@rocicorp/zero 1.11.0-canary.3 → 1.11.0-canary.30

package/out/zero-client/src/client/mutator-proxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"mutator-proxy.js","names":["#lc","#connectionManager","#mutationTracker","#onConnectionStateChange","#mutationRejection","#makeZeroErrorResultDetails","#makeApplicationErrorResultDetails","#normalizeResultPromise"],"sources":["../../../../../zero-client/src/client/mutator-proxy.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport {unreachable} from '../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport type {ApplicationError} from '../../../zero-protocol/src/application-error.ts';\nimport {wrapWithApplicationError} from '../../../zero-protocol/src/application-error.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport type {\n  ConnectionManager,\n  ConnectionManagerState,\n} from './connection-manager.ts';\nimport {ConnectionStatus} from './connection-status.ts';\nimport type {\n  MutatorResult,\n  MutatorResultErrorDetails,\n  MutatorResultSuccessDetails,\n} from './custom.ts';\nimport {isZeroError, type ZeroError} from './error.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\n\nconst successResultDetails = {\n  type: 'success',\n} as const satisfies MutatorResultSuccessDetails;\nconst successResult = () => successResultDetails;\n\nfunction getStateDescription(error: ZeroError): string {\n  switch (error.kind) {\n    case ClientErrorKind.Offline:\n      return 'offline';\n    case ClientErrorKind.ClientClosed:\n      return 'closed';\n    default:\n      return 'in error state';\n  }\n}\n\ntype CachedMutationRejection = {\n  readonly error: ZeroError;\n  readonly promise: Promise<MutatorResultErrorDetails>;\n};\n\nexport class MutatorProxy {\n  readonly #lc: LogContext;\n  readonly #connectionManager: ConnectionManager;\n  readonly #mutationTracker: MutationTracker;\n  #mutationRejection: CachedMutationRejection | undefined;\n\n  constructor(\n    lc: LogContext,\n    connectionManager: ConnectionManager,\n    mutationTracker: MutationTracker,\n  ) {\n    this.#lc = lc;\n    this.#connectionManager = connectionManager;\n    this.#mutationTracker = mutationTracker;\n\n    this.#connectionManager.subscribe(state =>\n      this.#onConnectionStateChange(state),\n    );\n    this.#onConnectionStateChange(connectionManager.state);\n  }\n\n  get mutationRejectionError(): ZeroError | undefined {\n    return this.#mutationRejection?.error;\n  }\n\n  /**\n   * Called when the connection state changes.\n   *\n   * If the connection state is disconnected, error, or closed, the\n   * mutation rejection error is set and all outstanding `.server` promises in\n   * the mutation tracker are rejected with the error.\n   */\n  #onConnectionStateChange(state: ConnectionManagerState) {\n    // we short circuit the rejection if the error is due to a missing cacheURL\n    // this allows local writes to continue\n    if (\n      state.name === ConnectionStatus.Disconnected &&\n      state.reason.kind === ClientErrorKind.NoSocketOrigin\n    ) {\n      this.#mutationRejection = undefined;\n      return;\n    }\n\n    switch (state.name) {\n      case ConnectionStatus.Disconnected:\n      case ConnectionStatus.Error:\n      case ConnectionStatus.Closed:\n        this.#mutationRejection = {\n          error: state.reason,\n          promise: Promise.resolve(\n            this.#makeZeroErrorResultDetails(state.reason),\n          ),\n        };\n        this.#mutationTracker.rejectAllOutstandingMutations(state.reason);\n        break;\n      case ConnectionStatus.Connected:\n      case ConnectionStatus.Connecting:\n      case ConnectionStatus.NeedsAuth:\n        this.#mutationRejection = undefined;\n        return;\n      default:\n        unreachable(state);\n    }\n  }\n\n  wrapCustomMutator<\n    F extends (...args: [] | [ReadonlyJSONValue]) => {\n      client: Promise<unknown>;\n      server: Promise<unknown>;\n    },\n  >(name: string, f: F): (...args: Parameters<F>) => MutatorResult {\n    return (...args) => {\n      if (this.#mutationRejection) {\n        const error = this.#mutationRejection.error;\n        this.#lc.warn?.(\n          `Mutation \"${name}\" rejected because Zero is ${getStateDescription(error)}. Details: ${error.message}. See also: https://zero.rocicorp.dev/docs/connection.`,\n        );\n        return {\n          client: this.#mutationRejection.promise,\n          server: this.#mutationRejection.promise,\n        } as const satisfies MutatorResult;\n      }\n\n      let result: {\n        client: Promise<unknown>;\n        server: Promise<unknown>;\n      };\n\n      const cachedMutationPromises: Partial<\n        Record<'client' | 'server', Promise<MutatorResultErrorDetails>>\n      > = {};\n\n      const wrapErrorFor =\n        (origin: 'client' | 'server') =>\n        (error: unknown): Promise<MutatorResultErrorDetails> => {\n          const cachedPromise = cachedMutationPromises[origin];\n          if (cachedPromise) {\n            return cachedPromise;\n          }\n\n          if (isZeroError(error)) {\n            this.#lc.error?.(`Mutator \"${name}\" error on ${origin}`, error);\n\n            const zeroErrorPromise = this.#makeZeroErrorResultDetails(error);\n            cachedMutationPromises[origin] = zeroErrorPromise;\n            return zeroErrorPromise;\n          }\n\n          const applicationError = wrapWithApplicationError(error);\n          this.#lc.error?.(\n            `Mutator \"${name}\" app error on ${origin}`,\n            applicationError,\n          );\n\n          const applicationErrorPromise =\n            this.#makeApplicationErrorResultDetails(applicationError);\n          cachedMutationPromises[origin] = applicationErrorPromise;\n          return applicationErrorPromise;\n        };\n\n      try {\n        result = f(...args);\n      } catch (error) {\n        const clientPromise = wrapErrorFor('client')(error);\n        const serverPromise = wrapErrorFor('server')(error);\n\n        return {\n          client: clientPromise,\n          server: serverPromise,\n        } as const satisfies MutatorResult;\n      }\n\n      const client = this.#normalizeResultPromise(\n        result.client,\n        wrapErrorFor('client'),\n      );\n      const server = this.#normalizeResultPromise(\n        result.server,\n        wrapErrorFor('server'),\n      );\n\n      return {\n        client,\n        server,\n      };\n    };\n  }\n\n  #normalizeResultPromise(\n    promise: Promise<unknown>,\n    wrapError: (error: unknown) => Promise<MutatorResultErrorDetails>,\n  ) {\n    return promise.then<MutatorResultSuccessDetails, MutatorResultErrorDetails>(\n      successResult,\n      wrapError,\n    );\n  }\n\n  #makeZeroErrorResultDetails(zeroError: ZeroError) {\n    return Promise.resolve({\n      type: 'error',\n      error: {\n        type: 'zero',\n        message: zeroError.message,\n      },\n    } as const satisfies MutatorResultErrorDetails);\n  }\n\n  #makeApplicationErrorResultDetails(applicationError: ApplicationError) {\n    return Promise.resolve({\n      type: 'error',\n      error: {\n        type: 'app',\n        message: applicationError.message,\n        details: applicationError.details,\n      },\n    } as const satisfies MutatorResultErrorDetails);\n  }\n}\n"],"mappings":";;;;;;AAmBA,IAAM,uBAAuB,EAC3B,MAAM,UACR;AACA,IAAM,sBAAsB;AAE5B,SAAS,oBAAoB,OAA0B;CACrD,QAAQ,MAAM,MAAd;EACE,KAAK,SACH,OAAO;EACT,KAAK,cACH,OAAO;EACT,SACE,OAAO;CACX;AACF;AAOA,IAAa,eAAb,MAA0B;CACxB;CACA;CACA;CACA;CAEA,YACE,IACA,mBACA,iBACA;EACA,KAAKA,MAAM;EACX,KAAKC,qBAAqB;EAC1B,KAAKC,mBAAmB;EAExB,KAAKD,mBAAmB,WAAU,UAChC,KAAKE,yBAAyB,KAAK,CACrC;EACA,KAAKA,yBAAyB,kBAAkB,KAAK;CACvD;CAEA,IAAI,yBAAgD;EAClD,OAAO,KAAKC,oBAAoB;CAClC;;;;;;;;CASA,yBAAyB,OAA+B;EAGtD,IACE,MAAM,SAAS,kBACf,MAAM,OAAO,SAAS,kBACtB;GACA,KAAKA,qBAAqB,KAAA;GAC1B;EACF;EAEA,QAAQ,MAAM,MAAd;GACE,KAAK;GACL,KAAK;GACL,KAAK;IACH,KAAKA,qBAAqB;KACxB,OAAO,MAAM;KACb,SAAS,QAAQ,QACf,KAAKC,4BAA4B,MAAM,MAAM,CAC/C;IACF;IACA,KAAKH,iBAAiB,8BAA8B,MAAM,MAAM;IAChE;GACF,KAAK;GACL,KAAK;GACL,KAAK;IACH,KAAKE,qBAAqB,KAAA;IAC1B;GACF,SACE,YAAY,KAAK;EACrB;CACF;CAEA,kBAKE,MAAc,GAAiD;EAC/D,QAAQ,GAAG,SAAS;GAClB,IAAI,KAAKA,oBAAoB;IAC3B,MAAM,QAAQ,KAAKA,mBAAmB;IACtC,KAAKJ,IAAI,OACP,aAAa,KAAK,6BAA6B,oBAAoB,KAAK,EAAE,aAAa,MAAM,QAAQ,uDACvG;IACA,OAAO;KACL,QAAQ,KAAKI,mBAAmB;KAChC,QAAQ,KAAKA,mBAAmB;IAClC;GACF;GAEA,IAAI;GAKJ,MAAM,yBAEF,CAAC;GAEL,MAAM,gBACH,YACA,UAAuD;IACtD,MAAM,gBAAgB,uBAAuB;IAC7C,IAAI,eACF,OAAO;IAGT,IAAI,YAAY,KAAK,GAAG;KACtB,KAAKJ,IAAI,QAAQ,YAAY,KAAK,aAAa,UAAU,KAAK;KAE9D,MAAM,mBAAmB,KAAKK,4BAA4B,KAAK;KAC/D,uBAAuB,UAAU;KACjC,OAAO;IACT;IAEA,MAAM,mBAAmB,yBAAyB,KAAK;IACvD,KAAKL,IAAI,QACP,YAAY,KAAK,iBAAiB,UAClC,gBACF;IAEA,MAAM,0BACJ,KAAKM,mCAAmC,gBAAgB;IAC1D,uBAAuB,UAAU;IACjC,OAAO;GACT;GAEF,IAAI;IACF,SAAS,EAAE,GAAG,IAAI;GACpB,SAAS,OAAO;IAId,OAAO;KACL,QAJoB,aAAa,QAAQ,EAAE,KAInC;KACR,QAJoB,aAAa,QAAQ,EAAE,KAInC;IACV;GACF;GAWA,OAAO;IACL,QAVa,KAAKC,wBAClB,OAAO,QACP,aAAa,QAAQ,CAQrB;IACA,QAPa,KAAKA,wBAClB,OAAO,QACP,aAAa,QAAQ,CAKrB;GACF;EACF;CACF;CAEA,wBACE,SACA,WACA;EACA,OAAO,QAAQ,KACb,eACA,SACF;CACF;CAEA,4BAA4B,WAAsB;EAChD,OAAO,QAAQ,QAAQ;GACrB,MAAM;GACN,OAAO;IACL,MAAM;IACN,SAAS,UAAU;GACrB;EACF,CAA8C;CAChD;CAEA,mCAAmC,kBAAoC;EACrE,OAAO,QAAQ,QAAQ;GACrB,MAAM;GACN,OAAO;IACL,MAAM;IACN,SAAS,iBAAiB;IAC1B,SAAS,iBAAiB;GAC5B;EACF,CAA8C;CAChD;AACF"}
+{"version":3,"file":"mutator-proxy.js","names":["#lc","#connectionManager","#mutationTracker","#onConnectionStateChange","#mutationRejection","#makeZeroErrorResultDetails","#makeApplicationErrorResultDetails","#normalizeResultPromise"],"sources":["../../../../../zero-client/src/client/mutator-proxy.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport {getStorageFailure} from '../../../replicache/src/storage-failure.ts';\nimport {unreachable} from '../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport type {ApplicationError} from '../../../zero-protocol/src/application-error.ts';\nimport {wrapWithApplicationError} from '../../../zero-protocol/src/application-error.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport type {\n  ConnectionManager,\n  ConnectionManagerState,\n} from './connection-manager.ts';\nimport {ConnectionStatus} from './connection-status.ts';\nimport type {\n  MutatorResult,\n  MutatorResultErrorDetails,\n  MutatorResultSuccessDetails,\n} from './custom.ts';\nimport {isZeroError, type ZeroError} from './error.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\n\nconst successResult = (data: unknown): MutatorResultSuccessDetails => ({\n  type: 'success',\n  data: data as ReadonlyJSONValue | undefined,\n});\n\nfunction getStateDescription(error: ZeroError): string {\n  switch (error.kind) {\n    case ClientErrorKind.Offline:\n      return 'offline';\n    case ClientErrorKind.ClientClosed:\n      return 'closed';\n    default:\n      return 'in error state';\n  }\n}\n\ntype CachedMutationRejection = {\n  readonly error: ZeroError;\n  readonly promise: Promise<MutatorResultErrorDetails>;\n};\n\nexport class MutatorProxy {\n  readonly #lc: LogContext;\n  readonly #connectionManager: ConnectionManager;\n  readonly #mutationTracker: MutationTracker;\n  #mutationRejection: CachedMutationRejection | undefined;\n\n  constructor(\n    lc: LogContext,\n    connectionManager: ConnectionManager,\n    mutationTracker: MutationTracker,\n  ) {\n    this.#lc = lc;\n    this.#connectionManager = connectionManager;\n    this.#mutationTracker = mutationTracker;\n\n    this.#connectionManager.subscribe(state =>\n      this.#onConnectionStateChange(state),\n    );\n    this.#onConnectionStateChange(connectionManager.state);\n  }\n\n  get mutationRejectionError(): ZeroError | undefined {\n    return this.#mutationRejection?.error;\n  }\n\n  /**\n   * Called when the connection state changes.\n   *\n   * If the connection state is disconnected, error, or closed, the\n   * mutation rejection error is set and all outstanding `.server` promises in\n   * the mutation tracker are rejected with the error.\n   */\n  #onConnectionStateChange(state: ConnectionManagerState) {\n    // we short circuit the rejection if the error is due to a missing cacheURL\n    // this allows local writes to continue\n    if (\n      state.name === ConnectionStatus.Disconnected &&\n      state.reason.kind === ClientErrorKind.NoSocketOrigin\n    ) {\n      this.#mutationRejection = undefined;\n      return;\n    }\n\n    switch (state.name) {\n      case ConnectionStatus.Disconnected:\n      case ConnectionStatus.Error:\n      case ConnectionStatus.Closed:\n        this.#mutationRejection = {\n          error: state.reason,\n          promise: Promise.resolve(\n            this.#makeZeroErrorResultDetails(state.reason),\n          ),\n        };\n        this.#mutationTracker.rejectAllOutstandingMutations(state.reason);\n        break;\n      case ConnectionStatus.Initializing:\n      case ConnectionStatus.Connected:\n      case ConnectionStatus.Connecting:\n      case ConnectionStatus.NeedsAuth:\n        this.#mutationRejection = undefined;\n        return;\n      default:\n        unreachable(state);\n    }\n  }\n\n  wrapCustomMutator<\n    F extends (...args: [] | [ReadonlyJSONValue]) => {\n      client: Promise<unknown>;\n      server: Promise<unknown>;\n    },\n  >(name: string, f: F): (...args: Parameters<F>) => MutatorResult {\n    return (...args) => {\n      if (this.#mutationRejection) {\n        const error = this.#mutationRejection.error;\n        this.#lc.warn?.(\n          `Mutation \"${name}\" rejected because Zero is ${getStateDescription(error)}. Details: ${error.message}. See also: https://zero.rocicorp.dev/docs/connection.`,\n        );\n        return {\n          client: this.#mutationRejection.promise,\n          server: this.#mutationRejection.promise,\n        } as const satisfies MutatorResult;\n      }\n\n      let result: {\n        client: Promise<unknown>;\n        server: Promise<unknown>;\n      };\n\n      const cachedMutationPromises: Partial<\n        Record<'client' | 'server', Promise<MutatorResultErrorDetails>>\n      > = {};\n\n      const wrapErrorFor =\n        (origin: 'client' | 'server') =>\n        (error: unknown): Promise<MutatorResultErrorDetails> => {\n          const cachedPromise = cachedMutationPromises[origin];\n          if (cachedPromise) {\n            return cachedPromise;\n          }\n\n          if (isZeroError(error)) {\n            this.#lc.error?.(`Mutator \"${name}\" error on ${origin}`, error);\n\n            const zeroErrorPromise = this.#makeZeroErrorResultDetails(error);\n            cachedMutationPromises[origin] = zeroErrorPromise;\n            return zeroErrorPromise;\n          }\n\n          const applicationError = wrapWithApplicationError(error);\n          if (getStorageFailure(error) === undefined) {\n            this.#lc.error?.(\n              `Mutator \"${name}\" app error on ${origin}`,\n              applicationError,\n            );\n          } else {\n            // The local store's storage failed under the mutation. That is\n            // the device's condition, reported once through\n            // `onStorageFailure`, not the app's mutator throwing and not a\n            // developer's to fix.\n            this.#lc.warn?.(\n              `Mutator \"${name}\" storage failure on ${origin}`,\n              applicationError,\n            );\n          }\n\n          const applicationErrorPromise =\n            this.#makeApplicationErrorResultDetails(applicationError);\n          cachedMutationPromises[origin] = applicationErrorPromise;\n          return applicationErrorPromise;\n        };\n\n      try {\n        result = f(...args);\n      } catch (error) {\n        const clientPromise = wrapErrorFor('client')(error);\n        const serverPromise = wrapErrorFor('server')(error);\n\n        return {\n          client: clientPromise,\n          server: serverPromise,\n        } as const satisfies MutatorResult;\n      }\n\n      const client = this.#normalizeResultPromise(\n        result.client,\n        wrapErrorFor('client'),\n      );\n      const server = this.#normalizeResultPromise(\n        result.server,\n        wrapErrorFor('server'),\n      );\n\n      return {\n        client,\n        server,\n      };\n    };\n  }\n\n  #normalizeResultPromise(\n    promise: Promise<unknown>,\n    wrapError: (error: unknown) => Promise<MutatorResultErrorDetails>,\n  ) {\n    return promise.then<MutatorResultSuccessDetails, MutatorResultErrorDetails>(\n      successResult,\n      wrapError,\n    );\n  }\n\n  #makeZeroErrorResultDetails(zeroError: ZeroError) {\n    return Promise.resolve({\n      type: 'error',\n      error: {\n        type: 'zero',\n        message: zeroError.message,\n      },\n    } as const satisfies MutatorResultErrorDetails);\n  }\n\n  #makeApplicationErrorResultDetails(applicationError: ApplicationError) {\n    return Promise.resolve({\n      type: 'error',\n      error: {\n        type: 'app',\n        message: applicationError.message,\n        details: applicationError.details,\n      },\n    } as const satisfies MutatorResultErrorDetails);\n  }\n}\n"],"mappings":"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"}

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

@@ -1,5 +1,6 @@
 import type { LogLevel, LogSink } from '@rocicorp/logger';
 import type { StoreProvider } from '../../../replicache/src/kv/store.ts';
+import type { StorageFailureError } from '../../../replicache/src/storage-failure.ts';
 import * as v from '../../../shared/src/valita.ts';
 import type { BaseDefaultContext, BaseDefaultSchema, DefaultContext, DefaultSchema } from '../../../zero-types/src/default-types.ts';
 import type { AnyMutatorRegistry } from '../../../zql/src/mutate/mutator-registry.ts';
@@ -213,6 +214,9 @@ export type ZeroOptions<S extends BaseDefaultSchema = DefaultSchema, MD extends
      * - the local persistent synchronization state has been garbage collected.
      *   This can happen if the client has no pending mutations and has not been
      *   used for a while (e.g. the client's tab has been hidden for a long time).
+     * - the local persistent synchronization state was found to be corrupt.
+     *   Replicache tries to drop the local database so that a reload starts
+     *   fresh. The callback is called even if that fails.
      * - zero-cache fails to find the server side synchronization state for
      *   this client.
      * - zero-cache rejects this client's persisted synchronization state,
@@ -228,6 +232,35 @@ export type ZeroOptions<S extends BaseDefaultSchema = DefaultSchema, MD extends
      * Provide your own function to prevent this functionality.
      */
     onClientStateNotFound?: (() => void) | undefined;
+    /**
+     * `onStorageFailure` is called once, the first time the local persistent
+     * store reports that its storage has failed rather than its data, with the
+     * {@link StorageFailureError} it threw: the device is out of space
+     * (`full`), the database cannot be opened (`cannot-open`, including an
+     * IndexedDB that fails to open), or a read or write to it failed
+     * (`io-error`).
+     *
+     * A failure while this `Zero` instance is opening runs it on memory for the
+     * session, as with `kvStore: 'mem'`: nothing is written to disk. A failure
+     * after that stops persisting locally: queries and mutations keep running
+     * against what the in-memory dag holds, and mutations keep pushing to
+     * zero-cache, but nothing is written to disk until a new instance is
+     * created; a read that needs a chunk not yet loaded
+     * from the store (or since evicted from the in-memory cache) still fails
+     * the way any store read does, and is reported here too, whichever caller
+     * made it. An invalid ref count seen while the store is
+     * failing with `cannot-open` or `io-error` is not treated as corruption, so
+     * {@link onClientStateNotFound} is not called for it: a store that cannot
+     * complete its reads and writes produces such readings without the data
+     * being corrupt, and dropping the database would rebuild onto the same
+     * failing storage. A `full` disk keeps the drop, since deleting the database
+     * is also what frees the space.
+     *
+     * The default behavior is to log the failure and nothing else. Provide a
+     * function to show the user what to do — free up space, or restart the
+     * app once the storage is available again.
+     */
+    onStorageFailure?: ((failure: StorageFailureError) => void) | undefined;
     /**
      * The number of milliseconds to wait before disconnecting a Zero
      * instance whose tab has become hidden.

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"options.js","names":[],"sources":["../../../../../zero-client/src/client/options.ts"],"sourcesContent":["import type {LogLevel, LogSink} from '@rocicorp/logger';\nimport type {StoreProvider} from '../../../replicache/src/kv/store.ts';\nimport * as v from '../../../shared/src/valita.ts';\nimport type {\n  BaseDefaultContext,\n  BaseDefaultSchema,\n  DefaultContext,\n  DefaultSchema,\n} from '../../../zero-types/src/default-types.ts';\nimport type {AnyMutatorRegistry} from '../../../zql/src/mutate/mutator-registry.ts';\nimport type {CustomMutatorDefs} from './custom.ts';\nimport {UpdateNeededReasonType} from './update-needed-reason-type.ts';\n\n/**\n * Configuration for {@linkcode Zero}.\n */\nexport type ZeroOptions<\n  S extends BaseDefaultSchema = DefaultSchema,\n  MD extends CustomMutatorDefs | undefined = undefined,\n  C extends BaseDefaultContext = DefaultContext,\n> = {\n  /**\n   * URL to the zero-cache. This can be a simple hostname, e.g.\n   * - \"https://myapp-myteam.zero.ms\"\n   * or a prefix with a single path component, e.g.\n   * - \"https://myapp-myteam.zero.ms/zero\"\n   * - \"https://myapp-myteam.zero.ms/db\"\n   *\n   * The latter is useful for configuring routing rules (e.g. \"/zero/\\*\") when\n   * the zero-cache is hosted on the same domain as the application. **Note that\n   * only a single path segment is allowed (e.g. it cannot be \"/proxy/zero/\\*\")**.\n   */\n  cacheURL?: string | null | undefined;\n\n  /**\n   * @deprecated Use {@linkcode cacheURL} instead.\n   */\n  server?: string | null | undefined;\n\n  /**\n   * A token to identify and authenticate the user.\n   *\n   * Set `auth` to `null` or `undefined` if there is no logged in user.\n   *\n   * The call to `connect` is handled automatically by the ZeroProvider component\n   * for React and SolidJS when the `auth` prop changes.\n   *\n   * Transitions between authenticated and logged-out states recreate the Zero\n   * instance instead.\n   *\n   * When `auth` changes while connected, Zero refreshes server-side auth context\n   * and re-transforms queries without reconnecting.\n   *\n   * When a 401 or 403 HTTP status code is received from your server, Zero will\n   * transition to the `needs-auth` connection state. The app should call\n   * `zero.connection.connect({auth: newToken})` with a new token to reconnect.\n   */\n  auth?: string | null | undefined;\n\n  /**\n   * A unique identifier for the user.\n   *\n   * Omit this, or set to `null`, for logged-out clients.\n   *\n   * Each userID gets its own client-side storage so that the app can switch\n   * between users without losing state.\n   */\n  userID?: string | null | undefined;\n\n  /**\n   * Distinguishes the storage used by this Zero instance from that of other\n   * instances with the same userID. Useful in the case where the app wants to\n   * have multiple Zero instances for the same user for different parts of the\n   * app.\n   */\n  storageKey?: string | undefined;\n\n  /**\n   * Determines the level of detail at which Zero logs messages about\n   * its operation. Messages are logged to the `console`.\n   *\n   * When this is set to `'debug'`, `'info'` and `'error'` messages are also\n   * logged. When set to `'info'`, `'info'` and `'error'` but not\n   * `'debug'` messages are logged. When set to `'error'` only `'error'`\n   * messages are logged.\n   *\n   * Default is `'error'`.\n   */\n  logLevel?: LogLevel | undefined;\n\n  /**\n   * Destination for Zero's log output. When omitted, logs are written with\n   * `console.log`/`info`/`warn`/`error` etc.\n   *\n   * Provide a custom {@linkcode LogSink} to redirect logs — for example, to\n   * `process.stderr` in a CLI so that the tool's structured stdout output\n   * isn't polluted by log lines.\n   *\n   * Note: this overrides only the console sink. When analytics logging is\n   * enabled, the Datadog sink is still installed alongside this one.\n   */\n  logSink?: LogSink | undefined;\n\n  /**\n   * This defines the schema of the tables used in Zero and their relationships\n   * to one another.\n   */\n  schema: S;\n\n  /**\n   * `mutators` is a map of custom mutator definitions. The keys are\n   * namespaces or names of the mutators. The values are the mutator\n   * implementations. Client side mutators must be idempotent as a\n   * mutation can be rebased multiple times when folding in authoritative\n   * changes from the server to the client.\n   *\n   * Define mutators using the `defineMutator` function to create type-safe,\n   * parameterized mutations. Mutators can be top-level or grouped in namespaces.\n   *\n   * @example\n   * ```ts\n   * import {defineMutator} from '@rocicorp/zero';\n   *\n   * const z = new Zero({\n   *   schema,\n   *   userID,\n   *   mutators: {\n   *     // Top-level mutator\n   *     increment: defineMutator(({tx, args}: {tx: Transaction<Schema>, args: {id: string}}) =>\n   *       tx.mutate.counter.update({id: args.id, value: tx.query.counter.where('id', '=', args.id).value + 1})\n   *     ),\n   *     // Namespace with multiple mutators\n   *     issues: {\n   *       create: defineMutator(({tx, args}: {tx: Transaction<Schema>, args: {title: string}}) =>\n   *         tx.mutate.issues.insert({id: nanoid(), title: args.title, status: 'open'})\n   *       ),\n   *       close: defineMutator(({tx, args}: {tx: Transaction<Schema>, args: {id: string}}) =>\n   *         tx.mutate.issues.update({id: args.id, status: 'closed'})\n   *       ),\n   *     },\n   *   },\n   * });\n   *\n   * // Usage\n   * await z.mutate.increment({id: 'counter-1'}).client;\n   * await z.mutate.issues.create({title: 'New issue'}).client;\n   * await z.mutate.issues.close({id: 'issue-123'}).client;\n   * ```\n   */\n  mutators?: MD extends CustomMutatorDefs ? MD : AnyMutatorRegistry | undefined;\n\n  /**\n   * Custom URL for mutation requests sent to your API server.\n   * If not provided, uses the default configured in zero-cache.\n   */\n  mutateURL?: string | undefined;\n\n  /**\n   * Custom headers to include in mutation requests sent to your API server.\n   * These headers are passed through zero-cache to the mutate endpoint.\n   */\n  mutateHeaders?: Record<string, string> | undefined;\n\n  /**\n   * Custom URL for query requests sent to your API server.\n   * If not provided, uses the default configured in zero-cache.\n   *\n   * @deprecated Use {@linkcode queryURL} instead.\n   */\n  getQueriesURL?: string | undefined;\n\n  /**\n   * Custom URL for query requests sent to your API server.\n   * If not provided, uses the default configured in zero-cache.\n   */\n  queryURL?: string | undefined;\n\n  /**\n   * Custom headers to include in query requests sent to your API server.\n   * These headers are passed through zero-cache to the query endpoint.\n   */\n  queryHeaders?: Record<string, string> | undefined;\n\n  /**\n   * Optional callback that returns a W3C `traceparent` header value for\n   * distributed tracing. Called before sending WebSocket messages that\n   * trigger API server calls (`push`, `changeDesiredQueries`,\n   * `initConnection`).\n   *\n   * This enables end-to-end trace correlation from your frontend through\n   * zero-cache to your API server.\n   *\n   * @example\n   * ```ts\n   * import {propagation, context} from '@opentelemetry/api';\n   *\n   * new Zero({\n   *   getTraceparent: () => {\n   *     const carrier: Record<string, string> = {};\n   *     propagation.inject(context.active(), carrier);\n   *     return carrier.traceparent;\n   *   },\n   * });\n   * ```\n   */\n  getTraceparent?: (() => string | undefined) | undefined;\n\n  /**\n   * `onOnlineChange` is called when the Zero instance's online status changes.\n   *\n   * @deprecated Use {@linkcode Connection.state.subscribe} on the Zero instance instead. e.g.\n   * ```ts\n   * const zero = new Zero({...});\n   * zero.connection.state.subscribe((state) => {\n   *   console.log('Connection state:', state.name);\n   * });\n   * ```\n   *\n   * Or use a hook like {@linkcode useConnectionState} to subscribe to state changes.\n   */\n  onOnlineChange?: ((online: boolean) => void) | undefined;\n\n  /**\n   * `onUpdateNeeded` is called when a client code update is needed.\n   *\n   * See {@link UpdateNeededReason} for why updates can be needed.\n   *\n   * The default behavior is to reload the page (using `location.reload()`).\n   * Provide your own function to prevent the page from\n   * reloading automatically. You may want to display a toast to inform the end\n   * user there is a new version of your app available and prompt them to\n   * refresh.\n   */\n  onUpdateNeeded?: ((reason: UpdateNeededReason) => void) | undefined;\n\n  /**\n   * `onClientStateNotFound` is called when this client is no longer able\n   * to sync with zero-cache due to missing synchronization state. This\n   * can be because:\n   * - the local persistent synchronization state has been garbage collected.\n   *   This can happen if the client has no pending mutations and has not been\n   *   used for a while (e.g. the client's tab has been hidden for a long time).\n   * - zero-cache fails to find the server side synchronization state for\n   *   this client.\n   * - zero-cache rejects this client's persisted synchronization state,\n   *   requiring the local Replicache database to be reset.\n   *\n   * The current `Zero` instance should be treated as dead and replaced, not\n   * reconnected.\n   *\n   * The default behavior for the Zero client is to reload the page\n   * (using `location.reload()`). The React and SolidJS providers will replace\n   * the client in-place, without a full page reload.\n   *\n   * Provide your own function to prevent this functionality.\n   */\n  onClientStateNotFound?: (() => void) | undefined;\n\n  /**\n   * The number of milliseconds to wait before disconnecting a Zero\n   * instance whose tab has become hidden.\n   *\n   * Instances in hidden tabs are disconnected to save resources.\n   *\n   * Default is 5 minutes.\n   */\n  hiddenTabDisconnectDelay?: number | undefined;\n\n  /**\n   * The number of milliseconds to wait before disconnecting a Zero\n   * instance when the connection to the server has timed out.\n   *\n   * Default is 1 minute.\n   */\n  disconnectTimeoutMs?: number | undefined;\n\n  /**\n   * The timeout in milliseconds for ping operations. This value is used for:\n   * - How long to wait in idle before sending a ping to the server\n   * - How long to wait for a pong response after sending a ping\n   *\n   * Total time to detect a dead connection is 2 × pingTimeoutMs.\n   *\n   * Default is 5_000.\n   */\n  pingTimeoutMs?: number | undefined;\n\n  /**\n   * Determines what kind of storage implementation to use on the client.\n   *\n   * Defaults to `'idb'` which means that Zero uses an IndexedDB storage\n   * implementation. This allows the data to be persisted on the client and\n   * enables faster syncs between application restarts.\n   *\n   * By setting this to `'mem'`, Zero uses an in memory storage and\n   * the data is not persisted on the client.\n   *\n   * You can also set this to a function that is used to create new KV stores,\n   * allowing a custom implementation of the underlying storage layer.\n   */\n  kvStore?: 'mem' | 'idb' | StoreProvider | undefined;\n\n  /**\n   * The maximum number of bytes to allow in a single header.\n   *\n   * Zero adds some extra information to headers on initialization if possible.\n   * This speeds up data synchronization. This number should be kept less than\n   * or equal to the maximum header size allowed by the zero-cache and any load\n   * balancers.\n   *\n   * Default value: 8kb.\n   */\n  maxHeaderLength?: number | undefined;\n\n  /**\n   * The maximum amount of milliseconds to wait for a materialization to\n   * complete (including network/server time) before printing a warning to the\n   * console.\n   *\n   * Default value: 5_000.\n   */\n  slowMaterializeThreshold?: number | undefined;\n\n  /**\n   * UI rendering libraries will often provide a utility for batching multiple\n   * state updates into a single render. Some examples are React's\n   * `unstable_batchedUpdates`, and solid-js's `batch`.\n   *\n   * This option enables integrating these batch utilities with Zero.\n   *\n   * When `batchViewUpdates` is provided, Zero will call it whenever\n   * it updates query view state with an `applyViewUpdates` function\n   * that performs the actual state updates.\n   *\n   * Zero updates query view state when:\n   * 1. creating a new view\n   * 2. updating all existing queries' views to a new consistent state\n   *\n   * When creating a new view, that single view's creation will be wrapped\n   * in a `batchViewUpdates` call.\n   *\n   * When updating existing queries, all queries will be updated in a single\n   * `batchViewUpdates` call, so that the transition to the new consistent\n   * state can be done in a single render.\n   *\n   * Implementations must always call `applyViewUpdates` synchronously.\n   */\n  batchViewUpdates?: ((applyViewUpdates: () => void) => void) | undefined;\n\n  /**\n   * The maximum number of recent queries, no longer subscribed to by a preload\n   * or view, to continue syncing.\n   *\n   * Defaults is 0.\n   *\n   * @deprecated Use ttl instead\n   */\n  maxRecentQueries?: number | undefined;\n\n  /**\n   * Changes to queries are sent to server in batches. This option controls\n   * the number of milliseconds to wait before sending the next batch.\n   *\n   * Defaults is 10.\n   */\n  queryChangeThrottleMs?: number | undefined;\n\n  /**\n   * Context is passed to queries when they are executed.\n   */\n  context?: C | undefined;\n} & (unknown extends DefaultContext\n  ? {}\n  : {\n      context: C;\n    });\n\n/**\n * @deprecated Use {@link ZeroOptions} instead.\n */\nexport type ZeroAdvancedOptions<\n  S extends BaseDefaultSchema,\n  MD extends CustomMutatorDefs | undefined,\n  Context extends BaseDefaultContext,\n> = ZeroOptions<S, MD, Context>;\n\ntype UpdateNeededReasonBase = {\n  message?: string;\n};\n\nexport type UpdateNeededReason =\n  | ({type: UpdateNeededReasonType.NewClientGroup} & UpdateNeededReasonBase)\n  | ({\n      type: UpdateNeededReasonType.VersionNotSupported;\n    } & UpdateNeededReasonBase)\n  | ({\n      type: UpdateNeededReasonType.SchemaVersionNotSupported;\n    } & UpdateNeededReasonBase);\n\nexport const updateNeededReasonTypeSchema: v.Type<UpdateNeededReason['type']> =\n  v.literalUnion(\n    UpdateNeededReasonType.NewClientGroup,\n    UpdateNeededReasonType.VersionNotSupported,\n    UpdateNeededReasonType.SchemaVersionNotSupported,\n  );\n"],"mappings":";;;AA+YA,IAAa,+BACX,aACE,gBACA,qBACA,yBACF"}
+{"version":3,"file":"options.js","names":[],"sources":["../../../../../zero-client/src/client/options.ts"],"sourcesContent":["import type {LogLevel, LogSink} from '@rocicorp/logger';\nimport type {StoreProvider} from '../../../replicache/src/kv/store.ts';\nimport type {StorageFailureError} from '../../../replicache/src/storage-failure.ts';\nimport * as v from '../../../shared/src/valita.ts';\nimport type {\n  BaseDefaultContext,\n  BaseDefaultSchema,\n  DefaultContext,\n  DefaultSchema,\n} from '../../../zero-types/src/default-types.ts';\nimport type {AnyMutatorRegistry} from '../../../zql/src/mutate/mutator-registry.ts';\nimport type {CustomMutatorDefs} from './custom.ts';\nimport {UpdateNeededReasonType} from './update-needed-reason-type.ts';\n\n/**\n * Configuration for {@linkcode Zero}.\n */\nexport type ZeroOptions<\n  S extends BaseDefaultSchema = DefaultSchema,\n  MD extends CustomMutatorDefs | undefined = undefined,\n  C extends BaseDefaultContext = DefaultContext,\n> = {\n  /**\n   * URL to the zero-cache. This can be a simple hostname, e.g.\n   * - \"https://myapp-myteam.zero.ms\"\n   * or a prefix with a single path component, e.g.\n   * - \"https://myapp-myteam.zero.ms/zero\"\n   * - \"https://myapp-myteam.zero.ms/db\"\n   *\n   * The latter is useful for configuring routing rules (e.g. \"/zero/\\*\") when\n   * the zero-cache is hosted on the same domain as the application. **Note that\n   * only a single path segment is allowed (e.g. it cannot be \"/proxy/zero/\\*\")**.\n   */\n  cacheURL?: string | null | undefined;\n\n  /**\n   * @deprecated Use {@linkcode cacheURL} instead.\n   */\n  server?: string | null | undefined;\n\n  /**\n   * A token to identify and authenticate the user.\n   *\n   * Set `auth` to `null` or `undefined` if there is no logged in user.\n   *\n   * The call to `connect` is handled automatically by the ZeroProvider component\n   * for React and SolidJS when the `auth` prop changes.\n   *\n   * Transitions between authenticated and logged-out states recreate the Zero\n   * instance instead.\n   *\n   * When `auth` changes while connected, Zero refreshes server-side auth context\n   * and re-transforms queries without reconnecting.\n   *\n   * When a 401 or 403 HTTP status code is received from your server, Zero will\n   * transition to the `needs-auth` connection state. The app should call\n   * `zero.connection.connect({auth: newToken})` with a new token to reconnect.\n   */\n  auth?: string | null | undefined;\n\n  /**\n   * A unique identifier for the user.\n   *\n   * Omit this, or set to `null`, for logged-out clients.\n   *\n   * Each userID gets its own client-side storage so that the app can switch\n   * between users without losing state.\n   */\n  userID?: string | null | undefined;\n\n  /**\n   * Distinguishes the storage used by this Zero instance from that of other\n   * instances with the same userID. Useful in the case where the app wants to\n   * have multiple Zero instances for the same user for different parts of the\n   * app.\n   */\n  storageKey?: string | undefined;\n\n  /**\n   * Determines the level of detail at which Zero logs messages about\n   * its operation. Messages are logged to the `console`.\n   *\n   * When this is set to `'debug'`, `'info'` and `'error'` messages are also\n   * logged. When set to `'info'`, `'info'` and `'error'` but not\n   * `'debug'` messages are logged. When set to `'error'` only `'error'`\n   * messages are logged.\n   *\n   * Default is `'error'`.\n   */\n  logLevel?: LogLevel | undefined;\n\n  /**\n   * Destination for Zero's log output. When omitted, logs are written with\n   * `console.log`/`info`/`warn`/`error` etc.\n   *\n   * Provide a custom {@linkcode LogSink} to redirect logs — for example, to\n   * `process.stderr` in a CLI so that the tool's structured stdout output\n   * isn't polluted by log lines.\n   *\n   * Note: this overrides only the console sink. When analytics logging is\n   * enabled, the Datadog sink is still installed alongside this one.\n   */\n  logSink?: LogSink | undefined;\n\n  /**\n   * This defines the schema of the tables used in Zero and their relationships\n   * to one another.\n   */\n  schema: S;\n\n  /**\n   * `mutators` is a map of custom mutator definitions. The keys are\n   * namespaces or names of the mutators. The values are the mutator\n   * implementations. Client side mutators must be idempotent as a\n   * mutation can be rebased multiple times when folding in authoritative\n   * changes from the server to the client.\n   *\n   * Define mutators using the `defineMutator` function to create type-safe,\n   * parameterized mutations. Mutators can be top-level or grouped in namespaces.\n   *\n   * @example\n   * ```ts\n   * import {defineMutator} from '@rocicorp/zero';\n   *\n   * const z = new Zero({\n   *   schema,\n   *   userID,\n   *   mutators: {\n   *     // Top-level mutator\n   *     increment: defineMutator(({tx, args}: {tx: Transaction<Schema>, args: {id: string}}) =>\n   *       tx.mutate.counter.update({id: args.id, value: tx.query.counter.where('id', '=', args.id).value + 1})\n   *     ),\n   *     // Namespace with multiple mutators\n   *     issues: {\n   *       create: defineMutator(({tx, args}: {tx: Transaction<Schema>, args: {title: string}}) =>\n   *         tx.mutate.issues.insert({id: nanoid(), title: args.title, status: 'open'})\n   *       ),\n   *       close: defineMutator(({tx, args}: {tx: Transaction<Schema>, args: {id: string}}) =>\n   *         tx.mutate.issues.update({id: args.id, status: 'closed'})\n   *       ),\n   *     },\n   *   },\n   * });\n   *\n   * // Usage\n   * await z.mutate.increment({id: 'counter-1'}).client;\n   * await z.mutate.issues.create({title: 'New issue'}).client;\n   * await z.mutate.issues.close({id: 'issue-123'}).client;\n   * ```\n   */\n  mutators?: MD extends CustomMutatorDefs ? MD : AnyMutatorRegistry | undefined;\n\n  /**\n   * Custom URL for mutation requests sent to your API server.\n   * If not provided, uses the default configured in zero-cache.\n   */\n  mutateURL?: string | undefined;\n\n  /**\n   * Custom headers to include in mutation requests sent to your API server.\n   * These headers are passed through zero-cache to the mutate endpoint.\n   */\n  mutateHeaders?: Record<string, string> | undefined;\n\n  /**\n   * Custom URL for query requests sent to your API server.\n   * If not provided, uses the default configured in zero-cache.\n   *\n   * @deprecated Use {@linkcode queryURL} instead.\n   */\n  getQueriesURL?: string | undefined;\n\n  /**\n   * Custom URL for query requests sent to your API server.\n   * If not provided, uses the default configured in zero-cache.\n   */\n  queryURL?: string | undefined;\n\n  /**\n   * Custom headers to include in query requests sent to your API server.\n   * These headers are passed through zero-cache to the query endpoint.\n   */\n  queryHeaders?: Record<string, string> | undefined;\n\n  /**\n   * Optional callback that returns a W3C `traceparent` header value for\n   * distributed tracing. Called before sending WebSocket messages that\n   * trigger API server calls (`push`, `changeDesiredQueries`,\n   * `initConnection`).\n   *\n   * This enables end-to-end trace correlation from your frontend through\n   * zero-cache to your API server.\n   *\n   * @example\n   * ```ts\n   * import {propagation, context} from '@opentelemetry/api';\n   *\n   * new Zero({\n   *   getTraceparent: () => {\n   *     const carrier: Record<string, string> = {};\n   *     propagation.inject(context.active(), carrier);\n   *     return carrier.traceparent;\n   *   },\n   * });\n   * ```\n   */\n  getTraceparent?: (() => string | undefined) | undefined;\n\n  /**\n   * `onOnlineChange` is called when the Zero instance's online status changes.\n   *\n   * @deprecated Use {@linkcode Connection.state.subscribe} on the Zero instance instead. e.g.\n   * ```ts\n   * const zero = new Zero({...});\n   * zero.connection.state.subscribe((state) => {\n   *   console.log('Connection state:', state.name);\n   * });\n   * ```\n   *\n   * Or use a hook like {@linkcode useConnectionState} to subscribe to state changes.\n   */\n  onOnlineChange?: ((online: boolean) => void) | undefined;\n\n  /**\n   * `onUpdateNeeded` is called when a client code update is needed.\n   *\n   * See {@link UpdateNeededReason} for why updates can be needed.\n   *\n   * The default behavior is to reload the page (using `location.reload()`).\n   * Provide your own function to prevent the page from\n   * reloading automatically. You may want to display a toast to inform the end\n   * user there is a new version of your app available and prompt them to\n   * refresh.\n   */\n  onUpdateNeeded?: ((reason: UpdateNeededReason) => void) | undefined;\n\n  /**\n   * `onClientStateNotFound` is called when this client is no longer able\n   * to sync with zero-cache due to missing synchronization state. This\n   * can be because:\n   * - the local persistent synchronization state has been garbage collected.\n   *   This can happen if the client has no pending mutations and has not been\n   *   used for a while (e.g. the client's tab has been hidden for a long time).\n   * - the local persistent synchronization state was found to be corrupt.\n   *   Replicache tries to drop the local database so that a reload starts\n   *   fresh. The callback is called even if that fails.\n   * - zero-cache fails to find the server side synchronization state for\n   *   this client.\n   * - zero-cache rejects this client's persisted synchronization state,\n   *   requiring the local Replicache database to be reset.\n   *\n   * The current `Zero` instance should be treated as dead and replaced, not\n   * reconnected.\n   *\n   * The default behavior for the Zero client is to reload the page\n   * (using `location.reload()`). The React and SolidJS providers will replace\n   * the client in-place, without a full page reload.\n   *\n   * Provide your own function to prevent this functionality.\n   */\n  onClientStateNotFound?: (() => void) | undefined;\n\n  /**\n   * `onStorageFailure` is called once, the first time the local persistent\n   * store reports that its storage has failed rather than its data, with the\n   * {@link StorageFailureError} it threw: the device is out of space\n   * (`full`), the database cannot be opened (`cannot-open`, including an\n   * IndexedDB that fails to open), or a read or write to it failed\n   * (`io-error`).\n   *\n   * A failure while this `Zero` instance is opening runs it on memory for the\n   * session, as with `kvStore: 'mem'`: nothing is written to disk. A failure\n   * after that stops persisting locally: queries and mutations keep running\n   * against what the in-memory dag holds, and mutations keep pushing to\n   * zero-cache, but nothing is written to disk until a new instance is\n   * created; a read that needs a chunk not yet loaded\n   * from the store (or since evicted from the in-memory cache) still fails\n   * the way any store read does, and is reported here too, whichever caller\n   * made it. An invalid ref count seen while the store is\n   * failing with `cannot-open` or `io-error` is not treated as corruption, so\n   * {@link onClientStateNotFound} is not called for it: a store that cannot\n   * complete its reads and writes produces such readings without the data\n   * being corrupt, and dropping the database would rebuild onto the same\n   * failing storage. A `full` disk keeps the drop, since deleting the database\n   * is also what frees the space.\n   *\n   * The default behavior is to log the failure and nothing else. Provide a\n   * function to show the user what to do — free up space, or restart the\n   * app once the storage is available again.\n   */\n  onStorageFailure?: ((failure: StorageFailureError) => void) | undefined;\n\n  /**\n   * The number of milliseconds to wait before disconnecting a Zero\n   * instance whose tab has become hidden.\n   *\n   * Instances in hidden tabs are disconnected to save resources.\n   *\n   * Default is 5 minutes.\n   */\n  hiddenTabDisconnectDelay?: number | undefined;\n\n  /**\n   * The number of milliseconds to wait before disconnecting a Zero\n   * instance when the connection to the server has timed out.\n   *\n   * Default is 1 minute.\n   */\n  disconnectTimeoutMs?: number | undefined;\n\n  /**\n   * The timeout in milliseconds for ping operations. This value is used for:\n   * - How long to wait in idle before sending a ping to the server\n   * - How long to wait for a pong response after sending a ping\n   *\n   * Total time to detect a dead connection is 2 × pingTimeoutMs.\n   *\n   * Default is 5_000.\n   */\n  pingTimeoutMs?: number | undefined;\n\n  /**\n   * Determines what kind of storage implementation to use on the client.\n   *\n   * Defaults to `'idb'` which means that Zero uses an IndexedDB storage\n   * implementation. This allows the data to be persisted on the client and\n   * enables faster syncs between application restarts.\n   *\n   * By setting this to `'mem'`, Zero uses an in memory storage and\n   * the data is not persisted on the client.\n   *\n   * You can also set this to a function that is used to create new KV stores,\n   * allowing a custom implementation of the underlying storage layer.\n   */\n  kvStore?: 'mem' | 'idb' | StoreProvider | undefined;\n\n  /**\n   * The maximum number of bytes to allow in a single header.\n   *\n   * Zero adds some extra information to headers on initialization if possible.\n   * This speeds up data synchronization. This number should be kept less than\n   * or equal to the maximum header size allowed by the zero-cache and any load\n   * balancers.\n   *\n   * Default value: 8kb.\n   */\n  maxHeaderLength?: number | undefined;\n\n  /**\n   * The maximum amount of milliseconds to wait for a materialization to\n   * complete (including network/server time) before printing a warning to the\n   * console.\n   *\n   * Default value: 5_000.\n   */\n  slowMaterializeThreshold?: number | undefined;\n\n  /**\n   * UI rendering libraries will often provide a utility for batching multiple\n   * state updates into a single render. Some examples are React's\n   * `unstable_batchedUpdates`, and solid-js's `batch`.\n   *\n   * This option enables integrating these batch utilities with Zero.\n   *\n   * When `batchViewUpdates` is provided, Zero will call it whenever\n   * it updates query view state with an `applyViewUpdates` function\n   * that performs the actual state updates.\n   *\n   * Zero updates query view state when:\n   * 1. creating a new view\n   * 2. updating all existing queries' views to a new consistent state\n   *\n   * When creating a new view, that single view's creation will be wrapped\n   * in a `batchViewUpdates` call.\n   *\n   * When updating existing queries, all queries will be updated in a single\n   * `batchViewUpdates` call, so that the transition to the new consistent\n   * state can be done in a single render.\n   *\n   * Implementations must always call `applyViewUpdates` synchronously.\n   */\n  batchViewUpdates?: ((applyViewUpdates: () => void) => void) | undefined;\n\n  /**\n   * The maximum number of recent queries, no longer subscribed to by a preload\n   * or view, to continue syncing.\n   *\n   * Defaults is 0.\n   *\n   * @deprecated Use ttl instead\n   */\n  maxRecentQueries?: number | undefined;\n\n  /**\n   * Changes to queries are sent to server in batches. This option controls\n   * the number of milliseconds to wait before sending the next batch.\n   *\n   * Defaults is 10.\n   */\n  queryChangeThrottleMs?: number | undefined;\n\n  /**\n   * Context is passed to queries when they are executed.\n   */\n  context?: C | undefined;\n} & (unknown extends DefaultContext\n  ? {}\n  : {\n      context: C;\n    });\n\n/**\n * @deprecated Use {@link ZeroOptions} instead.\n */\nexport type ZeroAdvancedOptions<\n  S extends BaseDefaultSchema,\n  MD extends CustomMutatorDefs | undefined,\n  Context extends BaseDefaultContext,\n> = ZeroOptions<S, MD, Context>;\n\ntype UpdateNeededReasonBase = {\n  message?: string;\n};\n\nexport type UpdateNeededReason =\n  | ({type: UpdateNeededReasonType.NewClientGroup} & UpdateNeededReasonBase)\n  | ({\n      type: UpdateNeededReasonType.VersionNotSupported;\n    } & UpdateNeededReasonBase)\n  | ({\n      type: UpdateNeededReasonType.SchemaVersionNotSupported;\n    } & UpdateNeededReasonBase);\n\nexport const updateNeededReasonTypeSchema: v.Type<UpdateNeededReason['type']> =\n  v.literalUnion(\n    UpdateNeededReasonType.NewClientGroup,\n    UpdateNeededReasonType.VersionNotSupported,\n    UpdateNeededReasonType.SchemaVersionNotSupported,\n  );\n"],"mappings":";;;AAibA,IAAa,+BACX,aACE,gBACA,qBACA,yBACF"}

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

@@ -18,6 +18,15 @@ import type { InspectorDelegate } from './inspector/inspector.ts';
 import type { QueryClientMetrics } from './inspector/lazy-inspector.ts';
 import type { MutationTracker } from './mutation-tracker.ts';
 import type { ReadTransaction } from './replicache-types.ts';
+/**
+ * Client query updates are timed for only the first of every
+ * UPDATE_SAMPLE_RATE pushes to each source connection (see the
+ * MeasurePushOperator that ZeroContext adds), so each reported
+ * `query-update-client` time is recorded with this weight. Timing and
+ * recording every push is a noticeable cost when applying a large sync on
+ * React Native, for numbers only the inspector reads.
+ */
+export declare const UPDATE_SAMPLE_RATE = 32;
 type ClientMetric = {
     [K in keyof ClientMetricMap]: TDigest;
 };

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

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

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

@@ -1,4 +1,5 @@
 import { assert, unreachable } from "../../../shared/src/asserts.js";
+import { getOrInsertComputed } from "../../../shared/src/map.js";
 import { must } from "../../../shared/src/must.js";
 import { mapAST, normalizeAST } from "../../../zero-protocol/src/ast.js";
 import { clientToServer, serverToClient } from "../../../zero-schema/src/name-mapper.js";
@@ -13,7 +14,6 @@ import { clampTTL, compareTTL } from "../../../zql/src/query/ttl.js";
 import { desiredQueriesPrefixForClient } from "./keys.js";
 import { difference } from "../../../shared/src/set-utils.js";
 import { TDigest } from "../../../shared/src/tdigest.js";
-//#region ../zero-client/src/client/query-manager.ts
 /**
 * Tracks what queries the client is currently subscribed to on the server.
 * Sends `changeDesiredQueries` message to server when this changes.
@@ -30,6 +30,8 @@ var QueryManager = class {
 	#recentQueries = /* @__PURE__ */ new Set();
 	#gotQueries = /* @__PURE__ */ new Set();
 	#gotQueriesAuthoritative = false;
+	#cachedQueries = /* @__PURE__ */ new Set();
+	#awaitingPersistedGotDiff = true;
 	#mutationTracker;
 	#pendingQueryChanges = [];
 	#queryChangeThrottleMs;
@@ -59,19 +61,32 @@ var QueryManager = class {
 			for (const removal of pendingRemovals) removal();
 		});
 		experimentalWatch((diff) => {
+			const persisted = this.#awaitingPersistedGotDiff;
+			this.#awaitingPersistedGotDiff = false;
+			let thrown;
+			const fire = (queryHash, got) => {
+				const e = this.#fireGotCallbacks(queryHash, got);
+				thrown ??= e;
+			};
 			for (const diffOp of diff) {
 				const queryHash = diffOp.key.substring(2);
 				switch (diffOp.op) {
 					case "add":
 						this.#gotQueries.add(queryHash);
-						if (this.#gotQueriesAuthoritative) this.#fireGotCallbacks(queryHash, true);
+						if (this.#gotQueriesAuthoritative) fire(queryHash, true);
+						else if (persisted) {
+							this.#cachedQueries.add(queryHash);
+							fire(queryHash, "cached");
+						}
 						break;
 					case "del":
 						this.#gotQueries.delete(queryHash);
-						this.#fireGotCallbacks(queryHash, false);
+						this.#cachedQueries.delete(queryHash);
+						fire(queryHash, false);
 						break;
 				}
 			}
+			if (thrown) throw thrown.error;
 		}, {
 			prefix: "g/",
 			initialValuesInFirstDiff: true
@@ -87,9 +102,21 @@ var QueryManager = class {
 	mapClientASTToServer(ast) {
 		return mapAST(ast, this.#clientToServer);
 	}
+	/**
+	* Notifies every subscriber of the query. A throwing subscriber does not
+	* keep the others from being notified; the first error is returned so the
+	* caller can rethrow it once its own bookkeeping is consistent.
+	*/
 	#fireGotCallbacks(queryHash, got) {
-		const gotCallbacks = this.#queries.get(queryHash)?.gotCallbacks ?? [];
-		for (const gotCallback of gotCallbacks) gotCallback(got);
+		const entry = this.#queries.get(queryHash);
+		if (!entry) return;
+		let thrown;
+		for (const gotCallback of [...entry.gotCallbacks]) try {
+			gotCallback(got);
+		} catch (error) {
+			thrown ??= { error };
+		}
+		return thrown;
 	}
 	/**
 	* Trust `#gotQueries`. Called once the first poke after a (re)connect has
@@ -101,11 +128,20 @@ var QueryManager = class {
 	markGotQueriesAuthoritative() {
 		if (this.#gotQueriesAuthoritative) return;
 		this.#gotQueriesAuthoritative = true;
-		for (const queryHash of this.#queries.keys()) if (this.#gotQueries.has(queryHash)) this.#fireGotCallbacks(queryHash, true);
+		this.#cachedQueries.clear();
+		this.#awaitingPersistedGotDiff = false;
+		let thrown;
+		for (const queryHash of this.#queries.keys()) if (this.#gotQueries.has(queryHash)) {
+			const e = this.#fireGotCallbacks(queryHash, true);
+			thrown ??= e;
+		}
+		if (thrown) throw thrown.error;
 	}
 	/** Called on disconnect. The next connect must re-confirm `#gotQueries`. */
 	clearGotQueriesAuthoritative() {
+		if (!this.#gotQueriesAuthoritative) return;
 		this.#gotQueriesAuthoritative = false;
+		for (const queryHash of this.#gotQueries) this.#cachedQueries.add(queryHash);
 	}
 	/**
 	* Get the queries that need to be registered with the server.
@@ -220,7 +256,7 @@ var QueryManager = class {
 			this.#updateEntry(entry, queryId, ttl);
 			if (gotCallback) entry.gotCallbacks.push(gotCallback);
 		}
-		if (gotCallback) gotCallback(this.#gotQueriesAuthoritative && this.#gotQueries.has(queryId));
+		if (gotCallback) gotCallback(this.#gotQueriesAuthoritative ? this.#gotQueries.has(queryId) : this.#cachedQueries.has(queryId) && "cached");
 		let removed = false;
 		const cleanupCb = () => {
 			if (removed) return;
@@ -307,21 +343,18 @@ var QueryManager = class {
 		return this.#metrics;
 	}
 	addMetric(metric, value, ...args) {
-		this.#metrics[metric].add(value);
+		const weight = metric === "query-update-client" ? 32 : 1;
+		this.#metrics[metric].add(value, weight);
 		const queryID = args[0];
 		if (metric === "query-materialization-end-to-end") {
 			const ast = args[1];
 			if (this.#slowMaterializeThreshold !== void 0 && value > this.#slowMaterializeThreshold) this.#lc.warn?.("Slow query materialization (including server/network)", queryID, ast, value);
 			else this.#lc.debug?.("Materialized query (including server/network)", queryID, ast, value);
 		}
-		let existing = this.#queryMetrics.get(queryID);
-		if (!existing) {
-			existing = newPerQueryMetrics();
-			this.#queryMetrics.set(queryID, existing);
-		}
+		const existing = getOrInsertComputed(this.#queryMetrics, queryID, newPerQueryMetrics);
 		switch (metric) {
 			case "query-update-client":
-				existing["query-update-client"].add(value);
+				existing["query-update-client"].add(value, weight);
 				break;
 			case "query-materialization-client":
 			case "query-materialization-end-to-end":

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

@@ -1 +1 @@
-{"version":3,"file":"query-manager.js","names":["#clientID","#clientToServer","#serverToClient","#send","#onFatalError","#queries","#recentQueriesMaxSize","#recentQueries","#gotQueries","#mutationTracker","#pendingQueryChanges","#queryChangeThrottleMs","#lc","#metrics","#queryMetrics","#slowMaterializeThreshold","#pendingRemovals","#gotQueriesAuthoritative","#fireGotCallbacks","#queryEvictedCallback","#closedError","#add","#queueQueryChange","#updateEntry","#remove","#scheduleBatch","#batchTimer"],"sources":["../../../../../zero-client/src/client/query-manager.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {ReplicacheImpl} from '../../../replicache/src/replicache-impl.ts';\nimport type {ClientID} from '../../../replicache/src/sync/ids.ts';\nimport {assert, unreachable} from '../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport {difference} from '../../../shared/src/set-utils.ts';\nimport {TDigest} from '../../../shared/src/tdigest.ts';\nimport {\n  mapAST,\n  normalizeAST,\n  type AST,\n} from '../../../zero-protocol/src/ast.ts';\nimport type {ChangeDesiredQueriesMessage} from '../../../zero-protocol/src/change-desired-queries.ts';\nimport type {ErroredQuery} from '../../../zero-protocol/src/custom-queries.ts';\nimport {ErrorKind} from '../../../zero-protocol/src/error-kind.ts';\nimport {ErrorOrigin} from '../../../zero-protocol/src/error-origin.ts';\nimport {ErrorReason} from '../../../zero-protocol/src/error-reason.ts';\nimport {ProtocolError} from '../../../zero-protocol/src/error.ts';\nimport type {UpQueriesPatchOp} from '../../../zero-protocol/src/queries-patch.ts';\nimport {\n  hashOfAST,\n  hashOfNameAndArgs,\n} from '../../../zero-protocol/src/query-hash.ts';\nimport {\n  clientToServer,\n  serverToClient,\n  type NameMapper,\n} from '../../../zero-schema/src/name-mapper.ts';\nimport type {TableSchema} from '../../../zero-schema/src/table-schema.ts';\nimport type {ClientMetricMap} from '../../../zql/src/query/metrics-delegate.ts';\nimport type {CustomQueryID} from '../../../zql/src/query/named.ts';\nimport type {GotCallback} from '../../../zql/src/query/query-delegate.ts';\nimport {clampTTL, compareTTL, type TTL} from '../../../zql/src/query/ttl.ts';\nimport type {ClientErrorKind} from './client-error-kind.ts';\nimport type {ClientError} from './error.ts';\nimport {type ZeroError} from './error.ts';\nimport type {InspectorDelegate} from './inspector/inspector.ts';\nimport type {QueryClientMetrics} from './inspector/lazy-inspector.ts';\nimport {desiredQueriesPrefixForClient, GOT_QUERIES_KEY_PREFIX} from './keys.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\nimport type {ReadTransaction} from './replicache-types.ts';\n\ntype QueryHash = string;\n\ntype Entry = {\n  // We keep track of the AST so we can use it in the inspector.\n  normalized: AST;\n  name: string | undefined;\n  args: readonly ReadonlyJSONValue[] | undefined;\n  count: number;\n  gotCallbacks: GotCallback[];\n  ttl: TTL;\n};\n\ntype ClientMetric = {\n  [K in keyof ClientMetricMap]: TDigest;\n};\n\ntype PerQueryClientMetric = {\n  'query-materialization-client': number | undefined;\n  'query-materialization-end-to-end': number | undefined;\n  'query-update-client': TDigest;\n};\n\n/**\n * Tracks what queries the client is currently subscribed to on the server.\n * Sends `changeDesiredQueries` message to server when this changes.\n * Deduplicates requests so that we only listen to a given unique query once.\n */\nexport class QueryManager implements InspectorDelegate {\n  readonly #clientID: ClientID;\n  readonly #clientToServer: NameMapper;\n  readonly #serverToClient: NameMapper;\n  readonly #send: (change: ChangeDesiredQueriesMessage) => void;\n  readonly #onFatalError: (error: ZeroError) => void;\n  readonly #queries: Map<QueryHash, Entry> = new Map();\n  readonly #recentQueriesMaxSize: number;\n  readonly #recentQueries: Set<string> = new Set();\n  readonly #gotQueries: Set<string> = new Set();\n  // Whether `#gotQueries` can be trusted. The persisted set loaded from\n  // IndexedDB may be stale (a query 'got' in a previous session can be evicted\n  // server-side); see `markGotQueriesAuthoritative`.\n  #gotQueriesAuthoritative = false;\n  readonly #mutationTracker: MutationTracker;\n  readonly #pendingQueryChanges: UpQueriesPatchOp[] = [];\n  readonly #queryChangeThrottleMs: number;\n  #pendingRemovals: Array<() => void> = [];\n  #batchTimer: ReturnType<typeof setTimeout> | undefined;\n  readonly #lc: LogContext;\n  readonly #metrics: ClientMetric = newMetrics();\n  readonly #queryMetrics: Map<string, PerQueryClientMetric> = new Map();\n  readonly #slowMaterializeThreshold: number;\n  #closedError: ZeroError | undefined;\n  #queryEvictedCallback:\n    | ((hash: string, ast: AST, metrics: QueryClientMetrics) => void)\n    | undefined;\n\n  constructor(\n    lc: LogContext,\n    mutationTracker: MutationTracker,\n    clientID: ClientID,\n    tables: Record<string, TableSchema>,\n    send: (change: ChangeDesiredQueriesMessage) => void,\n    experimentalWatch: ReplicacheImpl['experimentalWatch'],\n    recentQueriesMaxSize: number,\n    queryChangeThrottleMs: number,\n    slowMaterializeThreshold: number,\n    onFatalError: (error: ZeroError) => void,\n  ) {\n    this.#lc = lc.withContext('QueryManager');\n    this.#clientID = clientID;\n    this.#clientToServer = clientToServer(tables);\n    this.#serverToClient = serverToClient(tables);\n    this.#recentQueriesMaxSize = recentQueriesMaxSize;\n    this.#send = send;\n    this.#mutationTracker = mutationTracker;\n    this.#queryChangeThrottleMs = queryChangeThrottleMs;\n    this.#slowMaterializeThreshold = slowMaterializeThreshold;\n    this.#onFatalError = onFatalError;\n    this.#mutationTracker.onAllMutationsApplied(() => {\n      if (this.#pendingRemovals.length === 0) {\n        return;\n      }\n      const pendingRemovals = this.#pendingRemovals;\n      this.#pendingRemovals = [];\n      for (const removal of pendingRemovals) {\n        removal();\n      }\n    });\n\n    experimentalWatch(\n      diff => {\n        for (const diffOp of diff) {\n          const queryHash = diffOp.key.substring(GOT_QUERIES_KEY_PREFIX.length);\n          switch (diffOp.op) {\n            case 'add':\n              this.#gotQueries.add(queryHash);\n              if (this.#gotQueriesAuthoritative) {\n                this.#fireGotCallbacks(queryHash, true);\n              }\n              break;\n            case 'del':\n              this.#gotQueries.delete(queryHash);\n              this.#fireGotCallbacks(queryHash, false);\n              break;\n          }\n        }\n      },\n      {\n        prefix: GOT_QUERIES_KEY_PREFIX,\n        initialValuesInFirstDiff: true,\n      },\n    );\n  }\n\n  getAST(queryID: string): AST | undefined {\n    const ast = this.#queries.get(queryID)?.normalized;\n    return ast && mapAST(ast, this.#serverToClient);\n  }\n\n  setQueryEvictedCallback(\n    cb: (hash: string, ast: AST, metrics: QueryClientMetrics) => void,\n  ): void {\n    this.#queryEvictedCallback = cb;\n  }\n\n  mapClientASTToServer(ast: AST): AST {\n    return mapAST(ast, this.#clientToServer);\n  }\n\n  #fireGotCallbacks(queryHash: string, got: boolean) {\n    const gotCallbacks = this.#queries.get(queryHash)?.gotCallbacks ?? [];\n    for (const gotCallback of gotCallbacks) {\n      gotCallback(got);\n    }\n  }\n\n  /**\n   * Trust `#gotQueries`. Called once the first poke after a (re)connect has\n   * been applied. Because `gotQueriesPatch` is a diff, the server won't re-send\n   * `put`s for queries it thinks the client already has, so we re-derive and\n   * fire `got` for every subscribed query already in the set. Only fires\n   * `true`, so this never reverts a query from 'complete'. Idempotent.\n   */\n  markGotQueriesAuthoritative(): void {\n    if (this.#gotQueriesAuthoritative) {\n      return;\n    }\n    this.#gotQueriesAuthoritative = true;\n    for (const queryHash of this.#queries.keys()) {\n      if (this.#gotQueries.has(queryHash)) {\n        this.#fireGotCallbacks(queryHash, true);\n      }\n    }\n  }\n\n  /** Called on disconnect. The next connect must re-confirm `#gotQueries`. */\n  clearGotQueriesAuthoritative(): void {\n    this.#gotQueriesAuthoritative = false;\n  }\n\n  /**\n   * Get the queries that need to be registered with the server.\n   *\n   * An optional `lastPatch` can be provided. This is the last patch that was\n   * sent to the server and may not yet have been acked. If `lastPatch` is provided,\n   * this method will return a patch that does not include any events sent in `lastPatch`.\n   *\n   * This diffing of last patch and current patch is needed since we send\n   * a set of queries to the server when we first connect inside of the `sec-protocol` as\n   * the `initConnectionMessage`.\n   *\n   * While we're waiting for the `connected` response to come back from the server,\n   * the client may have registered more queries. We need to diff the `initConnectionMessage`\n   * queries with the current set of queries to understand what those were.\n   */\n  async getQueriesPatch(\n    tx: ReadTransaction,\n    lastPatch?: Map<string, UpQueriesPatchOp>,\n  ): Promise<Map<string, UpQueriesPatchOp>> {\n    const existingQueryHashes = new Set<string>();\n    const prefix = desiredQueriesPrefixForClient(this.#clientID);\n    for await (const key of tx.scan({prefix}).keys()) {\n      existingQueryHashes.add(key.substring(prefix.length, key.length));\n    }\n    const patch: Map<string, UpQueriesPatchOp> = new Map();\n    for (const hash of existingQueryHashes) {\n      if (!this.#queries.has(hash)) {\n        patch.set(hash, {op: 'del', hash});\n      }\n    }\n\n    for (const [hash, {normalized, ttl, name, args}] of this.#queries) {\n      if (!existingQueryHashes.has(hash)) {\n        patch.set(hash, {\n          op: 'put',\n          hash,\n          ast: name === undefined ? normalized : undefined,\n          name,\n          args,\n          // We get TTL out of the DagStore so it is possible that the TTL was written\n          // with a too high TTL.\n          ttl: clampTTL(ttl), // no lc here since no need to log here\n        });\n      }\n    }\n\n    if (lastPatch) {\n      // if there are any `puts` in `lastPatch` that are not in `patch` then we need to\n      // send a `del` event in `patch`.\n      for (const [hash, {op}] of lastPatch) {\n        if (op === 'put' && !patch.has(hash)) {\n          patch.set(hash, {op: 'del', hash});\n        }\n      }\n      // Remove everything from `patch` that was already sent in `lastPatch`.\n      for (const [hash, {op}] of patch) {\n        const lastPatchOp = lastPatch.get(hash);\n        if (lastPatchOp && lastPatchOp.op === op) {\n          patch.delete(hash);\n        }\n      }\n    }\n\n    return patch;\n  }\n\n  handleTransformErrors(errors: ErroredQuery[]) {\n    for (const error of errors) {\n      const queryId = error.id;\n      const entry = this.#queries.get(queryId);\n\n      // if we don't have the query registered, continue\n      if (!entry) {\n        continue;\n      }\n\n      if (error.error === 'app' || error.error === 'parse') {\n        entry.gotCallbacks.forEach(callback => callback(false, error));\n      }\n      // this code path is not possible technically since errors were never implemented in the legacy query transform error\n      // but is included for backwards compatibility and we have a test case for it\n      else {\n        this.#onFatalError(\n          new ProtocolError({\n            kind: ErrorKind.TransformFailed,\n            origin: ErrorOrigin.ZeroCache,\n            reason: ErrorReason.Internal,\n            message: `Unknown error transforming queries: ${JSON.stringify(error)}`,\n            queryIDs: [],\n          }),\n        );\n        // unreachable(error); TODO(0xcadams): this should eventually be unreachable\n      }\n    }\n  }\n\n  handleClosed(\n    reason: ClientError<{kind: ClientErrorKind.ClientClosed; message: string}>,\n  ) {\n    if (this.#closedError) {\n      return;\n    }\n    this.#closedError = reason;\n    for (const [queryId, entry] of this.#queries) {\n      const erroredQuery: ErroredQuery = {\n        error: 'app',\n        id: queryId,\n        name: entry.name ?? 'legacy',\n        message: reason.message,\n        details: {kind: reason.kind},\n      };\n      for (const gotCallback of entry.gotCallbacks) {\n        gotCallback(false, erroredQuery);\n      }\n    }\n  }\n\n  addCustom(\n    ast: AST,\n    {name, args}: CustomQueryID,\n    ttl: TTL,\n    gotCallback?: GotCallback,\n  ): () => void {\n    const normalized = normalizeAST(ast);\n    const queryId = hashOfNameAndArgs(name, args);\n    return this.#add(queryId, normalized, name, args, ttl, gotCallback);\n  }\n\n  /** @deprecated */\n  addLegacy(ast: AST, ttl: TTL, gotCallback?: GotCallback): () => void {\n    const normalized = normalizeAST(ast);\n    const astHash = hashOfAST(normalized);\n    return this.#add(\n      astHash,\n      normalized,\n      undefined, // name is undefined for legacy queries\n      undefined, // args are undefined for legacy queries\n      ttl,\n      gotCallback,\n    );\n  }\n\n  #add(\n    queryId: string,\n    normalized: AST,\n    name: string | undefined,\n    args: readonly ReadonlyJSONValue[] | undefined,\n    ttl: TTL,\n    gotCallback?: GotCallback,\n  ) {\n    assert(\n      (name === undefined) === (args === undefined),\n      'If name is defined, args must be defined',\n    );\n    ttl = clampTTL(ttl, this.#lc);\n    let entry = this.#queries.get(queryId);\n    this.#recentQueries.delete(queryId);\n    if (!entry) {\n      normalized = mapAST(normalized, this.#clientToServer);\n\n      entry = {\n        normalized,\n        name,\n        args,\n        count: 1,\n        gotCallbacks: gotCallback ? [gotCallback] : [],\n        ttl,\n      };\n      this.#queries.set(queryId, entry);\n      this.#queueQueryChange({\n        op: 'put',\n        hash: queryId,\n        ast: name === undefined ? normalized : undefined,\n        name,\n        args,\n        ttl,\n      });\n    } else {\n      ++entry.count;\n      this.#updateEntry(entry, queryId, ttl);\n\n      if (gotCallback) {\n        entry.gotCallbacks.push(gotCallback);\n      }\n    }\n\n    if (gotCallback) {\n      gotCallback(\n        this.#gotQueriesAuthoritative && this.#gotQueries.has(queryId),\n      );\n    }\n\n    let removed = false;\n    const cleanupCb = () => {\n      if (removed) {\n        return;\n      }\n      removed = true;\n\n      // We cannot remove queries while mutations are pending\n      // as that could take data out of scope that is needed in a rebase\n      if (this.#mutationTracker.size > 0) {\n        this.#pendingRemovals.push(() =>\n          this.#remove(entry, queryId, gotCallback),\n        );\n        return;\n      }\n\n      this.#remove(entry, queryId, gotCallback);\n    };\n    return cleanupCb;\n  }\n\n  updateCustom({name, args}: CustomQueryID, ttl: TTL) {\n    const queryID = hashOfNameAndArgs(name, args);\n    const entry = must(this.#queries.get(queryID));\n    this.#updateEntry(entry, queryID, ttl);\n  }\n\n  /** @deprecated */\n  updateLegacy(ast: AST, ttl: TTL) {\n    const normalized = normalizeAST(ast);\n    const queryID = hashOfAST(normalized);\n    const entry = must(this.#queries.get(queryID));\n    this.#updateEntry(entry, queryID, ttl);\n  }\n\n  #updateEntry(entry: Entry, queryID: string, ttl: TTL): void {\n    // If the query already exists and the new ttl is larger than the old one\n    // we send a changeDesiredQueries message to the server to update the ttl.\n    ttl = clampTTL(ttl, this.#lc);\n    if (compareTTL(ttl, entry.ttl) > 0) {\n      entry.ttl = ttl;\n      this.#queueQueryChange({\n        op: 'put',\n        hash: queryID,\n        ast: entry.name === undefined ? entry.normalized : undefined,\n        name: entry.name,\n        args: entry.args,\n        ttl,\n      });\n    }\n  }\n\n  #queueQueryChange(op: UpQueriesPatchOp) {\n    this.#pendingQueryChanges.push(op);\n    this.#scheduleBatch();\n  }\n\n  #scheduleBatch() {\n    if (this.#batchTimer === undefined) {\n      this.#batchTimer = setTimeout(\n        () => this.flushBatch(),\n        this.#queryChangeThrottleMs,\n      );\n    }\n  }\n\n  flushBatch() {\n    if (this.#batchTimer !== undefined) {\n      clearTimeout(this.#batchTimer);\n      this.#batchTimer = undefined;\n    }\n    if (this.#pendingQueryChanges.length > 0) {\n      this.#send([\n        'changeDesiredQueries',\n        {\n          desiredQueriesPatch: [...this.#pendingQueryChanges],\n        },\n      ]);\n      this.#pendingQueryChanges.length = 0;\n    }\n  }\n\n  #remove(entry: Entry, astHash: string, gotCallback: GotCallback | undefined) {\n    if (gotCallback) {\n      const index = entry.gotCallbacks.indexOf(gotCallback);\n      entry.gotCallbacks.splice(index, 1);\n    }\n    --entry.count;\n    if (entry.count === 0) {\n      this.#recentQueries.add(astHash);\n      if (this.#recentQueries.size > this.#recentQueriesMaxSize) {\n        const lruQueryID = this.#recentQueries.values().next().value;\n        assert(lruQueryID, 'Expected LRU query ID to exist');\n        const evictedAST = this.getAST(lruQueryID);\n        const evictedMetrics =\n          this.#queryMetrics.get(lruQueryID) ?? newPerQueryMetrics();\n        this.#queries.delete(lruQueryID);\n        this.#recentQueries.delete(lruQueryID);\n        this.#queryMetrics.delete(lruQueryID);\n        this.#queueQueryChange({op: 'del', hash: lruQueryID});\n        assert(evictedAST, 'Expected evicted AST to exist');\n        this.#queryEvictedCallback?.(lruQueryID, evictedAST, evictedMetrics);\n      }\n    }\n  }\n\n  /**\n   * Gets the aggregated metrics for all queries managed by this QueryManager.\n   */\n  get metrics(): ClientMetric {\n    return this.#metrics;\n  }\n\n  addMetric<K extends keyof ClientMetricMap>(\n    metric: K,\n    value: number,\n    ...args: ClientMetricMap[K]\n  ): void {\n    // Only query metrics are tracked at this point.\n    // If this check fails then we need to add a runtime check.\n    metric satisfies `query-${string}`;\n\n    // We track all materializations of queries as well as per\n    // query materializations.\n    this.#metrics[metric].add(value);\n\n    const queryID = args[0];\n\n    // Handle slow query logging for end-to-end materialization\n    if (metric === 'query-materialization-end-to-end') {\n      const ast = args[1];\n\n      if (\n        this.#slowMaterializeThreshold !== undefined &&\n        value > this.#slowMaterializeThreshold\n      ) {\n        this.#lc.warn?.(\n          'Slow query materialization (including server/network)',\n          queryID,\n          ast,\n          value,\n        );\n      } else {\n        this.#lc.debug?.(\n          'Materialized query (including server/network)',\n          queryID,\n          ast,\n          value,\n        );\n      }\n    }\n\n    // The query manager manages metrics that are per query.\n    let existing = this.#queryMetrics.get(queryID);\n    if (!existing) {\n      existing = newPerQueryMetrics();\n      this.#queryMetrics.set(queryID, existing);\n    }\n    switch (metric) {\n      case 'query-update-client':\n        existing['query-update-client'].add(value);\n        break;\n      case 'query-materialization-client':\n      case 'query-materialization-end-to-end':\n        // Recorded once per query (last value wins).\n        existing[\n          metric as\n            | 'query-materialization-client'\n            | 'query-materialization-end-to-end'\n        ] = value;\n        break;\n      default:\n        unreachable(metric);\n    }\n  }\n\n  getQueryMetrics(queryID: string): PerQueryClientMetric | undefined {\n    return this.#queryMetrics.get(queryID);\n  }\n\n  /**\n   * For testing only: returns all query hashes currently registered.\n   */\n  getAllNonGotQueryHashes(): Iterable<string> {\n    return difference(this.#queries, this.#gotQueries);\n  }\n}\n\nfunction newMetrics(): ClientMetric {\n  return {\n    'query-materialization-client': new TDigest(),\n    'query-materialization-end-to-end': new TDigest(),\n    'query-update-client': new TDigest(),\n  };\n}\n\nfunction newPerQueryMetrics(): PerQueryClientMetric {\n  return {\n    'query-materialization-client': undefined,\n    'query-materialization-end-to-end': undefined,\n    'query-update-client': new TDigest(),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"query-manager.js","names":["#clientID","#clientToServer","#serverToClient","#send","#onFatalError","#queries","#recentQueriesMaxSize","#recentQueries","#gotQueries","#cachedQueries","#mutationTracker","#pendingQueryChanges","#queryChangeThrottleMs","#lc","#metrics","#queryMetrics","#slowMaterializeThreshold","#pendingRemovals","#awaitingPersistedGotDiff","#fireGotCallbacks","#gotQueriesAuthoritative","#queryEvictedCallback","#closedError","#add","#queueQueryChange","#updateEntry","#remove","#scheduleBatch","#batchTimer"],"sources":["../../../../../zero-client/src/client/query-manager.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {ReplicacheImpl} from '../../../replicache/src/replicache-impl.ts';\nimport type {ClientID} from '../../../replicache/src/sync/ids.ts';\nimport {assert, unreachable} from '../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport {getOrInsertComputed} from '../../../shared/src/map.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport {difference} from '../../../shared/src/set-utils.ts';\nimport {TDigest} from '../../../shared/src/tdigest.ts';\nimport {\n  mapAST,\n  normalizeAST,\n  type AST,\n} from '../../../zero-protocol/src/ast.ts';\nimport type {ChangeDesiredQueriesMessage} from '../../../zero-protocol/src/change-desired-queries.ts';\nimport type {ErroredQuery} from '../../../zero-protocol/src/custom-queries.ts';\nimport {ErrorKind} from '../../../zero-protocol/src/error-kind.ts';\nimport {ErrorOrigin} from '../../../zero-protocol/src/error-origin.ts';\nimport {ErrorReason} from '../../../zero-protocol/src/error-reason.ts';\nimport {ProtocolError} from '../../../zero-protocol/src/error.ts';\nimport type {UpQueriesPatchOp} from '../../../zero-protocol/src/queries-patch.ts';\nimport {\n  hashOfAST,\n  hashOfNameAndArgs,\n} from '../../../zero-protocol/src/query-hash.ts';\nimport {\n  clientToServer,\n  serverToClient,\n  type NameMapper,\n} from '../../../zero-schema/src/name-mapper.ts';\nimport type {TableSchema} from '../../../zero-schema/src/table-schema.ts';\nimport type {ClientMetricMap} from '../../../zql/src/query/metrics-delegate.ts';\nimport type {CustomQueryID} from '../../../zql/src/query/named.ts';\nimport type {GotCallback} from '../../../zql/src/query/query-delegate.ts';\nimport {clampTTL, compareTTL, type TTL} from '../../../zql/src/query/ttl.ts';\nimport type {ClientErrorKind} from './client-error-kind.ts';\nimport type {ClientError} from './error.ts';\nimport {type ZeroError} from './error.ts';\nimport type {InspectorDelegate} from './inspector/inspector.ts';\nimport type {QueryClientMetrics} from './inspector/lazy-inspector.ts';\nimport {desiredQueriesPrefixForClient, GOT_QUERIES_KEY_PREFIX} from './keys.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\nimport type {ReadTransaction} from './replicache-types.ts';\n\n/**\n * Client query updates are timed for only the first of every\n * UPDATE_SAMPLE_RATE pushes to each source connection (see the\n * MeasurePushOperator that ZeroContext adds), so each reported\n * `query-update-client` time is recorded with this weight. Timing and\n * recording every push is a noticeable cost when applying a large sync on\n * React Native, for numbers only the inspector reads.\n */\nexport const UPDATE_SAMPLE_RATE = 32;\n\ntype QueryHash = string;\n\ntype Entry = {\n  // We keep track of the AST so we can use it in the inspector.\n  normalized: AST;\n  name: string | undefined;\n  args: readonly ReadonlyJSONValue[] | undefined;\n  count: number;\n  gotCallbacks: GotCallback[];\n  ttl: TTL;\n};\n\n// A thrown value, boxed so that `throw undefined` is still distinguishable\n// from \"nothing thrown\".\ntype ThrownBy = {readonly error: unknown};\n\ntype ClientMetric = {\n  [K in keyof ClientMetricMap]: TDigest;\n};\n\ntype PerQueryClientMetric = {\n  'query-materialization-client': number | undefined;\n  'query-materialization-end-to-end': number | undefined;\n  'query-update-client': TDigest;\n};\n\n/**\n * Tracks what queries the client is currently subscribed to on the server.\n * Sends `changeDesiredQueries` message to server when this changes.\n * Deduplicates requests so that we only listen to a given unique query once.\n */\nexport class QueryManager implements InspectorDelegate {\n  readonly #clientID: ClientID;\n  readonly #clientToServer: NameMapper;\n  readonly #serverToClient: NameMapper;\n  readonly #send: (change: ChangeDesiredQueriesMessage) => void;\n  readonly #onFatalError: (error: ZeroError) => void;\n  readonly #queries: Map<QueryHash, Entry> = new Map();\n  readonly #recentQueriesMaxSize: number;\n  readonly #recentQueries: Set<string> = new Set();\n  readonly #gotQueries: Set<string> = new Set();\n  // Whether `#gotQueries` can be trusted. The persisted set loaded from\n  // IndexedDB may be stale (a query 'got' in a previous session can be evicted\n  // server-side); see `markGotQueriesAuthoritative`.\n  #gotQueriesAuthoritative = false;\n  // The got keys whose result the store holds from a previous connection: the\n  // set persisted by a previous session, and on disconnect everything the\n  // connection just torn down had confirmed. Until the got set is\n  // authoritative, a registration reports these as 'cached'. Keys added by a\n  // live diff are not in it; see the watch below.\n  readonly #cachedQueries: Set<string> = new Set();\n  // Whether the got-queries watch has yet to deliver its first diff, the\n  // persisted set. Cleared before that diff is processed, so a throwing\n  // callback cannot leave it set.\n  #awaitingPersistedGotDiff = true;\n  readonly #mutationTracker: MutationTracker;\n  readonly #pendingQueryChanges: UpQueriesPatchOp[] = [];\n  readonly #queryChangeThrottleMs: number;\n  #pendingRemovals: Array<() => void> = [];\n  #batchTimer: ReturnType<typeof setTimeout> | undefined;\n  readonly #lc: LogContext;\n  readonly #metrics: ClientMetric = newMetrics();\n  readonly #queryMetrics: Map<string, PerQueryClientMetric> = new Map();\n  readonly #slowMaterializeThreshold: number;\n  #closedError: ZeroError | undefined;\n  #queryEvictedCallback:\n    | ((hash: string, ast: AST, metrics: QueryClientMetrics) => void)\n    | undefined;\n\n  constructor(\n    lc: LogContext,\n    mutationTracker: MutationTracker,\n    clientID: ClientID,\n    tables: Record<string, TableSchema>,\n    send: (change: ChangeDesiredQueriesMessage) => void,\n    experimentalWatch: ReplicacheImpl['experimentalWatch'],\n    recentQueriesMaxSize: number,\n    queryChangeThrottleMs: number,\n    slowMaterializeThreshold: number,\n    onFatalError: (error: ZeroError) => void,\n  ) {\n    this.#lc = lc.withContext('QueryManager');\n    this.#clientID = clientID;\n    this.#clientToServer = clientToServer(tables);\n    this.#serverToClient = serverToClient(tables);\n    this.#recentQueriesMaxSize = recentQueriesMaxSize;\n    this.#send = send;\n    this.#mutationTracker = mutationTracker;\n    this.#queryChangeThrottleMs = queryChangeThrottleMs;\n    this.#slowMaterializeThreshold = slowMaterializeThreshold;\n    this.#onFatalError = onFatalError;\n    this.#mutationTracker.onAllMutationsApplied(() => {\n      if (this.#pendingRemovals.length === 0) {\n        return;\n      }\n      const pendingRemovals = this.#pendingRemovals;\n      this.#pendingRemovals = [];\n      for (const removal of pendingRemovals) {\n        removal();\n      }\n    });\n\n    // The first diff is the got set persisted by a previous session, the only\n    // state the watch may report as 'cached'. Every later diff is live: this\n    // tab's own poke, whose keys are confirmations on this connection and are\n    // reported as got once the poke has been applied (see\n    // `markGotQueriesAuthoritative`), or another tab's state arriving via\n    // replicache refresh. A live diff can therefore only revoke a cached\n    // claim (a deleted key), never grant one.\n    experimentalWatch(\n      diff => {\n        const persisted = this.#awaitingPersistedGotDiff;\n        this.#awaitingPersistedGotDiff = false;\n        // A throwing callback must not leave the rest of the diff unapplied,\n        // or later keys would never enter the got set. The first error is\n        // rethrown once the sets are consistent.\n        let thrown: ThrownBy | undefined;\n        const fire = (queryHash: string, got: boolean | 'cached') => {\n          const e = this.#fireGotCallbacks(queryHash, got);\n          thrown ??= e;\n        };\n        for (const diffOp of diff) {\n          const queryHash = diffOp.key.substring(GOT_QUERIES_KEY_PREFIX.length);\n          switch (diffOp.op) {\n            case 'add':\n              this.#gotQueries.add(queryHash);\n              if (this.#gotQueriesAuthoritative) {\n                fire(queryHash, true);\n              } else if (persisted) {\n                this.#cachedQueries.add(queryHash);\n                fire(queryHash, 'cached');\n              }\n              break;\n            case 'del':\n              this.#gotQueries.delete(queryHash);\n              this.#cachedQueries.delete(queryHash);\n              fire(queryHash, false);\n              break;\n          }\n        }\n        if (thrown) {\n          throw thrown.error;\n        }\n      },\n      {\n        prefix: GOT_QUERIES_KEY_PREFIX,\n        initialValuesInFirstDiff: true,\n      },\n    );\n  }\n\n  getAST(queryID: string): AST | undefined {\n    const ast = this.#queries.get(queryID)?.normalized;\n    return ast && mapAST(ast, this.#serverToClient);\n  }\n\n  setQueryEvictedCallback(\n    cb: (hash: string, ast: AST, metrics: QueryClientMetrics) => void,\n  ): void {\n    this.#queryEvictedCallback = cb;\n  }\n\n  mapClientASTToServer(ast: AST): AST {\n    return mapAST(ast, this.#clientToServer);\n  }\n\n  /**\n   * Notifies every subscriber of the query. A throwing subscriber does not\n   * keep the others from being notified; the first error is returned so the\n   * caller can rethrow it once its own bookkeeping is consistent.\n   */\n  #fireGotCallbacks(\n    queryHash: string,\n    got: boolean | 'cached',\n  ): ThrownBy | undefined {\n    const entry = this.#queries.get(queryHash);\n    if (!entry) {\n      return undefined;\n    }\n    let thrown: ThrownBy | undefined;\n    // A subscriber may unregister during dispatch (a run() waiter destroys its\n    // view on the notification it was waiting for), so iterate a snapshot.\n    for (const gotCallback of [...entry.gotCallbacks]) {\n      try {\n        gotCallback(got);\n      } catch (error) {\n        thrown ??= {error};\n      }\n    }\n    return thrown;\n  }\n\n  /**\n   * Trust `#gotQueries`. Called once the first poke after a (re)connect has\n   * been applied. Because `gotQueriesPatch` is a diff, the server won't re-send\n   * `put`s for queries it thinks the client already has, so we re-derive and\n   * fire `got` for every subscribed query already in the set. Only fires\n   * `true`, so this never reverts a query from 'complete'. Idempotent.\n   */\n  markGotQueriesAuthoritative(): void {\n    if (this.#gotQueriesAuthoritative) {\n      return;\n    }\n    this.#gotQueriesAuthoritative = true;\n    // Whatever the previous connection held, this one has now confirmed or\n    // deleted. Should the watch's first diff have been skipped (a failed\n    // initial run), the next diff is live too.\n    this.#cachedQueries.clear();\n    this.#awaitingPersistedGotDiff = false;\n    let thrown: ThrownBy | undefined;\n    for (const queryHash of this.#queries.keys()) {\n      if (this.#gotQueries.has(queryHash)) {\n        const e = this.#fireGotCallbacks(queryHash, true);\n        thrown ??= e;\n      }\n    }\n    if (thrown) {\n      throw thrown.error;\n    }\n  }\n\n  /** Called on disconnect. The next connect must re-confirm `#gotQueries`. */\n  clearGotQueriesAuthoritative(): void {\n    if (!this.#gotQueriesAuthoritative) {\n      // The connection never confirmed the got set, so the persisted\n      // classification still stands. Keys a live diff added in the meantime\n      // were not confirmed by this connection and stay unclaimed.\n      return;\n    }\n    this.#gotQueriesAuthoritative = false;\n    // Everything got at this point was confirmed by the connection just torn\n    // down, which for a new registration is the cached claim.\n    for (const queryHash of this.#gotQueries) {\n      this.#cachedQueries.add(queryHash);\n    }\n  }\n\n  /**\n   * Get the queries that need to be registered with the server.\n   *\n   * An optional `lastPatch` can be provided. This is the last patch that was\n   * sent to the server and may not yet have been acked. If `lastPatch` is provided,\n   * this method will return a patch that does not include any events sent in `lastPatch`.\n   *\n   * This diffing of last patch and current patch is needed since we send\n   * a set of queries to the server when we first connect inside of the `sec-protocol` as\n   * the `initConnectionMessage`.\n   *\n   * While we're waiting for the `connected` response to come back from the server,\n   * the client may have registered more queries. We need to diff the `initConnectionMessage`\n   * queries with the current set of queries to understand what those were.\n   */\n  async getQueriesPatch(\n    tx: ReadTransaction,\n    lastPatch?: Map<string, UpQueriesPatchOp>,\n  ): Promise<Map<string, UpQueriesPatchOp>> {\n    const existingQueryHashes = new Set<string>();\n    const prefix = desiredQueriesPrefixForClient(this.#clientID);\n    for await (const key of tx.scan({prefix}).keys()) {\n      existingQueryHashes.add(key.substring(prefix.length, key.length));\n    }\n    const patch: Map<string, UpQueriesPatchOp> = new Map();\n    for (const hash of existingQueryHashes) {\n      if (!this.#queries.has(hash)) {\n        patch.set(hash, {op: 'del', hash});\n      }\n    }\n\n    for (const [hash, {normalized, ttl, name, args}] of this.#queries) {\n      if (!existingQueryHashes.has(hash)) {\n        patch.set(hash, {\n          op: 'put',\n          hash,\n          ast: name === undefined ? normalized : undefined,\n          name,\n          args,\n          // We get TTL out of the DagStore so it is possible that the TTL was written\n          // with a too high TTL.\n          ttl: clampTTL(ttl), // no lc here since no need to log here\n        });\n      }\n    }\n\n    if (lastPatch) {\n      // if there are any `puts` in `lastPatch` that are not in `patch` then we need to\n      // send a `del` event in `patch`.\n      for (const [hash, {op}] of lastPatch) {\n        if (op === 'put' && !patch.has(hash)) {\n          patch.set(hash, {op: 'del', hash});\n        }\n      }\n      // Remove everything from `patch` that was already sent in `lastPatch`.\n      for (const [hash, {op}] of patch) {\n        const lastPatchOp = lastPatch.get(hash);\n        if (lastPatchOp && lastPatchOp.op === op) {\n          patch.delete(hash);\n        }\n      }\n    }\n\n    return patch;\n  }\n\n  handleTransformErrors(errors: ErroredQuery[]) {\n    for (const error of errors) {\n      const queryId = error.id;\n      const entry = this.#queries.get(queryId);\n\n      // if we don't have the query registered, continue\n      if (!entry) {\n        continue;\n      }\n\n      if (error.error === 'app' || error.error === 'parse') {\n        entry.gotCallbacks.forEach(callback => callback(false, error));\n      }\n      // this code path is not possible technically since errors were never implemented in the legacy query transform error\n      // but is included for backwards compatibility and we have a test case for it\n      else {\n        this.#onFatalError(\n          new ProtocolError({\n            kind: ErrorKind.TransformFailed,\n            origin: ErrorOrigin.ZeroCache,\n            reason: ErrorReason.Internal,\n            message: `Unknown error transforming queries: ${JSON.stringify(error)}`,\n            queryIDs: [],\n          }),\n        );\n        // unreachable(error); TODO(0xcadams): this should eventually be unreachable\n      }\n    }\n  }\n\n  handleClosed(\n    reason: ClientError<{kind: ClientErrorKind.ClientClosed; message: string}>,\n  ) {\n    if (this.#closedError) {\n      return;\n    }\n    this.#closedError = reason;\n    for (const [queryId, entry] of this.#queries) {\n      const erroredQuery: ErroredQuery = {\n        error: 'app',\n        id: queryId,\n        name: entry.name ?? 'legacy',\n        message: reason.message,\n        details: {kind: reason.kind},\n      };\n      for (const gotCallback of entry.gotCallbacks) {\n        gotCallback(false, erroredQuery);\n      }\n    }\n  }\n\n  addCustom(\n    ast: AST,\n    {name, args}: CustomQueryID,\n    ttl: TTL,\n    gotCallback?: GotCallback,\n  ): () => void {\n    const normalized = normalizeAST(ast);\n    const queryId = hashOfNameAndArgs(name, args);\n    return this.#add(queryId, normalized, name, args, ttl, gotCallback);\n  }\n\n  /** @deprecated */\n  addLegacy(ast: AST, ttl: TTL, gotCallback?: GotCallback): () => void {\n    const normalized = normalizeAST(ast);\n    const astHash = hashOfAST(normalized);\n    return this.#add(\n      astHash,\n      normalized,\n      undefined, // name is undefined for legacy queries\n      undefined, // args are undefined for legacy queries\n      ttl,\n      gotCallback,\n    );\n  }\n\n  #add(\n    queryId: string,\n    normalized: AST,\n    name: string | undefined,\n    args: readonly ReadonlyJSONValue[] | undefined,\n    ttl: TTL,\n    gotCallback?: GotCallback,\n  ) {\n    assert(\n      (name === undefined) === (args === undefined),\n      'If name is defined, args must be defined',\n    );\n    ttl = clampTTL(ttl, this.#lc);\n    let entry = this.#queries.get(queryId);\n    this.#recentQueries.delete(queryId);\n    if (!entry) {\n      normalized = mapAST(normalized, this.#clientToServer);\n\n      entry = {\n        normalized,\n        name,\n        args,\n        count: 1,\n        gotCallbacks: gotCallback ? [gotCallback] : [],\n        ttl,\n      };\n      this.#queries.set(queryId, entry);\n      this.#queueQueryChange({\n        op: 'put',\n        hash: queryId,\n        ast: name === undefined ? normalized : undefined,\n        name,\n        args,\n        ttl,\n      });\n    } else {\n      ++entry.count;\n      this.#updateEntry(entry, queryId, ttl);\n\n      if (gotCallback) {\n        entry.gotCallbacks.push(gotCallback);\n      }\n    }\n\n    if (gotCallback) {\n      gotCallback(\n        this.#gotQueriesAuthoritative\n          ? this.#gotQueries.has(queryId)\n          : this.#cachedQueries.has(queryId) && 'cached',\n      );\n    }\n\n    let removed = false;\n    const cleanupCb = () => {\n      if (removed) {\n        return;\n      }\n      removed = true;\n\n      // We cannot remove queries while mutations are pending\n      // as that could take data out of scope that is needed in a rebase\n      if (this.#mutationTracker.size > 0) {\n        this.#pendingRemovals.push(() =>\n          this.#remove(entry, queryId, gotCallback),\n        );\n        return;\n      }\n\n      this.#remove(entry, queryId, gotCallback);\n    };\n    return cleanupCb;\n  }\n\n  updateCustom({name, args}: CustomQueryID, ttl: TTL) {\n    const queryID = hashOfNameAndArgs(name, args);\n    const entry = must(this.#queries.get(queryID));\n    this.#updateEntry(entry, queryID, ttl);\n  }\n\n  /** @deprecated */\n  updateLegacy(ast: AST, ttl: TTL) {\n    const normalized = normalizeAST(ast);\n    const queryID = hashOfAST(normalized);\n    const entry = must(this.#queries.get(queryID));\n    this.#updateEntry(entry, queryID, ttl);\n  }\n\n  #updateEntry(entry: Entry, queryID: string, ttl: TTL): void {\n    // If the query already exists and the new ttl is larger than the old one\n    // we send a changeDesiredQueries message to the server to update the ttl.\n    ttl = clampTTL(ttl, this.#lc);\n    if (compareTTL(ttl, entry.ttl) > 0) {\n      entry.ttl = ttl;\n      this.#queueQueryChange({\n        op: 'put',\n        hash: queryID,\n        ast: entry.name === undefined ? entry.normalized : undefined,\n        name: entry.name,\n        args: entry.args,\n        ttl,\n      });\n    }\n  }\n\n  #queueQueryChange(op: UpQueriesPatchOp) {\n    this.#pendingQueryChanges.push(op);\n    this.#scheduleBatch();\n  }\n\n  #scheduleBatch() {\n    if (this.#batchTimer === undefined) {\n      this.#batchTimer = setTimeout(\n        () => this.flushBatch(),\n        this.#queryChangeThrottleMs,\n      );\n    }\n  }\n\n  flushBatch() {\n    if (this.#batchTimer !== undefined) {\n      clearTimeout(this.#batchTimer);\n      this.#batchTimer = undefined;\n    }\n    if (this.#pendingQueryChanges.length > 0) {\n      this.#send([\n        'changeDesiredQueries',\n        {\n          desiredQueriesPatch: [...this.#pendingQueryChanges],\n        },\n      ]);\n      this.#pendingQueryChanges.length = 0;\n    }\n  }\n\n  #remove(entry: Entry, astHash: string, gotCallback: GotCallback | undefined) {\n    if (gotCallback) {\n      const index = entry.gotCallbacks.indexOf(gotCallback);\n      entry.gotCallbacks.splice(index, 1);\n    }\n    --entry.count;\n    if (entry.count === 0) {\n      this.#recentQueries.add(astHash);\n      if (this.#recentQueries.size > this.#recentQueriesMaxSize) {\n        const lruQueryID = this.#recentQueries.values().next().value;\n        assert(lruQueryID, 'Expected LRU query ID to exist');\n        const evictedAST = this.getAST(lruQueryID);\n        const evictedMetrics =\n          this.#queryMetrics.get(lruQueryID) ?? newPerQueryMetrics();\n        this.#queries.delete(lruQueryID);\n        this.#recentQueries.delete(lruQueryID);\n        this.#queryMetrics.delete(lruQueryID);\n        this.#queueQueryChange({op: 'del', hash: lruQueryID});\n        assert(evictedAST, 'Expected evicted AST to exist');\n        this.#queryEvictedCallback?.(lruQueryID, evictedAST, evictedMetrics);\n      }\n    }\n  }\n\n  /**\n   * Gets the aggregated metrics for all queries managed by this QueryManager.\n   */\n  get metrics(): ClientMetric {\n    return this.#metrics;\n  }\n\n  addMetric<K extends keyof ClientMetricMap>(\n    metric: K,\n    value: number,\n    ...args: ClientMetricMap[K]\n  ): void {\n    // Only query metrics are tracked at this point.\n    // If this check fails then we need to add a runtime check.\n    metric satisfies `query-${string}`;\n\n    // We track all materializations of queries as well as per\n    // query materializations.\n    const weight = metric === 'query-update-client' ? UPDATE_SAMPLE_RATE : 1;\n    this.#metrics[metric].add(value, weight);\n\n    const queryID = args[0];\n\n    // Handle slow query logging for end-to-end materialization\n    if (metric === 'query-materialization-end-to-end') {\n      const ast = args[1];\n\n      if (\n        this.#slowMaterializeThreshold !== undefined &&\n        value > this.#slowMaterializeThreshold\n      ) {\n        this.#lc.warn?.(\n          'Slow query materialization (including server/network)',\n          queryID,\n          ast,\n          value,\n        );\n      } else {\n        this.#lc.debug?.(\n          'Materialized query (including server/network)',\n          queryID,\n          ast,\n          value,\n        );\n      }\n    }\n\n    // The query manager manages metrics that are per query.\n    const existing = getOrInsertComputed(\n      this.#queryMetrics,\n      queryID,\n      newPerQueryMetrics,\n    );\n    switch (metric) {\n      case 'query-update-client':\n        existing['query-update-client'].add(value, weight);\n        break;\n      case 'query-materialization-client':\n      case 'query-materialization-end-to-end':\n        // Recorded once per query (last value wins).\n        existing[\n          metric as\n            | 'query-materialization-client'\n            | 'query-materialization-end-to-end'\n        ] = value;\n        break;\n      default:\n        unreachable(metric);\n    }\n  }\n\n  getQueryMetrics(queryID: string): PerQueryClientMetric | undefined {\n    return this.#queryMetrics.get(queryID);\n  }\n\n  /**\n   * For testing only: returns all query hashes currently registered.\n   */\n  getAllNonGotQueryHashes(): Iterable<string> {\n    return difference(this.#queries, this.#gotQueries);\n  }\n}\n\nfunction newMetrics(): ClientMetric {\n  return {\n    'query-materialization-client': new TDigest(),\n    'query-materialization-end-to-end': new TDigest(),\n    'query-update-client': new TDigest(),\n  };\n}\n\nfunction newPerQueryMetrics(): PerQueryClientMetric {\n  return {\n    'query-materialization-client': undefined,\n    'query-materialization-end-to-end': undefined,\n    'query-update-client': new TDigest(),\n  };\n}\n"],"mappings":"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"}

package/out/zero-client/src/client/reload-error-handler.js

@@ -6,8 +6,8 @@ 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)
+	lastReloadTime: valita_exports.number().optional(() => 0),
+	nextIntervalMs: valita_exports.number().optional(() => 0)
 });
 var MAX_RELOAD_INTERVAL_MS = 6e4;
 var FALLBACK_RELOAD_INTERVAL_MS = 1e4;

package/out/zero-client/src/client/reload-error-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"reload-error-handler.js","names":[],"sources":["../../../../../zero-client/src/client/reload-error-handler.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport * as v from '../../../shared/src/valita.ts';\nimport type {ErrorKind} from '../../../zero-protocol/src/error-kind.ts';\nimport {errorKindSchema} from '../../../zero-protocol/src/error.ts';\nimport {updateNeededReasonTypeSchema} from './options.ts';\nimport type {UpdateNeededReasonType} from './update-needed-reason-type.ts';\n\nexport const RELOAD_REASON_STORAGE_KEY = '_zeroReloadReason';\nexport const RELOAD_BACKOFF_STATE_KEY = '_zeroReloadBackoffState';\n\nconst reloadReasonSchema = v.tuple([\n  v.union(updateNeededReasonTypeSchema, errorKindSchema),\n  v.string(),\n]);\n\nconst backoffStateSchema = v.object({\n  lastReloadTime: v.number().default(0),\n  nextIntervalMs: v.number().default(0),\n});\n\nexport type BackoffState = v.Infer<typeof backoffStateSchema>;\n\nexport const MIN_RELOAD_INTERVAL_MS = 500;\nexport const MAX_RELOAD_INTERVAL_MS = 60_000;\n\n// For the fraction of browsers that do not support sessionStorage.\nexport const FALLBACK_RELOAD_INTERVAL_MS = 10_000;\n\nlet reloadTimer: ReturnType<typeof setTimeout> | null = null;\n\n// TODO: This should get pushed down into Replicache and used for reloads we\n// do there.\nexport function reloadWithReason(\n  lc: LogContext,\n  reload: () => void,\n  reason: UpdateNeededReasonType | ErrorKind,\n  message: string,\n) {\n  if (reloadTimer) {\n    lc.info?.('reload timer already scheduled');\n    return;\n  }\n  const now = Date.now();\n  const backoff = nextBackoff(lc, now);\n\n  // Record state immediately so that it persists if the user manually reloads first.\n  if (typeof sessionStorage !== 'undefined') {\n    sessionStorage.setItem(RELOAD_BACKOFF_STATE_KEY, JSON.stringify(backoff));\n    sessionStorage.setItem(\n      RELOAD_REASON_STORAGE_KEY,\n      JSON.stringify([reason, message]),\n    );\n  }\n\n  const delay = backoff.lastReloadTime - now;\n  lc.error?.(\n    reason,\n    '\\n',\n    'reloading',\n    delay > 0 ? `in ${delay / 1000} seconds` : '',\n  );\n  reloadTimer = setTimeout(() => {\n    reloadTimer = null;\n    reload();\n  }, delay);\n}\n\nexport function reportReloadReason(lc: LogContext) {\n  if (typeof sessionStorage !== 'undefined') {\n    const value = sessionStorage.getItem(RELOAD_REASON_STORAGE_KEY);\n    if (value) {\n      sessionStorage.removeItem(RELOAD_REASON_STORAGE_KEY);\n      try {\n        const parsed = JSON.parse(value);\n        const [reasonType, message] = v.parse(parsed, reloadReasonSchema);\n        lc.error?.(reasonType, 'Zero reloaded the page.', message);\n      } catch (e) {\n        lc.error?.('Zero reloaded the page.', e);\n        // ignore if not able to parse\n        return;\n      }\n    }\n  }\n}\n\n/** If a reload is scheduled, do not attempt to reconnect. */\nexport function reloadScheduled() {\n  return reloadTimer !== null;\n}\n\n/** Call upon a successful connection, indicating that backoff should be reset. */\nexport function resetBackoff() {\n  if (typeof sessionStorage !== 'undefined') {\n    sessionStorage.removeItem(RELOAD_BACKOFF_STATE_KEY);\n  }\n}\n\nfunction nextBackoff(lc: LogContext, now: number): BackoffState {\n  if (typeof sessionStorage === 'undefined') {\n    lc.warn?.(\n      `sessionStorage not supported. backing off in ${\n        FALLBACK_RELOAD_INTERVAL_MS / 1000\n      } seconds`,\n    );\n    return {\n      lastReloadTime: now + FALLBACK_RELOAD_INTERVAL_MS,\n      nextIntervalMs: MIN_RELOAD_INTERVAL_MS,\n    };\n  }\n  const val = sessionStorage.getItem(RELOAD_BACKOFF_STATE_KEY);\n  if (!val) {\n    return {lastReloadTime: now, nextIntervalMs: MIN_RELOAD_INTERVAL_MS};\n  }\n  let parsed: BackoffState;\n  try {\n    parsed = v.parse(JSON.parse(val), backoffStateSchema, 'passthrough');\n  } catch (e) {\n    lc.warn?.('ignoring unparsable backoff state', val, e);\n    return {lastReloadTime: now, nextIntervalMs: MIN_RELOAD_INTERVAL_MS};\n  }\n  const {lastReloadTime, nextIntervalMs} = parsed;\n\n  // Backoff state might not have been cleared. Reset for sufficiently old state.\n  if (now - lastReloadTime > MAX_RELOAD_INTERVAL_MS * 2) {\n    return {lastReloadTime: now, nextIntervalMs: MIN_RELOAD_INTERVAL_MS};\n  }\n  if (now < lastReloadTime) {\n    // If the user manually reloaded, stick to the existing schedule.\n    return parsed;\n  }\n  const nextReloadTime = Math.max(now, lastReloadTime + nextIntervalMs);\n  return {\n    lastReloadTime: nextReloadTime,\n    nextIntervalMs: Math.min(nextIntervalMs * 2, MAX_RELOAD_INTERVAL_MS),\n  };\n}\n"],"mappings":";;;;AAOA,IAAa,4BAA4B;AACzC,IAAa,2BAA2B;AAExC,IAAM,qBAAqB,eAAE,MAAM,CACjC,eAAE,MAAM,8BAA8B,eAAe,GACrD,eAAE,OAAO,CACX,CAAC;AAED,IAAM,qBAAqB,eAAE,OAAO;CAClC,gBAAgB,eAAE,OAAO,EAAE,QAAQ,CAAC;CACpC,gBAAgB,eAAE,OAAO,EAAE,QAAQ,CAAC;AACtC,CAAC;AAKD,IAAa,yBAAyB;AAGtC,IAAa,8BAA8B;AAE3C,IAAI,cAAoD;AAIxD,SAAgB,iBACd,IACA,QACA,QACA,SACA;CACA,IAAI,aAAa;EACf,GAAG,OAAO,gCAAgC;EAC1C;CACF;CACA,MAAM,MAAM,KAAK,IAAI;CACrB,MAAM,UAAU,YAAY,IAAI,GAAG;CAGnC,IAAI,OAAO,mBAAmB,aAAa;EACzC,eAAe,QAAQ,0BAA0B,KAAK,UAAU,OAAO,CAAC;EACxE,eAAe,QACb,2BACA,KAAK,UAAU,CAAC,QAAQ,OAAO,CAAC,CAClC;CACF;CAEA,MAAM,QAAQ,QAAQ,iBAAiB;CACvC,GAAG,QACD,QACA,MACA,aACA,QAAQ,IAAI,MAAM,QAAQ,IAAK,YAAY,EAC7C;CACA,cAAc,iBAAiB;EAC7B,cAAc;EACd,OAAO;CACT,GAAG,KAAK;AACV;AAEA,SAAgB,mBAAmB,IAAgB;CACjD,IAAI,OAAO,mBAAmB,aAAa;EACzC,MAAM,QAAQ,eAAe,QAAQ,yBAAyB;EAC9D,IAAI,OAAO;GACT,eAAe,WAAW,yBAAyB;GACnD,IAAI;IAEF,MAAM,CAAC,YAAY,WAAW,MADf,KAAK,MAAM,KACY,GAAQ,kBAAkB;IAChE,GAAG,QAAQ,YAAY,2BAA2B,OAAO;GAC3D,SAAS,GAAG;IACV,GAAG,QAAQ,2BAA2B,CAAC;IAEvC;GACF;EACF;CACF;AACF;;AAGA,SAAgB,kBAAkB;CAChC,OAAO,gBAAgB;AACzB;;AAGA,SAAgB,eAAe;CAC7B,IAAI,OAAO,mBAAmB,aAC5B,eAAe,WAAW,wBAAwB;AAEtD;AAEA,SAAS,YAAY,IAAgB,KAA2B;CAC9D,IAAI,OAAO,mBAAmB,aAAa;EACzC,GAAG,OACD,gDACE,8BAA8B,IAC/B,SACH;EACA,OAAO;GACL,gBAAgB,MAAM;GACtB,gBAAA;EACF;CACF;CACA,MAAM,MAAM,eAAe,QAAQ,wBAAwB;CAC3D,IAAI,CAAC,KACH,OAAO;EAAC,gBAAgB;EAAK,gBAAA;CAAsC;CAErE,IAAI;CACJ,IAAI;EACF,SAAS,MAAQ,KAAK,MAAM,GAAG,GAAG,oBAAoB,aAAa;CACrE,SAAS,GAAG;EACV,GAAG,OAAO,qCAAqC,KAAK,CAAC;EACrD,OAAO;GAAC,gBAAgB;GAAK,gBAAA;EAAsC;CACrE;CACA,MAAM,EAAC,gBAAgB,mBAAkB;CAGzC,IAAI,MAAM,iBAAA,MAA0C,GAClD,OAAO;EAAC,gBAAgB;EAAK,gBAAA;CAAsC;CAErE,IAAI,MAAM,gBAER,OAAO;CAGT,OAAO;EACL,gBAFqB,KAAK,IAAI,KAAK,iBAAiB,cAEpC;EAChB,gBAAgB,KAAK,IAAI,iBAAiB,GAAG,sBAAsB;CACrE;AACF"}
+{"version":3,"file":"reload-error-handler.js","names":[],"sources":["../../../../../zero-client/src/client/reload-error-handler.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport * as v from '../../../shared/src/valita.ts';\nimport type {ErrorKind} from '../../../zero-protocol/src/error-kind.ts';\nimport {errorKindSchema} from '../../../zero-protocol/src/error.ts';\nimport {updateNeededReasonTypeSchema} from './options.ts';\nimport type {UpdateNeededReasonType} from './update-needed-reason-type.ts';\n\nexport const RELOAD_REASON_STORAGE_KEY = '_zeroReloadReason';\nexport const RELOAD_BACKOFF_STATE_KEY = '_zeroReloadBackoffState';\n\nconst reloadReasonSchema = v.tuple([\n  v.union(updateNeededReasonTypeSchema, errorKindSchema),\n  v.string(),\n]);\n\nconst backoffStateSchema = v.object({\n  lastReloadTime: v.number().optional(() => 0),\n  nextIntervalMs: v.number().optional(() => 0),\n});\n\nexport type BackoffState = v.Infer<typeof backoffStateSchema>;\n\nexport const MIN_RELOAD_INTERVAL_MS = 500;\nexport const MAX_RELOAD_INTERVAL_MS = 60_000;\n\n// For the fraction of browsers that do not support sessionStorage.\nexport const FALLBACK_RELOAD_INTERVAL_MS = 10_000;\n\nlet reloadTimer: ReturnType<typeof setTimeout> | null = null;\n\n// TODO: This should get pushed down into Replicache and used for reloads we\n// do there.\nexport function reloadWithReason(\n  lc: LogContext,\n  reload: () => void,\n  reason: UpdateNeededReasonType | ErrorKind,\n  message: string,\n) {\n  if (reloadTimer) {\n    lc.info?.('reload timer already scheduled');\n    return;\n  }\n  const now = Date.now();\n  const backoff = nextBackoff(lc, now);\n\n  // Record state immediately so that it persists if the user manually reloads first.\n  if (typeof sessionStorage !== 'undefined') {\n    sessionStorage.setItem(RELOAD_BACKOFF_STATE_KEY, JSON.stringify(backoff));\n    sessionStorage.setItem(\n      RELOAD_REASON_STORAGE_KEY,\n      JSON.stringify([reason, message]),\n    );\n  }\n\n  const delay = backoff.lastReloadTime - now;\n  lc.error?.(\n    reason,\n    '\\n',\n    'reloading',\n    delay > 0 ? `in ${delay / 1000} seconds` : '',\n  );\n  reloadTimer = setTimeout(() => {\n    reloadTimer = null;\n    reload();\n  }, delay);\n}\n\nexport function reportReloadReason(lc: LogContext) {\n  if (typeof sessionStorage !== 'undefined') {\n    const value = sessionStorage.getItem(RELOAD_REASON_STORAGE_KEY);\n    if (value) {\n      sessionStorage.removeItem(RELOAD_REASON_STORAGE_KEY);\n      try {\n        const parsed = JSON.parse(value);\n        const [reasonType, message] = v.parse(parsed, reloadReasonSchema);\n        lc.error?.(reasonType, 'Zero reloaded the page.', message);\n      } catch (e) {\n        lc.error?.('Zero reloaded the page.', e);\n        // ignore if not able to parse\n        return;\n      }\n    }\n  }\n}\n\n/** If a reload is scheduled, do not attempt to reconnect. */\nexport function reloadScheduled() {\n  return reloadTimer !== null;\n}\n\n/** Call upon a successful connection, indicating that backoff should be reset. */\nexport function resetBackoff() {\n  if (typeof sessionStorage !== 'undefined') {\n    sessionStorage.removeItem(RELOAD_BACKOFF_STATE_KEY);\n  }\n}\n\nfunction nextBackoff(lc: LogContext, now: number): BackoffState {\n  if (typeof sessionStorage === 'undefined') {\n    lc.warn?.(\n      `sessionStorage not supported. backing off in ${\n        FALLBACK_RELOAD_INTERVAL_MS / 1000\n      } seconds`,\n    );\n    return {\n      lastReloadTime: now + FALLBACK_RELOAD_INTERVAL_MS,\n      nextIntervalMs: MIN_RELOAD_INTERVAL_MS,\n    };\n  }\n  const val = sessionStorage.getItem(RELOAD_BACKOFF_STATE_KEY);\n  if (!val) {\n    return {lastReloadTime: now, nextIntervalMs: MIN_RELOAD_INTERVAL_MS};\n  }\n  let parsed: BackoffState;\n  try {\n    parsed = v.parse(JSON.parse(val), backoffStateSchema, 'passthrough');\n  } catch (e) {\n    lc.warn?.('ignoring unparsable backoff state', val, e);\n    return {lastReloadTime: now, nextIntervalMs: MIN_RELOAD_INTERVAL_MS};\n  }\n  const {lastReloadTime, nextIntervalMs} = parsed;\n\n  // Backoff state might not have been cleared. Reset for sufficiently old state.\n  if (now - lastReloadTime > MAX_RELOAD_INTERVAL_MS * 2) {\n    return {lastReloadTime: now, nextIntervalMs: MIN_RELOAD_INTERVAL_MS};\n  }\n  if (now < lastReloadTime) {\n    // If the user manually reloaded, stick to the existing schedule.\n    return parsed;\n  }\n  const nextReloadTime = Math.max(now, lastReloadTime + nextIntervalMs);\n  return {\n    lastReloadTime: nextReloadTime,\n    nextIntervalMs: Math.min(nextIntervalMs * 2, MAX_RELOAD_INTERVAL_MS),\n  };\n}\n"],"mappings":";;;;AAOA,IAAa,4BAA4B;AACzC,IAAa,2BAA2B;AAExC,IAAM,qBAAqB,eAAE,MAAM,CACjC,eAAE,MAAM,8BAA8B,eAAe,GACrD,eAAE,OAAO,CACX,CAAC;AAED,IAAM,qBAAqB,eAAE,OAAO;CAClC,gBAAgB,eAAE,OAAO,EAAE,eAAe,CAAC;CAC3C,gBAAgB,eAAE,OAAO,EAAE,eAAe,CAAC;AAC7C,CAAC;AAKD,IAAa,yBAAyB;AAGtC,IAAa,8BAA8B;AAE3C,IAAI,cAAoD;AAIxD,SAAgB,iBACd,IACA,QACA,QACA,SACA;CACA,IAAI,aAAa;EACf,GAAG,OAAO,gCAAgC;EAC1C;CACF;CACA,MAAM,MAAM,KAAK,IAAI;CACrB,MAAM,UAAU,YAAY,IAAI,GAAG;CAGnC,IAAI,OAAO,mBAAmB,aAAa;EACzC,eAAe,QAAQ,0BAA0B,KAAK,UAAU,OAAO,CAAC;EACxE,eAAe,QACb,2BACA,KAAK,UAAU,CAAC,QAAQ,OAAO,CAAC,CAClC;CACF;CAEA,MAAM,QAAQ,QAAQ,iBAAiB;CACvC,GAAG,QACD,QACA,MACA,aACA,QAAQ,IAAI,MAAM,QAAQ,IAAK,YAAY,EAC7C;CACA,cAAc,iBAAiB;EAC7B,cAAc;EACd,OAAO;CACT,GAAG,KAAK;AACV;AAEA,SAAgB,mBAAmB,IAAgB;CACjD,IAAI,OAAO,mBAAmB,aAAa;EACzC,MAAM,QAAQ,eAAe,QAAQ,yBAAyB;EAC9D,IAAI,OAAO;GACT,eAAe,WAAW,yBAAyB;GACnD,IAAI;IAEF,MAAM,CAAC,YAAY,WAAW,MADf,KAAK,MAAM,KACY,GAAQ,kBAAkB;IAChE,GAAG,QAAQ,YAAY,2BAA2B,OAAO;GAC3D,SAAS,GAAG;IACV,GAAG,QAAQ,2BAA2B,CAAC;IAEvC;GACF;EACF;CACF;AACF;;AAGA,SAAgB,kBAAkB;CAChC,OAAO,gBAAgB;AACzB;;AAGA,SAAgB,eAAe;CAC7B,IAAI,OAAO,mBAAmB,aAC5B,eAAe,WAAW,wBAAwB;AAEtD;AAEA,SAAS,YAAY,IAAgB,KAA2B;CAC9D,IAAI,OAAO,mBAAmB,aAAa;EACzC,GAAG,OACD,gDACE,8BAA8B,IAC/B,SACH;EACA,OAAO;GACL,gBAAgB,MAAM;GACtB,gBAAA;EACF;CACF;CACA,MAAM,MAAM,eAAe,QAAQ,wBAAwB;CAC3D,IAAI,CAAC,KACH,OAAO;EAAC,gBAAgB;EAAK,gBAAA;CAAsC;CAErE,IAAI;CACJ,IAAI;EACF,SAAS,MAAQ,KAAK,MAAM,GAAG,GAAG,oBAAoB,aAAa;CACrE,SAAS,GAAG;EACV,GAAG,OAAO,qCAAqC,KAAK,CAAC;EACrD,OAAO;GAAC,gBAAgB;GAAK,gBAAA;EAAsC;CACrE;CACA,MAAM,EAAC,gBAAgB,mBAAkB;CAGzC,IAAI,MAAM,iBAAA,MAA0C,GAClD,OAAO;EAAC,gBAAgB;EAAK,gBAAA;CAAsC;CAErE,IAAI,MAAM,gBAER,OAAO;CAGT,OAAO;EACL,gBAFqB,KAAK,IAAI,KAAK,iBAAiB,cAEpC;EAChB,gBAAgB,KAAK,IAAI,iBAAiB,GAAG,sBAAsB;CACrE;AACF"}

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

@@ -2,7 +2,7 @@
 /**
 * The current version of Zero.
 */
-var version = "1.11.0-canary.3";
+var version = "1.11.0-canary.30";
 //#endregion
 export { version };
 

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

@@ -11,6 +11,7 @@ type TxData = {
     ivmSources: IVMSourceBranch;
     token: string | undefined;
     context: unknown;
+    fork: () => TxData;
 };
 export declare class ZeroRep implements ZeroOption {
     #private;

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

@@ -1 +1 @@
-{"version":3,"file":"zero-rep.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/zero-rep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,2CAA2C,CAAC;AAGzE,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,iCAAiC,CAAC;AAC1D,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAGvD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAK3D,eAAO,MAAM,qBAAqB,SAC1B,MAAM,GAAG,SAAS,GAAG,IAAI,KAC9B,MAA0C,CAAC;AAE9C,eAAO,MAAM,uBAAuB,SAAU,MAAM,KAAG,MAAM,GAAG,SACtC,CAAC;AAE3B,KAAK,MAAM,GAAG;IACZ,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,qBAAa,OAAQ,YAAW,UAAU;;IASxC,YACE,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,eAAe,EACxB,qBAAqB,EAAE,OAAO,EAC9B,eAAe,EAAE,eAAe,EAMjC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,EAEpB;IAEK,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,iBAsBtC;IAED,SAAS,gBACM,IAAI,gBACH,eAAe,KAC5B,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAe5B;IAEF,OAAO,iBAAkB,IAAI,WAAW,IAAI,SAAS,YAAY,KAAG,IAAI,CAEtE;IAEF,aAAa,IAAI,oBAAoB,CAEpC;IACD,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAErE;IACD,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAE1D;CACF"}
+{"version":3,"file":"zero-rep.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/zero-rep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,2CAA2C,CAAC;AAGzE,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,iCAAiC,CAAC;AAC1D,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAGvD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAK3D,eAAO,MAAM,qBAAqB,SAC1B,MAAM,GAAG,SAAS,GAAG,IAAI,KAC9B,MAA0C,CAAC;AAE9C,eAAO,MAAM,uBAAuB,SAAU,MAAM,KAAG,MAAM,GAAG,SACtC,CAAC;AAE3B,KAAK,MAAM,GAAG;IACZ,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,MAAM,CAAC;CACpB,CAAC;AAEF,qBAAa,OAAQ,YAAW,UAAU;;IASxC,YACE,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,eAAe,EACxB,qBAAqB,EAAE,OAAO,EAC9B,eAAe,EAAE,eAAe,EAMjC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,EAEpB;IAEK,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,iBAwBtC;IAED,SAAS,gBACM,IAAI,gBACH,eAAe,KAC5B,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAW5B;IASF,OAAO,iBAAkB,IAAI,WAAW,IAAI,SAAS,YAAY,KAAG,IAAI,CAEtE;IAEF,aAAa,IAAI,oBAAoB,CAEpC;IACD,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAErE;IACD,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAE1D;CACF"}