@ddd-ts-kit/redis 0.10.0 → 0.12.0

package/README.md

@@ -1,7 +1,8 @@
 # @ddd-ts-kit/redis
 
 Adapters of kernel ports on the Redis protocol: the `Cache`, `Lock` and `RateLimiter` ports,
-the wake-up signal of the outbox relay, and an integration event provider on Redis Streams.
+the wake-up signal of the outbox relay, a store of background jobs, and an integration event
+provider on Redis Streams.
 They use a common subset of the protocol, so the same code runs on Redis, Dragonfly and
 Valkey: the choice of server is an operational one, made in the composition root by a
 connection URL.
@@ -12,7 +13,7 @@ npm i @ddd-ts-kit/redis ioredis
 
 | Entry | Holds | Imports |
 |---|---|---|
-| `@ddd-ts-kit/redis` | `connectRedis`, `redisHealth`, `RedisCache`, `RedisLock`, `RedisRateLimiter`, `RedisRelaySignal`, `relayWakeUpMiddleware`; re-exported from the kernel: the `Lock` and `RateLimiter` ports, `InMemoryLock`, `InMemoryRateLimiter` | the kernel, `ioredis` (peer) |
+| `@ddd-ts-kit/redis` | `connectRedis`, `redisHealth`, `RedisCache`, `RedisLock`, `RedisRateLimiter`, `RedisRelaySignal`, `relayWakeUpMiddleware`, `RedisJobStore`, `reportLostJobs`; re-exported from the kernel: the `Lock` and `RateLimiter` ports, `InMemoryLock`, `InMemoryRateLimiter` | the kernel, `@ddd-ts-kit/scheduling`, `ioredis` (peer) |
 | `@ddd-ts-kit/redis/event-bus` | `RedisStreamsEventBus`, its options, topology and error types, the names of the entry fields | the kernel, `ioredis` (peer) |
 | `@ddd-ts-kit/redis/testing` | `cacheContract`, `lockContract`, `rateLimiterContract`, re-exported from `@ddd-ts-kit/testing/contracts` | `@ddd-ts-kit/testing` (optional peer), the runner you pass |
 
@@ -665,6 +666,36 @@ timeout, groups lost and created again, reconnection through a TCP relay the tes
 graceful close) and the whole chain from the outbox to an idempotent consumer. Each test works
 under a prefix of its own and deletes its keys.
 
+## Background job store
+
+`RedisJobStore` is the `JobStore` of `@ddd-ts-kit/scheduling` on Redis, Dragonfly or Valkey,
+for a project without a database or a queue it wants out of it: a few Lua scripts on the
+client of the package, every key under `{<namespace>}` so that a cluster keeps them in one slot
+and Dragonfly sees every key a script touches declared.
+
+```ts
+const jobStore = new RedisJobStore(redis, { namespace: 'jobs', onLostJob: reportLostJobs(logger, errors) });
+
+kernelModule({ jobStore });
+```
+
+`reportLostJobs(logger, errors?)` logs a write lost after its unit of work committed (the id of
+the job, the class and code of the error) and hands the error to the `ErrorReporter`, origin
+`queue`; a project initialised with `--queue redis` has it bound by its platform module.
+
+Redis cannot join the transaction of a database. Inside a unit of work, `add`, `cancel` and
+`retryDead` answer from what Redis holds and write once it committed (`whenCommitted` of the
+kernel): a command that rolls back leaves no job and cancels none, but a process that dies
+between the commit and the write loses that write, and `onLostJob` is told when it fails. With
+a database, prefer the jobs table of the ORM package. The idempotency key, scoped by the tenant
+of the job, is checked before the job is staged and again when it is written: two jobs of one
+key staged before either committed both answer their own id, and only the first is kept.
+
+Not BullMQ: it would bring a second worker model that the store contract (claim, lease,
+heartbeat, reports by attempt) does not map onto, and emulated cluster mode on Dragonfly. The
+store passes `jobStoreContract` on Dragonfly in the integration job of CI; it was also run by
+hand on Redis 8 (last run: Dragonfly 2.0.2, Redis 8.2, 2026-10-13). What the jobs guarantee: [Background jobs](../../docs/concepts/background-jobs.md).
+
 ## Contract suites
 
 Each port has a suite that its in-memory implementation and its adapter both pass. An adapter

package/dist/index.d.ts

@@ -14,4 +14,7 @@ export { RedisRelaySignal, type RedisRelaySignalOptions } from './relay/redis-re
 export { relayWakeUpMiddleware } from './relay/relay-wake-up-middleware.js';
 export { InMemoryLock, Lock, type AcquireOptions, type LockHandle, type WaitingOptions } from '@ddd-ts-kit/kernel';
 export { InMemoryRateLimiter, RateLimiter, type RateLimit, type RateLimitDecision } from '@ddd-ts-kit/kernel';
+export { RedisJobStore } from './jobs/redis-job-store.js';
+export type { RedisJobStoreOptions } from './jobs/redis-job-store-options.js';
+export { reportLostJobs } from './jobs/report-lost-jobs.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACtG,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACtG,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC9G,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -10,4 +10,6 @@ export { RedisRelaySignal } from './relay/redis-relay-signal.js';
 export { relayWakeUpMiddleware } from './relay/relay-wake-up-middleware.js';
 export { InMemoryLock, Lock } from '@ddd-ts-kit/kernel';
 export { InMemoryRateLimiter, RateLimiter } from '@ddd-ts-kit/kernel';
+export { RedisJobStore } from './jobs/redis-job-store.js';
+export { reportLostJobs } from './jobs/report-lost-jobs.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4C,MAAM,wBAAwB,CAAC;AAG9F,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAwB,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,OAAO,EAAE,WAAW,EAA6C,MAAM,8BAA8B,CAAC;AAEtG,OAAO,EAAE,SAAS,EAAyB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAgC,MAAM,sCAAsC,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAgC,MAAM,+BAA+B,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,IAAI,EAA6D,MAAM,oBAAoB,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAA0C,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA4C,MAAM,wBAAwB,CAAC;AAG9F,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAwB,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,OAAO,EAAE,WAAW,EAA6C,MAAM,8BAA8B,CAAC;AAEtG,OAAO,EAAE,SAAS,EAAyB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAgC,MAAM,sCAAsC,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAgC,MAAM,+BAA+B,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,IAAI,EAA6D,MAAM,oBAAoB,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAA0C,MAAM,oBAAoB,CAAC;AAC9G,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/jobs/claimed-job-of-record.d.ts

@@ -0,0 +1,5 @@
+import type { ClaimedJob } from '@ddd-ts-kit/scheduling';
+import type { RedisJobRecord } from './redis-job-record.js';
+/** A record as the worker receives it. */
+export declare function claimedJobOfRecord(record: RedisJobRecord): ClaimedJob;
+//# sourceMappingURL=claimed-job-of-record.d.ts.map

package/dist/jobs/claimed-job-of-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claimed-job-of-record.d.ts","sourceRoot":"","sources":["../../src/jobs/claimed-job-of-record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CAarE"}

package/dist/jobs/claimed-job-of-record.js

@@ -0,0 +1,23 @@
+import { parseEnqueuedBy } from './parse-enqueued-by.js';
+/** A record as the worker receives it. */
+export function claimedJobOfRecord(record) {
+    const payload = JSON.parse(record.payload);
+    return {
+        id: record.id,
+        name: record.name,
+        queue: record.queue,
+        payload,
+        enqueuedBy: parseEnqueuedBy(record.enqueuedBy),
+        enqueuedAt: new Date(record.enqueuedAt),
+        attempt: record.attempts,
+        ...checkpointOf(record),
+    };
+}
+function checkpointOf(record) {
+    if (record.checkpoint === undefined) {
+        return {};
+    }
+    const checkpoint = JSON.parse(record.checkpoint);
+    return { checkpoint };
+}
+//# sourceMappingURL=claimed-job-of-record.js.map

package/dist/jobs/claimed-job-of-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claimed-job-of-record.js","sourceRoot":"","sources":["../../src/jobs/claimed-job-of-record.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,0CAA0C;AAC1C,MAAM,UAAU,kBAAkB,CAAC,MAAsB;IACvD,MAAM,OAAO,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEpD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO;QACP,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC;QAC9C,UAAU,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QACvC,OAAO,EAAE,MAAM,CAAC,QAAQ;QACxB,GAAG,YAAY,CAAC,MAAM,CAAC;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAAsB;IAC1C,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAE1D,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC"}

package/dist/jobs/job-scripts.d.ts

@@ -0,0 +1,13 @@
+/** KEYS: records, waiting, keys. ARGV: id, record, idempotency field or '', run at. Answers { id, duplicate }. */
+export declare const ADD_JOB = "\nif ARGV[3] ~= '' then\n  local kept = redis.call('HGET', KEYS[3], ARGV[3])\n  if kept then return {kept, 1} end\nend\nif redis.call('HEXISTS', KEYS[1], ARGV[1]) == 1 then return {ARGV[1], 0} end\nlocal record = cjson.decode(ARGV[2])\nrecord.seq = redis.call('HINCRBY', KEYS[1], '#sequence', 1)\nredis.call('HSET', KEYS[1], ARGV[1], cjson.encode(record))\nredis.call('ZADD', KEYS[2], ARGV[4], ARGV[1])\nif ARGV[3] ~= '' then redis.call('HSET', KEYS[3], ARGV[3], ARGV[1]) end\nreturn {ARGV[1], 0}";
+/** KEYS: records, waiting, running. ARGV: now, limit, lease until. Answers the claimed records, earliest first. */
+export declare const CLAIM_JOBS = "\nlocal limit = tonumber(ARGV[2])\nlocal records = {}\nfor _, set in ipairs({KEYS[2], KEYS[3]}) do\n  for _, id in ipairs(redis.call('ZRANGEBYSCORE', set, '-inf', ARGV[1], 'LIMIT', 0, limit)) do\n    local raw = redis.call('HGET', KEYS[1], id)\n    if raw then table.insert(records, cjson.decode(raw)) end\n  end\nend\ntable.sort(records, function(a, b)\n  if a.runAt == b.runAt then return a.seq < b.seq end\n  return a.runAt < b.runAt\nend)\nlocal claimed = {}\nfor index = 1, math.min(#records, limit) do\n  local record = records[index]\n  record.status = 'running'\n  record.attempts = record.attempts + 1\n  record.leaseUntil = tonumber(ARGV[3])\n  local raw = cjson.encode(record)\n  redis.call('HSET', KEYS[1], record.id, raw)\n  redis.call('ZREM', KEYS[2], record.id)\n  redis.call('ZADD', KEYS[3], ARGV[3], record.id)\n  table.insert(claimed, raw)\nend\nreturn claimed";
+/**
+ * KEYS: records, waiting, running, dead, finished. ARGV: id, statuses allowed (space separated),
+ * attempt or '', change. A change sets fields, removes those it sets to false, and adds
+ * `attemptsDelta` to the attempts. Answers 1 when it applied, 0 otherwise.
+ */
+export declare const TRANSITION_JOB = "\nlocal raw = redis.call('HGET', KEYS[1], ARGV[1])\nif not raw then return 0 end\nlocal record = cjson.decode(raw)\nif not string.find(' ' .. ARGV[2] .. ' ', ' ' .. record.status .. ' ', 1, true) then return 0 end\nif ARGV[3] ~= '' and record.attempts ~= tonumber(ARGV[3]) then return 0 end\nfor field, value in pairs(cjson.decode(ARGV[4])) do\n  if field == 'attemptsDelta' then record.attempts = record.attempts + value\n  elseif value == false then record[field] = nil\n  else record[field] = value end\nend\nredis.call('HSET', KEYS[1], ARGV[1], cjson.encode(record))\nfor index = 2, 5 do redis.call('ZREM', KEYS[index], ARGV[1]) end\nif record.status == 'waiting' then redis.call('ZADD', KEYS[2], record.runAt, ARGV[1])\nelseif record.status == 'running' then redis.call('ZADD', KEYS[3], record.leaseUntil, ARGV[1])\nelseif record.status == 'dead' then redis.call('ZADD', KEYS[4], record.finishedAt, ARGV[1])\nelse redis.call('ZADD', KEYS[5], record.finishedAt, ARGV[1]) end\nreturn 1";
+/** KEYS: records, finished, keys. ARGV: before. Answers how many records it dropped. */
+export declare const PURGE_JOBS = "\nlocal ids = redis.call('ZRANGEBYSCORE', KEYS[2], '-inf', '(' .. ARGV[1])\nfor _, id in ipairs(ids) do\n  local raw = redis.call('HGET', KEYS[1], id)\n  if raw then\n    local record = cjson.decode(raw)\n    if record.key then redis.call('HDEL', KEYS[3], record.key) end\n    redis.call('HDEL', KEYS[1], id)\n  end\n  redis.call('ZREM', KEYS[2], id)\nend\nreturn #ids";
+//# sourceMappingURL=job-scripts.d.ts.map

package/dist/jobs/job-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-scripts.d.ts","sourceRoot":"","sources":["../../src/jobs/job-scripts.ts"],"names":[],"mappings":"AAQA,kHAAkH;AAClH,eAAO,MAAM,OAAO,qfAWA,CAAC;AAErB,mHAAmH;AACnH,eAAO,MAAM,UAAU,m3BAyBR,CAAC;AAEhB;;;;GAIG;AACH,eAAO,MAAM,cAAc,i+BAiBlB,CAAC;AAEV,wFAAwF;AACxF,eAAO,MAAM,UAAU,qXAWX,CAAC"}

package/dist/jobs/job-scripts.js

@@ -0,0 +1,84 @@
+/*
+ * The scripts of the job store. Each one runs atomically on the server and touches only the keys
+ * it is given, which Dragonfly requires: the records hash, the sorted sets of one queue
+ * (`waiting` by due instant, `running` by end of lease, `dead`), the finished set and the
+ * idempotency keys. A record is JSON whose payload, checkpoint and progress are JSON texts the
+ * scripts never open.
+ */
+/** KEYS: records, waiting, keys. ARGV: id, record, idempotency field or '', run at. Answers { id, duplicate }. */
+export const ADD_JOB = `
+if ARGV[3] ~= '' then
+  local kept = redis.call('HGET', KEYS[3], ARGV[3])
+  if kept then return {kept, 1} end
+end
+if redis.call('HEXISTS', KEYS[1], ARGV[1]) == 1 then return {ARGV[1], 0} end
+local record = cjson.decode(ARGV[2])
+record.seq = redis.call('HINCRBY', KEYS[1], '#sequence', 1)
+redis.call('HSET', KEYS[1], ARGV[1], cjson.encode(record))
+redis.call('ZADD', KEYS[2], ARGV[4], ARGV[1])
+if ARGV[3] ~= '' then redis.call('HSET', KEYS[3], ARGV[3], ARGV[1]) end
+return {ARGV[1], 0}`;
+/** KEYS: records, waiting, running. ARGV: now, limit, lease until. Answers the claimed records, earliest first. */
+export const CLAIM_JOBS = `
+local limit = tonumber(ARGV[2])
+local records = {}
+for _, set in ipairs({KEYS[2], KEYS[3]}) do
+  for _, id in ipairs(redis.call('ZRANGEBYSCORE', set, '-inf', ARGV[1], 'LIMIT', 0, limit)) do
+    local raw = redis.call('HGET', KEYS[1], id)
+    if raw then table.insert(records, cjson.decode(raw)) end
+  end
+end
+table.sort(records, function(a, b)
+  if a.runAt == b.runAt then return a.seq < b.seq end
+  return a.runAt < b.runAt
+end)
+local claimed = {}
+for index = 1, math.min(#records, limit) do
+  local record = records[index]
+  record.status = 'running'
+  record.attempts = record.attempts + 1
+  record.leaseUntil = tonumber(ARGV[3])
+  local raw = cjson.encode(record)
+  redis.call('HSET', KEYS[1], record.id, raw)
+  redis.call('ZREM', KEYS[2], record.id)
+  redis.call('ZADD', KEYS[3], ARGV[3], record.id)
+  table.insert(claimed, raw)
+end
+return claimed`;
+/**
+ * KEYS: records, waiting, running, dead, finished. ARGV: id, statuses allowed (space separated),
+ * attempt or '', change. A change sets fields, removes those it sets to false, and adds
+ * `attemptsDelta` to the attempts. Answers 1 when it applied, 0 otherwise.
+ */
+export const TRANSITION_JOB = `
+local raw = redis.call('HGET', KEYS[1], ARGV[1])
+if not raw then return 0 end
+local record = cjson.decode(raw)
+if not string.find(' ' .. ARGV[2] .. ' ', ' ' .. record.status .. ' ', 1, true) then return 0 end
+if ARGV[3] ~= '' and record.attempts ~= tonumber(ARGV[3]) then return 0 end
+for field, value in pairs(cjson.decode(ARGV[4])) do
+  if field == 'attemptsDelta' then record.attempts = record.attempts + value
+  elseif value == false then record[field] = nil
+  else record[field] = value end
+end
+redis.call('HSET', KEYS[1], ARGV[1], cjson.encode(record))
+for index = 2, 5 do redis.call('ZREM', KEYS[index], ARGV[1]) end
+if record.status == 'waiting' then redis.call('ZADD', KEYS[2], record.runAt, ARGV[1])
+elseif record.status == 'running' then redis.call('ZADD', KEYS[3], record.leaseUntil, ARGV[1])
+elseif record.status == 'dead' then redis.call('ZADD', KEYS[4], record.finishedAt, ARGV[1])
+else redis.call('ZADD', KEYS[5], record.finishedAt, ARGV[1]) end
+return 1`;
+/** KEYS: records, finished, keys. ARGV: before. Answers how many records it dropped. */
+export const PURGE_JOBS = `
+local ids = redis.call('ZRANGEBYSCORE', KEYS[2], '-inf', '(' .. ARGV[1])
+for _, id in ipairs(ids) do
+  local raw = redis.call('HGET', KEYS[1], id)
+  if raw then
+    local record = cjson.decode(raw)
+    if record.key then redis.call('HDEL', KEYS[3], record.key) end
+    redis.call('HDEL', KEYS[1], id)
+  end
+  redis.call('ZREM', KEYS[2], id)
+end
+return #ids`;
+//# sourceMappingURL=job-scripts.js.map

package/dist/jobs/job-scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-scripts.js","sourceRoot":"","sources":["../../src/jobs/job-scripts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kHAAkH;AAClH,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;;;;;oBAWH,CAAC;AAErB,mHAAmH;AACnH,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;eAyBX,CAAC;AAEhB;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;SAiBrB,CAAC;AAEV,wFAAwF;AACxF,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;YAWd,CAAC"}

package/dist/jobs/parse-enqueued-by.d.ts

@@ -0,0 +1,4 @@
+import { type EnqueuedBy } from '@ddd-ts-kit/kernel';
+/** Reads who enqueued a job, as the store wrote it. */
+export declare function parseEnqueuedBy(raw: string): EnqueuedBy;
+//# sourceMappingURL=parse-enqueued-by.d.ts.map

package/dist/jobs/parse-enqueued-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-enqueued-by.d.ts","sourceRoot":"","sources":["../../src/jobs/parse-enqueued-by.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE9D,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAoBvD"}

package/dist/jobs/parse-enqueued-by.js

@@ -0,0 +1,23 @@
+import { isActor } from '@ddd-ts-kit/kernel';
+/** Reads who enqueued a job, as the store wrote it. */
+export function parseEnqueuedBy(raw) {
+    const parsed = JSON.parse(raw);
+    const actor = typeof parsed === 'object' && parsed !== null ? Reflect.get(parsed, 'actor') : undefined;
+    const correlationId = typeof parsed === 'object' && parsed !== null ? Reflect.get(parsed, 'correlationId') : undefined;
+    if (!isActor(actor) || typeof correlationId !== 'string') {
+        throw new TypeError('Who enqueued a background job of Redis is not written the way the store writes it.');
+    }
+    const tenantId = textOf(parsed, 'tenantId');
+    const traceparent = textOf(parsed, 'traceparent');
+    return {
+        correlationId,
+        actor,
+        ...(tenantId === undefined ? {} : { tenantId }),
+        ...(traceparent === undefined ? {} : { traceparent }),
+    };
+}
+function textOf(value, field) {
+    const text = typeof value === 'object' && value !== null ? Reflect.get(value, field) : undefined;
+    return typeof text === 'string' ? text : undefined;
+}
+//# sourceMappingURL=parse-enqueued-by.js.map

package/dist/jobs/parse-enqueued-by.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-enqueued-by.js","sourceRoot":"","sources":["../../src/jobs/parse-enqueued-by.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAmB,MAAM,oBAAoB,CAAC;AAE9D,uDAAuD;AACvD,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAY,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhH,MAAM,aAAa,GACjB,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEnG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACzD,MAAM,IAAI,SAAS,CAAC,oFAAoF,CAAC,CAAC;IAC5G,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAElD,OAAO;QACL,aAAa;QACb,KAAK;QACL,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC/C,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;KACtD,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,KAAc,EAAE,KAAa;IAC3C,MAAM,IAAI,GAAY,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1G,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC"}

package/dist/jobs/parse-job-record.d.ts

@@ -0,0 +1,4 @@
+import type { RedisJobRecord } from './redis-job-record.js';
+/** Reads a record the scripts wrote. Throws on anything else: the keys of the namespace belong to the store. */
+export declare function parseJobRecord(raw: string): RedisJobRecord;
+//# sourceMappingURL=parse-job-record.d.ts.map

package/dist/jobs/parse-job-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-job-record.d.ts","sourceRoot":"","sources":["../../src/jobs/parse-job-record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,gHAAgH;AAChH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAQ1D"}

package/dist/jobs/parse-job-record.js

@@ -0,0 +1,17 @@
+/** Reads a record the scripts wrote. Throws on anything else: the keys of the namespace belong to the store. */
+export function parseJobRecord(raw) {
+    const parsed = JSON.parse(raw);
+    if (!isJobRecord(parsed)) {
+        throw new TypeError('A background job record of Redis does not have the shape the store writes.');
+    }
+    return parsed;
+}
+function isJobRecord(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const fields = ['id', 'name', 'queue', 'payload', 'enqueuedBy', 'status'].map((field) => Reflect.get(value, field));
+    const instants = ['attempts', 'runAt', 'enqueuedAt', 'seq'].map((field) => Reflect.get(value, field));
+    return fields.every((field) => typeof field === 'string') && instants.every((field) => typeof field === 'number');
+}
+//# sourceMappingURL=parse-job-record.js.map

package/dist/jobs/parse-job-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-job-record.js","sourceRoot":"","sources":["../../src/jobs/parse-job-record.ts"],"names":[],"mappings":"AAEA,gHAAgH;AAChH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAExC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CAAC,4EAA4E,CAAC,CAAC;IACpG,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAW,EAAE,CAC/F,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAC1B,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAW,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAE/G,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;AACpH,CAAC"}

package/dist/jobs/queued-job-of-record.d.ts

@@ -0,0 +1,5 @@
+import type { QueuedJob } from '@ddd-ts-kit/kernel';
+import type { RedisJobRecord } from './redis-job-record.js';
+/** What a record shows of its job: never the payload, the checkpoint or the actor. */
+export declare function queuedJobOfRecord(record: RedisJobRecord): QueuedJob;
+//# sourceMappingURL=queued-job-of-record.d.ts.map

package/dist/jobs/queued-job-of-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queued-job-of-record.d.ts","sourceRoot":"","sources":["../../src/jobs/queued-job-of-record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAenE"}

package/dist/jobs/queued-job-of-record.js

@@ -0,0 +1,18 @@
+/** What a record shows of its job: never the payload, the checkpoint or the actor. */
+export function queuedJobOfRecord(record) {
+    return {
+        id: record.id,
+        name: record.name,
+        queue: record.queue,
+        status: record.status,
+        attempts: record.attempts,
+        enqueuedAt: new Date(record.enqueuedAt),
+        runAt: new Date(record.runAt),
+        ...(record.tenantId === undefined ? {} : { tenantId: record.tenantId }),
+        ...(record.subject === undefined ? {} : { subject: record.subject }),
+        ...(record.progress === undefined ? {} : { progress: record.progress }),
+        ...(record.lastErrorCode === undefined ? {} : { lastErrorCode: record.lastErrorCode }),
+        ...(record.finishedAt === undefined ? {} : { finishedAt: new Date(record.finishedAt) }),
+    };
+}
+//# sourceMappingURL=queued-job-of-record.js.map

package/dist/jobs/queued-job-of-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queued-job-of-record.js","sourceRoot":"","sources":["../../src/jobs/queued-job-of-record.ts"],"names":[],"mappings":"AAGA,sFAAsF;AACtF,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACtD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QACvC,KAAK,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAC7B,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvE,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QACpE,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvE,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;QACtF,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;KACxF,CAAC;AACJ,CAAC"}

package/dist/jobs/redis-job-record.d.ts

@@ -0,0 +1,25 @@
+import type { JobProgress, QueuedJobStatus } from '@ddd-ts-kit/kernel';
+/** A job as the Redis store keeps it: instants in epoch milliseconds, JSON values as texts. */
+export interface RedisJobRecord {
+    readonly id: string;
+    readonly name: string;
+    readonly queue: string;
+    readonly payload: string;
+    /** A JSON text: an empty list would come back from the scripts as an empty object. */
+    readonly enqueuedBy: string;
+    /** The idempotency field: name, tenant and key together. */
+    readonly key?: string;
+    readonly tenantId?: string;
+    readonly subject?: string;
+    readonly seq: number;
+    readonly status: QueuedJobStatus;
+    readonly attempts: number;
+    readonly runAt: number;
+    readonly leaseUntil?: number;
+    readonly progress?: JobProgress;
+    readonly checkpoint?: string;
+    readonly lastErrorCode?: string;
+    readonly enqueuedAt: number;
+    readonly finishedAt?: number;
+}
+//# sourceMappingURL=redis-job-record.d.ts.map

package/dist/jobs/redis-job-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-job-record.d.ts","sourceRoot":"","sources":["../../src/jobs/redis-job-record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEvE,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/jobs/redis-job-record.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=redis-job-record.js.map

package/dist/jobs/redis-job-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-job-record.js","sourceRoot":"","sources":["../../src/jobs/redis-job-record.ts"],"names":[],"mappings":""}

package/dist/jobs/redis-job-store-options.d.ts

@@ -0,0 +1,11 @@
+export interface RedisJobStoreOptions {
+    /** Prefix of the keys, typically the application. Default `jobs`. */
+    readonly namespace?: string;
+    /**
+     * Told when a job staged by a committed unit of work could not be written (that job is lost),
+     * or a cancellation or a revival staged the same way could not be applied. The composition
+     * root hands it to the error reporter and the logger. Default: nothing is told.
+     */
+    readonly onLostJob?: (error: unknown, jobId: string) => void;
+}
+//# sourceMappingURL=redis-job-store-options.d.ts.map

package/dist/jobs/redis-job-store-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-job-store-options.d.ts","sourceRoot":"","sources":["../../src/jobs/redis-job-store-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D"}

package/dist/jobs/redis-job-store-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=redis-job-store-options.js.map

package/dist/jobs/redis-job-store-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-job-store-options.js","sourceRoot":"","sources":["../../src/jobs/redis-job-store-options.ts"],"names":[],"mappings":""}

package/dist/jobs/redis-job-store.d.ts

@@ -0,0 +1,48 @@
+import { inspect } from 'node:util';
+import type { Redis } from 'ioredis';
+import { type EnqueuedJob, type QueuedJob } from '@ddd-ts-kit/kernel';
+import { type ClaimedJob, type ClaimRequest, type JobFailure, type JobLease, type JobStore, type JobStoreStats, type JobUpdate, type NewJob } from '@ddd-ts-kit/scheduling';
+import type { RedisJobStoreOptions } from './redis-job-store-options.js';
+/**
+ * The background jobs on Redis, Dragonfly or Valkey, in a few Lua scripts: no dependency but the
+ * client of the package. Redis cannot join the transaction of the database: inside a unit of
+ * work, `add`, `cancel` and `retryDead` answer from what Redis holds and write once it committed
+ * (`whenCommitted`), so a command that rolls back leaves no job and cancels none, and a crash
+ * between the commit and the write loses that write. Every key carries the namespace in braces,
+ * so that a cluster keeps them in one slot.
+ */
+export declare class RedisJobStore implements JobStore {
+    private readonly client;
+    private readonly prefix;
+    private readonly onLostJob;
+    constructor(client: Redis, options?: RedisJobStoreOptions);
+    add(job: NewJob): Promise<EnqueuedJob>;
+    claim({ queue, limit, now, leaseMs }: ClaimRequest): Promise<ClaimedJob[]>;
+    heartbeat(lease: JobLease, leaseUntil: Date): Promise<boolean>;
+    update(lease: JobLease, update: JobUpdate, leaseUntil: Date): Promise<boolean>;
+    complete(lease: JobLease, at: Date): Promise<boolean>;
+    fail(lease: JobLease, { errorCode, retryAt, at }: JobFailure): Promise<boolean>;
+    release(lease: JobLease, runAt: Date): Promise<boolean>;
+    cancel(id: string, at: Date): Promise<boolean>;
+    find(id: string): Promise<QueuedJob | undefined>;
+    retryDead(ids: readonly string[], now: Date): Promise<number>;
+    purgeFinished(before: Date): Promise<number>;
+    stats(queue: string): Promise<JobStoreStats>;
+    /** What a serialisation shows: a name, never the client, whose options carry the password. */
+    toJSON(): string;
+    /** What `console.log` and `util.inspect` show: the same. */
+    [inspect.custom](): string;
+    private write;
+    /**
+     * Inside a unit of work, `write` waits for the commit and `expected` is the answer; anywhere
+     * else, it runs at once and its own answer is.
+     */
+    private afterCommit;
+    private revive;
+    private holding;
+    /** The queue of a job never changes: it is read first, to name the keys the script may touch. */
+    private transition;
+    private record;
+    private key;
+}
+//# sourceMappingURL=redis-job-store.d.ts.map

package/dist/jobs/redis-job-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-job-store.d.ts","sourceRoot":"","sources":["../../src/jobs/redis-job-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAiB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,MAAM,EACZ,MAAM,wBAAwB,CAAC;AAQhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAgBzE;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IAEpE,YAAY,MAAM,EAAE,KAAK,EAAE,OAAO,GAAE,oBAAyB,EAK5D;IAEK,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAoB3C;IAEK,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAY/E;IAED,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7D;IAED,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAM7E;IAED,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpD;IAED,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAK9E;IAED,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAEtD;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAUnD;IAEK,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAIrD;IAEK,SAAS,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAKlE;IAEK,aAAa,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAIjD;IAEK,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAMjD;IAED,8FAA8F;IAC9F,MAAM,IAAI,MAAM,CAEf;IAED,4DAA4D;IAC5D,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAEzB;YAEa,KAAK;IAsBnB;;;OAGG;YACW,WAAW;YAiBX,MAAM;IAYpB,OAAO,CAAC,OAAO;IAIf,iGAAiG;YACnF,UAAU;YA4BV,MAAM;IAMpB,OAAO,CAAC,GAAG;CAGZ"}

package/dist/jobs/redis-job-store.js

@@ -0,0 +1,178 @@
+import { inspect } from 'node:util';
+import { whenCommitted } from '@ddd-ts-kit/kernel';
+import { tenantKeyOf, } from '@ddd-ts-kit/scheduling';
+import { listOf } from '../replies/list-of.js';
+import { conceal } from '../secrecy/conceal.js';
+import { claimedJobOfRecord } from './claimed-job-of-record.js';
+import { ADD_JOB, CLAIM_JOBS, PURGE_JOBS, TRANSITION_JOB } from './job-scripts.js';
+import { parseJobRecord } from './parse-job-record.js';
+import { queuedJobOfRecord } from './queued-job-of-record.js';
+const DESCRIPTION = 'RedisJobStore [client concealed]';
+/**
+ * The background jobs on Redis, Dragonfly or Valkey, in a few Lua scripts: no dependency but the
+ * client of the package. Redis cannot join the transaction of the database: inside a unit of
+ * work, `add`, `cancel` and `retryDead` answer from what Redis holds and write once it committed
+ * (`whenCommitted`), so a command that rolls back leaves no job and cancels none, and a crash
+ * between the commit and the write loses that write. Every key carries the namespace in braces,
+ * so that a cluster keeps them in one slot.
+ */
+export class RedisJobStore {
+    client;
+    prefix;
+    onLostJob;
+    constructor(client, options = {}) {
+        this.client = client;
+        this.prefix = `{${options.namespace ?? 'jobs'}}`;
+        this.onLostJob = options.onLostJob ?? (() => undefined);
+        conceal(this);
+    }
+    async add(job) {
+        const field = job.idempotencyKey === undefined
+            ? ''
+            : JSON.stringify([job.name, tenantKeyOf(job.enqueuedBy), job.idempotencyKey]);
+        const kept = field === '' ? null : await this.client.hget(this.key('keys'), field);
+        if (kept !== null) {
+            return { id: kept, duplicate: true };
+        }
+        await whenCommitted(() => this.write(job, field), (error) => {
+            this.onLostJob(error, job.id);
+        });
+        return { id: job.id, duplicate: false };
+    }
+    async claim({ queue, limit, now, leaseMs }) {
+        if (limit <= 0) {
+            return [];
+        }
+        const keys = [this.key('records'), this.key('waiting', queue), this.key('running', queue)];
+        const leaseUntil = now.getTime() + leaseMs;
+        const claimed = await this.client.eval(CLAIM_JOBS, keys.length, ...keys, now.getTime(), limit, leaseUntil);
+        return listOf(claimed)
+            .filter((raw) => typeof raw === 'string')
+            .map((raw) => claimedJobOfRecord(parseJobRecord(raw)));
+    }
+    heartbeat(lease, leaseUntil) {
+        return this.holding(lease, { leaseUntil: leaseUntil.getTime() });
+    }
+    update(lease, update, leaseUntil) {
+        return this.holding(lease, {
+            leaseUntil: leaseUntil.getTime(),
+            ...(update.progress === undefined ? {} : { progress: update.progress }),
+            ...('checkpoint' in update ? { checkpoint: jsonOrFalse(update.checkpoint) } : {}),
+        });
+    }
+    complete(lease, at) {
+        return this.holding(lease, { status: 'succeeded', finishedAt: at.getTime(), leaseUntil: false });
+    }
+    fail(lease, { errorCode, retryAt, at }) {
+        const next = retryAt === null ? { status: 'dead', finishedAt: at.getTime() } : { status: 'waiting', runAt: retryAt.getTime() };
+        return this.holding(lease, { ...next, leaseUntil: false, lastErrorCode: errorCode });
+    }
+    release(lease, runAt) {
+        return this.holding(lease, { status: 'waiting', runAt: runAt.getTime(), leaseUntil: false, attemptsDelta: -1 });
+    }
+    async cancel(id, at) {
+        const status = (await this.record(id))?.status;
+        if (status !== 'waiting' && status !== 'running') {
+            return false;
+        }
+        const change = { status: 'cancelled', finishedAt: at.getTime(), leaseUntil: false };
+        return this.afterCommit(true, [id], () => this.transition({ id, from: 'waiting running', change }));
+    }
+    async find(id) {
+        const record = await this.record(id);
+        return record === undefined ? undefined : queuedJobOfRecord(record);
+    }
+    async retryDead(ids, now) {
+        const records = await Promise.all(ids.map((id) => this.record(id)));
+        const dead = records.flatMap((record) => (record?.status === 'dead' ? [record.id] : []));
+        return this.afterCommit(dead.length, dead, () => this.revive(dead, now));
+    }
+    async purgeFinished(before) {
+        const keys = [this.key('records'), this.key('finished'), this.key('keys')];
+        return Number(await this.client.eval(PURGE_JOBS, keys.length, ...keys, before.getTime()));
+    }
+    async stats(queue) {
+        const [waiting, running, dead] = await Promise.all(['waiting', 'running', 'dead'].map((set) => this.client.zcard(this.key(set, queue))));
+        return { waiting: waiting ?? 0, running: running ?? 0, dead: dead ?? 0 };
+    }
+    /** What a serialisation shows: a name, never the client, whose options carry the password. */
+    toJSON() {
+        return DESCRIPTION;
+    }
+    /** What `console.log` and `util.inspect` show: the same. */
+    [inspect.custom]() {
+        return DESCRIPTION;
+    }
+    async write(job, field) {
+        const keys = [this.key('records'), this.key('waiting', job.queue), this.key('keys')];
+        const runAt = job.runAt.getTime();
+        const record = {
+            id: job.id,
+            name: job.name,
+            queue: job.queue,
+            payload: jsonOrFalse(job.payload) || 'null',
+            enqueuedBy: JSON.stringify(job.enqueuedBy),
+            ...(field === '' ? {} : { key: field }),
+            ...(job.enqueuedBy.tenantId === undefined ? {} : { tenantId: job.enqueuedBy.tenantId }),
+            ...(job.subject === undefined ? {} : { subject: job.subject }),
+            status: 'waiting',
+            attempts: 0,
+            runAt,
+            enqueuedAt: job.enqueuedAt.getTime(),
+        };
+        await this.client.eval(ADD_JOB, keys.length, ...keys, job.id, JSON.stringify(record), field, runAt);
+    }
+    /**
+     * Inside a unit of work, `write` waits for the commit and `expected` is the answer; anywhere
+     * else, it runs at once and its own answer is.
+     */
+    async afterCommit(expected, ids, write) {
+        let answer = expected;
+        await whenCommitted(async () => {
+            answer = await write();
+        }, (error) => {
+            for (const id of ids) {
+                this.onLostJob(error, id);
+            }
+        });
+        return answer;
+    }
+    async revive(ids, now) {
+        let revived = 0;
+        for (const id of ids) {
+            const change = { status: 'waiting', runAt: now.getTime(), finishedAt: false, attempts: 0 };
+            revived += (await this.transition({ id, from: 'dead', change })) ? 1 : 0;
+        }
+        return revived;
+    }
+    holding(lease, change) {
+        return this.transition({ id: lease.id, from: 'running', attempt: lease.attempt, change });
+    }
+    /** The queue of a job never changes: it is read first, to name the keys the script may touch. */
+    async transition({ id, from, attempt, change }) {
+        const record = await this.record(id);
+        if (record === undefined) {
+            return false;
+        }
+        const keys = [
+            this.key('records'),
+            ...['waiting', 'running', 'dead'].map((set) => this.key(set, record.queue)),
+            this.key('finished'),
+        ];
+        const held = attempt === undefined ? '' : String(attempt);
+        const applied = await this.client.eval(TRANSITION_JOB, keys.length, ...keys, id, from, held, JSON.stringify(change));
+        return Number(applied) === 1;
+    }
+    async record(id) {
+        const raw = await this.client.hget(this.key('records'), id);
+        return raw === null ? undefined : parseJobRecord(raw);
+    }
+    key(...parts) {
+        return [this.prefix, ...parts].join(':');
+    }
+}
+/** JSON of a value, or `false` (the field is removed) for `undefined`, which JSON cannot write. */
+function jsonOrFalse(value) {
+    return value === undefined ? false : JSON.stringify(value);
+}
+//# sourceMappingURL=redis-job-store.js.map

package/dist/jobs/redis-job-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-job-store.js","sourceRoot":"","sources":["../../src/jobs/redis-job-store.ts"],"names":[],"mappings":"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"}

package/dist/jobs/report-lost-jobs.d.ts

@@ -0,0 +1,10 @@
+import { type ErrorReporter, type Logger } from '@ddd-ts-kit/kernel';
+/**
+ * The `onLostJob` of a `RedisJobStore` a composition root wires: a job a committed command
+ * enqueued, or a cancellation it decided, that Redis did not take is logged, and reported when a
+ * reporter is given: never dropped in silence.
+ *
+ *     new RedisJobStore(client, { onLostJob: reportLostJobs(logger, errors) });
+ */
+export declare function reportLostJobs(logger: Logger, errors?: ErrorReporter): (error: unknown, jobId: string) => void;
+//# sourceMappingURL=report-lost-jobs.d.ts.map

package/dist/jobs/report-lost-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-lost-jobs.d.ts","sourceRoot":"","sources":["../../src/jobs/report-lost-jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEnG;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAY9G"}

package/dist/jobs/report-lost-jobs.js

@@ -0,0 +1,18 @@
+import { errorReportOf, identifyError } from '@ddd-ts-kit/kernel';
+/**
+ * The `onLostJob` of a `RedisJobStore` a composition root wires: a job a committed command
+ * enqueued, or a cancellation it decided, that Redis did not take is logged, and reported when a
+ * reporter is given: never dropped in silence.
+ *
+ *     new RedisJobStore(client, { onLostJob: reportLostJobs(logger, errors) });
+ */
+export function reportLostJobs(logger, errors) {
+    return (error, jobId) => {
+        logger.error('A background job write was lost after its unit of work committed', {
+            jobId,
+            ...identifyError(error),
+        });
+        errors?.report(error, errorReportOf(error, { origin: 'queue', operation: 'background job write', severity: 'error' }));
+    };
+}
+//# sourceMappingURL=report-lost-jobs.js.map

package/dist/jobs/report-lost-jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-lost-jobs.js","sourceRoot":"","sources":["../../src/jobs/report-lost-jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAmC,MAAM,oBAAoB,CAAC;AAEnG;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,MAAsB;IACnE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACtB,MAAM,CAAC,KAAK,CAAC,kEAAkE,EAAE;YAC/E,KAAK;YACL,GAAG,aAAa,CAAC,KAAK,CAAC;SACxB,CAAC,CAAC;QAEH,MAAM,EAAE,MAAM,CACZ,KAAK,EACL,aAAa,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAChG,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ddd-ts-kit/redis",
-  "version": "0.10.0",
-  "description": "Adapters of the kernel ports on the Redis protocol (Redis, Dragonfly, Valkey): cache, distributed lock, rate limiter, relay wake-up signal, and an integration event provider on Redis Streams.",
+  "version": "0.12.0",
+  "description": "Adapters of the kernel ports on the Redis protocol (Redis, Dragonfly, Valkey): cache, distributed lock, rate limiter, relay wake-up signal, a background job store, and an integration event provider on Redis Streams.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -34,11 +34,12 @@
     "dist"
   ],
   "dependencies": {
-    "@ddd-ts-kit/kernel": "0.10.0"
+    "@ddd-ts-kit/kernel": "0.12.0",
+    "@ddd-ts-kit/scheduling": "0.12.0"
   },
   "peerDependencies": {
     "ioredis": "^5.0.0 || ^6.0.0",
-    "@ddd-ts-kit/testing": "0.10.0"
+    "@ddd-ts-kit/testing": "0.12.0"
   },
   "peerDependenciesMeta": {
     "@ddd-ts-kit/testing": {
@@ -47,7 +48,7 @@
   },
   "devDependencies": {
     "ioredis": "^6.0.0",
-    "@ddd-ts-kit/events": "0.10.0",
-    "@ddd-ts-kit/testing": "0.10.0"
+    "@ddd-ts-kit/events": "0.12.0",
+    "@ddd-ts-kit/testing": "0.12.0"
   }
 }