@reactor-team/js-sdk 2.5.0 → 2.6.0

package/dist/index.d.mts

@@ -89,12 +89,17 @@ interface ReactorError {
     message: string;
     timestamp: number;
     recoverable: boolean;
-    component: "coordinator" | "gpu" | "livekit";
+    component: "api" | "gpu";
     retryAfter?: number;
 }
 declare class ConflictError extends Error {
     constructor(message: string);
 }
+declare class AbortError extends Error {
+    constructor(message: string);
+}
+/** Matches both our custom AbortError and the native DOMException thrown by fetch(). */
+declare function isAbortError(error: unknown): boolean;
 interface ReactorState$1 {
     status: ReactorStatus;
     lastError?: ReactorError;
@@ -106,6 +111,25 @@ interface ConnectOptions {
     /** Maximum number of SDP polling attempts before giving up. Default: 6. */
     maxAttempts?: number;
 }
+/**
+ * One-shot timing breakdown of the connect() handshake, recorded once per
+ * connection and included in every subsequent {@link ConnectionStats} update.
+ * All durations are in milliseconds (from `performance.now()`).
+ */
+interface ConnectionTimings {
+    /** POST /sessions round-trip time */
+    sessionCreationMs: number;
+    /** Total time spent polling for the SDP answer */
+    sdpPollingMs: number;
+    /** Number of SDP poll requests made (1 = answered on first try) */
+    sdpPollingAttempts: number;
+    /** setRemoteDescription → RTCPeerConnection connectionState "connected" */
+    iceNegotiationMs: number;
+    /** setRemoteDescription → RTCDataChannel "open" */
+    dataChannelMs: number;
+    /** End-to-end: connect() invocation → status "ready" */
+    totalMs: number;
+}
 interface ConnectionStats {
     /** ICE candidate-pair round-trip time in milliseconds */
     rtt?: number;
@@ -119,13 +143,15 @@ interface ConnectionStats {
     packetLossRatio?: number;
     /** Network jitter in seconds (from inbound-rtp) */
     jitter?: number;
+    /** Timing breakdown of the initial connection handshake (set once, persisted until disconnect) */
+    connectionTimings?: ConnectionTimings;
     timestamp: number;
 }
 type ReactorEvent = "statusChanged" | "sessionIdChanged" | "message" | "runtimeMessage" | "trackReceived" | "error" | "sessionExpirationChanged" | "statsUpdate";
 
-declare const PROD_COORDINATOR_URL = "https://api.reactor.inc";
+declare const DEFAULT_BASE_URL = "https://api.reactor.inc";
 declare const OptionsSchema: z.ZodObject<{
-    coordinatorUrl: z.ZodDefault<z.ZodString>;
+    apiUrl: z.ZodDefault<z.ZodString>;
     modelName: z.ZodString;
     local: z.ZodDefault<z.ZodBoolean>;
     receive: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -159,6 +185,8 @@ declare class Reactor {
     /** Tracks the client SENDS to the model (client → model). */
     private send;
     private sessionId?;
+    private connectStartTime?;
+    private connectionTimings?;
     constructor(options: Options);
     private eventListeners;
     on(event: ReactorEvent, handler: EventHandler): void;
@@ -200,6 +228,11 @@ declare class Reactor {
     connect(jwtToken?: string, options?: ConnectOptions): Promise<void>;
     /**
      * Sets up event handlers for the machine client.
+     *
+     * Each handler captures the client reference at registration time and
+     * ignores events if this.machineClient has since changed (e.g. after
+     * disconnect + reconnect), preventing stale WebRTC teardown events from
+     * interfering with a new connection.
      */
     private setupMachineClientHandlers;
     /**
@@ -225,6 +258,8 @@ declare class Reactor {
      */
     getLastError(): ReactorError | undefined;
     getStats(): ConnectionStats | undefined;
+    private resetConnectionTimings;
+    private finalizeConnectionTimings;
     /**
      * Create and store an error
      */
@@ -362,9 +397,9 @@ declare function useStats(): ConnectionStats | undefined;
  * In production, call /tokens from your server and pass the JWT to your frontend.
  *
  * @param apiKey - Your Reactor API key (will be exposed in client code!)
- * @param coordinatorUrl - Optional coordinator URL, defaults to production
+ * @param apiUrl - Optional API URL, defaults to production
  * @returns string containing the JWT token
  */
-declare function fetchInsecureJwtToken(apiKey: string, coordinatorUrl?: string): Promise<string>;
+declare function fetchInsecureToken(apiKey: string, apiUrl?: string): Promise<string>;
 
-export { type AudioTrackOptions, ConflictError, type ConnectOptions, type ConnectionStats, type MessageScope, type Options, PROD_COORDINATOR_URL, Reactor, type ReactorConnectOptions, ReactorController, type ReactorControllerProps, type ReactorError, type ReactorEvent, ReactorProvider, type ReactorState$1 as ReactorState, type ReactorStatus, ReactorView, type ReactorViewProps, type TrackConfig, type VideoTrackOptions, WebcamStream, type WebcamStreamProps, audio, fetchInsecureJwtToken, useReactor, useReactorInternalMessage, useReactorMessage, useReactorStore, useStats, video };
+export { AbortError, type AudioTrackOptions, ConflictError, type ConnectOptions, type ConnectionStats, type ConnectionTimings, DEFAULT_BASE_URL, type MessageScope, type Options, Reactor, type ReactorConnectOptions, ReactorController, type ReactorControllerProps, type ReactorError, type ReactorEvent, ReactorProvider, type ReactorState$1 as ReactorState, type ReactorStatus, ReactorView, type ReactorViewProps, type TrackConfig, type VideoTrackOptions, WebcamStream, type WebcamStreamProps, audio, fetchInsecureToken, isAbortError, useReactor, useReactorInternalMessage, useReactorMessage, useReactorStore, useStats, video };

package/dist/index.d.ts

@@ -89,12 +89,17 @@ interface ReactorError {
     message: string;
     timestamp: number;
     recoverable: boolean;
-    component: "coordinator" | "gpu" | "livekit";
+    component: "api" | "gpu";
     retryAfter?: number;
 }
 declare class ConflictError extends Error {
     constructor(message: string);
 }
+declare class AbortError extends Error {
+    constructor(message: string);
+}
+/** Matches both our custom AbortError and the native DOMException thrown by fetch(). */
+declare function isAbortError(error: unknown): boolean;
 interface ReactorState$1 {
     status: ReactorStatus;
     lastError?: ReactorError;
@@ -106,6 +111,25 @@ interface ConnectOptions {
     /** Maximum number of SDP polling attempts before giving up. Default: 6. */
     maxAttempts?: number;
 }
+/**
+ * One-shot timing breakdown of the connect() handshake, recorded once per
+ * connection and included in every subsequent {@link ConnectionStats} update.
+ * All durations are in milliseconds (from `performance.now()`).
+ */
+interface ConnectionTimings {
+    /** POST /sessions round-trip time */
+    sessionCreationMs: number;
+    /** Total time spent polling for the SDP answer */
+    sdpPollingMs: number;
+    /** Number of SDP poll requests made (1 = answered on first try) */
+    sdpPollingAttempts: number;
+    /** setRemoteDescription → RTCPeerConnection connectionState "connected" */
+    iceNegotiationMs: number;
+    /** setRemoteDescription → RTCDataChannel "open" */
+    dataChannelMs: number;
+    /** End-to-end: connect() invocation → status "ready" */
+    totalMs: number;
+}
 interface ConnectionStats {
     /** ICE candidate-pair round-trip time in milliseconds */
     rtt?: number;
@@ -119,13 +143,15 @@ interface ConnectionStats {
     packetLossRatio?: number;
     /** Network jitter in seconds (from inbound-rtp) */
     jitter?: number;
+    /** Timing breakdown of the initial connection handshake (set once, persisted until disconnect) */
+    connectionTimings?: ConnectionTimings;
     timestamp: number;
 }
 type ReactorEvent = "statusChanged" | "sessionIdChanged" | "message" | "runtimeMessage" | "trackReceived" | "error" | "sessionExpirationChanged" | "statsUpdate";
 
-declare const PROD_COORDINATOR_URL = "https://api.reactor.inc";
+declare const DEFAULT_BASE_URL = "https://api.reactor.inc";
 declare const OptionsSchema: z.ZodObject<{
-    coordinatorUrl: z.ZodDefault<z.ZodString>;
+    apiUrl: z.ZodDefault<z.ZodString>;
     modelName: z.ZodString;
     local: z.ZodDefault<z.ZodBoolean>;
     receive: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -159,6 +185,8 @@ declare class Reactor {
     /** Tracks the client SENDS to the model (client → model). */
     private send;
     private sessionId?;
+    private connectStartTime?;
+    private connectionTimings?;
     constructor(options: Options);
     private eventListeners;
     on(event: ReactorEvent, handler: EventHandler): void;
@@ -200,6 +228,11 @@ declare class Reactor {
     connect(jwtToken?: string, options?: ConnectOptions): Promise<void>;
     /**
      * Sets up event handlers for the machine client.
+     *
+     * Each handler captures the client reference at registration time and
+     * ignores events if this.machineClient has since changed (e.g. after
+     * disconnect + reconnect), preventing stale WebRTC teardown events from
+     * interfering with a new connection.
      */
     private setupMachineClientHandlers;
     /**
@@ -225,6 +258,8 @@ declare class Reactor {
      */
     getLastError(): ReactorError | undefined;
     getStats(): ConnectionStats | undefined;
+    private resetConnectionTimings;
+    private finalizeConnectionTimings;
     /**
      * Create and store an error
      */
@@ -362,9 +397,9 @@ declare function useStats(): ConnectionStats | undefined;
  * In production, call /tokens from your server and pass the JWT to your frontend.
  *
  * @param apiKey - Your Reactor API key (will be exposed in client code!)
- * @param coordinatorUrl - Optional coordinator URL, defaults to production
+ * @param apiUrl - Optional API URL, defaults to production
  * @returns string containing the JWT token
  */
-declare function fetchInsecureJwtToken(apiKey: string, coordinatorUrl?: string): Promise<string>;
+declare function fetchInsecureToken(apiKey: string, apiUrl?: string): Promise<string>;
 
-export { type AudioTrackOptions, ConflictError, type ConnectOptions, type ConnectionStats, type MessageScope, type Options, PROD_COORDINATOR_URL, Reactor, type ReactorConnectOptions, ReactorController, type ReactorControllerProps, type ReactorError, type ReactorEvent, ReactorProvider, type ReactorState$1 as ReactorState, type ReactorStatus, ReactorView, type ReactorViewProps, type TrackConfig, type VideoTrackOptions, WebcamStream, type WebcamStreamProps, audio, fetchInsecureJwtToken, useReactor, useReactorInternalMessage, useReactorMessage, useReactorStore, useStats, video };
+export { AbortError, type AudioTrackOptions, ConflictError, type ConnectOptions, type ConnectionStats, type ConnectionTimings, DEFAULT_BASE_URL, type MessageScope, type Options, Reactor, type ReactorConnectOptions, ReactorController, type ReactorControllerProps, type ReactorError, type ReactorEvent, ReactorProvider, type ReactorState$1 as ReactorState, type ReactorStatus, ReactorView, type ReactorViewProps, type TrackConfig, type VideoTrackOptions, WebcamStream, type WebcamStreamProps, audio, fetchInsecureToken, isAbortError, useReactor, useReactorInternalMessage, useReactorMessage, useReactorStore, useStats, video };