@periodic/vanadium 1.0.0

package/dist/esm/adapters/redis/index.js

@@ -0,0 +1,173 @@
+/**
+ * Redis Storage Adapter for @periodic/vanadium
+ *
+ * Peer dependency: "redis" >= 4.0.0
+ * Import: import { createRedisAdapter } from '@periodic/vanadium/adapters/redis'
+ *
+ * The caller is responsible for creating and connecting the Redis client.
+ * This adapter NEVER creates its own connection.
+ */
+import { createStorageError, createConfigurationError } from '../../errors/index.js';
+import { safeJsonStringify, safeJsonParse } from '../../utils/crypto.js';
+import { buildNamespacedKey } from '../../utils/keys.js';
+// ─── Lua Scripts ─────────────────────────────────────────────────────────────
+/** Atomic CAS: compare ownerToken, replace if match */
+const LUA_CAS = `
+local current = redis.call('GET', KEYS[1])
+if current == false then return 0 end
+local record = cjson.decode(current)
+if record['ownerToken'] ~= ARGV[1] then return 0 end
+local ttl = tonumber(ARGV[3])
+if ttl > 0 then
+  redis.call('SET', KEYS[1], ARGV[2], 'PX', ttl)
+else
+  redis.call('SET', KEYS[1], ARGV[2])
+end
+return 1
+`;
+/** Safe delete: only delete if ownerToken matches */
+const LUA_SAFE_DELETE = `
+local current = redis.call('GET', KEYS[1])
+if current == false then return 0 end
+local record = cjson.decode(current)
+if record['ownerToken'] ~= ARGV[1] then return 0 end
+return redis.call('DEL', KEYS[1])
+`;
+// ─── Redis Adapter ────────────────────────────────────────────────────────────
+export class RedisAdapter {
+    constructor(options) {
+        this.name = 'redis';
+        if (!options.client) {
+            throw createConfigurationError('', 'redis', 'Redis adapter requires a connected client.');
+        }
+        this.client = options.client;
+        this.keyPrefix = options.keyPrefix ?? 'vanadium:';
+        this.namespace = options.namespace ?? '';
+        this.useLua = options.useLua ?? true;
+        this.clock = options.clock ?? Date.now;
+    }
+    // ── Storage Interface ─────────────────────────────────────────────────────
+    async get(key) {
+        const redisKey = this._buildKey(key);
+        try {
+            const raw = await this.client.get(redisKey);
+            if (raw === null)
+                return null;
+            return safeJsonParse(raw, `redis:${key}`);
+        }
+        catch (err) {
+            throw createStorageError(key, this.name, err, this.clock);
+        }
+    }
+    async set(key, value, ttlMs) {
+        const redisKey = this._buildKey(key);
+        let serialized;
+        try {
+            serialized = safeJsonStringify(value);
+        }
+        catch (err) {
+            throw createStorageError(key, this.name, err, this.clock);
+        }
+        try {
+            if (ttlMs !== undefined && ttlMs > 0) {
+                await this.client.set(redisKey, serialized, { PX: ttlMs });
+            }
+            else {
+                await this.client.set(redisKey, serialized);
+            }
+        }
+        catch (err) {
+            throw createStorageError(key, this.name, err, this.clock);
+        }
+    }
+    async delete(key) {
+        const redisKey = this._buildKey(key);
+        try {
+            await this.client.del(redisKey);
+        }
+        catch (err) {
+            throw createStorageError(key, this.name, err, this.clock);
+        }
+    }
+    async compareAndSet(key, expectedOwnerToken, newValue, ttlMs) {
+        const redisKey = this._buildKey(key);
+        let serialized;
+        try {
+            serialized = safeJsonStringify(newValue);
+        }
+        catch (err) {
+            throw createStorageError(key, this.name, err, this.clock);
+        }
+        try {
+            if (this.useLua) {
+                const result = await this.client.eval(LUA_CAS, {
+                    keys: [redisKey],
+                    arguments: [expectedOwnerToken, serialized, String(ttlMs ?? 0)],
+                });
+                return result === 1;
+            }
+            // Fallback: non-atomic (less safe — only for adapters without Lua)
+            const current = await this.client.get(redisKey);
+            if (!current)
+                return false;
+            const existing = safeJsonParse(current, `cas:${key}`);
+            if (existing.ownerToken !== expectedOwnerToken)
+                return false;
+            await this.set(key, newValue, ttlMs);
+            return true;
+        }
+        catch (err) {
+            if (err.type !== undefined)
+                throw err;
+            throw createStorageError(key, this.name, err, this.clock);
+        }
+    }
+    /**
+     * Safe owner-only delete using Lua. Use in lock release.
+     */
+    async safeDelete(key, ownerToken) {
+        const redisKey = this._buildKey(key);
+        try {
+            const result = await this.client.eval(LUA_SAFE_DELETE, {
+                keys: [redisKey],
+                arguments: [ownerToken],
+            });
+            return result === 1;
+        }
+        catch (err) {
+            throw createStorageError(key, this.name, err, this.clock);
+        }
+    }
+    // ── Capabilities ──────────────────────────────────────────────────────────
+    capabilities() {
+        return {
+            transactions: false,
+            cas: true,
+            ttl: true,
+            advisoryLocks: false,
+        };
+    }
+    // ── Private ───────────────────────────────────────────────────────────────
+    _buildKey(key) {
+        return buildNamespacedKey(key, this.keyPrefix, this.namespace);
+    }
+}
+// ─── Factory ──────────────────────────────────────────────────────────────────
+/**
+ * Create a Redis storage adapter.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from 'redis';
+ * import { createRedisAdapter } from '@periodic/vanadium/adapters/redis';
+ *
+ * const client = createClient({ url: process.env.REDIS_URL });
+ * await client.connect();
+ *
+ * const adapter = createRedisAdapter({ client, namespace: 'payments' });
+ * ```
+ */
+export function createRedisAdapter(options) {
+    return new RedisAdapter(options);
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/adapters/redis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/redis/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AA8BzD,gFAAgF;AAEhF,uDAAuD;AACvD,MAAM,OAAO,GAAG;;;;;;;;;;;;CAYf,CAAC;AAEF,qDAAqD;AACrD,MAAM,eAAe,GAAG;;;;;;CAMvB,CAAC;AAEF,iFAAiF;AAEjF,MAAM,OAAO,YAAY;IASvB,YAAY,OAA4B;QARxB,SAAI,GAAG,OAAO,CAAC;QAS7B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,wBAAwB,CAAC,EAAE,EAAE,OAAO,EAAE,4CAA4C,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,WAAW,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IACzC,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,GAAG,CAAc,GAAW;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC9B,OAAO,aAAa,CAAkB,GAAG,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAc,GAAW,EAAE,KAAsB,EAAE,KAAc;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,GAAW,EACX,kBAA0B,EAC1B,QAAyB,EACzB,KAAc;QAEd,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;oBAC7C,IAAI,EAAE,CAAC,QAAQ,CAAC;oBAChB,SAAS,EAAE,CAAC,kBAAkB,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;iBAChE,CAAC,CAAC;gBACH,OAAO,MAAM,KAAK,CAAC,CAAC;YACtB,CAAC;YAED,mEAAmE;YACnE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChD,IAAI,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAC;YAC3B,MAAM,QAAQ,GAAG,aAAa,CAAkB,OAAO,EAAE,OAAO,GAAG,EAAE,CAAC,CAAC;YACvE,IAAI,QAAQ,CAAC,UAAU,KAAK,kBAAkB;gBAAE,OAAO,KAAK,CAAC;YAC7D,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAAyB,CAAC,IAAI,KAAK,SAAS;gBAAE,MAAM,GAAG,CAAC;YAC7D,MAAM,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,UAAkB;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;gBACrD,IAAI,EAAE,CAAC,QAAQ,CAAC;gBAChB,SAAS,EAAE,CAAC,UAAU,CAAC;aACxB,CAAC,CAAC;YACH,OAAO,MAAM,KAAK,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,6EAA6E;IAE7E,YAAY;QACV,OAAO;YACL,YAAY,EAAE,KAAK;YACnB,GAAG,EAAE,IAAI;YACT,GAAG,EAAE,IAAI;YACT,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;IAED,6EAA6E;IAErE,SAAS,CAAC,GAAW;QAC3B,OAAO,kBAAkB,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;CACF;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/dist/esm/cleanup/engine.js

@@ -0,0 +1,95 @@
+const DEFAULT_INTERVAL_MS = 60000; // 1 minute
+const DEFAULT_STALE_THRESHOLD_MS = 10 * 60000; // 10 minutes
+// ─── Cleanup Engine ───────────────────────────────────────────────────────────
+/**
+ * Optional background cleanup engine.
+ *
+ * Scans for orphaned IN_PROGRESS records and removes or marks them FAILED.
+ * Does NOT break distributed semantics — TTL handles the authoritative expiry.
+ * This is purely a maintenance utility.
+ *
+ * @example
+ * ```ts
+ * const cleanup = createCleanupEngine({ adapter, intervalMs: 30_000 });
+ * cleanup.start();
+ * process.on('SIGTERM', () => cleanup.stop());
+ * ```
+ */
+export class CleanupEngine {
+    constructor(options) {
+        this.intervalHandle = null;
+        this.running = false;
+        this.adapter = options.adapter;
+        this.intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+        this.staleThresholdMs = options.staleThresholdMs ?? DEFAULT_STALE_THRESHOLD_MS;
+        this.deleteOnClean = options.deleteOnClean ?? true;
+        this.clock = options.clock ?? Date.now;
+    }
+    /**
+     * Start the cleanup timer.
+     */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.intervalHandle = setInterval(() => {
+            void this._runCleanup();
+        }, this.intervalMs);
+        // Allow process to exit without waiting for cleanup timer
+        if (this.intervalHandle.unref) {
+            this.intervalHandle.unref();
+        }
+    }
+    /**
+     * Stop the cleanup timer gracefully.
+     */
+    stop() {
+        if (this.intervalHandle !== null) {
+            clearInterval(this.intervalHandle);
+            this.intervalHandle = null;
+        }
+        this.running = false;
+    }
+    /**
+     * Run a single cleanup pass manually (useful for testing).
+     */
+    async runOnce(keysToCheck) {
+        return this._cleanKeys(keysToCheck);
+    }
+    // ── Private ───────────────────────────────────────────────────────────────
+    async _runCleanup() {
+        // NOTE: The cleanup engine operates on keys that callers explicitly provide.
+        // A full scan requires adapter-level support (e.g., SCAN in Redis, SELECT in Postgres).
+        // This base implementation is a no-op periodic tick — adapters may extend it.
+        // Use runOnce(keys) to clean specific known stale keys.
+    }
+    async _cleanKeys(keys) {
+        const now = this.clock();
+        let cleaned = 0;
+        for (const key of keys) {
+            try {
+                const record = await this.adapter.get(key);
+                if (!record)
+                    continue;
+                if (record.status !== 'IN_PROGRESS')
+                    continue;
+                const staleAt = record.updatedAt + this.staleThresholdMs;
+                if (now < staleAt)
+                    continue;
+                if (this.deleteOnClean) {
+                    await this.adapter.delete(key);
+                }
+                cleaned++;
+            }
+            catch {
+                // Best effort — never let cleanup crash the app
+            }
+        }
+        return cleaned;
+    }
+}
+// ─── Factory ──────────────────────────────────────────────────────────────────
+export function createCleanupEngine(options) {
+    return new CleanupEngine(options);
+}
+//# sourceMappingURL=engine.js.map

package/dist/esm/cleanup/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/cleanup/engine.ts"],"names":[],"mappings":"AAEA,MAAM,mBAAmB,GAAG,KAAM,CAAC,CAAC,WAAW;AAC/C,MAAM,0BAA0B,GAAG,EAAE,GAAG,KAAM,CAAC,CAAC,aAAa;AAE7D,iFAAiF;AAEjF;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAa;IAUxB,YAAY,OAAuB;QAT3B,mBAAc,GAA0C,IAAI,CAAC;QAC7D,YAAO,GAAG,KAAK,CAAC;QAStB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;QAC5D,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;QAC/E,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;QACnD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACrC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1B,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEpB,0DAA0D;QAC1D,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACjC,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,WAAqB;QACjC,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,6EAA6E;IAErE,KAAK,CAAC,WAAW;QACvB,6EAA6E;QAC7E,wFAAwF;QACxF,8EAA8E;QAC9E,wDAAwD;IAC1D,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,IAAc;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC3C,IAAI,CAAC,MAAM;oBAAE,SAAS;gBACtB,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa;oBAAE,SAAS;gBAE9C,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC;gBACzD,IAAI,GAAG,GAAG,OAAO;oBAAE,SAAS;gBAE5B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBACvB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjC,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC;YAAC,MAAM,CAAC;gBACP,gDAAgD;YAClD,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,iFAAiF;AAEjF,MAAM,UAAU,mBAAmB,CAAC,OAAuB;IACzD,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/esm/core/concurrencyGuard.js

@@ -0,0 +1,46 @@
+/**
+ * Local concurrency guard — prevents redundant concurrent calls to the
+ * distributed adapter for the same key within a single process.
+ *
+ * This is a performance optimization ONLY. It does NOT replace the
+ * distributed guarantee provided by the storage adapter.
+ */
+export class ConcurrencyGuard {
+    constructor() {
+        this.inFlight = new Map();
+    }
+    /**
+     * If a promise for this key is already in-flight, return it.
+     * Otherwise, register the new promise and clean up when it settles.
+     */
+    wrap(key, fn) {
+        const existing = this.inFlight.get(key);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const promise = fn().finally(() => {
+            this.inFlight.delete(key);
+        });
+        this.inFlight.set(key, promise);
+        return promise;
+    }
+    /**
+     * Check if a key is currently in-flight locally.
+     */
+    isInFlight(key) {
+        return this.inFlight.has(key);
+    }
+    /**
+     * Return the number of keys currently tracked.
+     */
+    size() {
+        return this.inFlight.size;
+    }
+    /**
+     * Clear all tracked keys (for testing / cleanup).
+     */
+    clear() {
+        this.inFlight.clear();
+    }
+}
+//# sourceMappingURL=concurrencyGuard.js.map

package/dist/esm/core/concurrencyGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrencyGuard.js","sourceRoot":"","sources":["../../../src/core/concurrencyGuard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAA7B;QACmB,aAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAwClE,CAAC;IAtCC;;;OAGG;IACH,IAAI,CAAI,GAAW,EAAE,EAAoB;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,QAAsB,CAAC;QAChC,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YAChC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/esm/core/metrics.js

@@ -0,0 +1,35 @@
+// ─── Metrics Store ────────────────────────────────────────────────────────────
+/**
+ * Mutable metrics container. One instance per engine.
+ * Never uses global state.
+ */
+export class MetricsStore {
+    constructor() {
+        this.data = {
+            totalExecutions: 0,
+            totalDuplicates: 0,
+            totalLocksAcquired: 0,
+            totalLockFailures: 0,
+            totalPayloadMismatches: 0,
+            inProgressCount: 0,
+            totalTakeovers: 0,
+            totalStorageErrors: 0,
+            totalFailuresCached: 0,
+        };
+    }
+    increment(key, amount = 1) {
+        this.data[key] += amount;
+    }
+    decrement(key, amount = 1) {
+        this.data[key] = Math.max(0, this.data[key] - amount);
+    }
+    get() {
+        return { ...this.data };
+    }
+    reset() {
+        for (const key of Object.keys(this.data)) {
+            this.data[key] = 0;
+        }
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/esm/core/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/core/metrics.ts"],"names":[],"mappings":"AAEA,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,OAAO,YAAY;IAAzB;QACU,SAAI,GAAoB;YAC9B,eAAe,EAAE,CAAC;YAClB,eAAe,EAAE,CAAC;YAClB,kBAAkB,EAAE,CAAC;YACrB,iBAAiB,EAAE,CAAC;YACpB,sBAAsB,EAAE,CAAC;YACzB,eAAe,EAAE,CAAC;YAClB,cAAc,EAAE,CAAC;YACjB,kBAAkB,EAAE,CAAC;YACrB,mBAAmB,EAAE,CAAC;SACvB,CAAC;IAmBJ,CAAC;IAjBC,SAAS,CAAC,GAA0B,EAAE,MAAM,GAAG,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,GAA0B,EAAE,MAAM,GAAG,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,GAAG;QACD,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAA8B,EAAE,CAAC;YACtE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}

package/dist/esm/core/stateMachine.js

@@ -0,0 +1,40 @@
+import { createStateTransitionError } from '../errors/index.js';
+// ─── Valid Transitions ────────────────────────────────────────────────────────
+const VALID_TRANSITIONS = new Set([
+    'IN_PROGRESS -> COMPLETED',
+    'IN_PROGRESS -> FAILED',
+    'IN_PROGRESS -> IN_PROGRESS', // expired takeover only
+]);
+// ─── State Machine ────────────────────────────────────────────────────────────
+/**
+ * Assert that a transition from one execution status to another is valid.
+ * Throws a VanadiumError(STATE_TRANSITION_ERROR) on illegal transitions.
+ */
+export function assertValidTransition(from, to, key, adapterName, clock = Date.now) {
+    const transition = `${from} -> ${to}`;
+    if (!VALID_TRANSITIONS.has(transition)) {
+        throw createStateTransitionError(key, adapterName, from, to, clock);
+    }
+}
+/**
+ * Check if a transition is valid without throwing.
+ */
+export function isValidTransition(from, to) {
+    return VALID_TRANSITIONS.has(`${from} -> ${to}`);
+}
+/**
+ * Determine whether a stored record has expired based on current time.
+ */
+export function isExpired(expiresAt, clock = Date.now) {
+    if (expiresAt === undefined)
+        return false;
+    return clock() >= expiresAt;
+}
+/**
+ * Determine whether an IN_PROGRESS record can be taken over.
+ * Requires: status is IN_PROGRESS AND expiresAt has passed.
+ */
+export function canTakeover(status, expiresAt, clock = Date.now) {
+    return status === 'IN_PROGRESS' && isExpired(expiresAt, clock);
+}
+//# sourceMappingURL=stateMachine.js.map

package/dist/esm/core/stateMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateMachine.js","sourceRoot":"","sources":["../../../src/core/stateMachine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhE,iFAAiF;AAEjF,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS;IACxC,0BAA0B;IAC1B,uBAAuB;IACvB,4BAA4B,EAAE,wBAAwB;CACvD,CAAC,CAAC;AAEH,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAqB,EACrB,EAAmB,EACnB,GAAW,EACX,WAAmB,EACnB,QAAsB,IAAI,CAAC,GAAG;IAE9B,MAAM,UAAU,GAAG,GAAG,IAAI,OAAO,EAAE,EAAE,CAAC;IACtC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,MAAM,0BAA0B,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAqB,EAAE,EAAmB;IAC1E,OAAO,iBAAiB,CAAC,GAAG,CAAC,GAAG,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,SAA6B,EAAE,QAAsB,IAAI,CAAC,GAAG;IACrF,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,KAAK,EAAE,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAuB,EACvB,SAA6B,EAC7B,QAAsB,IAAI,CAAC,GAAG;IAE9B,OAAO,MAAM,KAAK,aAAa,IAAI,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACjE,CAAC"}

package/dist/esm/errors/index.js

@@ -0,0 +1,114 @@
+export class VanadiumError extends Error {
+    constructor(details) {
+        super(details.message);
+        this.name = 'VanadiumError';
+        this.type = details.type;
+        this.key = details.key;
+        this.adapterName = details.adapterName;
+        this.timestamp = details.timestamp;
+        this.originalError = details.originalError;
+        this.attempts = details.attempts;
+        this.payloadHash = details.payloadHash;
+        // Maintain proper prototype chain
+        Object.setPrototypeOf(this, VanadiumError.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, VanadiumError);
+        }
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            type: this.type,
+            message: this.message,
+            key: this.key,
+            adapterName: this.adapterName,
+            timestamp: this.timestamp,
+            attempts: this.attempts,
+            payloadHash: this.payloadHash,
+        };
+    }
+}
+// ─── Error Factories ──────────────────────────────────────────────────────────
+export function createDuplicateExecutionError(key, adapterName, clock = Date.now) {
+    return new VanadiumError({
+        type: 'DUPLICATE_EXECUTION',
+        key,
+        adapterName,
+        timestamp: clock(),
+        message: `Duplicate execution detected for key "${key}". Returning cached result.`,
+    });
+}
+export function createInProgressError(key, adapterName, attempts, clock = Date.now) {
+    return new VanadiumError({
+        type: 'IN_PROGRESS',
+        key,
+        adapterName,
+        timestamp: clock(),
+        attempts,
+        message: `Execution for key "${key}" is currently in progress (attempt ${attempts}). Another node owns execution.`,
+    });
+}
+export function createLockAcquisitionFailedError(key, adapterName, clock = Date.now) {
+    return new VanadiumError({
+        type: 'LOCK_ACQUISITION_FAILED',
+        key,
+        adapterName,
+        timestamp: clock(),
+        message: `Failed to acquire lock for key "${key}".`,
+    });
+}
+export function createLockTimeoutError(key, adapterName, maxWaitMs, clock = Date.now) {
+    return new VanadiumError({
+        type: 'LOCK_TIMEOUT',
+        key,
+        adapterName,
+        timestamp: clock(),
+        message: `Timed out waiting to acquire lock for key "${key}" after ${maxWaitMs}ms.`,
+    });
+}
+export function createPayloadMismatchError(key, adapterName, storedHash, incomingHash, clock = Date.now) {
+    return new VanadiumError({
+        type: 'PAYLOAD_MISMATCH',
+        key,
+        adapterName,
+        timestamp: clock(),
+        payloadHash: incomingHash,
+        message: `Payload mismatch for key "${key}". ` +
+            `Stored hash: "${storedHash ?? 'none'}", Incoming hash: "${incomingHash}". ` +
+            `The same idempotency key cannot be used with different payloads.`,
+    });
+}
+export function createConfigurationError(key, adapterName, message, clock = Date.now) {
+    return new VanadiumError({
+        type: 'CONFIGURATION_ERROR',
+        key,
+        adapterName,
+        timestamp: clock(),
+        message,
+    });
+}
+export function createStorageError(key, adapterName, originalError, clock = Date.now) {
+    const msg = originalError instanceof Error ? originalError.message : String(originalError);
+    return new VanadiumError({
+        type: 'STORAGE_ERROR',
+        key,
+        adapterName,
+        timestamp: clock(),
+        originalError,
+        message: `Storage error for key "${key}" in adapter "${adapterName}": ${msg}`,
+    });
+}
+export function createStateTransitionError(key, adapterName, from, to, clock = Date.now) {
+    return new VanadiumError({
+        type: 'STATE_TRANSITION_ERROR',
+        key,
+        adapterName,
+        timestamp: clock(),
+        message: `Invalid state transition for key "${key}": ${from} -> ${to}`,
+    });
+}
+// ─── Type Guard ───────────────────────────────────────────────────────────────
+export function isVanadiumError(err) {
+    return err instanceof VanadiumError;
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/errors/index.js.map

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

package/dist/esm/http/express.js

@@ -0,0 +1,81 @@
+/**
+ * Express middleware for @periodic/vanadium
+ *
+ * Automatically wraps HTTP handlers with idempotency semantics.
+ * Reads the Idempotency-Key header and caches successful responses.
+ *
+ * @example
+ * ```ts
+ * import express from 'express';
+ * import { createIdempotency, createMemoryAdapter } from '@periodic/vanadium';
+ * import { vanadiumMiddleware } from '@periodic/vanadium/http/express';
+ *
+ * const app = express();
+ * const idempotency = createIdempotency({ adapter: createMemoryAdapter(), ttlMs: 86_400_000 });
+ *
+ * app.post('/payments', vanadiumMiddleware(idempotency), async (req, res) => {
+ *   const result = await chargeCard(req.body);
+ *   res.json(result);
+ * });
+ * ```
+ */
+import { isVanadiumError } from '../errors/index.js';
+// ─── Middleware Factory ───────────────────────────────────────────────────────
+/**
+ * Create Express middleware that enforces idempotency on HTTP handlers.
+ */
+export function vanadiumMiddleware(idempotency, options = {}) {
+    const headerName = options.headerName ?? 'idempotency-key';
+    const methods = (options.methods ?? ['POST', 'PUT', 'PATCH']).map((m) => m.toUpperCase());
+    return function vanadiumHandler(req, res, next) {
+        if (!methods.includes(req.method.toUpperCase())) {
+            next();
+            return;
+        }
+        const rawHeader = req.headers[headerName.toLowerCase()];
+        const idempotencyKey = Array.isArray(rawHeader) ? rawHeader[0] : rawHeader;
+        if (!idempotencyKey) {
+            next();
+            return;
+        }
+        const fullKey = `http:${req.method}:${req.path}:${idempotencyKey}`;
+        void idempotency
+            .execute(fullKey, () => {
+            return new Promise((resolve, _reject) => {
+                // Intercept res.json to capture the response
+                const originalJson = res.json.bind(res);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                res.json = function (body) {
+                    const statusCode = res.statusCode ?? 200;
+                    originalJson(body);
+                    resolve({ statusCode, body });
+                };
+                next();
+            });
+        })
+            .then((cached) => {
+            // If we got here without executing the handler (duplicate), replay cached response
+            if (cached) {
+                res.status(cached.statusCode).json(cached.body);
+            }
+        })
+            .catch((err) => {
+            if (isVanadiumError(err)) {
+                if (err.type === 'DUPLICATE_EXECUTION') {
+                    // Already handled — no-op
+                    return;
+                }
+                if (err.type === 'IN_PROGRESS') {
+                    res.status(409).json({
+                        error: 'Request is currently being processed',
+                        type: 'IN_PROGRESS',
+                        key: err.key,
+                    });
+                    return;
+                }
+            }
+            next(err);
+        });
+    };
+}
+//# sourceMappingURL=express.js.map

package/dist/esm/http/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../../src/http/express.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAyCrD,iFAAiF;AAEjF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAA8B,EAC9B,UAAqC,EAAE;IAEvC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC;IAC3D,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1F,OAAO,SAAS,eAAe,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB;QAC7E,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAChD,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;QACxD,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE3E,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,cAAc,EAAE,CAAC;QAEnE,KAAK,WAAW;aACb,OAAO,CAAiB,OAAO,EAAE,GAAG,EAAE;YACrC,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;gBACtD,6CAA6C;gBAC7C,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAExC,8DAA8D;gBAC9D,GAAG,CAAC,IAAI,GAAG,UAAU,IAAS;oBAC5B,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC;oBACzC,YAAY,CAAC,IAAI,CAAC,CAAC;oBACnB,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChC,CAAC,CAAC;gBAEF,IAAI,EAAE,CAAC;YACT,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,mFAAmF;YACnF,IAAI,MAAM,EAAE,CAAC;gBACX,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,IAAI,GAAG,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;oBACvC,0BAA0B;oBAC1B,OAAO;gBACT,CAAC;gBACD,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBAC/B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;wBACnB,KAAK,EAAE,sCAAsC;wBAC7C,IAAI,EAAE,aAAa;wBACnB,GAAG,EAAE,GAAG,CAAC,GAAG;qBACb,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;YACH,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;AACJ,CAAC"}