@rocicorp/zero 0.19.2025041601 → 0.19.2025042200

package/out/{chunk-NIDZOMES.js → chunk-ZEL4YSUP.js}

@@ -84,10 +84,9 @@ import {
   withRead,
   withWrite,
   withWriteNoImplicitCommit
-} from "./chunk-PFL3ILT2.js";
+} from "./chunk-I5KZ62HL.js";
 import {
   AbstractQuery,
-  DEFAULT_RUN_OPTIONS_UNKNOWN,
   ExpressionBuilder,
   assertJSONObject,
   assertJSONValue,
@@ -120,8 +119,9 @@ import {
   transformFilters,
   valita_exports,
   wrapIterable
-} from "./chunk-TOXB4NRA.js";
+} from "./chunk-2QVFOPGX.js";
 import {
+  __export,
   assert,
   assertArray,
   assertNotNull,
@@ -5537,6 +5537,45 @@ function canDatabaseBeCollectedAndGetDeletedClientIDs(enableMutationRecovery, pe
   });
 }
 
+// ../zero-protocol/src/error-kind-enum.ts
+var error_kind_enum_exports = {};
+__export(error_kind_enum_exports, {
+  AuthInvalidated: () => AuthInvalidated,
+  ClientNotFound: () => ClientNotFound,
+  Internal: () => Internal,
+  InvalidConnectionRequest: () => InvalidConnectionRequest,
+  InvalidConnectionRequestBaseCookie: () => InvalidConnectionRequestBaseCookie,
+  InvalidConnectionRequestClientDeleted: () => InvalidConnectionRequestClientDeleted,
+  InvalidConnectionRequestLastMutationID: () => InvalidConnectionRequestLastMutationID,
+  InvalidMessage: () => InvalidMessage,
+  InvalidPush: () => InvalidPush,
+  MutationFailed: () => MutationFailed,
+  MutationRateLimited: () => MutationRateLimited,
+  Rebalance: () => Rebalance,
+  Rehome: () => Rehome,
+  SchemaVersionNotSupported: () => SchemaVersionNotSupported,
+  ServerOverloaded: () => ServerOverloaded,
+  Unauthorized: () => Unauthorized,
+  VersionNotSupported: () => VersionNotSupported
+});
+var AuthInvalidated = "AuthInvalidated";
+var ClientNotFound = "ClientNotFound";
+var InvalidConnectionRequest = "InvalidConnectionRequest";
+var InvalidConnectionRequestBaseCookie = "InvalidConnectionRequestBaseCookie";
+var InvalidConnectionRequestLastMutationID = "InvalidConnectionRequestLastMutationID";
+var InvalidConnectionRequestClientDeleted = "InvalidConnectionRequestClientDeleted";
+var InvalidMessage = "InvalidMessage";
+var InvalidPush = "InvalidPush";
+var MutationFailed = "MutationFailed";
+var MutationRateLimited = "MutationRateLimited";
+var Rebalance = "Rebalance";
+var Rehome = "Rehome";
+var Unauthorized = "Unauthorized";
+var VersionNotSupported = "VersionNotSupported";
+var SchemaVersionNotSupported = "SchemaVersionNotSupported";
+var ServerOverloaded = "ServerOverloaded";
+var Internal = "Internal";
+
 // ../zero-schema/src/builder/relationship-builder.ts
 function relationships(table2, cb) {
   const relationships2 = cb({ many, one });
@@ -6085,8 +6124,58 @@ function escapeLike(val) {
   return val.replace(/[%_]/g, "\\$&");
 }
 
+// ../zero-client/src/client/on-error-kind-enum.ts
+var on_error_kind_enum_exports = {};
+__export(on_error_kind_enum_exports, {
+  AuthInvalidated: () => AuthInvalidated,
+  ClientNotFound: () => ClientNotFound,
+  Internal: () => Internal,
+  InvalidConnectionRequest: () => InvalidConnectionRequest,
+  InvalidConnectionRequestBaseCookie: () => InvalidConnectionRequestBaseCookie,
+  InvalidConnectionRequestClientDeleted: () => InvalidConnectionRequestClientDeleted,
+  InvalidConnectionRequestLastMutationID: () => InvalidConnectionRequestLastMutationID,
+  InvalidMessage: () => InvalidMessage,
+  InvalidPush: () => InvalidPush,
+  InvalidState: () => InvalidState,
+  Metrics: () => Metrics,
+  Mutation: () => Mutation,
+  MutationFailed: () => MutationFailed,
+  MutationRateLimited: () => MutationRateLimited,
+  Network: () => Network,
+  NewClientGroup: () => NewClientGroup,
+  Poke: () => Poke,
+  Push: () => Push,
+  Rebalance: () => Rebalance,
+  Rehome: () => Rehome,
+  SchemaVersionNotSupported: () => SchemaVersionNotSupported2,
+  ServerOverloaded: () => ServerOverloaded,
+  Unauthorized: () => Unauthorized,
+  Unknown: () => Unknown,
+  VersionNotSupported: () => VersionNotSupported2
+});
+
+// ../zero-client/src/client/update-needed-reason-type-enum.ts
+var update_needed_reason_type_enum_exports = {};
+__export(update_needed_reason_type_enum_exports, {
+  NewClientGroup: () => NewClientGroup,
+  SchemaVersionNotSupported: () => SchemaVersionNotSupported2,
+  VersionNotSupported: () => VersionNotSupported2
+});
+var NewClientGroup = "NewClientGroup";
+var VersionNotSupported2 = "VersionNotSupported";
+var SchemaVersionNotSupported2 = "SchemaVersionNotSupported";
+
+// ../zero-client/src/client/on-error-kind-enum.ts
+var Poke = "Poke";
+var Mutation = "Mutation";
+var Push = "Push";
+var Metrics = "Metrics";
+var Unknown = "Unknown";
+var InvalidState = "InvalidState";
+var Network = "Network";
+
 // ../zero-client/src/client/zero.ts
-import { LogContext as LogContext4 } from "@rocicorp/logger";
+import "@rocicorp/logger";
 import { resolver as resolver8 } from "@rocicorp/resolver";
 
 // ../zero-protocol/src/delete-clients.ts
@@ -6148,50 +6237,31 @@ function encodeSecProtocols(initConnectionMessage, authToken) {
   return encodeURIComponent(btoa(JSON.stringify(protocols)));
 }
 
-// ../zero-protocol/src/error-kind-enum.ts
-var AuthInvalidated = "AuthInvalidated";
-var ClientNotFound = "ClientNotFound";
-var InvalidConnectionRequest = "InvalidConnectionRequest";
-var InvalidConnectionRequestBaseCookie = "InvalidConnectionRequestBaseCookie";
-var InvalidConnectionRequestLastMutationID = "InvalidConnectionRequestLastMutationID";
-var InvalidConnectionRequestClientDeleted = "InvalidConnectionRequestClientDeleted";
-var InvalidMessage = "InvalidMessage";
-var InvalidPush = "InvalidPush";
-var MutationFailed = "MutationFailed";
-var MutationRateLimited = "MutationRateLimited";
-var Rebalance = "Rebalance";
-var Rehome = "Rehome";
-var Unauthorized = "Unauthorized";
-var VersionNotSupported = "VersionNotSupported";
-var SchemaVersionNotSupported = "SchemaVersionNotSupported";
-var ServerOverloaded = "ServerOverloaded";
-var Internal = "Internal";
-
 // ../zero-protocol/src/error.ts
 var basicErrorKindSchema = valita_exports.union(
-  valita_exports.literal(AuthInvalidated),
-  valita_exports.literal(ClientNotFound),
-  valita_exports.literal(InvalidConnectionRequest),
-  valita_exports.literal(InvalidConnectionRequestBaseCookie),
-  valita_exports.literal(InvalidConnectionRequestLastMutationID),
-  valita_exports.literal(InvalidConnectionRequestClientDeleted),
-  valita_exports.literal(InvalidMessage),
-  valita_exports.literal(InvalidPush),
-  valita_exports.literal(MutationRateLimited),
-  valita_exports.literal(MutationFailed),
-  valita_exports.literal(Unauthorized),
-  valita_exports.literal(VersionNotSupported),
-  valita_exports.literal(SchemaVersionNotSupported),
-  valita_exports.literal(Internal)
+  valita_exports.literal(error_kind_enum_exports.AuthInvalidated),
+  valita_exports.literal(error_kind_enum_exports.ClientNotFound),
+  valita_exports.literal(error_kind_enum_exports.InvalidConnectionRequest),
+  valita_exports.literal(error_kind_enum_exports.InvalidConnectionRequestBaseCookie),
+  valita_exports.literal(error_kind_enum_exports.InvalidConnectionRequestLastMutationID),
+  valita_exports.literal(error_kind_enum_exports.InvalidConnectionRequestClientDeleted),
+  valita_exports.literal(error_kind_enum_exports.InvalidMessage),
+  valita_exports.literal(error_kind_enum_exports.InvalidPush),
+  valita_exports.literal(error_kind_enum_exports.MutationRateLimited),
+  valita_exports.literal(error_kind_enum_exports.MutationFailed),
+  valita_exports.literal(error_kind_enum_exports.Unauthorized),
+  valita_exports.literal(error_kind_enum_exports.VersionNotSupported),
+  valita_exports.literal(error_kind_enum_exports.SchemaVersionNotSupported),
+  valita_exports.literal(error_kind_enum_exports.Internal)
 );
 var basicErrorBodySchema = valita_exports.object({
   kind: basicErrorKindSchema,
   message: valita_exports.string()
 });
 var backoffErrorKindSchema = valita_exports.union(
-  valita_exports.literal(Rebalance),
-  valita_exports.literal(Rehome),
-  valita_exports.literal(ServerOverloaded)
+  valita_exports.literal(error_kind_enum_exports.Rebalance),
+  valita_exports.literal(error_kind_enum_exports.Rehome),
+  valita_exports.literal(error_kind_enum_exports.ServerOverloaded)
 );
 var backoffBodySchema = valita_exports.object({
   kind: backoffErrorKindSchema,
@@ -6207,6 +6277,10 @@ var backoffBodySchema = valita_exports.object({
   // reconnect, and not after that.
   reconnectParams: valita_exports.record(valita_exports.string()).optional()
 });
+var errorKindSchema = valita_exports.union(
+  basicErrorKindSchema,
+  backoffErrorKindSchema
+);
 var errorBodySchema = valita_exports.union(basicErrorBodySchema, backoffBodySchema);
 var errorMessageSchema = valita_exports.tuple([
   valita_exports.literal("error"),
@@ -7703,20 +7777,20 @@ var ZeroContext = class {
   #commitListeners = /* @__PURE__ */ new Set();
   #slowMaterializeThreshold;
   #lc;
-  normalizeRunOptions;
+  assertValidRunOptions;
   /**
    * Client-side queries start out as "unknown" and are then updated to
    * "complete" once the server has sent back the query result.
    */
   defaultQueryComplete = false;
-  constructor(lc, mainSources, addQuery, updateQuery, batchViewUpdates, slowMaterializeThreshold, normalizeRunOptions3) {
+  constructor(lc, mainSources, addQuery, updateQuery, batchViewUpdates, slowMaterializeThreshold, assertValidRunOptions3) {
     this.#mainSources = mainSources;
     this.#addQuery = addQuery;
     this.#updateQuery = updateQuery;
     this.#batchViewUpdates = batchViewUpdates;
     this.#lc = lc;
     this.#slowMaterializeThreshold = slowMaterializeThreshold;
-    this.normalizeRunOptions = normalizeRunOptions3;
+    this.assertValidRunOptions = assertValidRunOptions3;
   }
   getSource(name) {
     return this.#mainSources.getSource(name);
@@ -7787,6 +7861,7 @@ var ZeroContext = class {
         listener();
       } catch (e) {
         this.#lc.error?.(
+          error_kind_enum_exports.Internal,
           "Failed notifying a commit listener of IVM updates",
           e
         );
@@ -8072,15 +8147,11 @@ function makeSchemaCRUD(schema, tx, ivmBranch) {
     }
   );
 }
-function normalizeRunOptions(options) {
-  if (options === void 0) {
-    return DEFAULT_RUN_OPTIONS_UNKNOWN;
-  }
+function assertValidRunOptions(options) {
   assert(
-    options.type !== "complete",
+    options?.type !== "complete",
     "Cannot wait for complete results in custom mutations"
   );
-  return options;
 }
 function makeSchemaQuery(lc, schema, ivmBranch, slowMaterializeThreshold) {
   const context = new ZeroContext(
@@ -8091,7 +8162,7 @@ function makeSchemaQuery(lc, schema, ivmBranch, slowMaterializeThreshold) {
     },
     (applyViewUpdates) => applyViewUpdates(),
     slowMaterializeThreshold,
-    normalizeRunOptions
+    assertValidRunOptions
   );
   return new Proxy(
     {},
@@ -8436,7 +8507,7 @@ function makeMessage(message, context, logLevel) {
 }
 
 // ../zero-client/src/client/version.ts
-var version2 = "0.19.2025041601";
+var version2 = "0.19.2025042200";
 
 // ../zero-client/src/client/log-options.ts
 var LevelFilterLogSink = class {
@@ -8633,7 +8704,10 @@ var MetricManager = class {
   async flush() {
     const lc = this.#lc;
     if (this.#timerID === null) {
-      lc.error?.("MetricManager.flush() called but already stopped");
+      lc.error?.(
+        on_error_kind_enum_exports.InvalidState,
+        "MetricManager.flush() called but already stopped"
+      );
       return;
     }
     const allSeries = [];
@@ -8654,12 +8728,15 @@ var MetricManager = class {
     try {
       await this.#reporter(allSeries);
     } catch (e) {
-      lc?.error?.(`Error reporting metrics: ${e}`);
+      lc?.error?.(on_error_kind_enum_exports.Metrics, `Error reporting metrics: ${e}`);
     }
   }
   stop() {
     if (this.#timerID === null) {
-      this.#lc.error?.("MetricManager.stop() called but already stopped");
+      this.#lc.error?.(
+        on_error_kind_enum_exports.InvalidState,
+        "MetricManager.stop() called but already stopped"
+      );
       return;
     }
     clearInterval(this.#timerID);
@@ -8787,6 +8864,7 @@ var MutationTracker = class {
   processPushResponse(response) {
     if ("error" in response) {
       this.#lc.error?.(
+        on_error_kind_enum_exports.Push,
         "Received an error response when pushing mutations",
         response
       );
@@ -8857,7 +8935,11 @@ var MutationTracker = class {
       mid.clientID === this.#clientID,
       "received mutation for the wrong client"
     );
-    this.#lc.error?.(`Mutation ${mid.id} returned an error`, error);
+    this.#lc.error?.(
+      on_error_kind_enum_exports.Mutation,
+      `Mutation ${mid.id} returned an error`,
+      error
+    );
     const ephemeralID = this.#ephemeralIDsByMutationID.get(mid.id);
     assert(
       ephemeralID,
@@ -9109,10 +9191,20 @@ var QueryManager = class {
   }
 };
 
+// ../zero-client/src/client/options.ts
+var updateNeededReasonTypeSchema = valita_exports.union(
+  valita_exports.literal(update_needed_reason_type_enum_exports.NewClientGroup),
+  valita_exports.literal(update_needed_reason_type_enum_exports.VersionNotSupported),
+  valita_exports.literal(update_needed_reason_type_enum_exports.SchemaVersionNotSupported)
+);
+
 // ../zero-client/src/client/reload-error-handler.ts
-import "@rocicorp/logger";
 var RELOAD_REASON_STORAGE_KEY = "_zeroReloadReason";
 var RELOAD_BACKOFF_STATE_KEY = "_zeroReloadBackoffState";
+var reloadReasonSchema = valita_exports.tuple([
+  valita_exports.union(updateNeededReasonTypeSchema, errorKindSchema),
+  valita_exports.string()
+]);
 var backoffStateSchema = valita_exports.object({
   lastReloadTime: valita_exports.number().default(0),
   nextIntervalMs: valita_exports.number().default(0)
@@ -9121,16 +9213,19 @@ var MIN_RELOAD_INTERVAL_MS = 500;
 var MAX_RELOAD_INTERVAL_MS = 6e4;
 var FALLBACK_RELOAD_INTERVAL_MS = 1e4;
 var reloadTimer = null;
-function reloadWithReason(lc, reload2, reason) {
+function reloadWithReason(lc, reload2, reason, message) {
   if (reloadTimer) {
-    lc.warn?.("reload timer already scheduled");
+    lc.info?.("reload timer already scheduled");
     return;
   }
   const now = Date.now();
   const backoff = nextBackoff(lc, now);
   if (typeof sessionStorage !== "undefined") {
     sessionStorage.setItem(RELOAD_BACKOFF_STATE_KEY, JSON.stringify(backoff));
-    sessionStorage.setItem(RELOAD_REASON_STORAGE_KEY, reason);
+    sessionStorage.setItem(
+      RELOAD_REASON_STORAGE_KEY,
+      JSON.stringify([reason, message])
+    );
   }
   const delay = backoff.lastReloadTime - now;
   lc.error?.(
@@ -9146,10 +9241,17 @@ function reloadWithReason(lc, reload2, reason) {
 }
 function reportReloadReason(lc) {
   if (typeof sessionStorage !== "undefined") {
-    const reason = sessionStorage.getItem(RELOAD_REASON_STORAGE_KEY);
-    if (reason) {
+    const value = sessionStorage.getItem(RELOAD_REASON_STORAGE_KEY);
+    if (value) {
       sessionStorage.removeItem(RELOAD_REASON_STORAGE_KEY);
-      lc.error?.("Zero reloaded the page.", reason);
+      try {
+        const parsed = JSON.parse(value);
+        const [reasonType, message] = parse(parsed, reloadReasonSchema);
+        lc.error?.(reasonType, "Zero reloaded the page.", message);
+      } catch (e) {
+        lc.error?.(on_error_kind_enum_exports.InvalidState, "Zero reloaded the page.", e);
+        return;
+      }
     }
   }
 }
@@ -9215,14 +9317,14 @@ function isAuthError(ex) {
   return isServerError(ex) && isAuthErrorKind(ex.kind);
 }
 function isAuthErrorKind(kind) {
-  return kind === AuthInvalidated || kind === Unauthorized;
+  return kind === error_kind_enum_exports.AuthInvalidated || kind === error_kind_enum_exports.Unauthorized;
 }
 function isBackoffError(ex) {
   if (isServerError(ex)) {
     switch (ex.errorBody.kind) {
-      case Rebalance:
-      case Rehome:
-      case ServerOverloaded:
+      case error_kind_enum_exports.Rebalance:
+      case error_kind_enum_exports.Rehome:
+      case error_kind_enum_exports.ServerOverloaded:
         return ex.errorBody;
     }
   }
@@ -9290,6 +9392,10 @@ function getServer(server) {
   return validateServerParam("server", server);
 }
 
+// ../zero-client/src/client/zero-log-context.ts
+import { LogContext as LogContext3 } from "@rocicorp/logger";
+var ZeroLogContext = LogContext3;
+
 // ../zero-client/src/client/zero-poke-handler.ts
 import { Lock as Lock3 } from "@rocicorp/lock";
 var PokeHandler = class {
@@ -9413,7 +9519,11 @@ var PokeHandler = class {
     if (String(e).includes("unexpected base cookie for poke")) {
       this.#lc.debug?.("clearing due to", e);
     } else {
-      this.#lc.error?.("clearing due to unexpected poke error", e);
+      this.#lc.error?.(
+        on_error_kind_enum_exports.Poke,
+        "clearing due to unexpected poke error",
+        e
+      );
     }
     this.#clear();
     this.#onPokeError();
@@ -9633,7 +9743,7 @@ var NULL_LAST_MUTATION_ID_SENT = { clientID: "", id: -1 };
 function convertOnUpdateNeededReason(reason) {
   return { type: reason.type };
 }
-function updateNeededReloadReason(reason, serverErrMsg) {
+function updateNeededReloadReasonMessage(reason, serverErrMsg) {
   const { type } = reason;
   let reasonMsg = "";
   switch (type) {
@@ -9654,9 +9764,7 @@ function updateNeededReloadReason(reason, serverErrMsg) {
   }
   return reasonMsg;
 }
-function serverAheadReloadReason(kind) {
-  return `Server reported that client is ahead of server (${kind}). This probably happened because the server is in development mode and restarted. Currently when this happens, the dev server loses its state and on reconnect sees the client as ahead. If you see this in other cases, it may be a bug in Zero.`;
-}
+var serverAheadReloadReason = `Server reported that client is ahead of server. This probably happened because the server is in development mode and restarted. Currently when this happens, the dev server loses its state and on reconnect sees the client as ahead. If you see this in other cases, it may be a bug in Zero.`;
 function onClientStateNotFoundServerReason(serverErrMsg) {
   return `Server could not find state needed to synchronize this client. ${serverErrMsg}`;
 }
@@ -9816,7 +9924,21 @@ var Zero = class {
         `A mutator, or mutator namespace, has already been defined for ${key}`
       );
     }
-    const lc = new LogContext4(logOptions.logLevel, {}, logOptions.logSink);
+    const { onError } = options;
+    const sink = logOptions.logSink;
+    const logSink = {
+      log(level, context, ...args) {
+        if (level === "error" && onError) {
+          onError(...args);
+        } else {
+          sink.log(level, context, ...args);
+        }
+      },
+      async flush() {
+        await sink.flush?.();
+      }
+    };
+    const lc = new ZeroLogContext(logOptions.logLevel, {}, logSink);
     this.#mutationTracker = new MutationTracker(lc);
     if (options.mutators) {
       for (const [namespaceOrKey, mutatorOrMutators] of Object.entries(
@@ -9883,7 +10005,7 @@ var Zero = class {
       (ast, ttl) => this.#queryManager.update(ast, ttl),
       batchViewUpdates,
       slowMaterializeThreshold,
-      normalizeRunOptions2
+      assertValidRunOptions2
     );
     const replicacheImplOptions = {
       enableClientGroupForking: false,
@@ -9907,13 +10029,18 @@ var Zero = class {
     this.userID = userID;
     this.#lc = lc.withContext("clientID", rep.clientID);
     this.#mutationTracker.clientID = rep.clientID;
-    const onUpdateNeededCallback = onUpdateNeeded ?? ((reason, serverErrorMsg) => {
-      reloadWithReason(
-        this.#lc,
-        this.#reload,
-        updateNeededReloadReason(reason, serverErrorMsg)
-      );
-    });
+    const onUpdateNeededCallback = (reason, serverErrorMsg) => {
+      if (onUpdateNeeded) {
+        onUpdateNeeded(reason);
+      } else {
+        reloadWithReason(
+          this.#lc,
+          this.#reload,
+          reason.type,
+          updateNeededReloadReasonMessage(reason, serverErrorMsg)
+        );
+      }
+    };
     this.#onUpdateNeeded = onUpdateNeededCallback;
     this.#rep.onUpdateNeeded = (reason) => {
       onUpdateNeededCallback(convertOnUpdateNeededReason(reason));
@@ -9922,6 +10049,7 @@ var Zero = class {
       reloadWithReason(
         this.#lc,
         this.#reload,
+        error_kind_enum_exports.ClientNotFound,
         reason ?? ON_CLIENT_STATE_NOT_FOUND_REASON_CLIENT
       );
     });
@@ -10193,7 +10321,8 @@ var Zero = class {
     const l = addWebSocketIDFromSocketToLogContext(this.#socket, this.#lc);
     if (this.#connectStart === void 0) {
       l.error?.(
-        "Got open event but connect start time is undefined. This should not happen."
+        on_error_kind_enum_exports.InvalidState,
+        "Got open event but connect start time is undefined."
       );
     } else {
       const now = Date.now();
@@ -10205,20 +10334,27 @@ var Zero = class {
     }
   };
   #onClose = (e) => {
-    const l = addWebSocketIDFromSocketToLogContext(this.#socket, this.#lc);
+    const lc = addWebSocketIDFromSocketToLogContext(this.#socket, this.#lc);
     const { code, reason, wasClean } = e;
-    const log = code <= 1001 ? "info" : "error";
-    l[log]?.("Got socket close event", { code, reason, wasClean });
+    if (code <= 1001) {
+      lc.info?.("Got socket close event", { code, reason, wasClean });
+    } else {
+      lc.error?.(on_error_kind_enum_exports.Network, "Got unexpected socket close event", {
+        code,
+        reason,
+        wasClean
+      });
+    }
     const closeKind = wasClean ? "CleanClose" : "AbruptClose";
     this.#connectResolver.reject(new CloseError(closeKind));
-    this.#disconnect(l, { client: closeKind });
+    this.#disconnect(lc, { client: closeKind });
   };
   // An error on the connection is fatal for the connection.
   async #handleErrorMessage(lc, downMessage) {
     const [, { kind, message }] = downMessage;
-    if (kind === MutationRateLimited) {
+    if (kind === error_kind_enum_exports.MutationRateLimited) {
       this.#lastMutationIDSent = NULL_LAST_MUTATION_ID_SENT;
-      lc.error?.("Mutation rate limited", { message });
+      lc.error?.(kind, "Mutation rate limited", { message });
       return;
     }
     lc.info?.(`${kind}: ${message}}`);
@@ -10227,17 +10363,17 @@ var Zero = class {
     lc.debug?.("Rejecting connect resolver due to error", error);
     this.#connectResolver.reject(error);
     this.#disconnect(lc, { server: kind });
-    if (kind === VersionNotSupported) {
+    if (kind === error_kind_enum_exports.VersionNotSupported) {
       this.#onUpdateNeeded?.({ type: kind }, message);
-    } else if (kind === SchemaVersionNotSupported) {
+    } else if (kind === error_kind_enum_exports.SchemaVersionNotSupported) {
       await this.#rep.disableClientGroup();
       this.#onUpdateNeeded?.({ type: "SchemaVersionNotSupported" }, message);
-    } else if (kind === ClientNotFound) {
+    } else if (kind === error_kind_enum_exports.ClientNotFound) {
       await this.#rep.disableClientGroup();
       this.#onClientStateNotFound?.(onClientStateNotFoundServerReason(message));
-    } else if (kind === InvalidConnectionRequestLastMutationID || kind === InvalidConnectionRequestBaseCookie) {
+    } else if (kind === error_kind_enum_exports.InvalidConnectionRequestLastMutationID || kind === error_kind_enum_exports.InvalidConnectionRequestBaseCookie) {
       await dropDatabase(this.#rep.idbName);
-      reloadWithReason(lc, this.#reload, serverAheadReloadReason(kind));
+      reloadWithReason(lc, this.#reload, kind, serverAheadReloadReason);
     }
   }
   async #handleConnectedMessage(lc, connectedMessage) {
@@ -10258,7 +10394,8 @@ var Zero = class {
     let connectMsgLatencyMs;
     if (this.#connectStart === void 0) {
       lc.error?.(
-        "Got connected message but connect start time is undefined. This should not happen."
+        on_error_kind_enum_exports.InvalidState,
+        "Got connected message but connect start time is undefined."
       );
     } else {
       timeToConnectMs = now - this.#connectStart;
@@ -10269,7 +10406,8 @@ var Zero = class {
     let totalTimeToConnectMs;
     if (this.#totalToConnectStart === void 0) {
       lc.error?.(
-        "Got connected message but total to connect start time is undefined. This should not happen."
+        on_error_kind_enum_exports.InvalidState,
+        "Got connected message but total to connect start time is undefined."
       );
     } else {
       totalTimeToConnectMs = now - this.#totalToConnectStart;
@@ -10341,12 +10479,12 @@ var Zero = class {
    * is received before the connected message is received or if the connection
    * attempt times out.
    */
-  async #connect(l, additionalConnectParams) {
+  async #connect(lc, additionalConnectParams) {
     assert(this.#server);
     assert(this.#connectionState === Disconnected);
     const wsid = nanoid();
-    l = addWebSocketIDToLogContext(wsid, l);
-    l.info?.("Connecting...", { navigatorOnline: localNavigator?.onLine });
+    lc = addWebSocketIDToLogContext(wsid, lc);
+    lc.info?.("Connecting...", { navigatorOnline: localNavigator?.onLine });
     this.#setConnectionState(Connecting);
     assert(this.#connectStart === void 0);
     const now = Date.now();
@@ -10365,9 +10503,9 @@ var Zero = class {
       return;
     }
     const timeoutID = setTimeout(() => {
-      l.debug?.("Rejecting connect resolver due to timeout");
+      lc.debug?.("Rejecting connect resolver due to timeout");
       this.#connectResolver.reject(new TimedOutError("Connect"));
-      this.#disconnect(l, {
+      this.#disconnect(lc, {
         client: "ConnectTimeout"
       });
     }, CONNECT_TIMEOUT_MS);
@@ -10389,7 +10527,7 @@ var Zero = class {
       this.#lastMutationIDReceived,
       wsid,
       this.#options.logLevel === "debug",
-      l,
+      lc,
       this.#options.push,
       this.#options.maxHeaderLength,
       additionalConnectParams
@@ -10409,7 +10547,7 @@ var Zero = class {
       this.#onPageHide
     );
     try {
-      l.debug?.("Waiting for connection to be acknowledged");
+      lc.debug?.("Waiting for connection to be acknowledged");
       await this.#connectResolver.promise;
       this.#mutationTracker.onConnected(this.#lastMutationIDReceived);
       this.#rep.push().catch(() => {
@@ -10422,11 +10560,11 @@ var Zero = class {
       );
     }
   }
-  #disconnect(l, reason, closeCode, closeReason) {
+  #disconnect(lc, reason, closeCode, closeReason) {
     if (this.#connectionState === Connecting) {
       this.#connectErrorCount++;
     }
-    l.info?.("disconnecting", {
+    lc.info?.("disconnecting", {
       navigatorOnline: localNavigator?.onLine,
       reason,
       connectStart: this.#connectStart,
@@ -10440,8 +10578,9 @@ var Zero = class {
     switch (this.#connectionState) {
       case Connected: {
         if (this.#connectStart !== void 0) {
-          l.error?.(
-            "disconnect() called while connected but connect start time is defined. This should not happen."
+          lc.error?.(
+            on_error_kind_enum_exports.InvalidState,
+            "disconnect() called while connected but connect start time is defined."
           );
         }
         break;
@@ -10456,18 +10595,22 @@ var Zero = class {
           );
         }
         if (this.#connectStart === void 0) {
-          l.error?.(
-            "disconnect() called while connecting but connect start time is undefined. This should not happen."
+          lc.error?.(
+            on_error_kind_enum_exports.InvalidState,
+            "disconnect() called while connecting but connect start time is undefined."
           );
         }
         break;
       }
       case Disconnected:
-        l.error?.("disconnect() called while disconnected");
+        lc.error?.(
+          on_error_kind_enum_exports.InvalidState,
+          "disconnect() called while disconnected"
+        );
         break;
     }
     this.#socketResolver = resolver8();
-    l.debug?.("Creating new connect resolver");
+    lc.debug?.("Creating new connect resolver");
     this.#connectResolver = resolver8();
     this.#setConnectionState(Disconnected);
     this.#messageCount = 0;
@@ -10645,7 +10788,7 @@ var Zero = class {
             break;
           }
           case Connecting:
-            lc.error?.("unreachable");
+            lc.error?.(on_error_kind_enum_exports.InvalidState);
             gotError = true;
             break;
           case Connected: {
@@ -10693,7 +10836,8 @@ var Zero = class {
       } catch (ex) {
         if (this.#connectionState !== Connected) {
           const level = isAuthError(ex) ? "warn" : "error";
-          lc[level]?.("Failed to connect", ex, {
+          const kind = isServerError(ex) ? ex.kind : on_error_kind_enum_exports.Unknown;
+          lc[level]?.(kind, "Failed to connect", ex, {
             lmid: this.#lastMutationIDReceived,
             baseCookie: this.#connectCookie
           });
@@ -10793,7 +10937,7 @@ var Zero = class {
           };
         }
         default:
-          assert(false, "unreachable");
+          unreachable();
       }
     } finally {
       pullResponseResolver.reject("timed out");
@@ -10820,8 +10964,8 @@ var Zero = class {
    * If it takes too long to get a pong we disconnect and this returns
    * {@linkcode PingResult.TimedOut}.
    */
-  async #ping(l, messageErrorRejectionPromise) {
-    l.debug?.("pinging");
+  async #ping(lc, messageErrorRejectionPromise) {
+    lc.debug?.("pinging");
     const { promise, resolve } = resolver8();
     this.#onPong = resolve;
     const pingMessage = ["ping", {}];
@@ -10835,13 +10979,13 @@ var Zero = class {
     ]) === 0;
     const delta = performance.now() - t0;
     if (!connected) {
-      l.info?.("ping failed in", delta, "ms - disconnecting");
-      this.#disconnect(l, {
+      lc.info?.("ping failed in", delta, "ms - disconnecting");
+      this.#disconnect(lc, {
         client: "PingTimeout"
       });
       return TimedOut;
     }
-    l.debug?.("ping succeeded in", delta, "ms");
+    lc.debug?.("ping succeeded in", delta, "ms");
     return Success;
   }
   // Sends a set of metrics to the server. Throws unless the server
@@ -10868,8 +11012,11 @@ var Zero = class {
    */
   async inspect() {
     BUNDLE_SIZE: {
-      const m = await import("./inspector-3FBM22O3.js");
-      return m.newInspector(this.#rep, this.#schema, () => this.#socket);
+      const m = await import("./inspector-T4TQPT2K.js");
+      return m.newInspector(this.#rep, this.#schema, async () => {
+        await this.#connectResolver.promise;
+        return this.#socket;
+      });
     }
   }
 };
@@ -10965,8 +11112,7 @@ var TimedOutError = class extends Error {
 };
 var CloseError = class extends Error {
 };
-function normalizeRunOptions2(options) {
-  return options ?? DEFAULT_RUN_OPTIONS_UNKNOWN;
+function assertValidRunOptions2(_options) {
 }
 
 export {
@@ -10976,6 +11122,7 @@ export {
   makeIDBName,
   dropDatabase,
   dropAllDatabases,
+  error_kind_enum_exports,
   relationships,
   table,
   string3 as string,
@@ -10989,6 +11136,8 @@ export {
   NOBODY_CAN,
   definePermissions,
   escapeLike,
+  update_needed_reason_type_enum_exports,
+  on_error_kind_enum_exports,
   Zero
 };
-//# sourceMappingURL=chunk-NIDZOMES.js.map
+//# sourceMappingURL=chunk-ZEL4YSUP.js.map