@rocicorp/zero 1.11.0-canary.2 → 1.11.0-canary.21

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.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":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,4CAA4C,CAAC;AAC/E,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,qCAAqC,CAAC;AAMlE,OAAO,EAAC,OAAO,EAAC,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAGL,KAAK,GAAG,EACT,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,sDAAsD,CAAC;AACtG,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,8CAA8C,CAAC;AAK/E,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,6CAA6C,CAAC;AAUlF,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,0CAA0C,CAAC;AAC1E,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,4CAA4C,CAAC;AAChF,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAuB,KAAK,GAAG,EAAC,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAC,KAAK,SAAS,EAAC,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAkB3D,KAAK,YAAY,GAAG;KACjB,CAAC,IAAI,MAAM,eAAe,GAAG,OAAO;CACtC,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,8BAA8B,EAAE,MAAM,GAAG,SAAS,CAAC;IACnD,kCAAkC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvD,qBAAqB,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF;;;;GAIG;AACH,qBAAa,YAAa,YAAW,iBAAiB;;IAsCpD,YACE,EAAE,EAAE,UAAU,EACd,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,IAAI,EAAE,CAAC,MAAM,EAAE,2BAA2B,KAAK,IAAI,EACnD,iBAAiB,EAAE,cAAc,CAAC,mBAAmB,CAAC,EACtD,oBAAoB,EAAE,MAAM,EAC5B,qBAAqB,EAAE,MAAM,EAC7B,wBAAwB,EAAE,MAAM,EAChC,YAAY,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,EAsEzC;IAED,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAGvC;IAED,uBAAuB,CACrB,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAChE,IAAI,CAEN;IAED,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAElC;IA4BD;;;;;;OAMG;IACH,2BAA2B,IAAI,IAAI,CAoBlC;IAED,4EAA4E;IAC5E,4BAA4B,IAAI,IAAI,CAanC;IAED;;;;;;;;;;;;;;OAcG;IACG,eAAe,CACnB,EAAE,EAAE,eAAe,EACnB,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,GACxC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CA8CxC;IAED,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,QA4B3C;IAED,YAAY,CACV,MAAM,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,eAAe,CAAC,YAAY,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,QAkB3E;IAED,SAAS,CACP,GAAG,EAAE,GAAG,EACR,EAAC,IAAI,EAAE,IAAI,EAAC,EAAE,aAAa,EAC3B,GAAG,EAAE,GAAG,EACR,WAAW,CAAC,EAAE,WAAW,GACxB,MAAM,IAAI,CAIZ;IAED,kBAAkB;IAClB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,IAAI,CAWnE;IA2ED,YAAY,CAAC,EAAC,IAAI,EAAE,IAAI,EAAC,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,QAIjD;IAED,kBAAkB;IAClB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,QAK9B;IAiCD,UAAU,SAcT;IA0BD;;OAEG;IACH,IAAI,OAAO,IAAI,YAAY,CAE1B;IAED,SAAS,CAAC,CAAC,SAAS,MAAM,eAAe,EACvC,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,MAAM,EACb,GAAG,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,IAAI,CAyDN;IAED,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAEjE;IAED;;OAEG;IACH,uBAAuB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAE1C;CACF"}

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";
@@ -30,6 +31,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 +62,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 +103,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 +129,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 +257,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;
@@ -314,11 +351,7 @@ var QueryManager = class {
 			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);

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\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    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    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);\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/version.js

@@ -2,7 +2,7 @@
 /**
 * The current version of Zero.
 */
-var version = "1.11.0-canary.2";
+var version = "1.11.0-canary.21";
 //#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"}

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

@@ -37,16 +37,18 @@ var ZeroRep = class {
 		});
 		this.#store = store;
 		this.#context.processChanges(void 0, hash, diffs);
-		this.#context.markPipelinesReady();
+		await this.#context.hydratePendingPipelines();
 	}
 	getTxData = (desiredHead, readOptions) => {
 		if (!this.#customMutatorsEnabled) return;
-		return this.#ivmMain.forkToHead(must(this.#store), desiredHead, readOptions).then((branch) => ({
-			ivmSources: branch,
-			token: fromReplicacheAuthToken(this.#auth),
-			context: this.#context
-		}));
+		return this.#ivmMain.forkToHead(must(this.#store), desiredHead, readOptions).then((branch) => this.#makeTxData(branch));
 	};
+	#makeTxData = (branch) => ({
+		ivmSources: branch,
+		token: fromReplicacheAuthToken(this.#auth),
+		context: this.#context,
+		fork: () => this.#makeTxData(branch.fork())
+	});
 	advance = (expectedHash, newHash, diffs) => {
 		this.#context.processChanges(expectedHash, newHash, diffs);
 	};

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

@@ -1 +1 @@
-{"version":3,"file":"zero-rep.js","names":["#context","#ivmMain","#customMutatorsEnabled","#mutationTracker","#auth","#store"],"sources":["../../../../../zero-client/src/client/zero-rep.ts"],"sourcesContent":["import type {\n  InternalDiff,\n  InternalDiffOperation,\n} from '../../../replicache/src/btree/node.ts';\nimport type {LazyStore} from '../../../replicache/src/dag/lazy-store.ts';\nimport {readFromHash} from '../../../replicache/src/db/read.ts';\nimport * as FormatVersion from '../../../replicache/src/format-version-enum.ts';\nimport type {Hash} from '../../../replicache/src/hash.ts';\nimport type {\n  EphemeralID,\n  MutationTrackingData,\n  ZeroOption,\n  ZeroReadOptions,\n} from '../../../replicache/src/replicache-options.ts';\nimport {withRead} from '../../../replicache/src/with-transactions.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport type {ZeroContext} from './context.ts';\nimport type {IVMSourceBranch} from './ivm-branch.ts';\nimport {ENTITIES_KEY_PREFIX} from './keys.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\n\n// Replicache doesn't support undefined auth tokens\nconst REPLICACHE_NO_AUTH_TOKEN = '';\n\nexport const toReplicacheAuthToken = (\n  auth: string | undefined | null,\n): string => auth ?? REPLICACHE_NO_AUTH_TOKEN;\n\nexport const fromReplicacheAuthToken = (auth: string): string | undefined =>\n  !auth ? undefined : auth;\n\ntype TxData = {\n  ivmSources: IVMSourceBranch;\n  token: string | undefined;\n  context: unknown;\n};\n\nexport class ZeroRep implements ZeroOption {\n  readonly #context: ZeroContext;\n  readonly #ivmMain: IVMSourceBranch;\n  readonly #customMutatorsEnabled: boolean;\n  readonly #mutationTracker: MutationTracker;\n  #store: LazyStore | undefined;\n  // matches replicache's auth token type\n  #auth: string = REPLICACHE_NO_AUTH_TOKEN;\n\n  constructor(\n    context: ZeroContext,\n    ivmMain: IVMSourceBranch,\n    customMutatorsEnabled: boolean,\n    mutationTracker: MutationTracker,\n  ) {\n    this.#context = context;\n    this.#ivmMain = ivmMain;\n    this.#customMutatorsEnabled = customMutatorsEnabled;\n    this.#mutationTracker = mutationTracker;\n  }\n\n  set auth(auth: string) {\n    this.#auth = auth;\n  }\n\n  async init(hash: Hash, store: LazyStore) {\n    const diffs: InternalDiffOperation[] = [];\n    await withRead(store, async dagRead => {\n      const read = await readFromHash(hash, dagRead, FormatVersion.Latest);\n      for await (const entry of read.map.scan(ENTITIES_KEY_PREFIX, true)) {\n        if (!entry[0].startsWith(ENTITIES_KEY_PREFIX)) {\n          break;\n        }\n        diffs.push({\n          op: 'add',\n          key: entry[0],\n          newValue: entry[1],\n        });\n      }\n    });\n    this.#store = store;\n\n    this.#context.processChanges(undefined, hash, diffs);\n    // Pipelines for queries materialized before this point were deferred so\n    // the replica above was loaded into the sources without fanning out to\n    // them. Build and hydrate them now that the sources are populated.\n    this.#context.markPipelinesReady();\n  }\n\n  getTxData = (\n    desiredHead: Hash,\n    readOptions?: ZeroReadOptions,\n  ): Promise<TxData> | undefined => {\n    // getTxData requires some extensive testing for complete confidence\n    // that it will not break. Do not enable `getTxData` unless the user\n    // has opted into custom mutators.\n    if (!this.#customMutatorsEnabled) {\n      return;\n    }\n\n    return this.#ivmMain\n      .forkToHead(must(this.#store), desiredHead, readOptions)\n      .then(branch => ({\n        ivmSources: branch,\n        token: fromReplicacheAuthToken(this.#auth),\n        context: this.#context,\n      }));\n  };\n\n  advance = (expectedHash: Hash, newHash: Hash, diffs: InternalDiff): void => {\n    this.#context.processChanges(expectedHash, newHash, diffs);\n  };\n\n  trackMutation(): MutationTrackingData {\n    return this.#mutationTracker.trackMutation();\n  }\n  mutationIDAssigned(ephemeralID: EphemeralID, mutationID: number): void {\n    this.#mutationTracker.mutationIDAssigned(ephemeralID, mutationID);\n  }\n  rejectMutation(ephemeralID: EphemeralID, ex: unknown): void {\n    this.#mutationTracker.rejectMutation(ephemeralID, ex);\n  }\n}\n"],"mappings":";;;;;AAsBA,IAAM,2BAA2B;AAEjC,IAAa,yBACX,SACW,QAAQ;AAErB,IAAa,2BAA2B,SACtC,CAAC,OAAO,KAAA,IAAY;AAQtB,IAAa,UAAb,MAA2C;CACzC;CACA;CACA;CACA;CACA;CAEA,QAAgB;CAEhB,YACE,SACA,SACA,uBACA,iBACA;EACA,KAAKA,WAAW;EAChB,KAAKC,WAAW;EAChB,KAAKC,yBAAyB;EAC9B,KAAKC,mBAAmB;CAC1B;CAEA,IAAI,KAAK,MAAc;EACrB,KAAKC,QAAQ;CACf;CAEA,MAAM,KAAK,MAAY,OAAkB;EACvC,MAAM,QAAiC,CAAC;EACxC,MAAM,SAAS,OAAO,OAAM,YAAW;GACrC,MAAM,OAAO,MAAM,aAAa,MAAM,SAAS,CAAoB;GACnE,WAAW,MAAM,SAAS,KAAK,IAAI,KAAA,MAA0B,IAAI,GAAG;IAClE,IAAI,CAAC,MAAM,GAAG,WAAA,IAA8B,GAC1C;IAEF,MAAM,KAAK;KACT,IAAI;KACJ,KAAK,MAAM;KACX,UAAU,MAAM;IAClB,CAAC;GACH;EACF,CAAC;EACD,KAAKC,SAAS;EAEd,KAAKL,SAAS,eAAe,KAAA,GAAW,MAAM,KAAK;EAInD,KAAKA,SAAS,mBAAmB;CACnC;CAEA,aACE,aACA,gBACgC;EAIhC,IAAI,CAAC,KAAKE,wBACR;EAGF,OAAO,KAAKD,SACT,WAAW,KAAK,KAAKI,MAAM,GAAG,aAAa,WAAW,EACtD,MAAK,YAAW;GACf,YAAY;GACZ,OAAO,wBAAwB,KAAKD,KAAK;GACzC,SAAS,KAAKJ;EAChB,EAAE;CACN;CAEA,WAAW,cAAoB,SAAe,UAA8B;EAC1E,KAAKA,SAAS,eAAe,cAAc,SAAS,KAAK;CAC3D;CAEA,gBAAsC;EACpC,OAAO,KAAKG,iBAAiB,cAAc;CAC7C;CACA,mBAAmB,aAA0B,YAA0B;EACrE,KAAKA,iBAAiB,mBAAmB,aAAa,UAAU;CAClE;CACA,eAAe,aAA0B,IAAmB;EAC1D,KAAKA,iBAAiB,eAAe,aAAa,EAAE;CACtD;AACF"}
+{"version":3,"file":"zero-rep.js","names":["#context","#ivmMain","#customMutatorsEnabled","#mutationTracker","#auth","#store","#makeTxData"],"sources":["../../../../../zero-client/src/client/zero-rep.ts"],"sourcesContent":["import type {\n  InternalDiff,\n  InternalDiffOperation,\n} from '../../../replicache/src/btree/node.ts';\nimport type {LazyStore} from '../../../replicache/src/dag/lazy-store.ts';\nimport {readFromHash} from '../../../replicache/src/db/read.ts';\nimport * as FormatVersion from '../../../replicache/src/format-version-enum.ts';\nimport type {Hash} from '../../../replicache/src/hash.ts';\nimport type {\n  EphemeralID,\n  MutationTrackingData,\n  ZeroOption,\n  ZeroReadOptions,\n} from '../../../replicache/src/replicache-options.ts';\nimport {withRead} from '../../../replicache/src/with-transactions.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport type {ZeroContext} from './context.ts';\nimport type {IVMSourceBranch} from './ivm-branch.ts';\nimport {ENTITIES_KEY_PREFIX} from './keys.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\n\n// Replicache doesn't support undefined auth tokens\nconst REPLICACHE_NO_AUTH_TOKEN = '';\n\nexport const toReplicacheAuthToken = (\n  auth: string | undefined | null,\n): string => auth ?? REPLICACHE_NO_AUTH_TOKEN;\n\nexport const fromReplicacheAuthToken = (auth: string): string | undefined =>\n  !auth ? undefined : auth;\n\ntype TxData = {\n  ivmSources: IVMSourceBranch;\n  token: string | undefined;\n  context: unknown;\n  fork: () => TxData;\n};\n\nexport class ZeroRep implements ZeroOption {\n  readonly #context: ZeroContext;\n  readonly #ivmMain: IVMSourceBranch;\n  readonly #customMutatorsEnabled: boolean;\n  readonly #mutationTracker: MutationTracker;\n  #store: LazyStore | undefined;\n  // matches replicache's auth token type\n  #auth: string = REPLICACHE_NO_AUTH_TOKEN;\n\n  constructor(\n    context: ZeroContext,\n    ivmMain: IVMSourceBranch,\n    customMutatorsEnabled: boolean,\n    mutationTracker: MutationTracker,\n  ) {\n    this.#context = context;\n    this.#ivmMain = ivmMain;\n    this.#customMutatorsEnabled = customMutatorsEnabled;\n    this.#mutationTracker = mutationTracker;\n  }\n\n  set auth(auth: string) {\n    this.#auth = auth;\n  }\n\n  async init(hash: Hash, store: LazyStore) {\n    const diffs: InternalDiffOperation[] = [];\n    await withRead(store, async dagRead => {\n      const read = await readFromHash(hash, dagRead, FormatVersion.Latest);\n      for await (const entry of read.map.scan(ENTITIES_KEY_PREFIX, true)) {\n        if (!entry[0].startsWith(ENTITIES_KEY_PREFIX)) {\n          break;\n        }\n        diffs.push({\n          op: 'add',\n          key: entry[0],\n          newValue: entry[1],\n        });\n      }\n    });\n    this.#store = store;\n\n    this.#context.processChanges(undefined, hash, diffs);\n    // Pipelines for queries materialized before this point were deferred so\n    // the replica above was loaded into the sources without fanning out to\n    // them. Build and hydrate them now that the sources are populated,\n    // yielding between pipelines so the app stays responsive. Replicache is\n    // not ready until this returns so no changes arrive in the meantime.\n    await this.#context.hydratePendingPipelines();\n  }\n\n  getTxData = (\n    desiredHead: Hash,\n    readOptions?: ZeroReadOptions,\n  ): Promise<TxData> | undefined => {\n    // getTxData requires some extensive testing for complete confidence\n    // that it will not break. Do not enable `getTxData` unless the user\n    // has opted into custom mutators.\n    if (!this.#customMutatorsEnabled) {\n      return;\n    }\n\n    return this.#ivmMain\n      .forkToHead(must(this.#store), desiredHead, readOptions)\n      .then(branch => this.#makeTxData(branch));\n  };\n\n  #makeTxData = (branch: IVMSourceBranch): TxData => ({\n    ivmSources: branch,\n    token: fromReplicacheAuthToken(this.#auth),\n    context: this.#context,\n    fork: () => this.#makeTxData(branch.fork()),\n  });\n\n  advance = (expectedHash: Hash, newHash: Hash, diffs: InternalDiff): void => {\n    this.#context.processChanges(expectedHash, newHash, diffs);\n  };\n\n  trackMutation(): MutationTrackingData {\n    return this.#mutationTracker.trackMutation();\n  }\n  mutationIDAssigned(ephemeralID: EphemeralID, mutationID: number): void {\n    this.#mutationTracker.mutationIDAssigned(ephemeralID, mutationID);\n  }\n  rejectMutation(ephemeralID: EphemeralID, ex: unknown): void {\n    this.#mutationTracker.rejectMutation(ephemeralID, ex);\n  }\n}\n"],"mappings":";;;;;AAsBA,IAAM,2BAA2B;AAEjC,IAAa,yBACX,SACW,QAAQ;AAErB,IAAa,2BAA2B,SACtC,CAAC,OAAO,KAAA,IAAY;AAStB,IAAa,UAAb,MAA2C;CACzC;CACA;CACA;CACA;CACA;CAEA,QAAgB;CAEhB,YACE,SACA,SACA,uBACA,iBACA;EACA,KAAKA,WAAW;EAChB,KAAKC,WAAW;EAChB,KAAKC,yBAAyB;EAC9B,KAAKC,mBAAmB;CAC1B;CAEA,IAAI,KAAK,MAAc;EACrB,KAAKC,QAAQ;CACf;CAEA,MAAM,KAAK,MAAY,OAAkB;EACvC,MAAM,QAAiC,CAAC;EACxC,MAAM,SAAS,OAAO,OAAM,YAAW;GACrC,MAAM,OAAO,MAAM,aAAa,MAAM,SAAS,CAAoB;GACnE,WAAW,MAAM,SAAS,KAAK,IAAI,KAAA,MAA0B,IAAI,GAAG;IAClE,IAAI,CAAC,MAAM,GAAG,WAAA,IAA8B,GAC1C;IAEF,MAAM,KAAK;KACT,IAAI;KACJ,KAAK,MAAM;KACX,UAAU,MAAM;IAClB,CAAC;GACH;EACF,CAAC;EACD,KAAKC,SAAS;EAEd,KAAKL,SAAS,eAAe,KAAA,GAAW,MAAM,KAAK;EAMnD,MAAM,KAAKA,SAAS,wBAAwB;CAC9C;CAEA,aACE,aACA,gBACgC;EAIhC,IAAI,CAAC,KAAKE,wBACR;EAGF,OAAO,KAAKD,SACT,WAAW,KAAK,KAAKI,MAAM,GAAG,aAAa,WAAW,EACtD,MAAK,WAAU,KAAKC,YAAY,MAAM,CAAC;CAC5C;CAEA,eAAe,YAAqC;EAClD,YAAY;EACZ,OAAO,wBAAwB,KAAKF,KAAK;EACzC,SAAS,KAAKJ;EACd,YAAY,KAAKM,YAAY,OAAO,KAAK,CAAC;CAC5C;CAEA,WAAW,cAAoB,SAAe,UAA8B;EAC1E,KAAKN,SAAS,eAAe,cAAc,SAAS,KAAK;CAC3D;CAEA,gBAAsC;EACpC,OAAO,KAAKG,iBAAiB,cAAc;CAC7C;CACA,mBAAmB,aAA0B,YAA0B;EACrE,KAAKA,iBAAiB,mBAAmB,aAAa,UAAU;CAClE;CACA,eAAe,aAA0B,IAAmB;EAC1D,KAAKA,iBAAiB,eAAe,aAAa,EAAE;CACtD;AACF"}

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

@@ -1,6 +1,7 @@
 import { LogContext } from '@rocicorp/logger';
 import { type Resolver } from '@rocicorp/resolver';
 import { ReplicacheImpl } from '../../../replicache/src/impl.ts';
+import type { Store as KVStore } from '../../../replicache/src/kv/store.ts';
 import type { Puller } from '../../../replicache/src/puller.ts';
 import type { Pusher } from '../../../replicache/src/pusher.ts';
 import type { ClientGroupID, ClientID } from '../../../replicache/src/sync/ids.ts';
@@ -107,8 +108,11 @@ export declare class Zero<const S extends BaseDefaultSchema = DefaultSchema, MD
      * This function is useful when you want to populate the cache ahead of time,
      * for example after login, to avoid a flash of loading screen on the next page.
      *
-     * Returns an object with two properties:
-     * - `complete`: a Promise that resolves when the data is loaded
+     * Returns an object with three properties:
+     * - `complete`: a Promise that resolves when the server has confirmed the
+     *   data on this connection
+     * - `cached`: a Promise that resolves as soon as the store holds a
+     *   server-confirmed result, from this connection or a previous one
      * - `cleanup`: a function that can be called to cancel the preload
      *
      * @example
@@ -121,12 +125,15 @@ export declare class Zero<const S extends BaseDefaultSchema = DefaultSchema, MD
     preload<TTable extends keyof S['tables'] & string, TInput extends ReadonlyJSONValue | undefined, TOutput extends ReadonlyJSONValue | undefined, TReturn>(query: QueryOrQueryRequest<TTable, TInput, TOutput, S, TReturn, C>, options?: PreloadOptions): {
         cleanup: () => void;
         complete: Promise<void>;
+        cached: Promise<void>;
     };
     /**
      * Executes a query once and returns the results.
      *
      * By default, runs immediately with whatever data is available locally.
-     * Use `{type: 'complete'}` to wait for fresh results from the server.
+     * Use `{type: 'complete'}` to wait for fresh results from the server, or
+     * `{type: 'cached'}` to accept a result the server confirmed on a previous
+     * connection when the store holds one.
      *
      * @param query - The query to execute
      * @param runOptions - Options controlling query execution
@@ -178,6 +185,14 @@ export declare class Zero<const S extends BaseDefaultSchema = DefaultSchema, MD
      * instance of Zero is stored.
      */
     get idbName(): string;
+    /**
+     * The KV store backing this instance of Zero. Its `kind` is the storage
+     * currently in use: `'idb'`, `'mem'`, `'op-sqlite'`, `'expo-sqlite'`, or
+     * whatever a custom store reports. An IndexedDB store that fails to open
+     * falls back to memory, so `kind` can change from `'idb'` to `'mem'` after
+     * the first read or write.
+     */
+    get kvStore(): KVStore;
     /**
      * The schema version of the data understood by this application.
      * See [[ZeroOptions.schemaVersion]].

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

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