debeem-queue

library1.0.31jsnpmunverified

DeBeem Queue is a lightweight, TypeScript-native queue library for Node.js (>=20.17.0), built with modern ESM and full TypeScript support. Version 1.0.31 provides a minimal, unopinionated queue implementation suitable for managing asynchronous task flows, job processing, or message buffering. It differentiates from alternatives like Bull or Bee-Queue by its zero-dependency design and focus on simplicity, making it ideal for small-scale or embedded use cases. The project is maintained by the DeBeem organization and follows a regular release cadence with semantic versioning.

storage

npm install debeem-queue

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · DEBEEM-QUEUE

debeem-queue

storagejavascriptv1.0.31

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.

Queue

✓ import { Queue } from 'debeem-queue'

✗ const Queue = require('debeem-queue')

Package is ESM-only due to Node >=20.17.0 requirement. Named export, not default.

QueueOptions

✓ import { QueueOptions } from 'debeem-queue'

TypeScript type export for configuration object. No runtime value.

Task

✓ import type { Task } from 'debeem-queue'

✗ import { Task } from 'debeem-queue'

Task is a TypeScript type/interface, not a constructor. Use 'import type' for type-only imports.

Basic usage: create a queue with concurrency, add tasks, and process with error handling.

import { Queue } from 'debeem-queue'; const queue = new Queue({ concurrency: 2 }); async function worker(task: string): Promise<void> { console.log(`Processing: ${task}`); } queue.process(worker); queue.add('task1'); queue.add('task2'); queue.add('task3'); queue.on('completed', (result) => { console.log(`Completed: ${result}`); }); queue.on('error', (err) => { console.error(err); });

Debug

Known issues

breakingNode.js >=20.17.0 required - cannot run on older versions

fix

Upgrade Node.js to >=20.17.0

affects: >=1.0.0

gotchaQueue is a named export, not default. Using default import results in undefined.

fix

Use import { Queue } from 'debeem-queue'

affects: >=1.0.0

gotchaThe 'concurrency' option defaults to 1 if not provided, which may lead to sequential processing.

fix

Explicitly set concurrency when creating queue instance

affects: >=1.0.0

gotchaTask type is imported as type-only; using value import causes TS error.

fix

Use import type { Task } from 'debeem-queue'

affects: >=1.0.0

Errors

Common errors & fixes

TypeError: debeem_queue_1.Queue is not a constructor

Using default import instead of named import

fix

Change to import { Queue } from 'debeem-queue'

SyntaxError: The requested module 'debeem-queue' does not provide an export named 'default'

Attempting default import in ESM context

fix

Use named import: import { Queue } from 'debeem-queue'

Error [ERR_REQUIRE_ESM]: require() of ES Module /node_modules/debeem-queue/index.js from ... not supported

Using require() for an ESM-only package

fix

Switch to ESM imports or set type: module in package.json

Upgrade

Version history

1.0.31latest on npm

Audit

Dependencies

noderequiredRequires Node.js >=20.17.0 for native ESM support

Agent activity

32 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/debeem/ ↗

packagedebeem-queue ↗

homepagehttps://github.com/debeem/ ↗