agents 0.24.0 → 0.26.0

package/dist/{client-BxdkCuVy.d.ts → client-je3koD9Z.d.ts}

@@ -1,4 +1,4 @@
-import { c as Agent } from "./agent-routing-B2XLNMxq.js";
+import { c as Agent } from "./agent-routing-0DR0Tk2v.js";
 import {
   ClientParameters,
   Method,
@@ -69,6 +69,31 @@ declare class AgentConnectionError extends Error {
   constructor(event: CloseEvent);
 }
 declare function isTerminalCloseEvent(event: CloseEvent): boolean;
+type ReconnectingSocket = {
+  shouldReconnect: boolean;
+  retryCount: number;
+};
+/**
+ * PartySocket's `shouldReconnectOnClose`, plus a record of whether that
+ * decision ended reconnection so the close can surface a connection error.
+ *
+ * Reconnection ends on a terminal close code, when the caller's
+ * `shouldReconnectOnClose` declines, or when `maxRetries` is spent (a
+ * failed handshake never reaches the server's close codes, so it only
+ * stops this way). An explicit `close()` has already cleared
+ * `shouldReconnect` by the time PartySocket asks, and is not an error.
+ * PartySocket asks before it schedules the next attempt, so `retryCount`
+ * still counts the attempt that just closed.
+ * @internal
+ */
+declare function createCloseClassifier(options: {
+  socket: () => ReconnectingSocket | null | undefined;
+  shouldReconnectOnClose: () => ((event: CloseEvent) => boolean) | undefined;
+  maxRetries: () => number | undefined;
+}): {
+  shouldReconnectOnClose: (event: CloseEvent) => boolean;
+  takeFinalClose: () => boolean;
+};
 type TerminalReconnectOptions = {
   shouldReconnectOnClose?: (event: CloseEvent) => boolean;
 };
@@ -142,7 +167,12 @@ type AgentClientOptions<State = unknown> = Omit<
      * that don't pass an explicit `timeout`. Defaults to 30 000 ms.
      * Set to `0` to disable. Streaming calls never get a default timeout.
      */
-    defaultCallTimeout?: number /** Called when the connection closes with a terminal code and will not reconnect. */;
+    defaultCallTimeout?: number;
+    /**
+     * Called when the connection closes and will not reconnect on its own: a
+     * terminal close code (1008 or 4000-4999), `shouldReconnectOnClose`
+     * returning false, or `maxRetries` spent.
+     */
     onConnectionError?: (error: AgentConnectionError) => void;
   };
 /**
@@ -329,17 +359,21 @@ declare class AgentClient<
   state: State | undefined;
   /**
    * Whether the client has received identity from the server.
-   * Becomes true after the first identity message is received.
+   * Becomes true with `ready`: after the identity message, or after the
+   * initial state message when the server sends one.
    * Resets to false on connection close.
    */
   identified: boolean;
   /**
-   * Terminal connection error, if the server closed the socket with a code
-   * that should not be retried automatically.
+   * Set when the connection closed and will not reconnect on its own (see
+   * `onConnectionError`). Cleared when a connection opens.
    */
   connectionError: AgentConnectionError | null;
   /**
    * Promise that resolves when identity has been received from the server.
+   * When the server also sends the stored state on connect, it resolves only
+   * after that state has been applied, so `state` is current once it settles.
+   * Servers without that signal resolve on identity alone.
    * Useful for waiting before making calls that depend on knowing the instance.
    * Resets on connection close so it can be awaited again after reconnect.
    */
@@ -387,9 +421,9 @@ declare function agentFetch(
 ): Promise<Response>;
 //#endregion
 export {
-  createStubProxy as _,
+  createCloseClassifier as _,
   AgentMethods as a,
-  splitCallOptions as b,
+  nativeCall as b,
   CallOptions as c,
   OptionalAgentMethods as d,
   RPCMethods as f,
@@ -405,7 +439,8 @@ export {
   AgentStub as s,
   AgentClient as t,
   NativeCallQueue as u,
-  isTerminalCloseEvent as v,
-  nativeCall as y
+  createStubProxy as v,
+  splitCallOptions as x,
+  isTerminalCloseEvent as y
 };
-//# sourceMappingURL=client-BxdkCuVy.d.ts.map
+//# sourceMappingURL=client-je3koD9Z.d.ts.map

package/dist/client.d.ts

@@ -1,8 +1,8 @@
 import { t as AgentTransport } from "./transport-protocol-ZTew5Wso.js";
 import {
-  _ as createStubProxy,
+  _ as createCloseClassifier,
   a as AgentMethods,
-  b as splitCallOptions,
+  b as nativeCall,
   c as CallOptions,
   d as OptionalAgentMethods,
   f as RPCMethods,
@@ -18,9 +18,10 @@ import {
   s as AgentStub,
   t as AgentClient,
   u as NativeCallQueue,
-  v as isTerminalCloseEvent,
-  y as nativeCall
-} from "./client-BxdkCuVy.js";
+  v as createStubProxy,
+  x as splitCallOptions,
+  y as isTerminalCloseEvent
+} from "./client-je3koD9Z.js";
 export {
   AgentClient,
   AgentClientFetchOptions,
@@ -39,6 +40,7 @@ export {
   StreamOptions,
   UntypedAgentStub,
   agentFetch,
+  createCloseClassifier,
   createStubProxy,
   isTerminalCloseEvent,
   nativeCall,

package/dist/client.js

@@ -1,2 +1,2 @@
-import { a as agentFetch, c as nativeCall, i as NativeCallQueue, l as splitCallOptions, n as AgentConnectionError, o as createStubProxy, r as DEFAULT_CALL_TIMEOUT_MS, s as isTerminalCloseEvent, t as AgentClient } from "./client-C9DAjZIY.js";
-export { AgentClient, AgentConnectionError, DEFAULT_CALL_TIMEOUT_MS, NativeCallQueue, agentFetch, createStubProxy, isTerminalCloseEvent, nativeCall, splitCallOptions };
+import { a as agentFetch, c as isTerminalCloseEvent, i as NativeCallQueue, l as nativeCall, n as AgentConnectionError, o as createCloseClassifier, r as DEFAULT_CALL_TIMEOUT_MS, s as createStubProxy, t as AgentClient, u as splitCallOptions } from "./client-4OlMIJx-.js";
+export { AgentClient, AgentConnectionError, DEFAULT_CALL_TIMEOUT_MS, NativeCallQueue, agentFetch, createCloseClassifier, createStubProxy, isTerminalCloseEvent, nativeCall, splitCallOptions };