@feltdb/core 0.12.2 → 0.15.0

package/dist/development-runtime-bridge.js

@@ -42,25 +42,76 @@ function safeBridgeUrl(value) {
     }
 }
 let warnedMismatch = false;
+function loopbackOrigin(value) {
+    if (!value)
+        return undefined;
+    try {
+        const url = new URL(value);
+        const host = ['localhost', '127.0.0.1', '::1', '[::1]'].includes(url.hostname) ? 'loopback' : url.hostname;
+        return `${url.protocol}//${host}:${url.port || (url.protocol === 'https:' ? '443' : '80')}`;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The authority a client is connected to, compared as an endpoint: `localhost` and `127.0.0.1` are one host. */
+export function sameAuthority(left, right) {
+    const a = loopbackOrigin(left);
+    return a !== undefined && a === loopbackOrigin(right);
+}
+/**
+ * Whether a database belongs to a development session: the same namespace, and
+ * either the same embedded runtime or a remote connection to the session's own
+ * authority. A browser application of a Node.js-authority project is the
+ * second case — it runs in the browser but its state is the session's.
+ */
+export function developmentConnectionMatches(session, connection) {
+    if (session.namespace !== connection.namespace)
+        return false;
+    if (connection.runtime === 'remote') {
+        if (connection.authorityUrl)
+            return sameAuthority(connection.authorityUrl, session.authorityUrl);
+        return ['managed', 'self-hosted', 'remote'].includes(session.runtime);
+    }
+    return session.runtime === connection.runtime;
+}
 /**
  * A development session was supplied but belongs to a different database than
  * the one being opened. Studio would show this app as "Not connected" with no
- * cause, so say what differs once instead of skipping registration silently.
+ * cause, so say what differs, and what to change, once instead of skipping
+ * registration silently.
  */
 function warnSessionMismatch(session, input) {
     if (warnedMismatch)
         return;
     warnedMismatch = true;
-    const differences = [
-        session.namespace !== input.namespace ? `namespace "${input.namespace}" (session expects "${session.namespace}")` : '',
-        session.runtime !== input.runtime ? `runtime "${input.runtime}" (session expects "${session.runtime}")` : '',
-    ].filter(Boolean).join(' and ');
-    console.warn(`[feltdb] This database opened with ${differences}, so it is not registered with the running \`feltdb dev\` session and Studio will report the application as not connected. `
-        + 'Pass the session namespace to createFeltDB({ namespace }).');
+    const differences = [];
+    const advice = [];
+    if (session.namespace !== input.namespace) {
+        differences.push(`namespace "${input.namespace}" (session expects "${session.namespace}")`);
+        advice.push('pass the session namespace to createFeltDB({ namespace })');
+    }
+    if (input.runtime === 'remote' && input.authorityUrl && !sameAuthority(input.authorityUrl, session.authorityUrl)) {
+        differences.push(`authority ${input.authorityUrl} (session authority is ${session.authorityUrl})`);
+        advice.push('connect to the session authority (VITE_FELTDB_AUTHORITY_URL) or start `feltdb dev` against this authority');
+    }
+    else if (session.namespace === input.namespace) {
+        differences.push(`runtime "${input.runtime}" (session expects "${session.runtime}")`);
+        advice.push(session.runtime === 'browser'
+            ? 'open the database in the browser runtime'
+            : `connect to the session authority with createFeltDB({ namespace, server: { url: ${JSON.stringify(session.authorityUrl)} } })`);
+    }
+    console.warn(`[feltdb] This database opened with ${differences.join(' and ')}, so it is not registered with the running \`feltdb dev\` session and Studio will report the application as not connected. `
+        + `To connect it, ${advice.join(' and ')}.`);
 }
 /** Internal, optional registration hook called by Core runtime construction. */
 export function attachDevelopmentRuntimeBridge(input) {
     const runtimeInstanceId = randomId();
+    const connection = {
+        namespace: input.namespace,
+        runtime: input.runtime,
+        ...(input.authorityUrl ? { authorityUrl: input.authorityUrl } : {}),
+    };
     let activeSession;
     let heartbeat;
     let flushTimer;
@@ -74,19 +125,17 @@ export function attachDevelopmentRuntimeBridge(input) {
         || 'application';
     const register = async (candidate) => {
         const session = candidate || configuredSession || processSession();
-        const compatibleRuntime = session?.runtime === input.runtime
-            || (input.runtime === 'remote' && ['managed', 'self-hosted', 'remote'].includes(session?.runtime || ''));
         if (!session)
             return;
-        if (session.namespace !== input.namespace || !compatibleRuntime) {
-            warnSessionMismatch(session, input);
+        if (!developmentConnectionMatches(session, connection)) {
+            warnSessionMismatch(session, connection);
             return;
         }
         const bridgeUrl = safeBridgeUrl(session.bridgeUrl);
         if (!bridgeUrl)
             return;
         activeSession = { ...session, bridgeUrl };
-        const registration = { ...activeSession, runtimeInstanceId, applicationId };
+        const registration = { ...activeSession, runtimeInstanceId, applicationId, connection };
         try {
             const response = await fetch(`${bridgeUrl}/api/v1/development/runtime/register`, {
                 method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(registration),

package/dist/embedded-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedded-query.d.ts","sourceRoot":"","sources":["../src/embedded-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG9E,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAInC,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,GAAG,cAAc,GAAG,WAAW,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAgDD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CASrH;AAkCD,kFAAkF;AAClF,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,OAAO,CAAmC;gBAErB,OAAO,EAAE,MAAM,QAAQ,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIvE,OAAO,IAAI,IAAI;IAMf,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAgCpD,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,IAAI;IAqBZ,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,wBAAwB;IAK/D,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,qBAAqB,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG;QAAE,KAAK,EAAE,kBAAkB,CAAA;KAAE;IAyErG,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,UAAU;IA6BlB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,QAAQ;CAkBjB"}
+{"version":3,"file":"embedded-query.d.ts","sourceRoot":"","sources":["../src/embedded-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAI9E,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAInC,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,GAAG,cAAc,GAAG,WAAW,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAgDD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CASrH;AAkCD,kFAAkF;AAClF,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,OAAO,CAAmC;gBAErB,OAAO,EAAE,MAAM,QAAQ,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIvE,OAAO,IAAI,IAAI;IAMf,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAgCpD,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,IAAI;IAqBZ,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,wBAAwB;IAK/D,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,qBAAqB,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG;QAAE,KAAK,EAAE,kBAAkB,CAAA;KAAE;IAyErG,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,UAAU;IA6BlB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,QAAQ;CAkBjB"}

package/dist/embedded-query.js

@@ -1,3 +1,4 @@
+import { FeltDBErrorCode, FeltDBServiceError } from './error-codes.js';
 const now = () => typeof performance !== 'undefined' ? performance.now() : Date.now();
 function compareValue(left, right) {
     if (left === right)
@@ -78,7 +79,7 @@ function decode(cursor, expectedBinding) {
         return value;
     }
     catch {
-        throw new Error('INVALID_CURSOR: cursor is malformed or does not match this query');
+        throw new FeltDBServiceError('INVALID_CURSOR: cursor is malformed or does not match this query', FeltDBErrorCode.INVALID_CURSOR);
     }
 }
 /** Small deterministic planner/executor owned by an embedded storage boundary. */
@@ -331,7 +332,7 @@ export class EmbeddedQueryEngine {
     }
     validate(query) {
         if (!query.collection?.trim() || !Number.isInteger(query.limit) || query.limit < 1 || query.limit > 1_000)
-            throw new Error('INVALID_QUERY: collection and a limit between 1 and 1000 are required');
+            throw new FeltDBServiceError('INVALID_QUERY: collection and a limit between 1 and 1000 are required', 'INVALID_QUERY');
         for (const condition of query.where ?? []) {
             // Every key beside `field` must be exactly one known operator. A stray
             // key — a `semantic` clause misplaced into a condition, or anything
@@ -340,13 +341,13 @@ export class EmbeddedQueryEngine {
             const keys = Object.keys(condition).filter(key => key !== 'field');
             const operators = keys.filter(operator => ['eq', 'neq', 'lt', 'lte', 'gt', 'gte'].includes(operator));
             if (!condition.field || operators.length !== 1 || keys.length !== 1)
-                throw new Error('INVALID_QUERY: each condition requires a field and exactly one operator');
+                throw new FeltDBServiceError('INVALID_QUERY: each condition requires a field and exactly one operator', 'INVALID_QUERY');
         }
         if (query.semantic !== undefined) {
             // Semantic composition runs where the Rust decision primitive runs. This
             // embedded engine has no runtime binding, so it refuses the clause
             // rather than answering the deterministic query in its place.
-            throw new Error('SEMANTIC_UNSUPPORTED: this runtime has no semantic runtime binding; semantic query composition is available through the managed authority');
+            throw new FeltDBServiceError('SEMANTIC_UNSUPPORTED: this runtime has no semantic runtime binding; semantic query composition is available through the managed authority', 'SEMANTIC_UNSUPPORTED');
         }
     }
 }

package/dist/embedded-transaction.d.ts

@@ -126,7 +126,7 @@ export type EmbeddedPlan =
     kind: 'reject';
     reason: string;
     failure?: ConditionalConflictDetail;
-    code?: 'INVALID_REQUEST';
+    code?: 'INVALID_REQUEST' | 'CONTRACT_UNSUPPORTED';
 } | {
     kind: 'apply';
     mutations: EmbeddedMutation[];
@@ -184,8 +184,12 @@ export declare function embeddedDuplicate(request: AtomicTransactionRequest, pla
 export declare class EmbeddedTransactionRejected extends Error {
     readonly feltdbCode?: 'PRECONDITION_FAILED';
     readonly feltdbConflict?: ConditionalConflictDetail;
-    /** Set when the request itself was malformed, as opposed to refused by state. */
-    readonly code?: 'INVALID_REQUEST';
-    constructor(reason: string, failure?: ConditionalConflictDetail, code?: 'INVALID_REQUEST');
+    /**
+     * Set when the request itself was malformed (`INVALID_REQUEST`) or asks for
+     * something this runtime cannot evaluate (`CONTRACT_UNSUPPORTED`), as
+     * opposed to refused by state.
+     */
+    readonly code?: 'INVALID_REQUEST' | 'CONTRACT_UNSUPPORTED';
+    constructor(reason: string, failure?: ConditionalConflictDetail, code?: 'INVALID_REQUEST' | 'CONTRACT_UNSUPPORTED');
 }
 //# sourceMappingURL=embedded-transaction.d.ts.map

package/dist/embedded-transaction.d.ts.map

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

package/dist/embedded-transaction.js

@@ -95,6 +95,10 @@ export function recordKey(collection, id) {
     return `${collection}:${id}`;
 }
 const SEGMENT = /^[A-Za-z0-9._-]{1,128}$/;
+/** The version a guard fences on, whichever spelling supplied it. */
+function fencedVersion(guard) {
+    return guard.expectedVersion ?? guard.ifVersion;
+}
 /**
  * Whether the request is well-formed, judged without any stored state.
  *
@@ -109,6 +113,11 @@ function structuralRefusal(request) {
     if (request.operations.length === 0)
         return invalid('a transaction requires at least one operation');
     const seen = new Set();
+    for (const guarded of [...request.operations, ...(request.preconditions ?? [])]) {
+        if (guarded.ifVersion !== undefined && guarded.expectedVersion !== undefined && guarded.ifVersion !== guarded.expectedVersion) {
+            return invalid(`${guarded.collection}:${guarded.id} supplies ifVersion ${guarded.ifVersion} and expectedVersion ${guarded.expectedVersion}; they are the same predicate`);
+        }
+    }
     for (const operation of request.operations) {
         if (!SEGMENT.test(operation.collection) || !SEGMENT.test(operation.id)) {
             return invalid(`invalid collection or id: ${operation.collection}:${operation.id}`);
@@ -195,16 +204,24 @@ export function decideTransaction(request, state, digest) {
     }
     // Preconditions first, before any operation is staged, so a failure cannot
     // leave a prefix of the transaction decided.
+    //
+    // `ifVersion` is the public spelling of `expectedVersion` and reaches this
+    // boundary unnormalised from callers below `db.transaction` (collections,
+    // agent state, composition). It is the same predicate, so it is evaluated
+    // here rather than counted as "constrains something" and then skipped.
     const guards = [
-        ...(request.preconditions ?? []).map(condition => ({ ...condition })),
+        ...(request.preconditions ?? []).map(condition => ({
+            ...condition,
+            expectedVersion: fencedVersion(condition),
+        })),
         ...request.operations
-            .filter(operation => operation.expectedVersion !== undefined
+            .filter(operation => fencedVersion(operation) !== undefined
             || operation.expectedEpoch !== undefined
             || operation.expectedLeaseId !== undefined)
             .map(operation => ({
             collection: operation.collection,
             id: operation.id,
-            expectedVersion: operation.expectedVersion,
+            expectedVersion: fencedVersion(operation),
             expectedEpoch: operation.expectedEpoch,
             expectedLeaseId: operation.expectedLeaseId,
         })),
@@ -214,11 +231,12 @@ export function decideTransaction(request, state, digest) {
             kind: 'reject',
             reason: 'this runtime cannot evaluate transaction preconditions, so it refuses the '
                 + 'transaction rather than committing it unconditionally',
+            code: 'CONTRACT_UNSUPPORTED',
         };
     }
     for (const guard of guards) {
         if (!SEGMENT.test(guard.collection) || !SEGMENT.test(String(guard.id))) {
-            return { kind: 'reject', reason: `invalid collection or id: ${guard.collection}:${guard.id}` };
+            return { kind: 'reject', reason: `invalid collection or id: ${guard.collection}:${guard.id}`, code: 'INVALID_REQUEST' };
         }
         const constrains = guard.requireAbsent === true
             || guard.expectedVersion !== undefined
@@ -228,6 +246,7 @@ export function decideTransaction(request, state, digest) {
             return {
                 kind: 'reject',
                 reason: `precondition on ${guard.collection}:${guard.id} constrains nothing`,
+                code: 'INVALID_REQUEST',
             };
         }
         const key = recordKey(guard.collection, String(guard.id));
@@ -237,7 +256,7 @@ export function decideTransaction(request, state, digest) {
                 return {
                     kind: 'reject',
                     reason: `PRECONDITION_FAILED:${key}:record already exists`,
-                    failure: { predicate: 'present', collection: guard.collection, key },
+                    failure: { predicate: 'present', collection: guard.collection, id: String(guard.id), key },
                 };
             }
             continue;
@@ -246,7 +265,7 @@ export function decideTransaction(request, state, digest) {
             return {
                 kind: 'reject',
                 reason: `PRECONDITION_FAILED:${key}:record does not exist`,
-                failure: { predicate: 'missing', collection: guard.collection, key },
+                failure: { predicate: 'missing', collection: guard.collection, id: String(guard.id), key },
             };
         }
         if (guard.expectedVersion !== undefined) {
@@ -258,6 +277,7 @@ export function decideTransaction(request, state, digest) {
                     failure: {
                         predicate: 'version',
                         collection: guard.collection,
+                        id: String(guard.id),
                         key,
                         expected: guard.expectedVersion,
                         actual,
@@ -275,6 +295,7 @@ export function decideTransaction(request, state, digest) {
                     failure: {
                         predicate: 'epoch',
                         collection: guard.collection,
+                        id: String(guard.id),
                         key,
                         expected: guard.expectedEpoch,
                         actual,
@@ -293,6 +314,7 @@ export function decideTransaction(request, state, digest) {
                     failure: {
                         predicate: 'lease',
                         collection: guard.collection,
+                        id: String(guard.id),
                         key,
                         expected: guard.expectedLeaseId,
                         actual: held ?? null,
@@ -310,18 +332,19 @@ export function decideTransaction(request, state, digest) {
                 kind: 'reject',
                 reason: 'this runtime cannot evaluate read-basis fences inside its commit boundary, so it refuses the '
                     + 'transaction rather than committing it unfenced',
+                code: 'CONTRACT_UNSUPPORTED',
             };
         }
         for (const fence of fences) {
             if (typeof fence?.token !== 'string' || !fence.token.startsWith(EMBEDDED_READ_BASIS_PREFIX)) {
-                return { kind: 'reject', reason: 'a read basis was not issued by this authority' };
+                return { kind: 'reject', reason: 'a read basis was not issued by this authority', code: 'INVALID_REQUEST' };
             }
             let actual;
             try {
                 actual = readBasisToken(fence.reads, { read: state.read, scan: state.scan });
             }
             catch (error) {
-                return { kind: 'reject', reason: `invalid read basis: ${error instanceof Error ? error.message : String(error)}` };
+                return { kind: 'reject', reason: `invalid read basis: ${error instanceof Error ? error.message : String(error)}`, code: 'INVALID_REQUEST' };
             }
             if (actual !== fence.token) {
                 const first = normaliseReadSet(fence.reads);
@@ -345,6 +368,7 @@ export function decideTransaction(request, state, digest) {
             return {
                 kind: 'reject',
                 reason: `invalid collection or id: ${operation.collection}:${operation.id}`,
+                code: 'INVALID_REQUEST',
             };
         }
         const key = recordKey(operation.collection, operation.id);
@@ -352,30 +376,38 @@ export function decideTransaction(request, state, digest) {
             return {
                 kind: 'reject',
                 reason: `PRECONDITION_FAILED:${key}:record already exists`,
-                failure: { predicate: 'present', collection: operation.collection, key },
+                failure: { predicate: 'present', collection: operation.collection, id: operation.id, key },
             };
         }
         // A requireAbsent create begins the authority-owned version lifecycle at
-        // 1. A write fenced by expectedVersion is validated at N and written at
-        // N + 1. Both are resolved in the same decision the runtime applies
-        // atomically. An unconditional write remains verbatim, and a delete has no
-        // record left to carry a version.
+        // 1. A write fenced by expectedVersion -- on the operation itself or by a
+        // transaction-level precondition on the same record -- is validated at N
+        // and written at N + 1. Both are resolved in the same decision the runtime
+        // applies atomically. An unconditional write remains verbatim, and a
+        // delete has no record left to carry a version.
+        //
+        // Where the fence is declared does not matter, and must not: a guard
+        // `preconditions: [{ A, ifVersion: N }]` beside a write of A that left the
+        // version alone would let a second transaction guarded on N commit after
+        // the first, which is the exclusive progression the guard exists to
+        // provide. The Rust authority applies the same rule.
         //
         // The value the caller supplied for __version is replaced rather than
         // honoured, because a caller that computes a different next version must
         // not be able to install it.
         // See docs/architecture/transaction-version-contract.md.
+        const sameRecord = (guard) => guard.collection === operation.collection
+            && String(guard.id) === operation.id;
         const guardedCreate = operation.requireAbsent === true
-            || guards.some(guard => guard.requireAbsent === true
-                && guard.collection === operation.collection
-                && String(guard.id) === operation.id);
+            || guards.some(guard => guard.requireAbsent === true && sameRecord(guard));
+        const fencedAt = guards.find(guard => guard.expectedVersion !== undefined && sameRecord(guard))?.expectedVersion;
         const value = operation.value === undefined
             ? undefined
             : guardedCreate
                 ? { ...operation.value, id: operation.id, __version: 1 }
-                : operation.expectedVersion === undefined
+                : fencedAt === undefined
                     ? { ...operation.value, id: operation.id }
-                    : { ...operation.value, id: operation.id, __version: operation.expectedVersion + 1 };
+                    : { ...operation.value, id: operation.id, __version: fencedAt + 1 };
         mutations.push({
             key,
             collection: operation.collection,
@@ -437,7 +469,11 @@ export function embeddedDuplicate(request, plan) {
 export class EmbeddedTransactionRejected extends Error {
     feltdbCode;
     feltdbConflict;
-    /** Set when the request itself was malformed, as opposed to refused by state. */
+    /**
+     * Set when the request itself was malformed (`INVALID_REQUEST`) or asks for
+     * something this runtime cannot evaluate (`CONTRACT_UNSUPPORTED`), as
+     * opposed to refused by state.
+     */
     code;
     constructor(reason, failure, code) {
         super(reason);

package/dist/error-codes.d.ts

@@ -53,13 +53,42 @@ export declare enum FeltDBErrorCode {
     SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
     AUTHORITY_SCOPE_REQUIRED = "AUTHORITY_SCOPE_REQUIRED",
     AUTHORITY_SCOPE_INVALID = "AUTHORITY_SCOPE_INVALID",
-    AUTHORITY_SCOPE_MISMATCH = "AUTHORITY_SCOPE_MISMATCH"
+    AUTHORITY_SCOPE_MISMATCH = "AUTHORITY_SCOPE_MISMATCH",
+    /** A local state directory is open exclusively by another live process. */
+    STATE_LOCKED = "STATE_LOCKED",
+    /** Stored content no longer hashes to its address. The bytes were not returned. */
+    CONTENT_INTEGRITY_FAILURE = "CONTENT_INTEGRITY_FAILURE"
 }
 export declare class FeltDBServiceError extends Error {
     readonly code: FeltDBErrorCode | string;
     readonly requestId?: string | undefined;
     readonly status?: number | undefined;
-    constructor(message: string, code: FeltDBErrorCode | string, requestId?: string | undefined, status?: number | undefined);
+    /** The authority's structured error body, when it answered with one. */
+    readonly body?: Record<string, unknown>;
+    constructor(message: string, code: FeltDBErrorCode | string, requestId?: string | undefined, status?: number | undefined, body?: Record<string, unknown>);
+    /** The body's structured `details`, when it carried any (e.g. a reused idempotency key's reason). */
+    get details(): Record<string, unknown> | undefined;
+}
+/**
+ * The local file runtime's state directory is held exclusively by another
+ * process. Nothing was opened, read, or modified.
+ *
+ * `owner` is what the lock file records about its holder. Close the other
+ * process, or, if it is gone and its lock could not be judged stale (another
+ * host, an unreadable lock), remove `lockPath` by hand.
+ */
+export declare class LocalStateLockedError extends FeltDBServiceError {
+    readonly lockPath: string;
+    readonly owner: {
+        pid?: number;
+        host?: string;
+        acquiredAt?: string;
+    };
+    constructor(lockPath: string, owner: {
+        pid?: number;
+        host?: string;
+        acquiredAt?: string;
+    }, detail?: string);
 }
 /**
  * Error response structure that all FeltDB APIs must return

package/dist/error-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../src/error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,oBAAY,eAAe;IACzB,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,sBAAsB,2BAA2B;IACjD,kBAAkB,uBAAuB;IACzC,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAC7C,6BAA6B;IAC7B,EAAE,OAAO;IAET,wEAAwE;IACxE,QAAQ,aAAa;IAErB,2DAA2D;IAC3D,mBAAmB,wBAAwB;IAE3C,gEAAgE;IAChE,QAAQ,aAAa;IAErB,6DAA6D;IAC7D,cAAc,mBAAmB;IACjC,uBAAuB,4BAA4B;IACnD,qBAAqB,0BAA0B;IAC/C,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAC7C,gFAAgF;IAChF,wBAAwB,6BAA6B;IACrD;sEACkE;IAClE,sBAAsB,2BAA2B;IACjD,aAAa,kBAAkB;IAC/B,oBAAoB,yBAAyB;IAC7C,kBAAkB,uBAAuB;IACzC,eAAe,oBAAoB;IACnC,oBAAoB,yBAAyB;IAC7C,gBAAgB,qBAAqB;IACrC,mBAAmB,wBAAwB;IAC3C,wBAAwB,6BAA6B;IACrD,uBAAuB,4BAA4B;IACnD,wBAAwB,6BAA6B;CACtD;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;gBAHxB,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,eAAe,GAAG,MAAM,EAC9B,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,MAAM,CAAC,EAAE,MAAM,YAAA;CAE3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC;IAE/B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAEhB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IAEnB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IAEpB,gEAAgE;IAChE,aAAa,CAAC,EAAE,eAAe,GAAG,YAAY,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;CAC1F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,OAAO,CAGxE;AAED,MAAM,MAAM,yBAAyB,GACjC,WAAW,GACX,eAAe,GACf,yBAAyB,GACzB,4BAA4B,CAAC;AAEjC,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,yBAAyB,CAevF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,qBAAqB,GAAG,gBAAgB,GAAG,YAAY,CAQxH"}
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../src/error-codes.ts"],"names":[],"mappings":"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"}

package/dist/error-codes.js

@@ -55,17 +55,53 @@ export var FeltDBErrorCode;
     FeltDBErrorCode["AUTHORITY_SCOPE_REQUIRED"] = "AUTHORITY_SCOPE_REQUIRED";
     FeltDBErrorCode["AUTHORITY_SCOPE_INVALID"] = "AUTHORITY_SCOPE_INVALID";
     FeltDBErrorCode["AUTHORITY_SCOPE_MISMATCH"] = "AUTHORITY_SCOPE_MISMATCH";
+    /** A local state directory is open exclusively by another live process. */
+    FeltDBErrorCode["STATE_LOCKED"] = "STATE_LOCKED";
+    /** Stored content no longer hashes to its address. The bytes were not returned. */
+    FeltDBErrorCode["CONTENT_INTEGRITY_FAILURE"] = "CONTENT_INTEGRITY_FAILURE";
 })(FeltDBErrorCode || (FeltDBErrorCode = {}));
 export class FeltDBServiceError extends Error {
     code;
     requestId;
     status;
-    constructor(message, code, requestId, status) {
+    /** The authority's structured error body, when it answered with one. */
+    body;
+    constructor(message, code, requestId, status, body) {
         super(message);
         this.code = code;
         this.requestId = requestId;
         this.status = status;
         this.name = 'FeltDBServiceError';
+        if (body !== undefined)
+            this.body = body;
+    }
+    /** The body's structured `details`, when it carried any (e.g. a reused idempotency key's reason). */
+    get details() {
+        const details = this.body?.details;
+        return details && typeof details === 'object' && !Array.isArray(details) ? details : undefined;
+    }
+}
+/**
+ * The local file runtime's state directory is held exclusively by another
+ * process. Nothing was opened, read, or modified.
+ *
+ * `owner` is what the lock file records about its holder. Close the other
+ * process, or, if it is gone and its lock could not be judged stale (another
+ * host, an unreadable lock), remove `lockPath` by hand.
+ */
+export class LocalStateLockedError extends FeltDBServiceError {
+    lockPath;
+    owner;
+    constructor(lockPath, owner, detail) {
+        super(`STATE_LOCKED: ${lockPath.replace(/[\\/][^\\/]+$/, '')} is open exclusively by `
+            + `${owner.pid === undefined ? 'another process' : `process ${owner.pid}`}`
+            + `${owner.host ? ` on ${owner.host}` : ''}${owner.acquiredAt ? ` since ${owner.acquiredAt}` : ''}. `
+            + (detail ? `${detail} ` : '')
+            + 'Close that process first, or open with createFeltDB({ path, access: \'shared\' }) if several '
+            + 'processes are meant to share this state.', FeltDBErrorCode.STATE_LOCKED);
+        this.lockPath = lockPath;
+        this.owner = owner;
+        this.name = 'LocalStateLockedError';
     }
 }
 /**
@@ -81,7 +117,10 @@ export function classifyError(code) {
         return 'retryable';
     if (code === FeltDBErrorCode.CONFLICT || code === FeltDBErrorCode.VERSION_CONFLICT
         || code === FeltDBErrorCode.IDEMPOTENCY_CONFLICT
-        || code === FeltDBErrorCode.COMMIT_OUTCOME_UNKNOWN)
+        || code === FeltDBErrorCode.COMMIT_OUTCOME_UNKNOWN
+        // A commit the authority could not make durable has an unknown outcome:
+        // reconcile by retrying with the same transaction id, never by assuming.
+        || code === FeltDBErrorCode.DURABILITY_FAILURE)
         return 'requires_reconciliation';
     if (code === FeltDBErrorCode.PRECONDITION_FAILED
         || code === FeltDBErrorCode.VALIDATION_ERROR

package/dist/feltdb.d.ts

@@ -67,6 +67,13 @@ export interface JsDb {
     delete?(key: string): any | Promise<any>;
     /** Subscribe to runtime-originated changes, including remote mutations. */
     subscribe_changes?(callback: (collection: string) => void, collection?: string): () => void;
+    /** Content-addressed immutable bytes (server and local file runtimes). */
+    storeContent?(content: Uint8Array): Promise<{
+        hash: string;
+        bytes: number;
+        ref: string;
+    }>;
+    acquireContent?(hash: string): Promise<Uint8Array | null>;
     close?(): void | Promise<void>;
     /**
      * Get capability records

package/dist/feltdb.d.ts.map

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

package/dist/file-db.d.ts

@@ -57,6 +57,15 @@ export interface FileJsDbOptions {
     };
     /** Collect persistence timings. Also enabled by `FELTDB_PERSISTENCE_PROFILE=1`. */
     profile?: boolean;
+    /**
+     * `shared` (the default for a directly constructed `FileJsDb`): any number
+     * of processes may open the directory; each commit is serialized by
+     * `state.lock`. `exclusive` (the default of `createFeltDB({ path })`): this
+     * process takes `owner.lock` at open and another process opening the same
+     * directory exclusively *or shared* is refused with `LocalStateLockedError`
+     * until `close()` or process exit. Handles in one process share the lock.
+     */
+    access?: 'shared' | 'exclusive';
 }
 export interface PersistenceStatus {
     format: 'none' | 'legacy-snapshot' | 'snapshot+journal';
@@ -91,7 +100,16 @@ export declare class FileJsDb implements JsDb {
     private readonly profiler;
     private readonly compaction;
     private compactionScheduled;
+    private releaseOwnerLock;
+    /** How this handle opened its directory. */
+    readonly access: 'shared' | 'exclusive';
     constructor(path: string, options?: FileJsDbOptions);
+    /**
+     * A shared open still respects an exclusive owner in another process: a
+     * process that asked for exclusive access must not find a second writer.
+     * Probing takes no lock of its own.
+     */
+    private assertNotHeldExclusively;
     private journalPath;
     private snapshotKey;
     private parseSnapshot;
@@ -283,6 +301,15 @@ export declare class FileJsDb implements JsDb {
         conflictCode?: string;
         item?: any;
     }>;
+    private contentDirectory;
+    private static sha256;
+    storeContent(content: Uint8Array): Promise<{
+        hash: string;
+        bytes: number;
+        ref: string;
+    }>;
+    acquireContent(hash: string): Promise<Uint8Array | null>;
+    private fsyncDirectory;
     close(): void;
 }
 //# sourceMappingURL=file-db.d.ts.map