@rocicorp/zero 0.26.1 → 0.26.2-canary.4

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

@@ -1,33 +1,50 @@
 import { must } from "../../../shared/src/must.js";
 import { customMutatorKey } from "../../../zql/src/mutate/custom.js";
+//#region ../zero-client/src/client/make-mutate-property.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.
+*/
 function addCustomMutatorsProperties(mutators, mutatorProxy, mutateObject, replicacheMutate) {
-  const processMutators = (mutators2, path, mutateObject2) => {
-    for (const [key, mutator] of Object.entries(mutators2)) {
-      path.push(key);
-      if (typeof mutator === "function") {
-        const fullKey = customMutatorKey("|", path);
-        mutateObject2[key] = mutatorProxy.wrapCustomMutator(
-          fullKey,
-          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);
+	const processMutators = (mutators, path, mutateObject) => {
+		for (const [key, mutator] of Object.entries(mutators)) {
+			path.push(key);
+			if (typeof mutator === "function") {
+				const fullKey = customMutatorKey("|", path);
+				mutateObject[key] = mutatorProxy.wrapCustomMutator(fullKey, must(replicacheMutate[fullKey]));
+			} else {
+				let existing = mutateObject[key];
+				if (existing === void 0) {
+					existing = {};
+					mutateObject[key] = existing;
+				}
+				processMutators(mutator, path, existing);
+			}
+			path.pop();
+		}
+	};
+	processMutators(mutators, [], mutateObject);
 }
-export {
-  addCustomMutatorsProperties
-};
-//# sourceMappingURL=make-mutate-property.js.map
+//#endregion
+export { addCustomMutatorsProperties };
+
+//# sourceMappingURL=make-mutate-property.js.map

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

@@ -1 +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 {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 addCustomMutatorsProperties(\n  mutators: CustomMutatorDefs,\n  mutatorProxy: MutatorProxy,\n  mutateObject: Record<string, unknown>,\n  replicacheMutate: Record<string, unknown>,\n): void {\n  const processMutators = (\n    mutators: CustomMutatorDefs,\n    path: string[],\n    mutateObject: Record<string, unknown>,\n  ) => {\n    for (const [key, mutator] of Object.entries(mutators)) {\n      path.push(key);\n      if (typeof mutator === 'function') {\n        const fullKey = customMutatorKey('|', path);\n        mutateObject[key] = mutatorProxy.wrapCustomMutator(\n          fullKey,\n          must(replicacheMutate[fullKey]) as unknown as (\n            ...args: unknown[]\n          ) => MutatorResult,\n        );\n      } else {\n        // Nested namespace - 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 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 legacy CustomMutatorDefs, handling arbitrary nesting.\n * Each node can be either a CustomMutatorImpl function or a namespace containing more mutators.\n */\ntype MakeFromMutatorDefinitions<\n  S extends Schema,\n  MD extends CustomMutatorDefs,\n  C,\n> = {\n  readonly [K in keyof MD]: MD[K] extends (\n    tx: Transaction<S>,\n    ...args: infer Args\n  ) => Promise<void>\n    ? (...args: Args) => MutatorResult\n    : MD[K] extends CustomMutatorDefs\n      ? MakeFromMutatorDefinitions<S, MD[K], C>\n      : never;\n};\n\nexport type MakeMutatePropertyType<\n  S extends Schema,\n  MD extends CustomMutatorDefs | undefined,\n  C,\n> = MD extends CustomMutatorDefs\n  ? S['enableLegacyMutators'] extends true\n    ? DeepMerge<DBMutator<S>, MakeFromMutatorDefinitions<S, MD, C>>\n    : MakeFromMutatorDefinitions<S, MD, C>\n  : DBMutator<S>;\n"],"names":["mutators","mutateObject"],"mappings":";;AAkCO,SAAS,4BACd,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,OAAO,YAAY,YAAY;AACjC,cAAM,UAAU,iBAAiB,KAAK,IAAI;AAC1CC,sBAAa,GAAG,IAAI,aAAa;AAAA,UAC/B;AAAA,UACA,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;"}
+{"version":3,"file":"make-mutate-property.js","names":[],"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 {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 addCustomMutatorsProperties(\n  mutators: CustomMutatorDefs,\n  mutatorProxy: MutatorProxy,\n  mutateObject: Record<string, unknown>,\n  replicacheMutate: Record<string, unknown>,\n): void {\n  const processMutators = (\n    mutators: CustomMutatorDefs,\n    path: string[],\n    mutateObject: Record<string, unknown>,\n  ) => {\n    for (const [key, mutator] of Object.entries(mutators)) {\n      path.push(key);\n      if (typeof mutator === 'function') {\n        const fullKey = customMutatorKey('|', path);\n        mutateObject[key] = mutatorProxy.wrapCustomMutator(\n          fullKey,\n          must(replicacheMutate[fullKey]) as unknown as (\n            ...args: unknown[]\n          ) => MutatorResult,\n        );\n      } else {\n        // Nested namespace - 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 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 legacy CustomMutatorDefs, handling arbitrary nesting.\n * Each node can be either a CustomMutatorImpl function or a namespace containing more mutators.\n */\ntype MakeFromMutatorDefinitions<\n  S extends Schema,\n  MD extends CustomMutatorDefs,\n  C,\n> = {\n  readonly [K in keyof MD]: MD[K] extends (\n    tx: Transaction<S>,\n    ...args: infer Args\n  ) => Promise<void>\n    ? (...args: Args) => MutatorResult\n    : MD[K] extends CustomMutatorDefs\n      ? MakeFromMutatorDefinitions<S, MD[K], C>\n      : never;\n};\n\nexport type MakeMutatePropertyType<\n  S extends Schema,\n  MD extends CustomMutatorDefs | undefined,\n  C,\n> = MD extends CustomMutatorDefs\n  ? S['enableLegacyMutators'] extends true\n    ? DeepMerge<DBMutator<S>, MakeFromMutatorDefinitions<S, MD, C>>\n    : MakeFromMutatorDefinitions<S, MD, C>\n  : DBMutator<S>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,4BACd,UACA,cACA,cACA,kBACM;CACN,MAAM,mBACJ,UACA,MACA,iBACG;AACH,OAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,SAAS,EAAE;AACrD,QAAK,KAAK,IAAI;AACd,OAAI,OAAO,YAAY,YAAY;IACjC,MAAM,UAAU,iBAAiB,KAAK,KAAK;AAC3C,iBAAa,OAAO,aAAa,kBAC/B,SACA,KAAK,iBAAiB,SAAS,CAGhC;UACI;IAEL,IAAI,WAAW,aAAa;AAC5B,QAAI,aAAa,KAAA,GAAW;AAC1B,gBAAW,EAAE;AACb,kBAAa,OAAO;;AAEtB,oBACE,SACA,MACA,SACD;;AAEH,QAAK,KAAK;;;AAId,iBAAgB,UAAU,EAAE,EAAE,aAAa"}

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

@@ -1,108 +1,92 @@
-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 { isMutator } from "../../../zql/src/mutate/mutator.js";
+import { isMutatorRegistry } from "../../../zql/src/mutate/mutator-registry.js";
+import { CRUD_MUTATION_NAME } from "../../../zero-protocol/src/push.js";
 import { Internal } from "./client-error-kind-enum.js";
+import { ClientError } from "./error.js";
 import { makeCRUDMutator } from "./crud.js";
+import { customMutatorKey } from "../../../zql/src/mutate/custom.js";
 import { TransactionImpl, makeReplicacheMutator as makeReplicacheMutator$1 } from "./custom.js";
-import { ClientError } from "./error.js";
+//#region ../zero-client/src/client/make-replicache-mutators.ts
 function extendReplicacheMutators(lc, context, mutators, schema, mutateObject) {
-  const processMutators = (mutators2, path) => {
-    for (const [key, mutator] of Object.entries(mutators2)) {
-      if (key === "~") {
-        continue;
-      }
-      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 if (mutator !== null && typeof mutator === "object") {
-        processMutators(mutator, path);
-      }
-      path.pop();
-    }
-  };
-  processMutators(mutators, []);
+	const processMutators = (mutators, path) => {
+		for (const [key, mutator] of Object.entries(mutators)) {
+			if (key === "~") continue;
+			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, mutator, schema, context);
+			} else if (mutator !== null && typeof mutator === "object") 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
-    });
-  };
+	return async (repTx, args) => {
+		const tx = new TransactionImpl(lc, repTx, schema);
+		await mutator.fn({
+			args,
+			ctx: context,
+			tx
+		});
+	};
 }
+/**
+* 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
+*/
 function makeReplicacheMutators(schema, mutators, context, lc) {
-  const { enableLegacyMutators = false } = schema;
-  const replicacheMutators = {
-    [CRUD_MUTATION_NAME]: enableLegacyMutators ? makeCRUDMutator(schema) : (
-      // TODO(arv): This code is unreachable since the public API prevents
-      // calling CRUD mutators when enableLegacyMutators is false. Remove this.
-      (() => 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;
+	const { enableLegacyMutators = false } = 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;
 }
+/**
+* Extends replicache mutators from a MutatorRegistry.
+* Walks the registry tree and wraps each Mutator.fn for Replicache.
+*/
 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);
+	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
+//#endregion
+export { makeReplicacheMutators };
+
+//# sourceMappingURL=make-replicache-mutators.js.map

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

@@ -1 +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 {isMutator, 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      if (key === '~') {\n        // Skip phantom type\n        continue;\n      }\n\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 if (mutator !== null && typeof mutator === 'object') {\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 = false} = schema;\n\n  const replicacheMutators = {\n    [CRUD_MUTATION_NAME]: enableLegacyMutators\n      ? makeCRUDMutator(schema)\n      : // TODO(arv): This code is unreachable since the public API prevents\n        // calling CRUD mutators when enableLegacyMutators is false. Remove this.\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 * 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<S>(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,UAAI,QAAQ,KAAK;AAEf;AAAA,MACF;AAEA,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,WAAW,YAAY,QAAQ,OAAO,YAAY,UAAU;AAC1D,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,MAAA,IAAS;AAEvC,QAAM,qBAAqB;AAAA,IACzB,CAAC,kBAAkB,GAAG,uBAClB,gBAAgB,MAAM;AAAA;AAAA;AAAA,OAGtB,MACE,QAAQ;AAAA,QACN,IAAI,YAAY;AAAA,UACd,MAAMC;AAAAA,UACN,SAAS;AAAA,QAAA,CACV;AAAA,MAAA;AAAA;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,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,UAAa,KAAK,GAAG;AAEvB,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;"}
+{"version":3,"file":"make-replicache-mutators.js","names":[],"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 {isMutator, 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      if (key === '~') {\n        // Skip phantom type\n        continue;\n      }\n\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 if (mutator !== null && typeof mutator === 'object') {\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 = false} = schema;\n\n  const replicacheMutators = {\n    [CRUD_MUTATION_NAME]: enableLegacyMutators\n      ? makeCRUDMutator(schema)\n      : // TODO(arv): This code is unreachable since the public API prevents\n        // calling CRUD mutators when enableLegacyMutators is false. Remove this.\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 * 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<S>(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"],"mappings":";;;;;;;;;AAqBA,SAAgB,yBACd,IACA,SACA,UACA,QACA,cACM;CAEN,MAAM,mBAAmB,UAAkB,SAAmB;AAC5D,OAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,SAAS,EAAE;AACrD,OAAI,QAAQ,IAEV;AAGF,QAAK,KAAK,IAAI;AACd,OAAI,UAAU,QAAQ,EAAE;IACtB,MAAM,UAAU,iBAAiB,KAAK,KAAK;AAC3C,iBAAa,WAAW,sBACtB,IACA,SACA,QACA,QACD;cACQ,OAAO,YAAY,YAAY;IACxC,MAAM,UAAU,iBAAiB,KAAK,KAAK;AAC3C,iBAAa,WAAW,wBACtB,IAEA,SACA,QACA,QACD;cACQ,YAAY,QAAQ,OAAO,YAAY,SAChD,iBAAgB,SAAS,KAAK;AAEhC,QAAK,KAAK;;;AAId,iBAAgB,UAAU,EAAE,CAAC;;AAG/B,SAAS,sBAMP,IACA,SACA,QACA,SACqE;AACrE,QAAO,OACL,OACA,SACkB;EAClB,MAAM,KAAK,IAAI,gBAAgB,IAAI,OAAO,OAAO;AAEjD,QAAM,QAAQ,GAAG;GACT;GACN,KAAK;GACD;GACL,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BN,SAAgB,uBACd,QACA,UACA,SACA,IACyC;CACzC,MAAM,EAAC,uBAAuB,UAAS;CAEvC,MAAM,qBAAqB,GACxB,qBAAqB,uBAClB,gBAAgB,OAAO,SAIrB,QAAQ,OACN,IAAI,YAAY;EACd,MAAM;EACN,SAAS;EACV,CAAC,CACH,EACR;AAED,KAAI,SACF,KAAI,kBAAkB,SAAS,CAC7B,2BACE,IACA,SACA,UACA,QACA,mBACD;KAED,0BACE,IACA,SACA,UACA,QACA,mBACD;AAIL,QAAO;;;;;;AAOT,SAAS,0BACP,IACA,SACA,UACA,QACA,cACM;CACN,MAAM,QAAQ,SAAkB;AAC9B,MAAI,OAAO,SAAS,YAAY,SAAS,KACvC;AAEF,OAAK,MAAM,SAAS,OAAO,OAAO,KAAK,CACrC,KAAI,UAAa,MAAM,CAErB,cAAa,MAAM,gBACjB,OACA,SACkB;GAClB,MAAM,KAAK,IAAI,gBAAgB,IAAI,OAAO,OAAO;AACjD,UAAO,MAAM,GAAG;IAAC;IAAM,KAAK;IAAS;IAAG,CAAC;;WAElC,OAAO,UAAU,YAAY,UAAU,KAEhD,MAAK,MAAM;;AAIjB,MAAK,SAAS"}

package/out/zero-client/src/client/metric-name-enum.js

@@ -1,15 +1,11 @@
-const TimeToConnectMs = "time_to_connect_ms";
-const LastConnectError = "last_connect_error";
-const TimeToConnectMsV2 = "time_to_connect_ms_v2";
-const LastConnectErrorV2 = "last_connect_error_v2";
-const TotalTimeToConnectMs = "total_time_to_connect_ms";
-const NotConnected = "not_connected";
-export {
-  LastConnectError,
-  LastConnectErrorV2,
-  NotConnected,
-  TimeToConnectMs,
-  TimeToConnectMsV2,
-  TotalTimeToConnectMs
-};
-//# sourceMappingURL=metric-name-enum.js.map
+//#region ../zero-client/src/client/metric-name-enum.ts
+var TimeToConnectMs = "time_to_connect_ms";
+var LastConnectError = "last_connect_error";
+var TimeToConnectMsV2 = "time_to_connect_ms_v2";
+var LastConnectErrorV2 = "last_connect_error_v2";
+var TotalTimeToConnectMs = "total_time_to_connect_ms";
+var NotConnected = "not_connected";
+//#endregion
+export { LastConnectError, LastConnectErrorV2, NotConnected, TimeToConnectMs, TimeToConnectMsV2, TotalTimeToConnectMs };
+
+//# sourceMappingURL=metric-name-enum.js.map

package/out/zero-client/src/client/metric-name-enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"metric-name-enum.js","sources":["../../../../../zero-client/src/client/metric-name-enum.ts"],"sourcesContent":["export const TimeToConnectMs = 'time_to_connect_ms';\nexport const LastConnectError = 'last_connect_error';\nexport const TimeToConnectMsV2 = 'time_to_connect_ms_v2';\nexport const LastConnectErrorV2 = 'last_connect_error_v2';\nexport const TotalTimeToConnectMs = 'total_time_to_connect_ms';\nexport const NotConnected = 'not_connected';\n\nexport type TimeToConnectMs = typeof TimeToConnectMs;\nexport type LastConnectError = typeof LastConnectError;\nexport type TimeToConnectMsV2 = typeof TimeToConnectMsV2;\nexport type LastConnectErrorV2 = typeof LastConnectErrorV2;\nexport type TotalTimeToConnectMs = typeof TotalTimeToConnectMs;\nexport type NotConnected = typeof NotConnected;\n"],"names":[],"mappings":"AAAO,MAAM,kBAAkB;AACxB,MAAM,mBAAmB;AACzB,MAAM,oBAAoB;AAC1B,MAAM,qBAAqB;AAC3B,MAAM,uBAAuB;AAC7B,MAAM,eAAe;"}
+{"version":3,"file":"metric-name-enum.js","names":[],"sources":["../../../../../zero-client/src/client/metric-name-enum.ts"],"sourcesContent":["export const TimeToConnectMs = 'time_to_connect_ms';\nexport const LastConnectError = 'last_connect_error';\nexport const TimeToConnectMsV2 = 'time_to_connect_ms_v2';\nexport const LastConnectErrorV2 = 'last_connect_error_v2';\nexport const TotalTimeToConnectMs = 'total_time_to_connect_ms';\nexport const NotConnected = 'not_connected';\n\nexport type TimeToConnectMs = typeof TimeToConnectMs;\nexport type LastConnectError = typeof LastConnectError;\nexport type TimeToConnectMsV2 = typeof TimeToConnectMsV2;\nexport type LastConnectErrorV2 = typeof LastConnectErrorV2;\nexport type TotalTimeToConnectMs = typeof TotalTimeToConnectMs;\nexport type NotConnected = typeof NotConnected;\n"],"mappings":";AAAA,IAAa,kBAAkB;AAC/B,IAAa,mBAAmB;AAChC,IAAa,oBAAoB;AACjC,IAAa,qBAAqB;AAClC,IAAa,uBAAuB;AACpC,IAAa,eAAe"}