@ultimat3/jobs 29.3.1 → 29.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/jobs",
-  "version": "29.3.1",
+  "version": "29.4.0",
   "description": "Durable background work: steps, transactional outbox, cron tasks, one driver interface",
   "license": "MIT",
   "type": "module",
@@ -33,10 +33,10 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "29.3.1",
-    "@ultimat3/db": "29.3.1",
-    "@ultimat3/entity": "29.3.1",
-    "@ultimat3/schema": "29.3.1",
-    "@ultimat3/time": "29.3.1"
+    "@ultimat3/core": "29.4.0",
+    "@ultimat3/db": "29.4.0",
+    "@ultimat3/entity": "29.4.0",
+    "@ultimat3/schema": "29.4.0",
+    "@ultimat3/time": "29.4.0"
   }
 }

package/src/leases.ts

@@ -50,8 +50,13 @@ export interface MemoryLeaseStoreOptions {
 export interface MemoryLeaseStore extends LeaseStore {
   /** Keys with at least one live slot. A key nothing holds is not retained — see `live`. */
   tracked(): number;
+  /** Keys in the heap right now, expired or not — no sweep. What the sweep's own test reads. */
+  retained(): number;
 }
 
+/** How often `acquire` sweeps every key for expired slots: at most once per this many ms. */
+export const LEASE_SWEEP_INTERVAL_MS = 60_000;
+
 /**
  * The `x dev` / test implementation. One heap, so it is not a fleet gate — it exists so the
  * memory driver enforces `concurrency` with the same code path the pg driver does, and so the
@@ -75,8 +80,22 @@ export function memoryLeaseStore(options: MemoryLeaseStoreOptions = {}): MemoryL
     return held;
   };
 
+  /**
+   * `live` only prunes the key it is asked about, so a key acquired once and never asked about
+   * again (its job's run crashed before release, one key per account) kept its expired slot for
+   * the life of the process. Bounded to once a minute: a sweep walks every key.
+   */
+  let swept = nowMs(clock);
+  const sweep = (): void => {
+    const at = nowMs(clock);
+    if (at - swept < LEASE_SWEEP_INTERVAL_MS) return;
+    swept = at;
+    for (const key of [...slots.keys()]) live(key);
+  };
+
   return {
     acquire(key, limit, ttlMs, holder) {
+      sweep();
       const held = live(key);
       for (let slot = 0; slot < limit; slot += 1) {
         if (held.has(slot)) continue;
@@ -114,6 +133,9 @@ export function memoryLeaseStore(options: MemoryLeaseStoreOptions = {}): MemoryL
       for (const key of [...slots.keys()]) live(key);
       return slots.size;
     },
+    retained() {
+      return slots.size;
+    },
   };
 }