@rocicorp/zero 0.25.0-canary.0 → 0.25.0-canary.10

package/out/zero-client/src/client/inspector/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sources":["../../../../../../zero-client/src/client/inspector/query.ts"],"sourcesContent":["import {astToZQL} from '../../../../ast-to-zql/src/ast-to-zql.ts';\nimport type {ReadonlyJSONValue} from '../../../../shared/src/json.ts';\nimport {must} from '../../../../shared/src/must.ts';\nimport type {AnalyzeQueryResult} from '../../../../zero-protocol/src/analyze-query-result.ts';\nimport type {AST} from '../../../../zero-protocol/src/ast.ts';\nimport {\n  type InspectQueryRow,\n  inspectAnalyzeQueryDownSchema,\n} from '../../../../zero-protocol/src/inspect-down.ts';\nimport type {AnalyzeQueryOptions} from '../../../../zero-protocol/src/inspect-up.ts';\nimport {type TTL, normalizeTTL} from '../../../../zql/src/query/ttl.ts';\nimport {\n  type ExtendedInspectorDelegate,\n  type GetWebSocket,\n  type Metrics,\n  mergeMetrics,\n  rpc,\n} from './lazy-inspector.ts';\n\nexport class Query {\n  readonly #socket: GetWebSocket;\n\n  readonly name: string | null;\n  readonly args: ReadonlyArray<ReadonlyJSONValue> | null;\n  readonly got: boolean;\n  readonly ttl: TTL;\n  readonly inactivatedAt: Date | null;\n  readonly rowCount: number;\n  readonly deleted: boolean;\n  readonly id: string;\n  readonly clientID: string;\n  readonly metrics: Metrics | null;\n  readonly clientZQL: string | null;\n  readonly serverZQL: string | null;\n  readonly #serverAST: AST | null;\n\n  readonly hydrateClient: number | null;\n  readonly hydrateServer: number | null;\n  readonly hydrateTotal: number | null;\n\n  readonly updateClientP50: number | null;\n  readonly updateClientP95: number | null;\n  readonly updateServerP50: number | null;\n  readonly updateServerP95: number | null;\n\n  constructor(\n    row: InspectQueryRow,\n    delegate: ExtendedInspectorDelegate,\n    socket: GetWebSocket,\n  ) {\n    this.#socket = socket;\n\n    const {ast, queryID, inactivatedAt} = row;\n    // Use own properties to make this more useful in dev tools. For example, in\n    // Chrome dev tools, if you do console.table(queries) you'll see the\n    // properties in the table, if these were getters you would not see them in the table.\n    this.clientID = row.clientID;\n    this.id = queryID;\n    this.inactivatedAt =\n      inactivatedAt === null ? null : new Date(inactivatedAt);\n    this.ttl = normalizeTTL(row.ttl);\n    this.name = row.name;\n    this.args = row.args;\n    this.got = row.got;\n    this.rowCount = row.rowCount;\n    this.deleted = row.deleted;\n    this.#serverAST = ast;\n    this.serverZQL = ast ? ast.table + astToZQL(ast) : null;\n    const clientAST = delegate.getAST(queryID);\n    this.clientZQL = clientAST ? clientAST.table + astToZQL(clientAST) : null;\n\n    // Merge client and server metrics\n    const clientMetrics = delegate.getQueryMetrics(queryID);\n    const serverMetrics = row.metrics;\n\n    const merged = mergeMetrics(clientMetrics, serverMetrics);\n    this.metrics = merged;\n\n    const percentile = (\n      name: keyof typeof merged,\n      percentile: number,\n    ): number | null => {\n      if (!merged?.[name]) {\n        return null;\n      }\n      const n = merged[name].quantile(percentile);\n      return Number.isNaN(n) ? null : n;\n    };\n\n    // Extract hydration metrics (median values) - handle NaN by defaulting to 0\n    this.hydrateClient = percentile('query-materialization-client', 0.5);\n    this.hydrateServer = percentile('query-materialization-server', 0.5);\n    this.hydrateTotal = percentile('query-materialization-end-to-end', 0.5);\n\n    // Extract update metrics (P50 and P95) - handle NaN by defaulting to 0\n    this.updateClientP50 = percentile('query-update-client', 0.5);\n    this.updateClientP95 = percentile('query-update-client', 0.95);\n\n    this.updateServerP50 = percentile('query-update-server', 0.5);\n    this.updateServerP95 = percentile('query-update-server', 0.95);\n  }\n\n  async analyze(options?: AnalyzeQueryOptions): Promise<AnalyzeQueryResult> {\n    const details =\n      this.name && this.args\n        ? {\n            name: this.name,\n            args: this.args,\n          }\n        : {value: must(this.#serverAST, 'AST is required for unnamed queries')};\n\n    return rpc(\n      await this.#socket(),\n      {\n        op: 'analyze-query',\n        ...details,\n        options,\n      },\n      inspectAnalyzeQueryDownSchema,\n    );\n  }\n}\n"],"names":["percentile"],"mappings":";;;;;AAmBO,MAAM,MAAM;AAAA,EACR;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,YACE,KACA,UACA,QACA;AACA,SAAK,UAAU;AAEf,UAAM,EAAC,KAAK,SAAS,cAAA,IAAiB;AAItC,SAAK,WAAW,IAAI;AACpB,SAAK,KAAK;AACV,SAAK,gBACH,kBAAkB,OAAO,OAAO,IAAI,KAAK,aAAa;AACxD,SAAK,MAAM,aAAa,IAAI,GAAG;AAC/B,SAAK,OAAO,IAAI;AAChB,SAAK,OAAO,IAAI;AAChB,SAAK,MAAM,IAAI;AACf,SAAK,WAAW,IAAI;AACpB,SAAK,UAAU,IAAI;AACnB,SAAK,aAAa;AAClB,SAAK,YAAY,MAAM,IAAI,QAAQ,SAAS,GAAG,IAAI;AACnD,UAAM,YAAY,SAAS,OAAO,OAAO;AACzC,SAAK,YAAY,YAAY,UAAU,QAAQ,SAAS,SAAS,IAAI;AAGrE,UAAM,gBAAgB,SAAS,gBAAgB,OAAO;AACtD,UAAM,gBAAgB,IAAI;AAE1B,UAAM,SAAS,aAAa,eAAe,aAAa;AACxD,SAAK,UAAU;AAEf,UAAM,aAAa,CACjB,MACAA,gBACkB;AAClB,UAAI,CAAC,SAAS,IAAI,GAAG;AACnB,eAAO;AAAA,MACT;AACA,YAAM,IAAI,OAAO,IAAI,EAAE,SAASA,WAAU;AAC1C,aAAO,OAAO,MAAM,CAAC,IAAI,OAAO;AAAA,IAClC;AAGA,SAAK,gBAAgB,WAAW,gCAAgC,GAAG;AACnE,SAAK,gBAAgB,WAAW,gCAAgC,GAAG;AACnE,SAAK,eAAe,WAAW,oCAAoC,GAAG;AAGtE,SAAK,kBAAkB,WAAW,uBAAuB,GAAG;AAC5D,SAAK,kBAAkB,WAAW,uBAAuB,IAAI;AAE7D,SAAK,kBAAkB,WAAW,uBAAuB,GAAG;AAC5D,SAAK,kBAAkB,WAAW,uBAAuB,IAAI;AAAA,EAC/D;AAAA,EAEA,MAAM,QAAQ,SAA4D;AACxE,UAAM,UACJ,KAAK,QAAQ,KAAK,OACd;AAAA,MACE,MAAM,KAAK;AAAA,MACX,MAAM,KAAK;AAAA,IAAA,IAEb,EAAC,OAAO,KAAK,KAAK,YAAY,qCAAqC,EAAA;AAEzE,WAAO;AAAA,MACL,MAAM,KAAK,QAAA;AAAA,MACX;AAAA,QACE,IAAI;AAAA,QACJ,GAAG;AAAA,QACH;AAAA,MAAA;AAAA,MAEF;AAAA,IAAA;AAAA,EAEJ;AACF;"}

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

@@ -1,10 +1,10 @@
-import { MemorySource } from '../../../zql/src/ivm/memory-source.ts';
-import type { TableSchema } from '../../../zero-schema/src/table-schema.ts';
+import type { NoIndexDiff } from '../../../replicache/src/btree/node.ts';
+import type { LazyStore } from '../../../replicache/src/dag/lazy-store.ts';
 import { type Store } from '../../../replicache/src/dag/store.ts';
 import type { Hash } from '../../../replicache/src/hash.ts';
-import type { NoIndexDiff } from '../../../replicache/src/btree/node.ts';
 import type { ZeroReadOptions } from '../../../replicache/src/replicache-options.ts';
-import type { LazyStore } from '../../../replicache/src/dag/lazy-store.ts';
+import type { TableSchema } from '../../../zero-schema/src/table-schema.ts';
+import { MemorySource } from '../../../zql/src/ivm/memory-source.ts';
 /**
  * Replicache needs to rebase mutations onto different
  * commits of it's b-tree. These mutations can have reads
@@ -24,7 +24,7 @@ import type { LazyStore } from '../../../replicache/src/dag/lazy-store.ts';
 export declare class IVMSourceBranch {
     #private;
     hash: Hash | undefined;
-    constructor(tables: Record<string, TableSchema>, hash?: Hash | undefined, sources?: Map<string, MemorySource | undefined>);
+    constructor(tables: Record<string, TableSchema>, hash?: Hash, sources?: Map<string, MemorySource | undefined>);
     getSource(name: string): MemorySource | undefined;
     clear(): void;
     /**
@@ -35,7 +35,7 @@ export declare class IVMSourceBranch {
     /**
      * Fork the branch and patch it up to match the desired head.
      */
-    forkToHead(store: LazyStore, desiredHead: Hash, readOptions?: ZeroReadOptions | undefined): Promise<IVMSourceBranch>;
+    forkToHead(store: LazyStore, desiredHead: Hash, readOptions?: ZeroReadOptions): Promise<IVMSourceBranch>;
     /**
      * Creates a new IVMSourceBranch that is a copy of the current one.
      * This is a cheap operation since the b-trees are shared until a write is performed

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

@@ -1 +1 @@
-{"version":3,"file":"ivm-branch.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/ivm-branch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,uCAAuC,CAAC;AACnE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,0CAA0C,CAAC;AAE1E,OAAO,EAAY,KAAK,KAAK,EAAC,MAAM,sCAAsC,CAAC;AAE3E,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,iCAAiC,CAAC;AAO1D,OAAO,KAAK,EAGV,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAG/C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+CAA+C,CAAC;AACnF,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,2CAA2C,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;;IAG1B,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;gBAGrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,EACvB,OAAO,GAAE,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAa;IAO5D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAajD,KAAK;IAIL;;;OAGG;IACH,OAAO,CAAC,YAAY,EAAE,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW;IAWzE;;OAEG;IACG,UAAU,CACd,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,IAAI,EACjB,WAAW,CAAC,EAAE,eAAe,GAAG,SAAS,GACxC,OAAO,CAAC,eAAe,CAAC;IAY3B;;;;;;;OAOG;IACH,IAAI;CAYL;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,iBAkBb"}
+{"version":3,"file":"ivm-branch.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/ivm-branch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,2CAA2C,CAAC;AACzE,OAAO,EAAY,KAAK,KAAK,EAAC,MAAM,sCAAsC,CAAC;AAG3E,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,iCAAiC,CAAC;AAC1D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+CAA+C,CAAC;AASnF,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAC,YAAY,EAAC,MAAM,uCAAuC,CAAC;AAGnE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;;IAG1B,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;gBAGrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,IAAI,CAAC,EAAE,IAAI,EACX,OAAO,GAAE,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAa;IAO5D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAajD,KAAK;IAIL;;;OAGG;IACH,OAAO,CAAC,YAAY,EAAE,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW;IAWzE;;OAEG;IACG,UAAU,CACd,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,IAAI,EACjB,WAAW,CAAC,EAAE,eAAe,GAC5B,OAAO,CAAC,eAAe,CAAC;IAY3B;;;;;;;OAOG;IACH,IAAI;CAYL;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,iBAkBb"}

package/out/zero-client/src/client/ivm-branch.js

@@ -0,0 +1,149 @@
+import { assert } from "../../../shared/src/asserts.js";
+import "../../../shared/src/config.js";
+import "../../../replicache/src/hash.js";
+import "../../../replicache/src/btree/node.js";
+import { Latest } from "../../../replicache/src/format-version-enum.js";
+import { diffBinarySearch } from "../../../replicache/src/subscriptions.js";
+import { diff } from "../../../replicache/src/sync/diff.js";
+import { using, withRead } from "../../../replicache/src/with-transactions.js";
+import { wrapIterable } from "../../../shared/src/iterables.js";
+import { must } from "../../../shared/src/must.js";
+import { MemorySource } from "../../../zql/src/ivm/memory-source.js";
+import { ENTITIES_KEY_PREFIX, sourceNameFromKey } from "./keys.js";
+class IVMSourceBranch {
+  #sources;
+  #tables;
+  hash;
+  constructor(tables, hash, sources = /* @__PURE__ */ new Map()) {
+    this.#tables = tables;
+    this.#sources = sources;
+    this.hash = hash;
+  }
+  getSource(name) {
+    if (this.#sources.has(name)) {
+      return this.#sources.get(name);
+    }
+    const schema = this.#tables[name];
+    const source = schema ? new MemorySource(name, schema.columns, schema.primaryKey) : void 0;
+    this.#sources.set(name, source);
+    return source;
+  }
+  clear() {
+    this.#sources.clear();
+  }
+  /**
+   * Mutates the current branch, advancing it to the new head
+   * by applying the given diffs.
+   */
+  advance(expectedHead, newHead, diffs) {
+    assert(
+      this.hash === expectedHead,
+      () => `Expected head must match the main head. Got: ${this.hash}, expected: ${expectedHead}`
+    );
+    applyDiffs(diffs, this);
+    this.hash = newHead;
+  }
+  /**
+   * Fork the branch and patch it up to match the desired head.
+   */
+  async forkToHead(store, desiredHead, readOptions) {
+    const fork = this.fork();
+    if (fork.hash === desiredHead) {
+      return fork;
+    }
+    await patchBranch(desiredHead, store, fork, readOptions);
+    fork.hash = desiredHead;
+    return fork;
+  }
+  /**
+   * Creates a new IVMSourceBranch that is a copy of the current one.
+   * This is a cheap operation since the b-trees are shared until a write is performed
+   * and then only the modified nodes are copied.
+   *
+   * IVM branches are forked when we need to rebase mutations.
+   * The mutations modify the fork rather than original branch.
+   */
+  fork() {
+    return new IVMSourceBranch(
+      this.#tables,
+      this.hash,
+      new Map(
+        wrapIterable(this.#sources.entries()).map(([name, source]) => [
+          name,
+          source?.fork()
+        ])
+      )
+    );
+  }
+}
+async function patchBranch(desiredHead, store, fork, readOptions) {
+  const diffs = await computeDiffs(
+    must(fork.hash),
+    desiredHead,
+    store,
+    readOptions
+  );
+  if (!diffs) {
+    return;
+  }
+  applyDiffs(diffs, fork);
+}
+async function computeDiffs(startHash, endHash, store, readOptions) {
+  const readFn = (dagRead) => diff(
+    startHash,
+    endHash,
+    dagRead,
+    {
+      shouldComputeDiffs: () => true,
+      shouldComputeDiffsForIndex(_name) {
+        return false;
+      }
+    },
+    Latest
+  );
+  let diffs;
+  if (readOptions?.openLazySourceRead) {
+    diffs = await using(store.read(readOptions.openLazySourceRead), readFn);
+  } else if (readOptions?.openLazyRead) {
+    diffs = await readFn(readOptions.openLazyRead);
+  } else {
+    diffs = await withRead(store, readFn);
+  }
+  return diffs.get("");
+}
+function applyDiffs(diffs, branch) {
+  for (let i = diffBinarySearch(diffs, ENTITIES_KEY_PREFIX, (diff2) => diff2.key); i < diffs.length; i++) {
+    const diff2 = diffs[i];
+    const { key } = diff2;
+    if (!key.startsWith(ENTITIES_KEY_PREFIX)) {
+      break;
+    }
+    const name = sourceNameFromKey(key);
+    const source = must(branch.getSource(name));
+    switch (diff2.op) {
+      case "del":
+        source.push({
+          type: "remove",
+          row: diff2.oldValue
+        });
+        break;
+      case "add":
+        source.push({
+          type: "add",
+          row: diff2.newValue
+        });
+        break;
+      case "change":
+        source.push({
+          type: "edit",
+          row: diff2.newValue,
+          oldRow: diff2.oldValue
+        });
+        break;
+    }
+  }
+}
+export {
+  IVMSourceBranch
+};
+//# sourceMappingURL=ivm-branch.js.map

package/out/zero-client/src/client/ivm-branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ivm-branch.js","sources":["../../../../../zero-client/src/client/ivm-branch.ts"],"sourcesContent":["import type {\n  InternalDiff,\n  InternalDiffOperation,\n  NoIndexDiff,\n} from '../../../replicache/src/btree/node.ts';\nimport type {LazyStore} from '../../../replicache/src/dag/lazy-store.ts';\nimport {type Read, type Store} from '../../../replicache/src/dag/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 {ZeroReadOptions} from '../../../replicache/src/replicache-options.ts';\nimport {diffBinarySearch} from '../../../replicache/src/subscriptions.ts';\nimport type {DiffsMap} from '../../../replicache/src/sync/diff.ts';\nimport {diff} from '../../../replicache/src/sync/diff.ts';\nimport {using, withRead} from '../../../replicache/src/with-transactions.ts';\nimport {assert} from '../../../shared/src/asserts.ts';\nimport {wrapIterable} from '../../../shared/src/iterables.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport type {Row} from '../../../zero-protocol/src/data.ts';\nimport type {TableSchema} from '../../../zero-schema/src/table-schema.ts';\nimport {MemorySource} from '../../../zql/src/ivm/memory-source.ts';\nimport {ENTITIES_KEY_PREFIX, sourceNameFromKey} from './keys.ts';\n\n/**\n * Replicache needs to rebase mutations onto different\n * commits of it's b-tree. These mutations can have reads\n * in them and those reads must be run against the IVM sources.\n *\n * To ensure the reads get the correct state, the IVM\n * sources need to reflect the state of the commit\n * being rebased onto. `IVMSourceBranch` allows us to:\n * 1. fork the IVM sources\n * 2. patch them up to match the desired head\n * 3. run the reads against the forked sources\n *\n * (2) is expected to be a cheap operation as there should only\n * ever be a few outstanding diffs to apply given Zero is meant\n * to be run in a connected state.\n */\nexport class IVMSourceBranch {\n  readonly #sources: Map<string, MemorySource | undefined>;\n  readonly #tables: Record<string, TableSchema>;\n  hash: Hash | undefined;\n\n  constructor(\n    tables: Record<string, TableSchema>,\n    hash?: Hash,\n    sources: Map<string, MemorySource | undefined> = new Map(),\n  ) {\n    this.#tables = tables;\n    this.#sources = sources;\n    this.hash = hash;\n  }\n\n  getSource(name: string): MemorySource | undefined {\n    if (this.#sources.has(name)) {\n      return this.#sources.get(name);\n    }\n\n    const schema = this.#tables[name];\n    const source = schema\n      ? new MemorySource(name, schema.columns, schema.primaryKey)\n      : undefined;\n    this.#sources.set(name, source);\n    return source;\n  }\n\n  clear() {\n    this.#sources.clear();\n  }\n\n  /**\n   * Mutates the current branch, advancing it to the new head\n   * by applying the given diffs.\n   */\n  advance(expectedHead: Hash | undefined, newHead: Hash, diffs: NoIndexDiff) {\n    assert(\n      this.hash === expectedHead,\n      () =>\n        `Expected head must match the main head. Got: ${this.hash}, expected: ${expectedHead}`,\n    );\n\n    applyDiffs(diffs, this);\n    this.hash = newHead;\n  }\n\n  /**\n   * Fork the branch and patch it up to match the desired head.\n   */\n  async forkToHead(\n    store: LazyStore,\n    desiredHead: Hash,\n    readOptions?: ZeroReadOptions,\n  ): Promise<IVMSourceBranch> {\n    const fork = this.fork();\n\n    if (fork.hash === desiredHead) {\n      return fork;\n    }\n\n    await patchBranch(desiredHead, store, fork, readOptions);\n    fork.hash = desiredHead;\n    return fork;\n  }\n\n  /**\n   * Creates a new IVMSourceBranch that is a copy of the current one.\n   * This is a cheap operation since the b-trees are shared until a write is performed\n   * and then only the modified nodes are copied.\n   *\n   * IVM branches are forked when we need to rebase mutations.\n   * The mutations modify the fork rather than original branch.\n   */\n  fork() {\n    return new IVMSourceBranch(\n      this.#tables,\n      this.hash,\n      new Map(\n        wrapIterable(this.#sources.entries()).map(([name, source]) => [\n          name,\n          source?.fork(),\n        ]),\n      ),\n    );\n  }\n}\n\nexport async function initFromStore(\n  branch: IVMSourceBranch,\n  hash: Hash,\n  store: Store,\n) {\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\n  branch.advance(undefined, hash, diffs);\n}\n\nasync function patchBranch(\n  desiredHead: Hash,\n  store: LazyStore,\n  fork: IVMSourceBranch,\n  readOptions: ZeroReadOptions | undefined,\n) {\n  const diffs = await computeDiffs(\n    must(fork.hash),\n    desiredHead,\n    store,\n    readOptions,\n  );\n  if (!diffs) {\n    return;\n  }\n  applyDiffs(diffs, fork);\n}\n\nasync function computeDiffs(\n  startHash: Hash,\n  endHash: Hash,\n  store: LazyStore,\n  readOptions: ZeroReadOptions | undefined,\n): Promise<InternalDiff | undefined> {\n  const readFn = (dagRead: Read) =>\n    diff(\n      startHash,\n      endHash,\n      dagRead,\n      {\n        shouldComputeDiffs: () => true,\n        shouldComputeDiffsForIndex(_name) {\n          return false;\n        },\n      },\n      FormatVersion.Latest,\n    );\n\n  let diffs: DiffsMap;\n  if (readOptions?.openLazySourceRead) {\n    diffs = await using(store.read(readOptions.openLazySourceRead), readFn);\n  } else if (readOptions?.openLazyRead) {\n    diffs = await readFn(readOptions.openLazyRead);\n  } else {\n    diffs = await withRead(store, readFn);\n  }\n\n  return diffs.get('');\n}\n\nfunction applyDiffs(diffs: NoIndexDiff, branch: IVMSourceBranch) {\n  for (\n    let i = diffBinarySearch(diffs, ENTITIES_KEY_PREFIX, diff => diff.key);\n    i < diffs.length;\n    i++\n  ) {\n    const diff = diffs[i];\n    const {key} = diff;\n    if (!key.startsWith(ENTITIES_KEY_PREFIX)) {\n      break;\n    }\n    const name = sourceNameFromKey(key);\n    const source = must(branch.getSource(name));\n    switch (diff.op) {\n      case 'del':\n        source.push({\n          type: 'remove',\n          row: diff.oldValue as Row,\n        });\n        break;\n      case 'add':\n        source.push({\n          type: 'add',\n          row: diff.newValue as Row,\n        });\n        break;\n      case 'change':\n        source.push({\n          type: 'edit',\n          row: diff.newValue as Row,\n          oldRow: diff.oldValue as Row,\n        });\n        break;\n    }\n  }\n}\n"],"names":["FormatVersion.Latest","diff"],"mappings":";;;;;;;;;;;;AAuCO,MAAM,gBAAgB;AAAA,EAClB;AAAA,EACA;AAAA,EACT;AAAA,EAEA,YACE,QACA,MACA,UAAiD,oBAAI,OACrD;AACA,SAAK,UAAU;AACf,SAAK,WAAW;AAChB,SAAK,OAAO;AAAA,EACd;AAAA,EAEA,UAAU,MAAwC;AAChD,QAAI,KAAK,SAAS,IAAI,IAAI,GAAG;AAC3B,aAAO,KAAK,SAAS,IAAI,IAAI;AAAA,IAC/B;AAEA,UAAM,SAAS,KAAK,QAAQ,IAAI;AAChC,UAAM,SAAS,SACX,IAAI,aAAa,MAAM,OAAO,SAAS,OAAO,UAAU,IACxD;AACJ,SAAK,SAAS,IAAI,MAAM,MAAM;AAC9B,WAAO;AAAA,EACT;AAAA,EAEA,QAAQ;AACN,SAAK,SAAS,MAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,QAAQ,cAAgC,SAAe,OAAoB;AACzE;AAAA,MACE,KAAK,SAAS;AAAA,MACd,MACE,gDAAgD,KAAK,IAAI,eAAe,YAAY;AAAA,IAAA;AAGxF,eAAW,OAAO,IAAI;AACtB,SAAK,OAAO;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,WACJ,OACA,aACA,aAC0B;AAC1B,UAAM,OAAO,KAAK,KAAA;AAElB,QAAI,KAAK,SAAS,aAAa;AAC7B,aAAO;AAAA,IACT;AAEA,UAAM,YAAY,aAAa,OAAO,MAAM,WAAW;AACvD,SAAK,OAAO;AACZ,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAO;AACL,WAAO,IAAI;AAAA,MACT,KAAK;AAAA,MACL,KAAK;AAAA,MACL,IAAI;AAAA,QACF,aAAa,KAAK,SAAS,QAAA,CAAS,EAAE,IAAI,CAAC,CAAC,MAAM,MAAM,MAAM;AAAA,UAC5D;AAAA,UACA,QAAQ,KAAA;AAAA,QAAK,CACd;AAAA,MAAA;AAAA,IACH;AAAA,EAEJ;AACF;AAyBA,eAAe,YACb,aACA,OACA,MACA,aACA;AACA,QAAM,QAAQ,MAAM;AAAA,IAClB,KAAK,KAAK,IAAI;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEF,MAAI,CAAC,OAAO;AACV;AAAA,EACF;AACA,aAAW,OAAO,IAAI;AACxB;AAEA,eAAe,aACb,WACA,SACA,OACA,aACmC;AACnC,QAAM,SAAS,CAAC,YACd;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,MACE,oBAAoB,MAAM;AAAA,MAC1B,2BAA2B,OAAO;AAChC,eAAO;AAAA,MACT;AAAA,IAAA;AAAA,IAEFA;AAAAA,EAAc;AAGlB,MAAI;AACJ,MAAI,aAAa,oBAAoB;AACnC,YAAQ,MAAM,MAAM,MAAM,KAAK,YAAY,kBAAkB,GAAG,MAAM;AAAA,EACxE,WAAW,aAAa,cAAc;AACpC,YAAQ,MAAM,OAAO,YAAY,YAAY;AAAA,EAC/C,OAAO;AACL,YAAQ,MAAM,SAAS,OAAO,MAAM;AAAA,EACtC;AAEA,SAAO,MAAM,IAAI,EAAE;AACrB;AAEA,SAAS,WAAW,OAAoB,QAAyB;AAC/D,WACM,IAAI,iBAAiB,OAAO,qBAAqB,CAAAC,UAAQA,MAAK,GAAG,GACrE,IAAI,MAAM,QACV,KACA;AACA,UAAMA,QAAO,MAAM,CAAC;AACpB,UAAM,EAAC,QAAOA;AACd,QAAI,CAAC,IAAI,WAAW,mBAAmB,GAAG;AACxC;AAAA,IACF;AACA,UAAM,OAAO,kBAAkB,GAAG;AAClC,UAAM,SAAS,KAAK,OAAO,UAAU,IAAI,CAAC;AAC1C,YAAQA,MAAK,IAAA;AAAA,MACX,KAAK;AACH,eAAO,KAAK;AAAA,UACV,MAAM;AAAA,UACN,KAAKA,MAAK;AAAA,QAAA,CACX;AACD;AAAA,MACF,KAAK;AACH,eAAO,KAAK;AAAA,UACV,MAAM;AAAA,UACN,KAAKA,MAAK;AAAA,QAAA,CACX;AACD;AAAA,MACF,KAAK;AACH,eAAO,KAAK;AAAA,UACV,MAAM;AAAA,UACN,KAAKA,MAAK;AAAA,UACV,QAAQA,MAAK;AAAA,QAAA,CACd;AACD;AAAA,IAAA;AAAA,EAEN;AACF;"}

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

@@ -0,0 +1,45 @@
+import { h128 } from "../../../shared/src/hash.js";
+import { parse } from "../../../shared/src/valita.js";
+import { primaryKeyValueSchema } from "../../../zero-protocol/src/primary-key.js";
+const DESIRED_QUERIES_KEY_PREFIX = "d/";
+const GOT_QUERIES_KEY_PREFIX = "g/";
+const ENTITIES_KEY_PREFIX = "e/";
+const MUTATIONS_KEY_PREFIX = "m/";
+function toDesiredQueriesKey(clientID, hash) {
+  return DESIRED_QUERIES_KEY_PREFIX + clientID + "/" + hash;
+}
+function desiredQueriesPrefixForClient(clientID) {
+  return DESIRED_QUERIES_KEY_PREFIX + clientID + "/";
+}
+function toGotQueriesKey(hash) {
+  return GOT_QUERIES_KEY_PREFIX + hash;
+}
+function toMutationResponseKey(mid) {
+  return MUTATIONS_KEY_PREFIX + mid.clientID + "/" + mid.id;
+}
+function toPrimaryKeyString(tableName, primaryKey, value) {
+  if (primaryKey.length === 1) {
+    return ENTITIES_KEY_PREFIX + tableName + "/" + parse(value[primaryKey[0]], primaryKeyValueSchema);
+  }
+  const values = primaryKey.map((k) => parse(value[k], primaryKeyValueSchema));
+  const str = JSON.stringify(values);
+  const idSegment = h128(str);
+  return ENTITIES_KEY_PREFIX + tableName + "/" + idSegment;
+}
+function sourceNameFromKey(key) {
+  const slash = key.indexOf("/", ENTITIES_KEY_PREFIX.length);
+  return key.slice(ENTITIES_KEY_PREFIX.length, slash);
+}
+export {
+  DESIRED_QUERIES_KEY_PREFIX,
+  ENTITIES_KEY_PREFIX,
+  GOT_QUERIES_KEY_PREFIX,
+  MUTATIONS_KEY_PREFIX,
+  desiredQueriesPrefixForClient,
+  sourceNameFromKey,
+  toDesiredQueriesKey,
+  toGotQueriesKey,
+  toMutationResponseKey,
+  toPrimaryKeyString
+};
+//# sourceMappingURL=keys.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sources":["../../../../../zero-client/src/client/keys.ts"],"sourcesContent":["import {h128} from '../../../shared/src/hash.ts';\nimport * as v from '../../../shared/src/valita.ts';\nimport type {CompoundKey} from '../../../zero-protocol/src/ast.ts';\nimport type {Row} from '../../../zero-protocol/src/data.ts';\nimport {primaryKeyValueSchema} from '../../../zero-protocol/src/primary-key.ts';\nimport type {MutationID} from '../../../zero-protocol/src/push.ts';\n\nexport const DESIRED_QUERIES_KEY_PREFIX = 'd/';\nexport const GOT_QUERIES_KEY_PREFIX = 'g/';\nexport const ENTITIES_KEY_PREFIX = 'e/';\nexport const MUTATIONS_KEY_PREFIX = 'm/';\n\nexport function toDesiredQueriesKey(clientID: string, hash: string): string {\n  return DESIRED_QUERIES_KEY_PREFIX + clientID + '/' + hash;\n}\n\nexport function desiredQueriesPrefixForClient(clientID: string): string {\n  return DESIRED_QUERIES_KEY_PREFIX + clientID + '/';\n}\n\nexport function toGotQueriesKey(hash: string): string {\n  return GOT_QUERIES_KEY_PREFIX + hash;\n}\n\nexport function toMutationResponseKey(mid: MutationID): string {\n  return MUTATIONS_KEY_PREFIX + mid.clientID + '/' + mid.id;\n}\n\nexport function toPrimaryKeyString(\n  tableName: string,\n  primaryKey: CompoundKey,\n  value: Row,\n): string {\n  if (primaryKey.length === 1) {\n    return (\n      ENTITIES_KEY_PREFIX +\n      tableName +\n      '/' +\n      v.parse(value[primaryKey[0]], primaryKeyValueSchema)\n    );\n  }\n\n  const values = primaryKey.map(k => v.parse(value[k], primaryKeyValueSchema));\n  const str = JSON.stringify(values);\n\n  const idSegment = h128(str);\n  return ENTITIES_KEY_PREFIX + tableName + '/' + idSegment;\n}\n\nexport function sourceNameFromKey(key: string): string {\n  const slash = key.indexOf('/', ENTITIES_KEY_PREFIX.length);\n  return key.slice(ENTITIES_KEY_PREFIX.length, slash);\n}\n"],"names":["v.parse"],"mappings":";;;AAOO,MAAM,6BAA6B;AACnC,MAAM,yBAAyB;AAC/B,MAAM,sBAAsB;AAC5B,MAAM,uBAAuB;AAE7B,SAAS,oBAAoB,UAAkB,MAAsB;AAC1E,SAAO,6BAA6B,WAAW,MAAM;AACvD;AAEO,SAAS,8BAA8B,UAA0B;AACtE,SAAO,6BAA6B,WAAW;AACjD;AAEO,SAAS,gBAAgB,MAAsB;AACpD,SAAO,yBAAyB;AAClC;AAEO,SAAS,sBAAsB,KAAyB;AAC7D,SAAO,uBAAuB,IAAI,WAAW,MAAM,IAAI;AACzD;AAEO,SAAS,mBACd,WACA,YACA,OACQ;AACR,MAAI,WAAW,WAAW,GAAG;AAC3B,WACE,sBACA,YACA,MACAA,MAAQ,MAAM,WAAW,CAAC,CAAC,GAAG,qBAAqB;AAAA,EAEvD;AAEA,QAAM,SAAS,WAAW,IAAI,CAAA,MAAKA,MAAQ,MAAM,CAAC,GAAG,qBAAqB,CAAC;AAC3E,QAAM,MAAM,KAAK,UAAU,MAAM;AAEjC,QAAM,YAAY,KAAK,GAAG;AAC1B,SAAO,sBAAsB,YAAY,MAAM;AACjD;AAEO,SAAS,kBAAkB,KAAqB;AACrD,QAAM,QAAQ,IAAI,QAAQ,KAAK,oBAAoB,MAAM;AACzD,SAAO,IAAI,MAAM,oBAAoB,QAAQ,KAAK;AACpD;"}

package/out/zero-client/src/client/log-options.js

@@ -0,0 +1,60 @@
+import { consoleLogSink, TeeLogSink } from "@rocicorp/logger";
+import { DatadogLogSink } from "../../../datadog/src/datadog-log-sink.js";
+import { appendPath } from "./http-string.js";
+import { version } from "./version.js";
+class LevelFilterLogSink {
+  #wrappedLogSink;
+  #level;
+  constructor(wrappedLogSink, level) {
+    this.#wrappedLogSink = wrappedLogSink;
+    this.#level = level;
+  }
+  log(level, context, ...args) {
+    if (this.#level === "error" && level !== "error") {
+      return;
+    }
+    if (this.#level === "info" && level === "debug") {
+      return;
+    }
+    this.#wrappedLogSink.log(level, context, ...args);
+  }
+  async flush() {
+    await consoleLogSink.flush?.();
+  }
+}
+const DATADOG_LOG_LEVEL = "info";
+const ZERO_SASS_DOMAIN = ".reflect-server.net";
+function createLogOptions(options, createDatadogLogSink = (options2) => new DatadogLogSink(options2)) {
+  const { consoleLogLevel, server, enableAnalytics } = options;
+  if (!enableAnalytics || server === null) {
+    return {
+      logLevel: consoleLogLevel,
+      logSink: consoleLogSink
+    };
+  }
+  const serverURL = new URL(server);
+  const { hostname } = serverURL;
+  const datadogServiceLabel = hostname.endsWith(ZERO_SASS_DOMAIN) ? hostname.substring(0, hostname.length - ZERO_SASS_DOMAIN.length).toLowerCase() : hostname;
+  const baseURL = new URL(appendPath(server, "/logs/v0/log"));
+  const logLevel = consoleLogLevel === "debug" ? "debug" : "info";
+  const logSink = new TeeLogSink([
+    new LevelFilterLogSink(consoleLogSink, consoleLogLevel),
+    new LevelFilterLogSink(
+      createDatadogLogSink({
+        service: datadogServiceLabel,
+        host: location.host,
+        version,
+        baseURL
+      }),
+      DATADOG_LOG_LEVEL
+    )
+  ]);
+  return {
+    logLevel,
+    logSink
+  };
+}
+export {
+  createLogOptions
+};
+//# sourceMappingURL=log-options.js.map

package/out/zero-client/src/client/log-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-options.js","sources":["../../../../../zero-client/src/client/log-options.ts"],"sourcesContent":["import {\n  TeeLogSink,\n  consoleLogSink,\n  type Context,\n  type LogLevel,\n  type LogSink,\n} from '@rocicorp/logger';\nimport {\n  DatadogLogSink,\n  type DatadogLogSinkOptions,\n} from '../../../datadog/src/datadog-log-sink.ts';\nimport {appendPath, type HTTPString} from './http-string.ts';\nimport {version} from './version.ts';\n\nclass LevelFilterLogSink implements LogSink {\n  readonly #wrappedLogSink: LogSink;\n  readonly #level: LogLevel;\n\n  constructor(wrappedLogSink: LogSink, level: LogLevel) {\n    this.#wrappedLogSink = wrappedLogSink;\n    this.#level = level;\n  }\n\n  log(level: LogLevel, context: Context | undefined, ...args: unknown[]): void {\n    if (this.#level === 'error' && level !== 'error') {\n      return;\n    }\n    if (this.#level === 'info' && level === 'debug') {\n      return;\n    }\n    this.#wrappedLogSink.log(level, context, ...args);\n  }\n\n  async flush() {\n    await consoleLogSink.flush?.();\n  }\n}\n\nconst DATADOG_LOG_LEVEL = 'info';\nconst ZERO_SASS_DOMAIN = '.reflect-server.net';\n\nexport type LogOptions = {\n  readonly logLevel: LogLevel;\n  readonly logSink: LogSink;\n};\n\nexport function createLogOptions(\n  options: {\n    consoleLogLevel: LogLevel;\n    server: HTTPString | null;\n    enableAnalytics: boolean;\n  },\n  createDatadogLogSink: (options: DatadogLogSinkOptions) => LogSink = (\n    options: DatadogLogSinkOptions,\n  ) => new DatadogLogSink(options),\n): LogOptions {\n  const {consoleLogLevel, server, enableAnalytics} = options;\n\n  if (!enableAnalytics || server === null) {\n    return {\n      logLevel: consoleLogLevel,\n      logSink: consoleLogSink,\n    };\n  }\n\n  const serverURL = new URL(server);\n  const {hostname} = serverURL;\n  const datadogServiceLabel = hostname.endsWith(ZERO_SASS_DOMAIN)\n    ? hostname\n        .substring(0, hostname.length - ZERO_SASS_DOMAIN.length)\n        .toLowerCase()\n    : hostname;\n  const baseURL = new URL(appendPath(server, '/logs/v0/log'));\n  const logLevel = consoleLogLevel === 'debug' ? 'debug' : 'info';\n  const logSink = new TeeLogSink([\n    new LevelFilterLogSink(consoleLogSink, consoleLogLevel),\n    new LevelFilterLogSink(\n      createDatadogLogSink({\n        service: datadogServiceLabel,\n        host: location.host,\n        version,\n        baseURL,\n      }),\n      DATADOG_LOG_LEVEL,\n    ),\n  ]);\n  return {\n    logLevel,\n    logSink,\n  };\n}\n"],"names":["options"],"mappings":";;;;AAcA,MAAM,mBAAsC;AAAA,EACjC;AAAA,EACA;AAAA,EAET,YAAY,gBAAyB,OAAiB;AACpD,SAAK,kBAAkB;AACvB,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,IAAI,OAAiB,YAAiC,MAAuB;AAC3E,QAAI,KAAK,WAAW,WAAW,UAAU,SAAS;AAChD;AAAA,IACF;AACA,QAAI,KAAK,WAAW,UAAU,UAAU,SAAS;AAC/C;AAAA,IACF;AACA,SAAK,gBAAgB,IAAI,OAAO,SAAS,GAAG,IAAI;AAAA,EAClD;AAAA,EAEA,MAAM,QAAQ;AACZ,UAAM,eAAe,QAAA;AAAA,EACvB;AACF;AAEA,MAAM,oBAAoB;AAC1B,MAAM,mBAAmB;AAOlB,SAAS,iBACd,SAKA,uBAAoE,CAClEA,aACG,IAAI,eAAeA,QAAO,GACnB;AACZ,QAAM,EAAC,iBAAiB,QAAQ,gBAAA,IAAmB;AAEnD,MAAI,CAAC,mBAAmB,WAAW,MAAM;AACvC,WAAO;AAAA,MACL,UAAU;AAAA,MACV,SAAS;AAAA,IAAA;AAAA,EAEb;AAEA,QAAM,YAAY,IAAI,IAAI,MAAM;AAChC,QAAM,EAAC,aAAY;AACnB,QAAM,sBAAsB,SAAS,SAAS,gBAAgB,IAC1D,SACG,UAAU,GAAG,SAAS,SAAS,iBAAiB,MAAM,EACtD,gBACH;AACJ,QAAM,UAAU,IAAI,IAAI,WAAW,QAAQ,cAAc,CAAC;AAC1D,QAAM,WAAW,oBAAoB,UAAU,UAAU;AACzD,QAAM,UAAU,IAAI,WAAW;AAAA,IAC7B,IAAI,mBAAmB,gBAAgB,eAAe;AAAA,IACtD,IAAI;AAAA,MACF,qBAAqB;AAAA,QACnB,SAAS;AAAA,QACT,MAAM,SAAS;AAAA,QACf;AAAA,QACA;AAAA,MAAA,CACD;AAAA,MACD;AAAA,IAAA;AAAA,EACF,CACD;AACD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EAAA;AAEJ;"}

package/out/zero-client/src/client/make-mutate-property.d.ts

@@ -0,0 +1,43 @@
+import type { DeepMerge } from '../../../shared/src/deep-merge.ts';
+import type { Schema } from '../../../zero-types/src/schema.ts';
+import { type Transaction } from '../../../zql/src/mutate/custom.ts';
+import type { AnyMutatorRegistry } from '../../../zql/src/mutate/mutator-registry.ts';
+import { type MutatorDefinition } from '../../../zql/src/mutate/mutator.ts';
+import type { DBMutator } from './crud.ts';
+import type { CustomMutatorDefs, MutatorResult } from './custom.ts';
+import type { MutatorProxy } from './mutator-proxy.ts';
+/**
+ * Creates and populates a mutate property object by processing mutator definitions recursively.
+ *
+ * This function traverses through mutator definitions (either schema-based or custom) and builds
+ * a corresponding object structure where each mutator is wrapped by the mutator proxy. It handles
+ * both flat mutator functions and nested mutator definition objects.
+ *
+ * @template S - The schema type that defines the structure of the data
+ * @template C - The context type used by mutators, defaults to unknown
+ *
+ * @param mutators - The mutator definitions to process, can be schema-based or custom mutator definitions
+ * @param mutatorProxy - The proxy object responsible for wrapping mutators with additional functionality
+ * @param mutateObject - The target object to populate with wrapped mutators
+ * @param replicacheMutate - The source object containing the actual mutator implementations to wrap
+ *
+ * @returns void - This function mutates the mutateObject parameter directly
+ *
+ * @remarks
+ * The function recursively processes nested mutator structures, creating corresponding nested objects
+ * in the mutateObject. For leaf mutators (functions or mutator definitions), it generates a full key
+ * using different separators ('.' for mutator definitions, '|' for custom functions) and wraps them
+ * using the mutator proxy.
+ */
+export declare function makeMutateProperty(mutators: AnyMutatorRegistry | CustomMutatorDefs, mutatorProxy: MutatorProxy, mutateObject: Record<string, unknown>, replicacheMutate: Record<string, unknown>): void;
+/**
+ * Builds the mutate type from mutator definitions, handling arbitrary nesting.
+ * Each node can be either a MutatorDefinition or a CustomMutatorImpl function,
+ * or a namespace containing more mutators.
+ */
+type MakeFromMutatorDefinitions<S extends Schema, MD extends AnyMutatorRegistry | CustomMutatorDefs, C> = {
+    readonly [K in keyof MD]: MD[K] extends MutatorDefinition<infer TInput, any, S, C, any> ? [TInput] extends [undefined] ? () => MutatorResult : undefined extends TInput ? (args?: TInput) => MutatorResult : (args: TInput) => MutatorResult : MD[K] extends (tx: Transaction<S>, ...args: infer Args) => Promise<void> ? (...args: Args) => MutatorResult : MD[K] extends AnyMutatorRegistry | CustomMutatorDefs ? MakeFromMutatorDefinitions<S, MD[K], C> : never;
+};
+export type MakeMutatePropertyType<S extends Schema, MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined, C> = MD extends AnyMutatorRegistry ? {} : MD extends AnyMutatorRegistry | CustomMutatorDefs ? S['enableLegacyMutators'] extends false ? MakeFromMutatorDefinitions<S, MD, C> : DeepMerge<DBMutator<S>, MakeFromMutatorDefinitions<S, MD, C>> : DBMutator<S>;
+export {};
+//# sourceMappingURL=make-mutate-property.d.ts.map

package/out/zero-client/src/client/make-mutate-property.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-mutate-property.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/make-mutate-property.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,mCAAmC,CAAC;AAEjE,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,6CAA6C,CAAC;AACpF,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAC,iBAAiB,EAAE,aAAa,EAAC,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,kBAAkB,GAAG,iBAAiB,EAChD,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,IAAI,CAwCN;AAED;;;;GAIG;AACH,KAAK,0BAA0B,CAC7B,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,kBAAkB,GAAG,iBAAiB,EACjD,CAAC,IACC;IACF,QAAQ,EAAE,CAAC,IAAI,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,iBAAiB,CACvD,MAAM,MAAM,EAEZ,GAAG,EACH,CAAC,EACD,CAAC,EAED,GAAG,CACJ,GACG,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,GAC1B,MAAM,aAAa,GACnB,SAAS,SAAS,MAAM,GACtB,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,aAAa,GAChC,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GACnC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GACtE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,aAAa,GAChC,EAAE,CAAC,CAAC,CAAC,SAAS,kBAAkB,GAAG,iBAAiB,GAClD,0BAA0B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GACvC,KAAK;CACd,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAChC,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,kBAAkB,GAAG,iBAAiB,GAAG,SAAS,EAC7D,CAAC,IACC,EAAE,SAAS,kBAAkB,GAE7B,EAAE,GACF,EAAE,SAAS,kBAAkB,GAAG,iBAAiB,GAC/C,CAAC,CAAC,sBAAsB,CAAC,SAAS,KAAK,GACrC,0BAA0B,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GACpC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,0BAA0B,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAC/D,SAAS,CAAC,CAAC,CAAC,CAAC"}

package/out/zero-client/src/client/make-mutate-property.js

@@ -0,0 +1,38 @@
+import { must } from "../../../shared/src/must.js";
+import { customMutatorKey } from "../../../zql/src/mutate/custom.js";
+import { isMutator } from "../../../zql/src/mutate/mutator.js";
+function makeMutateProperty(mutators, mutatorProxy, mutateObject, replicacheMutate) {
+  const processMutators = (mutators2, path, mutateObject2) => {
+    for (const [key, mutator] of Object.entries(mutators2)) {
+      path.push(key);
+      let fullKey;
+      if (isMutator(mutator)) {
+        fullKey = customMutatorKey(".", path);
+      } else if (typeof mutator === "function") {
+        fullKey = customMutatorKey("|", path);
+      }
+      if (fullKey) {
+        mutateObject2[key] = mutatorProxy.wrapCustomMutator(
+          must(replicacheMutate[fullKey])
+        );
+      } else {
+        let existing = mutateObject2[key];
+        if (existing === void 0) {
+          existing = {};
+          mutateObject2[key] = existing;
+        }
+        processMutators(
+          mutator,
+          path,
+          existing
+        );
+      }
+      path.pop();
+    }
+  };
+  processMutators(mutators, [], mutateObject);
+}
+export {
+  makeMutateProperty
+};
+//# sourceMappingURL=make-mutate-property.js.map

package/out/zero-client/src/client/make-mutate-property.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-mutate-property.js","sources":["../../../../../zero-client/src/client/make-mutate-property.ts"],"sourcesContent":["import type {DeepMerge} from '../../../shared/src/deep-merge.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport type {Schema} from '../../../zero-types/src/schema.ts';\nimport {\n  customMutatorKey,\n  type Transaction,\n} from '../../../zql/src/mutate/custom.ts';\nimport type {AnyMutatorRegistry} from '../../../zql/src/mutate/mutator-registry.ts';\nimport {\n  isMutator,\n  type MutatorDefinition,\n} from '../../../zql/src/mutate/mutator.ts';\nimport type {DBMutator} from './crud.ts';\nimport type {CustomMutatorDefs, MutatorResult} from './custom.ts';\nimport type {MutatorProxy} from './mutator-proxy.ts';\n\n/**\n * Creates and populates a mutate property object by processing mutator definitions recursively.\n *\n * This function traverses through mutator definitions (either schema-based or custom) and builds\n * a corresponding object structure where each mutator is wrapped by the mutator proxy. It handles\n * both flat mutator functions and nested mutator definition objects.\n *\n * @template S - The schema type that defines the structure of the data\n * @template C - The context type used by mutators, defaults to unknown\n *\n * @param mutators - The mutator definitions to process, can be schema-based or custom mutator definitions\n * @param mutatorProxy - The proxy object responsible for wrapping mutators with additional functionality\n * @param mutateObject - The target object to populate with wrapped mutators\n * @param replicacheMutate - The source object containing the actual mutator implementations to wrap\n *\n * @returns void - This function mutates the mutateObject parameter directly\n *\n * @remarks\n * The function recursively processes nested mutator structures, creating corresponding nested objects\n * in the mutateObject. For leaf mutators (functions or mutator definitions), it generates a full key\n * using different separators ('.' for mutator definitions, '|' for custom functions) and wraps them\n * using the mutator proxy.\n */\nexport function makeMutateProperty(\n  mutators: AnyMutatorRegistry | CustomMutatorDefs,\n  mutatorProxy: MutatorProxy,\n  mutateObject: Record<string, unknown>,\n  replicacheMutate: Record<string, unknown>,\n): void {\n  const processMutators = (\n    mutators: AnyMutatorRegistry | CustomMutatorDefs,\n    path: string[],\n    mutateObject: Record<string, unknown>,\n  ) => {\n    for (const [key, mutator] of Object.entries(mutators)) {\n      path.push(key);\n      let fullKey: string | undefined;\n      if (isMutator(mutator)) {\n        fullKey = customMutatorKey('.', path);\n      } else if (typeof mutator === 'function') {\n        // Legacy CustomMutatorImpl\n        fullKey = customMutatorKey('|', path);\n      }\n\n      if (fullKey) {\n        mutateObject[key] = mutatorProxy.wrapCustomMutator(\n          must(replicacheMutate[fullKey]) as unknown as (\n            ...args: unknown[]\n          ) => MutatorResult,\n        );\n      } else {\n        // recursive build and process.\n        let existing = mutateObject[key];\n        if (existing === undefined) {\n          existing = {};\n          mutateObject[key] = existing;\n        }\n        processMutators(\n          mutator as AnyMutatorRegistry | CustomMutatorDefs,\n          path,\n          existing as Record<string, unknown>,\n        );\n      }\n      path.pop();\n    }\n  };\n\n  processMutators(mutators, [], mutateObject);\n}\n\n/**\n * Builds the mutate type from mutator definitions, handling arbitrary nesting.\n * Each node can be either a MutatorDefinition or a CustomMutatorImpl function,\n * or a namespace containing more mutators.\n */\ntype MakeFromMutatorDefinitions<\n  S extends Schema,\n  MD extends AnyMutatorRegistry | CustomMutatorDefs,\n  C,\n> = {\n  readonly [K in keyof MD]: MD[K] extends MutatorDefinition<\n    infer TInput,\n    // oxlint-disable-next-line no-explicit-any\n    any,\n    S,\n    C,\n    // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n    any\n  >\n    ? [TInput] extends [undefined]\n      ? () => MutatorResult\n      : undefined extends TInput\n        ? (args?: TInput) => MutatorResult\n        : (args: TInput) => MutatorResult\n    : MD[K] extends (tx: Transaction<S>, ...args: infer Args) => Promise<void>\n      ? (...args: Args) => MutatorResult\n      : MD[K] extends AnyMutatorRegistry | CustomMutatorDefs\n        ? MakeFromMutatorDefinitions<S, MD[K], C>\n        : never;\n};\n\nexport type MakeMutatePropertyType<\n  S extends Schema,\n  MD extends AnyMutatorRegistry | CustomMutatorDefs | undefined,\n  C,\n> = MD extends AnyMutatorRegistry\n  ? // MutatorRegistry: no property tree, user calls zero.mutate(mr) directly\n    {}\n  : MD extends AnyMutatorRegistry | CustomMutatorDefs\n    ? S['enableLegacyMutators'] extends false\n      ? MakeFromMutatorDefinitions<S, MD, C>\n      : DeepMerge<DBMutator<S>, MakeFromMutatorDefinitions<S, MD, C>>\n    : DBMutator<S>;\n"],"names":["mutators","mutateObject"],"mappings":";;;AAuCO,SAAS,mBACd,UACA,cACA,cACA,kBACM;AACN,QAAM,kBAAkB,CACtBA,WACA,MACAC,kBACG;AACH,eAAW,CAAC,KAAK,OAAO,KAAK,OAAO,QAAQD,SAAQ,GAAG;AACrD,WAAK,KAAK,GAAG;AACb,UAAI;AACJ,UAAI,UAAU,OAAO,GAAG;AACtB,kBAAU,iBAAiB,KAAK,IAAI;AAAA,MACtC,WAAW,OAAO,YAAY,YAAY;AAExC,kBAAU,iBAAiB,KAAK,IAAI;AAAA,MACtC;AAEA,UAAI,SAAS;AACXC,sBAAa,GAAG,IAAI,aAAa;AAAA,UAC/B,KAAK,iBAAiB,OAAO,CAAC;AAAA,QAAA;AAAA,MAIlC,OAAO;AAEL,YAAI,WAAWA,cAAa,GAAG;AAC/B,YAAI,aAAa,QAAW;AAC1B,qBAAW,CAAA;AACXA,wBAAa,GAAG,IAAI;AAAA,QACtB;AACA;AAAA,UACE;AAAA,UACA;AAAA,UACA;AAAA,QAAA;AAAA,MAEJ;AACA,WAAK,IAAA;AAAA,IACP;AAAA,EACF;AAEA,kBAAgB,UAAU,CAAA,GAAI,YAAY;AAC5C;"}

package/out/zero-client/src/client/make-replicache-mutators.d.ts

@@ -0,0 +1,34 @@
+import type { LogContext } from '@rocicorp/logger';
+import type { MutatorDefs } from '../../../replicache/src/types.ts';
+import type { Schema } from '../../../zero-types/src/schema.ts';
+import { type AnyMutatorRegistry } from '../../../zql/src/mutate/mutator-registry.ts';
+import { type CRUDMutator } from './crud.ts';
+import type { CustomMutatorDefs } from './custom.ts';
+export declare function extendReplicacheMutators<S extends Schema, C>(lc: LogContext, context: C, mutators: AnyMutatorRegistry | CustomMutatorDefs, schema: S, mutateObject: Record<string, unknown>): void;
+/**
+ * Creates Replicache mutators from mutator definitions.
+ *
+ * This function processes mutator definitions at arbitrary depth, supporting both
+ * new-style mutator definitions and legacy custom mutator implementations. It creates
+ * a mutator object with the CRUD mutator and any provided custom mutators, with keys
+ * generated based on their path in the mutator definition hierarchy.
+ *
+ * @template S - The schema type that defines the structure of the data
+ * @template C - The type of the context object passed to mutators
+ *
+ * @param schema - The schema instance used for validation and type checking
+ * @param mutators - The mutator definitions to process, can be nested objects or custom mutator definitions
+ * @param context - The context to be passed to mutators
+ * @param lc - The log context used for logging operations
+ *
+ * @returns A mutator definitions object containing the CRUD mutator and any custom mutators
+ *
+ * @remarks
+ * - New-style mutator definitions use '.' as a separator in their keys
+ * - Legacy custom mutator implementations use '|' as a separator in their keys
+ * - The CRUD mutator can be disabled by setting `enableLegacyMutators: false` in the schema
+ */
+export declare function makeReplicacheMutators<const S extends Schema, C>(schema: S, mutators: AnyMutatorRegistry | CustomMutatorDefs | undefined, context: C, lc: LogContext): MutatorDefs & {
+    _zero_crud: CRUDMutator;
+};
+//# sourceMappingURL=make-replicache-mutators.d.ts.map

package/out/zero-client/src/client/make-replicache-mutators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-replicache-mutators.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/make-replicache-mutators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAGlE,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,mCAAmC,CAAC;AAE9D,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EAAkB,KAAK,WAAW,EAAC,MAAM,WAAW,CAAC;AAC5D,OAAO,KAAK,EAAC,iBAAiB,EAAoB,MAAM,aAAa,CAAC;AAQtE,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAC1D,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,kBAAkB,GAAG,iBAAiB,EAChD,MAAM,EAAE,CAAC,EACT,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,IAAI,CA8BN;AA2BD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAC9D,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,SAAS,EAC5D,OAAO,EAAE,CAAC,EACV,EAAE,EAAE,UAAU,GACb,WAAW,GAAG;IAAC,UAAU,EAAE,WAAW,CAAA;CAAC,CAoCzC"}

package/out/zero-client/src/client/make-replicache-mutators.js

@@ -0,0 +1,103 @@
+import { CRUD_MUTATION_NAME } from "../../../zero-protocol/src/push.js";
+import { customMutatorKey } from "../../../zql/src/mutate/custom.js";
+import { isMutatorRegistry } from "../../../zql/src/mutate/mutator-registry.js";
+import { Internal } from "./client-error-kind-enum.js";
+import { makeCRUDMutator } from "./crud.js";
+import { TransactionImpl, makeReplicacheMutator as makeReplicacheMutator$1 } from "./custom.js";
+import { ClientError } from "./error.js";
+function extendReplicacheMutators(lc, context, mutators, schema, mutateObject) {
+  const processMutators = (mutators2, path) => {
+    for (const [key, mutator] of Object.entries(mutators2)) {
+      path.push(key);
+      if (isMutator(mutator)) {
+        const fullKey = customMutatorKey(".", path);
+        mutateObject[fullKey] = makeReplicacheMutator(
+          lc,
+          mutator,
+          schema,
+          context
+        );
+      } else if (typeof mutator === "function") {
+        const fullKey = customMutatorKey("|", path);
+        mutateObject[fullKey] = makeReplicacheMutator$1(
+          lc,
+          // oxlint-disable-next-line no-explicit-any
+          mutator,
+          schema,
+          context
+        );
+      } else {
+        processMutators(mutator, path);
+      }
+      path.pop();
+    }
+  };
+  processMutators(mutators, []);
+}
+function makeReplicacheMutator(lc, mutator, schema, context) {
+  return async (repTx, args) => {
+    const tx = new TransactionImpl(lc, repTx, schema);
+    await mutator.fn({
+      args,
+      ctx: context,
+      tx
+    });
+  };
+}
+function makeReplicacheMutators(schema, mutators, context, lc) {
+  const { enableLegacyMutators = true } = schema;
+  const replicacheMutators = {
+    [CRUD_MUTATION_NAME]: enableLegacyMutators ? makeCRUDMutator(schema) : () => Promise.reject(
+      new ClientError({
+        kind: Internal,
+        message: "Zero CRUD mutators are not enabled."
+      })
+    )
+  };
+  if (mutators) {
+    if (isMutatorRegistry(mutators)) {
+      extendFromMutatorRegistry(
+        lc,
+        context,
+        mutators,
+        schema,
+        replicacheMutators
+      );
+    } else {
+      extendReplicacheMutators(
+        lc,
+        context,
+        mutators,
+        schema,
+        replicacheMutators
+      );
+    }
+  }
+  return replicacheMutators;
+}
+function isMutator(value) {
+  return typeof value === "function" && "mutatorName" in value && typeof value.mutatorName === "string" && "fn" in value && typeof value.fn === "function";
+}
+function extendFromMutatorRegistry(lc, context, registry, schema, mutateObject) {
+  const walk = (node) => {
+    if (typeof node !== "object" || node === null) {
+      return;
+    }
+    for (const value of Object.values(node)) {
+      if (isMutator(value)) {
+        mutateObject[value.mutatorName] = (repTx, args) => {
+          const tx = new TransactionImpl(lc, repTx, schema);
+          return value.fn({ args, ctx: context, tx });
+        };
+      } else if (typeof value === "object" && value !== null) {
+        walk(value);
+      }
+    }
+  };
+  walk(registry);
+}
+export {
+  extendReplicacheMutators,
+  makeReplicacheMutators
+};
+//# sourceMappingURL=make-replicache-mutators.js.map

package/out/zero-client/src/client/make-replicache-mutators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-replicache-mutators.js","sources":["../../../../../zero-client/src/client/make-replicache-mutators.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {MutatorDefs} from '../../../replicache/src/types.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport {CRUD_MUTATION_NAME} from '../../../zero-protocol/src/push.ts';\nimport type {Schema} from '../../../zero-types/src/schema.ts';\nimport {customMutatorKey} from '../../../zql/src/mutate/custom.ts';\nimport {\n  isMutatorRegistry,\n  type AnyMutatorRegistry,\n} from '../../../zql/src/mutate/mutator-registry.ts';\nimport {type Mutator} from '../../../zql/src/mutate/mutator.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport {makeCRUDMutator, type CRUDMutator} from './crud.ts';\nimport type {CustomMutatorDefs, CustomMutatorImpl} from './custom.ts';\nimport {\n  makeReplicacheMutator as makeReplicacheMutatorLegacy,\n  TransactionImpl,\n} from './custom.ts';\nimport {ClientError} from './error.ts';\nimport type {WriteTransaction} from './replicache-types.ts';\n\nexport function extendReplicacheMutators<S extends Schema, C>(\n  lc: LogContext,\n  context: C,\n  mutators: AnyMutatorRegistry | CustomMutatorDefs,\n  schema: S,\n  mutateObject: Record<string, unknown>,\n): void {\n  // Recursively process mutator definitions at arbitrary depth\n  const processMutators = (mutators: object, path: string[]) => {\n    for (const [key, mutator] of Object.entries(mutators)) {\n      path.push(key);\n      if (isMutator(mutator)) {\n        const fullKey = customMutatorKey('.', path);\n        mutateObject[fullKey] = makeReplicacheMutator(\n          lc,\n          mutator,\n          schema,\n          context,\n        );\n      } else if (typeof mutator === 'function') {\n        const fullKey = customMutatorKey('|', path);\n        mutateObject[fullKey] = makeReplicacheMutatorLegacy(\n          lc,\n          // oxlint-disable-next-line no-explicit-any\n          mutator as CustomMutatorImpl<any>,\n          schema,\n          context,\n        );\n      } else {\n        processMutators(mutator, path);\n      }\n      path.pop();\n    }\n  };\n\n  processMutators(mutators, []);\n}\n\nfunction makeReplicacheMutator<\n  TArgs extends ReadonlyJSONValue | undefined,\n  TSchema extends Schema,\n  TContext,\n  TWrappedTransaction,\n>(\n  lc: LogContext,\n  mutator: Mutator<TArgs, TSchema, TContext, TWrappedTransaction>,\n  schema: TSchema,\n  context: TContext,\n): (repTx: WriteTransaction, args: ReadonlyJSONValue) => Promise<void> {\n  return async (\n    repTx: WriteTransaction,\n    args: ReadonlyJSONValue,\n  ): Promise<void> => {\n    const tx = new TransactionImpl(lc, repTx, schema);\n    // fn does input validation internally\n    await mutator.fn({\n      args: args as TArgs,\n      ctx: context,\n      tx: tx,\n    });\n  };\n}\n\n/**\n * Creates Replicache mutators from mutator definitions.\n *\n * This function processes mutator definitions at arbitrary depth, supporting both\n * new-style mutator definitions and legacy custom mutator implementations. It creates\n * a mutator object with the CRUD mutator and any provided custom mutators, with keys\n * generated based on their path in the mutator definition hierarchy.\n *\n * @template S - The schema type that defines the structure of the data\n * @template C - The type of the context object passed to mutators\n *\n * @param schema - The schema instance used for validation and type checking\n * @param mutators - The mutator definitions to process, can be nested objects or custom mutator definitions\n * @param context - The context to be passed to mutators\n * @param lc - The log context used for logging operations\n *\n * @returns A mutator definitions object containing the CRUD mutator and any custom mutators\n *\n * @remarks\n * - New-style mutator definitions use '.' as a separator in their keys\n * - Legacy custom mutator implementations use '|' as a separator in their keys\n * - The CRUD mutator can be disabled by setting `enableLegacyMutators: false` in the schema\n */\nexport function makeReplicacheMutators<const S extends Schema, C>(\n  schema: S,\n  mutators: AnyMutatorRegistry | CustomMutatorDefs | undefined,\n  context: C,\n  lc: LogContext,\n): MutatorDefs & {_zero_crud: CRUDMutator} {\n  const {enableLegacyMutators = true} = schema;\n\n  const replicacheMutators = {\n    [CRUD_MUTATION_NAME]: enableLegacyMutators\n      ? makeCRUDMutator(schema)\n      : () =>\n          Promise.reject(\n            new ClientError({\n              kind: ClientErrorKind.Internal,\n              message: 'Zero CRUD mutators are not enabled.',\n            }),\n          ),\n  };\n\n  if (mutators) {\n    if (isMutatorRegistry(mutators)) {\n      extendFromMutatorRegistry(\n        lc,\n        context,\n        mutators,\n        schema,\n        replicacheMutators,\n      );\n    } else {\n      extendReplicacheMutators(\n        lc,\n        context,\n        mutators as CustomMutatorDefs,\n        schema,\n        replicacheMutators,\n      );\n    }\n  }\n\n  return replicacheMutators;\n}\n\n/**\n * Checks if a value is a Mutator (from MutatorRegistry).\n * Mutators have `mutatorName` and `fn` properties.\n */\nfunction isMutator(\n  value: unknown,\n  // oxlint-disable-next-line no-explicit-any\n): value is Mutator<any, any, any, any> {\n  return (\n    typeof value === 'function' &&\n    'mutatorName' in value &&\n    typeof value.mutatorName === 'string' &&\n    'fn' in value &&\n    typeof value.fn === 'function'\n  );\n}\n\n/**\n * Extends replicache mutators from a MutatorRegistry.\n * Walks the registry tree and wraps each Mutator.fn for Replicache.\n */\nfunction extendFromMutatorRegistry<S extends Schema, C>(\n  lc: LogContext,\n  context: C,\n  registry: AnyMutatorRegistry,\n  schema: S,\n  mutateObject: Record<string, unknown>,\n): void {\n  const walk = (node: unknown) => {\n    if (typeof node !== 'object' || node === null) {\n      return;\n    }\n    for (const value of Object.values(node)) {\n      if (isMutator(value)) {\n        // Mutator.fn already handles validation internally\n        mutateObject[value.mutatorName] = (\n          repTx: WriteTransaction,\n          args: ReadonlyJSONValue,\n        ): Promise<void> => {\n          const tx = new TransactionImpl(lc, repTx, schema);\n          return value.fn({args, ctx: context, tx});\n        };\n      } else if (typeof value === 'object' && value !== null) {\n        // Nested namespace\n        walk(value);\n      }\n    }\n  };\n  walk(registry);\n}\n"],"names":["mutators","makeReplicacheMutatorLegacy","ClientErrorKind.Internal"],"mappings":";;;;;;;AAqBO,SAAS,yBACd,IACA,SACA,UACA,QACA,cACM;AAEN,QAAM,kBAAkB,CAACA,WAAkB,SAAmB;AAC5D,eAAW,CAAC,KAAK,OAAO,KAAK,OAAO,QAAQA,SAAQ,GAAG;AACrD,WAAK,KAAK,GAAG;AACb,UAAI,UAAU,OAAO,GAAG;AACtB,cAAM,UAAU,iBAAiB,KAAK,IAAI;AAC1C,qBAAa,OAAO,IAAI;AAAA,UACtB;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QAAA;AAAA,MAEJ,WAAW,OAAO,YAAY,YAAY;AACxC,cAAM,UAAU,iBAAiB,KAAK,IAAI;AAC1C,qBAAa,OAAO,IAAIC;AAAAA,UACtB;AAAA;AAAA,UAEA;AAAA,UACA;AAAA,UACA;AAAA,QAAA;AAAA,MAEJ,OAAO;AACL,wBAAgB,SAAS,IAAI;AAAA,MAC/B;AACA,WAAK,IAAA;AAAA,IACP;AAAA,EACF;AAEA,kBAAgB,UAAU,EAAE;AAC9B;AAEA,SAAS,sBAMP,IACA,SACA,QACA,SACqE;AACrE,SAAO,OACL,OACA,SACkB;AAClB,UAAM,KAAK,IAAI,gBAAgB,IAAI,OAAO,MAAM;AAEhD,UAAM,QAAQ,GAAG;AAAA,MACf;AAAA,MACA,KAAK;AAAA,MACL;AAAA,IAAA,CACD;AAAA,EACH;AACF;AAyBO,SAAS,uBACd,QACA,UACA,SACA,IACyC;AACzC,QAAM,EAAC,uBAAuB,KAAA,IAAQ;AAEtC,QAAM,qBAAqB;AAAA,IACzB,CAAC,kBAAkB,GAAG,uBAClB,gBAAgB,MAAM,IACtB,MACE,QAAQ;AAAA,MACN,IAAI,YAAY;AAAA,QACd,MAAMC;AAAAA,QACN,SAAS;AAAA,MAAA,CACV;AAAA,IAAA;AAAA,EACH;AAGR,MAAI,UAAU;AACZ,QAAI,kBAAkB,QAAQ,GAAG;AAC/B;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ,OAAO;AACL;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AAEA,SAAO;AACT;AAMA,SAAS,UACP,OAEsC;AACtC,SACE,OAAO,UAAU,cACjB,iBAAiB,SACjB,OAAO,MAAM,gBAAgB,YAC7B,QAAQ,SACR,OAAO,MAAM,OAAO;AAExB;AAMA,SAAS,0BACP,IACA,SACA,UACA,QACA,cACM;AACN,QAAM,OAAO,CAAC,SAAkB;AAC9B,QAAI,OAAO,SAAS,YAAY,SAAS,MAAM;AAC7C;AAAA,IACF;AACA,eAAW,SAAS,OAAO,OAAO,IAAI,GAAG;AACvC,UAAI,UAAU,KAAK,GAAG;AAEpB,qBAAa,MAAM,WAAW,IAAI,CAChC,OACA,SACkB;AAClB,gBAAM,KAAK,IAAI,gBAAgB,IAAI,OAAO,MAAM;AAChD,iBAAO,MAAM,GAAG,EAAC,MAAM,KAAK,SAAS,IAAG;AAAA,QAC1C;AAAA,MACF,WAAW,OAAO,UAAU,YAAY,UAAU,MAAM;AAEtD,aAAK,KAAK;AAAA,MACZ;AAAA,IACF;AAAA,EACF;AACA,OAAK,QAAQ;AACf;"}