Registry / devops / necessary-utils-basic-queue

necessary-utils-basic-queue

JSON →
library1.3.5jsnpmunverified

A lightweight TypeScript queue library for internal systems. Version 1.3.5 provides a simple in-memory queue with producer-consumer pattern, automatic or manual message acknowledgment (ACK), and interceptor hooks (WhenAnyMessage, WhenZeroMessage, WhenQueueStopped, WhenQueueStarted, custom). It supports generics for typed messages and is ESM-only with TypeScript types included. No external dependencies. Designed for Node.js environments where a basic queue is needed without heavy infrastructure like Redis or Bull. NPM downloads are low, indicating niche use.

devops
npm install necessary-utils-basic-queue
github ↗package ↗homepage ↗
INSTALL
IMPORT
SIG · NECESSARY-UTILS-BA
N
necessary-utils-basic-queue
devopsjavascriptv1.3.5
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

BasicQueue
✓ import { BasicQueue } from 'necessary-utils-basic-queue'
✗ import BasicQueue from 'necessary-utils-basic-queue'
Named export only. Default import does not exist.
BasicQueueMessage
✓ import { BasicQueueMessage } from 'necessary-utils-basic-queue'
✗ const { BasicQueueMessage } = require('necessary-utils-basic-queue')
Package is ESM-only; CJS require is not supported.
QueueSettings
✓ import { QueueSettings } from 'necessary-utils-basic-queue'
TypeScript type for queue configuration. As of v1.3.5, QueueSettings is exported but may not have documentation on its shape.

Create a typed queue, register a consumer with automatic acknowledgment, and push a message.

import { BasicQueue, BasicQueueMessage } from 'necessary-utils-basic-queue'; class MyMessage extends BasicQueueMessage { constructor(public text: string) { super(); } } const queue = new BasicQueue<MyMessage>(); // Register consumer with auto-ACK queue.Consume((msg: MyMessage) => { console.log(msg.text); }, true); // Produce message queue.PushMessage(new MyMessage('Hello world!'));
Debug
Known issues
gotchaPackage name 'necessary-utils-basic-queue' is long and might be mistyped as 'necessary-utils-queue'.
fix
Use exact package name: necessary-utils-basic-queue.
affects: all
gotchaQueue is in-memory only; messages are lost on process exit.
fix
Use only for ephemeral flows. For persistence, integrate with a database or use a library like Bull.
affects: >=1.0.0
gotchaConsumer method signature uses `Consume` (capital C) – not `consume`. Case-sensitive.
fix
queue.Consume(callback, autoAck) – note capital letter.
affects: >=1.0.0
gotchaThe package has <100 weekly downloads and limited community support.
fix
Evaluate stability before using in production.
affects: all
Errors
Common errors & fixes
Cannot find module 'necessary-utils-basic-queue'
Package not installed or import path incorrect.
fix
Run 'npm install necessary-utils-basic-queue' and verify import: import { BasicQueue } from 'necessary-utils-basic-queue'.
SyntaxError: Cannot use import statement outside a module
Node.js not configured for ESM (no 'type':'module' in package.json or .mjs extension).
fix
Add '"type": "module"' to your package.json, or use .mjs extension for imports.
TypeError: BasicQueueMessage is not a constructor
Import of BasicQueueMessage as default instead of named import.
fix
Use correct named import: import { BasicQueueMessage } from 'necessary-utils-basic-queue'.
Upgrade
Version history
1.3.5latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
2 hits · last 30 days
node
2
Resources
githubhttps://github.com/hanifiyildirimdagi/nu-basic-queue ↗
packagenecessary-utils-basic-queue ↗
homepagehttps://github.com/hanifiyildirimdagi/nu-basic-queue#readme ↗
necessary-utils-basic-queue — npm install necessary-utils-basic-queue · libregistry