@rocicorp/zero 0.25.0-canary.21 → 0.25.0-canary.24

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

@@ -39,7 +39,7 @@ import { ConnectionManager, throwIfConnectionError } from "./connection-manager.
 import { Connected, Closed, Disconnected, Connecting, Error as Error$1, NeedsAuth } from "./connection-status-enum.js";
 import { ConnectionImpl } from "./connection.js";
 import { ZeroContext } from "./context.js";
-import { makeCRUDMutate } from "./crud.js";
+import { makeCRUDMutateBatch, addTableCRUDProperties } from "./crud.js";
 import { DeleteClientsManager } from "./delete-clients-manager.js";
 import { shouldEnableAnalytics } from "./enable-analytics.js";
 import { ClientError, getErrorConnectionTransition, NO_STATUS_TRANSITION, isClientError, isAuthError, isServerError, getBackoffParams } from "./error.js";
@@ -47,7 +47,7 @@ import { toWSString, appendPath } from "./http-string.js";
 import { Inspector } from "./inspector/inspector.js";
 import { IVMSourceBranch } from "./ivm-branch.js";
 import { createLogOptions } from "./log-options.js";
-import { makeMutateProperty } from "./make-mutate-property.js";
+import { addCustomMutatorsProperties } from "./make-mutate-property.js";
 import { makeReplicacheMutators } from "./make-replicache-mutators.js";
 import { MetricManager, REPORT_INTERVAL_MS, shouldReportConnectError, getLastConnectErrorValue, DID_NOT_CONNECT_VALUE } from "./metrics.js";
 import { MutationTracker } from "./mutation-tracker.js";
@@ -411,9 +411,12 @@ class Zero {
         repMutator
       )(mr.args);
     };
-    const mutateBatch = makeCRUDMutate(schema, rep.mutate, callableMutate);
+    const mutateBatch = makeCRUDMutateBatch(schema, rep.mutate);
+    if (schema.enableLegacyMutators) {
+      addTableCRUDProperties(schema, callableMutate, rep.mutate);
+    }
     if (mutators && !isMutatorRegistry(mutators)) {
-      makeMutateProperty(
+      addCustomMutatorsProperties(
         mutators,
         mutatorProxy,
         callableMutate,
@@ -623,13 +626,23 @@ class Zero {
     return this.#rep.clientGroupID;
   }
   /**
-   * Provides simple "CRUD" mutations for the tables in the schema.
+   * Use to execute mutations. The primary flow is to call
+   * `zero.mutate(mutationRequest)` with your registered custom mutators:
+   *
+   * ```ts
+   * await zero.mutate(
+   *   mutators.myMutator({id: '1', title: 'First issue'}),
+   * );
+   * ```
    *
-   * Each table has `create`, `set`, `update`, and `delete` methods.
+   * When `schema.enableLegacyMutators` is true, legacy conveniences are added:
+   * - Table-scoped CRUD helpers, e.g. `zero.mutate.issue.create` / `set` / `update` / `delete`
+   * - Your custom mutators exposed directly on `zero.mutate`
    *
    * ```ts
    * await zero.mutate.issue.create({id: '1', title: 'First issue', priority: 'high'});
    * await zero.mutate.comment.create({id: '1', text: 'First comment', issueID: '1'});
+   * await zero.mutate.myMutator({id: '1', title: 'First issue'});
    * ```
    *
    * The `update` methods support partials. Unspecified or `undefined` fields