queue-jobs-worker 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -1,76 +1,122 @@
-# 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.0] — 2026-08-29
-
-### Added
-
-**Core**
-
-- `QueueClient` — primary entry point; configures storage, exposes queues, and coordinates lifecycle.
-- `Queue` — independent job stream with per-queue configuration overrides.
-- `Job` — rich wrapper around the raw job data record; passed to user processors.
-- `Worker` — claims and executes jobs with configurable concurrency and graceful shutdown.
-- `QueueEventEmitter` — strongly-typed lifecycle event bus shared across all components.
-
-**Job processing**
-
-- At-least-once delivery guarantee.
-- Stable job identity preserved across all retries (no duplicate job IDs).
-- Full attempt history stored per job.
-- Per-job processor timeout enforcement.
-- Priority-ordered job claiming (higher priority = claimed first).
-- Delayed and scheduled job support via `schedule.delay` and `schedule.runAt`.
-- Recurring job support via `schedule.cron` field (cron expression stored; recurrence integration point provided).
-
-**Reliability**
-
-- Configurable retry with `attempts`, `retryDelay`, and `backoff` strategy.
-- Three backoff strategies: `fixed`, `linear`, `exponential` (capped at 10 minutes).
-- Dead Letter Queue (DLQ): jobs moved to `dead` status after exhausting all attempts.
-- Stalled-job recovery: expired locks on `active` jobs are detected and re-queued automatically.
-- Configurable lock duration (`lockDuration`) per queue.
-
-**Concurrency**
-
-- Per-worker concurrency limit (`concurrency`).
-- Atomic job claiming inside `InMemoryStorageAdapter` (single event-loop tick).
-
-**Rate limiting**
-
-- Sliding-window rate limiter configurable per queue (`rateLimit.max` / `rateLimit.duration`).
-
-**Storage**
-
-- `StorageAdapter` interface — clean abstraction; all core logic talks through this interface.
-- `InMemoryStorageAdapter` — full-featured in-process adapter for development and testing.
-
-**Configuration**
-
-- Layered configuration: Client defaults → Queue options → Worker options → Job options.
-- `QueueClient.withAdapter()` static factory for supplying a custom storage adapter.
-
-**TypeScript**
-
-- Full strict TypeScript types with `exactOptionalPropertyTypes` and `noUncheckedIndexedAccess`.
-- All public types exported from the top-level `index.ts`.
-
-**Build**
-
-- Dual ESM + CJS output via `tsup`.
-- Declaration files (`.d.ts` + `.d.ts.map`) generated via `tsc`.
-
-**Tests**
-
-- 31 tests across backoff strategies, storage adapter, queue client, and worker behaviour.
-- Coverage: job lifecycle, retry, DLQ, concurrency, stalled recovery, rate limiting, graceful shutdown.
-
----
-
-[1.0.0]: https://github.com/rafidahmed870/queue-jobs-worker/releases/tag/v1.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.1] — 2026-08-31
+
+### Core
+
+### Fixed
+
+- **`Worker.stop()` — clarified `releaseLock()` behavior in shutdown comment** ([#1](https://github.com/rafidahmed870/queue-jobs-worker/issues/1))
+
+  The inline comment in `worker.ts` now correctly explains that `releaseLock()`
+  sets `lockExpiresAt` to an already-expired timestamp (not null/empty), so
+  `recoverStalledJobs()` on any worker will immediately reclaim the job on the
+  next stall-check cycle.
+
+---
+
+### 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
+
+- **`releaseLock()` leaves jobs permanently stuck in `active` status** ([#1](https://github.com/rafidahmed870/queue-jobs-worker/issues/1))
+
+  All four adapters were clearing `lockExpiresAt` to `null` / empty string
+  while keeping `status` as `"active"`. Because `recoverStalledJobs()` requires
+  a non-null, already-expired `lockExpiresAt` to match a stalled job, those
+  jobs were silently skipped and could never be reclaimed or retried.
+
+  - `InMemoryStorageAdapter.releaseLock()` — `lockExpiresAt` now set to `new Date().toISOString()` instead of `null`.
+  - `RedisStorageAdapter.releaseLock()` — `lockExpiresAt` hash field now set to the current ISO timestamp instead of `""`.
+  - `PostgreSQLStorageAdapter.releaseLock()` — `lock_expires_at` column now set to `NOW()` instead of `NULL`.
+  - `MySQLStorageAdapter.releaseLock()` — `lock_expires_at` column now set to `NOW(3)` instead of `NULL`.
+
+---
+
+## [1.0.0] — 2026-08-29
+
+### Added
+
+**Core**
+
+- `QueueClient` — primary entry point; configures storage, exposes queues, and coordinates lifecycle.
+- `Queue` — independent job stream with per-queue configuration overrides.
+- `Job` — rich wrapper around the raw job data record; passed to user processors.
+- `Worker` — claims and executes jobs with configurable concurrency and graceful shutdown.
+- `QueueEventEmitter` — strongly-typed lifecycle event bus shared across all components.
+
+**Job processing**
+
+- At-least-once delivery guarantee.
+- Stable job identity preserved across all retries (no duplicate job IDs).
+- Full attempt history stored per job.
+- Per-job processor timeout enforcement.
+- Priority-ordered job claiming (higher priority = claimed first).
+- Delayed and scheduled job support via `schedule.delay` and `schedule.runAt`.
+- Recurring job support via `schedule.cron` field (cron expression stored; recurrence integration point provided).
+
+**Reliability**
+
+- Configurable retry with `attempts`, `retryDelay`, and `backoff` strategy.
+- Three backoff strategies: `fixed`, `linear`, `exponential` (capped at 10 minutes).
+- Dead Letter Queue (DLQ): jobs moved to `dead` status after exhausting all attempts.
+- Stalled-job recovery: expired locks on `active` jobs are detected and re-queued automatically.
+- Configurable lock duration (`lockDuration`) per queue.
+
+**Concurrency**
+
+- Per-worker concurrency limit (`concurrency`).
+- Atomic job claiming inside `InMemoryStorageAdapter` (single event-loop tick).
+
+**Rate limiting**
+
+- Sliding-window rate limiter configurable per queue (`rateLimit.max` / `rateLimit.duration`).
+
+**Storage**
+
+- `StorageAdapter` interface — clean abstraction; all core logic talks through this interface.
+- `InMemoryStorageAdapter` — full-featured in-process adapter for development and testing.
+
+**Configuration**
+
+- Layered configuration: Client defaults → Queue options → Worker options → Job options.
+- `QueueClient.withAdapter()` static factory for supplying a custom storage adapter.
+
+**TypeScript**
+
+- Full strict TypeScript types with `exactOptionalPropertyTypes` and `noUncheckedIndexedAccess`.
+- All public types exported from the top-level `index.ts`.
+
+**Build**
+
+- Dual ESM + CJS output via `tsup`.
+- Declaration files (`.d.ts` + `.d.ts.map`) generated via `tsc`.
+
+**Tests**
+
+- 31 tests across backoff strategies, storage adapter, queue client, and worker behaviour.
+- Coverage: job lifecycle, retry, DLQ, concurrency, stalled recovery, rate limiting, graceful shutdown.
+
+---
+
+[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/README.md

@@ -818,4 +818,10 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md).
 
 ## License
 
-MIT — [LICENSE](./LICENSE)
+MIT — [LICENSE](./LICENSE)
+
+# Donations
+
+## Buy me a coffee!
+
+BTC — ``12dxgVQ3sRFhc4g7M6oydsN2tTMMthJJqS``

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

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/core/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,KAAK,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;AAyBjD,qBAAa,MAAM;IACjB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAE1D,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,WAAW,CAAK;IAExB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,YAAY,CAA+B;IAEnD,4DAA4D;IAC5D,OAAO,CAAC,YAAY,CAA6B;gBAG/C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,EAC3C,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,gBAAgB;IAc5B,IAAI,MAAM,IAAI,YAAY,CAEzB;IAED,8BAA8B;IAC9B,KAAK,IAAI,IAAI;IAab;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiD3B,OAAO,CAAC,YAAY;YAQN,IAAI;YAsBJ,SAAS;YAiCT,UAAU;YAwDV,eAAe;YAwDf,aAAa;IA0C3B,OAAO,CAAC,kBAAkB;YAQZ,kBAAkB;CAkBjC"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/core/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,KAAK,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;AAyBjD,qBAAa,MAAM;IACjB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAE1D,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,WAAW,CAAK;IAExB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,YAAY,CAA+B;IAEnD,4DAA4D;IAC5D,OAAO,CAAC,YAAY,CAA6B;gBAG/C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,EAC3C,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,gBAAgB;IAc5B,IAAI,MAAM,IAAI,YAAY,CAEzB;IAED,8BAA8B;IAC9B,KAAK,IAAI,IAAI;IAab;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqD3B,OAAO,CAAC,YAAY;YAQN,IAAI;YAsBJ,SAAS;YAiCT,UAAU;YAwDV,eAAe;YAwDf,aAAa;IA0C3B,OAAO,CAAC,kBAAkB;YAQZ,kBAAkB;CAkBjC"}

package/dist/index.cjs

@@ -294,10 +294,11 @@ return job_id
       // Release lock
       // -------------------------------------------------------------------------
       async releaseLock(jobId) {
+        const now = (/* @__PURE__ */ new Date()).toISOString();
         await this.client.hSet(k.job(jobId), {
           lockId: "",
-          lockExpiresAt: "",
-          updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+          lockExpiresAt: now,
+          updatedAt: now
         });
       }
       // -------------------------------------------------------------------------
@@ -678,7 +679,7 @@ CREATE TABLE IF NOT EXISTS qjw_rate_limits (
       async releaseLock(jobId) {
         await this.pool.query(
           `UPDATE qjw_jobs
-       SET lock_id = NULL, lock_expires_at = NULL, updated_at = NOW()
+       SET lock_id = NULL, lock_expires_at = NOW(), updated_at = NOW()
        WHERE id = $1`,
           [jobId]
         );
@@ -1029,7 +1030,7 @@ CREATE TABLE IF NOT EXISTS qjw_rate_limits (
       async releaseLock(jobId) {
         await this.pool.query(
           `UPDATE qjw_jobs
-       SET lock_id = NULL, lock_expires_at = NULL, updated_at = NOW(3)
+       SET lock_id = NULL, lock_expires_at = NOW(3), updated_at = NOW(3)
        WHERE id = ?`,
           [jobId]
         );
@@ -1904,9 +1905,10 @@ var InMemoryStorageAdapter = class {
   async releaseLock(jobId) {
     const job = this.jobs.get(jobId);
     if (!job) return;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
     job.lockId = null;
-    job.lockExpiresAt = null;
-    job.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    job.lockExpiresAt = now;
+    job.updatedAt = now;
   }
   // -------------------------------------------------------------------------
   // Recover stalled jobs