@optimystic/db-core 1.0.0-beta.3 → 1.0.0

package/dist/src/collections/tree/struct.d.ts

@@ -14,7 +14,10 @@ export declare const rootId$: string;
  *
  * - `absent` — the key must not exist (SQL INSERT): a hit throws {@link TreeKeyTakenError},
  *   discarding the whole action's staged writes.
- * - `keepExisting` — if the key exists, skip this entry silently (SQL INSERT OR IGNORE).
+ * - `keepExisting` — if the key exists, skip this entry silently. No SQL statement stages
+ *   it any more (INSERT OR IGNORE is guarded `absent`, because skipping only the main-table
+ *   entry would leave the statement's index entries beside a rival's row — see the
+ *   `unchanged` paragraph in docs/internals.md); kept as a serialized log form.
  * - `absentRange` — no entry OTHER THAN this action's own key may exist in `range`
  *   (secondary-UNIQUE enforcement, where uniqueness is a property of a framed key
  *   PREFIX rather than one exact key: an index tree keys `indexKey ‖ primaryKey`, so
@@ -22,42 +25,101 @@ export declare const rootId$: string;
  *   foreign hit throws {@link TreeRangeTakenError}. The entry being staged lands inside
  *   its own range, so the scan excludes its exact key — otherwise every guarded
  *   re-stage of a present key (a replay after a clean refresh) would refuse itself.
+ * - `unchanged` — see {@link TreeUnchangedGuard}: the only kind that says something must
+ *   still BE here, rather than that nothing may be.
  *
  * MIXED VERSIONS: a peer running a build that predates guards destructures `[key, entry]`
  * and ignores the third slot — its replays revert to today's silent overwrite. No version
  * gating exists yet (see backlog ticket `debt-mixed-version-identify-incompatibility`).
  */
-export type TreeEntryGuard<TKey> = {
+export type TreeEntryGuard<TKey, TEntry = unknown> = {
     kind: 'absent';
 } | {
     kind: 'keepExisting';
 } | {
     kind: 'absentRange';
     range: KeyRange<TKey>;
+} | TreeUnchangedGuard<TEntry>;
+/**
+ * "The entry I am replacing must still be exactly the one I read" — the optimistic-concurrency
+ * (lost-update) guard, and the only {@link TreeEntryGuard} kind that also applies to a DELETE.
+ * The entry at the key must be PRESENT and structurally equal to `expected` (`structuralEquals`
+ * in `packages/db-core/src/utility/structural-equals.ts`); otherwise the handler throws
+ * {@link TreeEntryChangedError}.
+ *
+ * ABSENT COUNTS AS CHANGED. The staged effect was computed from an entry image that no longer
+ * exists, so re-applying it is never right: an upsert would resurrect a row a rival deleted, and
+ * a delete would be the second of two racing deletes. Refusing both is the optimistic answer —
+ * the writer read a row that is now gone, and an application-level retry then affects zero rows
+ * sequentially. If tolerating absence on deletes is ever genuinely wanted, add a separate
+ * `unchangedOrAbsent` kind rather than weakening this one's contract.
+ *
+ * `expected` is the entry AS STORED, not a digest: a guard rides in the log beside its action
+ * under the same encoding entries already use, so a full copy round-trips by construction and no
+ * digest scheme has to be invented, versioned, or kept in sync with the entry encoding.
+ *
+ * NOTE: that choice roughly doubles the row bytes of every guarded log entry (the new entry plus
+ * a full copy of the old one). If log volume ever becomes the binding constraint, replace
+ * `expected` with a content digest — the block-digest utilities under
+ * `packages/db-core/src/transaction/` are the starting point — and accept the versioning burden
+ * that comes with it.
+ */
+export type TreeUnchangedGuard<TEntry = unknown> = {
+    kind: 'unchanged';
+    /** The entry image the staged write read, as stored. */
+    expected: TEntry;
 };
-/** Represents a unit of change to a tree collection. */
-export type TreeReplaceAction<TKey, TEntry> = [
+/** An element that writes (inserts or replaces) an entry. Any {@link TreeEntryGuard} kind is
+ *  meaningful here. */
+export type TreeUpsertElement<TKey, TEntry> = [
     key: TKey,
-    entry?: TEntry,
-    guard?: TreeEntryGuard<TKey>
-][];
+    entry: TEntry,
+    guard?: TreeEntryGuard<TKey, TEntry>
+];
+/** An element that deletes the entry at a key. Only {@link TreeUnchangedGuard} says anything a
+ *  delete can act on — the other kinds all assert that nothing is present, which would make the
+ *  delete a no-op by construction. The handler rejects any other kind at runtime too, since a
+ *  replayed log entry is deserialized data that this type never policed. */
+export type TreeDeleteElement<TKey, TEntry> = [
+    key: TKey,
+    entry?: undefined,
+    guard?: TreeUnchangedGuard<TEntry>
+];
+/** Represents a unit of change to a tree collection. */
+export type TreeReplaceAction<TKey, TEntry> = (TreeUpsertElement<TKey, TEntry> | TreeDeleteElement<TKey, TEntry>)[];
 /**
- * Thrown by the tree `replace` handler when an entry guarded `absent` finds its key
- * already present — at initial staging, or (the load-bearing case) at conflict replay
- * after a rival writer's commit was adopted. The throw discards the whole action's
- * staged writes (the handler runs inside an all-or-nothing Atomic wrapper) and
- * propagates out of the sync/commit retry loops: it is not a StaleFailure, so no
- * retry absorbs it, and it must never be downgraded to a retryable condition.
+ * Base of every refusal a {@link TreeEntryGuard} raises out of the tree `replace` handler — at
+ * initial staging, or (the load-bearing case) at conflict replay after a rival writer's commit
+ * was adopted. One contract, stated once for every subclass:
+ *
+ * - The throw **discards the whole action's staged writes** — the handler runs inside an
+ *   all-or-nothing Atomic wrapper, so not one entry of a multi-entry action lands.
+ * - It is **not a `StaleFailure`**, so neither `Collection.sync`'s retry loop nor
+ *   `TransactionCoordinator.commit`'s stale-loss re-drive absorbs it; it propagates out of the
+ *   losing commit, and it must never be downgraded to a retryable condition.
+ *
+ * Subclasses split by WHAT was refused, because consumers map them differently: a
+ * {@link TreeKeyTakenError} is a uniqueness violation (the Quereus bridge renders it as
+ * `UNIQUE constraint failed`), while a {@link TreeEntryChangedError} is a lost update. Catch
+ * this base to treat any guard refusal uniformly; catch a subclass to say which happened.
  */
-export declare class TreeKeyTakenError<TKey = unknown> extends Error {
+export declare class TreeGuardRefusedError<TKey = unknown> extends Error {
     /** The collection whose tree refused the entry. */
     readonly collectionId: CollectionId;
-    /** The key some other writer already committed (for the `absentRange` subclass: the
-     * key this action was staging, whose claimed range a rival occupies). */
+    /** The key whose staged entry was refused. */
     readonly key: TKey;
     constructor(
     /** The collection whose tree refused the entry. */
     collectionId: CollectionId, 
+    /** The key whose staged entry was refused. */
+    key: TKey, message: string);
+}
+/**
+ * Thrown when an entry guarded `absent` finds its key already present: a duplicate-key
+ * refusal. See {@link TreeGuardRefusedError} for the contract every guard refusal shares.
+ */
+export declare class TreeKeyTakenError<TKey = unknown> extends TreeGuardRefusedError<TKey> {
+    constructor(collectionId: CollectionId, 
     /** The key some other writer already committed (for the `absentRange` subclass: the
      * key this action was staging, whose claimed range a rival occupies). */
     key: TKey, 
@@ -88,4 +150,50 @@ export declare class TreeRangeTakenError<TKey = unknown> extends TreeKeyTakenErr
     /** The committed key found inside `range` that is not `key`. */
     occupant: TKey);
 }
+/**
+ * The {@link TreeUnchangedGuard} refusal: the entry at `key` is no longer the one the staged
+ * write read — a rival committed a different entry there, or removed it (`actual` is
+ * `undefined`). A lost update, NOT a uniqueness violation, which is why this deliberately does
+ * NOT subclass {@link TreeKeyTakenError}: the Quereus bridge renders every `TreeKeyTakenError`
+ * as that collection's registered `UNIQUE constraint failed` message (`mapCommitRefusal` in
+ * `packages/quereus-plugin-optimystic/src/optimystic-adapter/txn-bridge.ts`), and reporting a
+ * concurrent-update refusal as a uniqueness failure would mislead every client that reads it.
+ * The shared contract lives on {@link TreeGuardRefusedError}.
+ */
+export declare class TreeEntryChangedError<TKey = unknown, TEntry = unknown> extends TreeGuardRefusedError<TKey> {
+    /** The entry image the staged write read, as carried by its guard. */
+    readonly expected: TEntry;
+    /** What is committed at `key` now; `undefined` when the entry is gone entirely. */
+    readonly actual: TEntry | undefined;
+    constructor(collectionId: CollectionId, 
+    /** The key whose entry the staged write was replacing or deleting. */
+    key: TKey, 
+    /** The entry image the staged write read, as carried by its guard. */
+    expected: TEntry, 
+    /** What is committed at `key` now; `undefined` when the entry is gone entirely. */
+    actual: TEntry | undefined);
+}
+/**
+ * A DELETE element carries a guard kind no delete can act on. NOT a concurrency refusal and
+ * deliberately not a {@link TreeGuardRefusedError}: every other kind asserts that nothing is
+ * present, which would make the delete a no-op by construction, so this is a malformed action —
+ * a caller bug, or a log entry written by a build whose element types disagree with this one.
+ * The handler raises it rather than ignoring the guard (the pre-guard behaviour) so a writer
+ * never believes an unenforceable guard is being enforced.
+ */
+export declare class TreeDeleteGuardKindError<TKey = unknown> extends Error {
+    /** The collection whose tree rejected the element. */
+    readonly collectionId: CollectionId;
+    /** The key the malformed delete named. */
+    readonly key: TKey;
+    /** The `kind` that was carried; only `'unchanged'` is meaningful on a delete. */
+    readonly guardKind: string;
+    constructor(
+    /** The collection whose tree rejected the element. */
+    collectionId: CollectionId, 
+    /** The key the malformed delete named. */
+    key: TKey, 
+    /** The `kind` that was carried; only `'unchanged'` is meaningful on a delete. */
+    guardKind: string);
+}
 //# sourceMappingURL=struct.d.ts.map

package/dist/src/collections/tree/struct.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"struct.d.ts","sourceRoot":"","sources":["../../../../src/collections/tree/struct.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKrD,eAAO,MAAM,mBAAmB,QAA8C,CAAC;AAO/E,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,GAAG;IAC/D,MAAM,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,OAAO,QAA8C,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,cAAc,CAAC,IAAI,IAC5B;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAElD,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,CAAC,IAAI,EAAE,MAAM,IAAI;IAE7C,GAAG,EAAE,IAAI;IAET,KAAK,CAAC,EAAE,MAAM;IAId,KAAK,CAAC,EAAE,cAAc,CAAC,IAAI,CAAC;CAC5B,EAAE,CAAC;AAEJ;;;;;;;GAOG;AACH,qBAAa,iBAAiB,CAAC,IAAI,GAAG,OAAO,CAAE,SAAQ,KAAK;IAE1D,mDAAmD;aACnC,YAAY,EAAE,YAAY;IAC1C;6EACyE;aACzD,GAAG,EAAE,IAAI;;IAJzB,mDAAmD;IACnC,YAAY,EAAE,YAAY;IAC1C;6EACyE;IACzD,GAAG,EAAE,IAAI;IACzB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM;CAKjB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB,CAAC,IAAI,GAAG,OAAO,CAAE,SAAQ,iBAAiB,CAAC,IAAI,CAAC;IAK9E,+CAA+C;aAC/B,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC;IACrC,gEAAgE;aAChD,QAAQ,EAAE,IAAI;gBAN9B,YAAY,EAAE,YAAY;IAC1B,kFAAkF;IAClF,GAAG,EAAE,IAAI;IACT,+CAA+C;IAC/B,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC;IACrC,gEAAgE;IAChD,QAAQ,EAAE,IAAI;CAO/B"}
+{"version":3,"file":"struct.d.ts","sourceRoot":"","sources":["../../../../src/collections/tree/struct.ts"],"names":[],"mappings":"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"}

package/dist/src/collections/tree/struct.js

@@ -8,27 +8,47 @@ registerCollectionType({
 });
 export const rootId$ = nameof("rootId");
 /**
- * Thrown by the tree `replace` handler when an entry guarded `absent` finds its key
- * already present — at initial staging, or (the load-bearing case) at conflict replay
- * after a rival writer's commit was adopted. The throw discards the whole action's
- * staged writes (the handler runs inside an all-or-nothing Atomic wrapper) and
- * propagates out of the sync/commit retry loops: it is not a StaleFailure, so no
- * retry absorbs it, and it must never be downgraded to a retryable condition.
+ * Base of every refusal a {@link TreeEntryGuard} raises out of the tree `replace` handler — at
+ * initial staging, or (the load-bearing case) at conflict replay after a rival writer's commit
+ * was adopted. One contract, stated once for every subclass:
+ *
+ * - The throw **discards the whole action's staged writes** — the handler runs inside an
+ *   all-or-nothing Atomic wrapper, so not one entry of a multi-entry action lands.
+ * - It is **not a `StaleFailure`**, so neither `Collection.sync`'s retry loop nor
+ *   `TransactionCoordinator.commit`'s stale-loss re-drive absorbs it; it propagates out of the
+ *   losing commit, and it must never be downgraded to a retryable condition.
+ *
+ * Subclasses split by WHAT was refused, because consumers map them differently: a
+ * {@link TreeKeyTakenError} is a uniqueness violation (the Quereus bridge renders it as
+ * `UNIQUE constraint failed`), while a {@link TreeEntryChangedError} is a lost update. Catch
+ * this base to treat any guard refusal uniformly; catch a subclass to say which happened.
  */
-export class TreeKeyTakenError extends Error {
+export class TreeGuardRefusedError extends Error {
     collectionId;
     key;
     constructor(
     /** The collection whose tree refused the entry. */
     collectionId, 
+    /** The key whose staged entry was refused. */
+    key, message) {
+        super(message);
+        this.collectionId = collectionId;
+        this.key = key;
+        this.name = 'TreeGuardRefusedError';
+    }
+}
+/**
+ * Thrown when an entry guarded `absent` finds its key already present: a duplicate-key
+ * refusal. See {@link TreeGuardRefusedError} for the contract every guard refusal shares.
+ */
+export class TreeKeyTakenError extends TreeGuardRefusedError {
+    constructor(collectionId, 
     /** The key some other writer already committed (for the `absentRange` subclass: the
      * key this action was staging, whose claimed range a rival occupies). */
     key, 
     /** Subclass override of the rendered message; the default names the exact-key refusal. */
     message) {
-        super(message ?? `Tree collection ${collectionId}: key ${renderKey(key)} is already taken by a committed entry`);
-        this.collectionId = collectionId;
-        this.key = key;
+        super(collectionId, key, message ?? `Tree collection ${collectionId}: key ${renderKey(key)} is already taken by a committed entry`);
         this.name = 'TreeKeyTakenError';
     }
 }
@@ -60,9 +80,64 @@ export class TreeRangeTakenError extends TreeKeyTakenError {
         this.name = 'TreeRangeTakenError';
     }
 }
+/**
+ * The {@link TreeUnchangedGuard} refusal: the entry at `key` is no longer the one the staged
+ * write read — a rival committed a different entry there, or removed it (`actual` is
+ * `undefined`). A lost update, NOT a uniqueness violation, which is why this deliberately does
+ * NOT subclass {@link TreeKeyTakenError}: the Quereus bridge renders every `TreeKeyTakenError`
+ * as that collection's registered `UNIQUE constraint failed` message (`mapCommitRefusal` in
+ * `packages/quereus-plugin-optimystic/src/optimystic-adapter/txn-bridge.ts`), and reporting a
+ * concurrent-update refusal as a uniqueness failure would mislead every client that reads it.
+ * The shared contract lives on {@link TreeGuardRefusedError}.
+ */
+export class TreeEntryChangedError extends TreeGuardRefusedError {
+    expected;
+    actual;
+    constructor(collectionId, 
+    /** The key whose entry the staged write was replacing or deleting. */
+    key, 
+    /** The entry image the staged write read, as carried by its guard. */
+    expected, 
+    /** What is committed at `key` now; `undefined` when the entry is gone entirely. */
+    actual) {
+        super(collectionId, key, `Tree collection ${collectionId}: the entry at key ${renderKey(key)} was `
+            + `${actual === undefined ? 'removed' : 'changed'} by another writer since this change read it`);
+        this.expected = expected;
+        this.actual = actual;
+        this.name = 'TreeEntryChangedError';
+    }
+}
+/**
+ * A DELETE element carries a guard kind no delete can act on. NOT a concurrency refusal and
+ * deliberately not a {@link TreeGuardRefusedError}: every other kind asserts that nothing is
+ * present, which would make the delete a no-op by construction, so this is a malformed action —
+ * a caller bug, or a log entry written by a build whose element types disagree with this one.
+ * The handler raises it rather than ignoring the guard (the pre-guard behaviour) so a writer
+ * never believes an unenforceable guard is being enforced.
+ */
+export class TreeDeleteGuardKindError extends Error {
+    collectionId;
+    key;
+    guardKind;
+    constructor(
+    /** The collection whose tree rejected the element. */
+    collectionId, 
+    /** The key the malformed delete named. */
+    key, 
+    /** The `kind` that was carried; only `'unchanged'` is meaningful on a delete. */
+    guardKind) {
+        super(`Tree collection ${collectionId}: the delete of key ${renderKey(key)} carries a `
+            + `'${guardKind}' guard; only 'unchanged' is meaningful on a delete`);
+        this.collectionId = collectionId;
+        this.key = key;
+        this.guardKind = guardKind;
+        this.name = 'TreeDeleteGuardKindError';
+    }
+}
 /** String keys render JSON-quoted so framing control bytes stay visible/escaped in logs;
  * everything else via String() — JSON.stringify would throw on a bigint key, and an error
- * constructor must never be the second failure. */
+ * constructor must never be the second failure. Module-private on purpose: every tree message
+ * renders a key the same way because every one of them is constructed in this file. */
 function renderKey(key) {
     return typeof key === 'string' ? JSON.stringify(key) : String(key);
 }

package/dist/src/collections/tree/struct.js.map

@@ -1 +1 @@
-{"version":3,"file":"struct.js","sourceRoot":"","sources":["../../../../src/collections/tree/struct.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;AAE/E,sBAAsB,CAAC;IACtB,SAAS,EAAE,mBAAmB;IAC9B,IAAI,EAAE,MAAM;CACZ,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAA4B,QAAQ,CAAC,CAAC;AAyCnE;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAkC,SAAQ,KAAK;IAG1C;IAGA;IALjB;IACC,mDAAmD;IACnC,YAA0B;IAC1C;6EACyE;IACzD,GAAS;IACzB,0FAA0F;IAC1F,OAAgB;QAEhB,KAAK,CAAC,OAAO,IAAI,mBAAmB,YAAY,SAAS,SAAS,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QAPjG,iBAAY,GAAZ,YAAY,CAAc;QAG1B,QAAG,GAAH,GAAG,CAAM;QAKzB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACjC,CAAC;CACD;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,mBAAoC,SAAQ,iBAAuB;IAM9D;IAEA;IAPjB,YACC,YAA0B;IAC1B,kFAAkF;IAClF,GAAS;IACT,+CAA+C;IAC/B,KAAqB;IACrC,gEAAgE;IAChD,QAAc;QAE9B,KAAK,CAAC,YAAY,EAAE,GAAG,EACtB,mBAAmB,YAAY,SAAS,SAAS,CAAC,GAAG,CAAC,sCAAsC;cAC1F,uCAAuC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QANjD,UAAK,GAAL,KAAK,CAAgB;QAErB,aAAQ,GAAR,QAAQ,CAAM;QAK9B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;CACD;AAED;;mDAEmD;AACnD,SAAS,SAAS,CAAC,GAAY;IAC9B,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"struct.js","sourceRoot":"","sources":["../../../../src/collections/tree/struct.ts"],"names":[],"mappings":"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"}

package/dist/src/collections/tree/tree.d.ts

@@ -1,5 +1,5 @@
 import { Collection, type CollectionId, type CollectionSnapshot, type ReadViewOptions } from "../../collection/index.js";
-import type { ITransactor, ActionId } from "../../index.js";
+import type { ITransactor, ActionId, WriteDurability } from "../../index.js";
 import { type Path, type KeyRange } from "../../btree/index.js";
 import { type TreeReplaceAction } from "./struct.js";
 /**
@@ -52,7 +52,17 @@ export declare class Tree<TKey, TEntry> implements TreeReadView<TKey, TEntry> {
      * over the collection's existing tracker. Either way the result is written back into `held` so
      * the `replace` handler's path-invalidation targets the very btree reads go through. */
     private static attach;
-    replace(data: TreeReplaceAction<TKey, TEntry>): Promise<void>;
+    /** Stage a mutation and flush it. Forwards the collection's answer verbatim — see
+     * {@link Collection.sync} for what `undefined` means and why a torn commit's `torn` list must
+     * survive the trip. This layer never interprets the value.
+     *
+     * A call that throws leaves nothing staged (see {@link Collection.actAndSync}), so the mutation
+     * cannot ride along with a later `replace`. Whether it reached STORAGE is what the error says:
+     * a `TornActionError` with `final: true` means it did not and submitting it again stores it
+     * once; `final: false` means that could not be established. A `SyncRetryExhaustedError` is not
+     * a promise either way — the write path's last budgeted attempt, and a deadline, are not
+     * followed by the refresh that would have settled it (see `Collection.syncAttempts`). */
+    replace(data: TreeReplaceAction<TKey, TEntry>): Promise<WriteDurability | undefined>;
     /** Stage a mutation into the collection's tracker WITHOUT flushing it to the
      * transactor. Reads through this same Tree instance see the staged change;
      * call {@link sync} to persist it, or {@link snapshot}/{@link restore} to drop it. This
@@ -62,7 +72,7 @@ export declare class Tree<TKey, TEntry> implements TreeReadView<TKey, TEntry> {
     stage(data: TreeReplaceAction<TKey, TEntry>): Promise<void>;
     /** Flush all staged (and any other pending) changes to the transactor.
      * Equivalent to the flush half of {@link replace}. */
-    sync(): Promise<void>;
+    sync(): Promise<WriteDurability | undefined>;
     /** Whether {@link sync} has anything to push — see
      * {@link Collection.hasUnsyncedChanges}. `false` means the commit half of
      * {@link sync} is a no-op, so a caller flushing several trees can skip the ones

package/dist/src/collections/tree/tree.d.ts.map

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

package/dist/src/collections/tree/tree.js

@@ -1,7 +1,69 @@
 import { Collection } from "../../collection/index.js";
 import { BTree } from "../../btree/index.js";
 import { CollectionTrunk } from "./collection-trunk.js";
-import { TreeHeaderBlockType, TreeKeyTakenError, TreeRangeTakenError } from "./struct.js";
+import { structuralEquals } from "../../utility/structural-equals.js";
+import { TreeHeaderBlockType, TreeDeleteGuardKindError, TreeEntryChangedError, TreeKeyTakenError, TreeRangeTakenError, } from "./struct.js";
+/**
+ * Enforce a guard carried by an UPSERT element against the CURRENT content of `actionTree` —
+ * the same Atomic store the upsert writes to, so it sees what earlier elements of this same
+ * replay already staged or deleted (an UPDATE's delete-old half runs before its guarded insert
+ * half). Throws the guard's refusal, which discards the whole action's staged writes.
+ *
+ * @returns `'skip'` when the element must be left unwritten (`keepExisting` found the key
+ * 	occupied — the INSERT OR IGNORE disposition), `'proceed'` otherwise.
+ */
+async function enforceUpsertGuard(actionTree, id, key, guard, keyFromEntry, compare) {
+    switch (guard.kind) {
+        case 'absentRange': {
+            // Secondary-UNIQUE: the claimed range (a unique index's framed value prefix) must hold
+            // no entry other than this action's own key. Two short descents (range start and end)
+            // plus an early-exit walk. The guard is plain data (it is serialized into the log with
+            // its action), and BTree.range reads the range's fields only — so a KeyRange that has
+            // round-tripped through JSON is scanned exactly like a live instance.
+            for await (const path of actionTree.range(guard.range)) {
+                const occupant = actionTree.at(path);
+                if (occupant === undefined)
+                    continue;
+                const occupantKey = keyFromEntry(occupant);
+                if (compare(occupantKey, key) === 0)
+                    continue; // self-exclusion
+                throw new TreeRangeTakenError(id, key, guard.range, occupantKey);
+            }
+            return 'proceed';
+        }
+        case 'unchanged': {
+            assertEntryUnchanged(id, key, guard.expected, actionTree.at(await actionTree.find(key)));
+            return 'proceed';
+        }
+        case 'absent':
+        case 'keepExisting': {
+            if (!(await actionTree.find(key)).on)
+                return 'proceed';
+            if (guard.kind === 'absent')
+                throw new TreeKeyTakenError(id, key);
+            // keepExisting: leave the present (rival's) entry in place and skip this element.
+            return 'skip';
+        }
+    }
+}
+/** The lost-update check shared by guarded upserts and guarded deletes: the committed entry must
+ *  be present AND structurally equal to what the staged write read. Absence counts as changed —
+ *  see {@link TreeUnchangedGuard} for why that is the contract on both dispositions. */
+function assertEntryUnchanged(id, key, expected, actual) {
+    if (actual === undefined || !structuralEquals(actual, expected)) {
+        throw new TreeEntryChangedError(id, key, expected, actual);
+    }
+}
+/** Narrow a DELETE element's guard to the only kind a delete can act on. The element type already
+ *  says this ({@link TreeDeleteElement}), but a replayed log entry is deserialized data that no
+ *  type policed, so the handler re-checks it and throws {@link TreeDeleteGuardKindError} rather
+ *  than silently ignoring a guard the writer believed was being enforced. */
+function deleteGuardExpected(id, key, guard) {
+    if (guard.kind !== 'unchanged') {
+        throw new TreeDeleteGuardKindError(id, key, guard.kind);
+    }
+    return guard.expected;
+}
 export class Tree {
     collection;
     btree;
@@ -59,48 +121,43 @@ export class Tree {
                     // public constructor; no btree API change needed.
                     const actionTree = new BTree(trx, new CollectionTrunk(trx, id), keyFromEntry, compare, nodeCapacity);
                     for (const [key, entry, guard] of actions) {
+                        // NOTE: an element is a DELETE when its entry slot is falsy, not when it is
+                        // strictly `undefined`. That is deliberate and load-bearing: JSON encodes the
+                        // empty slot of `[key, undefined]` as `null`, so a replayed log entry arrives
+                        // as `[key, null]` and a `!== undefined` test would upsert `null` over the row.
+                        // JSON really is the live encoding, not just a hypothetical: the p2p repo
+                        // protocol stringifies and parses every message (`protocol-client.ts` and
+                        // `repo/service.ts` in `packages/db-p2p/src/`). The in-process test transactors
+                        // use `structuredClone`, which preserves `undefined` — so no test that goes
+                        // only through them can reach this shape; the round-trip spec below stages the
+                        // JSON shape explicitly for that reason.
+                        // The cost is that a falsy-but-real entry (`''`, `0`, `false`) reads as a
+                        // delete. No entry type in this repo is falsy today (rows encode to a non-empty
+                        // string or Uint8Array; index entries are arrays); if one ever is, this needs an
+                        // explicit delete marker in the tuple rather than a tighter comparison.
                         if (entry) {
                             // Enforce the entry's guard (if any) on EVERY handler run — initial staging
-                            // and every conflict replay — so the uniqueness decision is re-made against
-                            // the newest adopted committed state, not just the stage-time snapshot.
-                            // A throw here discards the whole action's staged writes (Atomic wrapper).
-                            if (guard !== undefined) {
-                                if (guard.kind === 'absentRange') {
-                                    // Secondary-UNIQUE: the claimed range (a unique index's framed
-                                    // value prefix) must hold no entry other than this action's own
-                                    // key. Two short descents (range start and end) plus an early-exit
-                                    // walk, over the SAME store the upsert below writes to, so it sees entries earlier
-                                    // actions of this replay already staged or deleted (an UPDATE's
-                                    // delete-old half runs before its guarded insert half). The guard
-                                    // is plain data (it is serialized into the log with its action), and
-                                    // BTree.range reads the range's fields only — so a KeyRange that has
-                                    // round-tripped through JSON is scanned exactly like a live instance.
-                                    for await (const path of actionTree.range(guard.range)) {
-                                        const occupant = actionTree.at(path);
-                                        if (occupant === undefined)
-                                            continue;
-                                        const occupantKey = keyFromEntry(occupant);
-                                        if (compare(occupantKey, key) === 0)
-                                            continue; // self-exclusion
-                                        throw new TreeRangeTakenError(id, key, guard.range, occupantKey);
-                                    }
-                                }
-                                else {
-                                    const found = await actionTree.find(key);
-                                    if (found.on) {
-                                        if (guard.kind === 'absent') {
-                                            throw new TreeKeyTakenError(id, key);
-                                        }
-                                        // keepExisting: leave the present (rival's) entry in place and
-                                        // skip this entry silently — the INSERT OR IGNORE disposition.
-                                        continue;
-                                    }
-                                }
+                            // and every conflict replay — so the decision is re-made against the newest
+                            // adopted committed state, not just the stage-time snapshot. A throw here
+                            // discards the whole action's staged writes (Atomic wrapper).
+                            // Truthiness, not `!== undefined`, for the same round-trip reason as the entry
+                            // slot above: an explicitly-passed `undefined` guard (the shape every unguarded
+                            // index write stages) comes back from JSON as `null`, and reading `.kind` off it
+                            // would throw a TypeError mid-replay instead of meaning "no guard".
+                            if (guard
+                                && await enforceUpsertGuard(actionTree, id, key, guard, keyFromEntry, compare) === 'skip') {
+                                continue;
                             }
                             await actionTree.upsert(entry);
                         }
                         else {
-                            await actionTree.deleteAt((await actionTree.find(key)));
+                            // The path is found once and reused: the guard check reads it and `deleteAt`
+                            // consumes it, with no mutation in between to invalidate it.
+                            const path = await actionTree.find(key);
+                            if (guard) {
+                                assertEntryUnchanged(id, key, deleteGuardExpected(id, key, guard), actionTree.at(path));
+                            }
+                            await actionTree.deleteAt(path);
                         }
                     }
                     // Mutations landed in `trx`, not the read btree, so its version counter never moved.
@@ -133,9 +190,18 @@ export class Tree {
             ?? new BTree(collection.tracker, new CollectionTrunk(collection.tracker, collection.id), keyFromEntry, compare, nodeCapacity);
         return new Tree(collection, held.btree, keyFromEntry, compare);
     }
+    /** Stage a mutation and flush it. Forwards the collection's answer verbatim — see
+     * {@link Collection.sync} for what `undefined` means and why a torn commit's `torn` list must
+     * survive the trip. This layer never interprets the value.
+     *
+     * A call that throws leaves nothing staged (see {@link Collection.actAndSync}), so the mutation
+     * cannot ride along with a later `replace`. Whether it reached STORAGE is what the error says:
+     * a `TornActionError` with `final: true` means it did not and submitting it again stores it
+     * once; `final: false` means that could not be established. A `SyncRetryExhaustedError` is not
+     * a promise either way — the write path's last budgeted attempt, and a deadline, are not
+     * followed by the refresh that would have settled it (see `Collection.syncAttempts`). */
     async replace(data) {
-        await this.collection.act({ type: "replace", data });
-        await this.collection.updateAndSync();
+        return await this.collection.actAndSync([{ type: "replace", data }]);
     }
     /** Stage a mutation into the collection's tracker WITHOUT flushing it to the
      * transactor. Reads through this same Tree instance see the staged change;
@@ -149,7 +215,7 @@ export class Tree {
     /** Flush all staged (and any other pending) changes to the transactor.
      * Equivalent to the flush half of {@link replace}. */
     async sync() {
-        await this.collection.updateAndSync();
+        return await this.collection.updateAndSync();
     }
     /** Whether {@link sync} has anything to push — see
      * {@link Collection.hasUnsyncedChanges}. `false` means the commit half of

package/dist/src/collections/tree/tree.js.map

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

package/dist/src/index.d.ts

@@ -18,9 +18,9 @@ export * from "./utility/groupby.js";
 export * from "./utility/hash-string.js";
 export * from "./utility/latches.js";
 export * from "./utility/nameof.js";
+export * from "./utility/structural-equals.js";
 export * from "./utility/ensured.js";
 export * from "./utility/pending.js";
-export * from "./utility/block-id-to-bytes.js";
 export * from "./utility/lru-map.js";
 export * from "./utility/backoff.js";
 //# sourceMappingURL=index.d.ts.map