queue-jobs-worker 1.0.5 → 2.0.0

package/package.json

@@ -1,110 +1,91 @@
-{
-  "name": "queue-jobs-worker",
-  "version": "1.0.5",
-  "description": "Reliable job queue and background worker system for Node.js with retries, concurrency, scheduling, and failure recovery.",
-  "keywords": [
-    "queue-jobs-worker",
-    "queue",
-    "job-queue",
-    "background-jobs",
-    "background-processing",
-    "worker",
-    "nodejs",
-    "retry-jobs",
-    "concurrency",
-    "scheduling",
-    "dlq",
-    "dead-letter-queue",
-    "redis",
-    "postgres",
-    "mysql",
-    "typescript"
-  ],
-  "homepage": "https://github.com/rafidahmed870/queue-jobs-worker#readme",
-  "bugs": {
-    "url": "https://github.com/rafidahmed870/queue-jobs-worker/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/rafidahmed870/queue-jobs-worker.git"
-  },
-  "license": "MIT",
-  "author": "Rafid Ahmed",
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.cjs"
-      }
-    }
-  },
-  "sideEffects": false,
-  "files": [
-    "dist",
-    "assets",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsup && tsc -p tsconfig.dts.json",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
-    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "prepublishOnly": "npm run typecheck && npm run build",
-    "prepare": "husky"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "croner": "^10.0.1"
-  },
-  "peerDependencies": {
-    "mysql2": ">=3.0.0",
-    "pg": ">=8.0.0",
-    "redis": ">=4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "redis": {
-      "optional": true
-    },
-    "pg": {
-      "optional": true
-    },
-    "mysql2": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/node": "*",
-    "@types/pg": "^8.23.1",
-    "@typescript-eslint/eslint-plugin": "*",
-    "@typescript-eslint/parser": "*",
-    "eslint": "*",
-    "eslint-config-prettier": "*",
-    "eslint-plugin-prettier": "*",
-    "husky": "^9.1.7",
-    "mysql2": "^3.24.2",
-    "pg": "^8.23.0",
-    "prettier": "*",
-    "redis": "^6.2.1",
-    "tsup": "*",
-    "typescript": "*",
-    "vitest": "*"
-  }
-}
+{
+  "name": "queue-jobs-worker",
+  "version": "2.0.0",
+  "description": "Reliable background job queue and worker system for Node.js — supports in-memory, Redis, PostgreSQL, and MySQL with retries, concurrency, scheduling, and failure recovery.",
+  "homepage": "https://github.com/rafidahmed870/queue-jobs-worker#readme",
+  "bugs": {
+    "url": "https://github.com/rafidahmed870/queue-jobs-worker/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rafidahmed870/queue-jobs-worker.git"
+  },
+  "license": "MIT",
+  "author": "Rafid Ahmed",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "packageManager": "pnpm@11.22.0",
+  "scripts": {
+    "build": "tsup",
+    "build:tsc": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "format": "prettier --write .",
+    "prepare": "husky",
+    "prepublishOnly": "pnpm build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "queue",
+    "worker",
+    "job",
+    "background",
+    "task",
+    "scheduler",
+    "cron",
+    "redis",
+    "postgres",
+    "mysql",
+    "retry",
+    "concurrency"
+  ],
+  "devDependencies": {
+    "@types/node": "^26.6.1",
+    "@types/pg": "^8.23.1",
+    "@typescript-eslint/eslint-plugin": "^8.70.0",
+    "@typescript-eslint/parser": "^8.70.0",
+    "eslint": "^10.10.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.6",
+    "husky": "^9.1.7",
+    "prettier": "^3.9.8",
+    "tsup": "^8.5.1",
+    "typescript": "^5.8.3",
+    "vitest": "^5.0.1"
+  },
+  "dependencies": {
+    "croner": "^10.0.1"
+  },
+  "peerDependencies": {
+    "mysql2": ">=3.0.0",
+    "pg": ">=8.0.0",
+    "redis": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "redis": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    }
+  }
+}

package/CHANGELOG.md

@@ -1,133 +0,0 @@
-# Changelog
-
-All notable changes to **queue-jobs-worker** will be documented in this file.
-
-The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
-This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.0.5] — 2026-09-15
-
-### Core
-
-### Fixed
-
-- **Storage Initialization Enforcement prior to Queue Creation & Execution** ([#14](https://github.com/rafidahmed870/queue-jobs-worker/issues/14))
-
-  Previously, `QueueClient.createQueue()` allowed queues to be created before `await client.init()` was called when using external storage dialects (e.g. Redis, PostgreSQL, MySQL). This caused the created queue to bind to the temporary `InMemoryStorageAdapter` instance. When `client.init()` was subsequently called, the real external storage adapter replaced the internal storage field on `QueueClient`, rendering previously enqueued jobs lost or inaccessible.
-
-  After the fix:
-
-  - `QueueClient.createQueue()` checks `isInitialised` before creating a queue. For external dialects and custom adapters, attempting to create a queue before `await client.init()` throws an explicit error.
-  - Queue operations (`enqueue`, `getJob`, `getJobs`, `getJobCounts`, and `createWorker`) enforce initialization status checks before executing, preventing operations on uninitialized storage.
-  - In-memory dialect continues to auto-initialize synchronously, preserving convenient single-line setup for tests and local development.
-
----
-
-### Events
-
-### Added
-
-- `QueueEventEmitter` — strongly-typed lifecycle event bus shared across all components.
-- Emits events for the full job lifecycle: enqueued, started, completed, failed, retrying, dead, stalled.
-- All event payloads fully typed via `events.types.ts`.
-
----
-
-<!-- Links -->
-[1.0.0]: https://github.com/rafidahmed870/queue-jobs-worker/releases/tag/v1.0.0
-
-### Lib
-
-### Added
-
-- **`lib/scripts/` — Redis Lua scripts extracted to standalone `.lua` files**
-  - `claim.lua` — atomic job claim with delayed-job promotion.
-  - `recover-stalled.lua` — compare-and-swap stalled job recovery.
-  - `renew-lock.lua` — atomic lock renewal with ownership guard.
-  - `rate-limit.lua` — atomic rate limit decision, reset, and counter increment.
-  - `lib/scripts/index.ts` re-exports scripts as named string constants (`CLAIM_LUA`, `RECOVER_STALLED_LUA`, `RENEW_LOCK_LUA`, `RATE_LIMIT_LUA`).
-  - Scripts are embedded into the CJS/ESM distribution bundles at build time via `tsup`'s `loader: { ".lua": "text" }`.
-
----
-
-### Storage
-
-### Added
-
-- **Consistent timestamps across Lua scripts**
-  - Changed `RedisStorageAdapter` to use `now_iso` from `ARGV[3]` for `updatedAt` in `CLAIM_LUA` and `RECOVER_STALLED_LUA`.
-  - Previously, `updatedAt` was sometimes derived from `lockExpiresAt`, which could differ from the actual time of the operation.
-
-### Fixed
-
-- **Atomic rate limiting across Redis, PostgreSQL, and MySQL adapters**
-  - `RedisStorageAdapter`: Implemented `rate-limit.lua` (`RATE_LIMIT_LUA`) script to perform window check, expiry reset, counter evaluation, increment, and TTL renewal atomically inside Redis.
-  - `PostgreSQLStorageAdapter`: Wrapped `checkAndIncrementRateLimit` in a pool client transaction (`BEGIN ... COMMIT`) utilizing `INSERT ... ON CONFLICT DO NOTHING` and `SELECT ... FOR UPDATE` row locking.
-  - `MySQLStorageAdapter`: Wrapped `checkAndIncrementRateLimit` in a connection transaction (`beginTransaction ... commit`) utilizing `INSERT ... ON DUPLICATE KEY UPDATE` and `SELECT ... FOR UPDATE` row locking.
-
-
----
-
-### Types
-
-### Added
-
-- **`lua.d.ts` — ambient module declaration for `.lua` imports**
-  - Declares `declare module "*.lua"` so TypeScript recognises `.lua` files as `string`-exporting modules.
-  - Required by `src/lib/scripts/index.ts` to import Lua scripts directly without type errors.
-
----
-
-### Tests
-
-### Added
-
-- **`lua-scripts.test.ts` — unit tests for Redis Lua scripts**
-  - 22 tests covering all four Lua scripts (`CLAIM_LUA`, `RECOVER_STALLED_LUA`, `RENEW_LOCK_LUA`, `RATE_LIMIT_LUA`).
-  - Verifies each script loads as a non-empty string from `src/lib/scripts/index.ts`.
-  - Asserts presence of critical Redis commands (`ZPOPMIN`, `ZRANGEBYSCORE`, `SADD`, `HSET`, `SREM`, `ZADD`, `INCR`, `EXPIRE`) and CAS/RateLimit guard conditions.
-- **`vitest.config.ts` — `rawLuaPlugin` added**
-  - Custom Vite transform plugin that loads `.lua` files as raw text strings during tests, mirroring `tsup`'s `loader: { ".lua": "text" }` used at build time.
-
----
-
-## [1.0.4] — 2026-09-13
-
-### Core
-
-### Fixed
-
-- **`Worker` — Job timeout cooperative cancellation via `AbortSignal`** ([#12](https://github.com/rafidahmed870/queue-jobs-worker/issues/12))
-
-  Previously, when a job attempt reached its configured `timeout`, the worker rejected the internal execution promise and marked the attempt as failed (or scheduled a retry), but the underlying processor `Promise` continued running in the background. This could lead to duplicate side effects when retries overlapped with timed-out attempts.
-
-  After the fix:
-
-  - `Processor` type signature is updated: `type Processor<TPayload = unknown> = (job: Job<TPayload>, signal: AbortSignal) => Promise<void>`.
-  - An `AbortController` is created for each job attempt.
-  - When job execution times out, the worker aborts the `AbortSignal` with a timeout error before rejecting the wrapper promise.
-  - User processors can monitor `signal.aborted` or pass `signal` to async operations (e.g. `fetch`, database queries, timers) for cooperative cancellation.
-
----
-
-### Events
-
-### Added
-
-- `QueueEventEmitter` — strongly-typed lifecycle event bus shared across all components.
-- Emits events for the full job lifecycle: enqueued, started, completed, failed, retrying, dead, stalled.
-- All event payloads fully typed via `events.types.ts`.
-
----
-
-<!-- Links -->
-
-[1.0.5]: https://github.com/rafidahmed870/queue-jobs-worker/compare/v1.0.0...v1.0.5
-[1.0.0]: https://github.com/rafidahmed870/queue-jobs-worker/releases/tag/v1.0.0
-[1.0.4]: https://github.com/rafidahmed870/queue-jobs-worker/compare/v1.0.0...v1.0.4
-[1.0.0]: https://github.com/rafidahmed870/queue-jobs-worker/releases/tag/v1.0.0
-[1.0.3]: https://github.com/rafidahmed870/queue-jobs-worker/compare/v1.0.2...v1.0.3
-[1.0.2]: https://github.com/rafidahmed870/queue-jobs-worker/compare/v1.0.1...v1.0.2
-[1.0.0]: https://github.com/rafidahmed870/queue-jobs-worker/releases/tag/v1.0.0
-[1.0.1]: https://github.com/rafidahmed870/queue-jobs-worker/compare/v1.0.0...v1.0.1
-[1.0.0]: https://github.com/rafidahmed870/queue-jobs-worker/releases/tag/v1.0.0

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Rafid Ahmed
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/core/backoff.d.ts

@@ -1,24 +0,0 @@
-/**
- * Backoff strategies
- *
- * Calculates the delay (in ms) before a failed job is re-queued.
- *
- * - fixed       — always uses `baseDelay`
- * - linear      — baseDelay × attemptNumber
- * - exponential — baseDelay × 2^(attemptNumber - 1), capped at MAX_DELAY
- */
-import type { BackoffStrategy } from "../types/job.types.js";
-/**
- * Returns the retry delay in milliseconds for the given attempt.
- *
- * @param strategy    - Backoff strategy name.
- * @param baseDelay   - Base delay in ms (from job / queue / client config).
- * @param attemptNumber - The 1-based attempt number that just failed.
- */
-export declare function calculateBackoff(strategy: BackoffStrategy, baseDelay: number, attemptNumber: number): number;
-/**
- * Returns the ISO timestamp at which a job should next become eligible,
- * given the current time and the calculated delay.
- */
-export declare function nextRunAt(delayMs: number, fromDate?: Date): string;
-//# sourceMappingURL=backoff.d.ts.map

package/dist/core/backoff.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../../src/core/backoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,MAAM,CAuBR;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,IAAiB,GAAG,MAAM,CAE9E"}

package/dist/core/client.d.ts

@@ -1,95 +0,0 @@
-/**
- * QueueClient
- *
- * Primary entry point for the queue-jobs-worker package.
- *
- * Usage:
- *
- *   // In-memory (dev / tests)
- *   const client = new QueueClient();
- *   // init() is optional for "memory" but always safe to call
- *
- *   // Redis
- *   const client = new QueueClient({ dialect: "redis", connectionString: "redis://localhost:6379" });
- *   await client.init();   // connects, pings Redis
- *
- *   // PostgreSQL
- *   const client = new QueueClient({ dialect: "postgres", connectionString: "postgresql://..." });
- *   await client.init();   // connects, auto-creates qjw_ tables if missing
- *
- *   // MySQL
- *   const client = new QueueClient({ dialect: "mysql", connectionString: "mysql://..." });
- *   await client.init();   // connects, auto-creates qjw_ tables if missing
- */
-import type { QueueClientOptions } from "../types/client.types.js";
-import type { QueueOptions } from "../types/queue.types.js";
-import type { StorageAdapter } from "../types/storage.types.js";
-import type { QueueEvents } from "../types/events.types.js";
-import { Queue } from "./queue.js";
-export declare class QueueClient {
-    /** @internal — mutable so withAdapter() can replace it */
-    _storage: StorageAdapter;
-    private readonly emitter;
-    private readonly defaults;
-    private readonly dialect;
-    private readonly connectionString;
-    private readonly queues;
-    private initialised;
-    private closed;
-    /** True when the adapter was supplied via {@link withAdapter}; init() skips resolveAdapter() in that case. */
-    private _customAdapter;
-    constructor(options?: QueueClientOptions);
-    private buildMemoryOrEagerAdapter;
-    /**
-     * Initialise the client and storage adapter.
-     *
-     * **Must be called** before creating queues when using Redis, PostgreSQL,
-     * or MySQL.
-     *
-     * What each adapter does:
-     *  - **memory**   — no-op (always safe to call)
-     *  - **redis**    — connects, sends PING, verifies PONG
-     *  - **postgres** — connects, runs `SELECT 1`, auto-creates `qjw_` tables
-     *  - **mysql**    — connects, runs `SELECT 1`, auto-creates `qjw_` tables
-     *
-     * Idempotent — safe to call multiple times.
-     */
-    init(): Promise<void>;
-    /** @deprecated Use `init()`. */
-    initialize(): Promise<void>;
-    private resolveAdapter;
-    /**
-     * Create a named queue with optional per-queue configuration.
-     *
-     * For external dialects (redis/postgres/mysql), call `await client.init()`
-     * first.
-     */
-    createQueue<TPayload = unknown>(name: string, options?: QueueOptions): Queue<TPayload>;
-    /** Returns the queue with the given name, or `undefined`. */
-    getQueue<TPayload = unknown>(name: string): Queue<TPayload> | undefined;
-    /** Returns the queue with the given name, or throws. */
-    requireQueue<TPayload = unknown>(name: string): Queue<TPayload>;
-    /** Names of all queues registered on this client. */
-    get queueNames(): string[];
-    /** `true` after `init()` has completed successfully. */
-    get isInitialised(): boolean;
-    on<K extends keyof QueueEvents>(event: K, listener: (...args: QueueEvents[K]) => void): this;
-    once<K extends keyof QueueEvents>(event: K, listener: (...args: QueueEvents[K]) => void): this;
-    off<K extends keyof QueueEvents>(event: K, listener: (...args: QueueEvents[K]) => void): this;
-    /**
-     * Stop all workers, close all queues, and release the storage connection.
-     * Safe to call multiple times.
-     */
-    close(): Promise<void>;
-    /**
-     * Create a QueueClient with a fully custom StorageAdapter.
-     *
-     * `init()` will call `adapter.initialize()`.
-     *
-     * @example
-     * const client = QueueClient.withAdapter(myAdapter);
-     * await client.init();
-     */
-    static withAdapter(adapter: StorageAdapter, options?: Omit<QueueClientOptions, "dialect" | "connectionString">): QueueClient;
-}
-//# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,0BAA0B,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAwBnC,qBAAa,WAAW;IACtB,0DAA0D;IAC1D,QAAQ,EAAE,cAAc,CAAC;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,8GAA8G;IAC9G,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,GAAE,kBAAuB;IAkB5C,OAAO,CAAC,yBAAyB;IAajC;;;;;;;;;;;;;OAaG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,gCAAgC;IAC1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAInB,cAAc;IAkC5B;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC;IAwBtF,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,SAAS;IAIvE,wDAAwD;IACxD,YAAY,CAAC,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC;IAQ/D,qDAAqD;IACrD,IAAI,UAAU,IAAI,MAAM,EAAE,CAEzB;IAED,wDAAwD;IACxD,IAAI,aAAa,IAAI,OAAO,CAE3B;IAMD,EAAE,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAK5F,IAAI,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAK9F,GAAG,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAS7F;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;;;;;;;OAQG;IACH,MAAM,CAAC,WAAW,CAChB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,kBAAkB,CAAM,GACrE,WAAW;CAOf"}

package/dist/core/id.d.ts

@@ -1,9 +0,0 @@
-/**
- * Job ID generation
- *
- * Uses the built-in `crypto.randomUUID()` available in Node.js >= 14.17.
- * No external dependency needed.
- */
-/** Generate a new unique job ID. */
-export declare function generateJobId(): string;
-//# sourceMappingURL=id.d.ts.map

package/dist/core/id.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/core/id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,oCAAoC;AACpC,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/core/index.d.ts

@@ -1,7 +0,0 @@
-export { Job } from "./job.js";
-export { Queue } from "./queue.js";
-export { Worker } from "./worker.js";
-export { QueueClient } from "./client.js";
-export { calculateBackoff, nextRunAt } from "./backoff.js";
-export { generateJobId } from "./id.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/core/job.d.ts

@@ -1,75 +0,0 @@
-/**
- * Job
- *
- * A rich wrapper around the raw JobData record stored in the storage layer.
- * Exposes read-only accessors for all fields and a small set of helpers used
- * by Queue and Worker internals.
- *
- * The Job instance is passed directly to user-supplied Processor functions.
- * Users should never mutate the internal data object — all mutations happen
- * through the storage adapter.
- */
-import type { JobData, JobStatus, JobAttempt, BackoffStrategy } from "../types/job.types.js";
-export declare class Job<TPayload = unknown> {
-    /** @internal Raw data record — treat as immutable outside storage layer. */
-    readonly _data: JobData<TPayload>;
-    constructor(data: JobData<TPayload>);
-    /** Unique, stable job identifier. */
-    get id(): string;
-    /** Name of the queue this job belongs to. */
-    get queue(): string;
-    /** Application-defined job type (matches the registered processor). */
-    get type(): string;
-    /**
-     * User-supplied job payload.
-     * Never log this value — it may contain sensitive data.
-     */
-    get data(): TPayload;
-    /** Current lifecycle status. */
-    get status(): JobStatus;
-    /** Number of attempts already executed (0 = not yet started). */
-    get attemptsMade(): number;
-    /** Maximum allowed attempts. */
-    get maxAttempts(): number;
-    /** How many attempts remain (including the current one). */
-    get attemptsRemaining(): number;
-    /** Ordered list of past attempt records. */
-    get attemptHistory(): readonly JobAttempt[];
-    /** Base delay in ms between retry attempts. */
-    get retryDelay(): number;
-    /** Backoff strategy applied on retry. */
-    get backoff(): BackoffStrategy;
-    /** Per-attempt timeout in ms. */
-    get timeout(): number;
-    /** Processing priority — higher numbers are processed first. */
-    get priority(): number;
-    /** ISO timestamp when this job is eligible to run. */
-    get runAt(): string;
-    /** Cron expression for recurring jobs, or undefined. */
-    get cron(): string | undefined;
-    /** ID of the worker currently holding the lock, or null. */
-    get lockId(): string | null;
-    /** ISO timestamp when the current lock expires, or null. */
-    get lockExpiresAt(): string | null;
-    /** ISO timestamp when the job was first enqueued. */
-    get createdAt(): string;
-    /** ISO timestamp of the last status change. */
-    get updatedAt(): string;
-    /** ISO timestamp when the job completed successfully, or null. */
-    get completedAt(): string | null;
-    /** ISO timestamp when the job was moved to the DLQ, or null. */
-    get failedAt(): string | null;
-    /** Returns true when the job has been successfully processed. */
-    isCompleted(): boolean;
-    /** Returns true when the job is in the Dead Letter Queue. */
-    isDead(): boolean;
-    /** Returns true when the job is currently being processed by a worker. */
-    isActive(): boolean;
-    /** Returns true when the job is waiting to be claimed. */
-    isWaiting(): boolean;
-    /** Returns true when the job is scheduled for a future time. */
-    isDelayed(): boolean;
-    toJSON(): Record<string, unknown>;
-    toString(): string;
-}
-//# sourceMappingURL=job.d.ts.map

package/dist/core/job.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../src/core/job.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7F,qBAAa,GAAG,CAAC,QAAQ,GAAG,OAAO;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAEtB,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC;IAQnC,qCAAqC;IACrC,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,6CAA6C;IAC7C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,uEAAuE;IACvE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAMD;;;OAGG;IACH,IAAI,IAAI,IAAI,QAAQ,CAEnB;IAMD,gCAAgC;IAChC,IAAI,MAAM,IAAI,SAAS,CAEtB;IAED,iEAAiE;IACjE,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,gCAAgC;IAChC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,4DAA4D;IAC5D,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,4CAA4C;IAC5C,IAAI,cAAc,IAAI,SAAS,UAAU,EAAE,CAE1C;IAMD,+CAA+C;IAC/C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,yCAAyC;IACzC,IAAI,OAAO,IAAI,eAAe,CAE7B;IAMD,iCAAiC;IACjC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,gEAAgE;IAChE,IAAI,QAAQ,IAAI,MAAM,CAErB;IAMD,sDAAsD;IACtD,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,wDAAwD;IACxD,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAMD,4DAA4D;IAC5D,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,4DAA4D;IAC5D,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAEjC;IAMD,qDAAqD;IACrD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,+CAA+C;IAC/C,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,kEAAkE;IAClE,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,gEAAgE;IAChE,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAMD,iEAAiE;IACjE,WAAW,IAAI,OAAO;IAItB,6DAA6D;IAC7D,MAAM,IAAI,OAAO;IAIjB,0EAA0E;IAC1E,QAAQ,IAAI,OAAO;IAInB,0DAA0D;IAC1D,SAAS,IAAI,OAAO;IAIpB,gEAAgE;IAChE,SAAS,IAAI,OAAO;IAQpB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAkBjC,QAAQ,IAAI,MAAM;CAGnB"}