@feltdb/core 0.5.1 → 0.5.2

package/dist/http-db.d.ts

@@ -19,6 +19,19 @@ export declare class HttpJsDb implements JsDb {
     query(collection: string): Promise<JsResult>;
     insert(key: string, value: string): Promise<JsResult>;
     update(key: string, value: string): Promise<JsResult>;
+    cas(params: {
+        key: string;
+        expectedVersion: number;
+        expectedEpoch?: number;
+        expectedLeaseId?: string;
+        rejectIfDiverged?: boolean;
+        value: string;
+    }): Promise<{
+        updated: boolean;
+        currentVersion: number;
+        currentEpoch?: number;
+        conflictCode?: string;
+    }>;
     delete(key: string): Promise<JsResult>;
     /** Acquire a reference through the server's causal peer fabric. */
     acquire(collection: string, id: string): Promise<unknown | null>;

package/dist/http-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-db.d.ts","sourceRoot":"","sources":["../src/http-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,UAAU,QAAQ;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,kBAAkB;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iFAAiF;AACjF,qBAAa,QAAS,YAAW,IAAI;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,kBAAkB;IAKvC,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,QAAQ;IAQV,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAenC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa5C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgBrD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAerD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa5C,mEAAmE;IAC7D,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAOtE,qEAAqE;IAC/D,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQzE,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAMxD,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAMxF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAOxD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAQxD,iBAAiB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;YAMvD,aAAa;YA+Bb,OAAO;IASrB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC7D,UAAU,IAAI,QAAQ;IACtB,SAAS,IAAI,QAAQ;IACrB,QAAQ,IAAI,QAAQ;IACpB,aAAa,IAAI,QAAQ;IACzB,gBAAgB,IAAI,QAAQ;IAC5B,oBAAoB,IAAI,QAAQ;IAChC,2BAA2B,IAAI,QAAQ;IACvC,WAAW,IAAI,MAAM;IACrB,YAAY,IAAI,MAAM;CACvB"}
+{"version":3,"file":"http-db.d.ts","sourceRoot":"","sources":["../src/http-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,UAAU,QAAQ;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,kBAAkB;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iFAAiF;AACjF,qBAAa,QAAS,YAAW,IAAI;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,kBAAkB;IAKvC,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,QAAQ;IAQV,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAenC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa5C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgBrD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAerD,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA8CvP,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa5C,mEAAmE;IAC7D,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAOtE,qEAAqE;IAC/D,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQzE,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAMxD,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAMxF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAOxD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAQxD,iBAAiB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;YAMvD,aAAa;YA+Bb,OAAO;IASrB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC7D,UAAU,IAAI,QAAQ;IACtB,SAAS,IAAI,QAAQ;IACrB,QAAQ,IAAI,QAAQ;IACpB,aAAa,IAAI,QAAQ;IACzB,gBAAgB,IAAI,QAAQ;IAC5B,oBAAoB,IAAI,QAAQ;IAChC,2BAA2B,IAAI,QAAQ;IACvC,WAAW,IAAI,MAAM;IACrB,YAAY,IAAI,MAAM;CACvB"}

package/dist/http-db.js

@@ -82,6 +82,47 @@ export class HttpJsDb {
             return { success: false, error: String(error) };
         }
     }
+    async cas(params) {
+        try {
+            const [collection, id] = this.splitKey(params.key);
+            const parsed = JSON.parse(params.value);
+            const response = await fetch(`${this.url}/collections/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/cas`, {
+                method: 'POST',
+                headers: this.headers(true),
+                body: JSON.stringify({
+                    expectedVersion: params.expectedVersion,
+                    expectedEpoch: params.expectedEpoch,
+                    expectedLeaseId: params.expectedLeaseId,
+                    rejectIfDiverged: params.rejectIfDiverged,
+                    value: parsed,
+                }),
+            });
+            // Handle conflict response (structured error)
+            if (response.status === 409) {
+                const body = await response.json();
+                if ((body.code === 'VERSION_CONFLICT' || body.code === 'AUTHORITY_CONFLICT' || body.code === 'LEASE_CONFLICT' || body.code === 'REPLICATION_CONFLICT') &&
+                    body.currentVersion !== undefined) {
+                    return {
+                        updated: false,
+                        currentVersion: body.currentVersion,
+                        currentEpoch: body.currentEpoch,
+                        conflictCode: body.code,
+                    };
+                }
+            }
+            // Other errors
+            if (!response.ok) {
+                const failure = await this.failure(response);
+                throw new Error(failure.error || 'HTTP CAS failed');
+            }
+            // Success response
+            const result = await response.json();
+            return result;
+        }
+        catch (error) {
+            throw error instanceof Error ? error : new Error(String(error));
+        }
+    }
     async delete(key) {
         try {
             const [collection, id] = this.splitKey(key);

package/dist/http-server.d.ts

@@ -0,0 +1,42 @@
+/**
+ * FeltDB HTTP Server
+ *
+ * Provides HTTP endpoints for FeltDB collection operations including atomic CAS.
+ * Can be used as middleware in Express, Hono, or any HTTP framework.
+ *
+ * Endpoints:
+ * - GET /collections/{collection}/{id} - Get a record
+ * - POST /collections/{collection} - Insert a record
+ * - PATCH /collections/{collection}/{id} - Update a record
+ * - POST /collections/{collection}/{id}/cas - Compare-and-set atomic update
+ * - DELETE /collections/{collection}/{id} - Delete a record
+ *
+ * The CAS endpoint preserves atomic semantics across the HTTP boundary by:
+ * 1. Receiving expectedVersion and value from client
+ * 2. Delegating to Collection.updateIfVersion() inside transaction boundary
+ * 3. Returning structured conflict response on version mismatch
+ * 4. Ensuring exactly one concurrent writer succeeds on same version
+ */
+import type { StateFirstDB } from './db.js';
+export interface HttpServerOptions {
+    db: StateFirstDB;
+}
+export interface HttpRequest {
+    method: string;
+    path: string;
+    headers: Record<string, string>;
+    body?: string;
+}
+export interface HttpResponse {
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+}
+/**
+ * HTTP Server Request Handler
+ *
+ * This is a framework-agnostic handler that can be adapted to Express, Hono, etc.
+ * Returns {status, headers, body} that can be sent to the client.
+ */
+export declare function handleHttpRequest(options: HttpServerOptions, request: HttpRequest): Promise<HttpResponse>;
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,YAAY,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAwC/G"}

package/dist/http-server.js

@@ -0,0 +1,182 @@
+/**
+ * FeltDB HTTP Server
+ *
+ * Provides HTTP endpoints for FeltDB collection operations including atomic CAS.
+ * Can be used as middleware in Express, Hono, or any HTTP framework.
+ *
+ * Endpoints:
+ * - GET /collections/{collection}/{id} - Get a record
+ * - POST /collections/{collection} - Insert a record
+ * - PATCH /collections/{collection}/{id} - Update a record
+ * - POST /collections/{collection}/{id}/cas - Compare-and-set atomic update
+ * - DELETE /collections/{collection}/{id} - Delete a record
+ *
+ * The CAS endpoint preserves atomic semantics across the HTTP boundary by:
+ * 1. Receiving expectedVersion and value from client
+ * 2. Delegating to Collection.updateIfVersion() inside transaction boundary
+ * 3. Returning structured conflict response on version mismatch
+ * 4. Ensuring exactly one concurrent writer succeeds on same version
+ */
+/**
+ * HTTP Server Request Handler
+ *
+ * This is a framework-agnostic handler that can be adapted to Express, Hono, etc.
+ * Returns {status, headers, body} that can be sent to the client.
+ */
+export async function handleHttpRequest(options, request) {
+    const { db } = options;
+    const { method, path, headers, body } = request;
+    // Parse path: /collections/{collection}/{id}[/cas]
+    const match = path.match(/^\/collections\/([^/]+)(?:\/([^/]+))?(?:\/(.+))?$/);
+    if (!match) {
+        return errorResponse(404, 'Not Found', 'Invalid path');
+    }
+    const collection = decodeURIComponent(match[1]);
+    const id = match[2] ? decodeURIComponent(match[2]) : undefined;
+    const operation = match[3] || undefined;
+    // GET /collections/{collection}/{id}
+    if (method === 'GET' && id) {
+        return handleGet(db, collection, id);
+    }
+    // POST /collections/{collection}
+    if (method === 'POST' && !id && !operation) {
+        return handleInsert(db, collection, body);
+    }
+    // PATCH /collections/{collection}/{id}
+    if (method === 'PATCH' && id && !operation) {
+        return handleUpdate(db, collection, id, body);
+    }
+    // POST /collections/{collection}/{id}/cas - Atomic compare-and-set
+    if (method === 'POST' && id && operation === 'cas') {
+        return handleCas(db, collection, id, body);
+    }
+    // DELETE /collections/{collection}/{id}
+    if (method === 'DELETE' && id && !operation) {
+        return handleDelete(db, collection, id);
+    }
+    return errorResponse(404, 'Not Found', `No handler for ${method} ${path}`);
+}
+async function handleGet(db, collection, id) {
+    try {
+        const coll = db.collection(collection);
+        const item = await coll.get(id);
+        if (!item) {
+            return errorResponse(404, 'Not Found', `Record ${collection}:${id} not found`);
+        }
+        return successResponse(200, { value: item });
+    }
+    catch (error) {
+        return errorResponse(500, 'Internal Server Error', String(error));
+    }
+}
+async function handleInsert(db, collection, body) {
+    try {
+        if (!body) {
+            return errorResponse(400, 'Bad Request', 'Request body required');
+        }
+        const value = JSON.parse(body);
+        const id = String(value.id ?? '');
+        if (!id) {
+            return errorResponse(400, 'Bad Request', 'Record must have an id');
+        }
+        const coll = db.collection(collection);
+        await coll.insert(value, id);
+        return successResponse(201, { id, value });
+    }
+    catch (error) {
+        return errorResponse(400, 'Bad Request', String(error));
+    }
+}
+async function handleUpdate(db, collection, id, body) {
+    try {
+        if (!body) {
+            return errorResponse(400, 'Bad Request', 'Request body required');
+        }
+        const updates = JSON.parse(body);
+        const coll = db.collection(collection);
+        await coll.update(id, updates);
+        const item = await coll.get(id);
+        return successResponse(200, { value: item });
+    }
+    catch (error) {
+        return errorResponse(400, 'Bad Request', String(error));
+    }
+}
+/**
+ * Handle atomic Compare-And-Set (CAS) operation via HTTP
+ *
+ * This endpoint receives expectedVersion and value from the client,
+ * delegates to Collection.updateIfVersion() which performs the atomic
+ * version check inside the backend transaction boundary, and returns
+ * a structured conflict response if the version doesn't match.
+ *
+ * Path: POST /collections/{collection}/{id}/cas
+ * Body: { expectedVersion: number, value: object }
+ * Response 200: { updated: true, currentVersion: number, item: object }
+ * Response 409: { code: "VERSION_CONFLICT", currentVersion: number }
+ */
+async function handleCas(db, collection, id, body) {
+    try {
+        if (!body) {
+            return errorResponse(400, 'Bad Request', 'Request body required');
+        }
+        const request = JSON.parse(body);
+        if (request.expectedVersion === undefined) {
+            return errorResponse(400, 'Bad Request', 'expectedVersion is required');
+        }
+        if (!request.value) {
+            return errorResponse(400, 'Bad Request', 'value is required');
+        }
+        const coll = db.collection(collection);
+        const result = await coll.updateIfVersion(id, request.expectedVersion, request.value);
+        if (result.updated) {
+            // Success: return the updated item with new version
+            return successResponse(200, {
+                updated: true,
+                currentVersion: result.item?.__version,
+                item: result.item,
+            });
+        }
+        else {
+            // Conflict: return structured error response with actual version
+            return errorResponse(409, 'VERSION_CONFLICT', `Version mismatch for ${collection}:${id}`, {
+                code: 'VERSION_CONFLICT',
+                currentVersion: result.currentVersion,
+            });
+        }
+    }
+    catch (error) {
+        if (String(error).includes('not found')) {
+            return errorResponse(404, 'Not Found', `Record ${collection}:${id} not found`);
+        }
+        return errorResponse(400, 'Bad Request', String(error));
+    }
+}
+async function handleDelete(db, collection, id) {
+    try {
+        const coll = db.collection(collection);
+        await coll.delete(id);
+        return successResponse(204, {});
+    }
+    catch (error) {
+        return errorResponse(400, 'Bad Request', String(error));
+    }
+}
+function successResponse(status, data) {
+    return {
+        status,
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(data),
+    };
+}
+function errorResponse(status, code, message, extra) {
+    return {
+        status,
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            code,
+            message,
+            ...extra,
+        }),
+    };
+}

package/dist/index.d.ts

@@ -7,6 +7,7 @@
  */
 export * from './db.js';
 export * from './collection.js';
+export * from './cell.js';
 export * from './reactive-graph.js';
 export * from './index-types.js';
 export * from './index-backend.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,SAAS,IAAI,iBAAiB,EACnC,KAAK,QAAQ,IAAI,gBAAgB,GAClC,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAEnC;;GAEG;AACH,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,SAAS,IAAI,iBAAiB,EACnC,KAAK,QAAQ,IAAI,gBAAgB,GAClC,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAEnC;;GAEG;AACH,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -7,6 +7,7 @@
  */
 export * from './db.js';
 export * from './collection.js';
+export * from './cell.js';
 export * from './reactive-graph.js';
 export * from './index-types.js';
 export * from './index-backend.js';

package/dist/indexeddb-conformance.spec.d.ts

@@ -0,0 +1,21 @@
+/**
+ * IndexedDB CAS Conformance Tests - Chromium/Playwright
+ *
+ * Note: IndexedDB conformance testing requires a browser environment with
+ * ES modules support. For now, this file documents the test structure.
+ *
+ * To run these tests:
+ * 1. Create a simple HTML page that imports the compiled FeltDB modules
+ * 2. Run `npx playwright test` in this directory
+ * 3. Tests will run in Chromium and verify IndexedDB CAS semantics
+ *
+ * Validation points:
+ * - Concurrent transaction isolation
+ * - Version persistence across reopen
+ * - Stale writer conflict detection
+ * - Version increment atomicity
+ * - Failed CAS leaves state unchanged
+ * - __version cannot be supplied by caller
+ */
+export declare const playwrightTestStructure = "\nRequired test coverage (Playwright + Chromium):\n\nTest 1: Single process CAS increments version\n  \u2713 Insert record (version = 1)\n  \u2713 CAS update (expectedVersion: 1)\n  \u2713 Result: updated=true, currentVersion=2\n  \u2713 Verify persisted: version=2\n\nTest 2: Version conflict on mismatch\n  \u2713 Insert record (version = 1)\n  \u2713 CAS with wrong expectedVersion (999)\n  \u2713 Result: updated=false, currentVersion=1\n  \u2713 Verify no mutation: version=1, data unchanged\n\nTest 3: Two concurrent writers (Promise.all)\n  \u2713 Insert record (version = 1)\n  \u2713 Race 2 CAS requests on same version\n  \u2713 Result: 1 success, 1 conflict\n  \u2713 Verify final version = 2, not 3\n\nTest 4: Three concurrent writers\n  \u2713 Insert record (version = 1)\n  \u2713 Race 3 CAS requests on same version\n  \u2713 Result: 1 success, 2 conflicts\n  \u2713 Verify final version = 2\n\nTest 5: 50 concurrent races\n  \u2713 For each i in 0..49:\n    - Insert record\n    - Race 2 writers on version 1\n    - Verify: 1 success, 1 conflict\n\nTest 6: 100 sequential updates\n  \u2713 Insert counter (version = 1)\n  \u2713 For each i in 0..99:\n    - CAS with expectedVersion = i+1\n    - Verify updated=true, currentVersion = i+2\n  \u2713 Final version = 101 (1 + 100 updates)\n\nTest 7: Stale writer conflict after reopen\n  \u2713 Insert record, read version N\n  \u2713 Other writer updates with expectedVersion=N \u2192 success, version=N+1\n  \u2713 Stale writer tries expectedVersion=N \u2192 conflict, currentVersion=N+1\n\nTest 8: Failed CAS leaves state unchanged\n  \u2713 Insert record with nested structure\n  \u2713 50 failed CAS attempts with expectedVersion=999\n  \u2713 Verify: version unchanged, all fields unchanged (including nested)\n\nTest 9: User __version ignored\n  \u2713 Insert record (version = 1)\n  \u2713 CAS with __version: 999 in updates\n  \u2713 Result: currentVersion = 2, not 999\n  \u2713 Verify: stored __version = 2\n\nTest 10: Partial updates preserve fields\n  \u2713 Insert record with multiple fields\n  \u2713 CAS with only some fields in updates\n  \u2713 Verify: updated fields changed, others preserved\n\nTest 11: No mutation event on failed CAS\n  \u2713 Subscribe to changes for record\n  \u2713 50 failed CAS attempts\n  \u2713 Verify: no change events fired\n\nTest 12: Exactly one mutation event on success\n  \u2713 Subscribe to changes for record\n  \u2713 CAS success\n  \u2713 Verify: exactly 1 change event fired\n";
+//# sourceMappingURL=indexeddb-conformance.spec.d.ts.map

package/dist/indexeddb-conformance.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-conformance.spec.d.ts","sourceRoot":"","sources":["../src/indexeddb-conformance.spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,eAAO,MAAM,uBAAuB,s8EAsEnC,CAAC"}

package/dist/indexeddb-conformance.spec.js

@@ -0,0 +1,103 @@
+/**
+ * IndexedDB CAS Conformance Tests - Chromium/Playwright
+ *
+ * Note: IndexedDB conformance testing requires a browser environment with
+ * ES modules support. For now, this file documents the test structure.
+ *
+ * To run these tests:
+ * 1. Create a simple HTML page that imports the compiled FeltDB modules
+ * 2. Run `npx playwright test` in this directory
+ * 3. Tests will run in Chromium and verify IndexedDB CAS semantics
+ *
+ * Validation points:
+ * - Concurrent transaction isolation
+ * - Version persistence across reopen
+ * - Stale writer conflict detection
+ * - Version increment atomicity
+ * - Failed CAS leaves state unchanged
+ * - __version cannot be supplied by caller
+ */
+// This file serves as documentation for the IndexedDB conformance tests.
+// Implementation would require:
+// 1. A test HTML page that loads compiled FeltDB modules
+// 2. Playwright test harness using page.evaluate() for each operation
+// 3. Tests running in real Chromium with IndexedDB available
+export const playwrightTestStructure = `
+Required test coverage (Playwright + Chromium):
+
+Test 1: Single process CAS increments version
+  ✓ Insert record (version = 1)
+  ✓ CAS update (expectedVersion: 1)
+  ✓ Result: updated=true, currentVersion=2
+  ✓ Verify persisted: version=2
+
+Test 2: Version conflict on mismatch
+  ✓ Insert record (version = 1)
+  ✓ CAS with wrong expectedVersion (999)
+  ✓ Result: updated=false, currentVersion=1
+  ✓ Verify no mutation: version=1, data unchanged
+
+Test 3: Two concurrent writers (Promise.all)
+  ✓ Insert record (version = 1)
+  ✓ Race 2 CAS requests on same version
+  ✓ Result: 1 success, 1 conflict
+  ✓ Verify final version = 2, not 3
+
+Test 4: Three concurrent writers
+  ✓ Insert record (version = 1)
+  ✓ Race 3 CAS requests on same version
+  ✓ Result: 1 success, 2 conflicts
+  ✓ Verify final version = 2
+
+Test 5: 50 concurrent races
+  ✓ For each i in 0..49:
+    - Insert record
+    - Race 2 writers on version 1
+    - Verify: 1 success, 1 conflict
+
+Test 6: 100 sequential updates
+  ✓ Insert counter (version = 1)
+  ✓ For each i in 0..99:
+    - CAS with expectedVersion = i+1
+    - Verify updated=true, currentVersion = i+2
+  ✓ Final version = 101 (1 + 100 updates)
+
+Test 7: Stale writer conflict after reopen
+  ✓ Insert record, read version N
+  ✓ Other writer updates with expectedVersion=N → success, version=N+1
+  ✓ Stale writer tries expectedVersion=N → conflict, currentVersion=N+1
+
+Test 8: Failed CAS leaves state unchanged
+  ✓ Insert record with nested structure
+  ✓ 50 failed CAS attempts with expectedVersion=999
+  ✓ Verify: version unchanged, all fields unchanged (including nested)
+
+Test 9: User __version ignored
+  ✓ Insert record (version = 1)
+  ✓ CAS with __version: 999 in updates
+  ✓ Result: currentVersion = 2, not 999
+  ✓ Verify: stored __version = 2
+
+Test 10: Partial updates preserve fields
+  ✓ Insert record with multiple fields
+  ✓ CAS with only some fields in updates
+  ✓ Verify: updated fields changed, others preserved
+
+Test 11: No mutation event on failed CAS
+  ✓ Subscribe to changes for record
+  ✓ 50 failed CAS attempts
+  ✓ Verify: no change events fired
+
+Test 12: Exactly one mutation event on success
+  ✓ Subscribe to changes for record
+  ✓ CAS success
+  ✓ Verify: exactly 1 change event fired
+`;
+// Implementation note: For production conformance, uncomment and implement
+// the actual Playwright tests once ES module resolution is available in test runner.
+//
+// import { test, expect, Page } from '@playwright/test';
+//
+// test.describe('IndexedDB CAS Conformance', () => {
+//   // Test implementations here
+// });

package/dist/indexeddb-db.d.ts

@@ -38,6 +38,14 @@ export declare class IndexedDbJsDb implements JsDb {
     insert(key: string, value: string): Promise<JsResult>;
     update(key: string, value: string): Promise<JsResult>;
     delete(key: string): Promise<JsResult>;
+    cas(params: {
+        key: string;
+        expectedVersion: number;
+        value: string;
+    }): Promise<{
+        updated: boolean;
+        currentVersion: number;
+    }>;
     get(key: string): Promise<JsResult>;
     query(collection: string): Promise<JsResult>;
     private request;

package/dist/indexeddb-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexeddb-db.d.ts","sourceRoot":"","sources":["../src/indexeddb-db.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"indexeddb-db.d.ts","sourceRoot":"","sources":["../src/indexeddb-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,UAAU,QAAQ;IAAG,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AACtE,UAAU,YAAY;IAAG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE;AACrK,KAAK,cAAc,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;AAEnD,qGAAqG;AACrG,qBAAa,aAAc,YAAW,IAAI;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsD;IACtF,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,eAAe,CAAC,CAAgC;IACxD,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,0BAA0B,CAAwD;IAC1F,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAqB;gBAElD,SAAS,EAAE,MAAM;IAO7B,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,QAAQ;YAMF,MAAM;IA8BpB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IACrD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IACrD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAEhC,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAgF3H,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKnC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;YAapC,OAAO;IAKrB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI;IAoB5E,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAQnC;IAEF,OAAO,CAAC,yBAAyB;IASjC,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,yBAAyB;IAUjC,OAAO,CAAC,qBAAqB;YAQf,sBAAsB;YAwBtB,oBAAoB;YASpB,WAAW;IAyBzB,OAAO,CAAC,qBAAqB;IAc7B,KAAK,IAAI,IAAI;IAMb,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC7D,UAAU,IAAI,QAAQ;IACtB,SAAS,IAAI,QAAQ;IACrB,QAAQ,IAAI,QAAQ;IACpB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IACvC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAC1C,oBAAoB,IAAI,QAAQ;IAChC,2BAA2B,IAAI,QAAQ;IACvC,WAAW,IAAI,MAAM;IACrB,YAAY,IAAI,MAAM;IAChB,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IACvC,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IACjE,uBAAuB,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAwBzG"}

package/dist/indexeddb-db.js

@@ -91,6 +91,75 @@ export class IndexedDbJsDb {
     insert(key, value) { return this.mutate(key, JSON.parse(value), 'put'); }
     update(key, value) { return this.mutate(key, JSON.parse(value), 'put'); }
     delete(key) { return this.mutate(key, undefined, 'delete'); }
+    async cas(params) {
+        try {
+            const db = await this.database;
+            let result = { updated: false, currentVersion: 0 };
+            let committedSequence = 0;
+            const collection = this.splitKey(params.key);
+            await new Promise((resolve, reject) => {
+                let transaction;
+                try {
+                    transaction = db.transaction(['rows', 'changes'], 'readwrite', { durability: 'strict' });
+                }
+                catch {
+                    transaction = db.transaction(['rows', 'changes'], 'readwrite');
+                }
+                const rowsStore = transaction.objectStore('rows');
+                const changesStore = transaction.objectStore('changes');
+                // Read current value inside transaction boundary
+                const getRequest = rowsStore.get(params.key);
+                getRequest.onsuccess = () => {
+                    const existing = getRequest.result;
+                    if (existing === undefined) {
+                        result = { updated: false, currentVersion: 0 };
+                        return;
+                    }
+                    const existingRecord = existing;
+                    const currentVersion = existingRecord.__version ?? 1;
+                    // Version check happens inside transaction
+                    if (currentVersion !== params.expectedVersion) {
+                        result = { updated: false, currentVersion };
+                        return;
+                    }
+                    // Version matches - update it
+                    const parsed = JSON.parse(params.value);
+                    const newVersion = params.expectedVersion + 1;
+                    const updatedRecord = { ...parsed, __version: newVersion };
+                    rowsStore.put(updatedRecord, params.key);
+                    const timestamp = Date.now();
+                    const change = changesStore.add({
+                        collection,
+                        key: params.key,
+                        type: 'put',
+                        value: updatedRecord,
+                        timestamp,
+                        origin: this.origin,
+                        id: `${this.origin}:${timestamp}:${Math.random().toString(36).slice(2)}`
+                    });
+                    change.onsuccess = () => {
+                        committedSequence = Number(change.result);
+                        result = { updated: true, currentVersion: newVersion };
+                    };
+                };
+                getRequest.onerror = () => {
+                    transaction.abort();
+                };
+                transaction.oncomplete = () => resolve();
+                transaction.onerror = () => reject(transaction.error ?? new Error('IndexedDB CAS failed'));
+                transaction.onabort = () => reject(transaction.error ?? new Error('IndexedDB CAS aborted'));
+            });
+            if (result.updated && committedSequence > 0) {
+                this.sequence += 1;
+                this.announceLocalChange(collection, committedSequence);
+                this.channel?.postMessage({ collection, sequence: committedSequence });
+            }
+            return result;
+        }
+        catch (error) {
+            return { updated: false, currentVersion: 0 };
+        }
+    }
     async get(key) {
         try {
             const value = await this.request('rows', store => store.get(key));

package/dist/memory-db.d.ts

@@ -34,10 +34,12 @@ export declare class MemoryJsDb implements JsDb {
     cas(params: {
         key: string;
         expectedVersion: number;
+        expectedEpoch?: number;
         value: string;
     }): Promise<{
         updated: boolean;
         currentVersion: number;
+        currentEpoch?: number;
     }>;
     query(capability: string): JsResult;
     get_capability_records(capability: string): JsResult;

package/dist/memory-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-db.d.ts","sourceRoot":"","sources":["../src/memory-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,UAAU,QAAQ;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,aAAa;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE;AAIrK,mEAAmE;AACnE,qBAAa,UAAW,YAAW,IAAI;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;gBAE/B,SAAS,EAAE,MAAM;IAU7B,OAAO,CAAC,KAAK;IAMb,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ;IAU5C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ;IAO5C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAO1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAM7B,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBtF,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IA0B3H,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ;IAQnC,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ;IAIpD,UAAU,IAAI,QAAQ;IAItB,SAAS,IAAI,QAAQ;IAIrB,QAAQ,IAAI,QAAQ;IACpB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IACvC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAC1C,2BAA2B,IAAI,QAAQ;IACvC,oBAAoB,IAAI,QAAQ;IAChC,WAAW,IAAI,MAAM;IACrB,YAAY,IAAI,MAAM;IACtB,YAAY;IACZ,iBAAiB,CAAC,aAAa,EAAE,MAAM;IACvC,uBAAuB,CAAC,UAAU,EAAE,aAAa,EAAE;;;;CAapD"}
+{"version":3,"file":"memory-db.d.ts","sourceRoot":"","sources":["../src/memory-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,UAAU,QAAQ;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,aAAa;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE;AAIrK,mEAAmE;AACnE,qBAAa,UAAW,YAAW,IAAI;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;gBAE/B,SAAS,EAAE,MAAM;IAU7B,OAAO,CAAC,KAAK;IAMb,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ;IAU5C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ;IAO5C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAO1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAM7B,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBtF,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAiC1K,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ;IAQnC,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ;IAIpD,UAAU,IAAI,QAAQ;IAItB,SAAS,IAAI,QAAQ;IAIrB,QAAQ,IAAI,QAAQ;IACpB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IACvC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAC1C,2BAA2B,IAAI,QAAQ;IACvC,oBAAoB,IAAI,QAAQ;IAChC,WAAW,IAAI,MAAM;IACrB,YAAY,IAAI,MAAM;IACtB,YAAY;IACZ,iBAAiB,CAAC,aAAa,EAAE,MAAM;IACvC,uBAAuB,CAAC,UAAU,EAAE,aAAa,EAAE;;;;CAapD"}

package/dist/memory-db.js

@@ -70,16 +70,22 @@ export class MemoryJsDb {
         }
         const existingRecord = existing;
         const currentVersion = existingRecord.__version ?? 1;
+        const currentEpoch = existingRecord.authority?.epoch ?? 0;
         if (currentVersion !== params.expectedVersion) {
             // Version mismatch - conflict
-            return Promise.resolve({ updated: false, currentVersion });
+            return Promise.resolve({ updated: false, currentVersion, currentEpoch });
         }
-        // Version matches - update atomically
+        // Check epoch atomically with version if provided
+        if (params.expectedEpoch !== undefined && currentEpoch !== params.expectedEpoch) {
+            // Epoch mismatch - conflict
+            return Promise.resolve({ updated: false, currentVersion, currentEpoch });
+        }
+        // Both version and epoch match - update atomically
         const newVersion = params.expectedVersion + 1;
         const updated = { ...parsed, __version: newVersion };
         this.rows.set(params.key, updated);
         this.event(params.key.split(':')[0], params.key, 'put', updated);
-        return Promise.resolve({ updated: true, currentVersion: newVersion });
+        return Promise.resolve({ updated: true, currentVersion: newVersion, currentEpoch });
     }
     query(capability) {
         const prefix = `${capability}:`;