{"id":44696,"library":"debeem-queue","title":"debeem-queue","description":"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.","status":"active","version":"1.0.31","language":"javascript","source_language":"en","source_url":"https://github.com/debeem/","tags":["javascript","typescript"],"install":[{"cmd":"npm install debeem-queue","lang":"bash","label":"npm"},{"cmd":"yarn add debeem-queue","lang":"bash","label":"yarn"},{"cmd":"pnpm add debeem-queue","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Requires Node.js >=20.17.0 for native ESM support","package":"node","optional":false}],"imports":[{"note":"Package is ESM-only due to Node >=20.17.0 requirement. Named export, not default.","wrong":"const Queue = require('debeem-queue')","symbol":"Queue","correct":"import { Queue } from 'debeem-queue'"},{"note":"TypeScript type export for configuration object. No runtime value.","symbol":"QueueOptions","correct":"import { QueueOptions } from 'debeem-queue'"},{"note":"Task is a TypeScript type/interface, not a constructor. Use 'import type' for type-only imports.","wrong":"import { Task } from 'debeem-queue'","symbol":"Task","correct":"import type { Task } from 'debeem-queue'"}],"quickstart":{"code":"import { Queue } from 'debeem-queue';\n\nconst queue = new Queue({ concurrency: 2 });\n\nasync function worker(task: string): Promise<void> {\n  console.log(`Processing: ${task}`);\n}\n\nqueue.process(worker);\n\nqueue.add('task1');\nqueue.add('task2');\nqueue.add('task3');\n\nqueue.on('completed', (result) => {\n  console.log(`Completed: ${result}`);\n});\n\nqueue.on('error', (err) => {\n  console.error(err);\n});","lang":"typescript","description":"Basic usage: create a queue with concurrency, add tasks, and process with error handling."},"warnings":[{"fix":"Upgrade Node.js to >=20.17.0","message":"Node.js >=20.17.0 required - cannot run on older versions","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Use import { Queue } from 'debeem-queue'","message":"Queue is a named export, not default. Using default import results in undefined.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Explicitly set concurrency when creating queue instance","message":"The 'concurrency' option defaults to 1 if not provided, which may lead to sequential processing.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use import type { Task } from 'debeem-queue'","message":"Task type is imported as type-only; using value import causes TS error.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.0.31':26 '20.17.0':16 'altern':47 'asynchron':36 'bee':52 'bee-queu':51 'buffer':43 'built':17 'bull':49 'cadenc':88 'case':74 'debeem':2,4,81 'debeem-queu':1 'depend':58 'design':59 'differenti':45 'embed':72 'esm':20 'flow':38 'focus':61 'follow':84 'full':22 'ideal':66 'implement':32 'javascript':92 'job':39 'librari':13 'lightweight':8 'like':48 'maintain':78 'make':64 'manag':35 'messag':42 'minim':29 'modern':19 'nativ':11 'node.js':15 'organ':82 'process':40 'project':76 'provid':27 'queue':3,5,12,31,53 'regular':86 'releas':87 'scale':70 'semant':90 'simplic':63 'small':69 'small-scal':68 'suitabl':33 'support':24 'task':37 'typescript':10,23,93 'typescript-n':9 'unopinion':30 'use':73 'version':25,91 'zero':57 'zero-depend':56","created_at":"2026-06-07T12:51:23.719105+00:00","updated_at":"2026-06-07T12:51:23.719105+00:00","problems":[{"fix":"Change to import { Queue } from 'debeem-queue'","cause":"Using default import instead of named import","error":"TypeError: debeem_queue_1.Queue is not a constructor"},{"fix":"Use named import: import { Queue } from 'debeem-queue'","cause":"Attempting default import in ESM context","error":"SyntaxError: The requested module 'debeem-queue' does not provide an export named 'default'"},{"fix":"Switch to ESM imports or set type: module in package.json","cause":"Using require() for an ESM-only package","error":"Error [ERR_REQUIRE_ESM]: require() of ES Module /node_modules/debeem-queue/index.js from ... not supported"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/debeem/","github":"https://github.com/debeem/","docs":null,"changelog":null,"pypi":null,"npm":"debeem-queue","openapi_spec":null,"status_page":null,"smithery":null,"categories":["storage"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}