@periodic/vanadium 1.0.0

package/dist/cjs/resilience/circuitBreaker.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreakerAdapter = void 0;
+exports.createCircuitBreaker = createCircuitBreaker;
+const index_js_1 = require("../errors/index.js");
+const sleep_js_1 = require("../utils/sleep.js");
+const DEFAULT_FAILURE_THRESHOLD = 5;
+const DEFAULT_RESET_TIMEOUT_MS = 30000;
+const DEFAULT_HALF_OPEN_MAX_CALLS = 1;
+// ─── Circuit Breaker ──────────────────────────────────────────────────────────
+/**
+ * Wraps a StorageAdapter with a circuit breaker pattern.
+ * Protects the application from repeated storage failures.
+ *
+ * States:
+ * - CLOSED: Normal operation. Failures counted.
+ * - OPEN: Storage blocked. All calls throw immediately.
+ * - HALF_OPEN: Probe mode. Limited calls allowed to test recovery.
+ */
+class CircuitBreakerAdapter {
+    constructor(adapter, options = {}, clock = Date.now) {
+        this.state = 'CLOSED';
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.halfOpenCalls = 0;
+        this.adapter = adapter;
+        this.name = `circuit-breaker(${adapter.name})`;
+        this.failureThreshold = options.failureThreshold ?? DEFAULT_FAILURE_THRESHOLD;
+        this.resetTimeoutMs = options.resetTimeoutMs ?? DEFAULT_RESET_TIMEOUT_MS;
+        this.halfOpenMaxCalls = options.halfOpenMaxCalls ?? DEFAULT_HALF_OPEN_MAX_CALLS;
+        this.clock = clock;
+        this.lastFailureAt = clock();
+    }
+    // ── StorageAdapter implementation ─────────────────────────────────────────
+    async get(key) {
+        return this._execute(() => this.adapter.get(key), key);
+    }
+    async set(key, value, ttlMs) {
+        return this._execute(() => this.adapter.set(key, value, ttlMs), key);
+    }
+    async delete(key) {
+        return this._execute(() => this.adapter.delete(key), key);
+    }
+    async compareAndSet(key, expectedOwnerToken, newValue, ttlMs) {
+        if (!this.adapter.compareAndSet) {
+            throw (0, index_js_1.createStorageError)(key, this.name, new Error('Adapter does not support compareAndSet'), this.clock);
+        }
+        return this._execute(() => this.adapter.compareAndSet(key, expectedOwnerToken, newValue, ttlMs), key);
+    }
+    // ── State Inspection ──────────────────────────────────────────────────────
+    getState() {
+        this._checkReset();
+        return this.state;
+    }
+    reset() {
+        this.state = 'CLOSED';
+        this.failureCount = 0;
+        this.successCount = 0;
+        this.halfOpenCalls = 0;
+    }
+    // ── Private ───────────────────────────────────────────────────────────────
+    async _execute(fn, key) {
+        this._checkReset();
+        if (this.state === 'OPEN') {
+            throw (0, index_js_1.createStorageError)(key, this.name, new Error(`Circuit breaker is OPEN for adapter "${this.adapter.name}". Storage calls blocked.`), this.clock);
+        }
+        if (this.state === 'HALF_OPEN' && this.halfOpenCalls >= this.halfOpenMaxCalls) {
+            await (0, sleep_js_1.sleep)(100); // brief backoff
+            throw (0, index_js_1.createStorageError)(key, this.name, new Error('Circuit breaker is HALF_OPEN. Probe call limit reached.'), this.clock);
+        }
+        if (this.state === 'HALF_OPEN') {
+            this.halfOpenCalls++;
+        }
+        try {
+            const result = await fn();
+            this._onSuccess();
+            return result;
+        }
+        catch (err) {
+            this._onFailure();
+            throw err;
+        }
+    }
+    _onSuccess() {
+        this.failureCount = 0;
+        this.successCount++;
+        if (this.state === 'HALF_OPEN') {
+            this.state = 'CLOSED';
+            this.halfOpenCalls = 0;
+        }
+    }
+    _onFailure() {
+        this.failureCount++;
+        this.lastFailureAt = this.clock();
+        if (this.state === 'HALF_OPEN') {
+            this.state = 'OPEN';
+            this.halfOpenCalls = 0;
+        }
+        else if (this.failureCount >= this.failureThreshold) {
+            this.state = 'OPEN';
+        }
+    }
+    _checkReset() {
+        if (this.state === 'OPEN') {
+            const elapsed = this.clock() - this.lastFailureAt;
+            if (elapsed >= this.resetTimeoutMs) {
+                this.state = 'HALF_OPEN';
+                this.halfOpenCalls = 0;
+            }
+        }
+    }
+}
+exports.CircuitBreakerAdapter = CircuitBreakerAdapter;
+// ─── Factory ──────────────────────────────────────────────────────────────────
+/**
+ * Wrap any StorageAdapter with a circuit breaker.
+ *
+ * @example
+ * ```ts
+ * const protectedAdapter = createCircuitBreaker(redisAdapter, {
+ *   failureThreshold: 3,
+ *   resetTimeoutMs: 15_000,
+ * });
+ * ```
+ */
+function createCircuitBreaker(adapter, options, clock) {
+    return new CircuitBreakerAdapter(adapter, options, clock);
+}
+//# sourceMappingURL=circuitBreaker.js.map

package/dist/cjs/resilience/circuitBreaker.js.map

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

package/dist/cjs/types/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * @periodic/vanadium — Core Type Definitions
+ * Deterministic idempotency and distributed lock engine
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_TRANSITIONS = void 0;
+exports.VALID_TRANSITIONS = [
+    'IN_PROGRESS -> COMPLETED',
+    'IN_PROGRESS -> FAILED',
+    'IN_PROGRESS -> IN_PROGRESS', // expired takeover
+];
+//# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA2OU,QAAA,iBAAiB,GAA+B;IAC3D,0BAA0B;IAC1B,uBAAuB;IACvB,4BAA4B,EAAE,mBAAmB;CACzC,CAAC"}

package/dist/cjs/utils/crypto.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashPayload = hashPayload;
+exports.generateOwnerToken = generateOwnerToken;
+exports.safeJsonStringify = safeJsonStringify;
+exports.safeJsonParse = safeJsonParse;
+const node_crypto_1 = require("node:crypto");
+/**
+ * Deterministically hash an arbitrary payload using SHA-256.
+ * JSON.stringify order is normalized using sorted keys for determinism.
+ */
+function hashPayload(payload) {
+    const normalized = JSON.stringify(sortKeys(payload));
+    return (0, node_crypto_1.createHash)('sha256').update(normalized).digest('hex');
+}
+/**
+ * Recursively sort object keys for deterministic JSON serialization.
+ */
+function sortKeys(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(sortKeys);
+    }
+    const sorted = {};
+    for (const key of Object.keys(value).sort()) {
+        sorted[key] = sortKeys(value[key]);
+    }
+    return sorted;
+}
+/**
+ * Generate a cryptographically secure owner token (UUID v4).
+ */
+function generateOwnerToken() {
+    return (0, node_crypto_1.randomUUID)();
+}
+/**
+ * Safely serialize a value to JSON string.
+ * Throws STORAGE_ERROR compatible message on failure.
+ */
+function safeJsonStringify(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`JSON serialization failed: ${msg}`);
+    }
+}
+/**
+ * Safely parse a JSON string.
+ * Throws STORAGE_ERROR compatible message on failure.
+ */
+function safeJsonParse(raw, context = 'record') {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`JSON parse failure in ${context}: ${msg}`);
+    }
+}
+//# sourceMappingURL=crypto.js.map

package/dist/cjs/utils/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../../src/utils/crypto.ts"],"names":[],"mappings":";;AAMA,kCAGC;AAsBD,gDAEC;AAMD,8CAOC;AAMD,sCAOC;AA3DD,6CAAqD;AAErD;;;GAGG;AACH,SAAgB,WAAW,CAAC,OAAgB;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACvE,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO,IAAA,wBAAU,GAAE,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAc,GAAW,EAAE,OAAO,GAAG,QAAQ;IACxE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,KAAK,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}

package/dist/cjs/utils/keys.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateKey = validateKey;
+exports.buildNamespacedKey = buildNamespacedKey;
+exports.assertValidKey = assertValidKey;
+const index_js_1 = require("../errors/index.js");
+const MAX_KEY_LENGTH = 512;
+const VALID_KEY_PATTERN = /^[\w\-:.@/]+$/;
+/**
+ * Validate an idempotency key for safety and format correctness.
+ * Throws a VanadiumError (CONFIGURATION_ERROR) on invalid input.
+ */
+function validateKey(key, adapterName) {
+    if (!key || key.trim().length === 0) {
+        throw (0, index_js_1.createConfigurationError)(key, adapterName, 'Idempotency key must be a non-empty string.');
+    }
+    if (key.length > MAX_KEY_LENGTH) {
+        throw (0, index_js_1.createConfigurationError)(key, adapterName, `Idempotency key exceeds maximum length of ${MAX_KEY_LENGTH} characters. Got ${key.length}.`);
+    }
+    if (!VALID_KEY_PATTERN.test(key)) {
+        throw (0, index_js_1.createConfigurationError)(key, adapterName, `Idempotency key "${key}" contains invalid characters. ` +
+            `Allowed: alphanumeric, hyphens, underscores, colons, dots, @, and forward slashes.`);
+    }
+}
+/**
+ * Build a namespaced key: prefix + namespace + key.
+ * Example: "vanadium:payments:order_123"
+ */
+function buildNamespacedKey(key, prefix = '', namespace = '') {
+    const parts = [prefix, namespace, key].filter(Boolean);
+    return parts.join(':');
+}
+/**
+ * Assert the key is valid and return it unchanged (for chaining).
+ */
+function assertValidKey(key, adapterName) {
+    validateKey(key, adapterName);
+    return key;
+}
+//# sourceMappingURL=keys.js.map

package/dist/cjs/utils/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/utils/keys.ts"],"names":[],"mappings":";;AASA,kCAmBC;AAMD,gDAGC;AAKD,wCAGC;AA7CD,iDAA8D;AAE9D,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAE1C;;;GAGG;AACH,SAAgB,WAAW,CAAC,GAAW,EAAE,WAAmB;IAC1D,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAA,mCAAwB,EAAC,GAAG,EAAE,WAAW,EAAE,6CAA6C,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,IAAA,mCAAwB,EAC5B,GAAG,EACH,WAAW,EACX,6CAA6C,cAAc,oBAAoB,GAAG,CAAC,MAAM,GAAG,CAC7F,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,IAAA,mCAAwB,EAC5B,GAAG,EACH,WAAW,EACX,oBAAoB,GAAG,iCAAiC;YACtD,oFAAoF,CACvF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,GAAW,EAAE,MAAM,GAAG,EAAE,EAAE,SAAS,GAAG,EAAE;IACzE,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,GAAW,EAAE,WAAmB;IAC7D,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cjs/utils/sleep.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = sleep;
+exports.jitter = jitter;
+exports.sleepWithJitter = sleepWithJitter;
+/**
+ * Non-blocking async sleep.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Add ±jitter to a base delay to prevent thundering herd.
+ */
+function jitter(baseMs, factor = 0.2) {
+    const delta = baseMs * factor;
+    return baseMs + (Math.random() * 2 - 1) * delta;
+}
+/**
+ * Sleep with jitter applied.
+ */
+function sleepWithJitter(baseMs, factor = 0.2) {
+    return sleep(jitter(baseMs, factor));
+}
+//# sourceMappingURL=sleep.js.map

package/dist/cjs/utils/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../src/utils/sleep.ts"],"names":[],"mappings":";;AAGA,sBAEC;AAKD,wBAGC;AAKD,0CAEC;AApBD;;GAEG;AACH,SAAgB,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAC,MAAc,EAAE,MAAM,GAAG,GAAG;IACjD,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9B,OAAO,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,MAAc,EAAE,MAAM,GAAG,GAAG;IAC1D,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AACvC,CAAC"}

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

@@ -0,0 +1,129 @@
+import { createStorageError } from '../../errors/index.js';
+// ─── Memory Storage Adapter ───────────────────────────────────────────────────
+/**
+ * Built-in in-memory storage adapter.
+ *
+ * Features:
+ * - O(1) key lookup via Map
+ * - Automatic TTL eviction on read
+ * - Optional maxKeys with LRU eviction to prevent unbounded growth
+ * - No global state — each instance is isolated
+ *
+ * @example
+ * ```ts
+ * import { createMemoryAdapter } from '@periodic/vanadium';
+ * const adapter = createMemoryAdapter({ maxKeys: 10_000 });
+ * ```
+ */
+export class MemoryAdapter {
+    constructor(options = {}) {
+        this.name = 'memory';
+        this.store = new Map();
+        this.maxKeys = options.maxKeys ?? Infinity;
+        this.clock = options.clock ?? Date.now;
+    }
+    async get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return null;
+        const now = this.clock();
+        // Return expired IN_PROGRESS records so callers can attempt takeover
+        if (entry.expiresAt !== undefined && now >= entry.expiresAt) {
+            if (entry.record.status === 'IN_PROGRESS') {
+                entry.lastAccessed = now;
+                return { ...entry.record };
+            }
+            this.store.delete(key);
+            return null;
+        }
+        entry.lastAccessed = now;
+        return { ...entry.record };
+    }
+    async set(key, value, ttlMs) {
+        const now = this.clock();
+        const expiresAt = ttlMs !== undefined ? now + ttlMs : undefined;
+        // Evict LRU entries if at capacity
+        if (!this.store.has(key) && this.store.size >= this.maxKeys) {
+            this._evictLRU();
+        }
+        this.store.set(key, {
+            record: { ...value },
+            expiresAt,
+            lastAccessed: now,
+        });
+    }
+    async delete(key) {
+        this.store.delete(key);
+    }
+    async compareAndSet(key, expectedOwnerToken, newValue, ttlMs) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return false;
+        if (entry.record.ownerToken !== expectedOwnerToken)
+            return false;
+        const now = this.clock();
+        const expiresAt = ttlMs !== undefined ? now + ttlMs : entry.expiresAt;
+        this.store.set(key, {
+            record: { ...newValue },
+            expiresAt,
+            lastAccessed: now,
+        });
+        return true;
+    }
+    // ── Maintenance ───────────────────────────────────────────────────────────
+    async setIfAbsent(key, value, ttlMs) {
+        const now = this.clock();
+        const existing = this.store.get(key);
+        if (existing !== undefined) {
+            if (existing.expiresAt === undefined || now < existing.expiresAt) {
+                return false;
+            }
+            this.store.delete(key);
+        }
+        const expiresAt = ttlMs !== undefined ? now + ttlMs : undefined;
+        this.store.set(key, {
+            record: { ...value },
+            expiresAt,
+            lastAccessed: now,
+        });
+        return true;
+    }
+    /** Evict the single least-recently-accessed entry. */
+    _evictLRU() {
+        let oldestKey;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.store) {
+            if (entry.lastAccessed < oldestTime) {
+                oldestTime = entry.lastAccessed;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey !== undefined) {
+            this.store.delete(oldestKey);
+        }
+    }
+    /** Return current number of stored keys. */
+    size() {
+        return this.store.size;
+    }
+    /** Clear all stored entries. */
+    clear() {
+        this.store.clear();
+    }
+    /** Expose adapter capabilities. */
+    capabilities() {
+        return {
+            transactions: false,
+            cas: true,
+            ttl: true,
+            advisoryLocks: false,
+        };
+    }
+}
+// ─── Factory ──────────────────────────────────────────────────────────────────
+export function createMemoryAdapter(options) {
+    return new MemoryAdapter(options);
+}
+// Suppress unused import warning — this file intentionally imports for type safety
+void createStorageError;
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,184 @@
+/**
+ * MongoDB Storage Adapter for @periodic/vanadium
+ *
+ * Peer dependency: "mongodb" >= 5.0.0
+ * Import: import { createMongoAdapter } from '@periodic/vanadium/adapters/mongodb'
+ *
+ * Uses the official MongoDB driver (NOT Mongoose).
+ * The caller is responsible for providing a connected MongoClient.
+ *
+ * Required indexes (run once):
+ * ```js
+ * db.collection('vanadium_records').createIndex({ expiresAt: 1 });
+ * db.collection('vanadium_records').createIndex({ status: 1, expiresAt: 1 });
+ * ```
+ */
+import { createStorageError, createConfigurationError } from '../../errors/index.js';
+/* eslint-enable @typescript-eslint/no-explicit-any */
+const MONGO_DUPLICATE_KEY_CODE = 11000;
+// ─── MongoDB Adapter ──────────────────────────────────────────────────────────
+export class MongoAdapter {
+    constructor(options) {
+        this.name = 'mongodb';
+        if (!options.client || !options.dbName) {
+            throw createConfigurationError('', 'mongodb', 'MongoDB adapter requires a client and dbName.');
+        }
+        this.db = options.client.db(options.dbName);
+        this.collectionName = options.collectionName ?? 'vanadium_records';
+        this.useTransactions = options.useTransactions ?? true;
+        this.clock = options.clock ?? Date.now;
+    }
+    get collection() {
+        return this.db.collection(this.collectionName);
+    }
+    // ── Storage Interface ─────────────────────────────────────────────────────
+    async get(key) {
+        try {
+            const doc = (await this.collection.findOne({ _id: key }));
+            if (!doc)
+                return null;
+            return this._docToRecord(doc);
+        }
+        catch (err) {
+            throw createStorageError(key, this.name, err, this.clock);
+        }
+    }
+    async set(key, value, ttlMs) {
+        const now = this.clock();
+        const expiresAt = ttlMs !== undefined ? now + ttlMs : value.expiresAt;
+        const doc = {
+            _id: key,
+            status: value.status,
+            result: value.result,
+            payloadHash: value.payloadHash,
+            ownerToken: value.ownerToken,
+            attempts: value.attempts,
+            createdAt: value.createdAt,
+            updatedAt: value.updatedAt,
+            expiresAt,
+        };
+        try {
+            // Try atomic insert first (first-writer-wins)
+            await this.collection.insertOne(doc);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== MONGO_DUPLICATE_KEY_CODE) {
+                throw createStorageError(key, this.name, err, this.clock);
+            }
+            // Key exists — update it
+            try {
+                await this.collection.findOneAndUpdate({ _id: key }, {
+                    $set: {
+                        status: value.status,
+                        result: value.result,
+                        payloadHash: value.payloadHash,
+                        ownerToken: value.ownerToken,
+                        attempts: value.attempts,
+                        updatedAt: value.updatedAt,
+                        expiresAt,
+                    },
+                }, { returnDocument: 'after' });
+            }
+            catch (updateErr) {
+                throw createStorageError(key, this.name, updateErr, this.clock);
+            }
+        }
+    }
+    async delete(key) {
+        try {
+            await this.collection.deleteOne({ _id: key });
+        }
+        catch (err) {
+            throw createStorageError(key, this.name, err, this.clock);
+        }
+    }
+    async compareAndSet(key, expectedOwnerToken, newValue, ttlMs) {
+        const now = this.clock();
+        const expiresAt = ttlMs !== undefined ? now + ttlMs : newValue.expiresAt;
+        try {
+            const result = await this.collection.findOneAndUpdate({ _id: key, ownerToken: expectedOwnerToken }, {
+                $set: {
+                    status: newValue.status,
+                    result: newValue.result,
+                    payloadHash: newValue.payloadHash,
+                    ownerToken: newValue.ownerToken,
+                    attempts: newValue.attempts,
+                    updatedAt: newValue.updatedAt,
+                    expiresAt,
+                },
+            }, { returnDocument: 'after' });
+            return result !== null;
+        }
+        catch (err) {
+            throw createStorageError(key, this.name, err, this.clock);
+        }
+    }
+    /**
+     * Atomic expired takeover using conditional findOneAndUpdate.
+     * Guarantees only one concurrent caller succeeds.
+     */
+    async takeoverExpired(key, newOwnerToken, ttlMs) {
+        const now = this.clock();
+        try {
+            const result = (await this.collection.findOneAndUpdate({
+                _id: key,
+                status: 'IN_PROGRESS',
+                expiresAt: { $lt: now },
+            }, {
+                $set: {
+                    ownerToken: newOwnerToken,
+                    updatedAt: now,
+                    expiresAt: now + ttlMs,
+                },
+                $inc: { attempts: 1 },
+            }, { returnDocument: 'after' }));
+            return result;
+        }
+        catch (err) {
+            throw createStorageError(key, this.name, err, this.clock);
+        }
+    }
+    // ── Capabilities ──────────────────────────────────────────────────────────
+    capabilities() {
+        return {
+            transactions: this.useTransactions,
+            cas: true,
+            ttl: true, // via TTL index
+            advisoryLocks: false,
+        };
+    }
+    // ── Private ───────────────────────────────────────────────────────────────
+    _docToRecord(doc) {
+        return {
+            key: doc._id,
+            status: doc.status,
+            result: doc.result,
+            payloadHash: doc.payloadHash,
+            ownerToken: doc.ownerToken,
+            attempts: doc.attempts,
+            createdAt: doc.createdAt,
+            updatedAt: doc.updatedAt,
+            expiresAt: doc.expiresAt,
+        };
+    }
+}
+// ─── Factory ──────────────────────────────────────────────────────────────────
+/**
+ * Create a MongoDB storage adapter.
+ *
+ * @example
+ * ```ts
+ * import { MongoClient } from 'mongodb';
+ * import { createMongoAdapter } from '@periodic/vanadium/adapters/mongodb';
+ *
+ * const client = new MongoClient(process.env.MONGO_URL!);
+ * await client.connect();
+ *
+ * const adapter = createMongoAdapter({ client, dbName: 'myapp' });
+ * ```
+ */
+export function createMongoAdapter(options) {
+    return new MongoAdapter(options);
+}
+//# sourceMappingURL=index.js.map

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

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