@rocicorp/zero 0.25.0 → 0.26.0-canary.0

package/out/zero-client/src/client/zero-poke-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-poke-handler.js","sources":["../../../../../zero-client/src/client/zero-poke-handler.ts"],"sourcesContent":["import {Lock} from '@rocicorp/lock';\nimport type {LogContext} from '@rocicorp/logger';\nimport type {\n  PatchOperationInternal,\n  PokeInternal,\n} from '../../../replicache/src/impl.ts';\nimport type {PatchOperation} from '../../../replicache/src/patch-operation.ts';\nimport type {ClientID} from '../../../replicache/src/sync/ids.ts';\nimport {unreachable} from '../../../shared/src/asserts.ts';\nimport {getBrowserGlobalMethod} from '../../../shared/src/browser-env.ts';\nimport type {JSONValue} from '../../../shared/src/json.ts';\nimport type {MutationPatch} from '../../../zero-protocol/src/mutations-patch.ts';\nimport type {\n  PokeEndBody,\n  PokePartBody,\n  PokeStartBody,\n} from '../../../zero-protocol/src/poke.ts';\nimport type {QueriesPatchOp} from '../../../zero-protocol/src/queries-patch.ts';\nimport type {RowPatchOp} from '../../../zero-protocol/src/row-patch.ts';\nimport {\n  serverToClient,\n  type NameMapper,\n} from '../../../zero-schema/src/name-mapper.ts';\nimport type {Schema} from '../../../zero-types/src/schema.ts';\nimport {\n  toDesiredQueriesKey,\n  toGotQueriesKey,\n  toMutationResponseKey,\n  toPrimaryKeyString,\n} from './keys.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\n\ntype PokeAccumulator = {\n  readonly pokeStart: PokeStartBody;\n  readonly parts: PokePartBody[];\n  readonly pokeEnd: PokeEndBody;\n};\n\n/**\n * Handles the multi-part format of zero pokes.\n * As an optimization it also debounces pokes, only poking Replicache with a\n * merged poke at most once per frame (as determined by requestAnimationFrame).\n * The client cannot control how fast the server sends pokes, and it can only\n * update the UI once per frame. This debouncing avoids wastefully\n * computing separate diffs and IVM updates for intermediate states that will\n * never been displayed to the UI.\n */\nexport class PokeHandler {\n  readonly #replicachePoke: (poke: PokeInternal) => Promise<void>;\n  readonly #onPokeError: () => void;\n  readonly #clientID: ClientID;\n  readonly #lc: LogContext;\n  #receivingPoke: Omit<PokeAccumulator, 'pokeEnd'> | undefined = undefined;\n  readonly #pokeBuffer: PokeAccumulator[] = [];\n  #pokePlaybackLoopRunning = false;\n  #lastRafPerfTimestamp = 0;\n  // Serializes calls to this.#replicachePoke otherwise we can cause out of\n  // order poke errors.\n  readonly #pokeLock = new Lock();\n  readonly #schema: Schema;\n  readonly #serverToClient: NameMapper;\n  readonly #mutationTracker: MutationTracker;\n\n  readonly #raf =\n    getBrowserGlobalMethod('requestAnimationFrame') ?? rafFallback;\n\n  constructor(\n    replicachePoke: (poke: PokeInternal) => Promise<void>,\n    onPokeError: () => void,\n    clientID: ClientID,\n    schema: Schema,\n    lc: LogContext,\n    mutationTracker: MutationTracker,\n  ) {\n    this.#replicachePoke = replicachePoke;\n    this.#onPokeError = onPokeError;\n    this.#clientID = clientID;\n    this.#schema = schema;\n    this.#serverToClient = serverToClient(schema.tables);\n    this.#lc = lc.withContext('PokeHandler');\n    this.#mutationTracker = mutationTracker;\n  }\n\n  handlePokeStart(pokeStart: PokeStartBody) {\n    if (this.#receivingPoke) {\n      this.#handlePokeError(\n        `pokeStart ${JSON.stringify(\n          pokeStart,\n        )} while still receiving  ${JSON.stringify(\n          this.#receivingPoke.pokeStart,\n        )} `,\n      );\n      return;\n    }\n    this.#receivingPoke = {\n      pokeStart,\n      parts: [],\n    };\n  }\n\n  handlePokePart(pokePart: PokePartBody): number | undefined {\n    if (pokePart.pokeID !== this.#receivingPoke?.pokeStart.pokeID) {\n      this.#handlePokeError(\n        `pokePart for ${pokePart.pokeID}, when receiving ${\n          this.#receivingPoke?.pokeStart.pokeID\n        }`,\n      );\n      return;\n    }\n    this.#receivingPoke.parts.push(pokePart);\n    return pokePart.lastMutationIDChanges?.[this.#clientID];\n  }\n\n  handlePokeEnd(pokeEnd: PokeEndBody): void {\n    if (pokeEnd.pokeID !== this.#receivingPoke?.pokeStart.pokeID) {\n      this.#handlePokeError(\n        `pokeEnd for ${pokeEnd.pokeID}, when receiving ${\n          this.#receivingPoke?.pokeStart.pokeID\n        }`,\n      );\n      return;\n    }\n    if (pokeEnd.cancel) {\n      this.#receivingPoke = undefined;\n      return;\n    }\n    this.#pokeBuffer.push({...this.#receivingPoke, pokeEnd});\n    this.#receivingPoke = undefined;\n    if (!this.#pokePlaybackLoopRunning) {\n      this.#startPlaybackLoop();\n    }\n  }\n\n  handleDisconnect(): void {\n    this.#lc.debug?.('clearing due to disconnect');\n    this.#clear();\n  }\n\n  #startPlaybackLoop() {\n    this.#lc.debug?.('starting playback loop');\n    this.#pokePlaybackLoopRunning = true;\n    this.#raf(this.#rafCallback);\n  }\n\n  #rafCallback = async () => {\n    const rafLC = this.#lc.withContext('rafAt', Math.floor(performance.now()));\n    if (this.#pokeBuffer.length === 0) {\n      rafLC.debug?.('stopping playback loop');\n      this.#pokePlaybackLoopRunning = false;\n      return;\n    }\n    this.#raf(this.#rafCallback);\n    const start = performance.now();\n    rafLC.debug?.(\n      'raf fired, processing pokes.  Since last raf',\n      start - this.#lastRafPerfTimestamp,\n    );\n    this.#lastRafPerfTimestamp = start;\n    await this.#processPokesForFrame(rafLC);\n    rafLC.debug?.('processing pokes took', performance.now() - start);\n  };\n\n  #processPokesForFrame(lc: LogContext): Promise<void> {\n    return this.#pokeLock.withLock(async () => {\n      const now = Date.now();\n      lc.debug?.('got poke lock at', now);\n      lc.debug?.('merging', this.#pokeBuffer.length);\n      try {\n        const merged = mergePokes(\n          this.#pokeBuffer,\n          this.#schema,\n          this.#serverToClient,\n        );\n        this.#pokeBuffer.length = 0;\n        if (merged === undefined) {\n          lc.debug?.('frame is empty');\n          return;\n        }\n        const start = performance.now();\n        lc.debug?.('poking replicache');\n        await this.#replicachePoke(merged);\n        lc.debug?.('poking replicache took', performance.now() - start);\n\n        if (!('error' in merged.pullResponse)) {\n          const lmid =\n            merged.pullResponse.lastMutationIDChanges[this.#clientID];\n          if (lmid !== undefined) {\n            this.#mutationTracker.lmidAdvanced(lmid);\n          }\n        }\n      } catch (e) {\n        this.#handlePokeError(e);\n      }\n    });\n  }\n\n  #handlePokeError(e: unknown) {\n    if (String(e).includes('unexpected base cookie for poke')) {\n      // This can happen if cookie changes due to refresh from idb due\n      // to an update arriving to different tabs in the same\n      // client group at very different times.  Unusual but possible.\n      this.#lc.debug?.('clearing due to', e);\n    } else {\n      this.#lc.error?.('clearing due to unexpected poke error', e);\n    }\n    this.#clear();\n    this.#onPokeError();\n  }\n\n  #clear() {\n    this.#receivingPoke = undefined;\n    this.#pokeBuffer.length = 0;\n  }\n}\n\nexport function mergePokes(\n  pokeBuffer: PokeAccumulator[],\n  schema: Schema,\n  serverToClient: NameMapper,\n):\n  | (PokeInternal & {mutationResults?: MutationPatch[] | undefined})\n  | undefined {\n  if (pokeBuffer.length === 0) {\n    return undefined;\n  }\n  const {baseCookie} = pokeBuffer[0].pokeStart;\n  const lastPoke = pokeBuffer[pokeBuffer.length - 1];\n  const {cookie} = lastPoke.pokeEnd;\n  const mergedPatch: PatchOperationInternal[] = [];\n  const mergedLastMutationIDChanges: Record<string, number> = {};\n  const mutationResults: MutationPatch[] = [];\n\n  let prevPokeEnd = undefined;\n  for (const pokeAccumulator of pokeBuffer) {\n    if (\n      prevPokeEnd &&\n      pokeAccumulator.pokeStart.baseCookie &&\n      pokeAccumulator.pokeStart.baseCookie > prevPokeEnd.cookie\n    ) {\n      throw Error(\n        `unexpected cookie gap ${JSON.stringify(prevPokeEnd)} ${JSON.stringify(\n          pokeAccumulator.pokeStart,\n        )}`,\n      );\n    }\n    prevPokeEnd = pokeAccumulator.pokeEnd;\n    for (const pokePart of pokeAccumulator.parts) {\n      if (pokePart.lastMutationIDChanges) {\n        for (const [clientID, lastMutationID] of Object.entries(\n          pokePart.lastMutationIDChanges,\n        )) {\n          mergedLastMutationIDChanges[clientID] = lastMutationID;\n        }\n      }\n      if (pokePart.desiredQueriesPatches) {\n        for (const [clientID, queriesPatch] of Object.entries(\n          pokePart.desiredQueriesPatches,\n        )) {\n          for (const op of queriesPatch) {\n            mergedPatch.push(\n              queryPatchOpToReplicachePatchOp(op, hash =>\n                toDesiredQueriesKey(clientID, hash),\n              ),\n            );\n          }\n        }\n      }\n      if (pokePart.gotQueriesPatch) {\n        for (const op of pokePart.gotQueriesPatch) {\n          mergedPatch.push(\n            queryPatchOpToReplicachePatchOp(op, toGotQueriesKey),\n          );\n        }\n      }\n      if (pokePart.rowsPatch) {\n        for (const p of pokePart.rowsPatch) {\n          mergedPatch.push(\n            rowsPatchOpToReplicachePatchOp(p, schema, serverToClient),\n          );\n        }\n      }\n      if (pokePart.mutationsPatch) {\n        for (const op of pokePart.mutationsPatch) {\n          mergedPatch.push(mutationPatchOpToReplicachePatchOp(op));\n        }\n      }\n    }\n  }\n  const ret: PokeInternal & {mutationResults?: MutationPatch[] | undefined} = {\n    baseCookie,\n    pullResponse: {\n      lastMutationIDChanges: mergedLastMutationIDChanges,\n      patch: mergedPatch,\n      cookie,\n    },\n  };\n\n  // For backwards compatibility. Because we're strict on our validation,\n  // zero-client must be able to parse pokes with this field before we introduce it.\n  // So users can update their clients and then start using custom mutators that write responses to the db.\n  if (mutationResults.length > 0) {\n    ret.mutationResults = mutationResults;\n  }\n  return ret;\n}\n\nfunction queryPatchOpToReplicachePatchOp(\n  op: QueriesPatchOp,\n  toKey: (hash: string) => string,\n): PatchOperation {\n  switch (op.op) {\n    case 'clear':\n      return op;\n    case 'del':\n      return {\n        op: 'del',\n        key: toKey(op.hash),\n      };\n    case 'put':\n      return {\n        op: 'put',\n        key: toKey(op.hash),\n        value: null,\n      };\n    default:\n      unreachable(op);\n  }\n}\n\nexport function mutationPatchOpToReplicachePatchOp(\n  op: MutationPatch,\n): PatchOperationInternal {\n  switch (op.op) {\n    case 'put':\n      return {\n        op: 'put',\n        key: toMutationResponseKey(op.mutation.id),\n        value: op.mutation.result,\n      };\n    case 'del':\n      return {\n        op: 'del',\n        key: toMutationResponseKey(op.id),\n      };\n  }\n}\n\nfunction rowsPatchOpToReplicachePatchOp(\n  op: RowPatchOp,\n  schema: Schema,\n  serverToClient: NameMapper,\n): PatchOperationInternal {\n  if (op.op === 'clear') {\n    return op;\n  }\n  const tableName = serverToClient.tableName(op.tableName, op as JSONValue);\n  switch (op.op) {\n    case 'del':\n      return {\n        op: 'del',\n        key: toPrimaryKeyString(\n          tableName,\n          schema.tables[tableName].primaryKey,\n          serverToClient.row(op.tableName, op.id),\n        ),\n      };\n    case 'put':\n      return {\n        op: 'put',\n        key: toPrimaryKeyString(\n          tableName,\n          schema.tables[tableName].primaryKey,\n          serverToClient.row(op.tableName, op.value),\n        ),\n        value: serverToClient.row(op.tableName, op.value),\n      };\n    case 'update':\n      return {\n        op: 'update',\n        key: toPrimaryKeyString(\n          tableName,\n          schema.tables[tableName].primaryKey,\n          serverToClient.row(op.tableName, op.id),\n        ),\n        merge: op.merge\n          ? serverToClient.row(op.tableName, op.merge)\n          : undefined,\n        constrain: serverToClient.columns(op.tableName, op.constrain),\n      };\n    default:\n      unreachable(op);\n  }\n}\n\n/**\n * Some environments we run in don't have `requestAnimationFrame` (such as\n * Node, Cloudflare Workers).\n */\nfunction rafFallback(callback: () => void): void {\n  setTimeout(callback, 0);\n}\n"],"names":["serverToClient"],"mappings":"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"}

package/out/zero-client/src/client/zero-rep.d.ts

@@ -1,15 +1,16 @@
 import type { InternalDiff } from '../../../replicache/src/btree/node.ts';
+import type { LazyStore } from '../../../replicache/src/dag/lazy-store.ts';
 import type { Hash } from '../../../replicache/src/hash.ts';
+import type { EphemeralID, MutationTrackingData, ZeroOption, ZeroReadOptions } from '../../../replicache/src/replicache-options.ts';
 import type { ZeroContext } from './context.ts';
 import type { IVMSourceBranch } from './ivm-branch.ts';
-import type { LazyStore } from '../../../replicache/src/dag/lazy-store.ts';
-import type { EphemeralID, MutationTrackingData, ZeroOption, ZeroReadOptions } from '../../../replicache/src/replicache-options.ts';
 import type { MutationTracker } from './mutation-tracker.ts';
 export declare const toReplicacheAuthToken: (auth: string | undefined | null) => string;
 export declare const fromReplicacheAuthToken: (auth: string) => string | undefined;
 type TxData = {
     ivmSources: IVMSourceBranch;
     token: string | undefined;
+    context: unknown;
 };
 export declare class ZeroRep implements ZeroOption {
     #private;

package/out/zero-client/src/client/zero-rep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zero-rep.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/zero-rep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,uCAAuC,CAAC;AAE/C,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,iCAAiC,CAAC;AAE1D,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAGrD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,2CAA2C,CAAC;AACzE,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,eAAe,EAChB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAK3D,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,KAC9B,MAA0C,CAAC;AAE9C,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SACtC,CAAC;AAE3B,KAAK,MAAM,GAAG;IACZ,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF,qBAAa,OAAQ,YAAW,UAAU;;gBAUtC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,eAAe,EACxB,qBAAqB,EAAE,OAAO,EAC9B,eAAe,EAAE,eAAe;IAQlC,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,EAEpB;IAEK,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS;IAoBvC,SAAS,GACP,aAAa,IAAI,EACjB,cAAc,eAAe,KAC5B,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAc5B;IAEF,OAAO,GAAI,cAAc,IAAI,EAAE,SAAS,IAAI,EAAE,OAAO,YAAY,KAAG,IAAI,CAEtE;IAEF,aAAa,IAAI,oBAAoB;IAGrC,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAGtE,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI;CAG5D"}
+{"version":3,"file":"zero-rep.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/zero-rep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,2CAA2C,CAAC;AAGzE,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,iCAAiC,CAAC;AAC1D,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAGvD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAK3D,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,KAC9B,MAA0C,CAAC;AAE9C,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SACtC,CAAC;AAE3B,KAAK,MAAM,GAAG;IACZ,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,qBAAa,OAAQ,YAAW,UAAU;;gBAUtC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,eAAe,EACxB,qBAAqB,EAAE,OAAO,EAC9B,eAAe,EAAE,eAAe;IAQlC,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,EAEpB;IAEK,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS;IAoBvC,SAAS,GACP,aAAa,IAAI,EACjB,cAAc,eAAe,KAC5B,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAe5B;IAEF,OAAO,GAAI,cAAc,IAAI,EAAE,SAAS,IAAI,EAAE,OAAO,YAAY,KAAG,IAAI,CAEtE;IAEF,aAAa,IAAI,oBAAoB;IAGrC,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAGtE,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI;CAG5D"}

package/out/zero-client/src/client/zero-rep.js

@@ -0,0 +1,72 @@
+import { readFromHash } from "../../../replicache/src/db/read.js";
+import { Latest } from "../../../replicache/src/format-version-enum.js";
+import { withRead } from "../../../replicache/src/with-transactions.js";
+import { must } from "../../../shared/src/must.js";
+import { ENTITIES_KEY_PREFIX } from "./keys.js";
+const REPLICACHE_NO_AUTH_TOKEN = "";
+const toReplicacheAuthToken = (auth) => auth ?? REPLICACHE_NO_AUTH_TOKEN;
+const fromReplicacheAuthToken = (auth) => !auth ? void 0 : auth;
+class ZeroRep {
+  #context;
+  #ivmMain;
+  #customMutatorsEnabled;
+  #mutationTracker;
+  #store;
+  // matches replicache's auth token type
+  #auth = REPLICACHE_NO_AUTH_TOKEN;
+  constructor(context, ivmMain, customMutatorsEnabled, mutationTracker) {
+    this.#context = context;
+    this.#ivmMain = ivmMain;
+    this.#customMutatorsEnabled = customMutatorsEnabled;
+    this.#mutationTracker = mutationTracker;
+  }
+  set auth(auth) {
+    this.#auth = auth;
+  }
+  async init(hash, store) {
+    const diffs = [];
+    await withRead(store, async (dagRead) => {
+      const read = await readFromHash(hash, dagRead, Latest);
+      for await (const entry of read.map.scan(ENTITIES_KEY_PREFIX)) {
+        if (!entry[0].startsWith(ENTITIES_KEY_PREFIX)) {
+          break;
+        }
+        diffs.push({
+          op: "add",
+          key: entry[0],
+          newValue: entry[1]
+        });
+      }
+    });
+    this.#store = store;
+    this.#context.processChanges(void 0, hash, diffs);
+  }
+  getTxData = (desiredHead, readOptions) => {
+    if (!this.#customMutatorsEnabled) {
+      return;
+    }
+    return this.#ivmMain.forkToHead(must(this.#store), desiredHead, readOptions).then((branch) => ({
+      ivmSources: branch,
+      token: fromReplicacheAuthToken(this.#auth),
+      context: this.#context
+    }));
+  };
+  advance = (expectedHash, newHash, diffs) => {
+    this.#context.processChanges(expectedHash, newHash, diffs);
+  };
+  trackMutation() {
+    return this.#mutationTracker.trackMutation();
+  }
+  mutationIDAssigned(ephemeralID, mutationID) {
+    this.#mutationTracker.mutationIDAssigned(ephemeralID, mutationID);
+  }
+  rejectMutation(ephemeralID, ex) {
+    this.#mutationTracker.rejectMutation(ephemeralID, ex);
+  }
+}
+export {
+  ZeroRep,
+  fromReplicacheAuthToken,
+  toReplicacheAuthToken
+};
+//# sourceMappingURL=zero-rep.js.map

package/out/zero-client/src/client/zero-rep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-rep.js","sources":["../../../../../zero-client/src/client/zero-rep.ts"],"sourcesContent":["import type {\n  InternalDiff,\n  InternalDiffOperation,\n} from '../../../replicache/src/btree/node.ts';\nimport type {LazyStore} from '../../../replicache/src/dag/lazy-store.ts';\nimport {readFromHash} from '../../../replicache/src/db/read.ts';\nimport * as FormatVersion from '../../../replicache/src/format-version-enum.ts';\nimport type {Hash} from '../../../replicache/src/hash.ts';\nimport type {\n  EphemeralID,\n  MutationTrackingData,\n  ZeroOption,\n  ZeroReadOptions,\n} from '../../../replicache/src/replicache-options.ts';\nimport {withRead} from '../../../replicache/src/with-transactions.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport type {ZeroContext} from './context.ts';\nimport type {IVMSourceBranch} from './ivm-branch.ts';\nimport {ENTITIES_KEY_PREFIX} from './keys.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\n\n// Replicache doesn't support undefined auth tokens\nconst REPLICACHE_NO_AUTH_TOKEN = '';\n\nexport const toReplicacheAuthToken = (\n  auth: string | undefined | null,\n): string => auth ?? REPLICACHE_NO_AUTH_TOKEN;\n\nexport const fromReplicacheAuthToken = (auth: string): string | undefined =>\n  !auth ? undefined : auth;\n\ntype TxData = {\n  ivmSources: IVMSourceBranch;\n  token: string | undefined;\n  context: unknown;\n};\n\nexport class ZeroRep implements ZeroOption {\n  readonly #context: ZeroContext;\n  readonly #ivmMain: IVMSourceBranch;\n  readonly #customMutatorsEnabled: boolean;\n  readonly #mutationTracker: MutationTracker;\n  #store: LazyStore | undefined;\n  // matches replicache's auth token type\n  #auth: string = REPLICACHE_NO_AUTH_TOKEN;\n\n  constructor(\n    context: ZeroContext,\n    ivmMain: IVMSourceBranch,\n    customMutatorsEnabled: boolean,\n    mutationTracker: MutationTracker,\n  ) {\n    this.#context = context;\n    this.#ivmMain = ivmMain;\n    this.#customMutatorsEnabled = customMutatorsEnabled;\n    this.#mutationTracker = mutationTracker;\n  }\n\n  set auth(auth: string) {\n    this.#auth = auth;\n  }\n\n  async init(hash: Hash, store: LazyStore) {\n    const diffs: InternalDiffOperation[] = [];\n    await withRead(store, async dagRead => {\n      const read = await readFromHash(hash, dagRead, FormatVersion.Latest);\n      for await (const entry of read.map.scan(ENTITIES_KEY_PREFIX)) {\n        if (!entry[0].startsWith(ENTITIES_KEY_PREFIX)) {\n          break;\n        }\n        diffs.push({\n          op: 'add',\n          key: entry[0],\n          newValue: entry[1],\n        });\n      }\n    });\n    this.#store = store;\n\n    this.#context.processChanges(undefined, hash, diffs);\n  }\n\n  getTxData = (\n    desiredHead: Hash,\n    readOptions?: ZeroReadOptions,\n  ): Promise<TxData> | undefined => {\n    // getTxData requires some extensive testing for complete confidence\n    // that it will not break. Do not enable `getTxData` unless the user\n    // has opted into custom mutators.\n    if (!this.#customMutatorsEnabled) {\n      return;\n    }\n\n    return this.#ivmMain\n      .forkToHead(must(this.#store), desiredHead, readOptions)\n      .then(branch => ({\n        ivmSources: branch,\n        token: fromReplicacheAuthToken(this.#auth),\n        context: this.#context,\n      }));\n  };\n\n  advance = (expectedHash: Hash, newHash: Hash, diffs: InternalDiff): void => {\n    this.#context.processChanges(expectedHash, newHash, diffs);\n  };\n\n  trackMutation(): MutationTrackingData {\n    return this.#mutationTracker.trackMutation();\n  }\n  mutationIDAssigned(ephemeralID: EphemeralID, mutationID: number): void {\n    this.#mutationTracker.mutationIDAssigned(ephemeralID, mutationID);\n  }\n  rejectMutation(ephemeralID: EphemeralID, ex: unknown): void {\n    this.#mutationTracker.rejectMutation(ephemeralID, ex);\n  }\n}\n"],"names":["FormatVersion.Latest"],"mappings":";;;;;AAsBA,MAAM,2BAA2B;AAE1B,MAAM,wBAAwB,CACnC,SACW,QAAQ;AAEd,MAAM,0BAA0B,CAAC,SACtC,CAAC,OAAO,SAAY;AAQf,MAAM,QAA8B;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACT;AAAA;AAAA,EAEA,QAAgB;AAAA,EAEhB,YACE,SACA,SACA,uBACA,iBACA;AACA,SAAK,WAAW;AAChB,SAAK,WAAW;AAChB,SAAK,yBAAyB;AAC9B,SAAK,mBAAmB;AAAA,EAC1B;AAAA,EAEA,IAAI,KAAK,MAAc;AACrB,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,MAAM,KAAK,MAAY,OAAkB;AACvC,UAAM,QAAiC,CAAA;AACvC,UAAM,SAAS,OAAO,OAAM,YAAW;AACrC,YAAM,OAAO,MAAM,aAAa,MAAM,SAASA,MAAoB;AACnE,uBAAiB,SAAS,KAAK,IAAI,KAAK,mBAAmB,GAAG;AAC5D,YAAI,CAAC,MAAM,CAAC,EAAE,WAAW,mBAAmB,GAAG;AAC7C;AAAA,QACF;AACA,cAAM,KAAK;AAAA,UACT,IAAI;AAAA,UACJ,KAAK,MAAM,CAAC;AAAA,UACZ,UAAU,MAAM,CAAC;AAAA,QAAA,CAClB;AAAA,MACH;AAAA,IACF,CAAC;AACD,SAAK,SAAS;AAEd,SAAK,SAAS,eAAe,QAAW,MAAM,KAAK;AAAA,EACrD;AAAA,EAEA,YAAY,CACV,aACA,gBACgC;AAIhC,QAAI,CAAC,KAAK,wBAAwB;AAChC;AAAA,IACF;AAEA,WAAO,KAAK,SACT,WAAW,KAAK,KAAK,MAAM,GAAG,aAAa,WAAW,EACtD,KAAK,CAAA,YAAW;AAAA,MACf,YAAY;AAAA,MACZ,OAAO,wBAAwB,KAAK,KAAK;AAAA,MACzC,SAAS,KAAK;AAAA,IAAA,EACd;AAAA,EACN;AAAA,EAEA,UAAU,CAAC,cAAoB,SAAe,UAA8B;AAC1E,SAAK,SAAS,eAAe,cAAc,SAAS,KAAK;AAAA,EAC3D;AAAA,EAEA,gBAAsC;AACpC,WAAO,KAAK,iBAAiB,cAAA;AAAA,EAC/B;AAAA,EACA,mBAAmB,aAA0B,YAA0B;AACrE,SAAK,iBAAiB,mBAAmB,aAAa,UAAU;AAAA,EAClE;AAAA,EACA,eAAe,aAA0B,IAAmB;AAC1D,SAAK,iBAAiB,eAAe,aAAa,EAAE;AAAA,EACtD;AACF;"}

package/out/zero-client/src/client/zero.d.ts

@@ -1,36 +1,38 @@
+import { LogContext } from '@rocicorp/logger';
 import { type Resolver } from '@rocicorp/resolver';
 import { ReplicacheImpl } from '../../../replicache/src/impl.ts';
 import type { Puller } from '../../../replicache/src/puller.ts';
 import type { Pusher } from '../../../replicache/src/pusher.ts';
 import type { ClientGroupID, ClientID } from '../../../replicache/src/sync/ids.ts';
 import type { MutatorDefs } from '../../../replicache/src/types.ts';
-import type { DeepMerge } from '../../../shared/src/deep-merge.ts';
+import type { ReadonlyJSONValue } from '../../../shared/src/json.ts';
+import { Subscribable } from '../../../shared/src/subscribable.ts';
 import { type ClientSchema } from '../../../zero-protocol/src/client-schema.ts';
 import type { DeleteClientsBody } from '../../../zero-protocol/src/delete-clients.ts';
 import type { UpQueriesPatchOp } from '../../../zero-protocol/src/queries-patch.ts';
 import type { NullableVersion } from '../../../zero-protocol/src/version.ts';
-import { type Schema } from '../../../zero-schema/src/builder/schema-builder.ts';
+import type { DefaultContext, DefaultSchema } from '../../../zero-types/src/default-types.ts';
+import type { Schema } from '../../../zero-types/src/schema.ts';
 import type { ViewFactory } from '../../../zql/src/ivm/view.ts';
+import type { MutateRequest } from '../../../zql/src/mutate/mutator.ts';
 import type { QueryDelegate } from '../../../zql/src/query/query-delegate.ts';
-import { type HumanReadable, type MaterializeOptions, type PreloadOptions, type Query, type QueryRowType, type QueryTable, type RunOptions } from '../../../zql/src/query/query.ts';
+import { type QueryOrQueryRequest } from '../../../zql/src/query/query-registry.ts';
+import { type HumanReadable, type MaterializeOptions, type PreloadOptions, type PullRow, type RunOptions } from '../../../zql/src/query/query.ts';
+import type { ConditionalSchemaQuery } from '../../../zql/src/query/schema-query.ts';
 import type { TypedView } from '../../../zql/src/query/typed-view.ts';
 import { ActiveClientsManager } from './active-clients-manager.ts';
 import { ConnectionManager } from './connection-manager.ts';
 import { type Connection } from './connection.ts';
-import { type BatchMutator, type DBMutator } from './crud.ts';
-import type { CustomMutatorDefs, MakeCustomMutatorInterfaces } from './custom.ts';
+import { type BatchMutator } from './crud.ts';
+import type { CustomMutatorDefs, MutatorResult } from './custom.ts';
 import { DeleteClientsManager } from './delete-clients-manager.ts';
 import { type HTTPString, type WSString } from './http-string.ts';
 import { Inspector } from './inspector/inspector.ts';
 import { type LogOptions } from './log-options.ts';
+import type { MakeMutatePropertyType } from './make-mutate-property.ts';
 import type { ZeroOptions } from './options.ts';
 import { QueryManager } from './query-manager.ts';
-import { ZeroLogContext } from './zero-log-context.ts';
-import { Subscribable } from '../../../shared/src/subscribable.ts';
 export type NoRelations = Record<string, never>;
-export type MakeEntityQueriesFromSchema<S extends Schema> = {
-    readonly [K in keyof S['tables'] & string]: Query<S, K>;
-};
 export type TestingContext = {
     puller: Puller;
     pusher: Pusher;
@@ -39,18 +41,17 @@ export type TestingContext = {
     connectStart: () => number | undefined;
     socketResolver: () => Resolver<WebSocket>;
     connectionManager: () => ConnectionManager;
+    queryDelegate: () => QueryDelegate;
 };
 export declare const exposedToTestingSymbol: unique symbol;
 export declare const createLogOptionsSymbol: unique symbol;
 export declare const RUN_LOOP_INTERVAL_MS = 5000;
 /**
- * How frequently we should ping the server to keep the connection alive.
+ * Default timeout for ping operations. Controls both:
+ * - How long to wait in idle before sending a ping
+ * - How long to wait for a pong response
  */
-export declare const PING_INTERVAL_MS = 5000;
-/**
- * The amount of time we wait for a pong before we consider the ping timed out.
- */
-export declare const PING_TIMEOUT_MS = 5000;
+export declare const DEFAULT_PING_TIMEOUT_MS = 5000;
 /**
  * The amount of time we wait for a pull response before we consider a pull
  * request timed out.
@@ -73,24 +74,101 @@ export interface ReplicacheInternalAPI {
     lastMutationID(): number;
 }
 export declare function getInternalReplicacheImplForTesting(z: object): ReplicacheImpl<MutatorDefs>;
-export declare class Zero<const S extends Schema, MD extends CustomMutatorDefs | undefined = undefined> {
+export type ZeroMutate<S extends Schema, MD extends CustomMutatorDefs | undefined, C> = MakeMutatePropertyType<S, MD, C> & ((mr: MutateRequest<any, S, C, any>) => MutatorResult);
+export declare class Zero<const S extends Schema = DefaultSchema, MD extends CustomMutatorDefs | undefined = undefined, C = DefaultContext> {
     #private;
     readonly version: string;
     readonly userID: string;
     readonly storageKey: string;
-    readonly queryDelegate: QueryDelegate;
-    readonly query: MakeEntityQueriesFromSchema<S>;
+    /**
+     * The timeout in milliseconds for ping operations. Controls both:
+     * - How long to wait in idle before sending a ping
+     * - How long to wait for a pong response
+     *
+     * Total time to detect a dead connection is 2 × pingTimeoutMs.
+     *
+     * The new value will take effect on the next ping cycle.
+     */
+    pingTimeoutMs: number;
+    /**
+     * Query builders for each table in the schema.
+     *
+     * @deprecated Use {@linkcode createBuilder} to create query builders instead.
+     */
+    readonly query: ConditionalSchemaQuery<S>;
     /**
      * Constructs a new Zero client.
      */
-    constructor(options: ZeroOptions<S, MD>);
-    preload(query: Query<S, keyof S['tables'] & string, any>, options?: PreloadOptions): {
+    constructor(options: ZeroOptions<S, MD, C>);
+    /**
+     * Preloads data for a query into the cache, without keeping it in memory.
+     *
+     * This function is useful when you want to populate the cache ahead of time,
+     * for example after login, to avoid a flash of loading screen on the next page.
+     *
+     * Returns an object with two properties:
+     * - `complete`: a Promise that resolves when the data is loaded
+     * - `cleanup`: a function that can be called to cancel the preload
+     *
+     * @example
+     * ```ts
+     * const {complete, cleanup} = zero.preload(userQuery);
+     * await complete;
+     * // Now the data is cached and can be used immediately
+     * ```
+     */
+    preload<TTable extends keyof S['tables'] & string, TInput extends ReadonlyJSONValue | undefined, TOutput extends ReadonlyJSONValue | undefined, TReturn extends PullRow<TTable, S>>(query: QueryOrQueryRequest<TTable, TInput, TOutput, S, TReturn, C>, options?: PreloadOptions): {
         cleanup: () => void;
         complete: Promise<void>;
     };
-    run<Q>(query: Q, runOptions?: RunOptions): Promise<HumanReadable<QueryRowType<Q>>>;
-    materialize<Q>(query: Q, options?: MaterializeOptions): TypedView<HumanReadable<QueryRowType<Q>>>;
-    materialize<T, Q>(query: Q, factory: ViewFactory<S, QueryTable<Q>, QueryRowType<Q>, T>, options?: MaterializeOptions): T;
+    /**
+     * Executes a query once and returns the results.
+     *
+     * By default, waits for any pending data to sync before running the query.
+     * This ensures fresh results from the server. Use `{type: 'unknown'}` to
+     * run immediately with whatever data is available locally.
+     *
+     * @param query - The query to execute
+     * @param runOptions - Options controlling query execution
+     * @returns A Promise resolving to the query results
+     *
+     * @example
+     * ```ts
+     * // Wait for server sync
+     * const users = await zero.run(userQuery);
+     *
+     * // Run with local data only
+     * const cachedUsers = await zero.run(userQuery, {type: 'unknown'});
+     * ```
+     */
+    run<TTable extends keyof S['tables'] & string, TInput extends ReadonlyJSONValue | undefined, TOutput extends ReadonlyJSONValue | undefined, TReturn>(query: QueryOrQueryRequest<TTable, TInput, TOutput, S, TReturn, C>, runOptions?: RunOptions): Promise<HumanReadable<TReturn>>;
+    get context(): C;
+    /**
+     * Creates a materialized view of a query that stays synchronized with the database.
+     *
+     * The materialized view automatically updates when the underlying data changes.
+     * When done with the view, call `view.destroy()` to clean up subscriptions.
+     *
+     * Optionally accepts a factory function to create a custom view implementation.
+     *
+     * @param query - The query to materialize
+     * @param factory - Optional factory function to create a custom view
+     * @param options - Options controlling view behavior
+     * @returns A TypedView that stays synchronized with the data
+     *
+     * @example
+     * ```ts
+     * // Create a standard view
+     * const view = zero.materialize(userQuery);
+     * console.log(view.data); // Current query results
+     * view.destroy(); // Clean up when done
+     *
+     * // Create a custom view
+     * const customView = zero.materialize(userQuery, (query) => new MyCustomView(query));
+     * ```
+     */
+    materialize<TTable extends keyof S['tables'] & string, TInput extends ReadonlyJSONValue | undefined, TOutput extends ReadonlyJSONValue | undefined, TReturn>(query: QueryOrQueryRequest<TTable, TInput, TOutput, S, TReturn, C>, options?: MaterializeOptions): TypedView<HumanReadable<TReturn>>;
+    materialize<T, TTable extends keyof S['tables'] & string, TInput extends ReadonlyJSONValue | undefined, TOutput extends ReadonlyJSONValue | undefined, TReturn>(query: QueryOrQueryRequest<TTable, TInput, TOutput, S, TReturn, C>, factory: ViewFactory<TTable, S, TReturn, T>, options?: MaterializeOptions): T;
     /**
      * The server URL that this Zero instance is configured with.
      */
@@ -131,13 +209,23 @@ export declare class Zero<const S extends Schema, MD extends CustomMutatorDefs |
     get clientID(): ClientID;
     get clientGroupID(): Promise<ClientGroupID>;
     /**
-     * Provides simple "CRUD" mutations for the tables in the schema.
+     * Use to execute mutations. The primary flow is to call
+     * `zero.mutate(mutationRequest)` with your registered custom mutators:
      *
-     * Each table has `create`, `set`, `update`, and `delete` methods.
+     * ```ts
+     * await zero.mutate(
+     *   mutators.myMutator({id: '1', title: 'First issue'}),
+     * );
+     * ```
+     *
+     * When `schema.enableLegacyMutators` is true, legacy conveniences are added:
+     * - Table-scoped CRUD helpers, e.g. `zero.mutate.issue.create` / `set` / `update` / `delete`
+     * - Your custom mutators exposed directly on `zero.mutate`
      *
      * ```ts
      * await zero.mutate.issue.create({id: '1', title: 'First issue', priority: 'high'});
      * await zero.mutate.comment.create({id: '1', text: 'First comment', issueID: '1'});
+     * await zero.mutate.myMutator({id: '1', title: 'First issue'});
      * ```
      *
      * The `update` methods support partials. Unspecified or `undefined` fields
@@ -148,7 +236,7 @@ export declare class Zero<const S extends Schema, MD extends CustomMutatorDefs |
      * await zero.mutate.issue.update({id: '1', title: 'Updated title'});
      * ```
      */
-    readonly mutate: MD extends CustomMutatorDefs ? S['enableLegacyMutators'] extends false ? MakeCustomMutatorInterfaces<S, MD> : DeepMerge<DBMutator<S>, MakeCustomMutatorInterfaces<S, MD>> : DBMutator<S>;
+    readonly mutate: ZeroMutate<S, MD, C>;
     /**
      * Provides a way to batch multiple CRUD mutations together:
      *
@@ -165,6 +253,8 @@ export declare class Zero<const S extends Schema, MD extends CustomMutatorDefs |
      *
      * `mutateBatch` is not allowed inside another `mutateBatch` call. Doing so
      * will throw an error.
+     *
+     * @deprecated Use `zero.mutate(mutationRequest)`
      */
     readonly mutateBatch: BatchMutator<S>;
     /**
@@ -227,9 +317,10 @@ export declare class OnlineManager extends Subscribable<boolean> {
     setOnline(online: boolean): void;
     get online(): boolean;
 }
-export declare function createSocket(rep: ReplicacheImpl, queryManager: QueryManager, deleteClientsManager: DeleteClientsManager, socketOrigin: WSString, baseCookie: NullableVersion, clientID: string, clientGroupID: string, clientSchema: ClientSchema, userID: string, auth: string | undefined, lmid: number, wsid: string, debugPerf: boolean, lc: ZeroLogContext, userPushURL: string | undefined, userQueryURL: string | undefined, additionalConnectParams: Record<string, string> | undefined, activeClientsManager: Pick<ActiveClientsManager, 'activeClients'>, maxHeaderLength?: number): Promise<[
+export declare function createSocket(rep: ReplicacheImpl, queryManager: QueryManager, deleteClientsManager: DeleteClientsManager, socketOrigin: WSString, baseCookie: NullableVersion, clientID: string, clientGroupID: string, clientSchema: ClientSchema, userID: string, auth: string | undefined, lmid: number, wsid: string, debugPerf: boolean, lc: LogContext, userPushURL: string | undefined, userQueryURL: string | undefined, additionalConnectParams: Record<string, string> | undefined, activeClientsManager: Pick<ActiveClientsManager, 'activeClients'>, maxHeaderLength?: number): Promise<[
     WebSocket,
     Map<string, UpQueriesPatchOp> | undefined,
     DeleteClientsBody | undefined
 ]>;
+export declare function createConnectionURL(socketOrigin: HTTPString | WSString, clientID: string, clientGroupID: string, userID: string, baseCookie: string | null, lmid: number, wsid: string, rep: Pick<ReplicacheImpl<{}>, 'profileID'>, debugPerf: boolean, additionalConnectParams: Record<string, string> | undefined, lc: LogContext<unknown[], unknown[], unknown[], unknown[]>): Promise<URL>;
 //# sourceMappingURL=zero.d.ts.map

package/out/zero-client/src/client/zero.d.ts.map

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