@periodic/vanadium 1.0.0

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

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryAdapter = void 0;
+exports.createMemoryAdapter = createMemoryAdapter;
+const index_js_1 = require("../../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 });
+ * ```
+ */
+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,
+        };
+    }
+}
+exports.MemoryAdapter = MemoryAdapter;
+// ─── Factory ──────────────────────────────────────────────────────────────────
+function createMemoryAdapter(options) {
+    return new MemoryAdapter(options);
+}
+// Suppress unused import warning — this file intentionally imports for type safety
+void index_js_1.createStorageError;
+//# sourceMappingURL=index.js.map

package/dist/cjs/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/cjs/adapters/mongodb/index.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * 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 });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoAdapter = void 0;
+exports.createMongoAdapter = createMongoAdapter;
+const index_js_1 = require("../../errors/index.js");
+/* eslint-enable @typescript-eslint/no-explicit-any */
+const MONGO_DUPLICATE_KEY_CODE = 11000;
+// ─── MongoDB Adapter ──────────────────────────────────────────────────────────
+class MongoAdapter {
+    constructor(options) {
+        this.name = 'mongodb';
+        if (!options.client || !options.dbName) {
+            throw (0, index_js_1.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 (0, index_js_1.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 (0, index_js_1.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 (0, index_js_1.createStorageError)(key, this.name, updateErr, this.clock);
+            }
+        }
+    }
+    async delete(key) {
+        try {
+            await this.collection.deleteOne({ _id: key });
+        }
+        catch (err) {
+            throw (0, index_js_1.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 (0, index_js_1.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 (0, index_js_1.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,
+        };
+    }
+}
+exports.MongoAdapter = MongoAdapter;
+// ─── 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' });
+ * ```
+ */
+function createMongoAdapter(options) {
+    return new MongoAdapter(options);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/mongodb/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAuQH,gDAEC;AAtQD,oDAAqF;AAqBrF,sDAAsD;AAEtD,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAkCvC,iFAAiF;AAEjF,MAAa,YAAY;IAQvB,YAAY,OAA4B;QAPxB,SAAI,GAAG,SAAS,CAAC;QAQ/B,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACvC,MAAM,IAAA,mCAAwB,EAC5B,EAAE,EACF,SAAS,EACT,+CAA+C,CAChD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,kBAAkB,CAAC;QACnE,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IACzC,CAAC;IAED,IAAY,UAAU;QACpB,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACjD,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,GAAG,CAAc,GAAW;QAChC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAA4B,CAAC;YACrF,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,OAAO,IAAI,CAAC,YAAY,CAAI,GAAG,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAA,6BAAkB,EAAC,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,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;QAEtE,MAAM,GAAG,GAAqB;YAC5B,GAAG,EAAE,GAAG;YACR,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS;SACV,CAAC;QAEF,IAAI,CAAC;YACH,8CAA8C;YAC9C,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAC;YAC7C,IAAI,IAAI,KAAK,wBAAwB,EAAE,CAAC;gBACtC,MAAM,IAAA,6BAAkB,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5D,CAAC;YACD,yBAAyB;YACzB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,UAAU,CAAC,gBAAgB,CACpC,EAAE,GAAG,EAAE,GAAG,EAAE,EACZ;oBACE,IAAI,EAAE;wBACJ,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,WAAW,EAAE,KAAK,CAAC,WAAW;wBAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;wBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,SAAS;qBACV;iBACF,EACD,EAAE,cAAc,EAAE,OAAO,EAAE,CAC5B,CAAC;YACJ,CAAC;YAAC,OAAO,SAAS,EAAE,CAAC;gBACnB,MAAM,IAAA,6BAAkB,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAA,6BAAkB,EAAC,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,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QAEzE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,gBAAgB,CACnD,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,kBAAkB,EAAE,EAC5C;gBACE,IAAI,EAAE;oBACJ,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,WAAW,EAAE,QAAQ,CAAC,WAAW;oBACjC,UAAU,EAAE,QAAQ,CAAC,UAAU;oBAC/B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;oBAC7B,SAAS;iBACV;aACF,EACD,EAAE,cAAc,EAAE,OAAO,EAAE,CAC5B,CAAC;YACF,OAAO,MAAM,KAAK,IAAI,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAA,6BAAkB,EAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CACnB,GAAW,EACX,aAAqB,EACrB,KAAa;QAEb,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,gBAAgB,CACpD;gBACE,GAAG,EAAE,GAAG;gBACR,MAAM,EAAE,aAAa;gBACrB,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;aACxB,EACD;gBACE,IAAI,EAAE;oBACJ,UAAU,EAAE,aAAa;oBACzB,SAAS,EAAE,GAAG;oBACd,SAAS,EAAE,GAAG,GAAG,KAAK;iBACvB;gBACD,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;aACtB,EACD,EAAE,cAAc,EAAE,OAAO,EAAE,CAC5B,CAA4B,CAAC;YAC9B,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAA,6BAAkB,EAAC,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,IAAI,CAAC,eAAe;YAClC,GAAG,EAAE,IAAI;YACT,GAAG,EAAE,IAAI,EAAE,gBAAgB;YAC3B,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;IAED,6EAA6E;IAErE,YAAY,CAAI,GAAqB;QAC3C,OAAO;YACL,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,MAAM,EAAE,GAAG,CAAC,MAAmC;YAC/C,MAAM,EAAE,GAAG,CAAC,MAAuB;YACnC,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;CACF;AAvLD,oCAuLC;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;GAaG;AACH,SAAgB,kBAAkB,CAAC,OAA4B;IAC7D,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/dist/cjs/adapters/mongoose/index.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * Mongoose Storage Adapter Wrapper for @periodic/vanadium
+ *
+ * Peer dependency: "mongoose" >= 7.0.0
+ * Import: import { createMongooseAdapter } from '@periodic/vanadium/adapters/mongoose'
+ *
+ * This is a WRAPPER that preserves identical semantics to the MongoDB native adapter.
+ * Mongoose is purely an ORM layer — it does NOT change idempotency behavior.
+ *
+ * Required Prisma schema:
+ * ```prisma
+ * model vanadiumRecord {
+ *   id          String  @id @map("_id")
+ *   status      String
+ *   result      Json?
+ *   payloadHash String?
+ *   ownerToken  String?
+ *   attempts    Int     @default(0)
+ *   createdAt   BigInt
+ *   updatedAt   BigInt
+ *   expiresAt   BigInt?
+ * }
+ * ```
+ *
+ * Required Mongoose schema (use createVanadiumSchema() helper):
+ * ```ts
+ * import { createVanadiumSchema } from '@periodic/vanadium/adapters/mongoose';
+ * const VanadiumRecord = mongoose.model('VanadiumRecord', createVanadiumSchema());
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongooseAdapter = void 0;
+exports.createVanadiumSchema = createVanadiumSchema;
+exports.createMongooseAdapter = createMongooseAdapter;
+const index_js_1 = require("../../errors/index.js");
+/* eslint-enable @typescript-eslint/no-explicit-any */
+const MONGOOSE_DUPLICATE_KEY_CODE = 11000;
+// ─── Mongoose Adapter ─────────────────────────────────────────────────────────
+class MongooseAdapter {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    constructor(options) {
+        this.name = 'mongoose';
+        if (!options.model) {
+            throw (0, index_js_1.createConfigurationError)('', 'mongoose', 'Mongoose adapter requires a model.');
+        }
+        this.model = options.model;
+        this.useTransactions = options.useTransactions ?? true;
+        this.clock = options.clock ?? Date.now;
+    }
+    // ── Storage Interface ─────────────────────────────────────────────────────
+    async get(key) {
+        try {
+            const doc = await this.model.findOne({ _id: key });
+            if (!doc)
+                return null;
+            return this._docToRecord(doc);
+        }
+        catch (err) {
+            throw (0, index_js_1.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 docData = {
+            _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 {
+            await this.model.create(docData);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== MONGOOSE_DUPLICATE_KEY_CODE) {
+                throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
+            }
+            // Key exists — update
+            try {
+                await this.model.findOneAndUpdate({ _id: key }, {
+                    $set: {
+                        status: value.status,
+                        result: value.result,
+                        payloadHash: value.payloadHash,
+                        ownerToken: value.ownerToken,
+                        attempts: value.attempts,
+                        updatedAt: value.updatedAt,
+                        expiresAt,
+                    },
+                }, { new: true });
+            }
+            catch (updateErr) {
+                throw (0, index_js_1.createStorageError)(key, this.name, updateErr, this.clock);
+            }
+        }
+    }
+    async delete(key) {
+        try {
+            await this.model.deleteOne({ _id: key });
+        }
+        catch (err) {
+            throw (0, index_js_1.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.model.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,
+                },
+            }, { new: true });
+            return result !== null;
+        }
+        catch (err) {
+            throw (0, index_js_1.createStorageError)(key, this.name, err, this.clock);
+        }
+    }
+    // ── Capabilities ──────────────────────────────────────────────────────────
+    capabilities() {
+        return {
+            transactions: this.useTransactions,
+            cas: true,
+            ttl: true,
+            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,
+        };
+    }
+}
+exports.MongooseAdapter = MongooseAdapter;
+// ─── Schema Builder ───────────────────────────────────────────────────────────
+/**
+ * Build the required Mongoose schema for Vanadium records.
+ * Pass the Mongoose Schema constructor from your mongoose import.
+ */
+function createVanadiumSchema(Schema) {
+    return new Schema({
+        _id: { type: String, required: true },
+        status: {
+            type: String,
+            enum: ['IN_PROGRESS', 'COMPLETED', 'FAILED'],
+            required: true,
+        },
+        result: { type: Schema.Types.Mixed },
+        payloadHash: { type: String },
+        ownerToken: { type: String },
+        attempts: { type: Number, default: 0 },
+        createdAt: { type: Number, required: true },
+        updatedAt: { type: Number, required: true },
+        expiresAt: { type: Number },
+    }, {
+        versionKey: false,
+        strict: true,
+    });
+}
+// ─── Factory ──────────────────────────────────────────────────────────────────
+/**
+ * Create a Mongoose storage adapter.
+ *
+ * @example
+ * ```ts
+ * import mongoose from 'mongoose';
+ * import { createMongooseAdapter, createVanadiumSchema } from '@periodic/vanadium/adapters/mongoose';
+ *
+ * const VanadiumRecord = mongoose.model('VanadiumRecord', createVanadiumSchema(mongoose.Schema));
+ * const adapter = createMongooseAdapter({ model: VanadiumRecord });
+ * ```
+ */
+function createMongooseAdapter(options) {
+    return new MongooseAdapter(options);
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/adapters/mongoose/index.js.map

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