@rocicorp/zero 1.6.0-canary.0 → 1.6.0-canary.10

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

@@ -1,63 +0,0 @@
-import { assert } from "../../../shared/src/asserts.js";
-import { must } from "../../../shared/src/must.js";
-import { createRunnableBuilder } from "../../../zql/src/query/create-builder.js";
-import "../../../zql/src/query/query.js";
-import { zeroData } from "../../../replicache/src/transactions.js";
-import { emptyFunction } from "../../../shared/src/sentinels.js";
-import { ZeroContext } from "./context.js";
-import { makeCRUDExecutor } from "./crud.js";
-import { makeTransactionMutate } from "../../../zql/src/mutate/crud.js";
-//#region ../zero-client/src/client/custom.ts
-var TransactionImpl = class {
-	location = "client";
-	mutate;
-	/**
-	* @deprecated Use {@linkcode createBuilder} with `tx.run(zql.table.where(...))` instead.
-	*/
-	query;
-	#repTx;
-	#zeroContext;
-	constructor(lc, repTx, schema) {
-		must(repTx.reason === "initial" || repTx.reason === "rebase");
-		const txData = getZeroTxData(repTx);
-		const ivmBranch = txData.ivmSources;
-		this.#repTx = repTx;
-		this.mutate = makeTransactionMutate(schema, makeCRUDExecutor(repTx, schema, ivmBranch));
-		const zeroContext = newZeroContext(lc, txData.ivmSources);
-		this.query = createRunnableBuilder(zeroContext, schema);
-		this.#zeroContext = zeroContext;
-	}
-	get clientID() {
-		return this.#repTx.clientID;
-	}
-	get mutationID() {
-		return this.#repTx.mutationID;
-	}
-	get reason() {
-		return this.#repTx.reason === "initial" ? "optimistic" : "rebase";
-	}
-	get token() {
-		return this.#repTx[zeroData]?.token;
-	}
-	run(query, options) {
-		return this.#zeroContext.run(query, options);
-	}
-};
-function getZeroTxData(repTx) {
-	return must(repTx[zeroData], "zero was not set on replicache internal options!");
-}
-function makeReplicacheMutator(lc, mutator, schema, context) {
-	return async (repTx, args) => {
-		await mutator(new TransactionImpl(lc, repTx, schema), args, context);
-	};
-}
-function assertValidRunOptions(options) {
-	assert(options?.type !== "complete", "Cannot wait for complete results in custom mutations");
-}
-function newZeroContext(lc, ivmBranch) {
-	return new ZeroContext(lc, ivmBranch, () => emptyFunction, () => emptyFunction, emptyFunction, emptyFunction, emptyFunction, (applyViewUpdates) => applyViewUpdates(), emptyFunction, assertValidRunOptions);
-}
-//#endregion
-export { TransactionImpl, makeReplicacheMutator };
-
-//# sourceMappingURL=custom.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"custom.js","names":["#repTx","#zeroContext"],"sources":["../../../../../zero-client/src/client/custom.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {ZeroTxData} from '../../../replicache/src/replicache-options.ts';\nimport type {WriteTransactionImpl} from '../../../replicache/src/transactions.ts';\nimport {zeroData} from '../../../replicache/src/transactions.ts';\nimport {assert} from '../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport {emptyFunction} from '../../../shared/src/sentinels.ts';\nimport type {DefaultSchema} from '../../../zero-types/src/default-types.ts';\nimport type {Schema} from '../../../zero-types/src/schema.ts';\nimport {\n  makeTransactionMutate,\n  type TransactionMutate,\n} from '../../../zql/src/mutate/crud.ts';\nimport type {\n  ClientTransaction,\n  Transaction,\n} from '../../../zql/src/mutate/custom.ts';\nimport {createRunnableBuilder} from '../../../zql/src/query/create-builder.ts';\nimport {\n  type HumanReadable,\n  type Query,\n  type RunOptions,\n} from '../../../zql/src/query/query.ts';\nimport type {ConditionalSchemaQuery} from '../../../zql/src/query/schema-query.ts';\nimport type {ClientID} from '../types/client-state.ts';\nimport {ZeroContext} from './context.ts';\nimport {makeCRUDExecutor} from './crud.ts';\nimport type {IVMSourceBranch} from './ivm-branch.ts';\nimport type {WriteTransaction} from './replicache-types.ts';\n\n/**\n * The shape which a user's custom mutator definitions must conform to.\n * Supports arbitrary depth nesting of namespaces.\n */\nexport type CustomMutatorDefs = {\n  // oxlint-disable-next-line no-explicit-any\n  [namespaceOrKey: string]: CustomMutatorImpl<any> | CustomMutatorDefs;\n};\n\nexport type MutatorResultDetails =\n  | {\n      readonly type: 'success';\n    }\n  | {\n      readonly type: 'error';\n      readonly error:\n        | {\n            readonly type: 'app';\n            readonly message: string;\n            readonly details: ReadonlyJSONValue | undefined;\n          }\n        | {\n            readonly type: 'zero';\n            readonly message: string;\n          };\n    };\n\nexport type MutatorResultSuccessDetails = Extract<\n  MutatorResultDetails,\n  {type: 'success'}\n>;\nexport type MutatorResultErrorDetails = Extract<\n  MutatorResultDetails,\n  {type: 'error'}\n>;\n\nexport type MutatorResult = {\n  client: Promise<MutatorResultDetails & {}>;\n  server: Promise<MutatorResultDetails & {}>;\n} & {};\n\nexport type CustomMutatorImpl<\n  S extends Schema,\n  TWrappedTransaction = unknown,\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  TArgs = any,\n  Context = unknown,\n> = (\n  tx: Transaction<S, TWrappedTransaction>,\n  // TODO: many args. See commit: 52657c2f934b4a458d628ea77e56ce92b61eb3c6 which did have many args.\n  // The issue being that it will be a protocol change to support varargs.\n  args: TArgs,\n  ctx: Context,\n) => Promise<void>;\n\n/**\n * The shape exposed on the `Zero.mutate` instance.\n * The signature of a custom mutator takes a `transaction` as its first arg\n * but the user does not provide this arg when calling the mutator.\n *\n * This utility strips the `tx` arg from the user's custom mutator signatures.\n * Supports arbitrary depth nesting of namespaces.\n */\nexport type MakeCustomMutatorInterfaces<\n  S extends Schema,\n  MD extends CustomMutatorDefs,\n  TContext,\n> = {\n  readonly [NamespaceOrName in keyof MD]: MD[NamespaceOrName] extends (\n    tx: Transaction<S>,\n    ...args: infer Args\n  ) => Promise<void>\n    ? (...args: Args) => MutatorResult\n    : MD[NamespaceOrName] extends CustomMutatorDefs\n      ? MakeCustomMutatorInterfaces<S, MD[NamespaceOrName], TContext>\n      : never;\n};\n\nexport type MakeCustomMutatorInterface<TSchema extends Schema, F> = F extends (\n  tx: ClientTransaction<TSchema>,\n  ...args: infer Args\n) => Promise<void>\n  ? (...args: Args) => MutatorResult\n  : never;\n\nexport class TransactionImpl<\n  TSchema extends Schema = DefaultSchema,\n> implements ClientTransaction<TSchema> {\n  readonly location = 'client';\n  readonly mutate: TransactionMutate<TSchema>;\n  /**\n   * @deprecated Use {@linkcode createBuilder} with `tx.run(zql.table.where(...))` instead.\n   */\n  readonly query: ConditionalSchemaQuery<TSchema>;\n\n  readonly #repTx: WriteTransaction;\n  readonly #zeroContext: ZeroContext;\n\n  constructor(lc: LogContext, repTx: WriteTransaction, schema: TSchema) {\n    must(repTx.reason === 'initial' || repTx.reason === 'rebase');\n    const txData = getZeroTxData(repTx);\n    const ivmBranch = txData.ivmSources as IVMSourceBranch;\n\n    this.#repTx = repTx;\n\n    const executor = makeCRUDExecutor(repTx, schema, ivmBranch);\n    this.mutate = makeTransactionMutate(schema, executor);\n\n    const zeroContext = newZeroContext(\n      lc,\n      txData.ivmSources as IVMSourceBranch,\n    );\n\n    this.query = createRunnableBuilder(zeroContext, schema);\n\n    this.#zeroContext = zeroContext;\n  }\n\n  get clientID(): ClientID {\n    return this.#repTx.clientID;\n  }\n\n  get mutationID(): number {\n    return this.#repTx.mutationID;\n  }\n\n  get reason(): 'optimistic' | 'rebase' {\n    return this.#repTx.reason === 'initial' ? 'optimistic' : 'rebase';\n  }\n\n  get token(): string | undefined {\n    return (this.#repTx as WriteTransactionImpl)[zeroData]?.token;\n  }\n\n  run<TTable extends keyof TSchema['tables'] & string, TReturn>(\n    query: Query<TTable, TSchema, TReturn>,\n    options?: RunOptions,\n  ): Promise<HumanReadable<TReturn>> {\n    return this.#zeroContext.run(query, options);\n  }\n}\n\nexport function getZeroTxData(repTx: WriteTransaction): ZeroTxData {\n  const txData = must(\n    (repTx as WriteTransactionImpl)[zeroData],\n    'zero was not set on replicache internal options!',\n  );\n  return txData as ZeroTxData;\n}\n\nexport function makeReplicacheMutator<\n  S extends Schema,\n  TWrappedTransaction,\n  Context,\n>(\n  lc: LogContext,\n  mutator: CustomMutatorImpl<S, TWrappedTransaction>,\n  schema: S,\n  context: Context,\n): (repTx: WriteTransaction, args: ReadonlyJSONValue) => Promise<void> {\n  return async (\n    repTx: WriteTransaction,\n    args: ReadonlyJSONValue,\n  ): Promise<void> => {\n    const tx = new TransactionImpl(lc, repTx, schema);\n    await mutator(tx, args, context);\n  };\n}\n\nfunction assertValidRunOptions(options: RunOptions | undefined): void {\n  // TODO(arv): We should enforce this with the type system too.\n  assert(\n    options?.type !== 'complete',\n    'Cannot wait for complete results in custom mutations',\n  );\n}\n\nfunction newZeroContext(lc: LogContext, ivmBranch: IVMSourceBranch) {\n  return new ZeroContext(\n    lc,\n    ivmBranch,\n    () => emptyFunction,\n    () => emptyFunction,\n    emptyFunction,\n    emptyFunction,\n    emptyFunction,\n    applyViewUpdates => applyViewUpdates(),\n    emptyFunction,\n    assertValidRunOptions,\n  );\n}\n"],"mappings":";;;;;;;;;;AAoHA,IAAa,kBAAb,MAEwC;CACtC,WAAoB;CACpB;;;;CAIA;CAEA;CACA;CAEA,YAAY,IAAgB,OAAyB,QAAiB;AACpE,OAAK,MAAM,WAAW,aAAa,MAAM,WAAW,SAAS;EAC7D,MAAM,SAAS,cAAc,MAAM;EACnC,MAAM,YAAY,OAAO;AAEzB,QAAA,QAAc;AAGd,OAAK,SAAS,sBAAsB,QADnB,iBAAiB,OAAO,QAAQ,UAAU,CACN;EAErD,MAAM,cAAc,eAClB,IACA,OAAO,WACR;AAED,OAAK,QAAQ,sBAAsB,aAAa,OAAO;AAEvD,QAAA,cAAoB;;CAGtB,IAAI,WAAqB;AACvB,SAAO,MAAA,MAAY;;CAGrB,IAAI,aAAqB;AACvB,SAAO,MAAA,MAAY;;CAGrB,IAAI,SAAkC;AACpC,SAAO,MAAA,MAAY,WAAW,YAAY,eAAe;;CAG3D,IAAI,QAA4B;AAC9B,SAAQ,MAAA,MAAqC,WAAW;;CAG1D,IACE,OACA,SACiC;AACjC,SAAO,MAAA,YAAkB,IAAI,OAAO,QAAQ;;;AAIhD,SAAgB,cAAc,OAAqC;AAKjE,QAJe,KACZ,MAA+B,WAChC,mDACD;;AAIH,SAAgB,sBAKd,IACA,SACA,QACA,SACqE;AACrE,QAAO,OACL,OACA,SACkB;AAElB,QAAM,QADK,IAAI,gBAAgB,IAAI,OAAO,OAAO,EAC/B,MAAM,QAAQ;;;AAIpC,SAAS,sBAAsB,SAAuC;AAEpE,QACE,SAAS,SAAS,YAClB,uDACD;;AAGH,SAAS,eAAe,IAAgB,WAA4B;AAClE,QAAO,IAAI,YACT,IACA,iBACM,qBACA,eACN,eACA,eACA,gBACA,qBAAoB,kBAAkB,EACtC,eACA,sBACD"}

package/out/zero-client/src/client/delete-clients-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"delete-clients-manager.js","names":["#send","#lc","#dagStore","#clientGroupID","#clientID"],"sources":["../../../../../zero-client/src/client/delete-clients-manager.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {Store} from '../../../replicache/src/dag/store.ts';\nimport {\n  confirmDeletedClients,\n  getDeletedClients,\n  type DeletedClients,\n} from '../../../replicache/src/deleted-clients.ts';\nimport type {ClientGroupID} from '../../../replicache/src/sync/ids.ts';\nimport {\n  withRead,\n  withWrite,\n} from '../../../replicache/src/with-transactions.ts';\nimport {assert} from '../../../shared/src/asserts.ts';\nimport {promiseVoid} from '../../../shared/src/resolved-promises.ts';\nimport type {\n  DeleteClientsBody,\n  DeleteClientsMessage,\n} from '../../../zero-protocol/src/delete-clients.ts';\n\nfunction filterAndAssert(\n  deletedClients: DeletedClients,\n  clientGroupID: ClientGroupID,\n  clientID: string,\n  caller: string,\n): string[] {\n  const clientIDs = deletedClients\n    .filter(dc => dc.clientGroupID === clientGroupID)\n    .map(dc => dc.clientID);\n  for (const cid of clientIDs) {\n    assert(cid !== clientID, `cannot delete self in ${caller}`);\n  }\n  return clientIDs;\n}\n\n/**\n * Replicache will tell us when it deletes clients from the persistent storage\n * due to GC. When this happens we tell the server about the deleted clients.\n * Replicache also store the deleted clients in IDB in case the server is\n * currently offline.\n *\n * The server will reply with the client it actually deleted. When we get that\n * we remove those IDs from our local storage.\n */\nexport class DeleteClientsManager {\n  readonly #send: (msg: DeleteClientsMessage) => void;\n  readonly #lc: LogContext;\n  readonly #dagStore: Store;\n  readonly #clientGroupID: Promise<ClientGroupID>;\n  readonly #clientID: string;\n\n  constructor(\n    send: (msg: DeleteClientsMessage) => void,\n    dagStore: Store,\n    lc: LogContext,\n    clientGroupID: Promise<ClientGroupID>,\n    clientID: string,\n  ) {\n    this.#send = send;\n    this.#dagStore = dagStore;\n    this.#lc = lc;\n    this.#clientGroupID = clientGroupID;\n    this.#clientID = clientID;\n  }\n\n  /**\n   * This gets called by Replicache when it deletes clients from the persistent\n   * storage.\n   */\n  async onClientsDeleted(deletedClients: DeletedClients): Promise<void> {\n    this.#lc.debug?.('DeletedClientsManager, send:', deletedClients);\n    const clientGroupID = await this.#clientGroupID;\n    const clientIDs = filterAndAssert(\n      deletedClients,\n      clientGroupID,\n      this.#clientID,\n      'onClientsDeleted',\n    );\n    this.#send([\n      'deleteClients',\n      {\n        clientIDs,\n      },\n    ]);\n  }\n\n  /**\n   * Zero calls this after it connects to ensure that the server knows about all\n   * the clients that might have been deleted locally since the last connection.\n   */\n  async sendDeletedClientsToServer(): Promise<void> {\n    const clientGroupID = await this.#clientGroupID;\n    const deleted = await withRead(this.#dagStore, dagRead =>\n      getDeletedClients(dagRead),\n    );\n\n    const clientIDs = filterAndAssert(\n      deleted,\n      clientGroupID,\n      this.#clientID,\n      'sendDeletedClientsToServer',\n    );\n\n    if (clientIDs.length > 0) {\n      this.#send(['deleteClients', {clientIDs}]);\n      this.#lc.debug?.('DeletedClientsManager, send:', deleted);\n    }\n  }\n\n  /**\n   * This is called as a response to the server telling us which clients it\n   * actually deleted.\n   */\n  clientsDeletedOnServer(deletedClients: DeleteClientsBody): Promise<void> {\n    const {clientIDs = [], clientGroupIDs = []} = deletedClients;\n    if (clientIDs.length > 0 || clientGroupIDs.length > 0) {\n      // Get the deleted clients from the dag and remove the ones from the server.\n      // then write them back to the dag.\n      return withWrite(this.#dagStore, async dagWrite => {\n        this.#lc.debug?.('clientsDeletedOnServer:', clientIDs, clientGroupIDs);\n        await confirmDeletedClients(dagWrite, clientIDs, clientGroupIDs);\n      });\n    }\n    return promiseVoid;\n  }\n\n  async getDeletedClients(): Promise<DeletedClients> {\n    const deletedClients = await withRead(this.#dagStore, read =>\n      getDeletedClients(read),\n    );\n    const clientGroupID = await this.#clientGroupID;\n    filterAndAssert(\n      deletedClients,\n      clientGroupID,\n      this.#clientID,\n      'getDeletedClients',\n    );\n    return deletedClients.filter(d => d.clientGroupID === clientGroupID);\n  }\n}\n"],"mappings":";;;;;AAmBA,SAAS,gBACP,gBACA,eACA,UACA,QACU;CACV,MAAM,YAAY,eACf,QAAO,OAAM,GAAG,kBAAkB,cAAc,CAChD,KAAI,OAAM,GAAG,SAAS;AACzB,MAAK,MAAM,OAAO,UAChB,QAAO,QAAQ,UAAU,yBAAyB,SAAS;AAE7D,QAAO;;;;;;;;;;;AAYT,IAAa,uBAAb,MAAkC;CAChC;CACA;CACA;CACA;CACA;CAEA,YACE,MACA,UACA,IACA,eACA,UACA;AACA,QAAA,OAAa;AACb,QAAA,WAAiB;AACjB,QAAA,KAAW;AACX,QAAA,gBAAsB;AACtB,QAAA,WAAiB;;;;;;CAOnB,MAAM,iBAAiB,gBAA+C;AACpE,QAAA,GAAS,QAAQ,gCAAgC,eAAe;EAEhE,MAAM,YAAY,gBAChB,gBAFoB,MAAM,MAAA,eAI1B,MAAA,UACA,mBACD;AACD,QAAA,KAAW,CACT,iBACA,EACE,WACD,CACF,CAAC;;;;;;CAOJ,MAAM,6BAA4C;EAChD,MAAM,gBAAgB,MAAM,MAAA;EAC5B,MAAM,UAAU,MAAM,SAAS,MAAA,WAAgB,YAC7C,kBAAkB,QAAQ,CAC3B;EAED,MAAM,YAAY,gBAChB,SACA,eACA,MAAA,UACA,6BACD;AAED,MAAI,UAAU,SAAS,GAAG;AACxB,SAAA,KAAW,CAAC,iBAAiB,EAAC,WAAU,CAAC,CAAC;AAC1C,SAAA,GAAS,QAAQ,gCAAgC,QAAQ;;;;;;;CAQ7D,uBAAuB,gBAAkD;EACvE,MAAM,EAAC,YAAY,EAAE,EAAE,iBAAiB,EAAE,KAAI;AAC9C,MAAI,UAAU,SAAS,KAAK,eAAe,SAAS,EAGlD,QAAO,UAAU,MAAA,UAAgB,OAAM,aAAY;AACjD,SAAA,GAAS,QAAQ,2BAA2B,WAAW,eAAe;AACtE,SAAM,sBAAsB,UAAU,WAAW,eAAe;IAChE;AAEJ,SAAO;;CAGT,MAAM,oBAA6C;EACjD,MAAM,iBAAiB,MAAM,SAAS,MAAA,WAAgB,SACpD,kBAAkB,KAAK,CACxB;EACD,MAAM,gBAAgB,MAAM,MAAA;AAC5B,kBACE,gBACA,eACA,MAAA,UACA,oBACD;AACD,SAAO,eAAe,QAAO,MAAK,EAAE,kBAAkB,cAAc"}

package/out/zero-client/src/client/enable-analytics.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"enable-analytics.js","names":[],"sources":["../../../../../zero-client/src/client/enable-analytics.ts"],"sourcesContent":["// https://www.oreilly.com/library/view/regular-expressions-cookbook/9780596802837/ch07s16.html\nconst IPV4_ADDRESS_REGEX =\n  /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;\n// This doesn't ensure a valid ipv6, but any ipv6 hostname will\n// match this regex, and no domain based hostnames will.\nconst IPV6_ADDRESS_HOSTNAME_REGEX = /^\\[[a-fA-F0-9:]*:[a-fA-F0-9:]*\\]$/;\n\nexport const IP_ADDRESS_HOSTNAME_REGEX = new RegExp(\n  `(${IPV4_ADDRESS_REGEX.source}|${IPV6_ADDRESS_HOSTNAME_REGEX.source})`,\n);\n\nexport function shouldEnableAnalytics(\n  server: string | null,\n  enableAnalytics = true,\n): boolean {\n  if (!enableAnalytics) {\n    return false;\n  }\n  const serverURL = server === null ? null : new URL(server);\n  const socketHostname = serverURL?.hostname;\n  // If the hostname is undefined, localhost, or an ip address, then\n  // this is most likely a test or local development, in which case we\n  // do not want to enable analytics.\n  return (\n    server !== null &&\n    socketHostname !== undefined &&\n    socketHostname !== 'localhost' &&\n    !IP_ADDRESS_HOSTNAME_REGEX.test(socketHostname)\n  );\n}\n"],"mappings":"AAOA,IAAa,4BAA4B,IAAI,OAC3C,IANA,8FAMuB,OAAO,GAHI,oCAG2B,OAAO,GACrE;AAED,SAAgB,sBACd,QACA,kBAAkB,MACT;AACT,KAAI,CAAC,gBACH,QAAO;CAGT,MAAM,kBADY,WAAW,OAAO,OAAO,IAAI,IAAI,OAAO,GACxB;AAIlC,QACE,WAAW,QACX,mBAAmB,KAAA,KACnB,mBAAmB,eACnB,CAAC,0BAA0B,KAAK,eAAe"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"error.js","names":[],"sources":["../../../../../zero-client/src/client/error.ts"],"sourcesContent":["import {unreachable} from '../../../shared/src/asserts.ts';\nimport {getErrorMessage} from '../../../shared/src/error.ts';\nimport type {Expand} from '../../../shared/src/expand.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 type {ProtocolError} from '../../../zero-protocol/src/error.ts';\nimport {\n  type BackoffBody,\n  type ErrorBody,\n  isProtocolError,\n  type PushFailedBody,\n  type TransformFailedBody,\n} from '../../../zero-protocol/src/error.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport {ConnectionStatus} from './connection-status.ts';\n\nexport type AuthError = ProtocolError<NeedsAuthReason>;\nexport type ClientErrorBody = {\n  kind: ClientErrorKind;\n  origin: typeof ErrorOrigin.Client;\n  message: string;\n};\nexport type ClosedError = ClientError<{\n  kind: ClientErrorKind.ClientClosed;\n  message: string;\n}>;\nexport type NeedsAuthReason = Expand<\n  | (ErrorBody & {\n      kind: ErrorKind.AuthInvalidated | ErrorKind.Unauthorized;\n    })\n  | (Extract<PushFailedBody, {reason: ErrorReason.HTTP}> & {status: 401 | 403})\n  | (Extract<TransformFailedBody, {reason: ErrorReason.HTTP}> & {\n      status: 401 | 403;\n    })\n>;\nexport type OfflineError = ClientError<{\n  kind: ClientErrorKind.Offline;\n  message: string;\n}>;\nexport type NoSocketOriginError = ClientError<{\n  kind: ClientErrorKind.NoSocketOrigin;\n  message: string;\n}>;\nexport type HiddenError = ClientError<{\n  kind: ClientErrorKind.Hidden;\n  message: string;\n}>;\nexport type DisconnectedReason =\n  | OfflineError\n  | NoSocketOriginError\n  | HiddenError;\nexport type ServerError = ProtocolError<ErrorBody>;\nexport type ZeroError = ServerError | ClientError;\nexport type ZeroErrorBody = Expand<ErrorBody | ClientErrorBody>;\nexport type ZeroErrorDetails = Expand<Omit<ZeroErrorBody, 'message'>>;\nexport type ZeroErrorKind = Expand<ErrorKind | ClientErrorKind>;\n\n/**\n * Represents an error encountered by the Zero client.\n */\nexport class ClientError<\n  const T extends Omit<ClientErrorBody, 'origin'> = Omit<\n    ClientErrorBody,\n    'origin'\n  >,\n> extends Error {\n  readonly errorBody: {origin: typeof ErrorOrigin.Client} & T;\n\n  constructor(errorBody: T, options?: ErrorOptions) {\n    super(errorBody.message, options);\n    this.name = 'ClientError';\n    this.errorBody = {...errorBody, origin: ErrorOrigin.Client};\n  }\n\n  get kind(): T['kind'] {\n    return this.errorBody.kind;\n  }\n}\n\nexport function isZeroError(ex: unknown): ex is ZeroError {\n  return isClientError(ex) || isServerError(ex);\n}\n\nexport function isClientError(ex: unknown): ex is ClientError<ClientErrorBody> {\n  return (\n    ex instanceof ClientError && ex.errorBody.origin === ErrorOrigin.Client\n  );\n}\n\nexport function isServerError(ex: unknown): ex is ServerError {\n  return (\n    isProtocolError(ex) &&\n    (ex.errorBody.origin === ErrorOrigin.Server ||\n      ex.errorBody.origin === ErrorOrigin.ZeroCache)\n  );\n}\n\nexport function isOfflineError(ex: unknown): ex is OfflineError {\n  return isClientError(ex) && ex.kind === ClientErrorKind.Offline;\n}\n\nexport function isAuthError(ex: unknown): ex is AuthError {\n  if (isServerError(ex)) {\n    if (\n      ex.kind === ErrorKind.AuthInvalidated ||\n      ex.kind === ErrorKind.Unauthorized\n    ) {\n      return true;\n    }\n    if (\n      (ex.errorBody.kind === ErrorKind.PushFailed ||\n        ex.errorBody.kind === ErrorKind.TransformFailed) &&\n      ex.errorBody.reason === ErrorReason.HTTP &&\n      (ex.errorBody.status === 401 || ex.errorBody.status === 403)\n    ) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nexport function getBackoffParams(error: ZeroError): BackoffBody | undefined {\n  if (isServerError(error)) {\n    switch (error.errorBody.kind) {\n      case ErrorKind.Rebalance:\n      case ErrorKind.Rehome:\n      case ErrorKind.ServerOverloaded:\n        return error.errorBody;\n    }\n  }\n  return undefined;\n}\n\nexport const NO_STATUS_TRANSITION = 'NO_STATUS_TRANSITION';\n\nexport type ErrorConnectionTransition =\n  | {status: typeof NO_STATUS_TRANSITION; reason: ZeroError}\n  | {status: ConnectionStatus.NeedsAuth; reason: AuthError}\n  | {status: ConnectionStatus.Error; reason: ZeroError}\n  | {status: ConnectionStatus.Disconnected; reason: DisconnectedReason}\n  | {status: ConnectionStatus.Closed; reason: ZeroError};\n\n/**\n * Returns the status to transition to, or null if the error\n * indicates that the connection should continue in the current state.\n */\nexport function getErrorConnectionTransition(\n  ex: unknown,\n): ErrorConnectionTransition {\n  // Handle auth errors by transitioning to needs-auth state\n  if (isAuthError(ex)) {\n    return {\n      status: ConnectionStatus.NeedsAuth,\n      reason: ex,\n    } as const;\n  }\n\n  if (isClientError(ex)) {\n    switch (ex.kind) {\n      // Connecting errors that should continue in the current state\n      case ClientErrorKind.AbruptClose:\n      case ClientErrorKind.CleanClose:\n      case ClientErrorKind.ConnectTimeout:\n      case ClientErrorKind.PingTimeout:\n      case ClientErrorKind.PullTimeout:\n      case ClientErrorKind.UnexpectedBaseCookie:\n        return {status: NO_STATUS_TRANSITION, reason: ex} as const;\n\n      // Fatal errors that should transition to error state\n      case ClientErrorKind.Internal:\n      case ClientErrorKind.InvalidMessage:\n      case ClientErrorKind.UserDisconnect:\n        return {status: ConnectionStatus.Error, reason: ex} as const;\n\n      // Disconnected errors\n      case ClientErrorKind.Hidden:\n      case ClientErrorKind.Offline:\n      case ClientErrorKind.NoSocketOrigin:\n        return {\n          status: ConnectionStatus.Disconnected,\n          reason: ex as DisconnectedReason,\n        } as const;\n\n      // Closed error (this should already result in a closed state)\n      case ClientErrorKind.ClientClosed:\n        return {status: ConnectionStatus.Closed, reason: ex} as const;\n\n      default:\n        unreachable(ex.kind);\n    }\n  }\n\n  if (isServerError(ex)) {\n    switch (ex.kind) {\n      // Errors that should transition to error state\n      case ErrorKind.ClientNotFound:\n      case ErrorKind.InvalidConnectionRequest:\n      case ErrorKind.InvalidConnectionRequestBaseCookie:\n      case ErrorKind.InvalidConnectionRequestLastMutationID:\n      case ErrorKind.InvalidConnectionRequestClientDeleted:\n      case ErrorKind.InvalidMessage:\n      case ErrorKind.InvalidPush:\n      case ErrorKind.VersionNotSupported:\n      case ErrorKind.SchemaVersionNotSupported:\n      case ErrorKind.Internal:\n      // PushFailed and TransformFailed can be auth errors (401/403)\n      // or other errors - handle non-auth cases here\n      case ErrorKind.PushFailed:\n      case ErrorKind.TransformFailed:\n        return {status: ConnectionStatus.Error, reason: ex} as const;\n\n      // Errors that should continue with backoff/retry\n      case ErrorKind.Rebalance:\n      case ErrorKind.Rehome:\n      case ErrorKind.ServerOverloaded:\n        return {status: NO_STATUS_TRANSITION, reason: ex} as const;\n\n      // Auth errors are handled above by isAuthError check\n      case ErrorKind.AuthInvalidated:\n      case ErrorKind.Unauthorized:\n        return {\n          status: ConnectionStatus.NeedsAuth,\n          reason: ex as AuthError,\n        } as const;\n\n      // Mutation-specific errors don't affect connection state\n      case ErrorKind.MutationRateLimited:\n      case ErrorKind.MutationFailed:\n        return {status: NO_STATUS_TRANSITION, reason: ex} as const;\n\n      default:\n        unreachable(ex.kind);\n    }\n  }\n\n  // we default to error state if we don't know what to do\n  // this is a catch-all for unexpected errors\n  return {\n    status: ConnectionStatus.Error,\n    reason: new ClientError(\n      {\n        kind: ClientErrorKind.Internal,\n        message: 'Unexpected internal error: ' + getErrorMessage(ex),\n      },\n      {cause: ex},\n    ),\n  } as const;\n}\n"],"mappings":";;;;;;;;;;;;AA6DA,IAAa,cAAb,cAKU,MAAM;CACd;CAEA,YAAY,WAAc,SAAwB;AAChD,QAAM,UAAU,SAAS,QAAQ;AACjC,OAAK,OAAO;AACZ,OAAK,YAAY;GAAC,GAAG;GAAW,QAAQ;GAAmB;;CAG7D,IAAI,OAAkB;AACpB,SAAO,KAAK,UAAU;;;AAI1B,SAAgB,YAAY,IAA8B;AACxD,QAAO,cAAc,GAAG,IAAI,cAAc,GAAG;;AAG/C,SAAgB,cAAc,IAAiD;AAC7E,QACE,cAAc,eAAe,GAAG,UAAU,WAAW;;AAIzD,SAAgB,cAAc,IAAgC;AAC5D,QACE,gBAAgB,GAAG,KAClB,GAAG,UAAU,WAAW,YACvB,GAAG,UAAU,WAAW;;AAQ9B,SAAgB,YAAY,IAA8B;AACxD,KAAI,cAAc,GAAG,EAAE;AACrB,MACE,GAAG,SAAS,qBACZ,GAAG,SAAS,eAEZ,QAAO;AAET,OACG,GAAG,UAAU,SAAS,gBACrB,GAAG,UAAU,SAAS,sBACxB,GAAG,UAAU,WAAW,WACvB,GAAG,UAAU,WAAW,OAAO,GAAG,UAAU,WAAW,KAExD,QAAO;;AAIX,QAAO;;AAGT,SAAgB,iBAAiB,OAA2C;AAC1E,KAAI,cAAc,MAAM,CACtB,SAAQ,MAAM,UAAU,MAAxB;EACE,KAAK;EACL,KAAK;EACL,KAAK,iBACH,QAAO,MAAM;;;AAMrB,IAAa,uBAAuB;;;;;AAapC,SAAgB,6BACd,IAC2B;AAE3B,KAAI,YAAY,GAAG,CACjB,QAAO;EACL,QAAQ;EACR,QAAQ;EACT;AAGH,KAAI,cAAc,GAAG,CACnB,SAAQ,GAAG,MAAX;EAEE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,qBACH,QAAO;GAAC,QAAQ;GAAsB,QAAQ;GAAG;EAGnD,KAAK;EACL,KAAK;EACL,KAAK,eACH,QAAO;GAAC,QAAQ;GAAwB,QAAQ;GAAG;EAGrD,KAAK;EACL,KAAK;EACL,KAAK,eACH,QAAO;GACL,QAAQ;GACR,QAAQ;GACT;EAGH,KAAK,aACH,QAAO;GAAC,QAAQ;GAAyB,QAAQ;GAAG;EAEtD,QACE,aAAY,GAAG,KAAK;;AAI1B,KAAI,cAAc,GAAG,CACnB,SAAQ,GAAG,MAAX;EAEE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EAGL,KAAK;EACL,KAAK,gBACH,QAAO;GAAC,QAAQ;GAAwB,QAAQ;GAAG;EAGrD,KAAK;EACL,KAAK;EACL,KAAK,iBACH,QAAO;GAAC,QAAQ;GAAsB,QAAQ;GAAG;EAGnD,KAAK;EACL,KAAK,aACH,QAAO;GACL,QAAQ;GACR,QAAQ;GACT;EAGH,KAAK;EACL,KAAK,eACH,QAAO;GAAC,QAAQ;GAAsB,QAAQ;GAAG;EAEnD,QACE,aAAY,GAAG,KAAK;;AAM1B,QAAO;EACL,QAAQ;EACR,QAAQ,IAAI,YACV;GACE,MAAM;GACN,SAAS,gCAAgC,gBAAgB,GAAG;GAC7D,EACD,EAAC,OAAO,IAAG,CACZ;EACF"}

package/out/zero-client/src/client/http-string.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"http-string.js","names":[],"sources":["../../../../../zero-client/src/client/http-string.ts"],"sourcesContent":["import {assert} from '../../../shared/src/asserts.ts';\n\nexport type HTTPString = `http${'' | 's'}://${string}`;\n\nexport type WSString = `ws${'' | 's'}://${string}`;\n\nexport function toWSString(url: HTTPString): WSString {\n  return ('ws' + url.slice(4)) as WSString;\n}\n\nexport function toHTTPString(url: WSString): HTTPString {\n  return ('http' + url.slice(2)) as HTTPString;\n}\n\nconst httpsRe = /^https?:\\/\\//;\n\nexport function assertHTTPString(url: string): asserts url is HTTPString {\n  assert(httpsRe.test(url), () => `Expected HTTP(S) URL, got \"${url}\"`);\n}\n\nconst wssRe = /^wss?:\\/\\//;\n\nexport function assertWSString(url: string): asserts url is WSString {\n  assert(wssRe.test(url), () => `Expected WS(S) URL, got \"${url}\"`);\n}\n\nexport function appendPath<T extends HTTPString | WSString>(\n  url: T,\n  toAppend: `/${string}`,\n): T {\n  return (url + (url.endsWith('/') ? toAppend.substring(1) : toAppend)) as T;\n}\n"],"mappings":";AAMA,SAAgB,WAAW,KAA2B;AACpD,QAAQ,OAAO,IAAI,MAAM,EAAE;;AAmB7B,SAAgB,WACd,KACA,UACG;AACH,QAAQ,OAAO,IAAI,SAAS,IAAI,GAAG,SAAS,UAAU,EAAE,GAAG"}

package/out/zero-client/src/client/inspector/client-group.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-group.js","names":["#delegate"],"sources":["../../../../../../zero-client/src/client/inspector/client-group.ts"],"sourcesContent":["import type {Client} from './client.ts';\nimport type {ExtendedInspectorDelegate} from './lazy-inspector.ts';\nimport type {Query} from './query.ts';\n\nexport class ClientGroup {\n  readonly #delegate: ExtendedInspectorDelegate;\n  readonly id: Promise<string> | string;\n\n  constructor(\n    delegate: ExtendedInspectorDelegate,\n    clientGroupID: Promise<string> | string,\n  ) {\n    this.#delegate = delegate;\n    this.id = clientGroupID;\n  }\n\n  async clients(): Promise<Client[]> {\n    return (await this.#delegate.lazy).clientGroupClients(\n      this.#delegate,\n      this.id,\n    );\n  }\n\n  async clientsWithQueries(): Promise<Client[]> {\n    return (await this.#delegate.lazy).clientGroupClientsWithQueries(\n      this.#delegate,\n      this.id,\n    );\n  }\n\n  async queries(): Promise<Query[]> {\n    return (await this.#delegate.lazy).clientGroupQueries(this.#delegate);\n  }\n}\n"],"mappings":";AAIA,IAAa,cAAb,MAAyB;CACvB;CACA;CAEA,YACE,UACA,eACA;AACA,QAAA,WAAiB;AACjB,OAAK,KAAK;;CAGZ,MAAM,UAA6B;AACjC,UAAQ,MAAM,MAAA,SAAe,MAAM,mBACjC,MAAA,UACA,KAAK,GACN;;CAGH,MAAM,qBAAwC;AAC5C,UAAQ,MAAM,MAAA,SAAe,MAAM,8BACjC,MAAA,UACA,KAAK,GACN;;CAGH,MAAM,UAA4B;AAChC,UAAQ,MAAM,MAAA,SAAe,MAAM,mBAAmB,MAAA,SAAe"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","names":["#delegate"],"sources":["../../../../../../zero-client/src/client/inspector/client.ts"],"sourcesContent":["import type {ReadonlyJSONValue} from '../../../../shared/src/json.ts';\nimport type {Row} from '../../../../zero-protocol/src/data.ts';\nimport {ClientGroup} from './client-group.ts';\nimport type {ExtendedInspectorDelegate} from './lazy-inspector.ts';\nimport type {Query} from './query.ts';\n\nexport class Client {\n  readonly #delegate: ExtendedInspectorDelegate;\n  readonly id: string;\n  readonly clientGroup: ClientGroup;\n\n  constructor(\n    delegate: ExtendedInspectorDelegate,\n    clientID: string,\n    clientGroupID: Promise<string> | string,\n  ) {\n    this.#delegate = delegate;\n    this.id = clientID;\n\n    this.clientGroup = new ClientGroup(this.#delegate, clientGroupID);\n  }\n\n  async queries(): Promise<Query[]> {\n    return (await this.#delegate.lazy).clientQueries(this.#delegate, this.id);\n  }\n\n  async map(): Promise<Map<string, ReadonlyJSONValue>> {\n    return (await this.#delegate.lazy).clientMap(this.#delegate, this.id);\n  }\n\n  async rows(tableName: string): Promise<Row[]> {\n    return (await this.#delegate.lazy).clientRows(\n      this.#delegate,\n      this.id,\n      tableName,\n    );\n  }\n}\n"],"mappings":";;AAMA,IAAa,SAAb,MAAoB;CAClB;CACA;CACA;CAEA,YACE,UACA,UACA,eACA;AACA,QAAA,WAAiB;AACjB,OAAK,KAAK;AAEV,OAAK,cAAc,IAAI,YAAY,MAAA,UAAgB,cAAc;;CAGnE,MAAM,UAA4B;AAChC,UAAQ,MAAM,MAAA,SAAe,MAAM,cAAc,MAAA,UAAgB,KAAK,GAAG;;CAG3E,MAAM,MAA+C;AACnD,UAAQ,MAAM,MAAA,SAAe,MAAM,UAAU,MAAA,UAAgB,KAAK,GAAG;;CAGvE,MAAM,KAAK,WAAmC;AAC5C,UAAQ,MAAM,MAAA,SAAe,MAAM,WACjC,MAAA,UACA,KAAK,IACL,UACD"}

package/out/zero-client/src/client/inspector/html-dialog-prompt.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"html-dialog-prompt.js","names":[],"sources":["../../../../../../zero-client/src/client/inspector/html-dialog-prompt.ts"],"sourcesContent":["/**\n * Checks if we can create HTML elements and are in a browser document context\n */\nfunction canUseHTMLDialog(): boolean {\n  try {\n    // Check if we're in a test environment (vitest sets this)\n    if (\n      typeof globalThis !== 'undefined' &&\n      '__vitest_worker__' in globalThis\n    ) {\n      return false;\n    }\n\n    return (\n      typeof document !== 'undefined' &&\n      typeof document.createElement === 'function' &&\n      typeof HTMLDialogElement !== 'undefined' &&\n      document.body !== null &&\n      // Make sure we can actually create a dialog element\n      document.createElement('dialog') instanceof HTMLDialogElement\n    );\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Creates a password prompt using HTML <dialog> element\n */\nexport function createHTMLPasswordPrompt(\n  message: string,\n): Promise<string | null> {\n  if (!canUseHTMLDialog()) {\n    // Fallback to browser prompt if HTML dialog is not available\n    return Promise.resolve(prompt(message));\n  }\n\n  return new Promise<string | null>(resolve => {\n    // Shared CSS constants\n    const reset = 'all:revert;';\n    const w = 'rgba(255,255,255,';\n    const white = w + '1)';\n    const whiteTransp = w + '0.4)';\n    const r1 = '0.25rem';\n    const font = `font-family:system-ui,sans-serif;color:${white};`;\n    const btnBase = `${reset}${font}cursor:pointer;font-size:1rem;font-weight:500;border:none;padding:0.4rem 0.75rem;border-radius:${r1};background:`;\n\n    const dialog = document.createElement('dialog');\n    dialog.style.cssText = `${reset}${font}background:rgba(0,0,0,0.95);padding:2rem;border:1px solid ${whiteTransp};border-radius:0.5rem;`;\n\n    // Prevent keydown from escaping the dialog which can be interfered by other\n    // listeners (e.g. global hotkeys)\n    dialog.addEventListener('keydown', e => {\n      e.stopPropagation();\n    });\n\n    dialog.oncancel = () => {\n      dialog.remove();\n      resolve(null);\n    };\n\n    const form = document.createElement('form');\n    form.method = 'dialog';\n    form.style.cssText = `${reset}margin:0;`;\n\n    const messagePara = document.createElement('p');\n    messagePara.style.cssText = `${reset}${font}font-size:1.5rem;margin:0 0 1rem 0;`;\n    messagePara.append(message);\n\n    const passwordInput = document.createElement('input');\n    passwordInput.type = 'password';\n    passwordInput.placeholder = 'Admin password';\n    passwordInput.autocomplete = 'current-password';\n    passwordInput.autofocus = true;\n    passwordInput.style.cssText = `${reset}${font}font-size:1rem;display:block;margin:0 0 1rem 0;padding:0.5rem;background:rgba(0,0,0,0.5);border:1px solid ${whiteTransp};border-radius:${r1};`;\n\n    const buttonDiv = document.createElement('div');\n    buttonDiv.style.cssText = reset;\n\n    const cancelBtn = document.createElement('button');\n    cancelBtn.type = 'reset';\n    cancelBtn.append('Cancel');\n    cancelBtn.style.cssText = btnBase + w + '0.25);';\n\n    const okBtn = document.createElement('button');\n    okBtn.type = 'submit';\n    okBtn.value = 'ok';\n    okBtn.append('OK');\n    okBtn.style.cssText = btnBase + 'rgba(19,106,235,1);margin-right:0.5rem;';\n\n    buttonDiv.append(okBtn, cancelBtn);\n    form.append(messagePara, passwordInput, buttonDiv);\n    dialog.append(form);\n\n    form.onreset = () => {\n      dialog.close();\n    };\n\n    dialog.onclose = () => {\n      if (dialog.returnValue === 'ok') {\n        resolve(passwordInput.value || null);\n      } else {\n        resolve(null);\n      }\n      dialog.remove();\n    };\n\n    document.body.append(dialog);\n    dialog.showModal();\n  });\n}\n"],"mappings":";;;;AAGA,SAAS,mBAA4B;AACnC,KAAI;AAEF,MACE,OAAO,eAAe,eACtB,uBAAuB,WAEvB,QAAO;AAGT,SACE,OAAO,aAAa,eACpB,OAAO,SAAS,kBAAkB,cAClC,OAAO,sBAAsB,eAC7B,SAAS,SAAS,QAElB,SAAS,cAAc,SAAS,YAAY;SAExC;AACN,SAAO;;;;;;AAOX,SAAgB,yBACd,SACwB;AACxB,KAAI,CAAC,kBAAkB,CAErB,QAAO,QAAQ,QAAQ,OAAO,QAAQ,CAAC;AAGzC,QAAO,IAAI,SAAuB,YAAW;EAE3C,MAAM,QAAQ;EACd,MAAM,IAAI;EACV,MAAM,QAAQ,IAAI;EAClB,MAAM,cAAc,IAAI;EACxB,MAAM,KAAK;EACX,MAAM,OAAO,0CAA0C,MAAM;EAC7D,MAAM,UAAU,GAAG,QAAQ,KAAK,iGAAiG,GAAG;EAEpI,MAAM,SAAS,SAAS,cAAc,SAAS;AAC/C,SAAO,MAAM,UAAU,GAAG,QAAQ,KAAK,4DAA4D,YAAY;AAI/G,SAAO,iBAAiB,YAAW,MAAK;AACtC,KAAE,iBAAiB;IACnB;AAEF,SAAO,iBAAiB;AACtB,UAAO,QAAQ;AACf,WAAQ,KAAK;;EAGf,MAAM,OAAO,SAAS,cAAc,OAAO;AAC3C,OAAK,SAAS;AACd,OAAK,MAAM,UAAU,GAAG,MAAM;EAE9B,MAAM,cAAc,SAAS,cAAc,IAAI;AAC/C,cAAY,MAAM,UAAU,GAAG,QAAQ,KAAK;AAC5C,cAAY,OAAO,QAAQ;EAE3B,MAAM,gBAAgB,SAAS,cAAc,QAAQ;AACrD,gBAAc,OAAO;AACrB,gBAAc,cAAc;AAC5B,gBAAc,eAAe;AAC7B,gBAAc,YAAY;AAC1B,gBAAc,MAAM,UAAU,GAAG,QAAQ,KAAK,4GAA4G,YAAY,iBAAiB,GAAG;EAE1L,MAAM,YAAY,SAAS,cAAc,MAAM;AAC/C,YAAU,MAAM,UAAU;EAE1B,MAAM,YAAY,SAAS,cAAc,SAAS;AAClD,YAAU,OAAO;AACjB,YAAU,OAAO,SAAS;AAC1B,YAAU,MAAM,UAAU,UAAU,IAAI;EAExC,MAAM,QAAQ,SAAS,cAAc,SAAS;AAC9C,QAAM,OAAO;AACb,QAAM,QAAQ;AACd,QAAM,OAAO,KAAK;AAClB,QAAM,MAAM,UAAU,UAAU;AAEhC,YAAU,OAAO,OAAO,UAAU;AAClC,OAAK,OAAO,aAAa,eAAe,UAAU;AAClD,SAAO,OAAO,KAAK;AAEnB,OAAK,gBAAgB;AACnB,UAAO,OAAO;;AAGhB,SAAO,gBAAgB;AACrB,OAAI,OAAO,gBAAgB,KACzB,SAAQ,cAAc,SAAS,KAAK;OAEpC,SAAQ,KAAK;AAEf,UAAO,QAAQ;;AAGjB,WAAS,KAAK,OAAO,OAAO;AAC5B,SAAO,WAAW;GAClB"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"inspector.js","names":["#delegate","#deletedQueries"],"sources":["../../../../../../zero-client/src/client/inspector/inspector.ts"],"sourcesContent":["import type {ReadonlyJSONValue} from '../../../../shared/src/json.ts';\nimport type {\n  AnalyzeQueryResult,\n  PlanDebugEventJSON,\n} from '../../../../zero-protocol/src/analyze-query-result.ts';\nimport type {AST} from '../../../../zero-protocol/src/ast.ts';\nimport type {AnalyzeQueryOptions} from '../../../../zero-protocol/src/inspect-up.ts';\nimport {formatPlannerEvents} from '../../../../zql/src/planner/planner-debug.ts';\nimport type {QueryDelegate} from '../../../../zql/src/query/query-delegate.ts';\nimport type {AnyQuery} from '../../../../zql/src/query/query.ts';\nimport type {ClientGroup} from './client-group.ts';\nimport {Client} from './client.ts';\nimport type {\n  ExtendedInspectorDelegate,\n  InspectorDelegate,\n  Metrics,\n  QueryClientMetrics,\n  Rep,\n} from './lazy-inspector.ts';\n\nexport type {InspectorDelegate};\n\n// oxlint-disable-next-line consistent-type-imports\nexport type Lazy = typeof import('./lazy-inspector.ts');\n\nexport class Inspector {\n  readonly #delegate: ExtendedInspectorDelegate;\n  readonly #deletedQueries = new Map<\n    string,\n    {readonly ast: AST; readonly metrics: QueryClientMetrics}\n  >();\n  readonly client: Client;\n  readonly clientGroup: ClientGroup;\n\n  constructor(\n    rep: Rep,\n    inspectorDelegate: InspectorDelegate,\n    queryDelegate: QueryDelegate,\n    getSocket: () => Promise<WebSocket>,\n  ) {\n    const deletedQueries = this.#deletedQueries;\n    inspectorDelegate.setQueryEvictedCallback((hash, ast, metrics) => {\n      deletedQueries.set(hash, {ast, metrics});\n    });\n    this.#delegate = {\n      getQueryMetrics(hash) {\n        return (\n          inspectorDelegate.getQueryMetrics(hash) ??\n          deletedQueries.get(hash)?.metrics\n        );\n      },\n      getAST(queryID) {\n        return (\n          inspectorDelegate.getAST(queryID) ?? deletedQueries.get(queryID)?.ast\n        );\n      },\n      mapClientASTToServer:\n        inspectorDelegate.mapClientASTToServer.bind(inspectorDelegate),\n      get metrics() {\n        return inspectorDelegate.metrics;\n      },\n      setQueryEvictedCallback() {},\n      queryDelegate,\n      rep,\n      getSocket,\n      lazy: import('./lazy-inspector.ts'),\n    };\n\n    this.client = new Client(this.#delegate, rep.clientID, rep.clientGroupID);\n    this.clientGroup = this.client.clientGroup;\n  }\n\n  async metrics(): Promise<Metrics> {\n    return (await this.#delegate.lazy).inspectorMetrics(this.#delegate);\n  }\n\n  async clients(): Promise<Client[]> {\n    return (await this.#delegate.lazy).inspectorClients(this.#delegate);\n  }\n\n  async clientsWithQueries(): Promise<Client[]> {\n    return (await this.#delegate.lazy).inspectorClientsWithQueries(\n      this.#delegate,\n    );\n  }\n\n  async serverVersion(): Promise<string> {\n    return (await this.#delegate.lazy).serverVersion(this.#delegate);\n  }\n\n  async analyzeQuery(\n    query: AnyQuery,\n    options?: AnalyzeQueryOptions,\n  ): Promise<AnalyzeQueryResult> {\n    return (await this.#delegate.lazy).analyzeQuery(\n      this.#delegate,\n      query,\n      options,\n    );\n  }\n\n  /**\n   * Analyze a query specified by a server-side AST. Unlike {@link analyzeQuery}\n   * the AST is sent to the server verbatim with no client-to-server name\n   * mapping; callers should provide an AST already in the server shape.\n   */\n  async analyzeServerAST(\n    ast: AST,\n    options?: AnalyzeQueryOptions,\n  ): Promise<AnalyzeQueryResult> {\n    return (await this.#delegate.lazy).analyzeServerAST(\n      this.#delegate,\n      ast,\n      options,\n    );\n  }\n\n  /**\n   * Analyze a server-registered named (custom) query. The server resolves\n   * the name and args to an AST using its registered custom-query handler.\n   */\n  async analyzeNamedQuery(\n    name: string,\n    args: ReadonlyArray<ReadonlyJSONValue>,\n    options?: AnalyzeQueryOptions,\n  ): Promise<AnalyzeQueryResult> {\n    return (await this.#delegate.lazy).analyzeNamedQuery(\n      this.#delegate,\n      name,\n      args,\n      options,\n    );\n  }\n\n  /**\n   * Authenticate with the server's admin password. Other inspector RPCs\n   * (e.g. {@link analyzeQuery}) fall back to an interactive HTML password\n   * prompt when authentication is needed, which is unavailable in non-DOM\n   * environments. Call this first from Node contexts to establish the\n   * session.\n   *\n   * Returns `true` if the password is accepted (or the server runs in a\n   * development mode that bypasses the check), `false` otherwise.\n   */\n  async authenticate(password: string): Promise<boolean> {\n    return (await this.#delegate.lazy).authenticate(this.#delegate, password);\n  }\n\n  /**\n   * Format planner debug events as a human-readable string.\n   */\n  formatPlannerEvents(events: PlanDebugEventJSON[]): string {\n    return formatPlannerEvents(events);\n  }\n}\n"],"mappings":";;;AAyBA,IAAa,YAAb,MAAuB;CACrB;CACA,kCAA2B,IAAI,KAG5B;CACH;CACA;CAEA,YACE,KACA,mBACA,eACA,WACA;EACA,MAAM,iBAAiB,MAAA;AACvB,oBAAkB,yBAAyB,MAAM,KAAK,YAAY;AAChE,kBAAe,IAAI,MAAM;IAAC;IAAK;IAAQ,CAAC;IACxC;AACF,QAAA,WAAiB;GACf,gBAAgB,MAAM;AACpB,WACE,kBAAkB,gBAAgB,KAAK,IACvC,eAAe,IAAI,KAAK,EAAE;;GAG9B,OAAO,SAAS;AACd,WACE,kBAAkB,OAAO,QAAQ,IAAI,eAAe,IAAI,QAAQ,EAAE;;GAGtE,sBACE,kBAAkB,qBAAqB,KAAK,kBAAkB;GAChE,IAAI,UAAU;AACZ,WAAO,kBAAkB;;GAE3B,0BAA0B;GAC1B;GACA;GACA;GACA,MAAM,OAAO;GACd;AAED,OAAK,SAAS,IAAI,OAAO,MAAA,UAAgB,IAAI,UAAU,IAAI,cAAc;AACzE,OAAK,cAAc,KAAK,OAAO;;CAGjC,MAAM,UAA4B;AAChC,UAAQ,MAAM,MAAA,SAAe,MAAM,iBAAiB,MAAA,SAAe;;CAGrE,MAAM,UAA6B;AACjC,UAAQ,MAAM,MAAA,SAAe,MAAM,iBAAiB,MAAA,SAAe;;CAGrE,MAAM,qBAAwC;AAC5C,UAAQ,MAAM,MAAA,SAAe,MAAM,4BACjC,MAAA,SACD;;CAGH,MAAM,gBAAiC;AACrC,UAAQ,MAAM,MAAA,SAAe,MAAM,cAAc,MAAA,SAAe;;CAGlE,MAAM,aACJ,OACA,SAC6B;AAC7B,UAAQ,MAAM,MAAA,SAAe,MAAM,aACjC,MAAA,UACA,OACA,QACD;;;;;;;CAQH,MAAM,iBACJ,KACA,SAC6B;AAC7B,UAAQ,MAAM,MAAA,SAAe,MAAM,iBACjC,MAAA,UACA,KACA,QACD;;;;;;CAOH,MAAM,kBACJ,MACA,MACA,SAC6B;AAC7B,UAAQ,MAAM,MAAA,SAAe,MAAM,kBACjC,MAAA,UACA,MACA,MACA,QACD;;;;;;;;;;;;CAaH,MAAM,aAAa,UAAoC;AACrD,UAAQ,MAAM,MAAA,SAAe,MAAM,aAAa,MAAA,UAAgB,SAAS;;;;;CAM3E,oBAAoB,QAAsC;AACxD,SAAO,oBAAoB,OAAO"}

package/out/zero-client/src/client/inspector/lazy-inspector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lazy-inspector.js","names":[],"sources":["../../../../../../zero-client/src/client/inspector/lazy-inspector.ts"],"sourcesContent":["import type {BTreeRead} from '../../../../replicache/src/btree/read.ts';\nimport type {Read} from '../../../../replicache/src/dag/store.ts';\nimport {readFromHash} from '../../../../replicache/src/db/read.ts';\nimport * as FormatVersion from '../../../../replicache/src/format-version-enum.ts';\nimport {getClientGroup} from '../../../../replicache/src/persist/client-groups.ts';\nimport {\n  getClient,\n  getClients,\n  type ClientMap,\n} from '../../../../replicache/src/persist/clients.ts';\nimport type {ReplicacheImpl} from '../../../../replicache/src/replicache-impl.ts';\nimport {withRead} from '../../../../replicache/src/with-transactions.ts';\nimport {assert} from '../../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../../shared/src/json.ts';\nimport {TDigest, type ReadonlyTDigest} from '../../../../shared/src/tdigest.ts';\nimport * as valita from '../../../../shared/src/valita.ts';\nimport type {AnalyzeQueryResult} from '../../../../zero-protocol/src/analyze-query-result.ts';\nimport type {AST} from '../../../../zero-protocol/src/ast.ts';\nimport type {Row} from '../../../../zero-protocol/src/data.ts';\nimport {\n  inspectAnalyzeQueryDownSchema,\n  inspectAuthenticatedDownSchema,\n  inspectMetricsDownSchema,\n  inspectQueriesDownSchema,\n  inspectVersionDownSchema,\n  type InspectDownBody,\n  type InspectQueryRow,\n  type QueryServerMetrics as QueryServerMetricsJSON,\n} from '../../../../zero-protocol/src/inspect-down.ts';\nimport type {\n  AnalyzeQueryOptions,\n  InspectUpBody,\n} from '../../../../zero-protocol/src/inspect-up.ts';\nimport type {\n  ClientMetricMap,\n  ServerMetricMap,\n} from '../../../../zql/src/query/metrics-delegate.ts';\nimport type {QueryDelegate} from '../../../../zql/src/query/query-delegate.ts';\nimport {asQueryInternals} from '../../../../zql/src/query/query-internals.ts';\nimport type {AnyQuery} from '../../../../zql/src/query/query.ts';\nimport {nanoid} from '../../util/nanoid.ts';\nimport {ENTITIES_KEY_PREFIX} from '../keys.ts';\nimport type {MutatorDefs} from '../replicache-types.ts';\nimport {Client} from './client.ts';\nimport {createHTMLPasswordPrompt} from './html-dialog-prompt.ts';\nimport {type Lazy} from './inspector.ts';\nimport {Query} from './query.ts';\n\nexport type GetWebSocket = () => Promise<WebSocket>;\n\nexport type Metrics = {\n  readonly [K in keyof (ClientMetricMap & ServerMetricMap)]: ReadonlyTDigest;\n};\n\ntype DistributiveOmit<T, K extends string> = T extends object\n  ? Omit<T, K>\n  : never;\n\nexport async function rpc<T extends InspectDownBody>(\n  socket: WebSocket,\n  arg: DistributiveOmit<InspectUpBody, 'id'>,\n  downSchema: valita.Type<T>,\n): Promise<T['value']> {\n  try {\n    return await rpcNoAuthTry(socket, arg, downSchema);\n  } catch (e) {\n    if (e instanceof UnauthenticatedError) {\n      const password = await createHTMLPasswordPrompt('Enter password:');\n      if (password) {\n        // Do authenticate rpc\n        const authRes = await rpcNoAuthTry(\n          socket,\n          {op: 'authenticate', value: password},\n          inspectAuthenticatedDownSchema,\n        );\n        if (authRes) {\n          // If authentication is successful, retry the original RPC\n          return rpcNoAuthTry(socket, arg, downSchema);\n        }\n      }\n      throw new Error('Authentication failed');\n    }\n    throw e;\n  }\n}\n\nfunction rpcNoAuthTry<T extends InspectDownBody>(\n  socket: WebSocket,\n  arg: DistributiveOmit<InspectUpBody, 'id'>,\n  downSchema: valita.Type<T>,\n): Promise<T['value']> {\n  return new Promise((resolve, reject) => {\n    const id = nanoid();\n    const f = (ev: MessageEvent) => {\n      const msg = JSON.parse(ev.data);\n      if (msg[0] === 'inspect') {\n        const body = msg[1];\n        if (body.id !== id) {\n          return;\n        }\n        const res = valita.test(body, downSchema);\n        if (res.ok) {\n          if (res.value.op === 'error') {\n            reject(new Error(res.value.value));\n          } else {\n            resolve(res.value.value);\n          }\n        } else {\n          // Check if we got un authenticated/false response\n          const authRes = valita.test(body, inspectAuthenticatedDownSchema);\n          if (authRes.ok) {\n            // Handle authenticated response\n            assert(\n              authRes.value.value === false,\n              'Expected unauthenticated response',\n            );\n            reject(new UnauthenticatedError());\n          }\n\n          reject(res.error);\n        }\n        socket.removeEventListener('message', f);\n      }\n    };\n    socket.addEventListener('message', f);\n    socket.send(JSON.stringify(['inspect', {...arg, id}]));\n  });\n} // T extends forces T to be resolved\n\nexport function mergeMetrics(\n  clientMetrics: QueryClientMetrics | undefined,\n  serverMetrics: QueryServerMetricsJSON | null | undefined,\n): ClientMetrics & ServerMetrics {\n  const cm = clientMetrics ?? newClientMetrics();\n  return {\n    ...convertClientMetrics(cm),\n    ...(serverMetrics\n      ? convertServerMetrics(serverMetrics)\n      : newServerMetrics()),\n  };\n}\n\nfunction newClientMetrics(): QueryClientMetrics {\n  return {\n    'query-materialization-client': undefined,\n    'query-materialization-end-to-end': undefined,\n    'query-update-client': new TDigest(),\n  };\n}\n\nfunction convertClientMetrics(metrics: QueryClientMetrics): ClientMetrics {\n  const hydrateDigest = new TDigest();\n  if (metrics['query-materialization-client'] !== undefined) {\n    hydrateDigest.add(metrics['query-materialization-client']);\n  }\n  const totalDigest = new TDigest();\n  if (metrics['query-materialization-end-to-end'] !== undefined) {\n    totalDigest.add(metrics['query-materialization-end-to-end']);\n  }\n  return {\n    'query-materialization-client': hydrateDigest,\n    'query-materialization-end-to-end': totalDigest,\n    'query-update-client': metrics['query-update-client'] as TDigest,\n  };\n}\n\nfunction newServerMetrics(): ServerMetrics {\n  return {\n    'query-materialization-server': new TDigest(),\n    'query-update-server': new TDigest(),\n  };\n}\n\nfunction convertServerMetrics(metrics: QueryServerMetricsJSON): ServerMetrics {\n  const hydrateMs = metrics['query-hydration-server-ms'];\n  const hydrateDigest = new TDigest();\n  if (hydrateMs !== undefined) {\n    hydrateDigest.add(hydrateMs);\n  }\n  return {\n    'query-materialization-server': hydrateDigest,\n    'query-update-server': TDigest.fromJSON(metrics['query-update-server']),\n  };\n}\n\nexport async function inspectorMetrics(\n  delegate: ExtendedInspectorDelegate,\n): Promise<Metrics> {\n  const clientMetrics = delegate.metrics;\n  const serverMetricsJSON = await rpc(\n    await delegate.getSocket(),\n    {op: 'metrics'},\n    inspectMetricsDownSchema,\n  );\n  return {\n    ...(clientMetrics ?? newClientMetrics()),\n    'query-materialization-server': TDigest.fromJSON(\n      serverMetricsJSON['query-materialization-server'],\n    ),\n    'query-update-server': TDigest.fromJSON(\n      serverMetricsJSON['query-update-server'],\n    ),\n  };\n}\n\nexport function inspectorClients(\n  delegate: ExtendedInspectorDelegate,\n): Promise<Client[]> {\n  return withDagRead(delegate, dagRead => clients(delegate, dagRead));\n}\n\nexport function inspectorClientsWithQueries(\n  delegate: ExtendedInspectorDelegate,\n): Promise<Client[]> {\n  return withDagRead(delegate, dagRead =>\n    clientsWithQueries(delegate, dagRead),\n  );\n}\n\nasync function withDagRead<T>(\n  delegate: ExtendedInspectorDelegate,\n  f: (dagRead: Read) => Promise<T>,\n): Promise<T> {\n  const {rep} = delegate;\n  await rep.refresh();\n  await rep.persist();\n  return withRead(rep.perdag, f);\n}\n\nasync function getBTree(dagRead: Read, clientID: string): Promise<BTreeRead> {\n  const client = await getClient(clientID, dagRead);\n  assert(client, `Client not found: ${clientID}`);\n  const {clientGroupID} = client;\n  const clientGroup = await getClientGroup(clientGroupID, dagRead);\n  assert(clientGroup, `Client group not found: ${clientGroupID}`);\n  const dbRead = await readFromHash(\n    clientGroup.headHash,\n    dagRead,\n    FormatVersion.Latest,\n  );\n  return dbRead.map;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype MapEntry<T extends ReadonlyMap<any, any>> =\n  T extends ReadonlyMap<infer K, infer V> ? readonly [K, V] : never;\n\nasync function clients(\n  delegate: ExtendedInspectorDelegate,\n  dagRead: Read,\n  predicate: (entry: MapEntry<ClientMap>) => boolean = () => true,\n): Promise<Client[]> {\n  const clients = await getClients(dagRead);\n  return [...clients.entries()]\n    .filter(predicate)\n    .map(\n      ([clientID, {clientGroupID}]) =>\n        new Client(delegate, clientID, clientGroupID),\n    );\n}\n\nasync function clientsWithQueries(\n  delegate: ExtendedInspectorDelegate,\n  dagRead: Read,\n  predicate: (entry: MapEntry<ClientMap>) => boolean = () => true,\n): Promise<Client[]> {\n  const allClients = await clients(delegate, dagRead, predicate);\n  const clientsWithQueries: Client[] = [];\n  await Promise.all(\n    allClients.map(async client => {\n      const queries = await client.queries();\n      if (queries.length > 0) {\n        clientsWithQueries.push(client);\n      }\n    }),\n  );\n  return clientsWithQueries;\n}\n\nexport async function clientGroupClients(\n  delegate: ExtendedInspectorDelegate,\n  clientGroupID: Promise<string> | string,\n): Promise<Client[]> {\n  const id = await clientGroupID;\n  return withDagRead(delegate, dagRead =>\n    clients(delegate, dagRead, ([_, v]) => v.clientGroupID === id),\n  );\n}\n\nexport async function clientGroupClientsWithQueries(\n  delegate: ExtendedInspectorDelegate,\n  clientGroupID: Promise<string> | string,\n): Promise<Client[]> {\n  const id = await clientGroupID;\n  return withDagRead(delegate, dagRead =>\n    clientsWithQueries(delegate, dagRead, ([_, v]) => v.clientGroupID === id),\n  );\n}\n\nexport function clientGroupQueries(\n  delegate: ExtendedInspectorDelegate,\n): Promise<Query[]> {\n  return queries(delegate, {op: 'queries'});\n}\nexport function clientMap(\n  delegate: ExtendedInspectorDelegate,\n  clientID: string,\n): Promise<Map<string, ReadonlyJSONValue>> {\n  return withDagRead(delegate, async dagRead => {\n    const tree = await getBTree(dagRead, clientID);\n    const map = new Map<string, ReadonlyJSONValue>();\n    for await (const [key, value] of tree.scan('')) {\n      map.set(key, value);\n    }\n    return map;\n  });\n}\n\nexport function clientRows(\n  delegate: ExtendedInspectorDelegate,\n  clientID: string,\n  tableName: string,\n): Promise<Row[]> {\n  return withDagRead(delegate, async dagRead => {\n    const prefix = ENTITIES_KEY_PREFIX + tableName + '/';\n    const tree = await getBTree(dagRead, clientID);\n    const rows: Row[] = [];\n    for await (const [key, value] of tree.scan(prefix)) {\n      if (!key.startsWith(prefix)) {\n        break;\n      }\n      rows.push(value as Row);\n    }\n    return rows;\n  });\n}\n\nexport async function serverVersion(\n  delegate: ExtendedInspectorDelegate,\n): Promise<string> {\n  return rpc(\n    await delegate.getSocket(),\n    {op: 'version'},\n    inspectVersionDownSchema,\n  );\n}\n\nexport function clientQueries(\n  delegate: ExtendedInspectorDelegate,\n  clientID: string,\n): Promise<Query[]> {\n  return queries(delegate, {op: 'queries', clientID});\n}\n\nasync function queries(\n  delegate: ExtendedInspectorDelegate,\n  arg: {op: 'queries'; clientID?: string},\n): Promise<Query[]> {\n  const rows: InspectQueryRow[] = await rpc(\n    await delegate.getSocket(),\n    arg,\n    inspectQueriesDownSchema,\n  );\n  const queries = rows.map(row => new Query(row, delegate, delegate.getSocket));\n  queries.sort((a, b) => (b.hydrateServer ?? 0) - (a.hydrateServer ?? 0));\n  return queries;\n}\n\nexport async function analyzeQuery(\n  delegate: ExtendedInspectorDelegate,\n  query: AnyQuery,\n  options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n  const qi = asQueryInternals(query);\n  const {customQueryID} = qi;\n  const queryParameters = customQueryID\n    ? {name: customQueryID.name, args: customQueryID.args}\n    : {ast: delegate.mapClientASTToServer(qi.ast)};\n\n  return rpc(\n    await delegate.getSocket(),\n    {\n      op: 'analyze-query',\n      ...queryParameters,\n      options,\n    },\n    inspectAnalyzeQueryDownSchema,\n  );\n}\n\nexport async function analyzeServerAST(\n  delegate: ExtendedInspectorDelegate,\n  ast: AST,\n  options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n  return rpc(\n    await delegate.getSocket(),\n    {op: 'analyze-query', ast, options},\n    inspectAnalyzeQueryDownSchema,\n  );\n}\n\nexport async function analyzeNamedQuery(\n  delegate: ExtendedInspectorDelegate,\n  name: string,\n  args: ReadonlyArray<ReadonlyJSONValue>,\n  options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n  return rpc(\n    await delegate.getSocket(),\n    {op: 'analyze-query', name, args, options},\n    inspectAnalyzeQueryDownSchema,\n  );\n}\n\n/**\n * Sends an `authenticate` op to the server. Returns `true` if the password\n * is accepted (or the server is in a development mode that bypasses the\n * check). Use this from Node contexts where the default interactive HTML\n * prompt used by other inspector RPCs is not available.\n */\nexport async function authenticate(\n  delegate: ExtendedInspectorDelegate,\n  password: string,\n): Promise<boolean> {\n  return rpc(\n    await delegate.getSocket(),\n    {op: 'authenticate', value: password},\n    inspectAuthenticatedDownSchema,\n  );\n}\n\nclass UnauthenticatedError extends Error {}\n\nexport interface InspectorDelegate {\n  getQueryMetrics(hash: string): QueryClientMetrics | undefined;\n  getAST(queryID: string): AST | undefined;\n  readonly metrics: ClientMetrics;\n  mapClientASTToServer(ast: AST): AST;\n  setQueryEvictedCallback(\n    cb: (hash: string, ast: AST, metrics: QueryClientMetrics) => void,\n  ): void;\n}\n\nexport interface ExtendedInspectorDelegate extends InspectorDelegate {\n  readonly rep: Rep;\n  readonly getSocket: () => Promise<WebSocket>;\n  readonly queryDelegate: QueryDelegate;\n  lazy: Promise<Lazy>;\n}\n\nexport type Rep = ReplicacheImpl<MutatorDefs>;\n\nexport type QueryClientMetrics = {\n  readonly 'query-materialization-client': number | undefined;\n  readonly 'query-materialization-end-to-end': number | undefined;\n  readonly 'query-update-client': ReadonlyTDigest;\n};\n\nexport type ClientMetrics = {\n  readonly [K in keyof ClientMetricMap]: ReadonlyTDigest;\n};\n\nexport type ServerMetrics = {\n  readonly [K in keyof ServerMetricMap]: ReadonlyTDigest;\n};\n"],"mappings":"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"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"query.js","names":["#socket","#serverAST"],"sources":["../../../../../../zero-client/src/client/inspector/query.ts"],"sourcesContent":["import {astToZQL} from '../../../../ast-to-zql/src/ast-to-zql.ts';\nimport type {ReadonlyJSONValue} from '../../../../shared/src/json.ts';\nimport {must} from '../../../../shared/src/must.ts';\nimport type {AnalyzeQueryResult} from '../../../../zero-protocol/src/analyze-query-result.ts';\nimport type {AST} from '../../../../zero-protocol/src/ast.ts';\nimport {\n  type InspectQueryRow,\n  inspectAnalyzeQueryDownSchema,\n} from '../../../../zero-protocol/src/inspect-down.ts';\nimport type {AnalyzeQueryOptions} from '../../../../zero-protocol/src/inspect-up.ts';\nimport {type TTL, normalizeTTL} from '../../../../zql/src/query/ttl.ts';\nimport {\n  type ExtendedInspectorDelegate,\n  type GetWebSocket,\n  type Metrics,\n  mergeMetrics,\n  rpc,\n} from './lazy-inspector.ts';\n\nexport class Query {\n  readonly #socket: GetWebSocket;\n\n  readonly name: string | null;\n  readonly args: ReadonlyArray<ReadonlyJSONValue> | null;\n  readonly got: boolean;\n  readonly ttl: TTL;\n  readonly inactivatedAt: Date | null;\n  readonly rowCount: number;\n  readonly deleted: boolean;\n  readonly id: string;\n  readonly clientID: string;\n  readonly metrics: Metrics | null;\n  readonly clientZQL: string | null;\n  readonly serverZQL: string | null;\n  readonly #serverAST: AST | null;\n\n  readonly hydrateClient: number | null;\n  readonly hydrateServer: number | null;\n  readonly hydrateTotal: number | null;\n\n  readonly updateClientP50: number | null;\n  readonly updateClientP95: number | null;\n  readonly updateServerP50: number | null;\n  readonly updateServerP95: number | null;\n\n  constructor(\n    row: InspectQueryRow,\n    delegate: ExtendedInspectorDelegate,\n    socket: GetWebSocket,\n  ) {\n    this.#socket = socket;\n\n    const {ast, queryID, inactivatedAt} = row;\n    // Use own properties to make this more useful in dev tools. For example, in\n    // Chrome dev tools, if you do console.table(queries) you'll see the\n    // properties in the table, if these were getters you would not see them in the table.\n    this.clientID = row.clientID;\n    this.id = queryID;\n    this.inactivatedAt =\n      inactivatedAt === null ? null : new Date(inactivatedAt);\n    this.ttl = normalizeTTL(row.ttl);\n    this.name = row.name;\n    this.args = row.args;\n    this.got = row.got;\n    this.rowCount = row.rowCount;\n    this.deleted = row.deleted;\n    this.#serverAST = ast;\n    this.serverZQL = ast ? ast.table + astToZQL(ast) : null;\n    const clientAST = delegate.getAST(queryID);\n    this.clientZQL = clientAST ? clientAST.table + astToZQL(clientAST) : null;\n\n    // Merge client and server metrics\n    const clientMetrics = delegate.getQueryMetrics(queryID);\n    const serverMetrics = row.metrics;\n\n    const merged = mergeMetrics(clientMetrics, serverMetrics);\n    this.metrics = merged;\n\n    const percentile = (\n      name: keyof typeof merged,\n      percentile: number,\n    ): number | null => {\n      if (!merged?.[name]) {\n        return null;\n      }\n      const n = merged[name].quantile(percentile);\n      return Number.isNaN(n) ? null : n;\n    };\n\n    // Hydration times are plain numbers (performance.now()-based durations), so\n    // read them directly instead of going through the TDigest percentile path.\n    this.hydrateClient =\n      clientMetrics?.['query-materialization-client'] ?? null;\n    this.hydrateServer = serverMetrics?.['query-hydration-server-ms'] ?? null;\n    this.hydrateTotal =\n      clientMetrics?.['query-materialization-end-to-end'] ?? null;\n\n    // Extract update metrics (P50 and P95) - handle NaN by defaulting to 0\n    this.updateClientP50 = percentile('query-update-client', 0.5);\n    this.updateClientP95 = percentile('query-update-client', 0.95);\n\n    this.updateServerP50 = percentile('query-update-server', 0.5);\n    this.updateServerP95 = percentile('query-update-server', 0.95);\n  }\n\n  async analyze(options?: AnalyzeQueryOptions): Promise<AnalyzeQueryResult> {\n    const details =\n      this.name && this.args\n        ? {\n            name: this.name,\n            args: this.args,\n          }\n        : {value: must(this.#serverAST, 'AST is required for unnamed queries')};\n\n    return rpc(\n      await this.#socket(),\n      {\n        op: 'analyze-query',\n        ...details,\n        options,\n      },\n      inspectAnalyzeQueryDownSchema,\n    );\n  }\n}\n"],"mappings":";;;;;;AAmBA,IAAa,QAAb,MAAmB;CACjB;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CACA;CACA;CAEA,YACE,KACA,UACA,QACA;AACA,QAAA,SAAe;EAEf,MAAM,EAAC,KAAK,SAAS,kBAAiB;AAItC,OAAK,WAAW,IAAI;AACpB,OAAK,KAAK;AACV,OAAK,gBACH,kBAAkB,OAAO,OAAO,IAAI,KAAK,cAAc;AACzD,OAAK,MAAM,aAAa,IAAI,IAAI;AAChC,OAAK,OAAO,IAAI;AAChB,OAAK,OAAO,IAAI;AAChB,OAAK,MAAM,IAAI;AACf,OAAK,WAAW,IAAI;AACpB,OAAK,UAAU,IAAI;AACnB,QAAA,YAAkB;AAClB,OAAK,YAAY,MAAM,IAAI,QAAQ,SAAS,IAAI,GAAG;EACnD,MAAM,YAAY,SAAS,OAAO,QAAQ;AAC1C,OAAK,YAAY,YAAY,UAAU,QAAQ,SAAS,UAAU,GAAG;EAGrE,MAAM,gBAAgB,SAAS,gBAAgB,QAAQ;EACvD,MAAM,gBAAgB,IAAI;EAE1B,MAAM,SAAS,aAAa,eAAe,cAAc;AACzD,OAAK,UAAU;EAEf,MAAM,cACJ,MACA,eACkB;AAClB,OAAI,CAAC,SAAS,MACZ,QAAO;GAET,MAAM,IAAI,OAAO,MAAM,SAAS,WAAW;AAC3C,UAAO,OAAO,MAAM,EAAE,GAAG,OAAO;;AAKlC,OAAK,gBACH,gBAAgB,mCAAmC;AACrD,OAAK,gBAAgB,gBAAgB,gCAAgC;AACrE,OAAK,eACH,gBAAgB,uCAAuC;AAGzD,OAAK,kBAAkB,WAAW,uBAAuB,GAAI;AAC7D,OAAK,kBAAkB,WAAW,uBAAuB,IAAK;AAE9D,OAAK,kBAAkB,WAAW,uBAAuB,GAAI;AAC7D,OAAK,kBAAkB,WAAW,uBAAuB,IAAK;;CAGhE,MAAM,QAAQ,SAA4D;EACxE,MAAM,UACJ,KAAK,QAAQ,KAAK,OACd;GACE,MAAM,KAAK;GACX,MAAM,KAAK;GACZ,GACD,EAAC,OAAO,KAAK,MAAA,WAAiB,sCAAsC,EAAC;AAE3E,SAAO,IACL,MAAM,MAAA,QAAc,EACpB;GACE,IAAI;GACJ,GAAG;GACH;GACD,EACD,8BACD"}

package/out/zero-client/src/client/ivm-branch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ivm-branch.js","names":["#sources","#tables","#throwIfInvalid","#advanceError"],"sources":["../../../../../zero-client/src/client/ivm-branch.ts"],"sourcesContent":["import type {\n  InternalDiff,\n  InternalDiffOperation,\n  NoIndexDiff,\n} from '../../../replicache/src/btree/node.ts';\nimport type {LazyStore} from '../../../replicache/src/dag/lazy-store.ts';\nimport {type Read, type Store} from '../../../replicache/src/dag/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 {ZeroReadOptions} from '../../../replicache/src/replicache-options.ts';\nimport {diffBinarySearch} from '../../../replicache/src/subscriptions.ts';\nimport type {DiffsMap} from '../../../replicache/src/sync/diff.ts';\nimport {diff} from '../../../replicache/src/sync/diff.ts';\nimport {using, withRead} from '../../../replicache/src/with-transactions.ts';\nimport {assert} from '../../../shared/src/asserts.ts';\nimport {wrapIterable} from '../../../shared/src/iterables.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport type {Row} from '../../../zero-protocol/src/data.ts';\nimport type {TableSchema} from '../../../zero-schema/src/table-schema.ts';\nimport {MemorySource} from '../../../zql/src/ivm/memory-source.ts';\nimport {consume} from '../../../zql/src/ivm/stream.ts';\nimport {ENTITIES_KEY_PREFIX, sourceNameFromKey} from './keys.ts';\n\nimport {\n  makeSourceChangeAdd,\n  makeSourceChangeEdit,\n  makeSourceChangeRemove,\n} from '../../../zql/src/ivm/source.ts';\n/**\n * Replicache needs to rebase mutations onto different\n * commits of it's b-tree. These mutations can have reads\n * in them and those reads must be run against the IVM sources.\n *\n * To ensure the reads get the correct state, the IVM\n * sources need to reflect the state of the commit\n * being rebased onto. `IVMSourceBranch` allows us to:\n * 1. fork the IVM sources\n * 2. patch them up to match the desired head\n * 3. run the reads against the forked sources\n *\n * (2) is expected to be a cheap operation as there should only\n * ever be a few outstanding diffs to apply given Zero is meant\n * to be run in a connected state.\n */\nexport class IVMSourceBranch {\n  readonly #sources: Map<string, MemorySource | undefined>;\n  readonly #tables: Record<string, TableSchema>;\n  #advanceError: unknown;\n  hash: Hash | undefined;\n\n  constructor(\n    tables: Record<string, TableSchema>,\n    hash?: Hash,\n    sources: Map<string, MemorySource | undefined> = new Map(),\n  ) {\n    this.#tables = tables;\n    this.#sources = sources;\n    this.hash = hash;\n  }\n\n  getSource(name: string): MemorySource | undefined {\n    this.#throwIfInvalid();\n\n    if (this.#sources.has(name)) {\n      return this.#sources.get(name);\n    }\n\n    const schema = this.#tables[name];\n    const source = schema\n      ? new MemorySource(name, schema.columns, schema.primaryKey)\n      : undefined;\n    this.#sources.set(name, source);\n    return source;\n  }\n\n  clear() {\n    this.#sources.clear();\n  }\n\n  #throwIfInvalid() {\n    if (this.#advanceError) {\n      throw this.#advanceError;\n    }\n  }\n\n  /**\n   * Mutates the current branch, advancing it to the new head\n   * by applying the given diffs.\n   */\n  advance(expectedHead: Hash | undefined, newHead: Hash, diffs: NoIndexDiff) {\n    this.#throwIfInvalid();\n\n    assert(\n      this.hash === expectedHead,\n      () =>\n        `Expected head must match the main head. Got: ${this.hash}, expected: ${expectedHead}`,\n    );\n\n    try {\n      applyDiffs(diffs, this);\n      this.hash = newHead;\n    } catch (e) {\n      this.#advanceError = e;\n      this.clear();\n      throw e;\n    }\n  }\n\n  /**\n   * Fork the branch and patch it up to match the desired head.\n   */\n  async forkToHead(\n    store: LazyStore,\n    desiredHead: Hash,\n    readOptions?: ZeroReadOptions,\n  ): Promise<IVMSourceBranch> {\n    this.#throwIfInvalid();\n\n    const fork = this.fork();\n\n    if (fork.hash === desiredHead) {\n      return fork;\n    }\n\n    await patchBranch(desiredHead, store, fork, readOptions);\n    fork.hash = desiredHead;\n    return fork;\n  }\n\n  /**\n   * Creates a new IVMSourceBranch that is a copy of the current one.\n   * This is a cheap operation since the b-trees are shared until a write is performed\n   * and then only the modified nodes are copied.\n   *\n   * IVM branches are forked when we need to rebase mutations.\n   * The mutations modify the fork rather than original branch.\n   */\n  fork() {\n    this.#throwIfInvalid();\n\n    return new IVMSourceBranch(\n      this.#tables,\n      this.hash,\n      new Map(\n        wrapIterable(this.#sources.entries()).map(([name, source]) => [\n          name,\n          source?.fork(),\n        ]),\n      ),\n    );\n  }\n}\n\nexport async function initFromStore(\n  branch: IVMSourceBranch,\n  hash: Hash,\n  store: Store,\n) {\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)) {\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\n  branch.advance(undefined, hash, diffs);\n}\n\nasync function patchBranch(\n  desiredHead: Hash,\n  store: LazyStore,\n  fork: IVMSourceBranch,\n  readOptions: ZeroReadOptions | undefined,\n) {\n  const diffs = await computeDiffs(\n    must(fork.hash),\n    desiredHead,\n    store,\n    readOptions,\n  );\n  if (!diffs) {\n    return;\n  }\n  applyDiffs(diffs, fork);\n}\n\nasync function computeDiffs(\n  startHash: Hash,\n  endHash: Hash,\n  store: LazyStore,\n  readOptions: ZeroReadOptions | undefined,\n): Promise<InternalDiff | undefined> {\n  const readFn = (dagRead: Read) =>\n    diff(\n      startHash,\n      endHash,\n      dagRead,\n      {\n        shouldComputeDiffs: () => true,\n        shouldComputeDiffsForIndex(_name) {\n          return false;\n        },\n      },\n      FormatVersion.Latest,\n    );\n\n  let diffs: DiffsMap;\n  if (readOptions?.openLazySourceRead) {\n    diffs = await using(store.read(readOptions.openLazySourceRead), readFn);\n  } else if (readOptions?.openLazyRead) {\n    diffs = await readFn(readOptions.openLazyRead);\n  } else {\n    diffs = await withRead(store, readFn);\n  }\n\n  return diffs.get('');\n}\n\nfunction applyDiffs(diffs: NoIndexDiff, branch: IVMSourceBranch) {\n  for (\n    let i = diffBinarySearch(diffs, ENTITIES_KEY_PREFIX, diff => diff.key);\n    i < diffs.length;\n    i++\n  ) {\n    const diff = diffs[i];\n    const {key} = diff;\n    if (!key.startsWith(ENTITIES_KEY_PREFIX)) {\n      break;\n    }\n    const name = sourceNameFromKey(key);\n    const source = must(branch.getSource(name));\n    switch (diff.op) {\n      case 'del':\n        consume(source.push(makeSourceChangeRemove(diff.oldValue as Row)));\n        break;\n      case 'add':\n        consume(source.push(makeSourceChangeAdd(diff.newValue as Row)));\n        break;\n      case 'change':\n        consume(\n          source.push(\n            makeSourceChangeEdit(diff.newValue as Row, diff.oldValue as Row),\n          ),\n        );\n        break;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,IAAa,kBAAb,MAAa,gBAAgB;CAC3B;CACA;CACA;CACA;CAEA,YACE,QACA,MACA,0BAAiD,IAAI,KAAK,EAC1D;AACA,QAAA,SAAe;AACf,QAAA,UAAgB;AAChB,OAAK,OAAO;;CAGd,UAAU,MAAwC;AAChD,QAAA,gBAAsB;AAEtB,MAAI,MAAA,QAAc,IAAI,KAAK,CACzB,QAAO,MAAA,QAAc,IAAI,KAAK;EAGhC,MAAM,SAAS,MAAA,OAAa;EAC5B,MAAM,SAAS,SACX,IAAI,aAAa,MAAM,OAAO,SAAS,OAAO,WAAW,GACzD,KAAA;AACJ,QAAA,QAAc,IAAI,MAAM,OAAO;AAC/B,SAAO;;CAGT,QAAQ;AACN,QAAA,QAAc,OAAO;;CAGvB,kBAAkB;AAChB,MAAI,MAAA,aACF,OAAM,MAAA;;;;;;CAQV,QAAQ,cAAgC,SAAe,OAAoB;AACzE,QAAA,gBAAsB;AAEtB,SACE,KAAK,SAAS,oBAEZ,gDAAgD,KAAK,KAAK,cAAc,eAC3E;AAED,MAAI;AACF,cAAW,OAAO,KAAK;AACvB,QAAK,OAAO;WACL,GAAG;AACV,SAAA,eAAqB;AACrB,QAAK,OAAO;AACZ,SAAM;;;;;;CAOV,MAAM,WACJ,OACA,aACA,aAC0B;AAC1B,QAAA,gBAAsB;EAEtB,MAAM,OAAO,KAAK,MAAM;AAExB,MAAI,KAAK,SAAS,YAChB,QAAO;AAGT,QAAM,YAAY,aAAa,OAAO,MAAM,YAAY;AACxD,OAAK,OAAO;AACZ,SAAO;;;;;;;;;;CAWT,OAAO;AACL,QAAA,gBAAsB;AAEtB,SAAO,IAAI,gBACT,MAAA,QACA,KAAK,MACL,IAAI,IACF,aAAa,MAAA,QAAc,SAAS,CAAC,CAAC,KAAK,CAAC,MAAM,YAAY,CAC5D,MACA,QAAQ,MAAM,CACf,CAAC,CACH,CACF;;;AA2BL,eAAe,YACb,aACA,OACA,MACA,aACA;CACA,MAAM,QAAQ,MAAM,aAClB,KAAK,KAAK,KAAK,EACf,aACA,OACA,YACD;AACD,KAAI,CAAC,MACH;AAEF,YAAW,OAAO,KAAK;;AAGzB,eAAe,aACb,WACA,SACA,OACA,aACmC;CACnC,MAAM,UAAU,YACd,KACE,WACA,SACA,SACA;EACE,0BAA0B;EAC1B,2BAA2B,OAAO;AAChC,UAAO;;EAEV,EACD,EACD;CAEH,IAAI;AACJ,KAAI,aAAa,mBACf,SAAQ,MAAM,MAAM,MAAM,KAAK,YAAY,mBAAmB,EAAE,OAAO;UAC9D,aAAa,aACtB,SAAQ,MAAM,OAAO,YAAY,aAAa;KAE9C,SAAQ,MAAM,SAAS,OAAO,OAAO;AAGvC,QAAO,MAAM,IAAI,GAAG;;AAGtB,SAAS,WAAW,OAAoB,QAAyB;AAC/D,MACE,IAAI,IAAI,iBAAiB,OAAA,OAA4B,SAAQ,KAAK,IAAI,EACtE,IAAI,MAAM,QACV,KACA;EACA,MAAM,OAAO,MAAM;EACnB,MAAM,EAAC,QAAO;AACd,MAAI,CAAC,IAAI,WAAA,KAA+B,CACtC;EAEF,MAAM,OAAO,kBAAkB,IAAI;EACnC,MAAM,SAAS,KAAK,OAAO,UAAU,KAAK,CAAC;AAC3C,UAAQ,KAAK,IAAb;GACE,KAAK;AACH,YAAQ,OAAO,KAAK,uBAAuB,KAAK,SAAgB,CAAC,CAAC;AAClE;GACF,KAAK;AACH,YAAQ,OAAO,KAAK,oBAAoB,KAAK,SAAgB,CAAC,CAAC;AAC/D;GACF,KAAK;AACH,YACE,OAAO,KACL,qBAAqB,KAAK,UAAiB,KAAK,SAAgB,CACjE,CACF;AACD"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"keys.js","names":[],"sources":["../../../../../zero-client/src/client/keys.ts"],"sourcesContent":["import {h128} from '../../../shared/src/hash.ts';\nimport * as v from '../../../shared/src/valita.ts';\nimport type {CompoundKey} from '../../../zero-protocol/src/ast.ts';\nimport type {Row} from '../../../zero-protocol/src/data.ts';\nimport type {MutationID} from '../../../zero-protocol/src/mutation-id.ts';\nimport {primaryKeyValueSchema} from '../../../zero-protocol/src/primary-key.ts';\n\nexport const DESIRED_QUERIES_KEY_PREFIX = 'd/';\nexport const GOT_QUERIES_KEY_PREFIX = 'g/';\nexport const ENTITIES_KEY_PREFIX = 'e/';\nexport const MUTATIONS_KEY_PREFIX = 'm/';\n\nexport function toDesiredQueriesKey(clientID: string, hash: string): string {\n  return DESIRED_QUERIES_KEY_PREFIX + clientID + '/' + hash;\n}\n\nexport function desiredQueriesPrefixForClient(clientID: string): string {\n  return DESIRED_QUERIES_KEY_PREFIX + clientID + '/';\n}\n\nexport function toGotQueriesKey(hash: string): string {\n  return GOT_QUERIES_KEY_PREFIX + hash;\n}\n\nexport function toMutationResponseKey(mid: MutationID): string {\n  return MUTATIONS_KEY_PREFIX + mid.clientID + '/' + mid.id;\n}\n\nexport function toPrimaryKeyString(\n  tableName: string,\n  primaryKey: CompoundKey,\n  value: Row,\n): string {\n  if (primaryKey.length === 1) {\n    return (\n      ENTITIES_KEY_PREFIX +\n      tableName +\n      '/' +\n      v.parse(value[primaryKey[0]], primaryKeyValueSchema)\n    );\n  }\n\n  const values = primaryKey.map(k => v.parse(value[k], primaryKeyValueSchema));\n  const str = JSON.stringify(values);\n\n  const idSegment = h128(str);\n  return ENTITIES_KEY_PREFIX + tableName + '/' + idSegment;\n}\n\nexport function sourceNameFromKey(key: string): string {\n  const slash = key.indexOf('/', ENTITIES_KEY_PREFIX.length);\n  return key.slice(ENTITIES_KEY_PREFIX.length, slash);\n}\n"],"mappings":";;;AAYA,SAAgB,oBAAoB,UAAkB,MAAsB;AAC1E,QAAA,OAAoC,WAAW,MAAM;;AAGvD,SAAgB,8BAA8B,UAA0B;AACtE,QAAA,OAAoC,WAAW;;AAGjD,SAAgB,gBAAgB,MAAsB;AACpD,QAAA,OAAgC;;AAGlC,SAAgB,sBAAsB,KAAyB;AAC7D,QAAA,OAA8B,IAAI,WAAW,MAAM,IAAI;;AAGzD,SAAgB,mBACd,WACA,YACA,OACQ;AACR,KAAI,WAAW,WAAW,EACxB,QAAA,OAEE,YACA,MACA,MAAQ,MAAM,WAAW,KAAK,sBAAsB;CAIxD,MAAM,SAAS,WAAW,KAAI,MAAK,MAAQ,MAAM,IAAI,sBAAsB,CAAC;CAG5E,MAAM,YAAY,KAFN,KAAK,UAAU,OAAO,CAEP;AAC3B,QAAA,OAA6B,YAAY,MAAM;;AAGjD,SAAgB,kBAAkB,KAAqB;CACrD,MAAM,QAAQ,IAAI,QAAQ,KAAK,EAA2B;AAC1D,QAAO,IAAI,MAAM,GAA4B,MAAM"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"log-options.js","names":["#wrappedLogSink","#level"],"sources":["../../../../../zero-client/src/client/log-options.ts"],"sourcesContent":["import {\n  TeeLogSink,\n  consoleLogSink,\n  type Context,\n  type LogLevel,\n  type LogSink,\n} from '@rocicorp/logger';\nimport {\n  DatadogLogSink,\n  type DatadogLogSinkOptions,\n} from '../../../datadog/src/datadog-log-sink.ts';\nimport {appendPath, type HTTPString} from './http-string.ts';\nimport {version} from './version.ts';\n\nclass LevelFilterLogSink implements LogSink {\n  readonly #wrappedLogSink: LogSink;\n  readonly #level: LogLevel;\n\n  constructor(wrappedLogSink: LogSink, level: LogLevel) {\n    this.#wrappedLogSink = wrappedLogSink;\n    this.#level = level;\n  }\n\n  log(level: LogLevel, context: Context | undefined, ...args: unknown[]): void {\n    if (this.#level === 'error' && level !== 'error') {\n      return;\n    }\n    if (this.#level === 'info' && level === 'debug') {\n      return;\n    }\n    this.#wrappedLogSink.log(level, context, ...args);\n  }\n\n  async flush() {\n    await consoleLogSink.flush?.();\n  }\n}\n\nconst DATADOG_LOG_LEVEL = 'info';\nconst ZERO_SASS_DOMAIN = '.reflect-server.net';\n\nexport type LogOptions = {\n  readonly logLevel: LogLevel;\n  readonly logSink: LogSink;\n};\n\nexport function createLogOptions(\n  options: {\n    consoleLogLevel: LogLevel;\n    server: HTTPString | null;\n    enableAnalytics: boolean;\n    consoleLogSink?: LogSink | undefined;\n  },\n  createDatadogLogSink: (options: DatadogLogSinkOptions) => LogSink = (\n    options: DatadogLogSinkOptions,\n  ) => new DatadogLogSink(options),\n): LogOptions {\n  const {consoleLogLevel, server, enableAnalytics} = options;\n  const userSink = options.consoleLogSink ?? consoleLogSink;\n\n  if (!enableAnalytics || server === null) {\n    return {\n      logLevel: consoleLogLevel,\n      logSink: userSink,\n    };\n  }\n\n  const serverURL = new URL(server);\n  const {hostname} = serverURL;\n  const datadogServiceLabel = hostname.endsWith(ZERO_SASS_DOMAIN)\n    ? hostname\n        .substring(0, hostname.length - ZERO_SASS_DOMAIN.length)\n        .toLowerCase()\n    : hostname;\n  const baseURL = new URL(appendPath(server, '/logs/v0/log'));\n  const logLevel = consoleLogLevel === 'debug' ? 'debug' : 'info';\n  const logSink = new TeeLogSink([\n    new LevelFilterLogSink(userSink, consoleLogLevel),\n    new LevelFilterLogSink(\n      createDatadogLogSink({\n        service: datadogServiceLabel,\n        host: location.host,\n        version,\n        baseURL,\n      }),\n      DATADOG_LOG_LEVEL,\n    ),\n  ]);\n  return {\n    logLevel,\n    logSink,\n  };\n}\n"],"mappings":";;;;;AAcA,IAAM,qBAAN,MAA4C;CAC1C;CACA;CAEA,YAAY,gBAAyB,OAAiB;AACpD,QAAA,iBAAuB;AACvB,QAAA,QAAc;;CAGhB,IAAI,OAAiB,SAA8B,GAAG,MAAuB;AAC3E,MAAI,MAAA,UAAgB,WAAW,UAAU,QACvC;AAEF,MAAI,MAAA,UAAgB,UAAU,UAAU,QACtC;AAEF,QAAA,eAAqB,IAAI,OAAO,SAAS,GAAG,KAAK;;CAGnD,MAAM,QAAQ;AACZ,QAAM,eAAe,SAAS;;;AAIlC,IAAM,oBAAoB;AAC1B,IAAM,mBAAmB;AAOzB,SAAgB,iBACd,SAMA,wBACE,YACG,IAAI,eAAe,QAAQ,EACpB;CACZ,MAAM,EAAC,iBAAiB,QAAQ,oBAAmB;CACnD,MAAM,WAAW,QAAQ,kBAAkB;AAE3C,KAAI,CAAC,mBAAmB,WAAW,KACjC,QAAO;EACL,UAAU;EACV,SAAS;EACV;CAIH,MAAM,EAAC,aADW,IAAI,IAAI,OAAO;CAEjC,MAAM,sBAAsB,SAAS,SAAS,iBAAiB,GAC3D,SACG,UAAU,GAAG,SAAS,SAAS,GAAwB,CACvD,aAAa,GAChB;CACJ,MAAM,UAAU,IAAI,IAAI,WAAW,QAAQ,eAAe,CAAC;AAc3D,QAAO;EACL,UAde,oBAAoB,UAAU,UAAU;EAevD,SAdc,IAAI,WAAW,CAC7B,IAAI,mBAAmB,UAAU,gBAAgB,EACjD,IAAI,mBACF,qBAAqB;GACnB,SAAS;GACT,MAAM,SAAS;GACf;GACA;GACD,CAAC,EACF,kBACD,CACF,CAAC;EAID"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"make-mutate-property.js","names":[],"sources":["../../../../../zero-client/src/client/make-mutate-property.ts"],"sourcesContent":["import type {DeepMerge} from '../../../shared/src/deep-merge.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport type {Schema} from '../../../zero-types/src/schema.ts';\nimport {\n  customMutatorKey,\n  type Transaction,\n} from '../../../zql/src/mutate/custom.ts';\nimport type {DBMutator} from './crud.ts';\nimport type {CustomMutatorDefs, MutatorResult} from './custom.ts';\nimport type {MutatorProxy} from './mutator-proxy.ts';\n\n/**\n * Creates and populates a mutate property object by processing mutator definitions recursively.\n *\n * This function traverses through mutator definitions (either schema-based or custom) and builds\n * a corresponding object structure where each mutator is wrapped by the mutator proxy. It handles\n * both flat mutator functions and nested mutator definition objects.\n *\n * @template S - The schema type that defines the structure of the data\n * @template C - The context type used by mutators, defaults to unknown\n *\n * @param mutators - The mutator definitions to process, can be schema-based or custom mutator definitions\n * @param mutatorProxy - The proxy object responsible for wrapping mutators with additional functionality\n * @param mutateObject - The target object to populate with wrapped mutators\n * @param replicacheMutate - The source object containing the actual mutator implementations to wrap\n *\n * @returns void - This function mutates the mutateObject parameter directly\n *\n * @remarks\n * The function recursively processes nested mutator structures, creating corresponding nested objects\n * in the mutateObject. For leaf mutators (functions or mutator definitions), it generates a full key\n * using different separators ('.' for mutator definitions, '|' for custom functions) and wraps them\n * using the mutator proxy.\n */\nexport function addCustomMutatorsProperties(\n  mutators: CustomMutatorDefs,\n  mutatorProxy: MutatorProxy,\n  mutateObject: Record<string, unknown>,\n  replicacheMutate: Record<string, unknown>,\n): void {\n  const processMutators = (\n    mutators: CustomMutatorDefs,\n    path: string[],\n    mutateObject: Record<string, unknown>,\n  ) => {\n    for (const [key, mutator] of Object.entries(mutators)) {\n      path.push(key);\n      if (typeof mutator === 'function') {\n        const fullKey = customMutatorKey('|', path);\n        mutateObject[key] = mutatorProxy.wrapCustomMutator(\n          fullKey,\n          must(replicacheMutate[fullKey]) as unknown as (\n            ...args: unknown[]\n          ) => MutatorResult,\n        );\n      } else {\n        // Nested namespace - recursive build and process.\n        let existing = mutateObject[key];\n        if (existing === undefined) {\n          existing = {};\n          mutateObject[key] = existing;\n        }\n        processMutators(\n          mutator as CustomMutatorDefs,\n          path,\n          existing as Record<string, unknown>,\n        );\n      }\n      path.pop();\n    }\n  };\n\n  processMutators(mutators, [], mutateObject);\n}\n\n/**\n * Builds the mutate type from legacy CustomMutatorDefs, handling arbitrary nesting.\n * Each node can be either a CustomMutatorImpl function or a namespace containing more mutators.\n */\ntype MakeFromMutatorDefinitions<\n  S extends Schema,\n  MD extends CustomMutatorDefs,\n  C,\n> = {\n  readonly [K in keyof MD]: MD[K] extends (\n    tx: Transaction<S>,\n    ...args: infer Args\n  ) => Promise<void>\n    ? (...args: Args) => MutatorResult\n    : MD[K] extends CustomMutatorDefs\n      ? MakeFromMutatorDefinitions<S, MD[K], C>\n      : never;\n};\n\nexport type MakeMutatePropertyType<\n  S extends Schema,\n  MD extends CustomMutatorDefs | undefined,\n  C,\n> = MD extends CustomMutatorDefs\n  ? S['enableLegacyMutators'] extends true\n    ? DeepMerge<DBMutator<S>, MakeFromMutatorDefinitions<S, MD, C>>\n    : MakeFromMutatorDefinitions<S, MD, C>\n  : DBMutator<S>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,4BACd,UACA,cACA,cACA,kBACM;CACN,MAAM,mBACJ,UACA,MACA,iBACG;AACH,OAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,SAAS,EAAE;AACrD,QAAK,KAAK,IAAI;AACd,OAAI,OAAO,YAAY,YAAY;IACjC,MAAM,UAAU,iBAAiB,KAAK,KAAK;AAC3C,iBAAa,OAAO,aAAa,kBAC/B,SACA,KAAK,iBAAiB,SAAS,CAGhC;UACI;IAEL,IAAI,WAAW,aAAa;AAC5B,QAAI,aAAa,KAAA,GAAW;AAC1B,gBAAW,EAAE;AACb,kBAAa,OAAO;;AAEtB,oBACE,SACA,MACA,SACD;;AAEH,QAAK,KAAK;;;AAId,iBAAgB,UAAU,EAAE,EAAE,aAAa"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"make-replicache-mutators.js","names":[],"sources":["../../../../../zero-client/src/client/make-replicache-mutators.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {MutatorDefs} from '../../../replicache/src/types.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport {CRUD_MUTATION_NAME} from '../../../zero-protocol/src/mutation.ts';\nimport type {Schema} from '../../../zero-types/src/schema.ts';\nimport {customMutatorKey} from '../../../zql/src/mutate/custom.ts';\nimport {\n  isMutatorRegistry,\n  type AnyMutatorRegistry,\n} from '../../../zql/src/mutate/mutator-registry.ts';\nimport {isMutator, type Mutator} from '../../../zql/src/mutate/mutator.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport {makeCRUDMutator, type CRUDMutator} from './crud.ts';\nimport type {CustomMutatorDefs, CustomMutatorImpl} from './custom.ts';\nimport {\n  makeReplicacheMutator as makeReplicacheMutatorLegacy,\n  TransactionImpl,\n} from './custom.ts';\nimport {ClientError} from './error.ts';\nimport type {WriteTransaction} from './replicache-types.ts';\n\nexport function extendReplicacheMutators<S extends Schema, C>(\n  lc: LogContext,\n  context: C,\n  mutators: AnyMutatorRegistry | CustomMutatorDefs,\n  schema: S,\n  mutateObject: Record<string, unknown>,\n): void {\n  // Recursively process mutator definitions at arbitrary depth\n  const processMutators = (mutators: object, path: string[]) => {\n    for (const [key, mutator] of Object.entries(mutators)) {\n      if (key === '~') {\n        // Skip phantom type\n        continue;\n      }\n\n      path.push(key);\n      if (isMutator(mutator)) {\n        const fullKey = customMutatorKey('.', path);\n        mutateObject[fullKey] = makeReplicacheMutator(\n          lc,\n          mutator,\n          schema,\n          context,\n        );\n      } else if (typeof mutator === 'function') {\n        const fullKey = customMutatorKey('|', path);\n        mutateObject[fullKey] = makeReplicacheMutatorLegacy(\n          lc,\n          // oxlint-disable-next-line no-explicit-any\n          mutator as CustomMutatorImpl<any>,\n          schema,\n          context,\n        );\n      } else if (mutator !== null && typeof mutator === 'object') {\n        processMutators(mutator, path);\n      }\n      path.pop();\n    }\n  };\n\n  processMutators(mutators, []);\n}\n\nfunction makeReplicacheMutator<\n  TArgs extends ReadonlyJSONValue | undefined,\n  TSchema extends Schema,\n  TContext,\n  TWrappedTransaction,\n>(\n  lc: LogContext,\n  mutator: Mutator<TArgs, TSchema, TContext, TWrappedTransaction>,\n  schema: TSchema,\n  context: TContext,\n): (repTx: WriteTransaction, args: ReadonlyJSONValue) => Promise<void> {\n  return async (\n    repTx: WriteTransaction,\n    args: ReadonlyJSONValue,\n  ): Promise<void> => {\n    const tx = new TransactionImpl(lc, repTx, schema);\n    // fn does input validation internally\n    await mutator.fn({\n      args: args as TArgs,\n      ctx: context,\n      tx: tx,\n    });\n  };\n}\n\n/**\n * Creates Replicache mutators from mutator definitions.\n *\n * This function processes mutator definitions at arbitrary depth, supporting both\n * new-style mutator definitions and legacy custom mutator implementations. It creates\n * a mutator object with the CRUD mutator and any provided custom mutators, with keys\n * generated based on their path in the mutator definition hierarchy.\n *\n * @template S - The schema type that defines the structure of the data\n * @template C - The type of the context object passed to mutators\n *\n * @param schema - The schema instance used for validation and type checking\n * @param mutators - The mutator definitions to process, can be nested objects or custom mutator definitions\n * @param context - The context to be passed to mutators\n * @param lc - The log context used for logging operations\n *\n * @returns A mutator definitions object containing the CRUD mutator and any custom mutators\n *\n * @remarks\n * - New-style mutator definitions use '.' as a separator in their keys\n * - Legacy custom mutator implementations use '|' as a separator in their keys\n * - The CRUD mutator can be disabled by setting `enableLegacyMutators: false` in the schema\n */\nexport function makeReplicacheMutators<const S extends Schema, C>(\n  schema: S,\n  mutators: AnyMutatorRegistry | CustomMutatorDefs | undefined,\n  context: C,\n  lc: LogContext,\n): MutatorDefs & {_zero_crud: CRUDMutator} {\n  const {enableLegacyMutators = false} = schema;\n\n  const replicacheMutators = {\n    [CRUD_MUTATION_NAME]: enableLegacyMutators\n      ? makeCRUDMutator(schema)\n      : // TODO(arv): This code is unreachable since the public API prevents\n        // calling CRUD mutators when enableLegacyMutators is false. Remove this.\n        () =>\n          Promise.reject(\n            new ClientError({\n              kind: ClientErrorKind.Internal,\n              message: 'Zero CRUD mutators are not enabled.',\n            }),\n          ),\n  };\n\n  if (mutators) {\n    if (isMutatorRegistry(mutators)) {\n      extendFromMutatorRegistry(\n        lc,\n        context,\n        mutators,\n        schema,\n        replicacheMutators,\n      );\n    } else {\n      extendReplicacheMutators(\n        lc,\n        context,\n        mutators as CustomMutatorDefs,\n        schema,\n        replicacheMutators,\n      );\n    }\n  }\n\n  return replicacheMutators;\n}\n\n/**\n * Extends replicache mutators from a MutatorRegistry.\n * Walks the registry tree and wraps each Mutator.fn for Replicache.\n */\nfunction extendFromMutatorRegistry<S extends Schema, C>(\n  lc: LogContext,\n  context: C,\n  registry: AnyMutatorRegistry,\n  schema: S,\n  mutateObject: Record<string, unknown>,\n): void {\n  const walk = (node: unknown) => {\n    if (typeof node !== 'object' || node === null) {\n      return;\n    }\n    for (const value of Object.values(node)) {\n      if (isMutator<S>(value)) {\n        // Mutator.fn already handles validation internally\n        mutateObject[value.mutatorName] = (\n          repTx: WriteTransaction,\n          args: ReadonlyJSONValue,\n        ): Promise<void> => {\n          const tx = new TransactionImpl(lc, repTx, schema);\n          return value.fn({args, ctx: context, tx});\n        };\n      } else if (typeof value === 'object' && value !== null) {\n        // Nested namespace\n        walk(value);\n      }\n    }\n  };\n  walk(registry);\n}\n"],"mappings":";;;;;;;;;AAqBA,SAAgB,yBACd,IACA,SACA,UACA,QACA,cACM;CAEN,MAAM,mBAAmB,UAAkB,SAAmB;AAC5D,OAAK,MAAM,CAAC,KAAK,YAAY,OAAO,QAAQ,SAAS,EAAE;AACrD,OAAI,QAAQ,IAEV;AAGF,QAAK,KAAK,IAAI;AACd,OAAI,UAAU,QAAQ,EAAE;IACtB,MAAM,UAAU,iBAAiB,KAAK,KAAK;AAC3C,iBAAa,WAAW,sBACtB,IACA,SACA,QACA,QACD;cACQ,OAAO,YAAY,YAAY;IACxC,MAAM,UAAU,iBAAiB,KAAK,KAAK;AAC3C,iBAAa,WAAW,wBACtB,IAEA,SACA,QACA,QACD;cACQ,YAAY,QAAQ,OAAO,YAAY,SAChD,iBAAgB,SAAS,KAAK;AAEhC,QAAK,KAAK;;;AAId,iBAAgB,UAAU,EAAE,CAAC;;AAG/B,SAAS,sBAMP,IACA,SACA,QACA,SACqE;AACrE,QAAO,OACL,OACA,SACkB;EAClB,MAAM,KAAK,IAAI,gBAAgB,IAAI,OAAO,OAAO;AAEjD,QAAM,QAAQ,GAAG;GACT;GACN,KAAK;GACD;GACL,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BN,SAAgB,uBACd,QACA,UACA,SACA,IACyC;CACzC,MAAM,EAAC,uBAAuB,UAAS;CAEvC,MAAM,qBAAqB,GACxB,qBAAqB,uBAClB,gBAAgB,OAAO,SAIrB,QAAQ,OACN,IAAI,YAAY;EACd,MAAM;EACN,SAAS;EACV,CAAC,CACH,EACR;AAED,KAAI,SACF,KAAI,kBAAkB,SAAS,CAC7B,2BACE,IACA,SACA,UACA,QACA,mBACD;KAED,0BACE,IACA,SACA,UACA,QACA,mBACD;AAIL,QAAO;;;;;;AAOT,SAAS,0BACP,IACA,SACA,UACA,QACA,cACM;CACN,MAAM,QAAQ,SAAkB;AAC9B,MAAI,OAAO,SAAS,YAAY,SAAS,KACvC;AAEF,OAAK,MAAM,SAAS,OAAO,OAAO,KAAK,CACrC,KAAI,UAAa,MAAM,CAErB,cAAa,MAAM,gBACjB,OACA,SACkB;GAClB,MAAM,KAAK,IAAI,gBAAgB,IAAI,OAAO,OAAO;AACjD,UAAO,MAAM,GAAG;IAAC;IAAM,KAAK;IAAS;IAAG,CAAC;;WAElC,OAAO,UAAU,YAAY,UAAU,KAEhD,MAAK,MAAM;;AAIjB,MAAK,SAAS"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"metrics.js","names":["#reportIntervalMs","#host","#reporter","#lc","#setNotConnectedReason","#timerID","#register","#notConnected","#timeToConnectMsV2","#lastConnectErrorV2","#totalTimeToConnectMs","#metrics","#name","#value","#prefix","#clearOnFlush","#current"],"sources":["../../../../../zero-client/src/client/metrics.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {MaybePromise} from '../../../shared/src/types.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport {\n  isClientError,\n  isServerError,\n  type ZeroError,\n  type ZeroErrorKind,\n} from './error.ts';\nimport {MetricName} from './metric-name.ts';\n\n// This value is used to indicate that the client's last connection attempt\n// failed. We don't make this -1 because we want to stack this never connected\n// state in a graph on top of actual connection times, so it should be greater\n// than any other value.\nexport const DID_NOT_CONNECT_VALUE = 100 * 1000;\n\nexport const REPORT_INTERVAL_MS = 5_000;\n\ntype NotConnectedReason =\n  | 'init'\n  | 'error'\n  | 'hidden'\n  | 'hidden_was_init'\n  | 'hidden_was_error';\n\nexport function getLastConnectErrorValue(reason: ZeroError) {\n  return `${isServerError(reason) ? 'server_' : 'client_'}${camelToSnake(reason.kind)}` as const;\n}\n\nconst upperCasesRegExp = /\\.?(?=[A-Z])/;\n\n// camelToSnake is used to convert a ZeroErrorKind into a suitable\n// metric name, eg AuthInvalidated => auth_invalidated. It converts\n// both PascalCase and camelCase to snake_case.\nfunction camelToSnake(kind: ZeroErrorKind): string {\n  return kind.split(upperCasesRegExp).join('_').toLowerCase();\n}\n\n/**\n * Returns whether an error should be reported in metrics and\n * increment the connect error count.\n *\n * Returns `true` for all server errors and client errors that represent actual\n * connection problems. Returns `false` for expected client-side disconnections\n * (user disconnect, client closed, hidden tab, clean/abrupt close).\n */\nexport function shouldReportConnectError(reason: ZeroError): boolean {\n  if (!isClientError(reason)) {\n    return true;\n  }\n  switch (reason.kind) {\n    case ClientErrorKind.Hidden:\n    case ClientErrorKind.ClientClosed:\n    case ClientErrorKind.UserDisconnect:\n    case ClientErrorKind.CleanClose:\n    case ClientErrorKind.AbruptClose:\n      return false;\n    default:\n      return true;\n  }\n}\n\ntype MetricsReporter = (metrics: Series[]) => MaybePromise<void>;\n\nexport type MetricManagerOptions = {\n  reportIntervalMs: number;\n  host: string;\n  source: string;\n  reporter: MetricsReporter;\n  lc: LogContext;\n};\n\n/**\n * MetricManager keeps track of the set of metrics in use and flushes them\n * to a format suitable for reporting.\n */\nexport class MetricManager {\n  #reportIntervalMs: number;\n  #host: string;\n  #reporter: MetricsReporter;\n  #lc: LogContext;\n  #timerID: ReturnType<typeof setInterval> | null;\n\n  constructor(opts: MetricManagerOptions) {\n    this.#reportIntervalMs = opts.reportIntervalMs;\n    this.#host = opts.host;\n    this.#reporter = opts.reporter;\n    this.#lc = opts.lc;\n\n    this.tags.push(`source:${opts.source}`);\n\n    this.timeToConnectMs.set(DID_NOT_CONNECT_VALUE);\n    this.#setNotConnectedReason('init');\n\n    this.#timerID = setInterval(() => {\n      void this.flush();\n    }, this.#reportIntervalMs);\n  }\n\n  #metrics: Flushable[] = [];\n\n  // timeToConnectMs measures the time from the call to connect() to receiving\n  // the 'connected' ws message. We record the DID_NOT_CONNECT_VALUE if the previous\n  // connection attempt failed for any reason.\n  //\n  // We set the gauge using #connectStart as follows:\n  // - #connectStart is undefined if we are disconnected or connected; it is\n  //   defined only in the Connecting state, as a number representing the timestamp\n  //   at which we started connecting.\n  // - #connectStart is set to the current time when connect() is called.\n  // - When we receive the 'connected' message we record the time to connect and\n  //   set #connectStart to undefined.\n  // - If disconnect() is called with a defined #connectStart then we record\n  //   DID_NOT_CONNECT_VALUE and set #connectStart to undefined.\n  //\n  // TODO: this should be folded into the ConnectionManager.\n  readonly timeToConnectMs = this.#register(\n    new Gauge(MetricName.TimeToConnectMs),\n  );\n\n  // lastConnectError records the last error that occurred when connecting,\n  // if any. It is cleared when connecting successfully or when reported, so this\n  // state only gets reported if there was a failure during the reporting period and\n  // we are still not connected.\n  readonly lastConnectError = this.#register(\n    new State(\n      MetricName.LastConnectError,\n      true, // clearOnFlush\n    ),\n  );\n\n  // notConnected records the reason why the client is not currently connected.\n  // It is cleared when the client successfully connects.\n  readonly #notConnected = this.#register(new State(MetricName.NotConnected));\n\n  // The time from the call to connect() to receiving the 'connected' ws message\n  // for the current connection.  Cleared when the client is not connected.\n  // TODO: Not actually currently cleared on disconnect untill there is a\n  // connect error, or client reports disconnected and waiting for visible.\n  // Should have a value iff _notConnected has no value.\n  readonly #timeToConnectMsV2 = this.#register(\n    new Gauge(MetricName.TimeToConnectMsV2),\n  );\n\n  // lastConnectErrorV2 records the last error that occurred when connecting,\n  // if any. It is cleared when the client successfully connects or\n  // stops trying to connect due to being hidden.\n  // Should have a value iff notConnected state is NotConnectedReason.Error.\n  readonly #lastConnectErrorV2 = this.#register(\n    new State(MetricName.LastConnectErrorV2),\n  );\n\n  // The total time it took to connect across retries for the current\n  // connection.  Cleared when the client is not connected.\n  // TODO: Not actually currently cleared on disconnect until there is a\n  // connect error, or client reports disconnected and waiting for visible.\n  // See Zero.#totalToConnectStart for details of how this total is computed.\n  // Should have a value iff _notConnected has no value.\n  readonly #totalTimeToConnectMs = this.#register(\n    new Gauge(MetricName.TotalTimeToConnectMs),\n  );\n\n  #setNotConnectedReason(reason: NotConnectedReason) {\n    this.#notConnected.set(reason);\n  }\n\n  setConnected(timeToConnectMs: number, totalTimeToConnectMs: number) {\n    this.#notConnected.clear();\n    this.#lastConnectErrorV2.clear();\n    this.#timeToConnectMsV2.set(timeToConnectMs);\n    this.#totalTimeToConnectMs.set(totalTimeToConnectMs);\n  }\n\n  setDisconnectedWaitingForVisible() {\n    this.#timeToConnectMsV2.clear();\n    this.#totalTimeToConnectMs.clear();\n    this.#lastConnectErrorV2.clear();\n    let notConnectedReason: NotConnectedReason;\n    switch (this.#notConnected.get()) {\n      case 'init':\n        notConnectedReason = 'hidden_was_init';\n        break;\n      case 'error':\n        notConnectedReason = 'hidden_was_error';\n        break;\n      default:\n        notConnectedReason = 'hidden';\n        break;\n    }\n    this.#setNotConnectedReason(notConnectedReason);\n  }\n\n  setConnectError(reason: ZeroError) {\n    this.#timeToConnectMsV2.clear();\n    this.#totalTimeToConnectMs.clear();\n    this.#setNotConnectedReason('error');\n    this.#lastConnectErrorV2.set(getLastConnectErrorValue(reason));\n  }\n\n  /**\n   * Tags to include in all metrics.\n   */\n  readonly tags: string[] = [];\n\n  // Flushes all metrics to an array of time series (plural), one Series\n  // per metric.\n  async flush() {\n    const lc = this.#lc;\n    if (this.#timerID === null) {\n      lc.error?.('MetricManager.flush() called but already stopped');\n      return;\n    }\n    const allSeries: Series[] = [];\n    for (const metric of this.#metrics) {\n      const series = metric.flush();\n      if (series !== undefined) {\n        allSeries.push({\n          ...series,\n          host: this.#host,\n          tags: this.tags,\n        });\n      }\n    }\n    if (allSeries.length === 0) {\n      lc?.debug?.('No metrics to report');\n      return;\n    }\n    try {\n      await this.#reporter(allSeries);\n    } catch (e) {\n      lc?.error?.('Error reporting metrics', e);\n    }\n  }\n\n  stop() {\n    if (this.#timerID === null) {\n      this.#lc.error?.('MetricManager.stop() called but already stopped');\n      return;\n    }\n    clearInterval(this.#timerID);\n    this.#timerID = null;\n  }\n\n  #register<M extends Flushable>(metric: M) {\n    this.#metrics.push(metric);\n    return metric;\n  }\n}\n\n// These two types are influenced by Datadog's API's needs. We could change what\n// we use internally if necessary, but we'd just have to convert to/from before\n// sending to DD. So for convenience we go with their format.\n\n/** Series is a time series of points for a single metric. */\nexport type Series = {\n  host: string;\n  metric: string; // We call this 'name' bc 'metric' is overloaded in code.\n  points: Point[];\n  tags?: string[];\n};\n/**\n * A point is a second-resolution timestamp and a set of values for that\n * timestamp. A point represents exactly one second in time and the values\n * are those recorded for that second. The first element of this array\n * is the timestamp and the second element is an array of values.\n */\nexport type Point = [number, number[]];\n\nfunction makePoint(ts: number, value: number): Point {\n  return [ts, [value]];\n}\n\ntype Flushable = {\n  flush(): Pick<Series, 'metric' | 'points'> | undefined;\n};\n\n/**\n * Gauge is a metric type that represents a single value that can go up and\n * down. It's typically used to track discrete values or counts eg the number\n * of active users, number of connections, cpu load, etc. A gauge retains\n * its value when flushed.\n *\n * We use a Gauge to sample at the client. If we are interested in tracking\n * a metric value *per client*, the client can note the latest value in\n * a Gauge metric. The metric is periodically reported via Reporter. On the\n * server, we graph the value of the metric rolled up over the periodic\n * reporting period, that is, counted over a span of time equal to the\n * reporting period. The result is ~one point per client per reporting\n * period.\n */\nexport class Gauge implements Flushable {\n  readonly #name: string;\n  #value: number | undefined = undefined;\n\n  constructor(name: string) {\n    this.#name = name;\n  }\n\n  set(value: number) {\n    this.#value = value;\n  }\n\n  get() {\n    return this.#value;\n  }\n\n  clear() {\n    this.#value = undefined;\n  }\n\n  flush() {\n    if (this.#value === undefined) {\n      return undefined;\n    }\n    // Gauge reports the timestamp at flush time, not at the point the value was\n    // recorded.\n    const points = [makePoint(t(), this.#value)];\n    return {metric: this.#name, points};\n  }\n}\n\nfunction t() {\n  return Math.round(Date.now() / 1000);\n}\n\n/**\n * State is a metric type that represents a specific state that the system is\n * in, for example the state of a connection which may be 'open' or 'closed'.\n * The state is given a name/prefix at construction time (eg 'connection') and\n * then can be set to a specific state (eg 'open'). The prefix is prepended to\n * the set state (eg, 'connection_open') and a value of 1 is reported.\n * Unset/cleared states are not reported.\n *\n * Example:\n *   const s = new State('connection');\n *   s.set('open');\n *   s.flush(); // returns {metric: 'connection_open', points: [[now(), [1]]]}\n */\nexport class State implements Flushable {\n  readonly #prefix: string;\n  readonly #clearOnFlush: boolean;\n  #current: string | undefined = undefined;\n\n  constructor(prefix: string, clearOnFlush = false) {\n    this.#prefix = prefix;\n    this.#clearOnFlush = clearOnFlush;\n  }\n\n  set(state: string) {\n    this.#current = state;\n  }\n\n  get() {\n    return this.#current;\n  }\n\n  clear() {\n    this.#current = undefined;\n  }\n\n  flush() {\n    if (this.#current === undefined) {\n      return undefined;\n    }\n    const gauge = new Gauge([this.#prefix, this.#current].join('_'));\n    gauge.set(1);\n    const series = gauge.flush();\n    if (this.#clearOnFlush) {\n      this.clear();\n    }\n    return series;\n  }\n}\n"],"mappings":"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"}

package/out/zero-client/src/client/mutation-tracker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mutation-tracker.js","names":["#outstandingMutations","#ephemeralIDsByMutationID","#allMutationsAppliedListeners","#lc","#ackMutations","#onFatalError","#largestOutstandingMutationID","#currentMutationID","#clientID","#processMutationResponses","#settleMutation","#notifyAllMutationsAppliedListeners","#processMutationError","#processMutationOk","#fatalErrorFromPushError","#processPushOk","#resolveMutations"],"sources":["../../../../../zero-client/src/client/mutation-tracker.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport {resolver, type Resolver} from '@rocicorp/resolver';\nimport type {NoIndexDiff} from '../../../replicache/src/btree/node.ts';\nimport type {ReplicacheImpl} from '../../../replicache/src/impl.ts';\nimport type {\n  EphemeralID,\n  MutationTrackingData,\n} from '../../../replicache/src/replicache-options.ts';\nimport {assert, unreachable} from '../../../shared/src/asserts.ts';\nimport {getErrorDetails} from '../../../shared/src/error.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport {emptyObject} from '../../../shared/src/sentinels.ts';\nimport * as v from '../../../shared/src/valita.ts';\nimport {\n  ApplicationError,\n  isApplicationError,\n  wrapWithApplicationError,\n} from '../../../zero-protocol/src/application-error.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 {MutationID} from '../../../zero-protocol/src/mutation-id.ts';\nimport {\n  mutationResultSchema,\n  type MutationError,\n  type MutationOk,\n} from '../../../zero-protocol/src/mutation.ts';\nimport type {\n  PushError,\n  PushOk,\n  PushResponseBody,\n} from '../../../zero-protocol/src/push.ts';\nimport type {MutatorResultSuccessDetails} from './custom.ts';\nimport {isZeroError, type ZeroError} from './error.ts';\nimport {MUTATIONS_KEY_PREFIX} from './keys.ts';\n\ntype MutationSuccessType = MutatorResultSuccessDetails;\ntype MutationErrorType = ApplicationError | ZeroError;\n\nlet currentEphemeralID = 0;\nfunction nextEphemeralID(): EphemeralID {\n  return ++currentEphemeralID as EphemeralID;\n}\n\nconst successResultDetails: MutationSuccessType = {type: 'success'};\n\n/**\n * Tracks what pushes are in-flight and resolves promises when they're acked.\n */\nexport class MutationTracker {\n  readonly #outstandingMutations: Map<\n    EphemeralID,\n    {\n      mutationID?: number | undefined;\n      resolver: Resolver<MutationSuccessType, MutationErrorType>;\n    }\n  >;\n  readonly #ephemeralIDsByMutationID: Map<number, EphemeralID>;\n  readonly #allMutationsAppliedListeners: Set<() => void>;\n  readonly #lc: LogContext;\n\n  readonly #ackMutations: (upTo: MutationID) => void;\n  readonly #onFatalError: (error: ZeroError) => void;\n\n  #clientID: string | undefined;\n  #largestOutstandingMutationID: number;\n  #currentMutationID: number;\n\n  constructor(\n    lc: LogContext,\n    ackMutations: (upTo: MutationID) => void,\n    onFatalError: (error: ZeroError) => void,\n  ) {\n    this.#lc = lc.withContext('MutationTracker');\n    this.#outstandingMutations = new Map();\n    this.#ephemeralIDsByMutationID = new Map();\n    this.#allMutationsAppliedListeners = new Set();\n    this.#largestOutstandingMutationID = 0;\n    this.#currentMutationID = 0;\n    this.#ackMutations = ackMutations;\n    this.#onFatalError = onFatalError;\n  }\n\n  setClientIDAndWatch(\n    clientID: string,\n    experimentalWatch: ReplicacheImpl['experimentalWatch'],\n  ) {\n    assert(this.#clientID === undefined, 'clientID already set');\n    this.#clientID = clientID;\n    experimentalWatch(\n      diffs => {\n        this.#processMutationResponses(diffs);\n      },\n      {\n        prefix: MUTATIONS_KEY_PREFIX + clientID + '/',\n        initialValuesInFirstDiff: true,\n      },\n    );\n  }\n\n  trackMutation(): MutationTrackingData<MutationSuccessType> {\n    const id = nextEphemeralID();\n    const mutationResolver = resolver<MutationSuccessType, MutationErrorType>();\n\n    this.#outstandingMutations.set(id, {\n      resolver: mutationResolver,\n    });\n    return {ephemeralID: id, serverPromise: mutationResolver.promise};\n  }\n\n  mutationIDAssigned(id: EphemeralID, mutationID: number): void {\n    const entry = this.#outstandingMutations.get(id);\n    if (entry) {\n      entry.mutationID = mutationID;\n      this.#ephemeralIDsByMutationID.set(mutationID, id);\n      this.#largestOutstandingMutationID = Math.max(\n        this.#largestOutstandingMutationID,\n        mutationID,\n      );\n    }\n  }\n\n  /**\n   * Reject the mutation due to an unhandled exception on the client.\n   * The mutation must not have been persisted to the client store.\n   */\n  rejectMutation(id: EphemeralID, e: unknown): void {\n    const entry = this.#outstandingMutations.get(id);\n    if (entry) {\n      this.#settleMutation(id, entry, wrapWithApplicationError(e));\n    }\n  }\n\n  /**\n   * Reject all outstanding mutations. Called when the client is in a state\n   * that prevents mutations from being applied, such as offline or closed.\n   */\n  rejectAllOutstandingMutations(error: ZeroError): void {\n    if (this.#outstandingMutations.size === 0) {\n      return;\n    }\n    for (const [id, entry] of this.#outstandingMutations) {\n      this.#settleMutation(id, entry, error);\n    }\n    this.#largestOutstandingMutationID = this.#currentMutationID;\n    this.#notifyAllMutationsAppliedListeners();\n  }\n\n  /**\n   * Used when zero-cache pokes down mutation results.\n   */\n  #processMutationResponses(diffs: NoIndexDiff): void {\n    const clientID = must(this.#clientID);\n    let largestLmid = 0;\n    for (const diff of diffs) {\n      const mutationID = Number(\n        diff.key.slice(MUTATIONS_KEY_PREFIX.length + clientID.length + 1),\n      );\n      assert(\n        !isNaN(mutationID),\n        `MutationTracker received a diff with an invalid mutation ID: ${diff.key}`,\n      );\n      largestLmid = Math.max(largestLmid, mutationID);\n      switch (diff.op) {\n        case 'add': {\n          const result = v.parse(diff.newValue, mutationResultSchema);\n          if ('error' in result) {\n            this.#processMutationError(clientID, mutationID, result);\n          } else {\n            this.#processMutationOk(clientID, mutationID, result);\n          }\n          break;\n        }\n        case 'del':\n          break;\n        case 'change':\n          throw new Error('MutationTracker does not expect change operations');\n      }\n    }\n\n    if (largestLmid > 0) {\n      this.#ackMutations({\n        clientID: must(this.#clientID),\n        id: largestLmid,\n      });\n    }\n  }\n\n  processPushResponse(response: PushResponseBody): void {\n    if ('error' in response) {\n      this.#lc.error?.(\n        'Received an error response when pushing mutations',\n        response,\n      );\n      const fatalError = this.#fatalErrorFromPushError(response);\n      if (fatalError) {\n        this.#onFatalError(fatalError);\n      }\n    } else {\n      this.#processPushOk(response);\n    }\n  }\n\n  #fatalErrorFromPushError(error: PushError): ZeroError | undefined {\n    switch (error.error) {\n      case 'unsupportedPushVersion':\n        return new ProtocolError({\n          kind: ErrorKind.PushFailed,\n          origin: ErrorOrigin.ZeroCache,\n          reason: ErrorReason.Internal,\n          message: `Unsupported push version`,\n          mutationIDs: [],\n        });\n      case 'unsupportedSchemaVersion':\n        return new ProtocolError({\n          kind: ErrorKind.PushFailed,\n          origin: ErrorOrigin.ZeroCache,\n          reason: ErrorReason.Internal,\n          message: `Unsupported schema version`,\n          mutationIDs: [],\n        });\n      case 'http':\n        return new ProtocolError({\n          kind: ErrorKind.PushFailed,\n          origin: ErrorOrigin.ZeroCache,\n          reason: ErrorReason.HTTP,\n          status: error.status,\n          message: `Fetch from API server returned non-OK status ${error.status}: ${error.details ?? 'unknown'}`,\n          mutationIDs: [],\n        });\n      case 'zeroPusher':\n        return new ProtocolError({\n          kind: ErrorKind.PushFailed,\n          origin: ErrorOrigin.ZeroCache,\n          reason: ErrorReason.Internal,\n          message: `ZeroPusher error: ${error.details ?? 'unknown'}`,\n          mutationIDs: [],\n        });\n      default:\n        unreachable(error);\n    }\n  }\n\n  /**\n   * DEPRECATED: to be removed when we switch to fully driving\n   * mutation resolution via poke.\n   *\n   * When we reconnect to zero-cache, we resolve all outstanding mutations\n   * whose ID is less than or equal to the lastMutationID.\n   *\n   * The reason is that any responses the API server sent\n   * to those mutations have been lost.\n   *\n   * An example case: the API server responds while the connection\n   * is down. Those responses are lost.\n   *\n   * Mutations whose LMID is > the lastMutationID are not resolved\n   * since they will be retried by the client, giving us another chance\n   * at getting a response.\n   *\n   * The only way to ensure that all API server responses are\n   * received would be to have the API server write them\n   * to the DB while writing the LMID.\n   */\n  onConnected(lastMutationID: number) {\n    this.lmidAdvanced(lastMutationID);\n  }\n\n  /**\n   * lmid advance will:\n   * 1. notify \"allMutationsApplied\" listeners if the lastMutationID\n   *    is greater than or equal to the largest outstanding mutation ID.\n   * 2. resolve all mutations whose mutation ID is less than or equal to\n   *    the lastMutationID.\n   */\n  lmidAdvanced(lastMutationID: number): void {\n    assert(\n      lastMutationID >= this.#currentMutationID,\n      'lmid must be greater than or equal to current lmid',\n    );\n    if (lastMutationID === this.#currentMutationID) {\n      return;\n    }\n\n    try {\n      this.#currentMutationID = lastMutationID;\n      this.#resolveMutations(lastMutationID);\n    } finally {\n      if (lastMutationID >= this.#largestOutstandingMutationID) {\n        // this is very important otherwise we hang query de-registration\n        this.#notifyAllMutationsAppliedListeners();\n      }\n    }\n  }\n\n  get size() {\n    return this.#outstandingMutations.size;\n  }\n\n  #resolveMutations(upTo: number): void {\n    // We resolve all mutations whose mutation ID is less than or equal to\n    // the upTo mutation ID.\n    for (const [id, entry] of this.#outstandingMutations) {\n      if (entry.mutationID && entry.mutationID <= upTo) {\n        this.#settleMutation(id, entry, emptyObject);\n      } else {\n        break; // the map is in insertion order which is in mutation ID order\n      }\n    }\n  }\n\n  #processPushOk(success: PushOk): void {\n    for (const mutation of success.mutations) {\n      if ('error' in mutation.result) {\n        this.#processMutationError(\n          mutation.id.clientID,\n          mutation.id.id,\n          mutation.result,\n        );\n      } else {\n        this.#processMutationOk(\n          mutation.id.clientID,\n          mutation.id.id,\n          mutation.result,\n        );\n      }\n    }\n  }\n\n  #processMutationError(\n    clientID: string,\n    mid: number,\n    error: MutationError | Omit<PushError, 'mutationIDs'>,\n  ): void {\n    assert(\n      clientID === this.#clientID,\n      'received mutation for the wrong client',\n    );\n\n    // Each tab sends all mutations for the client group\n    // and the server responds back to the individual client that actually\n    // ran the mutation. This means that N clients can send the same\n    // mutation concurrently. If that happens, the promise for the mutation tracked\n    // by this class will try to be resolved N times.\n    // Every time after the first, the ephemeral ID will not be found.\n    //\n    // We also reject all outstanding mutations when the client is in a state\n    // that prevents mutations from being applied, such as offline or closed.\n    // In this case, the ephemeral ID will also not be found.\n    const ephemeralID = this.#ephemeralIDsByMutationID.get(mid);\n    if (!ephemeralID) {\n      this.#lc.debug?.(\n        'Mutation already resolved or rejected (e.g. due to disconnect); ignore late reject.',\n      );\n      return;\n    }\n\n    const entry = this.#outstandingMutations.get(ephemeralID);\n    assert(\n      entry && entry.mutationID === mid,\n      `outstanding mutation not found for mutation ID ${mid} and ephemeral ID ${ephemeralID}`,\n    );\n\n    if (error.error === 'alreadyProcessed') {\n      this.#settleMutation(ephemeralID, entry, emptyObject);\n      return;\n    }\n\n    this.#settleMutation(\n      ephemeralID,\n      entry,\n      error.error === 'app'\n        ? new ApplicationError(\n            error.message ?? `Unknown application error: ${error.error}`,\n            error.details ? {details: error.details} : undefined,\n          )\n        : new ProtocolError({\n            kind: ErrorKind.InvalidPush,\n            origin: ErrorOrigin.Server,\n            reason: ErrorReason.Internal,\n            message:\n              error.error === 'oooMutation'\n                ? 'Server reported an out-of-order mutation'\n                : `Unknown fallback error with mutation ID ${mid}: ${error.error}`,\n            details: getErrorDetails(error),\n          }),\n    );\n\n    // this is included for backwards compatibility with the per-mutation fatal error responses\n    if (error.error === 'oooMutation') {\n      this.#onFatalError(\n        new ProtocolError({\n          kind: ErrorKind.InvalidPush,\n          origin: ErrorOrigin.Server,\n          reason: ErrorReason.Internal,\n          message: 'Server reported an out-of-order mutation',\n          details: error.details,\n        }),\n      );\n    }\n  }\n\n  #processMutationOk(clientID: string, mid: number, result: MutationOk): void {\n    assert(\n      clientID === this.#clientID,\n      'received mutation for the wrong client',\n    );\n\n    // We reject all outstanding mutations when the client is in a state\n    // that prevents mutations from being applied, such as offline or closed.\n    // In this case, the ephemeral ID will not be found.\n    const ephemeralID = this.#ephemeralIDsByMutationID.get(mid);\n    if (!ephemeralID) {\n      this.#lc.debug?.(\n        'Mutation already resolved or rejected (e.g. due to disconnect); ignore late resolve.',\n      );\n      return;\n    }\n\n    const entry = this.#outstandingMutations.get(ephemeralID);\n    assert(\n      entry && entry.mutationID === mid,\n      `outstanding mutation not found for mutation ID ${mid} and ephemeral ID ${ephemeralID}`,\n    );\n    this.#settleMutation(ephemeralID, entry, result);\n  }\n\n  #settleMutation<Result extends MutationOk | ApplicationError | ZeroError>(\n    ephemeralID: EphemeralID,\n    entry: {\n      mutationID?: number | undefined;\n      resolver: Resolver<MutationSuccessType, MutationErrorType>;\n    },\n    result: Result,\n  ): void {\n    if (isApplicationError(result) || isZeroError(result)) {\n      // we reject here and catch in the mutator proxy\n      // the mutator proxy catches both client and server errors\n      entry.resolver.reject(result);\n    } else {\n      entry.resolver.resolve(successResultDetails);\n    }\n\n    this.#outstandingMutations.delete(ephemeralID);\n    if (entry.mutationID) {\n      this.#ephemeralIDsByMutationID.delete(entry.mutationID);\n    }\n  }\n\n  /**\n   * Be notified when all mutations have been included in the server snapshot.\n   *\n   * The query manager will not de-register queries from the server until there\n   * are no pending mutations.\n   *\n   * The reason is that a mutation may need to be rebased. We do not want\n   * data that was available the first time it was run to not be available\n   * on a rebase.\n   */\n  onAllMutationsApplied(listener: () => void): void {\n    this.#allMutationsAppliedListeners.add(listener);\n  }\n\n  #notifyAllMutationsAppliedListeners() {\n    for (const listener of this.#allMutationsAppliedListeners) {\n      listener();\n    }\n  }\n}\n"],"mappings":"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"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"mutator-proxy.js","names":["#lc","#connectionManager","#mutationTracker","#onConnectionStateChange","#mutationRejection","#makeZeroErrorResultDetails","#makeApplicationErrorResultDetails","#normalizeResultPromise"],"sources":["../../../../../zero-client/src/client/mutator-proxy.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport {unreachable} from '../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport type {ApplicationError} from '../../../zero-protocol/src/application-error.ts';\nimport {wrapWithApplicationError} from '../../../zero-protocol/src/application-error.ts';\nimport {ClientErrorKind} from './client-error-kind.ts';\nimport type {\n  ConnectionManager,\n  ConnectionManagerState,\n} from './connection-manager.ts';\nimport {ConnectionStatus} from './connection-status.ts';\nimport type {\n  MutatorResult,\n  MutatorResultErrorDetails,\n  MutatorResultSuccessDetails,\n} from './custom.ts';\nimport {isZeroError, type ZeroError} from './error.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\n\nconst successResultDetails = {\n  type: 'success',\n} as const satisfies MutatorResultSuccessDetails;\nconst successResult = () => successResultDetails;\n\nfunction getStateDescription(error: ZeroError): string {\n  switch (error.kind) {\n    case ClientErrorKind.Offline:\n      return 'offline';\n    case ClientErrorKind.ClientClosed:\n      return 'closed';\n    default:\n      return 'in error state';\n  }\n}\n\ntype CachedMutationRejection = {\n  readonly error: ZeroError;\n  readonly promise: Promise<MutatorResultErrorDetails>;\n};\n\nexport class MutatorProxy {\n  readonly #lc: LogContext;\n  readonly #connectionManager: ConnectionManager;\n  readonly #mutationTracker: MutationTracker;\n  #mutationRejection: CachedMutationRejection | undefined;\n\n  constructor(\n    lc: LogContext,\n    connectionManager: ConnectionManager,\n    mutationTracker: MutationTracker,\n  ) {\n    this.#lc = lc;\n    this.#connectionManager = connectionManager;\n    this.#mutationTracker = mutationTracker;\n\n    this.#connectionManager.subscribe(state =>\n      this.#onConnectionStateChange(state),\n    );\n    this.#onConnectionStateChange(connectionManager.state);\n  }\n\n  get mutationRejectionError(): ZeroError | undefined {\n    return this.#mutationRejection?.error;\n  }\n\n  /**\n   * Called when the connection state changes.\n   *\n   * If the connection state is disconnected, error, or closed, the\n   * mutation rejection error is set and all outstanding `.server` promises in\n   * the mutation tracker are rejected with the error.\n   */\n  #onConnectionStateChange(state: ConnectionManagerState) {\n    // we short circuit the rejection if the error is due to a missing cacheURL\n    // this allows local writes to continue\n    if (\n      state.name === ConnectionStatus.Disconnected &&\n      state.reason.kind === ClientErrorKind.NoSocketOrigin\n    ) {\n      this.#mutationRejection = undefined;\n      return;\n    }\n\n    switch (state.name) {\n      case ConnectionStatus.Disconnected:\n      case ConnectionStatus.Error:\n      case ConnectionStatus.Closed:\n        this.#mutationRejection = {\n          error: state.reason,\n          promise: Promise.resolve(\n            this.#makeZeroErrorResultDetails(state.reason),\n          ),\n        };\n        this.#mutationTracker.rejectAllOutstandingMutations(state.reason);\n        break;\n      case ConnectionStatus.Connected:\n      case ConnectionStatus.Connecting:\n      case ConnectionStatus.NeedsAuth:\n        this.#mutationRejection = undefined;\n        return;\n      default:\n        unreachable(state);\n    }\n  }\n\n  wrapCustomMutator<\n    F extends (...args: [] | [ReadonlyJSONValue]) => {\n      client: Promise<unknown>;\n      server: Promise<unknown>;\n    },\n  >(name: string, f: F): (...args: Parameters<F>) => MutatorResult {\n    return (...args) => {\n      if (this.#mutationRejection) {\n        const error = this.#mutationRejection.error;\n        this.#lc.warn?.(\n          `Mutation \"${name}\" rejected because Zero is ${getStateDescription(error)}. Details: ${error.message}. See also: https://zero.rocicorp.dev/docs/connection.`,\n        );\n        return {\n          client: this.#mutationRejection.promise,\n          server: this.#mutationRejection.promise,\n        } as const satisfies MutatorResult;\n      }\n\n      let result: {\n        client: Promise<unknown>;\n        server: Promise<unknown>;\n      };\n\n      const cachedMutationPromises: Partial<\n        Record<'client' | 'server', Promise<MutatorResultErrorDetails>>\n      > = {};\n\n      const wrapErrorFor =\n        (origin: 'client' | 'server') =>\n        (error: unknown): Promise<MutatorResultErrorDetails> => {\n          const cachedPromise = cachedMutationPromises[origin];\n          if (cachedPromise) {\n            return cachedPromise;\n          }\n\n          if (isZeroError(error)) {\n            this.#lc.error?.(`Mutator \"${name}\" error on ${origin}`, error);\n\n            const zeroErrorPromise = this.#makeZeroErrorResultDetails(error);\n            cachedMutationPromises[origin] = zeroErrorPromise;\n            return zeroErrorPromise;\n          }\n\n          const applicationError = wrapWithApplicationError(error);\n          this.#lc.error?.(\n            `Mutator \"${name}\" app error on ${origin}`,\n            applicationError,\n          );\n\n          const applicationErrorPromise =\n            this.#makeApplicationErrorResultDetails(applicationError);\n          cachedMutationPromises[origin] = applicationErrorPromise;\n          return applicationErrorPromise;\n        };\n\n      try {\n        result = f(...args);\n      } catch (error) {\n        const clientPromise = wrapErrorFor('client')(error);\n        const serverPromise = wrapErrorFor('server')(error);\n\n        return {\n          client: clientPromise,\n          server: serverPromise,\n        } as const satisfies MutatorResult;\n      }\n\n      const client = this.#normalizeResultPromise(\n        result.client,\n        wrapErrorFor('client'),\n      );\n      const server = this.#normalizeResultPromise(\n        result.server,\n        wrapErrorFor('server'),\n      );\n\n      return {\n        client,\n        server,\n      };\n    };\n  }\n\n  #normalizeResultPromise(\n    promise: Promise<unknown>,\n    wrapError: (error: unknown) => Promise<MutatorResultErrorDetails>,\n  ) {\n    return promise.then<MutatorResultSuccessDetails, MutatorResultErrorDetails>(\n      successResult,\n      wrapError,\n    );\n  }\n\n  #makeZeroErrorResultDetails(zeroError: ZeroError) {\n    return Promise.resolve({\n      type: 'error',\n      error: {\n        type: 'zero',\n        message: zeroError.message,\n      },\n    } as const satisfies MutatorResultErrorDetails);\n  }\n\n  #makeApplicationErrorResultDetails(applicationError: ApplicationError) {\n    return Promise.resolve({\n      type: 'error',\n      error: {\n        type: 'app',\n        message: applicationError.message,\n        details: applicationError.details,\n      },\n    } as const satisfies MutatorResultErrorDetails);\n  }\n}\n"],"mappings":";;;;;;AAmBA,IAAM,uBAAuB,EAC3B,MAAM,WACP;AACD,IAAM,sBAAsB;AAE5B,SAAS,oBAAoB,OAA0B;AACrD,SAAQ,MAAM,MAAd;EACE,KAAK,QACH,QAAO;EACT,KAAK,aACH,QAAO;EACT,QACE,QAAO;;;AASb,IAAa,eAAb,MAA0B;CACxB;CACA;CACA;CACA;CAEA,YACE,IACA,mBACA,iBACA;AACA,QAAA,KAAW;AACX,QAAA,oBAA0B;AAC1B,QAAA,kBAAwB;AAExB,QAAA,kBAAwB,WAAU,UAChC,MAAA,wBAA8B,MAAM,CACrC;AACD,QAAA,wBAA8B,kBAAkB,MAAM;;CAGxD,IAAI,yBAAgD;AAClD,SAAO,MAAA,mBAAyB;;;;;;;;;CAUlC,yBAAyB,OAA+B;AAGtD,MACE,MAAM,SAAS,kBACf,MAAM,OAAO,SAAS,kBACtB;AACA,SAAA,oBAA0B,KAAA;AAC1B;;AAGF,UAAQ,MAAM,MAAd;GACE,KAAK;GACL,KAAK;GACL,KAAK;AACH,UAAA,oBAA0B;KACxB,OAAO,MAAM;KACb,SAAS,QAAQ,QACf,MAAA,2BAAiC,MAAM,OAAO,CAC/C;KACF;AACD,UAAA,gBAAsB,8BAA8B,MAAM,OAAO;AACjE;GACF,KAAK;GACL,KAAK;GACL,KAAK;AACH,UAAA,oBAA0B,KAAA;AAC1B;GACF,QACE,aAAY,MAAM;;;CAIxB,kBAKE,MAAc,GAAiD;AAC/D,UAAQ,GAAG,SAAS;AAClB,OAAI,MAAA,mBAAyB;IAC3B,MAAM,QAAQ,MAAA,kBAAwB;AACtC,UAAA,GAAS,OACP,aAAa,KAAK,6BAA6B,oBAAoB,MAAM,CAAC,aAAa,MAAM,QAAQ,wDACtG;AACD,WAAO;KACL,QAAQ,MAAA,kBAAwB;KAChC,QAAQ,MAAA,kBAAwB;KACjC;;GAGH,IAAI;GAKJ,MAAM,yBAEF,EAAE;GAEN,MAAM,gBACH,YACA,UAAuD;IACtD,MAAM,gBAAgB,uBAAuB;AAC7C,QAAI,cACF,QAAO;AAGT,QAAI,YAAY,MAAM,EAAE;AACtB,WAAA,GAAS,QAAQ,YAAY,KAAK,aAAa,UAAU,MAAM;KAE/D,MAAM,mBAAmB,MAAA,2BAAiC,MAAM;AAChE,4BAAuB,UAAU;AACjC,YAAO;;IAGT,MAAM,mBAAmB,yBAAyB,MAAM;AACxD,UAAA,GAAS,QACP,YAAY,KAAK,iBAAiB,UAClC,iBACD;IAED,MAAM,0BACJ,MAAA,kCAAwC,iBAAiB;AAC3D,2BAAuB,UAAU;AACjC,WAAO;;AAGX,OAAI;AACF,aAAS,EAAE,GAAG,KAAK;YACZ,OAAO;AAId,WAAO;KACL,QAJoB,aAAa,SAAS,CAAC,MAAM;KAKjD,QAJoB,aAAa,SAAS,CAAC,MAAM;KAKlD;;AAYH,UAAO;IACL,QAVa,MAAA,uBACb,OAAO,QACP,aAAa,SAAS,CACvB;IAQC,QAPa,MAAA,uBACb,OAAO,QACP,aAAa,SAAS,CACvB;IAKA;;;CAIL,wBACE,SACA,WACA;AACA,SAAO,QAAQ,KACb,eACA,UACD;;CAGH,4BAA4B,WAAsB;AAChD,SAAO,QAAQ,QAAQ;GACrB,MAAM;GACN,OAAO;IACL,MAAM;IACN,SAAS,UAAU;IACpB;GACF,CAA8C;;CAGjD,mCAAmC,kBAAoC;AACrE,SAAO,QAAQ,QAAQ;GACrB,MAAM;GACN,OAAO;IACL,MAAM;IACN,SAAS,iBAAiB;IAC1B,SAAS,iBAAiB;IAC3B;GACF,CAA8C"}

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

@@ -1 +0,0 @@
-{"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,0BACD"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"query-manager.js","names":["#clientID","#clientToServer","#serverToClient","#send","#onFatalError","#queries","#recentQueriesMaxSize","#recentQueries","#gotQueries","#mutationTracker","#pendingQueryChanges","#queryChangeThrottleMs","#lc","#metrics","#queryMetrics","#slowMaterializeThreshold","#pendingRemovals","#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  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              this.#fireGotCallbacks(queryHash, true);\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   * 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  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(this.#gotQueries.has(queryId));\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  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 = this.#queryMetrics.get(lruQueryID);\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        assert(evictedMetrics, 'Expected evicted metrics 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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"}