queue-jobs-worker 1.0.4 → 2.0.0

package/package.json

@@ -1,110 +1,91 @@
-{
-  "name": "queue-jobs-worker",
-  "version": "1.0.4",
-  "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,160 +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.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.0]: https://github.com/rafidahmed870/queue-jobs-worker/releases/tag/v1.0.0
-
-### Storage
-
-### Fixed
-
-- **`recoverStalledJobs()` race condition — stale recovery overwrites a live job** ([#6](https://github.com/rafidahmed870/queue-jobs-worker/issues/6))
-
-  The previous implementation used a two-phase read-then-write pattern:
-
-  1. A fetch pipeline read `lockExpiresAt` and `priority` for all active jobs.
-  2. A separate write pipeline recovered every job whose lock appeared expired.
-
-  Between those two phases a worker could complete the job, fail it, or renew
-  its lock.  The write pipeline had no knowledge of that change and would
-  unconditionally overwrite the job back to `"waiting"`, causing duplicate
-  processing or data loss.
-
-  **`RedisStorageAdapter`** — the write pipeline has been replaced with a
-  per-job Lua script (`RECOVER_STALLED_LUA`) that implements a
-  **compare-and-swap (CAS)** guard.  The script atomically re-reads
-  `lockExpiresAt`, `lockId`, and `status` from the hash and aborts if any of
-  the three values differ from what the caller observed in the read phase.
-  Because Redis executes Lua scripts as a single indivisible command, no
-  concurrent write can slip between the re-read and the state update.  The
-  pre-filter (skip jobs whose lock has not yet expired) is preserved as an
-  optimisation to avoid unnecessary Lua round-trips.
-
-  **`InMemoryStorageAdapter`** — all operations run within a single event-loop
-  tick so the race is theoretical, but an equivalent CAS guard has been added
-  for consistency: `lockId` and `lockExpiresAt` are snapshotted at decision
-  time and re-validated immediately before the write.  Any interleaving that
-  mutated those fields will cause the recovery to be skipped.
-
----
-
-## [1.0.3] — 2026-09-09
-
-### 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.
-
-### Package
-
-### Fixed
-
-- **`package.json` — Added `assets` to npm package `files` distribution**
-
-  Added `"assets"` to the `"files"` list in `package.json` so header banner graphics in `README.md` display properly on npmjs.com.
-
----
-
-## [1.0.2] — 2026-09-05
-
-### Core
-
-### Fixed
-
-- **`Worker` — croner added as a required dependency; invalid expressions no longer fall back to a 1-minute interval** ([#5](https://github.com/rafidahmed870/queue-jobs-worker/issues/5))
-
-  `enqueueCronNext()` previously attempted a dynamic `import("croner")` inside
-  a try/catch. If the import failed — or if the resolved `Cron` class was not a
-  function — the code silently fell back to `Date.now() + 60_000`, scheduling
-  the next run 60 seconds later regardless of the configured cron expression.
-  The same silent fallback was also triggered for invalid cron expressions that
-  caused the `Cron` constructor to throw.
-
-  After the fix:
-
-  - `croner` is now declared as a proper `dependency` in `package.json`
-    (`^10.0.1`) and imported statically, so it is always available without any
-    dynamic-import dance.
-  - If the `Cron` constructor throws (invalid expression), a descriptive
-    `worker:error` event is emitted and re-enqueue is skipped. The worker
-    remains running.
-  - If `cronInstance.nextRun()` returns `null` (the schedule has no future
-    occurrences), a `worker:error` is emitted and re-enqueue is skipped. Again,
-    the worker keeps running.
-  - The 1-minute fallback path has been removed entirely — there is no silent
-    fallback under any failure condition.
-
-- **`Worker` — rate-limit quota no longer consumed on empty-queue polls** ([#4](https://github.com/rafidahmed870/queue-jobs-worker/issues/4))
-
-  `claimNext()` previously called `checkAndIncrementRateLimit()` before
-  attempting to claim a job. This meant every poll cycle against an empty queue
-  burned a quota slot, potentially exhausting the configured window budget
-  before any real work was done. After the fix, the storage `claim()` call
-  happens first; the rate-limit counter is only incremented when a job is
-  actually claimed for processing. If the rate limit is reached at that point
-  the lock is immediately released via `releaseLock()` so the job remains
-  reclaimable on the next window.
-
----
-
-### 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.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;IAe5C,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;IAgBtF,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;CAMf"}

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"}