@rindle/optimistic 0.2.0 → 0.3.1

package/dist/client-id.js

@@ -37,6 +37,23 @@ let tabInstance = 0;
 export function resetTabInstanceForTests() {
     tabInstance = 0;
 }
+/** Clear the persisted client identity so the next page load starts a fresh mid/lmid stream.
+ *  Intended for dev recovery after out-of-band server state loss, not for normal operation. */
+export function resetStableClientID() {
+    try {
+        globalThis.localStorage?.removeItem(CLIENT_ID_KEY);
+    }
+    catch {
+        // Storage can throw in private modes or test shims; best-effort reset.
+    }
+    try {
+        globalThis.sessionStorage?.removeItem(TAB_ID_KEY);
+    }
+    catch {
+        // Storage can throw in private modes or test shims; best-effort reset.
+    }
+    tabInstance = 0;
+}
 /** The connection's stable clientID. A per-origin base (localStorage) keeps one logical identity
  *  across reloads; a per-tab suffix (sessionStorage) gives each tab its OWN mid/lmid stream; a
  *  per-load instance suffix keeps two clients constructed in ONE tab from sharing that stream. Falls

package/dist/client-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-id.js","sourceRoot":"","sources":["../src/client-id.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,+FAA+F;AAC/F,+FAA+F;AAC/F,+FAA+F;AAC/F,+FAA+F;AAC/F,sGAAsG;AAEtG;sBACsB;AACtB,MAAM,aAAa,GAAG,kBAAkB,CAAC;AACzC,mGAAmG;AACnG,MAAM,UAAU,GAAG,eAAe,CAAC;AAEnC;kFACkF;AAClF,SAAS,WAAW,CAAC,IAAuC,EAAE,GAAW,EAAE,IAAkB;IAC3F,IAAI,CAAC;QACH,MAAM,OAAO,GAAI,UAA6D,CAAC,IAAI,CAAC,CAAC;QACrF,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;oGAGoG;AACpG,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB;2CAC2C;AAC3C,MAAM,UAAU,wBAAwB;IACtC,WAAW,GAAG,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;sFAMsF;AACtF,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAG,WAAW,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,mDAAmD;IAC1F,+FAA+F;IAC/F,MAAM,GAAG,GACP,WAAW,CAAC,gBAAgB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChF,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,kGAAkG;IAClG,oFAAoF;IACpF,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC3D,OAAO,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"client-id.js","sourceRoot":"","sources":["../src/client-id.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,+FAA+F;AAC/F,+FAA+F;AAC/F,+FAA+F;AAC/F,+FAA+F;AAC/F,sGAAsG;AAEtG;sBACsB;AACtB,MAAM,aAAa,GAAG,kBAAkB,CAAC;AACzC,mGAAmG;AACnG,MAAM,UAAU,GAAG,eAAe,CAAC;AAEnC;kFACkF;AAClF,SAAS,WAAW,CAAC,IAAuC,EAAE,GAAW,EAAE,IAAkB;IAC3F,IAAI,CAAC;QACH,MAAM,OAAO,GAAI,UAA6D,CAAC,IAAI,CAAC,CAAC;QACrF,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;oGAGoG;AACpG,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB;2CAC2C;AAC3C,MAAM,UAAU,wBAAwB;IACtC,WAAW,GAAG,CAAC,CAAC;AAClB,CAAC;AAED;+FAC+F;AAC/F,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC;QACH,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;IACD,IAAI,CAAC;QACH,UAAU,CAAC,cAAc,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;IACD,WAAW,GAAG,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;sFAMsF;AACtF,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAG,WAAW,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,mDAAmD;IAC1F,+FAA+F;IAC/F,MAAM,GAAG,GACP,WAAW,CAAC,gBAAgB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChF,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,kGAAkG;IAClG,oFAAoF;IACpF,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC3D,OAAO,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;AAC7B,CAAC"}

package/dist/client.d.ts

@@ -43,6 +43,13 @@ export interface RindleClientOptions<S extends ColsMap, R extends ClientRegistry
         maxBatch?: number;
         retryDelayMs?: (attempt: number) => number;
     };
+    /** Development-only recovery knobs. Keep off in production: a mutation gap means state loss
+     *  or two writers sharing a clientID, and should be investigated. */
+    dev?: {
+        /** On a mutation-gap response, clear the persisted clientID and hard reload the page. This
+         *  recovers from dev DB wipes while making the reset visible to the developer. */
+        resetOnMutationGap?: boolean;
+    };
 }
 export interface RindleClient<S extends ColsMap, R extends ClientRegistry> {
     store: Store<S>;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAMxE,OAAO,KAAK,EAA2C,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAM5C,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,cAAc;IAC9E,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAClB,qFAAqF;IACrF,QAAQ,EAAE,CAAC,CAAC;IACZ,qFAAqF;IACrF,GAAG,EAAE;QACH,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7C,6EAA6E;QAC7E,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;QACnE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;KACtB,CAAC;IACF;;;;;;+FAM2F;IAC3F,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,SAAS,EAAE,SAAS,CAAA;KAAE,CAAC;IACtD;;;uBAGmB;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,CAAC;CAC3E;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,cAAc;IACvE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC9B;gFAC4E;IAC5E,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IAC1D;kFAC8E;IAC9E,UAAU,IAAI,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,cAAc,EAClF,IAAI,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CA2E7B;AAED,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAMxE,OAAO,KAAK,EAA2C,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAM5C,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,cAAc;IAC9E,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAClB,qFAAqF;IACrF,QAAQ,EAAE,CAAC,CAAC;IACZ,qFAAqF;IACrF,GAAG,EAAE;QACH,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7C,6EAA6E;QAC7E,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;QACnE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;KACtB,CAAC;IACF;;;;;;+FAM2F;IAC3F,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,SAAS,EAAE,SAAS,CAAA;KAAE,CAAC;IACtD;;;uBAGmB;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,CAAC;IAC1E;yEACqE;IACrE,GAAG,CAAC,EAAE;QACJ;0FACkF;QAClF,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,cAAc;IACvE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC9B;gFAC4E;IAC5E,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IAC1D;kFAC8E;IAC9E,UAAU,IAAI,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,cAAc,EAClF,IAAI,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAmF7B;AAED,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/client.js

@@ -10,7 +10,7 @@
 // (rejection reasons surface via `onRejected`).
 import { RemoteOptimisticSource, WsTransport, createQueuedMutationSender, } from "@rindle/remote";
 import { initWasm } from "@rindle/wasm";
-import { stableClientID } from "./client-id.js";
+import { resetStableClientID, stableClientID } from "./client-id.js";
 import { createOptimisticStore } from "./index.js";
 /** Must mirror `DEFAULT_RINDLE_API_ROUTES` in `@rindle/api-server` (the app-wire contract;
  *  duplicated so the browser bundle doesn't import the server package). */
@@ -28,9 +28,10 @@ export async function createRindleClient(opts) {
             headers: { "content-type": "application/json", ...extra },
             body: JSON.stringify(payload),
         });
+        const text = await res.text();
         if (!res.ok)
-            throw new Error(`rindle api ${path} failed: ${res.status} ${await res.text()}`);
-        return res.json();
+            throw new RindleApiHttpError(path, res.status, text);
+        return text ? JSON.parse(text) : undefined;
     };
     // Reads-leg connection: a fixed transport (tests/in-process) or a replaceable connection built
     // from `wsUrl` (eager when present, lazy when omitted). A routed lease's `wsEndpoint` migrates it.
@@ -49,8 +50,16 @@ export async function createRindleClient(opts) {
             retryDelayMs: opts.queue?.retryDelayMs,
             onRejected: opts.onRejected,
             send: async (envelopes) => {
-                const outcomes = (await post(routes.mutate, { envelopes }));
-                return outcomes.map((o) => ({ accepted: o.accepted, reason: o.reason }));
+                try {
+                    const outcomes = (await post(routes.mutate, { envelopes }));
+                    return outcomes.map((o) => ({ accepted: o.accepted, reason: o.reason }));
+                }
+                catch (err) {
+                    if (opts.dev?.resetOnMutationGap && reloadAfterMutationGap(err)) {
+                        return new Promise(() => { });
+                    }
+                    throw err;
+                }
             },
         }),
     });
@@ -78,4 +87,36 @@ export async function createRindleClient(opts) {
         },
     };
 }
+class RindleApiHttpError extends Error {
+    path;
+    status;
+    body;
+    constructor(path, status, body) {
+        super(`rindle api ${path} failed: ${status}${body ? ` ${body}` : ""}`);
+        this.name = "RindleApiHttpError";
+        this.path = path;
+        this.status = status;
+        this.body = body;
+    }
+}
+const MUTATION_GAP_RE = /\bmutation(?: id)? gap\b/i;
+function reloadAfterMutationGap(err) {
+    const text = err instanceof RindleApiHttpError
+        ? `${err.status} ${err.body} ${err.message}`
+        : String(err?.message ?? err);
+    if (!MUTATION_GAP_RE.test(text))
+        return false;
+    resetStableClientID();
+    console.error("[rindle] mutation gap detected; cleared the dev client id and reloading so this tab starts a fresh mutation stream.", err);
+    const loc = globalThis.location;
+    if (typeof loc?.reload !== "function")
+        return false;
+    try {
+        loc.reload();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -8,11 +8,11 @@ export type MutateFn<Args> = ((args: Args) => number) & {
     folded(opts: FoldOptions, args: Args): FoldHandle;
 };
 export { OptimisticBackend } from "./backend.ts";
-export type { ClientMutator, ClientRegistry, FoldClock, FoldHandle, FoldInspect, FoldOptions, KeyedRow, MutationTx, OptimisticBackendOptions, OptimisticInspect, PendingInspect, ResultType, } from "./backend.ts";
+export type { ClientMutator, ClientRegistry, FoldClock, FoldHandle, FoldInspect, FoldOptions, KeyedRow, MutationTx, OptimisticBackendOptions, OptimisticInspect, PendingInspect, QueryArg, QueryResultRow, ResultType, } from "./backend.ts";
 export type { MutationEnvelope, OptimisticSource, ProgressFrame } from "@rindle/client";
 export { createRindleClient } from "./client.ts";
 export type { RindleClient, RindleClientOptions } from "./client.ts";
-export { stableClientID } from "./client-id.ts";
+export { resetStableClientID, stableClientID } from "./client-id.ts";
 /** A {@link Store} over an {@link OptimisticBackend}, plus the named-mutator entry
  *  (`mutate.createIssue(args)` — the §9 dream shape) and the §6 lifecycle surface. */
 export declare function createOptimisticStore<S extends ColsMap, R extends ClientRegistry>(schema: Schema<S>, source: OptimisticSource, registry: R, opts: OptimisticBackendOptions): {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACL,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC9B,MAAM,cAAc,CAAC;AAEtB;;mGAEmG;AACnG,MAAM,MAAM,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,GAAG;IACtD,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC;CACnD,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EACV,aAAa,EACb,cAAc,EACd,SAAS,EACT,UAAU,EACV,WAAW,EACX,WAAW,EACX,QAAQ,EACR,UAAU,EACV,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;sFACsF;AACtF,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,cAAc,EAC/E,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,CAAC,EACX,IAAI,EAAE,wBAAwB,GAC7B;IACD,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;CAC3D,CAcA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACL,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC9B,MAAM,cAAc,CAAC;AAEtB;;mGAEmG;AACnG,MAAM,MAAM,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,GAAG;IACtD,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC;CACnD,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EACV,aAAa,EACb,cAAc,EACd,SAAS,EACT,UAAU,EACV,WAAW,EACX,WAAW,EACX,QAAQ,EACR,UAAU,EACV,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,cAAc,EACd,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErE;sFACsF;AACtF,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,cAAc,EAC/E,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,CAAC,EACX,IAAI,EAAE,wBAAwB,GAC7B;IACD,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;CAC3D,CAcA"}

package/dist/index.js

@@ -7,7 +7,7 @@ import { OptimisticBackend, } from "./backend.js";
 export { OptimisticBackend } from "./backend.js";
 // The one-call client for the daemon/serverless topology (API server + daemon ws).
 export { createRindleClient } from "./client.js";
-export { stableClientID } from "./client-id.js";
+export { resetStableClientID, stableClientID } from "./client-id.js";
 /** A {@link Store} over an {@link OptimisticBackend}, plus the named-mutator entry
  *  (`mutate.createIssue(args)` — the §9 dream shape) and the §6 lifecycle surface. */
 export function createOptimisticStore(schema, source, registry, opts) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,gFAAgF;AAChF,gFAAgF;AAChF,qFAAqF;AAErF,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EACL,iBAAiB,GAKlB,MAAM,cAAc,CAAC;AAStB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAiBjD,mFAAmF;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;sFACsF;AACtF,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,MAAwB,EACxB,QAAW,EACX,IAA8B;IAM9B,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,KAAK,CACtB,EAAE,EACF;QACE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAY,EAAE,EAAE;YACxB,MAAM,EAAE,GAAG,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAsB,CAAC;YAChF,EAAE,CAAC,MAAM,GAAG,CAAC,QAAqB,EAAE,IAAa,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YACjG,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CACmD,CAAC;IACvD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,gFAAgF;AAChF,gFAAgF;AAChF,qFAAqF;AAErF,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EACL,iBAAiB,GAKlB,MAAM,cAAc,CAAC;AAStB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAmBjD,mFAAmF;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErE;sFACsF;AACtF,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,MAAwB,EACxB,QAAW,EACX,IAA8B;IAM9B,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,KAAK,CACtB,EAAE,EACF;QACE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAY,EAAE,EAAE;YACxB,MAAM,EAAE,GAAG,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAsB,CAAC;YAChF,EAAE,CAAC,MAAM,GAAG,CAAC,QAAqB,EAAE,IAAa,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YACjG,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CACmD,CAAC;IACvD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACpC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindle/optimistic",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -25,10 +25,10 @@
     "README.md"
   ],
   "dependencies": {
-    "@rindle/client": "0.2.0",
-    "@rindle/normalized": "0.2.0",
-    "@rindle/remote": "0.2.0",
-    "@rindle/wasm": "0.2.0"
+    "@rindle/client": "0.3.1",
+    "@rindle/remote": "0.3.1",
+    "@rindle/wasm": "0.3.1",
+    "@rindle/normalized": "0.3.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",

package/src/backend.ts

@@ -42,6 +42,7 @@ import { CLIENT_MUTATIONS_SCHEMA, LMID_QUERY_NAME, localTableNames, normalizedTa
 import type {
   Ast,
   Backend,
+  BackendDevObserver,
   ChangeEvent,
   ColsMap,
   Mutation,
@@ -65,6 +66,18 @@ import { AggOverlay, type ChildOp, collectAggDefs } from "./agg-overlay.ts";
  *  against the schema at runtime, so a typo throws immediately with the valid names. */
 export type KeyedRow = Record<string, WireValue>;
 
+/** What `MutationTx.query` accepts: a query handle whose `.ast()` lowers to the wire
+ *  {@link Ast} — exactly what the typed query builder (`store.query.<table>…` or
+ *  `newQueryBuilder(schema).<table>…`) produces (203-MUTATOR-READS-DESIGN.md §9.1). Typed
+ *  structurally so the `MutationTx` surface need not carry the builder's heavy generics. */
+export type QueryArg = { ast(): Ast };
+
+/** A row returned by {@link MutationTx.query}: column name → cell, plus each materialized
+ *  relationship name → its nested row(s) — an array (a plural relationship), or a single row /
+ *  `null` (a `.one()` relationship). Recursive (nested rows share the shape). Presented
+ *  identically to a `view.data` row of the same query (203-MUTATOR-READS-DESIGN.md §5.2). */
+export type QueryResultRow = { [key: string]: WireValue | QueryResultRow | QueryResultRow[] };
+
 /** The write handle a client mutator runs against (the client `MutationTx`, §4.2):
  *  reads see the current base + this transaction's own staged writes (§4.1).
  *
@@ -84,6 +97,14 @@ export interface MutationTx {
   upsert(table: string, row: KeyedRow): void;
   /** Delete the row identified by the pk columns. A missing row is a NO-OP. */
   delete(table: string, pk: KeyedRow): void;
+  /** Run a one-shot read query (`where`/`orderBy`/`limit`/join) over the state this
+   *  mutator is mutating — it sees this transaction's own writes-so-far, the same
+   *  read-your-writes contract as `get`/`row` (§4.1; 203-MUTATOR-READS-DESIGN.md §5.2).
+   *  Synchronous; returns the matching rows in the query's order, each with its materialized
+   *  relationship children nested by name (presented identically to a `view.data` row). Pass
+   *  a query from the typed builder, e.g. `tx.query(q.issue.where("owner", "=", me))`.
+   *  Refused inside a FOLDED mutator (a reading mutator is non-absorbing, §9.1). */
+  query(query: QueryArg): QueryResultRow[];
   // --- positional (the wire shape) ---
   get(table: string, pk: WireValue[]): WireValue[] | undefined;
   add(table: string, row: WireValue[]): void;
@@ -287,6 +308,12 @@ export class OptimisticBackend<S extends ColsMap> implements Backend {
    *  pending delta `displayed = server_base ⊕ local_pending_delta` is applied from. */
   private readonly overlay = new AggOverlay();
   private handler: (qid: QueryId, ev: ChangeEvent) => void = () => {};
+  /** The Store's commit-boundary handler ({@link Backend.onCommitBoundary}), forwarded from the
+   *  local engine's `dispatch` brackets so the Store folds every affected view before notifying any
+   *  subscriber (cross-view-atomic notification). All this backend's data deltas originate from the
+   *  local engine, so its commit brackets are this backend's commit brackets. */
+  private boundaryHandler: (phase: "begin" | "end") => void = () => {};
+  private readonly devObservers = new Set<BackendDevObserver>();
 
   private pendingMutations: PendingMutation[] = [];
   private nextMid = 1;
@@ -328,6 +355,9 @@ export class OptimisticBackend<S extends ColsMap> implements Backend {
   ) {
     this.local = new WasmBackend(schema);
     this.local.onEvent((qid, ev) => this.handler(qid, ev));
+    // Forward the local engine's commit brackets up to the Store (cross-view-atomic notification):
+    // every data delta this backend emits comes from `this.local`, so its commit boundaries are ours.
+    this.local.onCommitBoundary((phase) => this.boundaryHandler(phase));
     this.colCounts = colCountsFromSchema(schema);
     this.colIndex = colIndexFromSchema(schema);
     this.sync = new NormalizedSync(pkColsFromSchema(schema), this.colCounts);
@@ -518,39 +548,65 @@ export class OptimisticBackend<S extends ColsMap> implements Backend {
     this.handler = handler;
   }
 
+  onCommitBoundary(handler: (phase: "begin" | "end") => void): void {
+    this.boundaryHandler = handler;
+  }
+
   // --- the named-mutator entry (§9) ----------------------------------------------
 
+  /** Bracket a multi-step optimistic apply as ONE notification commit (cross-view-atomic
+   *  notification — {@link Backend.onCommitBoundary}). `invoke`/`invokeFolded` apply the prediction
+   *  and then reconcile the `__agg` head in TWO `this.local` commits, but they are two halves of one
+   *  logical mutation: a relationship-`count` view and the data view it counts must update together.
+   *  The Store's `commitDepth` is a counter, so each inner commit's own `begin`/`end` nests under this
+   *  outer pair and the Store flushes every affected view (data AND count) once, together, at the
+   *  outer `end` — a subscriber re-reading a sibling view then sees post-commit data, never a torn
+   *  half. Balanced on throw (the prediction mutator may reject) via the `finally`, so a thrown
+   *  prediction never wedges the Store in deferred mode. */
+  private inOneCommit<T>(apply: () => T): T {
+    this.boundaryHandler("begin");
+    try {
+      return apply();
+    } finally {
+      this.boundaryHandler("end");
+    }
+  }
+
   /** Run the named client mutator optimistically: the prediction applies to the live
    *  engine now (affected views update synchronously), `(mid, name, args)` joins the
    *  pending stack, and the envelope ships upstream. Returns the assigned `mid`. */
   invoke(name: string, args: unknown): number {
     const mutator = this.registry[name];
     if (!mutator) throw new Error(`unknown client mutator: ${name}`);
-    // Apply the prediction FIRST. If the mutator throws (client-side validation, a bad read),
-    // the staged write is discarded (the wasm txn is a clean no-op until commit) and the throw
-    // propagates with NO mid consumed — a burnt mid is a permanent server-side gap that
-    // silently refuses every later mutation from this client (#10).
-    const touched = new Set<string>();
-    const ops: ChildOp[] = [];
-    this.local.writeWith((tx) => {
-      mutator(trackingTx(tx, touched, this.specs, this.localTables, this.opCollector(ops)), args as never);
+    // One commit boundary spans the prediction AND the `__agg`-head reconcile below, so their views
+    // (data + count) flush together rather than tearing across two engine commits.
+    return this.inOneCommit(() => {
+      // Apply the prediction FIRST. If the mutator throws (client-side validation, a bad read),
+      // the staged write is discarded (the wasm txn is a clean no-op until commit) and the throw
+      // propagates with NO mid consumed — a burnt mid is a permanent server-side gap that
+      // silently refuses every later mutation from this client (#10).
+      const touched = new Set<string>();
+      const ops: ChildOp[] = [];
+      this.local.writeWith((tx) => {
+        mutator(trackingTx(tx, touched, this.specs, this.localTables, this.opCollector(ops)), args as never);
+      });
+      // Flush-on-enqueue (§4.2): a fold whose tables overlap this write must take its mid NOW, BEFORE
+      // this write does, so wire order == local-apply order for any pair that can observe each other
+      // (a read-dependent write reading a folded cell sees the same value optimistically and on the
+      // wire — no snap). Drained folds ship with smaller mids; this write's mid is dealt after.
+      this.drainOverlapping(touched);
+      const mid = this.nextMid++;
+      this.pendingMutations.push({ mid, name, args, touched });
+      // The prediction stuck — fold its child ops into the optimistic agg delta and push it onto
+      // the `__agg` head rows (§4). No reset here (this is the §1.3 trivial case, no rewind): the
+      // delta accumulates on top of the prior pending set, and `reconcileAggHead` recomputes each
+      // touched group's head as the absolute `server_base ⊕ delta`.
+      for (const op of ops) this.overlay.observe(op);
+      this.reconcileAggHead();
+      this.refreshPending(); // §7.2: this write now touches its queries' pending axis (NOT ResultType).
+      void this.source.pushMutation({ clientID: this.clientID, mid, name, args });
+      return mid;
     });
-    // Flush-on-enqueue (§4.2): a fold whose tables overlap this write must take its mid NOW, BEFORE
-    // this write does, so wire order == local-apply order for any pair that can observe each other
-    // (a read-dependent write reading a folded cell sees the same value optimistically and on the
-    // wire — no snap). Drained folds ship with smaller mids; this write's mid is dealt after.
-    this.drainOverlapping(touched);
-    const mid = this.nextMid++;
-    this.pendingMutations.push({ mid, name, args, touched });
-    // The prediction stuck — fold its child ops into the optimistic agg delta and push it onto
-    // the `__agg` head rows (§4). No reset here (this is the §1.3 trivial case, no rewind): the
-    // delta accumulates on top of the prior pending set, and `reconcileAggHead` recomputes each
-    // touched group's head as the absolute `server_base ⊕ delta`.
-    for (const op of ops) this.overlay.observe(op);
-    this.reconcileAggHead();
-    this.refreshPending(); // §7.2: this write now touches its queries' pending axis (NOT ResultType).
-    void this.source.pushMutation({ clientID: this.clientID, mid, name, args });
-    return mid;
   }
 
   /** Run a FOLDED invoke (FOLDED-MUTATIONS-DESIGN §8): apply the prediction to the live engine now
@@ -561,64 +617,68 @@ export class OptimisticBackend<S extends ColsMap> implements Backend {
     const mutator = this.registry[name];
     if (!mutator) throw new Error(`unknown client mutator: ${name}`);
     const foldKey = `${name}\0${stableJson(opts.key)}`;
-    // Apply the prediction with the read trap armed (§5): a folded mutator that reads state to
-    // compute its write is non-absorbing and refused. A throw discards the staged write (clean
-    // no-op) and consumes no mid — exactly `invoke`'s guarantee.
-    const touched = new Set<string>();
-    const ops: ChildOp[] = [];
-    try {
-      this.local.writeWith((tx) => {
-        mutator(trackingTx(tx, touched, this.specs, this.localTables, this.opCollector(ops), true), args as never);
-      });
-    } catch (e) {
-      if (e instanceof FoldReadError) {
-        throw new Error(
-          `cannot fold "${name}": it reads state via tx.get/tx.row, so it is not absorbing — folded mutators must be last-writer-wins (FOLDED-MUTATIONS-DESIGN §5)`,
-        );
+    // One commit boundary spans the prediction AND the `__agg`-head reconcile (see {@link inOneCommit}),
+    // so a folded mutation's list view and count view flush together, never torn across two commits.
+    return this.inOneCommit(() => {
+      // Apply the prediction with the read trap armed (§5): a folded mutator that reads state to
+      // compute its write is non-absorbing and refused. A throw discards the staged write (clean
+      // no-op) and consumes no mid — exactly `invoke`'s guarantee.
+      const touched = new Set<string>();
+      const ops: ChildOp[] = [];
+      try {
+        this.local.writeWith((tx) => {
+          mutator(trackingTx(tx, touched, this.specs, this.localTables, this.opCollector(ops), true), args as never);
+        });
+      } catch (e) {
+        if (e instanceof FoldReadError) {
+          throw new Error(
+            `cannot fold "${name}": it reads state via tx.get/tx.row, so it is not absorbing — folded mutators must be last-writer-wins (FOLDED-MUTATIONS-DESIGN §5)`,
+          );
+        }
+        throw e;
       }
-      throw e;
-    }
-    for (const op of ops) this.overlay.observe(op);
-    this.reconcileAggHead();
-
-    const now = this.clock.now();
-    let f = this.folds.get(foldKey);
-    if (f) {
-      // Overwrite the single entry in place — the pending stack does NOT grow (§1 #2). The head
-      // already carries this new prediction (absorbing, last-wins on the cell); the entry holds
-      // only the LATEST args, which is what a rebase re-derives from and what the flush ships.
-      f.entry.args = args;
-      f.entry.touched = touched;
-      f.args = args;
-      this.clock.clearTimeout(f.timer);
-    } else {
-      const entry: PendingMutation = { mid: null, name, args, touched };
-      this.pendingMutations.push(entry);
-      let resolveMid!: (mid: number) => void;
-      const midPromise = new Promise<number>((res) => (resolveMid = res));
-      f = {
-        entry,
-        args,
-        timer: undefined,
-        firstAt: now,
-        debounceMs: opts.debounceMs ?? DEFAULT_FOLD_DEBOUNCE_MS,
-        maxWaitMs: opts.maxWaitMs,
-        deferAcrossWrites: opts.deferAcrossWrites ?? false,
-        midPromise,
-        resolveMid,
-      };
-      this.folds.set(foldKey, f);
-    }
-    // (Re)arm the trailing debounce — unless the maxWaitMs cap is already due (a never-idle drag
-    // still persists periodically, §3/#4), in which case flush now instead of re-arming.
-    if (f.maxWaitMs !== undefined && now - f.firstAt >= f.maxWaitMs) {
-      this.flushFold(foldKey);
-    } else {
-      f.timer = this.clock.setTimeout(() => this.flushFold(foldKey), f.debounceMs);
-    }
-    this.refreshPending();
-    const handle: FoldHandle = { flush: () => this.flushFold(foldKey), mid: f.midPromise };
-    return handle;
+      for (const op of ops) this.overlay.observe(op);
+      this.reconcileAggHead();
+
+      const now = this.clock.now();
+      let f = this.folds.get(foldKey);
+      if (f) {
+        // Overwrite the single entry in place — the pending stack does NOT grow (§1 #2). The head
+        // already carries this new prediction (absorbing, last-wins on the cell); the entry holds
+        // only the LATEST args, which is what a rebase re-derives from and what the flush ships.
+        f.entry.args = args;
+        f.entry.touched = touched;
+        f.args = args;
+        this.clock.clearTimeout(f.timer);
+      } else {
+        const entry: PendingMutation = { mid: null, name, args, touched };
+        this.pendingMutations.push(entry);
+        let resolveMid!: (mid: number) => void;
+        const midPromise = new Promise<number>((res) => (resolveMid = res));
+        f = {
+          entry,
+          args,
+          timer: undefined,
+          firstAt: now,
+          debounceMs: opts.debounceMs ?? DEFAULT_FOLD_DEBOUNCE_MS,
+          maxWaitMs: opts.maxWaitMs,
+          deferAcrossWrites: opts.deferAcrossWrites ?? false,
+          midPromise,
+          resolveMid,
+        };
+        this.folds.set(foldKey, f);
+      }
+      // (Re)arm the trailing debounce — unless the maxWaitMs cap is already due (a never-idle drag
+      // still persists periodically, §3/#4), in which case flush now instead of re-arming.
+      if (f.maxWaitMs !== undefined && now - f.firstAt >= f.maxWaitMs) {
+        this.flushFold(foldKey);
+      } else {
+        f.timer = this.clock.setTimeout(() => this.flushFold(foldKey), f.debounceMs);
+      }
+      this.refreshPending();
+      const handle: FoldHandle = { flush: () => this.flushFold(foldKey), mid: f.midPromise };
+      return handle;
+    });
   }
 
   /** Flush-on-enqueue (§4.2): for each outstanding fold whose touched tables overlap `tables`,
@@ -701,6 +761,13 @@ export class OptimisticBackend<S extends ColsMap> implements Backend {
     this.resultTypeHandler = handler;
   }
 
+  __attachDevtoolsServerDeltas(observer: BackendDevObserver): () => void {
+    this.devObservers.add(observer);
+    return () => {
+      this.devObservers.delete(observer);
+    };
+  }
+
   // --- the pending AXIS (§7.2): orthogonal to ResultType -------------------------------
 
   /** Whether any pending mutation (folded or not) touches this query's tables — "is a prediction
@@ -777,6 +844,7 @@ export class OptimisticBackend<S extends ColsMap> implements Backend {
   // --- the downstream stream (§8.5: buffer, then release coherently) ---------------
 
   private onNormalized(qid: QueryId, ev: NormalizedEvent): void {
+    if (qid !== LMID_QID) this.emitServerDelta(qid, ev);
     if (ev.type === "hello") {
       // A hello is a (re)subscribe = a NEW epoch. The column map below is mutated eagerly, but
       // data frames are cv-buffered and drained later (onProgress). So any frame still buffered
@@ -813,6 +881,21 @@ export class OptimisticBackend<S extends ColsMap> implements Backend {
     if (this.buffer.length > this.bufferCap) this.overflow();
   }
 
+  private emitServerDelta(sourceQid: QueryId, ev: NormalizedEvent): void {
+    if (!this.devObservers.size) return;
+    for (const qid of this.localQidsForSource(sourceQid)) {
+      for (const o of this.devObservers) o.onServerDelta?.(qid, { format: "normalized", event: ev });
+    }
+  }
+
+  private localQidsForSource(sourceQid: QueryId): QueryId[] {
+    const key = this.sourceToRemote.get(sourceQid);
+    const sub = key ? this.remoteSubs.get(key) : undefined;
+    if (!sub) return [sourceQid];
+    const localQids = [...sub.localQids.keys()];
+    return localQids.length ? localQids : [sourceQid];
+  }
+
   private onProgress(frame: ProgressFrame): void {
     // (1) Take every buffered frame at cv ≤ cvMin, in (cv, arrival) order, and fold it:
     // lmid system-query frames advance `confirmedLmid`; data frames fold through the
@@ -1225,8 +1308,20 @@ function trackingTx(
     throw new FoldReadError();
   };
 
+  // One-shot query (203 §5.2): lower the builder to an AST, refuse any local-only table it
+  // reads (M1 — same guard as `rawGet`), and run it over the engine's read-cache fork. The
+  // wasm engine returns the rows already keyed by column name with their materialized
+  // relationship children nested by name (`marshal::caught_node_to_js`), in the query's order —
+  // identical in shape to `view.data` — so this is a pass-through.
+  const runQuery = (q: QueryArg): QueryResultRow[] => {
+    const ast = q.ast();
+    for (const t of collectTables(ast)) assertNotLocal(t, "read");
+    return tx.query(ast) as QueryResultRow[];
+  };
+
   return {
     get: trapReads ? trapped : rawGet,
+    query: trapReads ? trapped : runQuery,
     add,
     remove,
     edit,

package/src/client-id.ts

@@ -39,6 +39,22 @@ export function resetTabInstanceForTests(): void {
   tabInstance = 0;
 }
 
+/** Clear the persisted client identity so the next page load starts a fresh mid/lmid stream.
+ *  Intended for dev recovery after out-of-band server state loss, not for normal operation. */
+export function resetStableClientID(): void {
+  try {
+    globalThis.localStorage?.removeItem(CLIENT_ID_KEY);
+  } catch {
+    // Storage can throw in private modes or test shims; best-effort reset.
+  }
+  try {
+    globalThis.sessionStorage?.removeItem(TAB_ID_KEY);
+  } catch {
+    // Storage can throw in private modes or test shims; best-effort reset.
+  }
+  tabInstance = 0;
+}
+
 /** The connection's stable clientID. A per-origin base (localStorage) keeps one logical identity
  *  across reloads; a per-tab suffix (sessionStorage) gives each tab its OWN mid/lmid stream; a
  *  per-load instance suffix keeps two clients constructed in ONE tab from sharing that stream. Falls