@rocicorp/zero 0.25.0 → 0.26.0-canary.0

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

@@ -0,0 +1,87 @@
+import { zeroData } from "../../../replicache/src/transactions.js";
+import { assert } from "../../../shared/src/asserts.js";
+import { must } from "../../../shared/src/must.js";
+import { emptyFunction } from "../../../shared/src/sentinels.js";
+import { makeTransactionMutate } from "../../../zql/src/mutate/crud.js";
+import { createRunnableBuilder } from "../../../zql/src/query/create-builder.js";
+import "../../../zero-protocol/src/ast.js";
+import { ZeroContext } from "./context.js";
+import { makeCRUDExecutor } from "./crud.js";
+class TransactionImpl {
+  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;
+    const executor = makeCRUDExecutor(repTx, schema, ivmBranch);
+    this.mutate = makeTransactionMutate(schema, executor);
+    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) {
+  const txData = must(
+    repTx[zeroData],
+    "zero was not set on replicache internal options!"
+  );
+  return txData;
+}
+function makeReplicacheMutator(lc, mutator, schema, context) {
+  return async (repTx, args) => {
+    const tx = new TransactionImpl(lc, repTx, schema);
+    await mutator(tx, 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
+  );
+}
+export {
+  TransactionImpl,
+  getZeroTxData,
+  makeReplicacheMutator
+};
+//# sourceMappingURL=custom.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"custom.js","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<TSchema extends Schema = DefaultSchema>\n  implements ClientTransaction<TSchema>\n{\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"],"names":[],"mappings":";;;;;;;;;AAoHO,MAAM,gBAEb;AAAA,EACW,WAAW;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAIA;AAAA,EAEA;AAAA,EACA;AAAA,EAET,YAAY,IAAgB,OAAyB,QAAiB;AACpE,SAAK,MAAM,WAAW,aAAa,MAAM,WAAW,QAAQ;AAC5D,UAAM,SAAS,cAAc,KAAK;AAClC,UAAM,YAAY,OAAO;AAEzB,SAAK,SAAS;AAEd,UAAM,WAAW,iBAAiB,OAAO,QAAQ,SAAS;AAC1D,SAAK,SAAS,sBAAsB,QAAQ,QAAQ;AAEpD,UAAM,cAAc;AAAA,MAClB;AAAA,MACA,OAAO;AAAA,IAAA;AAGT,SAAK,QAAQ,sBAAsB,aAAa,MAAM;AAEtD,SAAK,eAAe;AAAA,EACtB;AAAA,EAEA,IAAI,WAAqB;AACvB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAEA,IAAI,aAAqB;AACvB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAEA,IAAI,SAAkC;AACpC,WAAO,KAAK,OAAO,WAAW,YAAY,eAAe;AAAA,EAC3D;AAAA,EAEA,IAAI,QAA4B;AAC9B,WAAQ,KAAK,OAAgC,QAAQ,GAAG;AAAA,EAC1D;AAAA,EAEA,IACE,OACA,SACiC;AACjC,WAAO,KAAK,aAAa,IAAI,OAAO,OAAO;AAAA,EAC7C;AACF;AAEO,SAAS,cAAc,OAAqC;AACjE,QAAM,SAAS;AAAA,IACZ,MAA+B,QAAQ;AAAA,IACxC;AAAA,EAAA;AAEF,SAAO;AACT;AAEO,SAAS,sBAKd,IACA,SACA,QACA,SACqE;AACrE,SAAO,OACL,OACA,SACkB;AAClB,UAAM,KAAK,IAAI,gBAAgB,IAAI,OAAO,MAAM;AAChD,UAAM,QAAQ,IAAI,MAAM,OAAO;AAAA,EACjC;AACF;AAEA,SAAS,sBAAsB,SAAuC;AAEpE;AAAA,IACE,SAAS,SAAS;AAAA,IAClB;AAAA,EAAA;AAEJ;AAEA,SAAS,eAAe,IAAgB,WAA4B;AAClE,SAAO,IAAI;AAAA,IACT;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA,sBAAoB,iBAAA;AAAA,IACpB;AAAA,IACA;AAAA,EAAA;AAEJ;"}

package/out/zero-client/src/client/delete-clients-manager.d.ts

@@ -1,8 +1,8 @@
+import type { LogContext } from '@rocicorp/logger';
 import type { Store } from '../../../replicache/src/dag/store.ts';
 import { type DeletedClients } from '../../../replicache/src/deleted-clients.ts';
 import type { ClientGroupID } from '../../../replicache/src/sync/ids.ts';
 import type { DeleteClientsBody, DeleteClientsMessage } from '../../../zero-protocol/src/delete-clients.ts';
-import type { ZeroLogContext } from './zero-log-context.ts';
 /**
  * Replicache will tell us when it deletes clients from the persistent storage
  * due to GC. When this happens we tell the server about the deleted clients.
@@ -14,7 +14,7 @@ import type { ZeroLogContext } from './zero-log-context.ts';
  */
 export declare class DeleteClientsManager {
     #private;
-    constructor(send: (msg: DeleteClientsMessage) => void, dagStore: Store, lc: ZeroLogContext, clientGroupID: Promise<ClientGroupID>);
+    constructor(send: (msg: DeleteClientsMessage) => void, dagStore: Store, lc: LogContext, clientGroupID: Promise<ClientGroupID>, clientID: string);
     /**
      * This gets called by Replicache when it deletes clients from the persistent
      * storage.

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

@@ -1 +1 @@
-{"version":3,"file":"delete-clients-manager.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/delete-clients-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,sCAAsC,CAAC;AAChE,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,qCAAqC,CAAC;AAMvE,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;;gBAO7B,IAAI,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,IAAI,EACzC,QAAQ,EAAE,KAAK,EACf,EAAE,EAAE,cAAc,EAClB,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC;IAQvC;;;OAGG;IACG,gBAAgB,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAarE;;;OAGG;IACG,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBjD;;;OAGG;IACH,sBAAsB,CAAC,cAAc,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAalE,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC;CAOnD"}
+{"version":3,"file":"delete-clients-manager.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/delete-clients-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,sCAAsC,CAAC;AAChE,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,qCAAqC,CAAC;AAOvE,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,8CAA8C,CAAC;AAiBtD;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;;gBAQ7B,IAAI,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,IAAI,EACzC,QAAQ,EAAE,KAAK,EACf,EAAE,EAAE,UAAU,EACd,aAAa,EAAE,OAAO,CAAC,aAAa,CAAC,EACrC,QAAQ,EAAE,MAAM;IASlB;;;OAGG;IACG,gBAAgB,CAAC,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrE;;;OAGG;IACG,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBjD;;;OAGG;IACH,sBAAsB,CAAC,cAAc,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAalE,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC;CAanD"}

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

@@ -0,0 +1,98 @@
+import { getDeletedClients, confirmDeletedClients } from "../../../replicache/src/deleted-clients.js";
+import { withRead, withWrite } from "../../../replicache/src/with-transactions.js";
+import { assert } from "../../../shared/src/asserts.js";
+import { promiseVoid } from "../../../shared/src/resolved-promises.js";
+function filterAndAssert(deletedClients, clientGroupID, clientID, caller) {
+  const clientIDs = deletedClients.filter((dc) => dc.clientGroupID === clientGroupID).map((dc) => dc.clientID);
+  for (const cid of clientIDs) {
+    assert(cid !== clientID, `cannot delete self in ${caller}`);
+  }
+  return clientIDs;
+}
+class DeleteClientsManager {
+  #send;
+  #lc;
+  #dagStore;
+  #clientGroupID;
+  #clientID;
+  constructor(send, dagStore, lc, clientGroupID, clientID) {
+    this.#send = send;
+    this.#dagStore = dagStore;
+    this.#lc = lc;
+    this.#clientGroupID = clientGroupID;
+    this.#clientID = clientID;
+  }
+  /**
+   * This gets called by Replicache when it deletes clients from the persistent
+   * storage.
+   */
+  async onClientsDeleted(deletedClients) {
+    this.#lc.debug?.("DeletedClientsManager, send:", deletedClients);
+    const clientGroupID = await this.#clientGroupID;
+    const clientIDs = filterAndAssert(
+      deletedClients,
+      clientGroupID,
+      this.#clientID,
+      "onClientsDeleted"
+    );
+    this.#send([
+      "deleteClients",
+      {
+        clientIDs
+      }
+    ]);
+  }
+  /**
+   * Zero calls this after it connects to ensure that the server knows about all
+   * the clients that might have been deleted locally since the last connection.
+   */
+  async sendDeletedClientsToServer() {
+    const clientGroupID = await this.#clientGroupID;
+    const deleted = await withRead(
+      this.#dagStore,
+      (dagRead) => getDeletedClients(dagRead)
+    );
+    const clientIDs = filterAndAssert(
+      deleted,
+      clientGroupID,
+      this.#clientID,
+      "sendDeletedClientsToServer"
+    );
+    if (clientIDs.length > 0) {
+      this.#send(["deleteClients", { clientIDs }]);
+      this.#lc.debug?.("DeletedClientsManager, send:", deleted);
+    }
+  }
+  /**
+   * This is called as a response to the server telling us which clients it
+   * actually deleted.
+   */
+  clientsDeletedOnServer(deletedClients) {
+    const { clientIDs = [], clientGroupIDs = [] } = deletedClients;
+    if (clientIDs.length > 0 || clientGroupIDs.length > 0) {
+      return withWrite(this.#dagStore, async (dagWrite) => {
+        this.#lc.debug?.("clientsDeletedOnServer:", clientIDs, clientGroupIDs);
+        await confirmDeletedClients(dagWrite, clientIDs, clientGroupIDs);
+      });
+    }
+    return promiseVoid;
+  }
+  async getDeletedClients() {
+    const deletedClients = await withRead(
+      this.#dagStore,
+      (read) => getDeletedClients(read)
+    );
+    const clientGroupID = await this.#clientGroupID;
+    filterAndAssert(
+      deletedClients,
+      clientGroupID,
+      this.#clientID,
+      "getDeletedClients"
+    );
+    return deletedClients.filter((d) => d.clientGroupID === clientGroupID);
+  }
+}
+export {
+  DeleteClientsManager
+};
+//# sourceMappingURL=delete-clients-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-clients-manager.js","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"],"names":[],"mappings":";;;;AAmBA,SAAS,gBACP,gBACA,eACA,UACA,QACU;AACV,QAAM,YAAY,eACf,OAAO,CAAA,OAAM,GAAG,kBAAkB,aAAa,EAC/C,IAAI,CAAA,OAAM,GAAG,QAAQ;AACxB,aAAW,OAAO,WAAW;AAC3B,WAAO,QAAQ,UAAU,yBAAyB,MAAM,EAAE;AAAA,EAC5D;AACA,SAAO;AACT;AAWO,MAAM,qBAAqB;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,YACE,MACA,UACA,IACA,eACA,UACA;AACA,SAAK,QAAQ;AACb,SAAK,YAAY;AACjB,SAAK,MAAM;AACX,SAAK,iBAAiB;AACtB,SAAK,YAAY;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,iBAAiB,gBAA+C;AACpE,SAAK,IAAI,QAAQ,gCAAgC,cAAc;AAC/D,UAAM,gBAAgB,MAAM,KAAK;AACjC,UAAM,YAAY;AAAA,MAChB;AAAA,MACA;AAAA,MACA,KAAK;AAAA,MACL;AAAA,IAAA;AAEF,SAAK,MAAM;AAAA,MACT;AAAA,MACA;AAAA,QACE;AAAA,MAAA;AAAA,IACF,CACD;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,6BAA4C;AAChD,UAAM,gBAAgB,MAAM,KAAK;AACjC,UAAM,UAAU,MAAM;AAAA,MAAS,KAAK;AAAA,MAAW,CAAA,YAC7C,kBAAkB,OAAO;AAAA,IAAA;AAG3B,UAAM,YAAY;AAAA,MAChB;AAAA,MACA;AAAA,MACA,KAAK;AAAA,MACL;AAAA,IAAA;AAGF,QAAI,UAAU,SAAS,GAAG;AACxB,WAAK,MAAM,CAAC,iBAAiB,EAAC,UAAA,CAAU,CAAC;AACzC,WAAK,IAAI,QAAQ,gCAAgC,OAAO;AAAA,IAC1D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,uBAAuB,gBAAkD;AACvE,UAAM,EAAC,YAAY,CAAA,GAAI,iBAAiB,CAAA,MAAM;AAC9C,QAAI,UAAU,SAAS,KAAK,eAAe,SAAS,GAAG;AAGrD,aAAO,UAAU,KAAK,WAAW,OAAM,aAAY;AACjD,aAAK,IAAI,QAAQ,2BAA2B,WAAW,cAAc;AACrE,cAAM,sBAAsB,UAAU,WAAW,cAAc;AAAA,MACjE,CAAC;AAAA,IACH;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,oBAA6C;AACjD,UAAM,iBAAiB,MAAM;AAAA,MAAS,KAAK;AAAA,MAAW,CAAA,SACpD,kBAAkB,IAAI;AAAA,IAAA;AAExB,UAAM,gBAAgB,MAAM,KAAK;AACjC;AAAA,MACE;AAAA,MACA;AAAA,MACA,KAAK;AAAA,MACL;AAAA,IAAA;AAEF,WAAO,eAAe,OAAO,CAAA,MAAK,EAAE,kBAAkB,aAAa;AAAA,EACrE;AACF;"}

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

@@ -0,0 +1,18 @@
+const IPV4_ADDRESS_REGEX = /^(?:(?: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]?)$/;
+const IPV6_ADDRESS_HOSTNAME_REGEX = /^\[[a-fA-F0-9:]*:[a-fA-F0-9:]*\]$/;
+const IP_ADDRESS_HOSTNAME_REGEX = new RegExp(
+  `(${IPV4_ADDRESS_REGEX.source}|${IPV6_ADDRESS_HOSTNAME_REGEX.source})`
+);
+function shouldEnableAnalytics(server, enableAnalytics = true) {
+  if (!enableAnalytics) {
+    return false;
+  }
+  const serverURL = server === null ? null : new URL(server);
+  const socketHostname = serverURL?.hostname;
+  return server !== null && socketHostname !== void 0 && socketHostname !== "localhost" && !IP_ADDRESS_HOSTNAME_REGEX.test(socketHostname);
+}
+export {
+  IP_ADDRESS_HOSTNAME_REGEX,
+  shouldEnableAnalytics
+};
+//# sourceMappingURL=enable-analytics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enable-analytics.js","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"],"names":[],"mappings":"AACA,MAAM,qBACJ;AAGF,MAAM,8BAA8B;AAE7B,MAAM,4BAA4B,IAAI;AAAA,EAC3C,IAAI,mBAAmB,MAAM,IAAI,4BAA4B,MAAM;AACrE;AAEO,SAAS,sBACd,QACA,kBAAkB,MACT;AACT,MAAI,CAAC,iBAAiB;AACpB,WAAO;AAAA,EACT;AACA,QAAM,YAAY,WAAW,OAAO,OAAO,IAAI,IAAI,MAAM;AACzD,QAAM,iBAAiB,WAAW;AAIlC,SACE,WAAW,QACX,mBAAmB,UACnB,mBAAmB,eACnB,CAAC,0BAA0B,KAAK,cAAc;AAElD;"}

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

@@ -2,13 +2,20 @@ import type { Expand } from '../../../shared/src/expand.ts';
 import { ErrorKind } from '../../../zero-protocol/src/error-kind.ts';
 import { ErrorOrigin } from '../../../zero-protocol/src/error-origin.ts';
 import { ErrorReason } from '../../../zero-protocol/src/error-reason.ts';
-import { type BackoffBody, type ErrorBody, ProtocolError, type PushFailedBody, type TransformFailedBody } from '../../../zero-protocol/src/error.ts';
+import type { ProtocolError } from '../../../zero-protocol/src/error.ts';
+import { type BackoffBody, type ErrorBody, type PushFailedBody, type TransformFailedBody } from '../../../zero-protocol/src/error.ts';
 import { ClientErrorKind } from './client-error-kind.ts';
 import { ConnectionStatus } from './connection-status.ts';
-export type ZeroError = ProtocolError<ErrorBody> | ClientError;
-export type ZeroErrorBody = Expand<ErrorBody | ClientErrorBody>;
-export type ZeroErrorKind = Expand<ErrorKind | ClientErrorKind>;
 export type AuthError = ProtocolError<NeedsAuthReason>;
+export type ClientErrorBody = {
+    kind: ClientErrorKind;
+    origin: typeof ErrorOrigin.Client;
+    message: string;
+};
+export type ClosedError = ClientError<{
+    kind: ClientErrorKind.ClientClosed;
+    message: string;
+}>;
 export type NeedsAuthReason = Expand<(ErrorBody & {
     kind: ErrorKind.AuthInvalidated | ErrorKind.Unauthorized;
 }) | (Extract<PushFailedBody, {
@@ -20,13 +27,22 @@ export type NeedsAuthReason = Expand<(ErrorBody & {
 }> & {
     status: 401 | 403;
 })>;
-export type ClientErrorBody = {
-    kind: ClientErrorKind;
-    origin: typeof ErrorOrigin.Client;
+export type OfflineError = ClientError<{
+    kind: ClientErrorKind.Offline;
     message: string;
-};
+}>;
+export type NoSocketOriginError = ClientError<{
+    kind: ClientErrorKind.NoSocketOrigin;
+    message: string;
+}>;
+export type DisconnectedReason = OfflineError | NoSocketOriginError;
+export type ServerError = ProtocolError<ErrorBody>;
+export type ZeroError = ServerError | ClientError;
+export type ZeroErrorBody = Expand<ErrorBody | ClientErrorBody>;
+export type ZeroErrorDetails = Expand<Omit<ZeroErrorBody, 'message'>>;
+export type ZeroErrorKind = Expand<ErrorKind | ClientErrorKind>;
 /**
- * Represents an error encountered by the client.
+ * Represents an error encountered by the Zero client.
  */
 export declare class ClientError<const T extends Omit<ClientErrorBody, 'origin'> = Omit<ClientErrorBody, 'origin'>> extends Error {
     readonly errorBody: {
@@ -35,10 +51,12 @@ export declare class ClientError<const T extends Omit<ClientErrorBody, 'origin'>
     constructor(errorBody: T, options?: ErrorOptions);
     get kind(): T['kind'];
 }
-export declare function isServerError(ex: unknown): ex is ProtocolError<ErrorBody>;
+export declare function isZeroError(ex: unknown): ex is ZeroError;
+export declare function isClientError(ex: unknown): ex is ClientError<ClientErrorBody>;
+export declare function isServerError(ex: unknown): ex is ServerError;
+export declare function isOfflineError(ex: unknown): ex is OfflineError;
 export declare function isAuthError(ex: unknown): ex is AuthError;
 export declare function getBackoffParams(error: ZeroError): BackoffBody | undefined;
-export declare function isClientError(ex: unknown): ex is ClientError<ClientErrorBody>;
 export declare const NO_STATUS_TRANSITION = "NO_STATUS_TRANSITION";
 export type ErrorConnectionTransition = {
     status: typeof NO_STATUS_TRANSITION;
@@ -51,7 +69,7 @@ export type ErrorConnectionTransition = {
     reason: ZeroError;
 } | {
     status: ConnectionStatus.Disconnected;
-    reason: ZeroError;
+    reason: DisconnectedReason;
 } | {
     status: ConnectionStatus.Closed;
     reason: ZeroError;

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

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

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

@@ -0,0 +1,148 @@
+import { unreachable } from "../../../shared/src/asserts.js";
+import { getErrorMessage } from "../../../shared/src/error.js";
+import { MutationFailed, MutationRateLimited, Unauthorized, AuthInvalidated, ServerOverloaded, Rehome, Rebalance, TransformFailed, PushFailed, Internal as Internal$1, SchemaVersionNotSupported, VersionNotSupported, InvalidPush, InvalidMessage as InvalidMessage$1, InvalidConnectionRequestClientDeleted, InvalidConnectionRequestLastMutationID, InvalidConnectionRequestBaseCookie, InvalidConnectionRequest, ClientNotFound } from "../../../zero-protocol/src/error-kind-enum.js";
+import { Client, Server, ZeroCache } from "../../../zero-protocol/src/error-origin-enum.js";
+import { HTTP } from "../../../zero-protocol/src/error-reason-enum.js";
+import { isProtocolError } from "../../../zero-protocol/src/error.js";
+import { ClientClosed, NoSocketOrigin, Offline, UserDisconnect, InvalidMessage, Internal, UnexpectedBaseCookie, Hidden, PullTimeout, PingTimeout, ConnectTimeout, CleanClose, AbruptClose } from "./client-error-kind-enum.js";
+import { NeedsAuth, Closed, Disconnected, Error as Error$1 } from "./connection-status-enum.js";
+class ClientError extends Error {
+  errorBody;
+  constructor(errorBody, options) {
+    super(errorBody.message, options);
+    this.name = "ClientError";
+    this.errorBody = { ...errorBody, origin: Client };
+  }
+  get kind() {
+    return this.errorBody.kind;
+  }
+}
+function isZeroError(ex) {
+  return isClientError(ex) || isServerError(ex);
+}
+function isClientError(ex) {
+  return ex instanceof ClientError && ex.errorBody.origin === Client;
+}
+function isServerError(ex) {
+  return isProtocolError(ex) && (ex.errorBody.origin === Server || ex.errorBody.origin === ZeroCache);
+}
+function isAuthError(ex) {
+  if (isServerError(ex)) {
+    if (ex.kind === AuthInvalidated || ex.kind === Unauthorized) {
+      return true;
+    }
+    if ((ex.errorBody.kind === PushFailed || ex.errorBody.kind === TransformFailed) && ex.errorBody.reason === HTTP && (ex.errorBody.status === 401 || ex.errorBody.status === 403)) {
+      return true;
+    }
+  }
+  return false;
+}
+function getBackoffParams(error) {
+  if (isServerError(error)) {
+    switch (error.errorBody.kind) {
+      case Rebalance:
+      case Rehome:
+      case ServerOverloaded:
+        return error.errorBody;
+    }
+  }
+  return void 0;
+}
+const NO_STATUS_TRANSITION = "NO_STATUS_TRANSITION";
+function getErrorConnectionTransition(ex) {
+  if (isAuthError(ex)) {
+    return {
+      status: NeedsAuth,
+      reason: ex
+    };
+  }
+  if (isClientError(ex)) {
+    switch (ex.kind) {
+      // Connecting errors that should continue in the current state
+      case AbruptClose:
+      case CleanClose:
+      case ConnectTimeout:
+      case PingTimeout:
+      case PullTimeout:
+      case Hidden:
+        return { status: NO_STATUS_TRANSITION, reason: ex };
+      // Fatal errors that should transition to error state
+      case UnexpectedBaseCookie:
+      case Internal:
+      case InvalidMessage:
+      case UserDisconnect:
+        return { status: Error$1, reason: ex };
+      // Disconnected error (this should already result in a disconnected state)
+      case Offline:
+      case NoSocketOrigin:
+        return {
+          status: Disconnected,
+          reason: ex
+        };
+      // Closed error (this should already result in a closed state)
+      case ClientClosed:
+        return { status: Closed, reason: ex };
+      default:
+        unreachable(ex.kind);
+    }
+  }
+  if (isServerError(ex)) {
+    switch (ex.kind) {
+      // Errors that should transition to error state
+      case ClientNotFound:
+      case InvalidConnectionRequest:
+      case InvalidConnectionRequestBaseCookie:
+      case InvalidConnectionRequestLastMutationID:
+      case InvalidConnectionRequestClientDeleted:
+      case InvalidMessage$1:
+      case InvalidPush:
+      case VersionNotSupported:
+      case SchemaVersionNotSupported:
+      case Internal$1:
+      // PushFailed and TransformFailed can be auth errors (401/403)
+      // or other errors - handle non-auth cases here
+      case PushFailed:
+      case TransformFailed:
+        return { status: Error$1, reason: ex };
+      // Errors that should continue with backoff/retry
+      case Rebalance:
+      case Rehome:
+      case ServerOverloaded:
+        return { status: NO_STATUS_TRANSITION, reason: ex };
+      // Auth errors are handled above by isAuthError check
+      case AuthInvalidated:
+      case Unauthorized:
+        return {
+          status: NeedsAuth,
+          reason: ex
+        };
+      // Mutation-specific errors don't affect connection state
+      case MutationRateLimited:
+      case MutationFailed:
+        return { status: NO_STATUS_TRANSITION, reason: ex };
+      default:
+        unreachable(ex.kind);
+    }
+  }
+  return {
+    status: Error$1,
+    reason: new ClientError(
+      {
+        kind: Internal,
+        message: "Unexpected internal error: " + getErrorMessage(ex)
+      },
+      { cause: ex }
+    )
+  };
+}
+export {
+  ClientError,
+  NO_STATUS_TRANSITION,
+  getBackoffParams,
+  getErrorConnectionTransition,
+  isAuthError,
+  isClientError,
+  isServerError,
+  isZeroError
+};
+//# sourceMappingURL=error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","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 DisconnectedReason = OfflineError | NoSocketOriginError;\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.Hidden:\n        return {status: NO_STATUS_TRANSITION, reason: ex} as const;\n\n      // Fatal errors that should transition to error state\n      case ClientErrorKind.UnexpectedBaseCookie:\n      case ClientErrorKind.Internal:\n      case ClientErrorKind.InvalidMessage:\n      case ClientErrorKind.UserDisconnect:\n        return {status: ConnectionStatus.Error, reason: ex} as const;\n\n      // Disconnected error (this should already result in a disconnected state)\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"],"names":["ErrorOrigin.Client","ErrorOrigin.Server","ErrorOrigin.ZeroCache","ErrorKind.AuthInvalidated","ErrorKind.Unauthorized","ErrorKind.PushFailed","ErrorKind.TransformFailed","ErrorReason.HTTP","ErrorKind.Rebalance","ErrorKind.Rehome","ErrorKind.ServerOverloaded","ConnectionStatus.NeedsAuth","ClientErrorKind.AbruptClose","ClientErrorKind.CleanClose","ClientErrorKind.ConnectTimeout","ClientErrorKind.PingTimeout","ClientErrorKind.PullTimeout","ClientErrorKind.Hidden","ClientErrorKind.UnexpectedBaseCookie","ClientErrorKind.Internal","ClientErrorKind.InvalidMessage","ClientErrorKind.UserDisconnect","ConnectionStatus.Error","ClientErrorKind.Offline","ClientErrorKind.NoSocketOrigin","ConnectionStatus.Disconnected","ClientErrorKind.ClientClosed","ConnectionStatus.Closed","ErrorKind.ClientNotFound","ErrorKind.InvalidConnectionRequest","ErrorKind.InvalidConnectionRequestBaseCookie","ErrorKind.InvalidConnectionRequestLastMutationID","ErrorKind.InvalidConnectionRequestClientDeleted","ErrorKind.InvalidMessage","ErrorKind.InvalidPush","ErrorKind.VersionNotSupported","ErrorKind.SchemaVersionNotSupported","ErrorKind.Internal","ErrorKind.MutationRateLimited","ErrorKind.MutationFailed"],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+function toWSString(url) {
+  return "ws" + url.slice(4);
+}
+function appendPath(url, toAppend) {
+  return url + (url.endsWith("/") ? toAppend.substring(1) : toAppend);
+}
+export {
+  appendPath,
+  toWSString
+};
+//# sourceMappingURL=http-string.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-string.js","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\nexport function assertHTTPString(url: string): asserts url is HTTPString {\n  assert(/^https?:\\/\\//.test(url));\n}\n\nexport function assertWSString(url: string): asserts url is WSString {\n  assert(/^wss?:\\/\\//.test(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"],"names":[],"mappings":"AAMO,SAAS,WAAW,KAA2B;AACpD,SAAQ,OAAO,IAAI,MAAM,CAAC;AAC5B;AAcO,SAAS,WACd,KACA,UACG;AACH,SAAQ,OAAO,IAAI,SAAS,GAAG,IAAI,SAAS,UAAU,CAAC,IAAI;AAC7D;"}

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

@@ -0,0 +1,27 @@
+class ClientGroup {
+  #delegate;
+  id;
+  constructor(delegate, clientGroupID) {
+    this.#delegate = delegate;
+    this.id = clientGroupID;
+  }
+  async clients() {
+    return (await this.#delegate.lazy).clientGroupClients(
+      this.#delegate,
+      this.id
+    );
+  }
+  async clientsWithQueries() {
+    return (await this.#delegate.lazy).clientGroupClientsWithQueries(
+      this.#delegate,
+      this.id
+    );
+  }
+  async queries() {
+    return (await this.#delegate.lazy).clientGroupQueries(this.#delegate);
+  }
+}
+export {
+  ClientGroup
+};
+//# sourceMappingURL=client-group.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client-group.js","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"],"names":[],"mappings":"AAIO,MAAM,YAAY;AAAA,EACd;AAAA,EACA;AAAA,EAET,YACE,UACA,eACA;AACA,SAAK,YAAY;AACjB,SAAK,KAAK;AAAA,EACZ;AAAA,EAEA,MAAM,UAA6B;AACjC,YAAQ,MAAM,KAAK,UAAU,MAAM;AAAA,MACjC,KAAK;AAAA,MACL,KAAK;AAAA,IAAA;AAAA,EAET;AAAA,EAEA,MAAM,qBAAwC;AAC5C,YAAQ,MAAM,KAAK,UAAU,MAAM;AAAA,MACjC,KAAK;AAAA,MACL,KAAK;AAAA,IAAA;AAAA,EAET;AAAA,EAEA,MAAM,UAA4B;AAChC,YAAQ,MAAM,KAAK,UAAU,MAAM,mBAAmB,KAAK,SAAS;AAAA,EACtE;AACF;"}

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

@@ -0,0 +1,28 @@
+import { ClientGroup } from "./client-group.js";
+class Client {
+  #delegate;
+  id;
+  clientGroup;
+  constructor(delegate, clientID, clientGroupID) {
+    this.#delegate = delegate;
+    this.id = clientID;
+    this.clientGroup = new ClientGroup(this.#delegate, clientGroupID);
+  }
+  async queries() {
+    return (await this.#delegate.lazy).clientQueries(this.#delegate, this.id);
+  }
+  async map() {
+    return (await this.#delegate.lazy).clientMap(this.#delegate, this.id);
+  }
+  async rows(tableName) {
+    return (await this.#delegate.lazy).clientRows(
+      this.#delegate,
+      this.id,
+      tableName
+    );
+  }
+}
+export {
+  Client
+};
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","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"],"names":[],"mappings":";AAMO,MAAM,OAAO;AAAA,EACT;AAAA,EACA;AAAA,EACA;AAAA,EAET,YACE,UACA,UACA,eACA;AACA,SAAK,YAAY;AACjB,SAAK,KAAK;AAEV,SAAK,cAAc,IAAI,YAAY,KAAK,WAAW,aAAa;AAAA,EAClE;AAAA,EAEA,MAAM,UAA4B;AAChC,YAAQ,MAAM,KAAK,UAAU,MAAM,cAAc,KAAK,WAAW,KAAK,EAAE;AAAA,EAC1E;AAAA,EAEA,MAAM,MAA+C;AACnD,YAAQ,MAAM,KAAK,UAAU,MAAM,UAAU,KAAK,WAAW,KAAK,EAAE;AAAA,EACtE;AAAA,EAEA,MAAM,KAAK,WAAmC;AAC5C,YAAQ,MAAM,KAAK,UAAU,MAAM;AAAA,MACjC,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,IAAA;AAAA,EAEJ;AACF;"}

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

@@ -1 +1 @@
-{"version":3,"file":"html-dialog-prompt.d.ts","sourceRoot":"","sources":["../../../../../../zero-client/src/client/inspector/html-dialog-prompt.ts"],"names":[],"mappings":"AA0BA;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgFxB"}
+{"version":3,"file":"html-dialog-prompt.d.ts","sourceRoot":"","sources":["../../../../../../zero-client/src/client/inspector/html-dialog-prompt.ts"],"names":[],"mappings":"AA0BA;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+ExB"}