appolo-queue

library8.0.3jsnpmunverified

A distributed job queue built with Redis and TypeScript, currently at version 8.0.3. It supports delayed jobs, scheduled jobs with cron or human-readable syntax, parallel multi-server execution, promise-based API, retries on failure, and job locking. Compared to similar queues like Bull or Bee, Appolo Queue offers a simpler API with built-in delay and schedule methods using natural language dates. Development appears paused with no recent releases, but the package remains functional for basic use cases.

messaging

npm install appolo-queue

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · APPOLO-QUEUE

appolo-queue

messagingjavascriptv8.0.3

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 'appolo-queue'

✗ const Queue = require('appolo-queue').Queue

ESM-only since v8

default export

✓ import AppoloQueue from 'appolo-queue'

✗ const AppoloQueue = require('appolo-queue')

CommonJS require does not work with ESM default exports; use named import instead

Job type

✓ import type { Job } from 'appolo-queue'

Type import only available with TypeScript

QueueOptions type

✓ import type { QueueOptions } from 'appolo-queue'

For type definitions only

Shows initialization, handler registration, job creation, and graceful shutdown with appolo-queue.

import { Queue } from 'appolo-queue'; const queue = new Queue({ redis: 'redis://localhost:6379', queueName: 'my-queue', checkInterval: 1000, maxConcurrency: 1, lockTime: 60000 }); await queue.initialize(); queue.handle('sendEmail', async (job) => { console.log(`Sending email to ${job.params.email}`); // simulate email sending return { sent: true }; }); await queue.create('sendEmail', { email: 'user@example.com' }).exec(); console.log('Job created and will be processed shortly.'); process.on('SIGINT', () => queue.stop());

Debug

Known issues

gotchaInstallation instruction in README says `npm install appolo --save` but the package name is `appolo-queue`. Installing `appolo` installs a different package.

fix

Run `npm install appolo-queue` instead.

affects: >=1.0.0

breakingVersion 8.0.x changed to ESM-only; CommonJS require() no longer works.

fix

Use ESM imports: `import { Queue } from 'appolo-queue'`.

affects: >=8.0.0

gotchaThe `redis` option must be a connection string; if using an object, it may cause runtime errors.

fix

Pass a string like `'redis://localhost:6379'`.

affects: >=1.0.0

deprecatedMethod `scedule` is a typo; will be removed in future versions.

fix

Use `schedule` instead.

affects: >=5.0.0

gotchaJob IDs must be unique; duplicate IDs overwrite existing jobs without warning.

fix

Ensure job IDs are unique or handle overwrites explicitly.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'appolo'

Installing the wrong package per README instruction

fix

Run `npm install appolo-queue` instead of `npm install appolo`.

TypeError: Queue is not a constructor

Using CommonJS require with ESM-only package

fix

Change to `import { Queue } from 'appolo-queue'` or use dynamic import.

ReplyError: MOVED ...

Using an incorrect redis connection string (e.g., missing protocol)

fix

Use valid Redis connection string like `redis://localhost:6379`.

Upgrade

Version history

8.0.3latest on npm

Audit

Dependencies

redisrequiredRequired for queue storage and job management

Agent activity

26 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/shmoop207/appolo-queue ↗

packageappolo-queue ↗

homepagehttps://github.com/shmoop207/appolo-queue#readme ↗