Skip to content

Releases: node-cron/redis-coordinator

Release list

v0.1.0

Choose a tag to compare

@merencia merencia released this 18 Jun 03:44

First release of @node-cron/redis-coordinator.

A Redis-backed RunCoordinator for node-cron: per-fire, highly-available coordination of distributed: true tasks across a fleet. Every instance runs the same schedule and exactly one wins the lock for each fire, surviving the loss of any single node.

Highlights

  • Atomic lock via SET <key> <token> NX PX <leaseMs>, release via Lua compare-and-delete (an instance only releases its own lock).
  • Fail-closed: errors from shouldRun propagate so node-cron skips the fire instead of running everywhere.
  • Optional healthCheck() for clock-skew detection against the Redis server clock.
  • Client-agnostic by injection: works with ioredis or node-redis v4 (auto-detected). Zero runtime dependencies.
  • Dual ESM/CJS build with bundled TypeScript declarations.

Requires node-cron >= 4.4.1.

npm: https://www.npmjs.com/package/@node-cron/redis-coordinator