@rocicorp/zero 0.25.0-canary.0 → 0.25.0-canary.2

package/out/zero-cache/src/workers/syncer.js

@@ -16,6 +16,25 @@ import { Connection, sendError } from "./connection.js";
 import { createNotifierFrom, subscribeTo } from "./replicator.js";
 import { SyncerWsMessageHandler } from "./syncer-ws-message-handler.js";
 import { recordConnectionSuccess, recordConnectionAttempted, setActiveClientGroupsGetter, } from "../server/anonymous-otel-start.js";
+import { ErrorOrigin } from "../../../zero-protocol/src/error-origin.js";
+function getWebSocketServerOptions(config) {
+    const options = {
+        noServer: true,
+    };
+    if (config.websocketCompression) {
+        options.perMessageDeflate = true;
+        if (config.websocketCompressionOptions) {
+            try {
+                const compressionOptions = JSON.parse(config.websocketCompressionOptions);
+                options.perMessageDeflate = compressionOptions;
+            }
+            catch (e) {
+                throw new Error(`Failed to parse ZERO_WEBSOCKET_COMPRESSION_OPTIONS: ${String(e)}. Expected valid JSON.`);
+            }
+        }
+    }
+    return options;
+}
 /**
  * The Syncer worker receives websocket handoffs for "/sync" connections
  * from the Dispatcher in the main thread, and creates websocket
@@ -48,7 +67,7 @@ export class Syncer {
             this.#pushers = new ServiceRunner(lc, pusherFactory, p => p.hasRefs());
         }
         this.#parent = parent;
-        this.#wss = new WebSocketServer({ noServer: true });
+        this.#wss = new WebSocketServer(getWebSocketServerOptions(config));
         installWebSocketReceiver(lc, this.#wss, this.#createConnection, this.#parent);
         setActiveClientGroupsGetter(() => this.#viewSyncers.size);
     }
@@ -86,6 +105,7 @@ export class Syncer {
                     sendError(this.#lc, ws, {
                         kind: ErrorKind.AuthInvalidated,
                         message: `Failed to decode auth token: ${String(e)}`,
+                        origin: ErrorOrigin.ZeroCache,
                     }, e);
                     ws.close(3000, 'Failed to decode JWT');
                     return;
@@ -105,9 +125,7 @@ export class Syncer {
         pusher?.ref();
         let connection;
         try {
-            connection = new Connection(this.#lc, params, ws, new SyncerWsMessageHandler(this.#lc, params, 
-            // auth is an empty string if the user is not authenticated
-            auth
+            connection = new Connection(this.#lc, params, ws, new SyncerWsMessageHandler(this.#lc, params, auth
                 ? {
                     raw: auth,
                     decoded: decodedToken ?? {},

package/out/zero-cache/src/workers/syncer.js.map

@@ -1 +1 @@
-{"version":3,"file":"syncer.js","sourceRoot":"","sources":["../../../../../zero-cache/src/workers/syncer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"syncer.js","sourceRoot":"","sources":["../../../../../zero-cache/src/workers/syncer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAC,QAAQ,EAAC,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAiB,MAAM,MAAM,CAAC;AACrC,OAAO,EAAC,GAAG,EAAC,MAAM,cAAc,CAAC;AACjC,OAAO,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAC,eAAe,EAAqC,MAAM,IAAI,CAAC;AACvE,OAAO,EAAC,WAAW,EAAC,MAAM,0CAA0C,CAAC;AACrE,OAAO,EAAC,SAAS,EAAC,MAAM,0CAA0C,CAAC;AACnE,OAAO,EAAC,kBAAkB,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAiB,MAAM,0BAA0B,CAAC;AAIzD,OAAO,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAC;AAMpD,OAAO,EAAC,gBAAgB,EAAC,MAAM,8CAA8C,CAAC;AAG9E,OAAO,EAAC,YAAY,EAAC,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAC,wBAAwB,EAAC,MAAM,+BAA+B,CAAC;AAEvE,OAAO,EAAC,UAAU,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAC,kBAAkB,EAAE,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAC,sBAAsB,EAAC,MAAM,gCAAgC,CAAC;AACtE,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAC,WAAW,EAAC,MAAM,4CAA4C,CAAC;AAMvE,SAAS,yBAAyB,CAAC,MAAkB;IACnD,MAAM,OAAO,GAAkB;QAC7B,QAAQ,EAAE,IAAI;KACf,CAAC;IAEF,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAChC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAEjC,IAAI,MAAM,CAAC,2BAA2B,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CACnC,MAAM,CAAC,2BAA2B,CACnC,CAAC;gBACF,OAAO,CAAC,iBAAiB,GAAG,kBAAkB,CAAC;YACjD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CACb,uDAAuD,MAAM,CAAC,CAAC,CAAC,wBAAwB,CACzF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,MAAM;IACR,EAAE,GAAG,UAAU,GAAG,EAAE,CAAC;IACrB,GAAG,CAAa;IAChB,YAAY,CAAmD;IAC/D,SAAS,CAAmC;IAC5C,QAAQ,CAA8C;IACtD,YAAY,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC7C,iBAAiB,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC3C,OAAO,CAAS;IAChB,IAAI,CAAkB;IACtB,QAAQ,GAAG,QAAQ,EAAE,CAAC;IACtB,OAAO,CAAa;IAE7B,YACE,EAAc,EACd,MAAkB,EAClB,iBAIsC,EACtC,cAAiD,EACjD,aAA6D,EAC7D,MAAc;QAEd,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,2DAA2D;QAC3D,qCAAqC;QACrC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAChD,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAExB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,YAAY,GAAG,IAAI,aAAa,CACnC,EAAE,EACF,EAAE,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,iBAAiB,CAAC,EACzE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CACnB,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,IAAI,aAAa,CAAC,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,eAAe,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC;QAEnE,wBAAwB,CACtB,EAAE,EACF,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,OAAO,CACb,CAAC;QAEF,2BAA2B,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAEQ,iBAAiB,GAAG,KAAK,EAAE,EAAa,EAAE,MAAqB,EAAE,EAAE;QAC1E,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CACd,qBAAqB,EACrB,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,QAAQ,CAChB,CAAC;QACF,yBAAyB,EAAE,CAAC;QAC5B,MAAM,EAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAC,GAAG,MAAM,CAAC;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CACd,UAAU,QAAQ,iDAAiD,CACpE,CAAC;YACF,QAAQ,CAAC,KAAK,CAAC,eAAe,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,YAAoC,CAAC;QACzC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAE3D,MAAM,eAAe,GACnB,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,SAAS;gBACrC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,SAAS,CAAC;YAC1C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,SAAS,CAAC;YAElE,2FAA2F;YAC3F,MAAM,wBAAwB,GAAG,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC;YAC3D,MAAM,kBAAkB,GAAG,eAAe,IAAI,aAAa,CAAC;YAC5D,IAAI,CAAC,wBAAwB,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACrD,MAAM,IAAI,KAAK,CACb,oHAAoH;oBAClH,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;oBAC5B,qJAAqJ,CACxJ,CAAC;YACJ,CAAC;YAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,YAAY,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE;wBACxD,OAAO,EAAE,MAAM;qBAChB,CAAC,CAAC;oBACH,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CACd,uBAAuB,IAAI,iBAAiB,QAAQ,cAAc,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CACjG,CAAC;gBACJ,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,SAAS,CACP,IAAI,CAAC,GAAG,EACR,EAAE,EACF;wBACE,IAAI,EAAE,SAAS,CAAC,eAAe;wBAC/B,OAAO,EAAE,gCAAgC,MAAM,CAAC,CAAC,CAAC,EAAE;wBACpD,MAAM,EAAE,WAAW,CAAC,SAAS;qBAC9B,EACD,CAAC,CACF,CAAC;oBACF,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;oBACvC,OAAO;gBACT,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CACb,uHAAuH,CACxH,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,uCAAuC,QAAQ,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;QACxD,2EAA2E;QAC3E,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,MAAM,EAAE,GAAG,EAAE,CAAC;QAEd,IAAI,UAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,UAAU,CACzB,IAAI,CAAC,GAAG,EACR,MAAM,EACN,EAAE,EACF,IAAI,sBAAsB,CACxB,IAAI,CAAC,GAAG,EACR,MAAM,EACN,IAAI;gBACF,CAAC,CAAC;oBACE,GAAG,EAAE,IAAI;oBACT,OAAO,EAAE,YAAY,IAAI,EAAE;iBAC5B;gBACH,CAAC,CAAC,SAAS,EACb,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,EAC3C,OAAO,EACP,MAAM,CACP,EACD,GAAG,EAAE;gBACH,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,UAAU,EAAE,CAAC;oBACnD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACrC,CAAC;gBACD,6DAA6D;gBAC7D,sFAAsF;gBACtF,OAAO,CAAC,KAAK,EAAE,CAAC;gBAChB,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,CAAC,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,EAAE,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,CAAC;QACV,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAE5C,UAAU,CAAC,IAAI,EAAE,IAAI,uBAAuB,EAAE,CAAC;QAE/C,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CACd,kDAAkD,EAClD,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,QAAQ,CAChB,CAAC;YACF,MAAM,UAAU,CAAC,oBAAoB,CACnC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,iBAAiB,CAAC,CACzC,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,GAAG;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,YAAY,IAAI,CAAC,YAAY,CAAC,IAAI,eAAe,CAAC,CAAC;QAEnE,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAEtC,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,CAAC;YAE/C,gDAAgD;YAChD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC;gBACjD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,wBAAwB,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;gBAC3D,6EAA6E;gBAC7E,yCAAyC;gBACzC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,sBAAsB,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC;IACrB,CAAC;CACF"}

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

@@ -5,8 +5,12 @@ export declare const ConnectTimeout = "ConnectTimeout";
 export declare const DisconnectTimeout = "DisconnectTimeout";
 export declare const UnexpectedBaseCookie = "UnexpectedBaseCookie";
 export declare const PingTimeout = "PingTimeout";
+export declare const PullTimeout = "PullTimeout";
 export declare const Hidden = "Hidden";
 export declare const NoSocketOrigin = "NoSocketOrigin";
+export declare const InvalidMessage = "InvalidMessage";
+export declare const UserDisconnect = "UserDisconnect";
+export declare const Internal = "Internal";
 export type AbruptClose = typeof AbruptClose;
 export type CleanClose = typeof CleanClose;
 export type ClientClosed = typeof ClientClosed;
@@ -14,6 +18,10 @@ export type ConnectTimeout = typeof ConnectTimeout;
 export type DisconnectTimeout = typeof DisconnectTimeout;
 export type UnexpectedBaseCookie = typeof UnexpectedBaseCookie;
 export type PingTimeout = typeof PingTimeout;
+export type PullTimeout = typeof PullTimeout;
 export type Hidden = typeof Hidden;
 export type NoSocketOrigin = typeof NoSocketOrigin;
+export type InvalidMessage = typeof InvalidMessage;
+export type UserDisconnect = typeof UserDisconnect;
+export type Internal = typeof Internal;
 //# sourceMappingURL=client-error-kind-enum.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"client-error-kind-enum.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/client-error-kind-enum.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAC3C,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,MAAM,WAAW,CAAC;AAC/B,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC;AAC7C,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC;AAC3C,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC;AAC/C,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC;AACzD,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC;AAC7C,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC;AACnC,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC"}
+{"version":3,"file":"client-error-kind-enum.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/client-error-kind-enum.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAC3C,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,MAAM,WAAW,CAAC;AAC/B,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,QAAQ,aAAa,CAAC;AAEnC,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC;AAC7C,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC;AAC3C,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC;AAC/C,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC;AACzD,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC;AAC7C,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC;AAC7C,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC;AACnC,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AACnD,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC"}

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

@@ -1,9 +1,28 @@
 import { Subscribable } from '../../../shared/src/subscribable.ts';
 import { ConnectionStatus } from './connection-status.ts';
-import type { ZeroError } from './error.ts';
+import { type AuthError, type ZeroError } from './error.ts';
+/**
+ * The current connection state of the Zero instance. It can be one of the following states:
+ *
+ * - `connecting`: The client is actively trying to connect every 5 seconds.
+ *   - `attempt` counts the number of retries within the current retry window,
+ *   - `disconnectAt` is the epoch timestamp when the client will transition to `disconnected` state
+ *   - `reason` is the optional error associated with the connection attempt.
+ * - `disconnected`: The client is now in an "offline" state. It will continue
+ *   to try to connect every 5 seconds.
+ * - `connected`: The client has opened a successful connection to the server.
+ * - `needs-auth`: Authentication is invalid or expired. No connection retries will be made
+ *   until the host application calls `connect({auth: token})`.
+ *   - `reason` is the `ZeroError` associated with the error state.
+ * - `error`: A fatal error occurred. No connection retries will be made until the host
+ *   application calls `connect()` again.
+ *   - `reason` is the `ZeroError` associated with the error state.
+ * - `closed`: The client was shut down (for example via `zero.close()`). This is
+ *   a terminal state, and a new Zero instance must be created to reconnect.
+ */
 export type ConnectionState = {
     name: ConnectionStatus.Disconnected;
-    reason?: ZeroError | undefined;
+    reason: ZeroError;
 } | {
     name: ConnectionStatus.Connecting;
     attempt: number;
@@ -11,8 +30,15 @@ export type ConnectionState = {
     reason?: ZeroError | undefined;
 } | {
     name: ConnectionStatus.Connected;
+} | {
+    name: ConnectionStatus.NeedsAuth;
+    reason: AuthError;
+} | {
+    name: ConnectionStatus.Error;
+    reason: ZeroError;
 } | {
     name: ConnectionStatus.Closed;
+    reason: ZeroError;
 };
 export type ConnectionManagerOptions = {
     /**
@@ -26,6 +52,11 @@ export type ConnectionManagerOptions = {
      */
     timeoutCheckIntervalMs?: number | undefined;
 };
+declare const TERMINAL_STATES: ["needs-auth", "error"];
+type TerminalConnectionStatus = (typeof TERMINAL_STATES)[number];
+type TerminalConnectionState = Extract<ConnectionState, {
+    name: TerminalConnectionStatus;
+}>;
 export declare class ConnectionManager extends Subscribable<ConnectionState> {
     #private;
     constructor(options: ConnectionManagerOptions);
@@ -34,13 +65,27 @@ export declare class ConnectionManager extends Subscribable<ConnectionState> {
      * Returns true if the current state is equal to the given status.
      */
     is(status: ConnectionStatus): boolean;
+    /**
+     * Returns true if the current state is a terminal state
+     * that can be recovered from by calling connect().
+     */
+    isInTerminalState(): boolean;
+    /**
+     * Returns true if the given status is a terminal state
+     * that can be recovered from by calling connect().
+     */
+    static isTerminalState(state: ConnectionState): state is TerminalConnectionState;
     /**
      * Returns true if the run loop should continue.
-     * The run loop continues in disconnected, connecting, and connected states.
-     * It stops in closed state.
+     * The run loop continues in all states except closed.
+     * In needs-auth and error states, the run loop pauses and waits for connect() to be called.
      */
     shouldContinueRunLoop(): boolean;
-    waitForStateChange(): Promise<void>;
+    /**
+     * Waits for the next state change.
+     * @returns A promise that resolves when the next state change occurs.
+     */
+    waitForStateChange(): Promise<ConnectionState>;
     /**
      * Transition to connecting state.
      *
@@ -49,8 +94,8 @@ export declare class ConnectionManager extends Subscribable<ConnectionState> {
      *
      * @returns An object containing a promise that resolves on the next state change.
      */
-    connecting(reason?: ZeroError | undefined): {
-        nextStatePromise: Promise<void>;
+    connecting(reason?: ZeroError): {
+        nextStatePromise: Promise<ConnectionState>;
     };
     /**
      * Transition to connected state.
@@ -59,7 +104,7 @@ export declare class ConnectionManager extends Subscribable<ConnectionState> {
      * @returns An object containing a promise that resolves on the next state change.
      */
     connected(): {
-        nextStatePromise: Promise<void>;
+        nextStatePromise: Promise<ConnectionState>;
     };
     /**
      * Transition to disconnected state.
@@ -69,18 +114,41 @@ export declare class ConnectionManager extends Subscribable<ConnectionState> {
      *
      * @returns An object containing a promise that resolves on the next state change.
      */
-    disconnected(reason?: ZeroError | undefined): {
-        nextStatePromise: Promise<void>;
+    disconnected(reason: ZeroError): {
+        nextStatePromise: Promise<ConnectionState>;
     };
     /**
-     * Transition to closed state.
-     * This is terminal - no further transitions are allowed.
+     * Transition to needs-auth state.
+     * This pauses the run loop until connect() is called with new credentials.
+     * Resets the retry window and attempt counter.
+     *
+     * @returns An object containing a promise that resolves on the next state change.
+     */
+    needsAuth(reason: AuthError): {
+        nextStatePromise: Promise<ConnectionState>;
+    };
+    /**
+     * Transition to error state.
+     * This pauses the run loop until connect() is called.
+     * Resets the retry window and attempt counter.
      *
      * @returns An object containing a promise that resolves on the next state change.
      */
-    closed(): {
-        nextStatePromise: Promise<void>;
+    error(reason: ZeroError): {
+        nextStatePromise: Promise<ConnectionState>;
     };
+    /**
+     * Transition to closed state.
+     * This is terminal - no further transitions are allowed.
+     */
+    closed(): void;
     cleanup: () => void;
 }
+/**
+ * Used to trigger the catch block when a terminal state is reached.
+ *
+ * @param state - The current connection state.
+ */
+export declare const throwIfConnectionError: (state: ConnectionState) => void;
+export {};
 //# sourceMappingURL=connection-manager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/connection-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,YAAY,EAAC,MAAM,qCAAqC,CAAC;AACjE,OAAO,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,YAAY,CAAC;AAI1C,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,gBAAgB,CAAC,YAAY,CAAC;IACpC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAChC,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC,UAAU,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAChC,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC;CAClC,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC;CAC/B,CAAC;AAEN,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C,CAAC;AAEF,qBAAa,iBAAkB,SAAQ,YAAY,CAAC,eAAe,CAAC;;gBAgCtD,OAAO,EAAE,wBAAwB;IAiB7C,IAAI,KAAK,IAAI,eAAe,CAE3B;IAED;;OAEG;IACH,EAAE,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;IAIrC;;;;OAIG;IACH,qBAAqB,IAAI,OAAO;IAIhC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;;;;;;OAOG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG;QAC1C,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;KACjC;IA+CD;;;;;OAKG;IACH,SAAS,IAAI;QAAC,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;KAAC;IAsB9C;;;;;;;OAOG;IACH,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG;QAC5C,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;KACjC;IA6BD;;;;;OAKG;IACH,MAAM,IAAI;QAAC,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;KAAC;IAgBlC,OAAO,QAAO,IAAI,CAGzB;CAuDH"}
+{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/connection-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,YAAY,EAAC,MAAM,qCAAqC,CAAC;AACjE,OAAO,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AAKpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,gBAAgB,CAAC,YAAY,CAAC;IACpC,MAAM,EAAE,SAAS,CAAC;CACnB,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC,UAAU,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAChC,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC;CAClC,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC;IACjC,MAAM,EAAE,SAAS,CAAC;CACnB,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC;IAC7B,MAAM,EAAE,SAAS,CAAC;CACnB,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC;IAC9B,MAAM,EAAE,SAAS,CAAC;CACnB,CAAC;AAEN,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C,CAAC;AAEF,QAAA,MAAM,eAAe,yBAGkB,CAAC;AAExC,KAAK,wBAAwB,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,KAAK,uBAAuB,GAAG,OAAO,CACpC,eAAe,EACf;IAAC,IAAI,EAAE,wBAAwB,CAAA;CAAC,CACjC,CAAC;AAEF,qBAAa,iBAAkB,SAAQ,YAAY,CAAC,eAAe,CAAC;;gBAgCtD,OAAO,EAAE,wBAAwB;IAiB7C,IAAI,KAAK,IAAI,eAAe,CAE3B;IAED;;OAEG;IACH,EAAE,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO;IAIrC;;;OAGG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;;OAGG;IACH,MAAM,CAAC,eAAe,CACpB,KAAK,EAAE,eAAe,GACrB,KAAK,IAAI,uBAAuB;IAMnC;;;;OAIG;IACH,qBAAqB,IAAI,OAAO;IAIhC;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;IAI9C;;;;;;;OAOG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG;QAC9B,gBAAgB,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;KAC5C;IA+CD;;;;;OAKG;IACH,SAAS,IAAI;QAAC,gBAAgB,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;KAAC;IAsBzD;;;;;;;OAOG;IACH,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG;QAC/B,gBAAgB,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;KAC5C;IA6BD;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG;QAC5B,gBAAgB,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;KAC5C;IAuBD;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG;QAAC,gBAAgB,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;KAAC;IAuBtE;;;OAGG;IACH,MAAM;IAqBG,OAAO,QAAO,IAAI,CAGzB;CA4DH;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,eAAe,SAkB5D,CAAC"}

package/out/zero-client/src/client/connection-status-enum.d.ts

@@ -1,9 +1,13 @@
 export declare const Disconnected = "disconnected";
 export declare const Connecting = "connecting";
 export declare const Connected = "connected";
+export declare const NeedsAuth = "needs-auth";
+export declare const Error = "error";
 export declare const Closed = "closed";
 export type Disconnected = typeof Disconnected;
 export type Connecting = typeof Connecting;
 export type Connected = typeof Connected;
+export type NeedsAuth = typeof NeedsAuth;
+export type Error = typeof Error;
 export type Closed = typeof Closed;
 //# sourceMappingURL=connection-status-enum.d.ts.map

package/out/zero-client/src/client/connection-status-enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-status-enum.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/connection-status-enum.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAC3C,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,MAAM,WAAW,CAAC;AAE/B,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC;AAC/C,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC;AACzC,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}
+{"version":3,"file":"connection-status-enum.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/connection-status-enum.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAC3C,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,SAAS,eAAe,CAAC;AACtC,eAAO,MAAM,KAAK,UAAU,CAAC;AAC7B,eAAO,MAAM,MAAM,WAAW,CAAC;AAE/B,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC;AAC/C,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC;AAC3C,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC;AACzC,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC;AACzC,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC;AACjC,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}

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

@@ -0,0 +1,53 @@
+import type { ConnectionManager, ConnectionState } from './connection-manager.ts';
+import type { ZeroLogContext } from './zero-log-context.ts';
+export interface Source<T> {
+    /**
+     * The current state value.
+     */
+    readonly current: T;
+    /**
+     * Subscribe to state changes.
+     *
+     * @param listener - Called when the state changes with the new state value.
+     * @returns A function to unsubscribe from state changes.
+     */
+    subscribe(listener: (state: T) => void): () => void;
+}
+/**
+ * Connection API for managing Zero's connection lifecycle.
+ */
+export interface Connection {
+    /**
+     * The current connection state as a subscribable value.
+     */
+    readonly state: Source<ConnectionState>;
+    /**
+     * Resumes the connection from a terminal state.
+     *
+     * If called when not in a terminal state, this method does nothing.
+     *
+     * @param opts - Optional connection options
+     * @param opts.auth - Token to use for authentication. If provided, this overrides
+     *                    the stored auth credential for this connection attempt.
+     *                    If `null` or `undefined`, the stored auth credential is cleared.
+     * @returns A promise that resolves once the connection state has transitioned to connecting.
+     */
+    connect(opts?: {
+        auth: string | null | undefined;
+    }): Promise<void>;
+}
+export declare class ConnectionImpl implements Connection {
+    #private;
+    constructor(connectionManager: ConnectionManager, lc: ZeroLogContext, setAuth: (auth: string | null | undefined) => void);
+    get state(): Source<ConnectionState>;
+    connect(opts?: {
+        auth: string | null | undefined;
+    }): Promise<void>;
+}
+export declare class ConnectionSource implements Source<ConnectionState> {
+    #private;
+    constructor(connectionManager: ConnectionManager);
+    get current(): ConnectionState;
+    get subscribe(): (listener: (obj: ConnectionState) => unknown) => (() => void);
+}
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAE,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAEpB;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IAExC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,IAAI,CAAC,EAAE;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;KAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,qBAAa,cAAe,YAAW,UAAU;;gBAO7C,iBAAiB,EAAE,iBAAiB,EACpC,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI;IAQpD,IAAI,KAAK,IAAI,MAAM,CAAC,eAAe,CAAC,CAEnC;IAEK,OAAO,CAAC,IAAI,CAAC,EAAE;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;KAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CA0BvE;AAED,qBAAa,gBAAiB,YAAW,MAAM,CAAC,eAAe,CAAC;;gBAGlD,iBAAiB,EAAE,iBAAiB;IAIhD,IAAI,OAAO,IAAI,eAAe,CAE7B;IAED,IAAI,SAAS,kEAEZ;CACF"}

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

@@ -1,37 +1,64 @@
 import type { Expand } from '../../../shared/src/expand.ts';
 import { ErrorKind } from '../../../zero-protocol/src/error-kind.ts';
-import type { BackoffBody, ErrorBody } from '../../../zero-protocol/src/error.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 { 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 NeedsAuthReason = Expand<(ErrorBody & {
+    kind: ErrorKind.AuthInvalidated | ErrorKind.Unauthorized;
+}) | (Extract<PushFailedBody, {
+    reason: ErrorReason.HTTP;
+}> & {
+    status: 401 | 403;
+}) | (Extract<TransformFailedBody, {
+    reason: ErrorReason.HTTP;
+}> & {
+    status: 401 | 403;
+})>;
 export type ClientErrorBody = {
     kind: ClientErrorKind;
+    origin: typeof ErrorOrigin.Client;
     message: string;
 };
-export type ZeroErrorBody = Expand<ErrorBody | ClientErrorBody>;
-export type ZeroErrorKind = Expand<ErrorKind | ClientErrorKind>;
-declare abstract class BaseError<T extends ErrorBody | ClientErrorBody, Name extends T extends ErrorBody ? 'ServerError' : 'ClientError'> extends Error {
-    readonly errorBody: T;
-    constructor(errorBody: T, options?: ErrorOptions);
-    get kind(): T['kind'];
-    abstract get name(): Name;
-}
-/**
- * Represents an error sent by server as part of Zero protocol.
- */
-export declare class ServerError extends BaseError<ErrorBody, 'ServerError'> {
-    get name(): "ServerError";
-}
 /**
  * Represents an error encountered by the client.
  */
-export declare class ClientError extends BaseError<ClientErrorBody, 'ClientError'> {
-    get name(): "ClientError";
+export declare class ClientError<const T extends Omit<ClientErrorBody, 'origin'> = Omit<ClientErrorBody, 'origin'>> extends Error {
+    readonly errorBody: {
+        origin: typeof ErrorOrigin.Client;
+    } & T;
+    constructor(errorBody: T, options?: ErrorOptions);
+    get kind(): T['kind'];
 }
-export type ZeroError = ServerError | ClientError;
-export declare function isServerError(ex: unknown): ex is ServerError;
-export declare function isAuthError(ex: unknown): ex is ServerError & {
-    kind: ErrorKind.AuthInvalidated | ErrorKind.Unauthorized;
+export declare function isServerError(ex: unknown): ex is ProtocolError<ErrorBody>;
+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;
+    reason: ZeroError;
+} | {
+    status: ConnectionStatus.NeedsAuth;
+    reason: AuthError;
+} | {
+    status: ConnectionStatus.Error;
+    reason: ZeroError;
+} | {
+    status: ConnectionStatus.Disconnected;
+    reason: ZeroError;
+} | {
+    status: ConnectionStatus.Closed;
+    reason: ZeroError;
 };
-export declare function isBackoffError(ex: unknown): BackoffBody | undefined;
-export declare function isClientError(ex: unknown): ex is ClientError;
-export {};
+/**
+ * Returns the status to transition to, or null if the error
+ * indicates that the connection should continue in the current state.
+ */
+export declare function getErrorConnectionTransition(ex: unknown): ErrorConnectionTransition;
 //# sourceMappingURL=error.d.ts.map

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":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAC,SAAS,EAAC,MAAM,0CAA0C,CAAC;AACnE,OAAO,KAAK,EAAC,WAAW,EAAE,SAAS,EAAC,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAC,eAAe,EAAC,MAAM,wBAAwB,CAAC;AAEvD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC;AAEhE,uBAAe,SAAS,CACtB,CAAC,SAAS,SAAS,GAAG,eAAe,EACrC,IAAI,SAAS,CAAC,SAAS,SAAS,GAAG,aAAa,GAAG,aAAa,CAChE,SAAQ,KAAK;IACb,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;gBACV,SAAS,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY;IAIhD,IAAI,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,CAEpB;IACD,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,SAAS,CAAC,SAAS,EAAE,aAAa,CAAC;IAClE,IAAI,IAAI,IACC,aAAa,CACrB;CACF;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,SAAS,CAAC,eAAe,EAAE,aAAa,CAAC;IACxE,IAAI,IAAI,IACC,aAAa,CACrB;CACF;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;AAElD,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,WAAW,CAE5D;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,WAAW,GAAG;IAC5D,IAAI,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC;CAC1D,CAEA;AAQD,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAUnE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,WAAW,CAE5D"}
+{"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/ivm-branch.d.ts

@@ -24,7 +24,7 @@ import type { LazyStore } from '../../../replicache/src/dag/lazy-store.ts';
 export declare class IVMSourceBranch {
     #private;
     hash: Hash | undefined;
-    constructor(tables: Record<string, TableSchema>, hash?: Hash | undefined, sources?: Map<string, MemorySource | undefined>);
+    constructor(tables: Record<string, TableSchema>, hash?: Hash, sources?: Map<string, MemorySource | undefined>);
     getSource(name: string): MemorySource | undefined;
     clear(): void;
     /**
@@ -35,7 +35,7 @@ export declare class IVMSourceBranch {
     /**
      * Fork the branch and patch it up to match the desired head.
      */
-    forkToHead(store: LazyStore, desiredHead: Hash, readOptions?: ZeroReadOptions | undefined): Promise<IVMSourceBranch>;
+    forkToHead(store: LazyStore, desiredHead: Hash, readOptions?: ZeroReadOptions): Promise<IVMSourceBranch>;
     /**
      * Creates a new IVMSourceBranch that is a copy of the current one.
      * This is a cheap operation since the b-trees are shared until a write is performed

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

@@ -1 +1 @@
-{"version":3,"file":"ivm-branch.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/ivm-branch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,uCAAuC,CAAC;AACnE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,0CAA0C,CAAC;AAE1E,OAAO,EAAY,KAAK,KAAK,EAAC,MAAM,sCAAsC,CAAC;AAE3E,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,iCAAiC,CAAC;AAO1D,OAAO,KAAK,EAGV,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAG/C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+CAA+C,CAAC;AACnF,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,2CAA2C,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;;IAG1B,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;gBAGrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,EACvB,OAAO,GAAE,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAa;IAO5D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAajD,KAAK;IAIL;;;OAGG;IACH,OAAO,CAAC,YAAY,EAAE,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW;IAWzE;;OAEG;IACG,UAAU,CACd,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,IAAI,EACjB,WAAW,CAAC,EAAE,eAAe,GAAG,SAAS,GACxC,OAAO,CAAC,eAAe,CAAC;IAY3B;;;;;;;OAOG;IACH,IAAI;CAYL;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,iBAkBb"}
+{"version":3,"file":"ivm-branch.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/ivm-branch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,uCAAuC,CAAC;AACnE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,0CAA0C,CAAC;AAE1E,OAAO,EAAY,KAAK,KAAK,EAAC,MAAM,sCAAsC,CAAC;AAE3E,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,iCAAiC,CAAC;AAO1D,OAAO,KAAK,EAGV,WAAW,EACZ,MAAM,uCAAuC,CAAC;AAG/C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+CAA+C,CAAC;AACnF,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,2CAA2C,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;;IAG1B,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;gBAGrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,IAAI,CAAC,EAAE,IAAI,EACX,OAAO,GAAE,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAa;IAO5D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAajD,KAAK;IAIL;;;OAGG;IACH,OAAO,CAAC,YAAY,EAAE,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW;IAWzE;;OAEG;IACG,UAAU,CACd,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,IAAI,EACjB,WAAW,CAAC,EAAE,eAAe,GAC5B,OAAO,CAAC,eAAe,CAAC;IAY3B;;;;;;;OAOG;IACH,IAAI;CAYL;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,iBAkBb"}

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

@@ -4,6 +4,15 @@ import type { ZeroLogContext } from './zero-log-context.ts';
 export declare const DID_NOT_CONNECT_VALUE: number;
 export declare const REPORT_INTERVAL_MS = 5000;
 export declare function getLastConnectErrorValue(reason: ZeroError): `server_${string}` | `client_${string}`;
+/**
+ * Returns whether an error should be reported in metrics and
+ * increment the connect error count.
+ *
+ * Returns `true` for all server errors and client errors that represent actual
+ * connection problems. Returns `false` for expected client-side disconnections
+ * (user disconnect, client closed, hidden tab, clean/abrupt close).
+ */
+export declare function shouldReportConnectError(reason: ZeroError): boolean;
 type MetricsReporter = (metrics: Series[]) => MaybePromise<void>;
 export type MetricManagerOptions = {
     reportIntervalMs: number;

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

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAgB,KAAK,SAAS,EAAqB,MAAM,YAAY,CAAC;AAE7E,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAM1D,eAAO,MAAM,qBAAqB,QAAa,CAAC;AAEhD,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AASxC,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,2CAEzD;AAYD,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,eAAe,CAAC;IAC1B,EAAE,EAAE,cAAc,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,qBAAa,aAAa;;gBAOZ,IAAI,EAAE,oBAAoB;IAqCtC,QAAQ,CAAC,eAAe,QAEtB;IAMF,QAAQ,CAAC,gBAAgB,QAKvB;IAqCF,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM;IAOlE,gCAAgC;IAmBhC,eAAe,CAAC,MAAM,EAAE,SAAS;IAOjC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAM;IAIvB,KAAK;IA4BX,IAAI;CAaL;AAMD,6DAA6D;AAC7D,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AACF;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAMvC,KAAK,SAAS,GAAG;IACf,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAAG,SAAS,CAAC;CACxD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAM,YAAW,SAAS;;gBAIzB,IAAI,EAAE,MAAM;IAIxB,GAAG,CAAC,KAAK,EAAE,MAAM;IAIjB,GAAG;IAIH,KAAK;IAIL,KAAK;;;;CASN;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,KAAM,YAAW,SAAS;;gBAKzB,MAAM,EAAE,MAAM,EAAE,YAAY,UAAQ;IAKhD,GAAG,CAAC,KAAK,EAAE,MAAM;IAIjB,GAAG;IAIH,KAAK;IAIL,KAAK;;;;CAYN"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAGL,KAAK,SAAS,EAEf,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAM1D,eAAO,MAAM,qBAAqB,QAAa,CAAC;AAEhD,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AASxC,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,2CAEzD;AAYD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAcnE;AAED,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,eAAe,CAAC;IAC1B,EAAE,EAAE,cAAc,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,qBAAa,aAAa;;gBAOZ,IAAI,EAAE,oBAAoB;IAqCtC,QAAQ,CAAC,eAAe,QAEtB;IAMF,QAAQ,CAAC,gBAAgB,QAKvB;IAqCF,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM;IAOlE,gCAAgC;IAmBhC,eAAe,CAAC,MAAM,EAAE,SAAS;IAOjC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAM;IAIvB,KAAK;IA4BX,IAAI;CAaL;AAMD,6DAA6D;AAC7D,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AACF;;;;;GAKG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAMvC,KAAK,SAAS,GAAG;IACf,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAAG,SAAS,CAAC;CACxD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,qBAAa,KAAM,YAAW,SAAS;;gBAIzB,IAAI,EAAE,MAAM;IAIxB,GAAG,CAAC,KAAK,EAAE,MAAM;IAIjB,GAAG;IAIH,KAAK;IAIL,KAAK;;;;CASN;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,KAAM,YAAW,SAAS;;gBAKzB,MAAM,EAAE,MAAM,EAAE,YAAY,UAAQ;IAKhD,GAAG,CAAC,KAAK,EAAE,MAAM;IAIjB,GAAG;IAIH,KAAK;IAIL,KAAK;;;;CAYN"}

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

@@ -1,13 +1,14 @@
 import type { EphemeralID, MutationTrackingData } from '../../../replicache/src/replicache-options.ts';
-import { type MutationID, type PushResponse } from '../../../zero-protocol/src/push.ts';
-import type { ZeroLogContext } from './zero-log-context.ts';
 import type { ReplicacheImpl } from '../../../replicache/src/impl.ts';
+import { type MutationID, type PushResponseBody } from '../../../zero-protocol/src/push.ts';
+import { type ZeroError } from './error.ts';
+import type { ZeroLogContext } from './zero-log-context.ts';
 /**
  * Tracks what pushes are in-flight and resolves promises when they're acked.
  */
 export declare class MutationTracker {
     #private;
-    constructor(lc: ZeroLogContext, ackMutations: (upTo: MutationID) => void);
+    constructor(lc: ZeroLogContext, ackMutations: (upTo: MutationID) => void, onFatalError: (error: ZeroError) => void);
     setClientIDAndWatch(clientID: string, experimentalWatch: ReplicacheImpl['experimentalWatch']): void;
     trackMutation(): MutationTrackingData;
     mutationIDAssigned(id: EphemeralID, mutationID: number): void;
@@ -16,7 +17,7 @@ export declare class MutationTracker {
      * The mutation must not have been persisted to the client store.
      */
     rejectMutation(id: EphemeralID, e: unknown): void;
-    processPushResponse(response: PushResponse): void;
+    processPushResponse(response: PushResponseBody): void;
     /**
      * DEPRECATED: to be removed when we switch to fully driving
      * mutation resolution via poke.

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

@@ -1 +1 @@
-{"version":3,"file":"mutation-tracker.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/mutation-tracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACrB,MAAM,+CAA+C,CAAC;AAGvD,OAAO,EAGL,KAAK,UAAU,EAIf,KAAK,YAAY,EAClB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,iCAAiC,CAAC;AAiBpE;;GAEG;AACH,qBAAa,eAAe;;gBAiBd,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI;IAUxE,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,cAAc,CAAC,mBAAmB,CAAC;IAexD,aAAa,IAAI,oBAAoB;IAUrC,kBAAkB,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAY7D;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,GAAG,IAAI;IA+CjD,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAWjD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM;IAIlC;;;;;;OAMG;IACH,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAoB1C,IAAI,IAAI,WAEP;IA4GD;;;;;;;;;OASG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;CASlD"}
+{"version":3,"file":"mutation-tracker.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/mutation-tracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACrB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,iCAAiC,CAAC;AAOpE,OAAO,EAGL,KAAK,UAAU,EAIf,KAAK,gBAAgB,EACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAC,KAAK,SAAS,EAAC,MAAM,YAAY,CAAC;AAE1C,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAoB1D;;GAEG;AACH,qBAAa,eAAe;;gBAmBxB,EAAE,EAAE,cAAc,EAClB,YAAY,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,EACxC,YAAY,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI;IAY1C,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,cAAc,CAAC,mBAAmB,CAAC;IAexD,aAAa,IAAI,oBAAoB;IAUrC,kBAAkB,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAY7D;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,GAAG,IAAI;IA+CjD,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAuDrD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM;IAIlC;;;;;;OAMG;IACH,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAoB1C,IAAI,IAAI,WAEP;IAuID;;;;;;;;;OASG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;CASlD"}

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

@@ -1,6 +1,5 @@
 import type { LogLevel } from '@rocicorp/logger';
 import type { StoreProvider } from '../../../replicache/src/kv/store.ts';
-import type { MaybePromise } from '../../../shared/src/types.ts';
 import * as v from '../../../shared/src/valita.ts';
 import type { Schema } from '../../../zero-schema/src/builder/schema-builder.ts';
 import type { CustomMutatorDefs } from './custom.ts';
@@ -23,24 +22,18 @@ export interface ZeroOptions<S extends Schema, MD extends CustomMutatorDefs | un
      */
     server?: string | null | undefined;
     /**
-     * A JWT to identify and authenticate the user. Can be provided as either:
-     * - A string containing the JWT token
-     * - A function that returns a JWT token
-     * - `undefined` if there is no logged in user
+     * A token to identify and authenticate the user.
      *
-     * Token validation behavior:
-     * 1. **For function providers:**
-     *    When zero-cache reports that a token is invalid (expired, malformed,
-     *    or has an invalid signature), Zero will call the function again with
-     *    `error='invalid-token'` to obtain a new token.
+     * Set `auth` to `null` or `undefined` if there is no logged in user.
      *
-     * 2. **For string tokens:**
-     *    Zero will continue to use the provided token even if zero-cache initially
-     *    reports it as invalid. This is because zero-cache may be able to validate
-     *    the token after fetching new public keys from its configured JWKS URL
-     *    (if `ZERO_AUTH_JWKS_URL` is set).
+     * When a 401 or 403 HTTP status code is received from your server, Zero will
+     * transition to the `needs-auth` connection state. The app should call
+     * `zero.connection.connect({auth: newToken})` with a new token to reconnect.
+     *
+     * The call to `connect` is handled automatically by the ZeroProvider component
+     * for React and SolidJS when the `auth` prop changes.
      */
-    auth?: string | ((error?: 'invalid-token') => MaybePromise<string | undefined>) | undefined;
+    auth?: string | null | undefined;
     /**
      * A unique identifier for the user. Must be non-empty.
      *
@@ -96,11 +89,15 @@ export interface ZeroOptions<S extends Schema, MD extends CustomMutatorDefs | un
     /**
      * `onOnlineChange` is called when the Zero instance's online status changes.
      *
-     * @deprecated Use `onOnline` on the Zero instance instead. e.g.
+     * @deprecated Use {@linkcode Connection.state.subscribe} on the Zero instance instead. e.g.
      * ```ts
      * const zero = new Zero({...});
-     * zero.onOnline((online) => { ... });
+     * zero.connection.state.subscribe((state) => {
+     *   console.log('Connection state:', state.name);
+     * });
      * ```
+     *
+     * Or use a hook like {@linkcode useZeroConnectionState} to subscribe to state changes.
      */
     onOnlineChange?: ((online: boolean) => void) | undefined;
     /**