@furious.luke/argus-js 0.3.0 → 0.4.0

package/README.md

@@ -10,7 +10,8 @@ Argus is a distributed video ingestion service. A stream flows through three par
 
 - **Your server** mints a short-lived **join token** using its secret API key (see the [Go client](https://github.com/furious-luke/go-projects/tree/main/argus/client), published as the `github.com/furious-luke/argus-go` module, or the control-plane HTTP API).
 - **The browser** (this library) uses that token to publish video to the nearest Argus media server. It never sees the API key.
-- **Your server** later fetches frames from the stream on demand.
+- **The browser** relays the winning gateway URL and its region-scoped read token
+  back to your server, which uses that pair for frame reads and notifications.
 
 This library is only the browser publishing half. It deliberately does **not** talk to the control plane or mint tokens — that requires your secret API key and must stay server-side.
 
@@ -21,6 +22,7 @@ This library is only the browser publishing half. It deliberately does **not** t
 │ argus-js │  2. token + gateway_urls └────────────┘
 │          │
 │          │  3. publish WebRTC video ────────────────▶ Argus media server
+│          │  4. frameReadToken + selectedGatewayURL ─▶ your server
 └──────────┘
 ```
 
@@ -42,8 +44,24 @@ const publisher = new Publisher({
   gatewayURLs: join.gateway_urls,
   token: join.token,
   callbacks: {
-    onConnected: () => console.log("streaming live"),
+    onConnected: async () => {
+      console.log("streaming live");
+      // Relay these as a pair; the read token is valid in the selected region.
+      await fetch("/api/stream-credentials", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          stream_id: join.stream_id,
+          read_token: publisher.frameReadToken,
+          gateway_url: publisher.selectedGatewayURL,
+        }),
+      });
+    },
     onConnectionStateChange: (state) => console.log("state:", state),
+    onRecoveryStateChange: (event) => console.log("media recovery:", event),
+    // Show a button or prompt. From its click handler, call captureScreen()
+    // and then publisher.replaceStream(newStream).
+    onRecoveryRequired: (event) => console.warn("screen share must be restarted", event),
     onError: (err) => console.error("publish error:", err),
   },
 });
@@ -51,9 +69,6 @@ const publisher = new Publisher({
 // captureCamera() applies sensible capture defaults; any MediaStream works too.
 const stream = await captureCamera();
 await publisher.start(stream);
-
-// After start() resolves, this token lets your server fetch frames for the stream.
-console.log("read token:", publisher.frameReadToken);
 ```
 
 ### Capture helpers
@@ -104,6 +119,7 @@ publisher.stop(); // stops all tracks and tears down the peer connection
 | `replaceStream(stream)` | Replaces the published tracks and renegotiates in place. |
 | `stop()` | Stops all local tracks and closes the peer connection. |
 | `frameReadToken` | The one-hour read token from the gateway's `ready` message, or `null` before connecting. The publisher uses it internally to resume signaling; hand it to your server to fetch frames. |
+| `selectedGatewayURL` | The signaling URL that won the regional race, or `null` before connecting. Relay it with `frameReadToken` so your server uses the same region for frame reads and notifications. |
 | `peerConnection` | The underlying `RTCPeerConnection`, or `null` if not started. |
 | `isConnected` | `true` when the peer connection state is `"connected"`. |
 
@@ -113,6 +129,8 @@ publisher.stop(); // stops all tracks and tears down the peer connection
 | --- | --- |
 | `onConnected()` | The peer connection reached `"connected"` — media is flowing. |
 | `onConnectionStateChange(state)` | The `RTCPeerConnectionState` changed. |
+| `onRecoveryStateChange(event)` | Argus detected stalled media and the publisher started, escalated, completed, or failed automatic recovery. |
+| `onRecoveryRequired(event)` | Automatic recovery could not restore media, or capture ended and the host must ask the user for a new screen share. |
 | `onError(error)` | A fatal error occurred (signaling error, initial gateway failure, or signaling resume timed out). |
 
 ## How `start()` works
@@ -127,6 +145,22 @@ one-hour read token and waits for `resumed`; it does not race regions, rebuild
 the peer connection, or repeat the `ready` handshake. If the retry deadline
 expires, the publisher closes the stream and calls `onError`.
 
+## Automatic media recovery
+
+Argus measures freshness from complete encoded samples received by the media
+server, not from pixel changes. An unchanged screen therefore remains healthy.
+If samples stop for 15 seconds, the media server tells the publisher that the
+track has stalled and stops serving its retained frame as current. The publisher
+first detaches and reattaches the live sender and renegotiates. If samples do not
+resume within four seconds, it performs an ICE restart and waits another eight
+seconds. These fixed timings deliberately are not application configuration.
+
+`onRecoveryStateChange` reports the recovery transitions. If both automatic
+steps fail, `onRecoveryRequired` is called and the host can acquire a replacement
+stream and pass it to `replaceStream`. A browser cannot silently reacquire a
+screen share after the user or operating system ends it, so `capture_ended`
+always requires host UI and a fresh `captureScreen()` call.
+
 ## Browser support
 
 Requires a browser with WebRTC (`RTCPeerConnection`) and `WebSocket` — all current evergreen browsers. There is no Node.js runtime support; this is a browser-only package.

package/dist/index.cjs

@@ -76,6 +76,9 @@ function parseSignal(data) {
 var defaultSignalingReconnectTimeoutMs = 2e4;
 var signalingResumeAttemptTimeoutMs = 3e3;
 var signalingResumeMaxBackoffMs = 3e3;
+var senderRestartPauseMs = 100;
+var senderRecoveryWaitMs = 4e3;
+var iceRecoveryWaitMs = 8e3;
 var Publisher = class {
   opts;
   sig = null;
@@ -84,11 +87,16 @@ var Publisher = class {
   pendingRemoteCandidates = [];
   localStream = null;
   readToken = null;
-  selectedGatewayURL = null;
+  gatewayURL = null;
   stopped = true;
   reconnecting = false;
   reconnectGeneration = 0;
   resumeSocket = null;
+  recoveryGeneration = 0;
+  recoveringMedia = false;
+  recoveryRequired = false;
+  recoveryAction = null;
+  trackEndHandlers = /* @__PURE__ */ new Map();
   constructor(opts) {
     this.opts = opts;
   }
@@ -96,6 +104,14 @@ var Publisher = class {
   get frameReadToken() {
     return this.readToken;
   }
+  /**
+   * The signaling gateway URL that won the initial race, or null before start.
+   * Relay this with frameReadToken so the application server can reach the same
+   * region for frame reads and change-notification subscriptions.
+   */
+  get selectedGatewayURL() {
+    return this.gatewayURL;
+  }
   /**
    * Starts the publisher: races all gateways to find the fastest, completes
    * the two-phase handshake, creates the peer connection, and sends the SDP
@@ -104,9 +120,11 @@ var Publisher = class {
    */
   async start(stream) {
     this.stopped = false;
+    this.recoveryRequired = false;
     this.localStream = stream;
+    this.watchStreamTracks(stream);
     const { ws, readyInfo, gatewayURL } = await this.raceGateways();
-    this.selectedGatewayURL = gatewayURL;
+    this.gatewayURL = gatewayURL;
     if (readyInfo.read_token) {
       this.readToken = readyInfo.read_token;
     }
@@ -149,6 +167,9 @@ var Publisher = class {
   /** Replaces the currently published stream with a new one. */
   async replaceStream(stream) {
     if (!this.pc) throw new Error("publisher not started");
+    this.cancelMediaRecovery();
+    this.recoveryRequired = false;
+    this.unwatchStreamTracks();
     const senders = this.pc.getSenders();
     for (const sender of senders) {
       if (sender.track) {
@@ -159,26 +180,20 @@ var Publisher = class {
       this.pc.addTrack(track, stream);
     }
     this.localStream = stream;
-    const offer = await this.pc.createOffer();
-    await this.pc.setLocalDescription(offer);
-    await this.gatherComplete();
-    const local = this.pc.localDescription;
-    if (!local) throw new Error("local description missing");
-    this.sig?.send({
-      type: "offer",
-      sdp: local.sdp,
-      sdp_type: "offer"
-    });
+    this.watchStreamTracks(stream);
+    await this.renegotiate(false);
   }
   /** Stops publishing and tears down the peer connection. */
   stop() {
     this.stopped = true;
+    this.cancelMediaRecovery();
     this.reconnectGeneration++;
     this.reconnecting = false;
     this.resumeSocket?.close();
     this.resumeSocket = null;
     this.sig?.close();
     this.sig = null;
+    this.unwatchStreamTracks();
     this.localStream?.getTracks().forEach((t) => t.stop());
     this.localStream = null;
     this.pc?.close();
@@ -186,7 +201,7 @@ var Publisher = class {
     this.hasAnswer = false;
     this.pendingRemoteCandidates = [];
     this.readToken = null;
-    this.selectedGatewayURL = null;
+    this.gatewayURL = null;
   }
   /** Returns the current RTCPeerConnection, or null if not started. */
   get peerConnection() {
@@ -266,7 +281,7 @@ var Publisher = class {
   }
   async resumeSignaling() {
     if (this.reconnecting || this.stopped) return;
-    if (!this.selectedGatewayURL || !this.readToken) {
+    if (!this.gatewayURL || !this.readToken) {
       this.terminateWithError(new Error("signaling closed and cannot be resumed"));
       return;
     }
@@ -305,7 +320,7 @@ var Publisher = class {
   }
   openResumeSocket(timeoutMs) {
     return new Promise((resolve, reject) => {
-      const u = new URL(this.selectedGatewayURL);
+      const u = new URL(this.gatewayURL);
       u.searchParams.set("token", this.readToken);
       const ws = new WebSocket(u.toString());
       this.resumeSocket = ws;
@@ -341,6 +356,7 @@ var Publisher = class {
   }
   terminateWithError(err) {
     this.stopped = true;
+    this.cancelMediaRecovery();
     this.reconnectGeneration++;
     this.resumeSocket?.close();
     this.resumeSocket = null;
@@ -348,12 +364,13 @@ var Publisher = class {
     this.sig = null;
     this.pc?.close();
     this.pc = null;
+    this.unwatchStreamTracks();
     this.localStream?.getTracks().forEach((track) => track.stop());
     this.localStream = null;
     this.hasAnswer = false;
     this.pendingRemoteCandidates = [];
     this.readToken = null;
-    this.selectedGatewayURL = null;
+    this.gatewayURL = null;
     this.opts.callbacks?.onError?.(err);
   }
   handleSignal(msg) {
@@ -395,6 +412,15 @@ var Publisher = class {
       case "connection_state": {
         break;
       }
+      case "media_stall":
+      case "media_track_ended": {
+        void this.beginMediaRecovery(msg.track);
+        break;
+      }
+      case "media_resumed": {
+        this.completeMediaRecovery(msg.track);
+        break;
+      }
       case "error": {
         this.opts.callbacks?.onError?.(new Error(msg.error));
         break;
@@ -403,6 +429,107 @@ var Publisher = class {
         break;
     }
   }
+  async beginMediaRecovery(trackType) {
+    if (this.stopped || this.recoveringMedia || this.recoveryRequired) return;
+    const tracks = this.localStream?.getVideoTracks() ?? [];
+    const liveTracks = tracks.filter((track) => track.readyState !== "ended");
+    if (liveTracks.length === 0) {
+      this.failMediaRecovery(trackType, "capture_ended");
+      return;
+    }
+    this.recoveringMedia = true;
+    const generation = ++this.recoveryGeneration;
+    this.recoveryAction = "sender_restart";
+    this.emitRecoveryTransition({ state: "recovering", track: trackType, action: "sender_restart" });
+    this.sendRecoveryDiagnostic("recovery_started", trackType, "sender_restart");
+    await this.restartSenders(liveTracks, generation);
+    if (!this.isCurrentRecovery(generation)) return;
+    await this.wait(senderRecoveryWaitMs);
+    if (!this.isCurrentRecovery(generation)) return;
+    this.recoveryAction = "ice_restart";
+    this.emitRecoveryTransition({ state: "recovering", track: trackType, action: "ice_restart" });
+    this.sendRecoveryDiagnostic("recovery_retry", trackType, "ice_restart");
+    try {
+      await this.renegotiate(true);
+    } catch {
+    }
+    await this.wait(iceRecoveryWaitMs);
+    if (!this.isCurrentRecovery(generation)) return;
+    this.failMediaRecovery(trackType, "automatic_recovery_failed");
+  }
+  async restartSenders(tracks, generation) {
+    const live = new Set(tracks);
+    const senders = this.pc?.getSenders().filter(
+      (sender) => sender.track && live.has(sender.track)
+    ) ?? [];
+    if (senders.length === 0) return;
+    const originals = senders.map((sender) => ({ sender, track: sender.track }));
+    try {
+      await Promise.all(originals.map(({ sender }) => sender.replaceTrack(null)));
+      await this.wait(senderRestartPauseMs);
+      if (!this.isCurrentRecovery(generation)) return;
+      await Promise.all(originals.map(({ sender, track }) => sender.replaceTrack(track)));
+      await this.renegotiate(false);
+    } catch {
+    }
+  }
+  async renegotiate(iceRestart) {
+    const pc = this.pc;
+    const signaling = this.sig;
+    if (!pc || !signaling) throw new Error("publisher signaling is unavailable");
+    if (iceRestart) pc.restartIce?.();
+    const offer = await pc.createOffer(iceRestart ? { iceRestart: true } : void 0);
+    await pc.setLocalDescription(offer);
+    await this.gatherComplete();
+    const local = pc.localDescription;
+    if (!local) throw new Error("local description missing");
+    this.hasAnswer = false;
+    this.pendingRemoteCandidates = [];
+    signaling.send({ type: "offer", sdp: local.sdp, sdp_type: "offer" });
+  }
+  completeMediaRecovery(trackType) {
+    if (!this.recoveringMedia) return;
+    const action = this.recoveryAction ?? void 0;
+    this.cancelMediaRecovery();
+    this.emitRecoveryTransition({ state: "recovered", track: trackType, action });
+  }
+  failMediaRecovery(trackType, reason) {
+    if (this.stopped || this.recoveryRequired) return;
+    this.recoveryRequired = true;
+    const action = this.recoveryAction ?? void 0;
+    this.cancelMediaRecovery();
+    const event = { state: "failed", track: trackType, action, reason };
+    this.emitRecoveryTransition(event);
+    this.opts.callbacks?.onRecoveryRequired?.(event);
+    this.sendRecoveryDiagnostic("recovery_failed", trackType, action, reason);
+  }
+  cancelMediaRecovery() {
+    this.recoveryGeneration++;
+    this.recoveringMedia = false;
+    this.recoveryAction = null;
+  }
+  isCurrentRecovery(generation) {
+    return !this.stopped && this.recoveringMedia && generation === this.recoveryGeneration;
+  }
+  emitRecoveryTransition(event) {
+    this.opts.callbacks?.onRecoveryStateChange?.(event);
+  }
+  sendRecoveryDiagnostic(event, track, action, reason) {
+    this.sig?.send({ type: "recovery_event", event, track, action, reason });
+  }
+  watchStreamTracks(stream) {
+    for (const track of stream.getVideoTracks()) {
+      const handler = () => this.failMediaRecovery("screen", "capture_ended");
+      track.addEventListener("ended", handler);
+      this.trackEndHandlers.set(track, handler);
+    }
+  }
+  unwatchStreamTracks() {
+    for (const [track, handler] of this.trackEndHandlers) {
+      track.removeEventListener("ended", handler);
+    }
+    this.trackEndHandlers.clear();
+  }
   /** Waits for ICE gathering to reach the "complete" state. */
   gatherComplete() {
     return new Promise((resolve) => {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/signaling.ts","../src/publisher.ts","../src/capture.ts"],"sourcesContent":["export { Publisher } from \"./publisher\";\nexport type {\n  SignalMessage,\n  PublisherCallbacks,\n  PublisherOptions,\n  GatewayReadyInfo,\n} from \"./types\";\nexport { captureCamera, captureScreen } from \"./capture\";\nexport type {\n  CaptureCameraOptions,\n  CaptureScreenOptions,\n} from \"./capture\";\n","import type { SignalMessage } from \"./types\";\n\n/**\n * Wraps an open WebSocket to the Argus gateway and handles the JSON message\n * envelope: incoming text frames are parsed into {@link SignalMessage}s and\n * outgoing messages are serialised.\n *\n * This is an internal helper. The {@link Publisher} opens the socket itself\n * (racing all candidate gateways) and hands the winner here, so this class only\n * ever adopts an already-open socket rather than dialing one.\n *\n * @internal\n */\nexport class SignalingChannel {\n  private ws: WebSocket;\n\n  /** Fired for every incoming JSON message. */\n  onMessage: ((msg: SignalMessage) => void) | null = null;\n  /** Fired when the underlying WebSocket closes. */\n  onClose: (() => void) | null = null;\n  /** Fired when an error occurs on the WebSocket. */\n  onError: ((err: Error) => void) | null = null;\n\n  private constructor(ws: WebSocket) {\n    this.ws = ws;\n  }\n\n  /**\n   * Adopts an already-open WebSocket (e.g. the winner of a gateway race),\n   * routing its events through the channel's callbacks. Any handlers previously\n   * attached to the socket are replaced.\n   */\n  static wrap(ws: WebSocket): SignalingChannel {\n    const ch = new SignalingChannel(ws);\n    ws.onmessage = (ev: MessageEvent) => {\n      const msg = parseSignal(ev.data);\n      if (msg) ch.onMessage?.(msg);\n    };\n    ws.onerror = () => ch.onError?.(new Error(\"WebSocket error\"));\n    ws.onclose = () => ch.onClose?.();\n    return ch;\n  }\n\n  /** Sends a JSON message if the socket is open; a no-op otherwise. */\n  send(msg: SignalMessage): void {\n    if (this.ws.readyState === WebSocket.OPEN) {\n      this.ws.send(JSON.stringify(msg));\n    }\n  }\n\n  /** Closes the underlying WebSocket. */\n  close(): void {\n    this.ws.close();\n  }\n}\n\n/** Parses a WebSocket text frame into a SignalMessage, or null if malformed. */\nfunction parseSignal(data: unknown): SignalMessage | null {\n  try {\n    return JSON.parse(data as string) as SignalMessage;\n  } catch {\n    return null;\n  }\n}\n","import { SignalingChannel } from \"./signaling\";\nimport type { GatewayReadyInfo, PublisherOptions, SignalMessage } from \"./types\";\n\nconst defaultSignalingReconnectTimeoutMs = 20_000;\nconst signalingResumeAttemptTimeoutMs = 3_000;\nconst signalingResumeMaxBackoffMs = 3_000;\n\n/**\n * Publisher streams a browser {@link MediaStream} to an Argus media server over\n * WebRTC. Given the `gateway_urls` and `token` from a join-token response, it\n * races the candidate gateways to the fastest one, completes the two-phase\n * signaling handshake, and manages the peer connection — offer/answer exchange,\n * ICE candidate trickling, and track (re)negotiation.\n *\n * After {@link Publisher.start} resolves, {@link Publisher.frameReadToken} holds\n * the token your application server needs to fetch frames for this stream.\n *\n * @example Publish the default camera:\n * ```ts\n * const pub = new Publisher({\n *   gatewayURLs: joinResp.gateway_urls,\n *   token: joinResp.token,\n *   callbacks: { onConnected: () => console.log(\"live!\") },\n * });\n *\n * const stream = await navigator.mediaDevices.getUserMedia({ video: true });\n * await pub.start(stream);\n * ```\n */\nexport class Publisher {\n  private opts: PublisherOptions;\n  private sig: SignalingChannel | null = null;\n  private pc: RTCPeerConnection | null = null;\n  private hasAnswer = false;\n  private pendingRemoteCandidates: RTCIceCandidateInit[] = [];\n  private localStream: MediaStream | null = null;\n  private readToken: string | null = null;\n  private selectedGatewayURL: string | null = null;\n  private stopped = true;\n  private reconnecting = false;\n  private reconnectGeneration = 0;\n  private resumeSocket: WebSocket | null = null;\n\n  constructor(opts: PublisherOptions) {\n    this.opts = opts;\n  }\n\n  /** The read token used for frame fetches and signaling resume in the selected region. */\n  get frameReadToken(): string | null { return this.readToken; }\n\n  /**\n   * Starts the publisher: races all gateways to find the fastest, completes\n   * the two-phase handshake, creates the peer connection, and sends the SDP\n   * offer. Resolves when the offer has been sent (not when ICE completes —\n   * use onConnected for that).\n   */\n  async start(stream: MediaStream): Promise<void> {\n    this.stopped = false;\n    this.localStream = stream;\n\n    // Race all gateways; returns winning WebSocket + TURN/read-token info\n    const { ws, readyInfo, gatewayURL } = await this.raceGateways();\n    this.selectedGatewayURL = gatewayURL;\n\n    // Store read token for caller\n    if (readyInfo.read_token) {\n      this.readToken = readyInfo.read_token;\n    }\n\n    // Build ICE servers: extra servers from opts + TURN from gateway. The\n    // gateway supplies multi-transport turn_urls (UDP + TCP) so relay can fall\n    // back to TCP on UDP-blocking networks. A single credential is valid for\n    // every transport.\n    const iceServers: RTCIceServer[] = [...(this.opts.iceServers ?? [])];\n    if (readyInfo.turn_urls && readyInfo.turn_urls.length > 0) {\n      iceServers.push({\n        urls: readyInfo.turn_urls,\n        username: readyInfo.turn_username,\n        credential: readyInfo.turn_credential,\n      });\n    }\n\n    this.pc = new RTCPeerConnection({ iceServers });\n\n    this.pc.onicecandidate = (ev) => {\n      if (!ev.candidate || !this.sig) return;\n      const c = ev.candidate;\n      this.sig.send({\n        type: \"ice_candidate\",\n        candidate: c.candidate,\n        sdp_mid: c.sdpMid ?? undefined,\n        sdp_mline_index: c.sdpMLineIndex ?? undefined,\n        username_fragment: c.usernameFragment ?? undefined,\n      });\n    };\n\n    this.pc.onconnectionstatechange = () => {\n      const state = this.pc?.connectionState;\n      if (state) this.opts.callbacks?.onConnectionStateChange?.(state);\n      if (state === \"connected\") this.opts.callbacks?.onConnected?.();\n    };\n\n    for (const track of stream.getTracks()) {\n      this.pc.addTrack(track, stream);\n    }\n\n    const offer = await this.pc.createOffer();\n    await this.pc.setLocalDescription(offer);\n    await this.gatherComplete();\n\n    // Wrap winning WebSocket in SignalingChannel\n    const signaling = this.installSignaling(ws);\n\n    const local = this.pc.localDescription;\n    if (!local) throw new Error(\"local description missing after gather\");\n    signaling.send({ type: \"offer\", sdp: local.sdp, sdp_type: \"offer\" });\n  }\n\n  /** Replaces the currently published stream with a new one. */\n  async replaceStream(stream: MediaStream): Promise<void> {\n    if (!this.pc) throw new Error(\"publisher not started\");\n\n    // Remove old tracks.\n    const senders = this.pc.getSenders();\n    for (const sender of senders) {\n      if (sender.track) {\n        this.pc.removeTrack(sender);\n      }\n    }\n\n    // Add new tracks.\n    for (const track of stream.getTracks()) {\n      this.pc.addTrack(track, stream);\n    }\n    this.localStream = stream;\n\n    // Renegotiate.\n    const offer = await this.pc.createOffer();\n    await this.pc.setLocalDescription(offer);\n    await this.gatherComplete();\n\n    const local = this.pc.localDescription;\n    if (!local) throw new Error(\"local description missing\");\n    this.sig?.send({\n      type: \"offer\",\n      sdp: local.sdp,\n      sdp_type: \"offer\",\n    });\n  }\n\n  /** Stops publishing and tears down the peer connection. */\n  stop(): void {\n    this.stopped = true;\n    this.reconnectGeneration++;\n    this.reconnecting = false;\n    this.resumeSocket?.close();\n    this.resumeSocket = null;\n    this.sig?.close();\n    this.sig = null;\n\n    this.localStream?.getTracks().forEach((t) => t.stop());\n    this.localStream = null;\n\n    this.pc?.close();\n    this.pc = null;\n    this.hasAnswer = false;\n    this.pendingRemoteCandidates = [];\n    this.readToken = null;\n    this.selectedGatewayURL = null;\n  }\n\n  /** Returns the current RTCPeerConnection, or null if not started. */\n  get peerConnection(): RTCPeerConnection | null {\n    return this.pc;\n  }\n\n  /** Returns true if the peer connection is in the \"connected\" state. */\n  get isConnected(): boolean {\n    return this.pc?.connectionState === \"connected\";\n  }\n\n  // -------------------------------------------------------------------------\n  // Private helpers\n  // -------------------------------------------------------------------------\n\n  private raceGateways(): Promise<{ ws: WebSocket; readyInfo: GatewayReadyInfo; gatewayURL: string }> {\n    return new Promise((resolve, reject) => {\n      const { gatewayURLs, token } = this.opts;\n      if (gatewayURLs.length === 0) {\n        reject(new Error(\"no gateway URLs provided\"));\n        return;\n      }\n\n      const sockets: WebSocket[] = [];\n      let settled = false;\n\n      const closeAll = (except?: WebSocket) => {\n        for (const s of sockets) {\n          if (s !== except) {\n            s.onmessage = null;\n            s.onerror = null;\n            s.onclose = null;\n            s.close();\n          }\n        }\n      };\n\n      const checkAllFailed = () => {\n        if (settled) return;\n        if (sockets.every(s => s.readyState === WebSocket.CLOSED || s.readyState === WebSocket.CLOSING)) {\n          settled = true;\n          reject(new Error(\"all gateways failed to connect\"));\n        }\n      };\n\n      for (const gatewayURL of gatewayURLs) {\n        const u = new URL(gatewayURL);\n        u.searchParams.set(\"token\", token);\n        const ws = new WebSocket(u.toString());\n        sockets.push(ws);\n\n        let accepted = false;\n\n        ws.onmessage = (ev: MessageEvent) => {\n          if (settled) return;\n          try {\n            const msg = JSON.parse(ev.data as string);\n            if (!accepted && msg.type === \"accepted\") {\n              accepted = true;\n              ws.send(JSON.stringify({ type: \"proceed\" }));\n            } else if (accepted && msg.type === \"ready\") {\n              settled = true;\n              closeAll(ws);\n              resolve({ ws, readyInfo: msg as GatewayReadyInfo, gatewayURL });\n            }\n          } catch {\n            /* ignore malformed */\n          }\n        };\n\n        ws.onerror = () => checkAllFailed();\n        ws.onclose = () => checkAllFailed();\n      }\n    });\n  }\n\n  private installSignaling(ws: WebSocket): SignalingChannel {\n    const channel = SignalingChannel.wrap(ws);\n    this.sig = channel;\n    channel.onMessage = (msg) => this.handleSignal(msg);\n    channel.onClose = () => {\n      if (this.sig !== channel || this.stopped) return;\n      this.sig = null;\n      void this.resumeSignaling();\n    };\n    // Browsers normally follow an error event with close. Recovery begins from\n    // close so a single transport failure cannot start two retry loops.\n    channel.onError = () => {};\n    return channel;\n  }\n\n  private async resumeSignaling(): Promise<void> {\n    if (this.reconnecting || this.stopped) return;\n    if (!this.selectedGatewayURL || !this.readToken) {\n      this.terminateWithError(new Error(\"signaling closed and cannot be resumed\"));\n      return;\n    }\n\n    this.reconnecting = true;\n    const generation = ++this.reconnectGeneration;\n    const timeout = this.opts.signalingReconnectTimeoutMs ?? defaultSignalingReconnectTimeoutMs;\n    const deadline = Date.now() + Math.max(0, timeout);\n    let backoffMs = 0;\n\n    while (!this.stopped && generation === this.reconnectGeneration && Date.now() <= deadline) {\n      if (backoffMs > 0) {\n        const waitMs = Math.min(backoffMs, Math.max(0, deadline - Date.now()));\n        if (waitMs === 0) break;\n        await this.wait(waitMs);\n        if (this.stopped || generation !== this.reconnectGeneration) return;\n      }\n\n      const remaining = deadline - Date.now();\n      if (remaining < 0) break;\n      try {\n        const ws = await this.openResumeSocket(Math.min(signalingResumeAttemptTimeoutMs, Math.max(1, remaining)));\n        if (this.stopped || generation !== this.reconnectGeneration) {\n          ws.close();\n          return;\n        }\n        this.resumeSocket = null;\n        this.reconnecting = false;\n        this.installSignaling(ws);\n        return;\n      } catch {\n        backoffMs = backoffMs === 0 ? 250 : Math.min(backoffMs * 2, signalingResumeMaxBackoffMs);\n      }\n    }\n\n    if (!this.stopped && generation === this.reconnectGeneration) {\n      this.reconnecting = false;\n      this.terminateWithError(new Error(\"unable to resume signaling with the selected gateway\"));\n    }\n  }\n\n  private openResumeSocket(timeoutMs: number): Promise<WebSocket> {\n    return new Promise((resolve, reject) => {\n      const u = new URL(this.selectedGatewayURL!);\n      u.searchParams.set(\"token\", this.readToken!);\n      const ws = new WebSocket(u.toString());\n      this.resumeSocket = ws;\n      let settled = false;\n      const timer = setTimeout(() => fail(), timeoutMs);\n\n      const fail = () => {\n        if (settled) return;\n        settled = true;\n        clearTimeout(timer);\n        if (this.resumeSocket === ws) this.resumeSocket = null;\n        ws.onmessage = null;\n        ws.onerror = null;\n        ws.onclose = null;\n        ws.close();\n        reject(new Error(\"signaling resume attempt failed\"));\n      };\n\n      ws.onmessage = (ev: MessageEvent) => {\n        try {\n          const msg = JSON.parse(ev.data as string);\n          if (msg.type !== \"resumed\" || settled) return;\n          settled = true;\n          clearTimeout(timer);\n          resolve(ws);\n        } catch {\n          // Ignore malformed messages while waiting for the resume acknowledgement.\n        }\n      };\n      ws.onerror = fail;\n      ws.onclose = fail;\n    });\n  }\n\n  private wait(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n\n  private terminateWithError(err: Error): void {\n    this.stopped = true;\n    this.reconnectGeneration++;\n    this.resumeSocket?.close();\n    this.resumeSocket = null;\n    this.sig?.close();\n    this.sig = null;\n    this.pc?.close();\n    this.pc = null;\n    this.localStream?.getTracks().forEach((track) => track.stop());\n    this.localStream = null;\n    this.hasAnswer = false;\n    this.pendingRemoteCandidates = [];\n    this.readToken = null;\n    this.selectedGatewayURL = null;\n    this.opts.callbacks?.onError?.(err);\n  }\n\n  private handleSignal(msg: SignalMessage): void {\n    switch (msg.type) {\n      case \"answer\": {\n        if (!this.pc) return;\n        this.pc\n          .setRemoteDescription(\n            new RTCSessionDescription({ type: \"answer\", sdp: msg.sdp }),\n          )\n          .then(() => {\n            this.hasAnswer = true;\n            // Flush any ICE candidates that arrived before the answer.\n            for (const init of this.pendingRemoteCandidates) {\n              this.pc?.addIceCandidate(init).catch(() => {\n                /* ignore stale candidates */\n              });\n            }\n            this.pendingRemoteCandidates = [];\n          })\n          .catch((err) => {\n            this.opts.callbacks?.onError?.(\n              new Error(`failed to set remote description: ${err}`),\n            );\n          });\n        break;\n      }\n\n      case \"ice_candidate\": {\n        if (!this.pc) return;\n        const init: RTCIceCandidateInit = {\n          candidate: msg.candidate,\n          sdpMid: msg.sdp_mid ?? null,\n          sdpMLineIndex: msg.sdp_mline_index ?? null,\n          usernameFragment: msg.username_fragment ?? null,\n        };\n        if (this.hasAnswer) {\n          this.pc.addIceCandidate(init).catch(() => {\n            /* ignore stale candidates */\n          });\n        } else {\n          this.pendingRemoteCandidates.push(init);\n        }\n        break;\n      }\n\n      case \"connection_state\": {\n        // The server echoes the peer connection state; the onconnectionstatechange\n        // handler above already covers this, but callers can also react via\n        // onConnectionStateChange.\n        break;\n      }\n\n      case \"error\": {\n        this.opts.callbacks?.onError?.(new Error(msg.error));\n        break;\n      }\n\n      case \"resumed\":\n        break;\n    }\n  }\n\n  /** Waits for ICE gathering to reach the \"complete\" state. */\n  private gatherComplete(): Promise<void> {\n    return new Promise((resolve) => {\n      const pc = this.pc;\n      if (!pc) {\n        resolve();\n        return;\n      }\n      if (pc.iceGatheringState === \"complete\") {\n        resolve();\n        return;\n      }\n      const handler = () => {\n        if (pc.iceGatheringState === \"complete\") {\n          pc.removeEventListener(\"icegatheringstatechange\", handler);\n          resolve();\n        }\n      };\n      pc.addEventListener(\"icegatheringstatechange\", handler);\n    });\n  }\n}\n","/**\n * Options for {@link captureCamera}.\n *\n * These are merged shallowly over the library defaults: any field you provide\n * replaces the default for that field entirely (e.g. passing `video` overrides\n * the default video constraints rather than merging into them). Omit a field to\n * keep its default.\n */\nexport interface CaptureCameraOptions {\n  /**\n   * Video constraints, or `true`/`false`. Defaults to a modest resolution and\n   * frame rate (see {@link captureCamera}). Set `false` to disable video.\n   */\n  video?: MediaTrackConstraints | boolean;\n  /**\n   * Audio constraints, or `true`/`false`. Defaults to `false` — Argus is a\n   * video-frame streaming system, so audio is off unless you ask for it.\n   */\n  audio?: MediaTrackConstraints | boolean;\n  /**\n   * The `MediaDevices` instance to capture from. Defaults to the global\n   * `navigator.mediaDevices`. Pass another window's `navigator.mediaDevices`\n   * (e.g. a Document Picture-in-Picture window's) so the browser's permission\n   * prompt and transient-activation check are anchored to that window rather\n   * than the one holding the global `navigator`.\n   */\n  mediaDevices?: MediaDevices;\n}\n\n/**\n * Options for {@link captureScreen}.\n *\n * These are merged shallowly over the library defaults: any field you provide\n * replaces the default for that field entirely. Omit a field to keep its\n * default.\n */\nexport interface CaptureScreenOptions {\n  /**\n   * Video constraints, or `true`. Defaults to a capped width and a low frame\n   * rate (see {@link captureScreen}).\n   */\n  video?: MediaTrackConstraints | boolean;\n  /**\n   * Audio constraints, or `true`/`false`. Defaults to `false` — screen shares\n   * rarely need audio for a video-frame streaming system.\n   */\n  audio?: MediaTrackConstraints | boolean;\n  /**\n   * The `MediaDevices` instance to capture from. Defaults to the global\n   * `navigator.mediaDevices`. Pass another window's `navigator.mediaDevices`\n   * (e.g. a Document Picture-in-Picture window's) so the screen picker and its\n   * transient-activation check are anchored to that window rather than the one\n   * holding the global `navigator`.\n   */\n  mediaDevices?: MediaDevices;\n}\n\n/**\n * Captures the user's camera via `navigator.mediaDevices.getUserMedia`,\n * applying sensible defaults for a video-frame streaming system.\n *\n * Defaults:\n * - `video`: `{ width: { ideal: 1280 }, height: { ideal: 720 }, frameRate: { ideal: 30 } }`\n *   — a modest resolution that keeps upload bandwidth reasonable. Cameras are\n *   rarely the 4k bandwidth problem that screen capture is, so this is an\n *   `ideal` (a hint) rather than a hard cap.\n * - `audio`: `false` — this is a video-frame streaming system.\n *\n * Any option you pass replaces the corresponding default outright (shallow\n * merge), so pass a full `video` constraints object if you want to tweak it.\n *\n * @example\n * ```ts\n * const stream = await captureCamera();\n * await publisher.start(stream);\n * ```\n *\n * @example Front camera with audio:\n * ```ts\n * const stream = await captureCamera({\n *   video: { facingMode: \"user\" },\n *   audio: true,\n * });\n * ```\n */\nexport async function captureCamera(\n  opts: CaptureCameraOptions = {},\n): Promise<MediaStream> {\n  const constraints: MediaStreamConstraints = {\n    video: opts.video ?? {\n      width: { ideal: 1280 },\n      height: { ideal: 720 },\n      frameRate: { ideal: 30 },\n    },\n    audio: opts.audio ?? false,\n  };\n  const mediaDevices = opts.mediaDevices ?? navigator.mediaDevices;\n  return mediaDevices.getUserMedia(constraints);\n}\n\n/**\n * Captures a screen / window / tab via\n * `navigator.mediaDevices.getDisplayMedia`, applying sensible defaults tuned to\n * avoid the HiDPI/Retina bandwidth trap.\n *\n * Defaults:\n * - `video`: `{ width: { max: 1920 }, frameRate: { ideal: 5, max: 10 } }`.\n *   The `width` is a **`max`, not an `ideal`**: on a 2x-Retina display the\n *   browser would otherwise capture at native resolution (often 3456px+ /\n *   effectively 4k), wasting upload bandwidth and downstream decode cost for no\n *   visible benefit. Capping the max roughly halves a 2x-Retina share while\n *   leaving smaller displays untouched. Screen content is mostly static, so the\n *   low frame rate saves further bandwidth.\n * - `audio`: `false`.\n *\n * IMPORTANT — do NOT add `resizeMode: \"none\"` here. That value forbids the\n * browser from downscaling the source, which turns the `width: { max: 1920 }`\n * cap into a no-op on exactly the Retina displays it targets. By omitting\n * `resizeMode` we let the user agent scale to satisfy the constraint (its\n * default behaviour), which is the entire point of this helper. It is tempting\n * to add `resizeMode: \"none\"` back for \"sharpness\" — don't.\n *\n * Any option you pass replaces the corresponding default outright (shallow\n * merge), so pass a full `video` constraints object if you want to tweak it.\n *\n * @example\n * ```ts\n * const stream = await captureScreen();\n * await publisher.start(stream);\n * ```\n */\nexport async function captureScreen(\n  opts: CaptureScreenOptions = {},\n): Promise<MediaStream> {\n  const constraints: MediaStreamConstraints = {\n    video: opts.video ?? {\n      width: { max: 1920 },\n      frameRate: { ideal: 5, max: 10 },\n    },\n    audio: opts.audio ?? false,\n  };\n  const mediaDevices = opts.mediaDevices ?? navigator.mediaDevices;\n  return mediaDevices.getDisplayMedia(constraints);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/signaling.ts","../src/publisher.ts","../src/capture.ts"],"sourcesContent":["export { Publisher } from \"./publisher\";\nexport type {\n  SignalMessage,\n  PublisherCallbacks,\n  PublisherOptions,\n  GatewayReadyInfo,\n  PublisherRecoveryEvent,\n  PublisherRecoveryState,\n  PublisherRecoveryAction,\n  PublisherRecoveryFailureReason,\n} from \"./types\";\nexport { captureCamera, captureScreen } from \"./capture\";\nexport type {\n  CaptureCameraOptions,\n  CaptureScreenOptions,\n} from \"./capture\";\n","import type { SignalMessage } from \"./types\";\n\n/**\n * Wraps an open WebSocket to the Argus gateway and handles the JSON message\n * envelope: incoming text frames are parsed into {@link SignalMessage}s and\n * outgoing messages are serialised.\n *\n * This is an internal helper. The {@link Publisher} opens the socket itself\n * (racing all candidate gateways) and hands the winner here, so this class only\n * ever adopts an already-open socket rather than dialing one.\n *\n * @internal\n */\nexport class SignalingChannel {\n  private ws: WebSocket;\n\n  /** Fired for every incoming JSON message. */\n  onMessage: ((msg: SignalMessage) => void) | null = null;\n  /** Fired when the underlying WebSocket closes. */\n  onClose: (() => void) | null = null;\n  /** Fired when an error occurs on the WebSocket. */\n  onError: ((err: Error) => void) | null = null;\n\n  private constructor(ws: WebSocket) {\n    this.ws = ws;\n  }\n\n  /**\n   * Adopts an already-open WebSocket (e.g. the winner of a gateway race),\n   * routing its events through the channel's callbacks. Any handlers previously\n   * attached to the socket are replaced.\n   */\n  static wrap(ws: WebSocket): SignalingChannel {\n    const ch = new SignalingChannel(ws);\n    ws.onmessage = (ev: MessageEvent) => {\n      const msg = parseSignal(ev.data);\n      if (msg) ch.onMessage?.(msg);\n    };\n    ws.onerror = () => ch.onError?.(new Error(\"WebSocket error\"));\n    ws.onclose = () => ch.onClose?.();\n    return ch;\n  }\n\n  /** Sends a JSON message if the socket is open; a no-op otherwise. */\n  send(msg: SignalMessage): void {\n    if (this.ws.readyState === WebSocket.OPEN) {\n      this.ws.send(JSON.stringify(msg));\n    }\n  }\n\n  /** Closes the underlying WebSocket. */\n  close(): void {\n    this.ws.close();\n  }\n}\n\n/** Parses a WebSocket text frame into a SignalMessage, or null if malformed. */\nfunction parseSignal(data: unknown): SignalMessage | null {\n  try {\n    return JSON.parse(data as string) as SignalMessage;\n  } catch {\n    return null;\n  }\n}\n","import { SignalingChannel } from \"./signaling\";\nimport type {\n  GatewayReadyInfo,\n  PublisherOptions,\n  PublisherRecoveryAction,\n  PublisherRecoveryEvent,\n  SignalMessage,\n} from \"./types\";\n\nconst defaultSignalingReconnectTimeoutMs = 20_000;\nconst signalingResumeAttemptTimeoutMs = 3_000;\nconst signalingResumeMaxBackoffMs = 3_000;\nconst senderRestartPauseMs = 100;\nconst senderRecoveryWaitMs = 4_000;\nconst iceRecoveryWaitMs = 8_000;\n\n/**\n * Publisher streams a browser {@link MediaStream} to an Argus media server over\n * WebRTC. Given the `gateway_urls` and `token` from a join-token response, it\n * races the candidate gateways to the fastest one, completes the two-phase\n * signaling handshake, and manages the peer connection — offer/answer exchange,\n * ICE candidate trickling, and track (re)negotiation.\n *\n * After {@link Publisher.start} resolves, {@link Publisher.frameReadToken} holds\n * the token your application server needs to fetch frames for this stream.\n *\n * @example Publish the default camera:\n * ```ts\n * const pub = new Publisher({\n *   gatewayURLs: joinResp.gateway_urls,\n *   token: joinResp.token,\n *   callbacks: { onConnected: () => console.log(\"live!\") },\n * });\n *\n * const stream = await navigator.mediaDevices.getUserMedia({ video: true });\n * await pub.start(stream);\n * ```\n */\nexport class Publisher {\n  private opts: PublisherOptions;\n  private sig: SignalingChannel | null = null;\n  private pc: RTCPeerConnection | null = null;\n  private hasAnswer = false;\n  private pendingRemoteCandidates: RTCIceCandidateInit[] = [];\n  private localStream: MediaStream | null = null;\n  private readToken: string | null = null;\n  private gatewayURL: string | null = null;\n  private stopped = true;\n  private reconnecting = false;\n  private reconnectGeneration = 0;\n  private resumeSocket: WebSocket | null = null;\n  private recoveryGeneration = 0;\n  private recoveringMedia = false;\n  private recoveryRequired = false;\n  private recoveryAction: PublisherRecoveryAction | null = null;\n  private trackEndHandlers = new Map<MediaStreamTrack, EventListener>();\n\n  constructor(opts: PublisherOptions) {\n    this.opts = opts;\n  }\n\n  /** The read token used for frame fetches and signaling resume in the selected region. */\n  get frameReadToken(): string | null { return this.readToken; }\n\n  /**\n   * The signaling gateway URL that won the initial race, or null before start.\n   * Relay this with frameReadToken so the application server can reach the same\n   * region for frame reads and change-notification subscriptions.\n   */\n  get selectedGatewayURL(): string | null { return this.gatewayURL; }\n\n  /**\n   * Starts the publisher: races all gateways to find the fastest, completes\n   * the two-phase handshake, creates the peer connection, and sends the SDP\n   * offer. Resolves when the offer has been sent (not when ICE completes —\n   * use onConnected for that).\n   */\n  async start(stream: MediaStream): Promise<void> {\n    this.stopped = false;\n    this.recoveryRequired = false;\n    this.localStream = stream;\n    this.watchStreamTracks(stream);\n\n    // Race all gateways; returns winning WebSocket + TURN/read-token info\n    const { ws, readyInfo, gatewayURL } = await this.raceGateways();\n    this.gatewayURL = gatewayURL;\n\n    // Store read token for caller\n    if (readyInfo.read_token) {\n      this.readToken = readyInfo.read_token;\n    }\n\n    // Build ICE servers: extra servers from opts + TURN from gateway. The\n    // gateway supplies multi-transport turn_urls (UDP + TCP) so relay can fall\n    // back to TCP on UDP-blocking networks. A single credential is valid for\n    // every transport.\n    const iceServers: RTCIceServer[] = [...(this.opts.iceServers ?? [])];\n    if (readyInfo.turn_urls && readyInfo.turn_urls.length > 0) {\n      iceServers.push({\n        urls: readyInfo.turn_urls,\n        username: readyInfo.turn_username,\n        credential: readyInfo.turn_credential,\n      });\n    }\n\n    this.pc = new RTCPeerConnection({ iceServers });\n\n    this.pc.onicecandidate = (ev) => {\n      if (!ev.candidate || !this.sig) return;\n      const c = ev.candidate;\n      this.sig.send({\n        type: \"ice_candidate\",\n        candidate: c.candidate,\n        sdp_mid: c.sdpMid ?? undefined,\n        sdp_mline_index: c.sdpMLineIndex ?? undefined,\n        username_fragment: c.usernameFragment ?? undefined,\n      });\n    };\n\n    this.pc.onconnectionstatechange = () => {\n      const state = this.pc?.connectionState;\n      if (state) this.opts.callbacks?.onConnectionStateChange?.(state);\n      if (state === \"connected\") this.opts.callbacks?.onConnected?.();\n    };\n\n    for (const track of stream.getTracks()) {\n      this.pc.addTrack(track, stream);\n    }\n\n    const offer = await this.pc.createOffer();\n    await this.pc.setLocalDescription(offer);\n    await this.gatherComplete();\n\n    // Wrap winning WebSocket in SignalingChannel\n    const signaling = this.installSignaling(ws);\n\n    const local = this.pc.localDescription;\n    if (!local) throw new Error(\"local description missing after gather\");\n    signaling.send({ type: \"offer\", sdp: local.sdp, sdp_type: \"offer\" });\n  }\n\n  /** Replaces the currently published stream with a new one. */\n  async replaceStream(stream: MediaStream): Promise<void> {\n    if (!this.pc) throw new Error(\"publisher not started\");\n\n    this.cancelMediaRecovery();\n    this.recoveryRequired = false;\n    this.unwatchStreamTracks();\n\n    // Remove old tracks.\n    const senders = this.pc.getSenders();\n    for (const sender of senders) {\n      if (sender.track) {\n        this.pc.removeTrack(sender);\n      }\n    }\n\n    // Add new tracks.\n    for (const track of stream.getTracks()) {\n      this.pc.addTrack(track, stream);\n    }\n    this.localStream = stream;\n    this.watchStreamTracks(stream);\n\n    await this.renegotiate(false);\n  }\n\n  /** Stops publishing and tears down the peer connection. */\n  stop(): void {\n    this.stopped = true;\n    this.cancelMediaRecovery();\n    this.reconnectGeneration++;\n    this.reconnecting = false;\n    this.resumeSocket?.close();\n    this.resumeSocket = null;\n    this.sig?.close();\n    this.sig = null;\n\n    this.unwatchStreamTracks();\n    this.localStream?.getTracks().forEach((t) => t.stop());\n    this.localStream = null;\n\n    this.pc?.close();\n    this.pc = null;\n    this.hasAnswer = false;\n    this.pendingRemoteCandidates = [];\n    this.readToken = null;\n    this.gatewayURL = null;\n  }\n\n  /** Returns the current RTCPeerConnection, or null if not started. */\n  get peerConnection(): RTCPeerConnection | null {\n    return this.pc;\n  }\n\n  /** Returns true if the peer connection is in the \"connected\" state. */\n  get isConnected(): boolean {\n    return this.pc?.connectionState === \"connected\";\n  }\n\n  // -------------------------------------------------------------------------\n  // Private helpers\n  // -------------------------------------------------------------------------\n\n  private raceGateways(): Promise<{ ws: WebSocket; readyInfo: GatewayReadyInfo; gatewayURL: string }> {\n    return new Promise((resolve, reject) => {\n      const { gatewayURLs, token } = this.opts;\n      if (gatewayURLs.length === 0) {\n        reject(new Error(\"no gateway URLs provided\"));\n        return;\n      }\n\n      const sockets: WebSocket[] = [];\n      let settled = false;\n\n      const closeAll = (except?: WebSocket) => {\n        for (const s of sockets) {\n          if (s !== except) {\n            s.onmessage = null;\n            s.onerror = null;\n            s.onclose = null;\n            s.close();\n          }\n        }\n      };\n\n      const checkAllFailed = () => {\n        if (settled) return;\n        if (sockets.every(s => s.readyState === WebSocket.CLOSED || s.readyState === WebSocket.CLOSING)) {\n          settled = true;\n          reject(new Error(\"all gateways failed to connect\"));\n        }\n      };\n\n      for (const gatewayURL of gatewayURLs) {\n        const u = new URL(gatewayURL);\n        u.searchParams.set(\"token\", token);\n        const ws = new WebSocket(u.toString());\n        sockets.push(ws);\n\n        let accepted = false;\n\n        ws.onmessage = (ev: MessageEvent) => {\n          if (settled) return;\n          try {\n            const msg = JSON.parse(ev.data as string);\n            if (!accepted && msg.type === \"accepted\") {\n              accepted = true;\n              ws.send(JSON.stringify({ type: \"proceed\" }));\n            } else if (accepted && msg.type === \"ready\") {\n              settled = true;\n              closeAll(ws);\n              resolve({ ws, readyInfo: msg as GatewayReadyInfo, gatewayURL });\n            }\n          } catch {\n            /* ignore malformed */\n          }\n        };\n\n        ws.onerror = () => checkAllFailed();\n        ws.onclose = () => checkAllFailed();\n      }\n    });\n  }\n\n  private installSignaling(ws: WebSocket): SignalingChannel {\n    const channel = SignalingChannel.wrap(ws);\n    this.sig = channel;\n    channel.onMessage = (msg) => this.handleSignal(msg);\n    channel.onClose = () => {\n      if (this.sig !== channel || this.stopped) return;\n      this.sig = null;\n      void this.resumeSignaling();\n    };\n    // Browsers normally follow an error event with close. Recovery begins from\n    // close so a single transport failure cannot start two retry loops.\n    channel.onError = () => {};\n    return channel;\n  }\n\n  private async resumeSignaling(): Promise<void> {\n    if (this.reconnecting || this.stopped) return;\n    if (!this.gatewayURL || !this.readToken) {\n      this.terminateWithError(new Error(\"signaling closed and cannot be resumed\"));\n      return;\n    }\n\n    this.reconnecting = true;\n    const generation = ++this.reconnectGeneration;\n    const timeout = this.opts.signalingReconnectTimeoutMs ?? defaultSignalingReconnectTimeoutMs;\n    const deadline = Date.now() + Math.max(0, timeout);\n    let backoffMs = 0;\n\n    while (!this.stopped && generation === this.reconnectGeneration && Date.now() <= deadline) {\n      if (backoffMs > 0) {\n        const waitMs = Math.min(backoffMs, Math.max(0, deadline - Date.now()));\n        if (waitMs === 0) break;\n        await this.wait(waitMs);\n        if (this.stopped || generation !== this.reconnectGeneration) return;\n      }\n\n      const remaining = deadline - Date.now();\n      if (remaining < 0) break;\n      try {\n        const ws = await this.openResumeSocket(Math.min(signalingResumeAttemptTimeoutMs, Math.max(1, remaining)));\n        if (this.stopped || generation !== this.reconnectGeneration) {\n          ws.close();\n          return;\n        }\n        this.resumeSocket = null;\n        this.reconnecting = false;\n        this.installSignaling(ws);\n        return;\n      } catch {\n        backoffMs = backoffMs === 0 ? 250 : Math.min(backoffMs * 2, signalingResumeMaxBackoffMs);\n      }\n    }\n\n    if (!this.stopped && generation === this.reconnectGeneration) {\n      this.reconnecting = false;\n      this.terminateWithError(new Error(\"unable to resume signaling with the selected gateway\"));\n    }\n  }\n\n  private openResumeSocket(timeoutMs: number): Promise<WebSocket> {\n    return new Promise((resolve, reject) => {\n      const u = new URL(this.gatewayURL!);\n      u.searchParams.set(\"token\", this.readToken!);\n      const ws = new WebSocket(u.toString());\n      this.resumeSocket = ws;\n      let settled = false;\n      const timer = setTimeout(() => fail(), timeoutMs);\n\n      const fail = () => {\n        if (settled) return;\n        settled = true;\n        clearTimeout(timer);\n        if (this.resumeSocket === ws) this.resumeSocket = null;\n        ws.onmessage = null;\n        ws.onerror = null;\n        ws.onclose = null;\n        ws.close();\n        reject(new Error(\"signaling resume attempt failed\"));\n      };\n\n      ws.onmessage = (ev: MessageEvent) => {\n        try {\n          const msg = JSON.parse(ev.data as string);\n          if (msg.type !== \"resumed\" || settled) return;\n          settled = true;\n          clearTimeout(timer);\n          resolve(ws);\n        } catch {\n          // Ignore malformed messages while waiting for the resume acknowledgement.\n        }\n      };\n      ws.onerror = fail;\n      ws.onclose = fail;\n    });\n  }\n\n  private wait(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n\n  private terminateWithError(err: Error): void {\n    this.stopped = true;\n    this.cancelMediaRecovery();\n    this.reconnectGeneration++;\n    this.resumeSocket?.close();\n    this.resumeSocket = null;\n    this.sig?.close();\n    this.sig = null;\n    this.pc?.close();\n    this.pc = null;\n    this.unwatchStreamTracks();\n    this.localStream?.getTracks().forEach((track) => track.stop());\n    this.localStream = null;\n    this.hasAnswer = false;\n    this.pendingRemoteCandidates = [];\n    this.readToken = null;\n    this.gatewayURL = null;\n    this.opts.callbacks?.onError?.(err);\n  }\n\n  private handleSignal(msg: SignalMessage): void {\n    switch (msg.type) {\n      case \"answer\": {\n        if (!this.pc) return;\n        this.pc\n          .setRemoteDescription(\n            new RTCSessionDescription({ type: \"answer\", sdp: msg.sdp }),\n          )\n          .then(() => {\n            this.hasAnswer = true;\n            // Flush any ICE candidates that arrived before the answer.\n            for (const init of this.pendingRemoteCandidates) {\n              this.pc?.addIceCandidate(init).catch(() => {\n                /* ignore stale candidates */\n              });\n            }\n            this.pendingRemoteCandidates = [];\n          })\n          .catch((err) => {\n            this.opts.callbacks?.onError?.(\n              new Error(`failed to set remote description: ${err}`),\n            );\n          });\n        break;\n      }\n\n      case \"ice_candidate\": {\n        if (!this.pc) return;\n        const init: RTCIceCandidateInit = {\n          candidate: msg.candidate,\n          sdpMid: msg.sdp_mid ?? null,\n          sdpMLineIndex: msg.sdp_mline_index ?? null,\n          usernameFragment: msg.username_fragment ?? null,\n        };\n        if (this.hasAnswer) {\n          this.pc.addIceCandidate(init).catch(() => {\n            /* ignore stale candidates */\n          });\n        } else {\n          this.pendingRemoteCandidates.push(init);\n        }\n        break;\n      }\n\n      case \"connection_state\": {\n        // The server echoes the peer connection state; the onconnectionstatechange\n        // handler above already covers this, but callers can also react via\n        // onConnectionStateChange.\n        break;\n      }\n\n      case \"media_stall\":\n      case \"media_track_ended\": {\n        void this.beginMediaRecovery(msg.track);\n        break;\n      }\n\n      case \"media_resumed\": {\n        this.completeMediaRecovery(msg.track);\n        break;\n      }\n\n      case \"error\": {\n        this.opts.callbacks?.onError?.(new Error(msg.error));\n        break;\n      }\n\n      case \"resumed\":\n        break;\n    }\n  }\n\n  private async beginMediaRecovery(trackType: string): Promise<void> {\n    if (this.stopped || this.recoveringMedia || this.recoveryRequired) return;\n\n    const tracks = this.localStream?.getVideoTracks() ?? [];\n    const liveTracks = tracks.filter((track) => track.readyState !== \"ended\");\n    if (liveTracks.length === 0) {\n      this.failMediaRecovery(trackType, \"capture_ended\");\n      return;\n    }\n\n    this.recoveringMedia = true;\n    const generation = ++this.recoveryGeneration;\n    this.recoveryAction = \"sender_restart\";\n    this.emitRecoveryTransition({ state: \"recovering\", track: trackType, action: \"sender_restart\" });\n    this.sendRecoveryDiagnostic(\"recovery_started\", trackType, \"sender_restart\");\n\n    await this.restartSenders(liveTracks, generation);\n    if (!this.isCurrentRecovery(generation)) return;\n\n    await this.wait(senderRecoveryWaitMs);\n    if (!this.isCurrentRecovery(generation)) return;\n\n    this.recoveryAction = \"ice_restart\";\n    this.emitRecoveryTransition({ state: \"recovering\", track: trackType, action: \"ice_restart\" });\n    this.sendRecoveryDiagnostic(\"recovery_retry\", trackType, \"ice_restart\");\n    try {\n      await this.renegotiate(true);\n    } catch {\n      // The fixed recovery window below still gives signaling-resume a chance.\n      // If media does not recover, the host receives onRecoveryRequired.\n    }\n\n    await this.wait(iceRecoveryWaitMs);\n    if (!this.isCurrentRecovery(generation)) return;\n    this.failMediaRecovery(trackType, \"automatic_recovery_failed\");\n  }\n\n  private async restartSenders(tracks: MediaStreamTrack[], generation: number): Promise<void> {\n    const live = new Set(tracks);\n    const senders = this.pc?.getSenders().filter(\n      (sender) => sender.track && live.has(sender.track),\n    ) ?? [];\n    if (senders.length === 0) return;\n\n    const originals = senders.map((sender) => ({ sender, track: sender.track! }));\n    try {\n      await Promise.all(originals.map(({ sender }) => sender.replaceTrack(null)));\n      await this.wait(senderRestartPauseMs);\n      if (!this.isCurrentRecovery(generation)) return;\n      await Promise.all(originals.map(({ sender, track }) => sender.replaceTrack(track)));\n      await this.renegotiate(false);\n    } catch {\n      // ICE restart is the second stage and may still recover a sender reset or\n      // renegotiation failure, so do not fail the stream at this stage.\n    }\n  }\n\n  private async renegotiate(iceRestart: boolean): Promise<void> {\n    const pc = this.pc;\n    const signaling = this.sig;\n    if (!pc || !signaling) throw new Error(\"publisher signaling is unavailable\");\n\n    if (iceRestart) pc.restartIce?.();\n    const offer = await pc.createOffer(iceRestart ? { iceRestart: true } : undefined);\n    await pc.setLocalDescription(offer);\n    await this.gatherComplete();\n\n    const local = pc.localDescription;\n    if (!local) throw new Error(\"local description missing\");\n    this.hasAnswer = false;\n    this.pendingRemoteCandidates = [];\n    signaling.send({ type: \"offer\", sdp: local.sdp, sdp_type: \"offer\" });\n  }\n\n  private completeMediaRecovery(trackType: string): void {\n    if (!this.recoveringMedia) return;\n    const action = this.recoveryAction ?? undefined;\n    this.cancelMediaRecovery();\n    this.emitRecoveryTransition({ state: \"recovered\", track: trackType, action });\n  }\n\n  private failMediaRecovery(\n    trackType: string,\n    reason: \"capture_ended\" | \"automatic_recovery_failed\",\n  ): void {\n    if (this.stopped || this.recoveryRequired) return;\n    this.recoveryRequired = true;\n    const action = this.recoveryAction ?? undefined;\n    this.cancelMediaRecovery();\n    const event: PublisherRecoveryEvent = { state: \"failed\", track: trackType, action, reason };\n    this.emitRecoveryTransition(event);\n    this.opts.callbacks?.onRecoveryRequired?.(event);\n    this.sendRecoveryDiagnostic(\"recovery_failed\", trackType, action, reason);\n  }\n\n  private cancelMediaRecovery(): void {\n    this.recoveryGeneration++;\n    this.recoveringMedia = false;\n    this.recoveryAction = null;\n  }\n\n  private isCurrentRecovery(generation: number): boolean {\n    return !this.stopped && this.recoveringMedia && generation === this.recoveryGeneration;\n  }\n\n  private emitRecoveryTransition(event: PublisherRecoveryEvent): void {\n    this.opts.callbacks?.onRecoveryStateChange?.(event);\n  }\n\n  private sendRecoveryDiagnostic(\n    event: \"recovery_started\" | \"recovery_retry\" | \"recovery_failed\",\n    track: string,\n    action?: PublisherRecoveryAction,\n    reason?: \"capture_ended\" | \"automatic_recovery_failed\",\n  ): void {\n    this.sig?.send({ type: \"recovery_event\", event, track, action, reason });\n  }\n\n  private watchStreamTracks(stream: MediaStream): void {\n    for (const track of stream.getVideoTracks()) {\n      const handler: EventListener = () => this.failMediaRecovery(\"screen\", \"capture_ended\");\n      track.addEventListener(\"ended\", handler);\n      this.trackEndHandlers.set(track, handler);\n    }\n  }\n\n  private unwatchStreamTracks(): void {\n    for (const [track, handler] of this.trackEndHandlers) {\n      track.removeEventListener(\"ended\", handler);\n    }\n    this.trackEndHandlers.clear();\n  }\n\n  /** Waits for ICE gathering to reach the \"complete\" state. */\n  private gatherComplete(): Promise<void> {\n    return new Promise((resolve) => {\n      const pc = this.pc;\n      if (!pc) {\n        resolve();\n        return;\n      }\n      if (pc.iceGatheringState === \"complete\") {\n        resolve();\n        return;\n      }\n      const handler = () => {\n        if (pc.iceGatheringState === \"complete\") {\n          pc.removeEventListener(\"icegatheringstatechange\", handler);\n          resolve();\n        }\n      };\n      pc.addEventListener(\"icegatheringstatechange\", handler);\n    });\n  }\n}\n","/**\n * Options for {@link captureCamera}.\n *\n * These are merged shallowly over the library defaults: any field you provide\n * replaces the default for that field entirely (e.g. passing `video` overrides\n * the default video constraints rather than merging into them). Omit a field to\n * keep its default.\n */\nexport interface CaptureCameraOptions {\n  /**\n   * Video constraints, or `true`/`false`. Defaults to a modest resolution and\n   * frame rate (see {@link captureCamera}). Set `false` to disable video.\n   */\n  video?: MediaTrackConstraints | boolean;\n  /**\n   * Audio constraints, or `true`/`false`. Defaults to `false` — Argus is a\n   * video-frame streaming system, so audio is off unless you ask for it.\n   */\n  audio?: MediaTrackConstraints | boolean;\n  /**\n   * The `MediaDevices` instance to capture from. Defaults to the global\n   * `navigator.mediaDevices`. Pass another window's `navigator.mediaDevices`\n   * (e.g. a Document Picture-in-Picture window's) so the browser's permission\n   * prompt and transient-activation check are anchored to that window rather\n   * than the one holding the global `navigator`.\n   */\n  mediaDevices?: MediaDevices;\n}\n\n/**\n * Options for {@link captureScreen}.\n *\n * These are merged shallowly over the library defaults: any field you provide\n * replaces the default for that field entirely. Omit a field to keep its\n * default.\n */\nexport interface CaptureScreenOptions {\n  /**\n   * Video constraints, or `true`. Defaults to a capped width and a low frame\n   * rate (see {@link captureScreen}).\n   */\n  video?: MediaTrackConstraints | boolean;\n  /**\n   * Audio constraints, or `true`/`false`. Defaults to `false` — screen shares\n   * rarely need audio for a video-frame streaming system.\n   */\n  audio?: MediaTrackConstraints | boolean;\n  /**\n   * The `MediaDevices` instance to capture from. Defaults to the global\n   * `navigator.mediaDevices`. Pass another window's `navigator.mediaDevices`\n   * (e.g. a Document Picture-in-Picture window's) so the screen picker and its\n   * transient-activation check are anchored to that window rather than the one\n   * holding the global `navigator`.\n   */\n  mediaDevices?: MediaDevices;\n}\n\n/**\n * Captures the user's camera via `navigator.mediaDevices.getUserMedia`,\n * applying sensible defaults for a video-frame streaming system.\n *\n * Defaults:\n * - `video`: `{ width: { ideal: 1280 }, height: { ideal: 720 }, frameRate: { ideal: 30 } }`\n *   — a modest resolution that keeps upload bandwidth reasonable. Cameras are\n *   rarely the 4k bandwidth problem that screen capture is, so this is an\n *   `ideal` (a hint) rather than a hard cap.\n * - `audio`: `false` — this is a video-frame streaming system.\n *\n * Any option you pass replaces the corresponding default outright (shallow\n * merge), so pass a full `video` constraints object if you want to tweak it.\n *\n * @example\n * ```ts\n * const stream = await captureCamera();\n * await publisher.start(stream);\n * ```\n *\n * @example Front camera with audio:\n * ```ts\n * const stream = await captureCamera({\n *   video: { facingMode: \"user\" },\n *   audio: true,\n * });\n * ```\n */\nexport async function captureCamera(\n  opts: CaptureCameraOptions = {},\n): Promise<MediaStream> {\n  const constraints: MediaStreamConstraints = {\n    video: opts.video ?? {\n      width: { ideal: 1280 },\n      height: { ideal: 720 },\n      frameRate: { ideal: 30 },\n    },\n    audio: opts.audio ?? false,\n  };\n  const mediaDevices = opts.mediaDevices ?? navigator.mediaDevices;\n  return mediaDevices.getUserMedia(constraints);\n}\n\n/**\n * Captures a screen / window / tab via\n * `navigator.mediaDevices.getDisplayMedia`, applying sensible defaults tuned to\n * avoid the HiDPI/Retina bandwidth trap.\n *\n * Defaults:\n * - `video`: `{ width: { max: 1920 }, frameRate: { ideal: 5, max: 10 } }`.\n *   The `width` is a **`max`, not an `ideal`**: on a 2x-Retina display the\n *   browser would otherwise capture at native resolution (often 3456px+ /\n *   effectively 4k), wasting upload bandwidth and downstream decode cost for no\n *   visible benefit. Capping the max roughly halves a 2x-Retina share while\n *   leaving smaller displays untouched. Screen content is mostly static, so the\n *   low frame rate saves further bandwidth.\n * - `audio`: `false`.\n *\n * IMPORTANT — do NOT add `resizeMode: \"none\"` here. That value forbids the\n * browser from downscaling the source, which turns the `width: { max: 1920 }`\n * cap into a no-op on exactly the Retina displays it targets. By omitting\n * `resizeMode` we let the user agent scale to satisfy the constraint (its\n * default behaviour), which is the entire point of this helper. It is tempting\n * to add `resizeMode: \"none\"` back for \"sharpness\" — don't.\n *\n * Any option you pass replaces the corresponding default outright (shallow\n * merge), so pass a full `video` constraints object if you want to tweak it.\n *\n * @example\n * ```ts\n * const stream = await captureScreen();\n * await publisher.start(stream);\n * ```\n */\nexport async function captureScreen(\n  opts: CaptureScreenOptions = {},\n): Promise<MediaStream> {\n  const constraints: MediaStreamConstraints = {\n    video: opts.video ?? {\n      width: { max: 1920 },\n      frameRate: { ideal: 5, max: 10 },\n    },\n    audio: opts.audio ?? false,\n  };\n  const mediaDevices = opts.mediaDevices ?? navigator.mediaDevices;\n  return mediaDevices.getDisplayMedia(constraints);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACaO,IAAM,mBAAN,MAAM,kBAAiB;AAAA,EACpB;AAAA;AAAA,EAGR,YAAmD;AAAA;AAAA,EAEnD,UAA+B;AAAA;AAAA,EAE/B,UAAyC;AAAA,EAEjC,YAAY,IAAe;AACjC,SAAK,KAAK;AAAA,EACZ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,KAAK,IAAiC;AAC3C,UAAM,KAAK,IAAI,kBAAiB,EAAE;AAClC,OAAG,YAAY,CAAC,OAAqB;AACnC,YAAM,MAAM,YAAY,GAAG,IAAI;AAC/B,UAAI,IAAK,IAAG,YAAY,GAAG;AAAA,IAC7B;AACA,OAAG,UAAU,MAAM,GAAG,UAAU,IAAI,MAAM,iBAAiB,CAAC;AAC5D,OAAG,UAAU,MAAM,GAAG,UAAU;AAChC,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,KAAK,KAA0B;AAC7B,QAAI,KAAK,GAAG,eAAe,UAAU,MAAM;AACzC,WAAK,GAAG,KAAK,KAAK,UAAU,GAAG,CAAC;AAAA,IAClC;AAAA,EACF;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,GAAG,MAAM;AAAA,EAChB;AACF;AAGA,SAAS,YAAY,MAAqC;AACxD,MAAI;AACF,WAAO,KAAK,MAAM,IAAc;AAAA,EAClC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;ACtDA,IAAM,qCAAqC;AAC3C,IAAM,kCAAkC;AACxC,IAAM,8BAA8B;AACpC,IAAM,uBAAuB;AAC7B,IAAM,uBAAuB;AAC7B,IAAM,oBAAoB;AAwBnB,IAAM,YAAN,MAAgB;AAAA,EACb;AAAA,EACA,MAA+B;AAAA,EAC/B,KAA+B;AAAA,EAC/B,YAAY;AAAA,EACZ,0BAAiD,CAAC;AAAA,EAClD,cAAkC;AAAA,EAClC,YAA2B;AAAA,EAC3B,aAA4B;AAAA,EAC5B,UAAU;AAAA,EACV,eAAe;AAAA,EACf,sBAAsB;AAAA,EACtB,eAAiC;AAAA,EACjC,qBAAqB;AAAA,EACrB,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,iBAAiD;AAAA,EACjD,mBAAmB,oBAAI,IAAqC;AAAA,EAEpE,YAAY,MAAwB;AAClC,SAAK,OAAO;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,iBAAgC;AAAE,WAAO,KAAK;AAAA,EAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7D,IAAI,qBAAoC;AAAE,WAAO,KAAK;AAAA,EAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQlE,MAAM,MAAM,QAAoC;AAC9C,SAAK,UAAU;AACf,SAAK,mBAAmB;AACxB,SAAK,cAAc;AACnB,SAAK,kBAAkB,MAAM;AAG7B,UAAM,EAAE,IAAI,WAAW,WAAW,IAAI,MAAM,KAAK,aAAa;AAC9D,SAAK,aAAa;AAGlB,QAAI,UAAU,YAAY;AACxB,WAAK,YAAY,UAAU;AAAA,IAC7B;AAMA,UAAM,aAA6B,CAAC,GAAI,KAAK,KAAK,cAAc,CAAC,CAAE;AACnE,QAAI,UAAU,aAAa,UAAU,UAAU,SAAS,GAAG;AACzD,iBAAW,KAAK;AAAA,QACd,MAAM,UAAU;AAAA,QAChB,UAAU,UAAU;AAAA,QACpB,YAAY,UAAU;AAAA,MACxB,CAAC;AAAA,IACH;AAEA,SAAK,KAAK,IAAI,kBAAkB,EAAE,WAAW,CAAC;AAE9C,SAAK,GAAG,iBAAiB,CAAC,OAAO;AAC/B,UAAI,CAAC,GAAG,aAAa,CAAC,KAAK,IAAK;AAChC,YAAM,IAAI,GAAG;AACb,WAAK,IAAI,KAAK;AAAA,QACZ,MAAM;AAAA,QACN,WAAW,EAAE;AAAA,QACb,SAAS,EAAE,UAAU;AAAA,QACrB,iBAAiB,EAAE,iBAAiB;AAAA,QACpC,mBAAmB,EAAE,oBAAoB;AAAA,MAC3C,CAAC;AAAA,IACH;AAEA,SAAK,GAAG,0BAA0B,MAAM;AACtC,YAAM,QAAQ,KAAK,IAAI;AACvB,UAAI,MAAO,MAAK,KAAK,WAAW,0BAA0B,KAAK;AAC/D,UAAI,UAAU,YAAa,MAAK,KAAK,WAAW,cAAc;AAAA,IAChE;AAEA,eAAW,SAAS,OAAO,UAAU,GAAG;AACtC,WAAK,GAAG,SAAS,OAAO,MAAM;AAAA,IAChC;AAEA,UAAM,QAAQ,MAAM,KAAK,GAAG,YAAY;AACxC,UAAM,KAAK,GAAG,oBAAoB,KAAK;AACvC,UAAM,KAAK,eAAe;AAG1B,UAAM,YAAY,KAAK,iBAAiB,EAAE;AAE1C,UAAM,QAAQ,KAAK,GAAG;AACtB,QAAI,CAAC,MAAO,OAAM,IAAI,MAAM,wCAAwC;AACpE,cAAU,KAAK,EAAE,MAAM,SAAS,KAAK,MAAM,KAAK,UAAU,QAAQ,CAAC;AAAA,EACrE;AAAA;AAAA,EAGA,MAAM,cAAc,QAAoC;AACtD,QAAI,CAAC,KAAK,GAAI,OAAM,IAAI,MAAM,uBAAuB;AAErD,SAAK,oBAAoB;AACzB,SAAK,mBAAmB;AACxB,SAAK,oBAAoB;AAGzB,UAAM,UAAU,KAAK,GAAG,WAAW;AACnC,eAAW,UAAU,SAAS;AAC5B,UAAI,OAAO,OAAO;AAChB,aAAK,GAAG,YAAY,MAAM;AAAA,MAC5B;AAAA,IACF;AAGA,eAAW,SAAS,OAAO,UAAU,GAAG;AACtC,WAAK,GAAG,SAAS,OAAO,MAAM;AAAA,IAChC;AACA,SAAK,cAAc;AACnB,SAAK,kBAAkB,MAAM;AAE7B,UAAM,KAAK,YAAY,KAAK;AAAA,EAC9B;AAAA;AAAA,EAGA,OAAa;AACX,SAAK,UAAU;AACf,SAAK,oBAAoB;AACzB,SAAK;AACL,SAAK,eAAe;AACpB,SAAK,cAAc,MAAM;AACzB,SAAK,eAAe;AACpB,SAAK,KAAK,MAAM;AAChB,SAAK,MAAM;AAEX,SAAK,oBAAoB;AACzB,SAAK,aAAa,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;AACrD,SAAK,cAAc;AAEnB,SAAK,IAAI,MAAM;AACf,SAAK,KAAK;AACV,SAAK,YAAY;AACjB,SAAK,0BAA0B,CAAC;AAChC,SAAK,YAAY;AACjB,SAAK,aAAa;AAAA,EACpB;AAAA;AAAA,EAGA,IAAI,iBAA2C;AAC7C,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,cAAuB;AACzB,WAAO,KAAK,IAAI,oBAAoB;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA,EAMQ,eAA4F;AAClG,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,YAAM,EAAE,aAAa,MAAM,IAAI,KAAK;AACpC,UAAI,YAAY,WAAW,GAAG;AAC5B,eAAO,IAAI,MAAM,0BAA0B,CAAC;AAC5C;AAAA,MACF;AAEA,YAAM,UAAuB,CAAC;AAC9B,UAAI,UAAU;AAEd,YAAM,WAAW,CAAC,WAAuB;AACvC,mBAAW,KAAK,SAAS;AACvB,cAAI,MAAM,QAAQ;AAChB,cAAE,YAAY;AACd,cAAE,UAAU;AACZ,cAAE,UAAU;AACZ,cAAE,MAAM;AAAA,UACV;AAAA,QACF;AAAA,MACF;AAEA,YAAM,iBAAiB,MAAM;AAC3B,YAAI,QAAS;AACb,YAAI,QAAQ,MAAM,OAAK,EAAE,eAAe,UAAU,UAAU,EAAE,eAAe,UAAU,OAAO,GAAG;AAC/F,oBAAU;AACV,iBAAO,IAAI,MAAM,gCAAgC,CAAC;AAAA,QACpD;AAAA,MACF;AAEA,iBAAW,cAAc,aAAa;AACpC,cAAM,IAAI,IAAI,IAAI,UAAU;AAC5B,UAAE,aAAa,IAAI,SAAS,KAAK;AACjC,cAAM,KAAK,IAAI,UAAU,EAAE,SAAS,CAAC;AACrC,gBAAQ,KAAK,EAAE;AAEf,YAAI,WAAW;AAEf,WAAG,YAAY,CAAC,OAAqB;AACnC,cAAI,QAAS;AACb,cAAI;AACF,kBAAM,MAAM,KAAK,MAAM,GAAG,IAAc;AACxC,gBAAI,CAAC,YAAY,IAAI,SAAS,YAAY;AACxC,yBAAW;AACX,iBAAG,KAAK,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC,CAAC;AAAA,YAC7C,WAAW,YAAY,IAAI,SAAS,SAAS;AAC3C,wBAAU;AACV,uBAAS,EAAE;AACX,sBAAQ,EAAE,IAAI,WAAW,KAAyB,WAAW,CAAC;AAAA,YAChE;AAAA,UACF,QAAQ;AAAA,UAER;AAAA,QACF;AAEA,WAAG,UAAU,MAAM,eAAe;AAClC,WAAG,UAAU,MAAM,eAAe;AAAA,MACpC;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEQ,iBAAiB,IAAiC;AACxD,UAAM,UAAU,iBAAiB,KAAK,EAAE;AACxC,SAAK,MAAM;AACX,YAAQ,YAAY,CAAC,QAAQ,KAAK,aAAa,GAAG;AAClD,YAAQ,UAAU,MAAM;AACtB,UAAI,KAAK,QAAQ,WAAW,KAAK,QAAS;AAC1C,WAAK,MAAM;AACX,WAAK,KAAK,gBAAgB;AAAA,IAC5B;AAGA,YAAQ,UAAU,MAAM;AAAA,IAAC;AACzB,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,kBAAiC;AAC7C,QAAI,KAAK,gBAAgB,KAAK,QAAS;AACvC,QAAI,CAAC,KAAK,cAAc,CAAC,KAAK,WAAW;AACvC,WAAK,mBAAmB,IAAI,MAAM,wCAAwC,CAAC;AAC3E;AAAA,IACF;AAEA,SAAK,eAAe;AACpB,UAAM,aAAa,EAAE,KAAK;AAC1B,UAAM,UAAU,KAAK,KAAK,+BAA+B;AACzD,UAAM,WAAW,KAAK,IAAI,IAAI,KAAK,IAAI,GAAG,OAAO;AACjD,QAAI,YAAY;AAEhB,WAAO,CAAC,KAAK,WAAW,eAAe,KAAK,uBAAuB,KAAK,IAAI,KAAK,UAAU;AACzF,UAAI,YAAY,GAAG;AACjB,cAAM,SAAS,KAAK,IAAI,WAAW,KAAK,IAAI,GAAG,WAAW,KAAK,IAAI,CAAC,CAAC;AACrE,YAAI,WAAW,EAAG;AAClB,cAAM,KAAK,KAAK,MAAM;AACtB,YAAI,KAAK,WAAW,eAAe,KAAK,oBAAqB;AAAA,MAC/D;AAEA,YAAM,YAAY,WAAW,KAAK,IAAI;AACtC,UAAI,YAAY,EAAG;AACnB,UAAI;AACF,cAAM,KAAK,MAAM,KAAK,iBAAiB,KAAK,IAAI,iCAAiC,KAAK,IAAI,GAAG,SAAS,CAAC,CAAC;AACxG,YAAI,KAAK,WAAW,eAAe,KAAK,qBAAqB;AAC3D,aAAG,MAAM;AACT;AAAA,QACF;AACA,aAAK,eAAe;AACpB,aAAK,eAAe;AACpB,aAAK,iBAAiB,EAAE;AACxB;AAAA,MACF,QAAQ;AACN,oBAAY,cAAc,IAAI,MAAM,KAAK,IAAI,YAAY,GAAG,2BAA2B;AAAA,MACzF;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,WAAW,eAAe,KAAK,qBAAqB;AAC5D,WAAK,eAAe;AACpB,WAAK,mBAAmB,IAAI,MAAM,sDAAsD,CAAC;AAAA,IAC3F;AAAA,EACF;AAAA,EAEQ,iBAAiB,WAAuC;AAC9D,WAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,YAAM,IAAI,IAAI,IAAI,KAAK,UAAW;AAClC,QAAE,aAAa,IAAI,SAAS,KAAK,SAAU;AAC3C,YAAM,KAAK,IAAI,UAAU,EAAE,SAAS,CAAC;AACrC,WAAK,eAAe;AACpB,UAAI,UAAU;AACd,YAAM,QAAQ,WAAW,MAAM,KAAK,GAAG,SAAS;AAEhD,YAAM,OAAO,MAAM;AACjB,YAAI,QAAS;AACb,kBAAU;AACV,qBAAa,KAAK;AAClB,YAAI,KAAK,iBAAiB,GAAI,MAAK,eAAe;AAClD,WAAG,YAAY;AACf,WAAG,UAAU;AACb,WAAG,UAAU;AACb,WAAG,MAAM;AACT,eAAO,IAAI,MAAM,iCAAiC,CAAC;AAAA,MACrD;AAEA,SAAG,YAAY,CAAC,OAAqB;AACnC,YAAI;AACF,gBAAM,MAAM,KAAK,MAAM,GAAG,IAAc;AACxC,cAAI,IAAI,SAAS,aAAa,QAAS;AACvC,oBAAU;AACV,uBAAa,KAAK;AAClB,kBAAQ,EAAE;AAAA,QACZ,QAAQ;AAAA,QAER;AAAA,MACF;AACA,SAAG,UAAU;AACb,SAAG,UAAU;AAAA,IACf,CAAC;AAAA,EACH;AAAA,EAEQ,KAAK,IAA2B;AACtC,WAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AAAA,EACzD;AAAA,EAEQ,mBAAmB,KAAkB;AAC3C,SAAK,UAAU;AACf,SAAK,oBAAoB;AACzB,SAAK;AACL,SAAK,cAAc,MAAM;AACzB,SAAK,eAAe;AACpB,SAAK,KAAK,MAAM;AAChB,SAAK,MAAM;AACX,SAAK,IAAI,MAAM;AACf,SAAK,KAAK;AACV,SAAK,oBAAoB;AACzB,SAAK,aAAa,UAAU,EAAE,QAAQ,CAAC,UAAU,MAAM,KAAK,CAAC;AAC7D,SAAK,cAAc;AACnB,SAAK,YAAY;AACjB,SAAK,0BAA0B,CAAC;AAChC,SAAK,YAAY;AACjB,SAAK,aAAa;AAClB,SAAK,KAAK,WAAW,UAAU,GAAG;AAAA,EACpC;AAAA,EAEQ,aAAa,KAA0B;AAC7C,YAAQ,IAAI,MAAM;AAAA,MAChB,KAAK,UAAU;AACb,YAAI,CAAC,KAAK,GAAI;AACd,aAAK,GACF;AAAA,UACC,IAAI,sBAAsB,EAAE,MAAM,UAAU,KAAK,IAAI,IAAI,CAAC;AAAA,QAC5D,EACC,KAAK,MAAM;AACV,eAAK,YAAY;AAEjB,qBAAW,QAAQ,KAAK,yBAAyB;AAC/C,iBAAK,IAAI,gBAAgB,IAAI,EAAE,MAAM,MAAM;AAAA,YAE3C,CAAC;AAAA,UACH;AACA,eAAK,0BAA0B,CAAC;AAAA,QAClC,CAAC,EACA,MAAM,CAAC,QAAQ;AACd,eAAK,KAAK,WAAW;AAAA,YACnB,IAAI,MAAM,qCAAqC,GAAG,EAAE;AAAA,UACtD;AAAA,QACF,CAAC;AACH;AAAA,MACF;AAAA,MAEA,KAAK,iBAAiB;AACpB,YAAI,CAAC,KAAK,GAAI;AACd,cAAM,OAA4B;AAAA,UAChC,WAAW,IAAI;AAAA,UACf,QAAQ,IAAI,WAAW;AAAA,UACvB,eAAe,IAAI,mBAAmB;AAAA,UACtC,kBAAkB,IAAI,qBAAqB;AAAA,QAC7C;AACA,YAAI,KAAK,WAAW;AAClB,eAAK,GAAG,gBAAgB,IAAI,EAAE,MAAM,MAAM;AAAA,UAE1C,CAAC;AAAA,QACH,OAAO;AACL,eAAK,wBAAwB,KAAK,IAAI;AAAA,QACxC;AACA;AAAA,MACF;AAAA,MAEA,KAAK,oBAAoB;AAIvB;AAAA,MACF;AAAA,MAEA,KAAK;AAAA,MACL,KAAK,qBAAqB;AACxB,aAAK,KAAK,mBAAmB,IAAI,KAAK;AACtC;AAAA,MACF;AAAA,MAEA,KAAK,iBAAiB;AACpB,aAAK,sBAAsB,IAAI,KAAK;AACpC;AAAA,MACF;AAAA,MAEA,KAAK,SAAS;AACZ,aAAK,KAAK,WAAW,UAAU,IAAI,MAAM,IAAI,KAAK,CAAC;AACnD;AAAA,MACF;AAAA,MAEA,KAAK;AACH;AAAA,IACJ;AAAA,EACF;AAAA,EAEA,MAAc,mBAAmB,WAAkC;AACjE,QAAI,KAAK,WAAW,KAAK,mBAAmB,KAAK,iBAAkB;AAEnE,UAAM,SAAS,KAAK,aAAa,eAAe,KAAK,CAAC;AACtD,UAAM,aAAa,OAAO,OAAO,CAAC,UAAU,MAAM,eAAe,OAAO;AACxE,QAAI,WAAW,WAAW,GAAG;AAC3B,WAAK,kBAAkB,WAAW,eAAe;AACjD;AAAA,IACF;AAEA,SAAK,kBAAkB;AACvB,UAAM,aAAa,EAAE,KAAK;AAC1B,SAAK,iBAAiB;AACtB,SAAK,uBAAuB,EAAE,OAAO,cAAc,OAAO,WAAW,QAAQ,iBAAiB,CAAC;AAC/F,SAAK,uBAAuB,oBAAoB,WAAW,gBAAgB;AAE3E,UAAM,KAAK,eAAe,YAAY,UAAU;AAChD,QAAI,CAAC,KAAK,kBAAkB,UAAU,EAAG;AAEzC,UAAM,KAAK,KAAK,oBAAoB;AACpC,QAAI,CAAC,KAAK,kBAAkB,UAAU,EAAG;AAEzC,SAAK,iBAAiB;AACtB,SAAK,uBAAuB,EAAE,OAAO,cAAc,OAAO,WAAW,QAAQ,cAAc,CAAC;AAC5F,SAAK,uBAAuB,kBAAkB,WAAW,aAAa;AACtE,QAAI;AACF,YAAM,KAAK,YAAY,IAAI;AAAA,IAC7B,QAAQ;AAAA,IAGR;AAEA,UAAM,KAAK,KAAK,iBAAiB;AACjC,QAAI,CAAC,KAAK,kBAAkB,UAAU,EAAG;AACzC,SAAK,kBAAkB,WAAW,2BAA2B;AAAA,EAC/D;AAAA,EAEA,MAAc,eAAe,QAA4B,YAAmC;AAC1F,UAAM,OAAO,IAAI,IAAI,MAAM;AAC3B,UAAM,UAAU,KAAK,IAAI,WAAW,EAAE;AAAA,MACpC,CAAC,WAAW,OAAO,SAAS,KAAK,IAAI,OAAO,KAAK;AAAA,IACnD,KAAK,CAAC;AACN,QAAI,QAAQ,WAAW,EAAG;AAE1B,UAAM,YAAY,QAAQ,IAAI,CAAC,YAAY,EAAE,QAAQ,OAAO,OAAO,MAAO,EAAE;AAC5E,QAAI;AACF,YAAM,QAAQ,IAAI,UAAU,IAAI,CAAC,EAAE,OAAO,MAAM,OAAO,aAAa,IAAI,CAAC,CAAC;AAC1E,YAAM,KAAK,KAAK,oBAAoB;AACpC,UAAI,CAAC,KAAK,kBAAkB,UAAU,EAAG;AACzC,YAAM,QAAQ,IAAI,UAAU,IAAI,CAAC,EAAE,QAAQ,MAAM,MAAM,OAAO,aAAa,KAAK,CAAC,CAAC;AAClF,YAAM,KAAK,YAAY,KAAK;AAAA,IAC9B,QAAQ;AAAA,IAGR;AAAA,EACF;AAAA,EAEA,MAAc,YAAY,YAAoC;AAC5D,UAAM,KAAK,KAAK;AAChB,UAAM,YAAY,KAAK;AACvB,QAAI,CAAC,MAAM,CAAC,UAAW,OAAM,IAAI,MAAM,oCAAoC;AAE3E,QAAI,WAAY,IAAG,aAAa;AAChC,UAAM,QAAQ,MAAM,GAAG,YAAY,aAAa,EAAE,YAAY,KAAK,IAAI,MAAS;AAChF,UAAM,GAAG,oBAAoB,KAAK;AAClC,UAAM,KAAK,eAAe;AAE1B,UAAM,QAAQ,GAAG;AACjB,QAAI,CAAC,MAAO,OAAM,IAAI,MAAM,2BAA2B;AACvD,SAAK,YAAY;AACjB,SAAK,0BAA0B,CAAC;AAChC,cAAU,KAAK,EAAE,MAAM,SAAS,KAAK,MAAM,KAAK,UAAU,QAAQ,CAAC;AAAA,EACrE;AAAA,EAEQ,sBAAsB,WAAyB;AACrD,QAAI,CAAC,KAAK,gBAAiB;AAC3B,UAAM,SAAS,KAAK,kBAAkB;AACtC,SAAK,oBAAoB;AACzB,SAAK,uBAAuB,EAAE,OAAO,aAAa,OAAO,WAAW,OAAO,CAAC;AAAA,EAC9E;AAAA,EAEQ,kBACN,WACA,QACM;AACN,QAAI,KAAK,WAAW,KAAK,iBAAkB;AAC3C,SAAK,mBAAmB;AACxB,UAAM,SAAS,KAAK,kBAAkB;AACtC,SAAK,oBAAoB;AACzB,UAAM,QAAgC,EAAE,OAAO,UAAU,OAAO,WAAW,QAAQ,OAAO;AAC1F,SAAK,uBAAuB,KAAK;AACjC,SAAK,KAAK,WAAW,qBAAqB,KAAK;AAC/C,SAAK,uBAAuB,mBAAmB,WAAW,QAAQ,MAAM;AAAA,EAC1E;AAAA,EAEQ,sBAA4B;AAClC,SAAK;AACL,SAAK,kBAAkB;AACvB,SAAK,iBAAiB;AAAA,EACxB;AAAA,EAEQ,kBAAkB,YAA6B;AACrD,WAAO,CAAC,KAAK,WAAW,KAAK,mBAAmB,eAAe,KAAK;AAAA,EACtE;AAAA,EAEQ,uBAAuB,OAAqC;AAClE,SAAK,KAAK,WAAW,wBAAwB,KAAK;AAAA,EACpD;AAAA,EAEQ,uBACN,OACA,OACA,QACA,QACM;AACN,SAAK,KAAK,KAAK,EAAE,MAAM,kBAAkB,OAAO,OAAO,QAAQ,OAAO,CAAC;AAAA,EACzE;AAAA,EAEQ,kBAAkB,QAA2B;AACnD,eAAW,SAAS,OAAO,eAAe,GAAG;AAC3C,YAAM,UAAyB,MAAM,KAAK,kBAAkB,UAAU,eAAe;AACrF,YAAM,iBAAiB,SAAS,OAAO;AACvC,WAAK,iBAAiB,IAAI,OAAO,OAAO;AAAA,IAC1C;AAAA,EACF;AAAA,EAEQ,sBAA4B;AAClC,eAAW,CAAC,OAAO,OAAO,KAAK,KAAK,kBAAkB;AACpD,YAAM,oBAAoB,SAAS,OAAO;AAAA,IAC5C;AACA,SAAK,iBAAiB,MAAM;AAAA,EAC9B;AAAA;AAAA,EAGQ,iBAAgC;AACtC,WAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,YAAM,KAAK,KAAK;AAChB,UAAI,CAAC,IAAI;AACP,gBAAQ;AACR;AAAA,MACF;AACA,UAAI,GAAG,sBAAsB,YAAY;AACvC,gBAAQ;AACR;AAAA,MACF;AACA,YAAM,UAAU,MAAM;AACpB,YAAI,GAAG,sBAAsB,YAAY;AACvC,aAAG,oBAAoB,2BAA2B,OAAO;AACzD,kBAAQ;AAAA,QACV;AAAA,MACF;AACA,SAAG,iBAAiB,2BAA2B,OAAO;AAAA,IACxD,CAAC;AAAA,EACH;AACF;;;AC9gBA,eAAsB,cACpB,OAA6B,CAAC,GACR;AACtB,QAAM,cAAsC;AAAA,IAC1C,OAAO,KAAK,SAAS;AAAA,MACnB,OAAO,EAAE,OAAO,KAAK;AAAA,MACrB,QAAQ,EAAE,OAAO,IAAI;AAAA,MACrB,WAAW,EAAE,OAAO,GAAG;AAAA,IACzB;AAAA,IACA,OAAO,KAAK,SAAS;AAAA,EACvB;AACA,QAAM,eAAe,KAAK,gBAAgB,UAAU;AACpD,SAAO,aAAa,aAAa,WAAW;AAC9C;AAiCA,eAAsB,cACpB,OAA6B,CAAC,GACR;AACtB,QAAM,cAAsC;AAAA,IAC1C,OAAO,KAAK,SAAS;AAAA,MACnB,OAAO,EAAE,KAAK,KAAK;AAAA,MACnB,WAAW,EAAE,OAAO,GAAG,KAAK,GAAG;AAAA,IACjC;AAAA,IACA,OAAO,KAAK,SAAS;AAAA,EACvB;AACA,QAAM,eAAe,KAAK,gBAAgB,UAAU;AACpD,SAAO,aAAa,gBAAgB,WAAW;AACjD;","names":[]}

package/dist/index.d.cts

@@ -18,6 +18,24 @@ type SignalMessage = {
 } | {
     type: "connection_state";
     state: string;
+} | {
+    type: "media_stall";
+    track: string;
+    frame_age_ms: number;
+} | {
+    type: "media_resumed";
+    track: string;
+    duration_ms: number;
+} | {
+    type: "media_track_ended";
+    track: string;
+    reason?: string;
+} | {
+    type: "recovery_event";
+    event: "recovery_started" | "recovery_retry" | "recovery_failed";
+    track: string;
+    action?: "sender_restart" | "ice_restart";
+    reason?: "capture_ended" | "automatic_recovery_failed";
 } | {
     type: "error";
     error: string;
@@ -44,6 +62,20 @@ interface PublisherCallbacks {
     onError?: (error: Error) => void;
     /** Called when the browser has successfully connected to the media server. */
     onConnected?: () => void;
+    /** Called for each transition in automatic media recovery. */
+    onRecoveryStateChange?: (event: PublisherRecoveryEvent) => void;
+    /** Called when recovery requires the host application to obtain a new screen share. */
+    onRecoveryRequired?: (event: PublisherRecoveryEvent) => void;
+}
+type PublisherRecoveryState = "recovering" | "recovered" | "failed";
+type PublisherRecoveryAction = "sender_restart" | "ice_restart";
+type PublisherRecoveryFailureReason = "capture_ended" | "automatic_recovery_failed";
+/** A transition in the publisher's fixed automatic media-recovery ladder. */
+interface PublisherRecoveryEvent {
+    state: PublisherRecoveryState;
+    track: string;
+    action?: PublisherRecoveryAction;
+    reason?: PublisherRecoveryFailureReason;
 }
 /**
  * TURN and read-token info delivered in the gateway `ready` message.
@@ -102,14 +134,25 @@ declare class Publisher {
     private pendingRemoteCandidates;
     private localStream;
     private readToken;
-    private selectedGatewayURL;
+    private gatewayURL;
     private stopped;
     private reconnecting;
     private reconnectGeneration;
     private resumeSocket;
+    private recoveryGeneration;
+    private recoveringMedia;
+    private recoveryRequired;
+    private recoveryAction;
+    private trackEndHandlers;
     constructor(opts: PublisherOptions);
     /** The read token used for frame fetches and signaling resume in the selected region. */
     get frameReadToken(): string | null;
+    /**
+     * The signaling gateway URL that won the initial race, or null before start.
+     * Relay this with frameReadToken so the application server can reach the same
+     * region for frame reads and change-notification subscriptions.
+     */
+    get selectedGatewayURL(): string | null;
     /**
      * Starts the publisher: races all gateways to find the fastest, completes
      * the two-phase handshake, creates the peer connection, and sends the SDP
@@ -132,6 +175,17 @@ declare class Publisher {
     private wait;
     private terminateWithError;
     private handleSignal;
+    private beginMediaRecovery;
+    private restartSenders;
+    private renegotiate;
+    private completeMediaRecovery;
+    private failMediaRecovery;
+    private cancelMediaRecovery;
+    private isCurrentRecovery;
+    private emitRecoveryTransition;
+    private sendRecoveryDiagnostic;
+    private watchStreamTracks;
+    private unwatchStreamTracks;
     /** Waits for ICE gathering to reach the "complete" state. */
     private gatherComplete;
 }
@@ -253,4 +307,4 @@ declare function captureCamera(opts?: CaptureCameraOptions): Promise<MediaStream
  */
 declare function captureScreen(opts?: CaptureScreenOptions): Promise<MediaStream>;
 
-export { type CaptureCameraOptions, type CaptureScreenOptions, type GatewayReadyInfo, Publisher, type PublisherCallbacks, type PublisherOptions, type SignalMessage, captureCamera, captureScreen };
+export { type CaptureCameraOptions, type CaptureScreenOptions, type GatewayReadyInfo, Publisher, type PublisherCallbacks, type PublisherOptions, type PublisherRecoveryAction, type PublisherRecoveryEvent, type PublisherRecoveryFailureReason, type PublisherRecoveryState, type SignalMessage, captureCamera, captureScreen };

package/dist/index.d.ts

@@ -18,6 +18,24 @@ type SignalMessage = {
 } | {
     type: "connection_state";
     state: string;
+} | {
+    type: "media_stall";
+    track: string;
+    frame_age_ms: number;
+} | {
+    type: "media_resumed";
+    track: string;
+    duration_ms: number;
+} | {
+    type: "media_track_ended";
+    track: string;
+    reason?: string;
+} | {
+    type: "recovery_event";
+    event: "recovery_started" | "recovery_retry" | "recovery_failed";
+    track: string;
+    action?: "sender_restart" | "ice_restart";
+    reason?: "capture_ended" | "automatic_recovery_failed";
 } | {
     type: "error";
     error: string;
@@ -44,6 +62,20 @@ interface PublisherCallbacks {
     onError?: (error: Error) => void;
     /** Called when the browser has successfully connected to the media server. */
     onConnected?: () => void;
+    /** Called for each transition in automatic media recovery. */
+    onRecoveryStateChange?: (event: PublisherRecoveryEvent) => void;
+    /** Called when recovery requires the host application to obtain a new screen share. */
+    onRecoveryRequired?: (event: PublisherRecoveryEvent) => void;
+}
+type PublisherRecoveryState = "recovering" | "recovered" | "failed";
+type PublisherRecoveryAction = "sender_restart" | "ice_restart";
+type PublisherRecoveryFailureReason = "capture_ended" | "automatic_recovery_failed";
+/** A transition in the publisher's fixed automatic media-recovery ladder. */
+interface PublisherRecoveryEvent {
+    state: PublisherRecoveryState;
+    track: string;
+    action?: PublisherRecoveryAction;
+    reason?: PublisherRecoveryFailureReason;
 }
 /**
  * TURN and read-token info delivered in the gateway `ready` message.
@@ -102,14 +134,25 @@ declare class Publisher {
     private pendingRemoteCandidates;
     private localStream;
     private readToken;
-    private selectedGatewayURL;
+    private gatewayURL;
     private stopped;
     private reconnecting;
     private reconnectGeneration;
     private resumeSocket;
+    private recoveryGeneration;
+    private recoveringMedia;
+    private recoveryRequired;
+    private recoveryAction;
+    private trackEndHandlers;
     constructor(opts: PublisherOptions);
     /** The read token used for frame fetches and signaling resume in the selected region. */
     get frameReadToken(): string | null;
+    /**
+     * The signaling gateway URL that won the initial race, or null before start.
+     * Relay this with frameReadToken so the application server can reach the same
+     * region for frame reads and change-notification subscriptions.
+     */
+    get selectedGatewayURL(): string | null;
     /**
      * Starts the publisher: races all gateways to find the fastest, completes
      * the two-phase handshake, creates the peer connection, and sends the SDP
@@ -132,6 +175,17 @@ declare class Publisher {
     private wait;
     private terminateWithError;
     private handleSignal;
+    private beginMediaRecovery;
+    private restartSenders;
+    private renegotiate;
+    private completeMediaRecovery;
+    private failMediaRecovery;
+    private cancelMediaRecovery;
+    private isCurrentRecovery;
+    private emitRecoveryTransition;
+    private sendRecoveryDiagnostic;
+    private watchStreamTracks;
+    private unwatchStreamTracks;
     /** Waits for ICE gathering to reach the "complete" state. */
     private gatherComplete;
 }
@@ -253,4 +307,4 @@ declare function captureCamera(opts?: CaptureCameraOptions): Promise<MediaStream
  */
 declare function captureScreen(opts?: CaptureScreenOptions): Promise<MediaStream>;
 
-export { type CaptureCameraOptions, type CaptureScreenOptions, type GatewayReadyInfo, Publisher, type PublisherCallbacks, type PublisherOptions, type SignalMessage, captureCamera, captureScreen };
+export { type CaptureCameraOptions, type CaptureScreenOptions, type GatewayReadyInfo, Publisher, type PublisherCallbacks, type PublisherOptions, type PublisherRecoveryAction, type PublisherRecoveryEvent, type PublisherRecoveryFailureReason, type PublisherRecoveryState, type SignalMessage, captureCamera, captureScreen };

package/dist/index.js

@@ -48,6 +48,9 @@ function parseSignal(data) {
 var defaultSignalingReconnectTimeoutMs = 2e4;
 var signalingResumeAttemptTimeoutMs = 3e3;
 var signalingResumeMaxBackoffMs = 3e3;
+var senderRestartPauseMs = 100;
+var senderRecoveryWaitMs = 4e3;
+var iceRecoveryWaitMs = 8e3;
 var Publisher = class {
   opts;
   sig = null;
@@ -56,11 +59,16 @@ var Publisher = class {
   pendingRemoteCandidates = [];
   localStream = null;
   readToken = null;
-  selectedGatewayURL = null;
+  gatewayURL = null;
   stopped = true;
   reconnecting = false;
   reconnectGeneration = 0;
   resumeSocket = null;
+  recoveryGeneration = 0;
+  recoveringMedia = false;
+  recoveryRequired = false;
+  recoveryAction = null;
+  trackEndHandlers = /* @__PURE__ */ new Map();
   constructor(opts) {
     this.opts = opts;
   }
@@ -68,6 +76,14 @@ var Publisher = class {
   get frameReadToken() {
     return this.readToken;
   }
+  /**
+   * The signaling gateway URL that won the initial race, or null before start.
+   * Relay this with frameReadToken so the application server can reach the same
+   * region for frame reads and change-notification subscriptions.
+   */
+  get selectedGatewayURL() {
+    return this.gatewayURL;
+  }
   /**
    * Starts the publisher: races all gateways to find the fastest, completes
    * the two-phase handshake, creates the peer connection, and sends the SDP
@@ -76,9 +92,11 @@ var Publisher = class {
    */
   async start(stream) {
     this.stopped = false;
+    this.recoveryRequired = false;
     this.localStream = stream;
+    this.watchStreamTracks(stream);
     const { ws, readyInfo, gatewayURL } = await this.raceGateways();
-    this.selectedGatewayURL = gatewayURL;
+    this.gatewayURL = gatewayURL;
     if (readyInfo.read_token) {
       this.readToken = readyInfo.read_token;
     }
@@ -121,6 +139,9 @@ var Publisher = class {
   /** Replaces the currently published stream with a new one. */
   async replaceStream(stream) {
     if (!this.pc) throw new Error("publisher not started");
+    this.cancelMediaRecovery();
+    this.recoveryRequired = false;
+    this.unwatchStreamTracks();
     const senders = this.pc.getSenders();
     for (const sender of senders) {
       if (sender.track) {
@@ -131,26 +152,20 @@ var Publisher = class {
       this.pc.addTrack(track, stream);
     }
     this.localStream = stream;
-    const offer = await this.pc.createOffer();
-    await this.pc.setLocalDescription(offer);
-    await this.gatherComplete();
-    const local = this.pc.localDescription;
-    if (!local) throw new Error("local description missing");
-    this.sig?.send({
-      type: "offer",
-      sdp: local.sdp,
-      sdp_type: "offer"
-    });
+    this.watchStreamTracks(stream);
+    await this.renegotiate(false);
   }
   /** Stops publishing and tears down the peer connection. */
   stop() {
     this.stopped = true;
+    this.cancelMediaRecovery();
     this.reconnectGeneration++;
     this.reconnecting = false;
     this.resumeSocket?.close();
     this.resumeSocket = null;
     this.sig?.close();
     this.sig = null;
+    this.unwatchStreamTracks();
     this.localStream?.getTracks().forEach((t) => t.stop());
     this.localStream = null;
     this.pc?.close();
@@ -158,7 +173,7 @@ var Publisher = class {
     this.hasAnswer = false;
     this.pendingRemoteCandidates = [];
     this.readToken = null;
-    this.selectedGatewayURL = null;
+    this.gatewayURL = null;
   }
   /** Returns the current RTCPeerConnection, or null if not started. */
   get peerConnection() {
@@ -238,7 +253,7 @@ var Publisher = class {
   }
   async resumeSignaling() {
     if (this.reconnecting || this.stopped) return;
-    if (!this.selectedGatewayURL || !this.readToken) {
+    if (!this.gatewayURL || !this.readToken) {
       this.terminateWithError(new Error("signaling closed and cannot be resumed"));
       return;
     }
@@ -277,7 +292,7 @@ var Publisher = class {
   }
   openResumeSocket(timeoutMs) {
     return new Promise((resolve, reject) => {
-      const u = new URL(this.selectedGatewayURL);
+      const u = new URL(this.gatewayURL);
       u.searchParams.set("token", this.readToken);
       const ws = new WebSocket(u.toString());
       this.resumeSocket = ws;
@@ -313,6 +328,7 @@ var Publisher = class {
   }
   terminateWithError(err) {
     this.stopped = true;
+    this.cancelMediaRecovery();
     this.reconnectGeneration++;
     this.resumeSocket?.close();
     this.resumeSocket = null;
@@ -320,12 +336,13 @@ var Publisher = class {
     this.sig = null;
     this.pc?.close();
     this.pc = null;
+    this.unwatchStreamTracks();
     this.localStream?.getTracks().forEach((track) => track.stop());
     this.localStream = null;
     this.hasAnswer = false;
     this.pendingRemoteCandidates = [];
     this.readToken = null;
-    this.selectedGatewayURL = null;
+    this.gatewayURL = null;
     this.opts.callbacks?.onError?.(err);
   }
   handleSignal(msg) {
@@ -367,6 +384,15 @@ var Publisher = class {
       case "connection_state": {
         break;
       }
+      case "media_stall":
+      case "media_track_ended": {
+        void this.beginMediaRecovery(msg.track);
+        break;
+      }
+      case "media_resumed": {
+        this.completeMediaRecovery(msg.track);
+        break;
+      }
       case "error": {
         this.opts.callbacks?.onError?.(new Error(msg.error));
         break;
@@ -375,6 +401,107 @@ var Publisher = class {
         break;
     }
   }
+  async beginMediaRecovery(trackType) {
+    if (this.stopped || this.recoveringMedia || this.recoveryRequired) return;
+    const tracks = this.localStream?.getVideoTracks() ?? [];
+    const liveTracks = tracks.filter((track) => track.readyState !== "ended");
+    if (liveTracks.length === 0) {
+      this.failMediaRecovery(trackType, "capture_ended");
+      return;
+    }
+    this.recoveringMedia = true;
+    const generation = ++this.recoveryGeneration;
+    this.recoveryAction = "sender_restart";
+    this.emitRecoveryTransition({ state: "recovering", track: trackType, action: "sender_restart" });
+    this.sendRecoveryDiagnostic("recovery_started", trackType, "sender_restart");
+    await this.restartSenders(liveTracks, generation);
+    if (!this.isCurrentRecovery(generation)) return;
+    await this.wait(senderRecoveryWaitMs);
+    if (!this.isCurrentRecovery(generation)) return;
+    this.recoveryAction = "ice_restart";
+    this.emitRecoveryTransition({ state: "recovering", track: trackType, action: "ice_restart" });
+    this.sendRecoveryDiagnostic("recovery_retry", trackType, "ice_restart");
+    try {
+      await this.renegotiate(true);
+    } catch {
+    }
+    await this.wait(iceRecoveryWaitMs);
+    if (!this.isCurrentRecovery(generation)) return;
+    this.failMediaRecovery(trackType, "automatic_recovery_failed");
+  }
+  async restartSenders(tracks, generation) {
+    const live = new Set(tracks);
+    const senders = this.pc?.getSenders().filter(
+      (sender) => sender.track && live.has(sender.track)
+    ) ?? [];
+    if (senders.length === 0) return;
+    const originals = senders.map((sender) => ({ sender, track: sender.track }));
+    try {
+      await Promise.all(originals.map(({ sender }) => sender.replaceTrack(null)));
+      await this.wait(senderRestartPauseMs);
+      if (!this.isCurrentRecovery(generation)) return;
+      await Promise.all(originals.map(({ sender, track }) => sender.replaceTrack(track)));
+      await this.renegotiate(false);
+    } catch {
+    }
+  }
+  async renegotiate(iceRestart) {
+    const pc = this.pc;
+    const signaling = this.sig;
+    if (!pc || !signaling) throw new Error("publisher signaling is unavailable");
+    if (iceRestart) pc.restartIce?.();
+    const offer = await pc.createOffer(iceRestart ? { iceRestart: true } : void 0);
+    await pc.setLocalDescription(offer);
+    await this.gatherComplete();
+    const local = pc.localDescription;
+    if (!local) throw new Error("local description missing");
+    this.hasAnswer = false;
+    this.pendingRemoteCandidates = [];
+    signaling.send({ type: "offer", sdp: local.sdp, sdp_type: "offer" });
+  }
+  completeMediaRecovery(trackType) {
+    if (!this.recoveringMedia) return;
+    const action = this.recoveryAction ?? void 0;
+    this.cancelMediaRecovery();
+    this.emitRecoveryTransition({ state: "recovered", track: trackType, action });
+  }
+  failMediaRecovery(trackType, reason) {
+    if (this.stopped || this.recoveryRequired) return;
+    this.recoveryRequired = true;
+    const action = this.recoveryAction ?? void 0;
+    this.cancelMediaRecovery();
+    const event = { state: "failed", track: trackType, action, reason };
+    this.emitRecoveryTransition(event);
+    this.opts.callbacks?.onRecoveryRequired?.(event);
+    this.sendRecoveryDiagnostic("recovery_failed", trackType, action, reason);
+  }
+  cancelMediaRecovery() {
+    this.recoveryGeneration++;
+    this.recoveringMedia = false;
+    this.recoveryAction = null;
+  }
+  isCurrentRecovery(generation) {
+    return !this.stopped && this.recoveringMedia && generation === this.recoveryGeneration;
+  }
+  emitRecoveryTransition(event) {
+    this.opts.callbacks?.onRecoveryStateChange?.(event);
+  }
+  sendRecoveryDiagnostic(event, track, action, reason) {
+    this.sig?.send({ type: "recovery_event", event, track, action, reason });
+  }
+  watchStreamTracks(stream) {
+    for (const track of stream.getVideoTracks()) {
+      const handler = () => this.failMediaRecovery("screen", "capture_ended");
+      track.addEventListener("ended", handler);
+      this.trackEndHandlers.set(track, handler);
+    }
+  }
+  unwatchStreamTracks() {
+    for (const [track, handler] of this.trackEndHandlers) {
+      track.removeEventListener("ended", handler);
+    }
+    this.trackEndHandlers.clear();
+  }
   /** Waits for ICE gathering to reach the "complete" state. */
   gatherComplete() {
     return new Promise((resolve) => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/signaling.ts","../src/publisher.ts","../src/capture.ts"],"sourcesContent":["import type { SignalMessage } from \"./types\";\n\n/**\n * Wraps an open WebSocket to the Argus gateway and handles the JSON message\n * envelope: incoming text frames are parsed into {@link SignalMessage}s and\n * outgoing messages are serialised.\n *\n * This is an internal helper. The {@link Publisher} opens the socket itself\n * (racing all candidate gateways) and hands the winner here, so this class only\n * ever adopts an already-open socket rather than dialing one.\n *\n * @internal\n */\nexport class SignalingChannel {\n  private ws: WebSocket;\n\n  /** Fired for every incoming JSON message. */\n  onMessage: ((msg: SignalMessage) => void) | null = null;\n  /** Fired when the underlying WebSocket closes. */\n  onClose: (() => void) | null = null;\n  /** Fired when an error occurs on the WebSocket. */\n  onError: ((err: Error) => void) | null = null;\n\n  private constructor(ws: WebSocket) {\n    this.ws = ws;\n  }\n\n  /**\n   * Adopts an already-open WebSocket (e.g. the winner of a gateway race),\n   * routing its events through the channel's callbacks. Any handlers previously\n   * attached to the socket are replaced.\n   */\n  static wrap(ws: WebSocket): SignalingChannel {\n    const ch = new SignalingChannel(ws);\n    ws.onmessage = (ev: MessageEvent) => {\n      const msg = parseSignal(ev.data);\n      if (msg) ch.onMessage?.(msg);\n    };\n    ws.onerror = () => ch.onError?.(new Error(\"WebSocket error\"));\n    ws.onclose = () => ch.onClose?.();\n    return ch;\n  }\n\n  /** Sends a JSON message if the socket is open; a no-op otherwise. */\n  send(msg: SignalMessage): void {\n    if (this.ws.readyState === WebSocket.OPEN) {\n      this.ws.send(JSON.stringify(msg));\n    }\n  }\n\n  /** Closes the underlying WebSocket. */\n  close(): void {\n    this.ws.close();\n  }\n}\n\n/** Parses a WebSocket text frame into a SignalMessage, or null if malformed. */\nfunction parseSignal(data: unknown): SignalMessage | null {\n  try {\n    return JSON.parse(data as string) as SignalMessage;\n  } catch {\n    return null;\n  }\n}\n","import { SignalingChannel } from \"./signaling\";\nimport type { GatewayReadyInfo, PublisherOptions, SignalMessage } from \"./types\";\n\nconst defaultSignalingReconnectTimeoutMs = 20_000;\nconst signalingResumeAttemptTimeoutMs = 3_000;\nconst signalingResumeMaxBackoffMs = 3_000;\n\n/**\n * Publisher streams a browser {@link MediaStream} to an Argus media server over\n * WebRTC. Given the `gateway_urls` and `token` from a join-token response, it\n * races the candidate gateways to the fastest one, completes the two-phase\n * signaling handshake, and manages the peer connection — offer/answer exchange,\n * ICE candidate trickling, and track (re)negotiation.\n *\n * After {@link Publisher.start} resolves, {@link Publisher.frameReadToken} holds\n * the token your application server needs to fetch frames for this stream.\n *\n * @example Publish the default camera:\n * ```ts\n * const pub = new Publisher({\n *   gatewayURLs: joinResp.gateway_urls,\n *   token: joinResp.token,\n *   callbacks: { onConnected: () => console.log(\"live!\") },\n * });\n *\n * const stream = await navigator.mediaDevices.getUserMedia({ video: true });\n * await pub.start(stream);\n * ```\n */\nexport class Publisher {\n  private opts: PublisherOptions;\n  private sig: SignalingChannel | null = null;\n  private pc: RTCPeerConnection | null = null;\n  private hasAnswer = false;\n  private pendingRemoteCandidates: RTCIceCandidateInit[] = [];\n  private localStream: MediaStream | null = null;\n  private readToken: string | null = null;\n  private selectedGatewayURL: string | null = null;\n  private stopped = true;\n  private reconnecting = false;\n  private reconnectGeneration = 0;\n  private resumeSocket: WebSocket | null = null;\n\n  constructor(opts: PublisherOptions) {\n    this.opts = opts;\n  }\n\n  /** The read token used for frame fetches and signaling resume in the selected region. */\n  get frameReadToken(): string | null { return this.readToken; }\n\n  /**\n   * Starts the publisher: races all gateways to find the fastest, completes\n   * the two-phase handshake, creates the peer connection, and sends the SDP\n   * offer. Resolves when the offer has been sent (not when ICE completes —\n   * use onConnected for that).\n   */\n  async start(stream: MediaStream): Promise<void> {\n    this.stopped = false;\n    this.localStream = stream;\n\n    // Race all gateways; returns winning WebSocket + TURN/read-token info\n    const { ws, readyInfo, gatewayURL } = await this.raceGateways();\n    this.selectedGatewayURL = gatewayURL;\n\n    // Store read token for caller\n    if (readyInfo.read_token) {\n      this.readToken = readyInfo.read_token;\n    }\n\n    // Build ICE servers: extra servers from opts + TURN from gateway. The\n    // gateway supplies multi-transport turn_urls (UDP + TCP) so relay can fall\n    // back to TCP on UDP-blocking networks. A single credential is valid for\n    // every transport.\n    const iceServers: RTCIceServer[] = [...(this.opts.iceServers ?? [])];\n    if (readyInfo.turn_urls && readyInfo.turn_urls.length > 0) {\n      iceServers.push({\n        urls: readyInfo.turn_urls,\n        username: readyInfo.turn_username,\n        credential: readyInfo.turn_credential,\n      });\n    }\n\n    this.pc = new RTCPeerConnection({ iceServers });\n\n    this.pc.onicecandidate = (ev) => {\n      if (!ev.candidate || !this.sig) return;\n      const c = ev.candidate;\n      this.sig.send({\n        type: \"ice_candidate\",\n        candidate: c.candidate,\n        sdp_mid: c.sdpMid ?? undefined,\n        sdp_mline_index: c.sdpMLineIndex ?? undefined,\n        username_fragment: c.usernameFragment ?? undefined,\n      });\n    };\n\n    this.pc.onconnectionstatechange = () => {\n      const state = this.pc?.connectionState;\n      if (state) this.opts.callbacks?.onConnectionStateChange?.(state);\n      if (state === \"connected\") this.opts.callbacks?.onConnected?.();\n    };\n\n    for (const track of stream.getTracks()) {\n      this.pc.addTrack(track, stream);\n    }\n\n    const offer = await this.pc.createOffer();\n    await this.pc.setLocalDescription(offer);\n    await this.gatherComplete();\n\n    // Wrap winning WebSocket in SignalingChannel\n    const signaling = this.installSignaling(ws);\n\n    const local = this.pc.localDescription;\n    if (!local) throw new Error(\"local description missing after gather\");\n    signaling.send({ type: \"offer\", sdp: local.sdp, sdp_type: \"offer\" });\n  }\n\n  /** Replaces the currently published stream with a new one. */\n  async replaceStream(stream: MediaStream): Promise<void> {\n    if (!this.pc) throw new Error(\"publisher not started\");\n\n    // Remove old tracks.\n    const senders = this.pc.getSenders();\n    for (const sender of senders) {\n      if (sender.track) {\n        this.pc.removeTrack(sender);\n      }\n    }\n\n    // Add new tracks.\n    for (const track of stream.getTracks()) {\n      this.pc.addTrack(track, stream);\n    }\n    this.localStream = stream;\n\n    // Renegotiate.\n    const offer = await this.pc.createOffer();\n    await this.pc.setLocalDescription(offer);\n    await this.gatherComplete();\n\n    const local = this.pc.localDescription;\n    if (!local) throw new Error(\"local description missing\");\n    this.sig?.send({\n      type: \"offer\",\n      sdp: local.sdp,\n      sdp_type: \"offer\",\n    });\n  }\n\n  /** Stops publishing and tears down the peer connection. */\n  stop(): void {\n    this.stopped = true;\n    this.reconnectGeneration++;\n    this.reconnecting = false;\n    this.resumeSocket?.close();\n    this.resumeSocket = null;\n    this.sig?.close();\n    this.sig = null;\n\n    this.localStream?.getTracks().forEach((t) => t.stop());\n    this.localStream = null;\n\n    this.pc?.close();\n    this.pc = null;\n    this.hasAnswer = false;\n    this.pendingRemoteCandidates = [];\n    this.readToken = null;\n    this.selectedGatewayURL = null;\n  }\n\n  /** Returns the current RTCPeerConnection, or null if not started. */\n  get peerConnection(): RTCPeerConnection | null {\n    return this.pc;\n  }\n\n  /** Returns true if the peer connection is in the \"connected\" state. */\n  get isConnected(): boolean {\n    return this.pc?.connectionState === \"connected\";\n  }\n\n  // -------------------------------------------------------------------------\n  // Private helpers\n  // -------------------------------------------------------------------------\n\n  private raceGateways(): Promise<{ ws: WebSocket; readyInfo: GatewayReadyInfo; gatewayURL: string }> {\n    return new Promise((resolve, reject) => {\n      const { gatewayURLs, token } = this.opts;\n      if (gatewayURLs.length === 0) {\n        reject(new Error(\"no gateway URLs provided\"));\n        return;\n      }\n\n      const sockets: WebSocket[] = [];\n      let settled = false;\n\n      const closeAll = (except?: WebSocket) => {\n        for (const s of sockets) {\n          if (s !== except) {\n            s.onmessage = null;\n            s.onerror = null;\n            s.onclose = null;\n            s.close();\n          }\n        }\n      };\n\n      const checkAllFailed = () => {\n        if (settled) return;\n        if (sockets.every(s => s.readyState === WebSocket.CLOSED || s.readyState === WebSocket.CLOSING)) {\n          settled = true;\n          reject(new Error(\"all gateways failed to connect\"));\n        }\n      };\n\n      for (const gatewayURL of gatewayURLs) {\n        const u = new URL(gatewayURL);\n        u.searchParams.set(\"token\", token);\n        const ws = new WebSocket(u.toString());\n        sockets.push(ws);\n\n        let accepted = false;\n\n        ws.onmessage = (ev: MessageEvent) => {\n          if (settled) return;\n          try {\n            const msg = JSON.parse(ev.data as string);\n            if (!accepted && msg.type === \"accepted\") {\n              accepted = true;\n              ws.send(JSON.stringify({ type: \"proceed\" }));\n            } else if (accepted && msg.type === \"ready\") {\n              settled = true;\n              closeAll(ws);\n              resolve({ ws, readyInfo: msg as GatewayReadyInfo, gatewayURL });\n            }\n          } catch {\n            /* ignore malformed */\n          }\n        };\n\n        ws.onerror = () => checkAllFailed();\n        ws.onclose = () => checkAllFailed();\n      }\n    });\n  }\n\n  private installSignaling(ws: WebSocket): SignalingChannel {\n    const channel = SignalingChannel.wrap(ws);\n    this.sig = channel;\n    channel.onMessage = (msg) => this.handleSignal(msg);\n    channel.onClose = () => {\n      if (this.sig !== channel || this.stopped) return;\n      this.sig = null;\n      void this.resumeSignaling();\n    };\n    // Browsers normally follow an error event with close. Recovery begins from\n    // close so a single transport failure cannot start two retry loops.\n    channel.onError = () => {};\n    return channel;\n  }\n\n  private async resumeSignaling(): Promise<void> {\n    if (this.reconnecting || this.stopped) return;\n    if (!this.selectedGatewayURL || !this.readToken) {\n      this.terminateWithError(new Error(\"signaling closed and cannot be resumed\"));\n      return;\n    }\n\n    this.reconnecting = true;\n    const generation = ++this.reconnectGeneration;\n    const timeout = this.opts.signalingReconnectTimeoutMs ?? defaultSignalingReconnectTimeoutMs;\n    const deadline = Date.now() + Math.max(0, timeout);\n    let backoffMs = 0;\n\n    while (!this.stopped && generation === this.reconnectGeneration && Date.now() <= deadline) {\n      if (backoffMs > 0) {\n        const waitMs = Math.min(backoffMs, Math.max(0, deadline - Date.now()));\n        if (waitMs === 0) break;\n        await this.wait(waitMs);\n        if (this.stopped || generation !== this.reconnectGeneration) return;\n      }\n\n      const remaining = deadline - Date.now();\n      if (remaining < 0) break;\n      try {\n        const ws = await this.openResumeSocket(Math.min(signalingResumeAttemptTimeoutMs, Math.max(1, remaining)));\n        if (this.stopped || generation !== this.reconnectGeneration) {\n          ws.close();\n          return;\n        }\n        this.resumeSocket = null;\n        this.reconnecting = false;\n        this.installSignaling(ws);\n        return;\n      } catch {\n        backoffMs = backoffMs === 0 ? 250 : Math.min(backoffMs * 2, signalingResumeMaxBackoffMs);\n      }\n    }\n\n    if (!this.stopped && generation === this.reconnectGeneration) {\n      this.reconnecting = false;\n      this.terminateWithError(new Error(\"unable to resume signaling with the selected gateway\"));\n    }\n  }\n\n  private openResumeSocket(timeoutMs: number): Promise<WebSocket> {\n    return new Promise((resolve, reject) => {\n      const u = new URL(this.selectedGatewayURL!);\n      u.searchParams.set(\"token\", this.readToken!);\n      const ws = new WebSocket(u.toString());\n      this.resumeSocket = ws;\n      let settled = false;\n      const timer = setTimeout(() => fail(), timeoutMs);\n\n      const fail = () => {\n        if (settled) return;\n        settled = true;\n        clearTimeout(timer);\n        if (this.resumeSocket === ws) this.resumeSocket = null;\n        ws.onmessage = null;\n        ws.onerror = null;\n        ws.onclose = null;\n        ws.close();\n        reject(new Error(\"signaling resume attempt failed\"));\n      };\n\n      ws.onmessage = (ev: MessageEvent) => {\n        try {\n          const msg = JSON.parse(ev.data as string);\n          if (msg.type !== \"resumed\" || settled) return;\n          settled = true;\n          clearTimeout(timer);\n          resolve(ws);\n        } catch {\n          // Ignore malformed messages while waiting for the resume acknowledgement.\n        }\n      };\n      ws.onerror = fail;\n      ws.onclose = fail;\n    });\n  }\n\n  private wait(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n\n  private terminateWithError(err: Error): void {\n    this.stopped = true;\n    this.reconnectGeneration++;\n    this.resumeSocket?.close();\n    this.resumeSocket = null;\n    this.sig?.close();\n    this.sig = null;\n    this.pc?.close();\n    this.pc = null;\n    this.localStream?.getTracks().forEach((track) => track.stop());\n    this.localStream = null;\n    this.hasAnswer = false;\n    this.pendingRemoteCandidates = [];\n    this.readToken = null;\n    this.selectedGatewayURL = null;\n    this.opts.callbacks?.onError?.(err);\n  }\n\n  private handleSignal(msg: SignalMessage): void {\n    switch (msg.type) {\n      case \"answer\": {\n        if (!this.pc) return;\n        this.pc\n          .setRemoteDescription(\n            new RTCSessionDescription({ type: \"answer\", sdp: msg.sdp }),\n          )\n          .then(() => {\n            this.hasAnswer = true;\n            // Flush any ICE candidates that arrived before the answer.\n            for (const init of this.pendingRemoteCandidates) {\n              this.pc?.addIceCandidate(init).catch(() => {\n                /* ignore stale candidates */\n              });\n            }\n            this.pendingRemoteCandidates = [];\n          })\n          .catch((err) => {\n            this.opts.callbacks?.onError?.(\n              new Error(`failed to set remote description: ${err}`),\n            );\n          });\n        break;\n      }\n\n      case \"ice_candidate\": {\n        if (!this.pc) return;\n        const init: RTCIceCandidateInit = {\n          candidate: msg.candidate,\n          sdpMid: msg.sdp_mid ?? null,\n          sdpMLineIndex: msg.sdp_mline_index ?? null,\n          usernameFragment: msg.username_fragment ?? null,\n        };\n        if (this.hasAnswer) {\n          this.pc.addIceCandidate(init).catch(() => {\n            /* ignore stale candidates */\n          });\n        } else {\n          this.pendingRemoteCandidates.push(init);\n        }\n        break;\n      }\n\n      case \"connection_state\": {\n        // The server echoes the peer connection state; the onconnectionstatechange\n        // handler above already covers this, but callers can also react via\n        // onConnectionStateChange.\n        break;\n      }\n\n      case \"error\": {\n        this.opts.callbacks?.onError?.(new Error(msg.error));\n        break;\n      }\n\n      case \"resumed\":\n        break;\n    }\n  }\n\n  /** Waits for ICE gathering to reach the \"complete\" state. */\n  private gatherComplete(): Promise<void> {\n    return new Promise((resolve) => {\n      const pc = this.pc;\n      if (!pc) {\n        resolve();\n        return;\n      }\n      if (pc.iceGatheringState === \"complete\") {\n        resolve();\n        return;\n      }\n      const handler = () => {\n        if (pc.iceGatheringState === \"complete\") {\n          pc.removeEventListener(\"icegatheringstatechange\", handler);\n          resolve();\n        }\n      };\n      pc.addEventListener(\"icegatheringstatechange\", handler);\n    });\n  }\n}\n","/**\n * Options for {@link captureCamera}.\n *\n * These are merged shallowly over the library defaults: any field you provide\n * replaces the default for that field entirely (e.g. passing `video` overrides\n * the default video constraints rather than merging into them). Omit a field to\n * keep its default.\n */\nexport interface CaptureCameraOptions {\n  /**\n   * Video constraints, or `true`/`false`. Defaults to a modest resolution and\n   * frame rate (see {@link captureCamera}). Set `false` to disable video.\n   */\n  video?: MediaTrackConstraints | boolean;\n  /**\n   * Audio constraints, or `true`/`false`. Defaults to `false` — Argus is a\n   * video-frame streaming system, so audio is off unless you ask for it.\n   */\n  audio?: MediaTrackConstraints | boolean;\n  /**\n   * The `MediaDevices` instance to capture from. Defaults to the global\n   * `navigator.mediaDevices`. Pass another window's `navigator.mediaDevices`\n   * (e.g. a Document Picture-in-Picture window's) so the browser's permission\n   * prompt and transient-activation check are anchored to that window rather\n   * than the one holding the global `navigator`.\n   */\n  mediaDevices?: MediaDevices;\n}\n\n/**\n * Options for {@link captureScreen}.\n *\n * These are merged shallowly over the library defaults: any field you provide\n * replaces the default for that field entirely. Omit a field to keep its\n * default.\n */\nexport interface CaptureScreenOptions {\n  /**\n   * Video constraints, or `true`. Defaults to a capped width and a low frame\n   * rate (see {@link captureScreen}).\n   */\n  video?: MediaTrackConstraints | boolean;\n  /**\n   * Audio constraints, or `true`/`false`. Defaults to `false` — screen shares\n   * rarely need audio for a video-frame streaming system.\n   */\n  audio?: MediaTrackConstraints | boolean;\n  /**\n   * The `MediaDevices` instance to capture from. Defaults to the global\n   * `navigator.mediaDevices`. Pass another window's `navigator.mediaDevices`\n   * (e.g. a Document Picture-in-Picture window's) so the screen picker and its\n   * transient-activation check are anchored to that window rather than the one\n   * holding the global `navigator`.\n   */\n  mediaDevices?: MediaDevices;\n}\n\n/**\n * Captures the user's camera via `navigator.mediaDevices.getUserMedia`,\n * applying sensible defaults for a video-frame streaming system.\n *\n * Defaults:\n * - `video`: `{ width: { ideal: 1280 }, height: { ideal: 720 }, frameRate: { ideal: 30 } }`\n *   — a modest resolution that keeps upload bandwidth reasonable. Cameras are\n *   rarely the 4k bandwidth problem that screen capture is, so this is an\n *   `ideal` (a hint) rather than a hard cap.\n * - `audio`: `false` — this is a video-frame streaming system.\n *\n * Any option you pass replaces the corresponding default outright (shallow\n * merge), so pass a full `video` constraints object if you want to tweak it.\n *\n * @example\n * ```ts\n * const stream = await captureCamera();\n * await publisher.start(stream);\n * ```\n *\n * @example Front camera with audio:\n * ```ts\n * const stream = await captureCamera({\n *   video: { facingMode: \"user\" },\n *   audio: true,\n * });\n * ```\n */\nexport async function captureCamera(\n  opts: CaptureCameraOptions = {},\n): Promise<MediaStream> {\n  const constraints: MediaStreamConstraints = {\n    video: opts.video ?? {\n      width: { ideal: 1280 },\n      height: { ideal: 720 },\n      frameRate: { ideal: 30 },\n    },\n    audio: opts.audio ?? false,\n  };\n  const mediaDevices = opts.mediaDevices ?? navigator.mediaDevices;\n  return mediaDevices.getUserMedia(constraints);\n}\n\n/**\n * Captures a screen / window / tab via\n * `navigator.mediaDevices.getDisplayMedia`, applying sensible defaults tuned to\n * avoid the HiDPI/Retina bandwidth trap.\n *\n * Defaults:\n * - `video`: `{ width: { max: 1920 }, frameRate: { ideal: 5, max: 10 } }`.\n *   The `width` is a **`max`, not an `ideal`**: on a 2x-Retina display the\n *   browser would otherwise capture at native resolution (often 3456px+ /\n *   effectively 4k), wasting upload bandwidth and downstream decode cost for no\n *   visible benefit. Capping the max roughly halves a 2x-Retina share while\n *   leaving smaller displays untouched. Screen content is mostly static, so the\n *   low frame rate saves further bandwidth.\n * - `audio`: `false`.\n *\n * IMPORTANT — do NOT add `resizeMode: \"none\"` here. That value forbids the\n * browser from downscaling the source, which turns the `width: { max: 1920 }`\n * cap into a no-op on exactly the Retina displays it targets. By omitting\n * `resizeMode` we let the user agent scale to satisfy the constraint (its\n * default behaviour), which is the entire point of this helper. It is tempting\n * to add `resizeMode: \"none\"` back for \"sharpness\" — don't.\n *\n * Any option you pass replaces the corresponding default outright (shallow\n * merge), so pass a full `video` constraints object if you want to tweak it.\n *\n * @example\n * ```ts\n * const stream = await captureScreen();\n * await publisher.start(stream);\n * ```\n */\nexport async function captureScreen(\n  opts: CaptureScreenOptions = {},\n): Promise<MediaStream> {\n  const constraints: MediaStreamConstraints = {\n    video: opts.video ?? {\n      width: { max: 1920 },\n      frameRate: { ideal: 5, max: 10 },\n    },\n    audio: opts.audio ?? false,\n  };\n  const mediaDevices = opts.mediaDevices ?? navigator.mediaDevices;\n  return mediaDevices.getDisplayMedia(constraints);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/signaling.ts","../src/publisher.ts","../src/capture.ts"],"sourcesContent":["import type { SignalMessage } from \"./types\";\n\n/**\n * Wraps an open WebSocket to the Argus gateway and handles the JSON message\n * envelope: incoming text frames are parsed into {@link SignalMessage}s and\n * outgoing messages are serialised.\n *\n * This is an internal helper. The {@link Publisher} opens the socket itself\n * (racing all candidate gateways) and hands the winner here, so this class only\n * ever adopts an already-open socket rather than dialing one.\n *\n * @internal\n */\nexport class SignalingChannel {\n  private ws: WebSocket;\n\n  /** Fired for every incoming JSON message. */\n  onMessage: ((msg: SignalMessage) => void) | null = null;\n  /** Fired when the underlying WebSocket closes. */\n  onClose: (() => void) | null = null;\n  /** Fired when an error occurs on the WebSocket. */\n  onError: ((err: Error) => void) | null = null;\n\n  private constructor(ws: WebSocket) {\n    this.ws = ws;\n  }\n\n  /**\n   * Adopts an already-open WebSocket (e.g. the winner of a gateway race),\n   * routing its events through the channel's callbacks. Any handlers previously\n   * attached to the socket are replaced.\n   */\n  static wrap(ws: WebSocket): SignalingChannel {\n    const ch = new SignalingChannel(ws);\n    ws.onmessage = (ev: MessageEvent) => {\n      const msg = parseSignal(ev.data);\n      if (msg) ch.onMessage?.(msg);\n    };\n    ws.onerror = () => ch.onError?.(new Error(\"WebSocket error\"));\n    ws.onclose = () => ch.onClose?.();\n    return ch;\n  }\n\n  /** Sends a JSON message if the socket is open; a no-op otherwise. */\n  send(msg: SignalMessage): void {\n    if (this.ws.readyState === WebSocket.OPEN) {\n      this.ws.send(JSON.stringify(msg));\n    }\n  }\n\n  /** Closes the underlying WebSocket. */\n  close(): void {\n    this.ws.close();\n  }\n}\n\n/** Parses a WebSocket text frame into a SignalMessage, or null if malformed. */\nfunction parseSignal(data: unknown): SignalMessage | null {\n  try {\n    return JSON.parse(data as string) as SignalMessage;\n  } catch {\n    return null;\n  }\n}\n","import { SignalingChannel } from \"./signaling\";\nimport type {\n  GatewayReadyInfo,\n  PublisherOptions,\n  PublisherRecoveryAction,\n  PublisherRecoveryEvent,\n  SignalMessage,\n} from \"./types\";\n\nconst defaultSignalingReconnectTimeoutMs = 20_000;\nconst signalingResumeAttemptTimeoutMs = 3_000;\nconst signalingResumeMaxBackoffMs = 3_000;\nconst senderRestartPauseMs = 100;\nconst senderRecoveryWaitMs = 4_000;\nconst iceRecoveryWaitMs = 8_000;\n\n/**\n * Publisher streams a browser {@link MediaStream} to an Argus media server over\n * WebRTC. Given the `gateway_urls` and `token` from a join-token response, it\n * races the candidate gateways to the fastest one, completes the two-phase\n * signaling handshake, and manages the peer connection — offer/answer exchange,\n * ICE candidate trickling, and track (re)negotiation.\n *\n * After {@link Publisher.start} resolves, {@link Publisher.frameReadToken} holds\n * the token your application server needs to fetch frames for this stream.\n *\n * @example Publish the default camera:\n * ```ts\n * const pub = new Publisher({\n *   gatewayURLs: joinResp.gateway_urls,\n *   token: joinResp.token,\n *   callbacks: { onConnected: () => console.log(\"live!\") },\n * });\n *\n * const stream = await navigator.mediaDevices.getUserMedia({ video: true });\n * await pub.start(stream);\n * ```\n */\nexport class Publisher {\n  private opts: PublisherOptions;\n  private sig: SignalingChannel | null = null;\n  private pc: RTCPeerConnection | null = null;\n  private hasAnswer = false;\n  private pendingRemoteCandidates: RTCIceCandidateInit[] = [];\n  private localStream: MediaStream | null = null;\n  private readToken: string | null = null;\n  private gatewayURL: string | null = null;\n  private stopped = true;\n  private reconnecting = false;\n  private reconnectGeneration = 0;\n  private resumeSocket: WebSocket | null = null;\n  private recoveryGeneration = 0;\n  private recoveringMedia = false;\n  private recoveryRequired = false;\n  private recoveryAction: PublisherRecoveryAction | null = null;\n  private trackEndHandlers = new Map<MediaStreamTrack, EventListener>();\n\n  constructor(opts: PublisherOptions) {\n    this.opts = opts;\n  }\n\n  /** The read token used for frame fetches and signaling resume in the selected region. */\n  get frameReadToken(): string | null { return this.readToken; }\n\n  /**\n   * The signaling gateway URL that won the initial race, or null before start.\n   * Relay this with frameReadToken so the application server can reach the same\n   * region for frame reads and change-notification subscriptions.\n   */\n  get selectedGatewayURL(): string | null { return this.gatewayURL; }\n\n  /**\n   * Starts the publisher: races all gateways to find the fastest, completes\n   * the two-phase handshake, creates the peer connection, and sends the SDP\n   * offer. Resolves when the offer has been sent (not when ICE completes —\n   * use onConnected for that).\n   */\n  async start(stream: MediaStream): Promise<void> {\n    this.stopped = false;\n    this.recoveryRequired = false;\n    this.localStream = stream;\n    this.watchStreamTracks(stream);\n\n    // Race all gateways; returns winning WebSocket + TURN/read-token info\n    const { ws, readyInfo, gatewayURL } = await this.raceGateways();\n    this.gatewayURL = gatewayURL;\n\n    // Store read token for caller\n    if (readyInfo.read_token) {\n      this.readToken = readyInfo.read_token;\n    }\n\n    // Build ICE servers: extra servers from opts + TURN from gateway. The\n    // gateway supplies multi-transport turn_urls (UDP + TCP) so relay can fall\n    // back to TCP on UDP-blocking networks. A single credential is valid for\n    // every transport.\n    const iceServers: RTCIceServer[] = [...(this.opts.iceServers ?? [])];\n    if (readyInfo.turn_urls && readyInfo.turn_urls.length > 0) {\n      iceServers.push({\n        urls: readyInfo.turn_urls,\n        username: readyInfo.turn_username,\n        credential: readyInfo.turn_credential,\n      });\n    }\n\n    this.pc = new RTCPeerConnection({ iceServers });\n\n    this.pc.onicecandidate = (ev) => {\n      if (!ev.candidate || !this.sig) return;\n      const c = ev.candidate;\n      this.sig.send({\n        type: \"ice_candidate\",\n        candidate: c.candidate,\n        sdp_mid: c.sdpMid ?? undefined,\n        sdp_mline_index: c.sdpMLineIndex ?? undefined,\n        username_fragment: c.usernameFragment ?? undefined,\n      });\n    };\n\n    this.pc.onconnectionstatechange = () => {\n      const state = this.pc?.connectionState;\n      if (state) this.opts.callbacks?.onConnectionStateChange?.(state);\n      if (state === \"connected\") this.opts.callbacks?.onConnected?.();\n    };\n\n    for (const track of stream.getTracks()) {\n      this.pc.addTrack(track, stream);\n    }\n\n    const offer = await this.pc.createOffer();\n    await this.pc.setLocalDescription(offer);\n    await this.gatherComplete();\n\n    // Wrap winning WebSocket in SignalingChannel\n    const signaling = this.installSignaling(ws);\n\n    const local = this.pc.localDescription;\n    if (!local) throw new Error(\"local description missing after gather\");\n    signaling.send({ type: \"offer\", sdp: local.sdp, sdp_type: \"offer\" });\n  }\n\n  /** Replaces the currently published stream with a new one. */\n  async replaceStream(stream: MediaStream): Promise<void> {\n    if (!this.pc) throw new Error(\"publisher not started\");\n\n    this.cancelMediaRecovery();\n    this.recoveryRequired = false;\n    this.unwatchStreamTracks();\n\n    // Remove old tracks.\n    const senders = this.pc.getSenders();\n    for (const sender of senders) {\n      if (sender.track) {\n        this.pc.removeTrack(sender);\n      }\n    }\n\n    // Add new tracks.\n    for (const track of stream.getTracks()) {\n      this.pc.addTrack(track, stream);\n    }\n    this.localStream = stream;\n    this.watchStreamTracks(stream);\n\n    await this.renegotiate(false);\n  }\n\n  /** Stops publishing and tears down the peer connection. */\n  stop(): void {\n    this.stopped = true;\n    this.cancelMediaRecovery();\n    this.reconnectGeneration++;\n    this.reconnecting = false;\n    this.resumeSocket?.close();\n    this.resumeSocket = null;\n    this.sig?.close();\n    this.sig = null;\n\n    this.unwatchStreamTracks();\n    this.localStream?.getTracks().forEach((t) => t.stop());\n    this.localStream = null;\n\n    this.pc?.close();\n    this.pc = null;\n    this.hasAnswer = false;\n    this.pendingRemoteCandidates = [];\n    this.readToken = null;\n    this.gatewayURL = null;\n  }\n\n  /** Returns the current RTCPeerConnection, or null if not started. */\n  get peerConnection(): RTCPeerConnection | null {\n    return this.pc;\n  }\n\n  /** Returns true if the peer connection is in the \"connected\" state. */\n  get isConnected(): boolean {\n    return this.pc?.connectionState === \"connected\";\n  }\n\n  // -------------------------------------------------------------------------\n  // Private helpers\n  // -------------------------------------------------------------------------\n\n  private raceGateways(): Promise<{ ws: WebSocket; readyInfo: GatewayReadyInfo; gatewayURL: string }> {\n    return new Promise((resolve, reject) => {\n      const { gatewayURLs, token } = this.opts;\n      if (gatewayURLs.length === 0) {\n        reject(new Error(\"no gateway URLs provided\"));\n        return;\n      }\n\n      const sockets: WebSocket[] = [];\n      let settled = false;\n\n      const closeAll = (except?: WebSocket) => {\n        for (const s of sockets) {\n          if (s !== except) {\n            s.onmessage = null;\n            s.onerror = null;\n            s.onclose = null;\n            s.close();\n          }\n        }\n      };\n\n      const checkAllFailed = () => {\n        if (settled) return;\n        if (sockets.every(s => s.readyState === WebSocket.CLOSED || s.readyState === WebSocket.CLOSING)) {\n          settled = true;\n          reject(new Error(\"all gateways failed to connect\"));\n        }\n      };\n\n      for (const gatewayURL of gatewayURLs) {\n        const u = new URL(gatewayURL);\n        u.searchParams.set(\"token\", token);\n        const ws = new WebSocket(u.toString());\n        sockets.push(ws);\n\n        let accepted = false;\n\n        ws.onmessage = (ev: MessageEvent) => {\n          if (settled) return;\n          try {\n            const msg = JSON.parse(ev.data as string);\n            if (!accepted && msg.type === \"accepted\") {\n              accepted = true;\n              ws.send(JSON.stringify({ type: \"proceed\" }));\n            } else if (accepted && msg.type === \"ready\") {\n              settled = true;\n              closeAll(ws);\n              resolve({ ws, readyInfo: msg as GatewayReadyInfo, gatewayURL });\n            }\n          } catch {\n            /* ignore malformed */\n          }\n        };\n\n        ws.onerror = () => checkAllFailed();\n        ws.onclose = () => checkAllFailed();\n      }\n    });\n  }\n\n  private installSignaling(ws: WebSocket): SignalingChannel {\n    const channel = SignalingChannel.wrap(ws);\n    this.sig = channel;\n    channel.onMessage = (msg) => this.handleSignal(msg);\n    channel.onClose = () => {\n      if (this.sig !== channel || this.stopped) return;\n      this.sig = null;\n      void this.resumeSignaling();\n    };\n    // Browsers normally follow an error event with close. Recovery begins from\n    // close so a single transport failure cannot start two retry loops.\n    channel.onError = () => {};\n    return channel;\n  }\n\n  private async resumeSignaling(): Promise<void> {\n    if (this.reconnecting || this.stopped) return;\n    if (!this.gatewayURL || !this.readToken) {\n      this.terminateWithError(new Error(\"signaling closed and cannot be resumed\"));\n      return;\n    }\n\n    this.reconnecting = true;\n    const generation = ++this.reconnectGeneration;\n    const timeout = this.opts.signalingReconnectTimeoutMs ?? defaultSignalingReconnectTimeoutMs;\n    const deadline = Date.now() + Math.max(0, timeout);\n    let backoffMs = 0;\n\n    while (!this.stopped && generation === this.reconnectGeneration && Date.now() <= deadline) {\n      if (backoffMs > 0) {\n        const waitMs = Math.min(backoffMs, Math.max(0, deadline - Date.now()));\n        if (waitMs === 0) break;\n        await this.wait(waitMs);\n        if (this.stopped || generation !== this.reconnectGeneration) return;\n      }\n\n      const remaining = deadline - Date.now();\n      if (remaining < 0) break;\n      try {\n        const ws = await this.openResumeSocket(Math.min(signalingResumeAttemptTimeoutMs, Math.max(1, remaining)));\n        if (this.stopped || generation !== this.reconnectGeneration) {\n          ws.close();\n          return;\n        }\n        this.resumeSocket = null;\n        this.reconnecting = false;\n        this.installSignaling(ws);\n        return;\n      } catch {\n        backoffMs = backoffMs === 0 ? 250 : Math.min(backoffMs * 2, signalingResumeMaxBackoffMs);\n      }\n    }\n\n    if (!this.stopped && generation === this.reconnectGeneration) {\n      this.reconnecting = false;\n      this.terminateWithError(new Error(\"unable to resume signaling with the selected gateway\"));\n    }\n  }\n\n  private openResumeSocket(timeoutMs: number): Promise<WebSocket> {\n    return new Promise((resolve, reject) => {\n      const u = new URL(this.gatewayURL!);\n      u.searchParams.set(\"token\", this.readToken!);\n      const ws = new WebSocket(u.toString());\n      this.resumeSocket = ws;\n      let settled = false;\n      const timer = setTimeout(() => fail(), timeoutMs);\n\n      const fail = () => {\n        if (settled) return;\n        settled = true;\n        clearTimeout(timer);\n        if (this.resumeSocket === ws) this.resumeSocket = null;\n        ws.onmessage = null;\n        ws.onerror = null;\n        ws.onclose = null;\n        ws.close();\n        reject(new Error(\"signaling resume attempt failed\"));\n      };\n\n      ws.onmessage = (ev: MessageEvent) => {\n        try {\n          const msg = JSON.parse(ev.data as string);\n          if (msg.type !== \"resumed\" || settled) return;\n          settled = true;\n          clearTimeout(timer);\n          resolve(ws);\n        } catch {\n          // Ignore malformed messages while waiting for the resume acknowledgement.\n        }\n      };\n      ws.onerror = fail;\n      ws.onclose = fail;\n    });\n  }\n\n  private wait(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n\n  private terminateWithError(err: Error): void {\n    this.stopped = true;\n    this.cancelMediaRecovery();\n    this.reconnectGeneration++;\n    this.resumeSocket?.close();\n    this.resumeSocket = null;\n    this.sig?.close();\n    this.sig = null;\n    this.pc?.close();\n    this.pc = null;\n    this.unwatchStreamTracks();\n    this.localStream?.getTracks().forEach((track) => track.stop());\n    this.localStream = null;\n    this.hasAnswer = false;\n    this.pendingRemoteCandidates = [];\n    this.readToken = null;\n    this.gatewayURL = null;\n    this.opts.callbacks?.onError?.(err);\n  }\n\n  private handleSignal(msg: SignalMessage): void {\n    switch (msg.type) {\n      case \"answer\": {\n        if (!this.pc) return;\n        this.pc\n          .setRemoteDescription(\n            new RTCSessionDescription({ type: \"answer\", sdp: msg.sdp }),\n          )\n          .then(() => {\n            this.hasAnswer = true;\n            // Flush any ICE candidates that arrived before the answer.\n            for (const init of this.pendingRemoteCandidates) {\n              this.pc?.addIceCandidate(init).catch(() => {\n                /* ignore stale candidates */\n              });\n            }\n            this.pendingRemoteCandidates = [];\n          })\n          .catch((err) => {\n            this.opts.callbacks?.onError?.(\n              new Error(`failed to set remote description: ${err}`),\n            );\n          });\n        break;\n      }\n\n      case \"ice_candidate\": {\n        if (!this.pc) return;\n        const init: RTCIceCandidateInit = {\n          candidate: msg.candidate,\n          sdpMid: msg.sdp_mid ?? null,\n          sdpMLineIndex: msg.sdp_mline_index ?? null,\n          usernameFragment: msg.username_fragment ?? null,\n        };\n        if (this.hasAnswer) {\n          this.pc.addIceCandidate(init).catch(() => {\n            /* ignore stale candidates */\n          });\n        } else {\n          this.pendingRemoteCandidates.push(init);\n        }\n        break;\n      }\n\n      case \"connection_state\": {\n        // The server echoes the peer connection state; the onconnectionstatechange\n        // handler above already covers this, but callers can also react via\n        // onConnectionStateChange.\n        break;\n      }\n\n      case \"media_stall\":\n      case \"media_track_ended\": {\n        void this.beginMediaRecovery(msg.track);\n        break;\n      }\n\n      case \"media_resumed\": {\n        this.completeMediaRecovery(msg.track);\n        break;\n      }\n\n      case \"error\": {\n        this.opts.callbacks?.onError?.(new Error(msg.error));\n        break;\n      }\n\n      case \"resumed\":\n        break;\n    }\n  }\n\n  private async beginMediaRecovery(trackType: string): Promise<void> {\n    if (this.stopped || this.recoveringMedia || this.recoveryRequired) return;\n\n    const tracks = this.localStream?.getVideoTracks() ?? [];\n    const liveTracks = tracks.filter((track) => track.readyState !== \"ended\");\n    if (liveTracks.length === 0) {\n      this.failMediaRecovery(trackType, \"capture_ended\");\n      return;\n    }\n\n    this.recoveringMedia = true;\n    const generation = ++this.recoveryGeneration;\n    this.recoveryAction = \"sender_restart\";\n    this.emitRecoveryTransition({ state: \"recovering\", track: trackType, action: \"sender_restart\" });\n    this.sendRecoveryDiagnostic(\"recovery_started\", trackType, \"sender_restart\");\n\n    await this.restartSenders(liveTracks, generation);\n    if (!this.isCurrentRecovery(generation)) return;\n\n    await this.wait(senderRecoveryWaitMs);\n    if (!this.isCurrentRecovery(generation)) return;\n\n    this.recoveryAction = \"ice_restart\";\n    this.emitRecoveryTransition({ state: \"recovering\", track: trackType, action: \"ice_restart\" });\n    this.sendRecoveryDiagnostic(\"recovery_retry\", trackType, \"ice_restart\");\n    try {\n      await this.renegotiate(true);\n    } catch {\n      // The fixed recovery window below still gives signaling-resume a chance.\n      // If media does not recover, the host receives onRecoveryRequired.\n    }\n\n    await this.wait(iceRecoveryWaitMs);\n    if (!this.isCurrentRecovery(generation)) return;\n    this.failMediaRecovery(trackType, \"automatic_recovery_failed\");\n  }\n\n  private async restartSenders(tracks: MediaStreamTrack[], generation: number): Promise<void> {\n    const live = new Set(tracks);\n    const senders = this.pc?.getSenders().filter(\n      (sender) => sender.track && live.has(sender.track),\n    ) ?? [];\n    if (senders.length === 0) return;\n\n    const originals = senders.map((sender) => ({ sender, track: sender.track! }));\n    try {\n      await Promise.all(originals.map(({ sender }) => sender.replaceTrack(null)));\n      await this.wait(senderRestartPauseMs);\n      if (!this.isCurrentRecovery(generation)) return;\n      await Promise.all(originals.map(({ sender, track }) => sender.replaceTrack(track)));\n      await this.renegotiate(false);\n    } catch {\n      // ICE restart is the second stage and may still recover a sender reset or\n      // renegotiation failure, so do not fail the stream at this stage.\n    }\n  }\n\n  private async renegotiate(iceRestart: boolean): Promise<void> {\n    const pc = this.pc;\n    const signaling = this.sig;\n    if (!pc || !signaling) throw new Error(\"publisher signaling is unavailable\");\n\n    if (iceRestart) pc.restartIce?.();\n    const offer = await pc.createOffer(iceRestart ? { iceRestart: true } : undefined);\n    await pc.setLocalDescription(offer);\n    await this.gatherComplete();\n\n    const local = pc.localDescription;\n    if (!local) throw new Error(\"local description missing\");\n    this.hasAnswer = false;\n    this.pendingRemoteCandidates = [];\n    signaling.send({ type: \"offer\", sdp: local.sdp, sdp_type: \"offer\" });\n  }\n\n  private completeMediaRecovery(trackType: string): void {\n    if (!this.recoveringMedia) return;\n    const action = this.recoveryAction ?? undefined;\n    this.cancelMediaRecovery();\n    this.emitRecoveryTransition({ state: \"recovered\", track: trackType, action });\n  }\n\n  private failMediaRecovery(\n    trackType: string,\n    reason: \"capture_ended\" | \"automatic_recovery_failed\",\n  ): void {\n    if (this.stopped || this.recoveryRequired) return;\n    this.recoveryRequired = true;\n    const action = this.recoveryAction ?? undefined;\n    this.cancelMediaRecovery();\n    const event: PublisherRecoveryEvent = { state: \"failed\", track: trackType, action, reason };\n    this.emitRecoveryTransition(event);\n    this.opts.callbacks?.onRecoveryRequired?.(event);\n    this.sendRecoveryDiagnostic(\"recovery_failed\", trackType, action, reason);\n  }\n\n  private cancelMediaRecovery(): void {\n    this.recoveryGeneration++;\n    this.recoveringMedia = false;\n    this.recoveryAction = null;\n  }\n\n  private isCurrentRecovery(generation: number): boolean {\n    return !this.stopped && this.recoveringMedia && generation === this.recoveryGeneration;\n  }\n\n  private emitRecoveryTransition(event: PublisherRecoveryEvent): void {\n    this.opts.callbacks?.onRecoveryStateChange?.(event);\n  }\n\n  private sendRecoveryDiagnostic(\n    event: \"recovery_started\" | \"recovery_retry\" | \"recovery_failed\",\n    track: string,\n    action?: PublisherRecoveryAction,\n    reason?: \"capture_ended\" | \"automatic_recovery_failed\",\n  ): void {\n    this.sig?.send({ type: \"recovery_event\", event, track, action, reason });\n  }\n\n  private watchStreamTracks(stream: MediaStream): void {\n    for (const track of stream.getVideoTracks()) {\n      const handler: EventListener = () => this.failMediaRecovery(\"screen\", \"capture_ended\");\n      track.addEventListener(\"ended\", handler);\n      this.trackEndHandlers.set(track, handler);\n    }\n  }\n\n  private unwatchStreamTracks(): void {\n    for (const [track, handler] of this.trackEndHandlers) {\n      track.removeEventListener(\"ended\", handler);\n    }\n    this.trackEndHandlers.clear();\n  }\n\n  /** Waits for ICE gathering to reach the \"complete\" state. */\n  private gatherComplete(): Promise<void> {\n    return new Promise((resolve) => {\n      const pc = this.pc;\n      if (!pc) {\n        resolve();\n        return;\n      }\n      if (pc.iceGatheringState === \"complete\") {\n        resolve();\n        return;\n      }\n      const handler = () => {\n        if (pc.iceGatheringState === \"complete\") {\n          pc.removeEventListener(\"icegatheringstatechange\", handler);\n          resolve();\n        }\n      };\n      pc.addEventListener(\"icegatheringstatechange\", handler);\n    });\n  }\n}\n","/**\n * Options for {@link captureCamera}.\n *\n * These are merged shallowly over the library defaults: any field you provide\n * replaces the default for that field entirely (e.g. passing `video` overrides\n * the default video constraints rather than merging into them). Omit a field to\n * keep its default.\n */\nexport interface CaptureCameraOptions {\n  /**\n   * Video constraints, or `true`/`false`. Defaults to a modest resolution and\n   * frame rate (see {@link captureCamera}). Set `false` to disable video.\n   */\n  video?: MediaTrackConstraints | boolean;\n  /**\n   * Audio constraints, or `true`/`false`. Defaults to `false` — Argus is a\n   * video-frame streaming system, so audio is off unless you ask for it.\n   */\n  audio?: MediaTrackConstraints | boolean;\n  /**\n   * The `MediaDevices` instance to capture from. Defaults to the global\n   * `navigator.mediaDevices`. Pass another window's `navigator.mediaDevices`\n   * (e.g. a Document Picture-in-Picture window's) so the browser's permission\n   * prompt and transient-activation check are anchored to that window rather\n   * than the one holding the global `navigator`.\n   */\n  mediaDevices?: MediaDevices;\n}\n\n/**\n * Options for {@link captureScreen}.\n *\n * These are merged shallowly over the library defaults: any field you provide\n * replaces the default for that field entirely. Omit a field to keep its\n * default.\n */\nexport interface CaptureScreenOptions {\n  /**\n   * Video constraints, or `true`. Defaults to a capped width and a low frame\n   * rate (see {@link captureScreen}).\n   */\n  video?: MediaTrackConstraints | boolean;\n  /**\n   * Audio constraints, or `true`/`false`. Defaults to `false` — screen shares\n   * rarely need audio for a video-frame streaming system.\n   */\n  audio?: MediaTrackConstraints | boolean;\n  /**\n   * The `MediaDevices` instance to capture from. Defaults to the global\n   * `navigator.mediaDevices`. Pass another window's `navigator.mediaDevices`\n   * (e.g. a Document Picture-in-Picture window's) so the screen picker and its\n   * transient-activation check are anchored to that window rather than the one\n   * holding the global `navigator`.\n   */\n  mediaDevices?: MediaDevices;\n}\n\n/**\n * Captures the user's camera via `navigator.mediaDevices.getUserMedia`,\n * applying sensible defaults for a video-frame streaming system.\n *\n * Defaults:\n * - `video`: `{ width: { ideal: 1280 }, height: { ideal: 720 }, frameRate: { ideal: 30 } }`\n *   — a modest resolution that keeps upload bandwidth reasonable. Cameras are\n *   rarely the 4k bandwidth problem that screen capture is, so this is an\n *   `ideal` (a hint) rather than a hard cap.\n * - `audio`: `false` — this is a video-frame streaming system.\n *\n * Any option you pass replaces the corresponding default outright (shallow\n * merge), so pass a full `video` constraints object if you want to tweak it.\n *\n * @example\n * ```ts\n * const stream = await captureCamera();\n * await publisher.start(stream);\n * ```\n *\n * @example Front camera with audio:\n * ```ts\n * const stream = await captureCamera({\n *   video: { facingMode: \"user\" },\n *   audio: true,\n * });\n * ```\n */\nexport async function captureCamera(\n  opts: CaptureCameraOptions = {},\n): Promise<MediaStream> {\n  const constraints: MediaStreamConstraints = {\n    video: opts.video ?? {\n      width: { ideal: 1280 },\n      height: { ideal: 720 },\n      frameRate: { ideal: 30 },\n    },\n    audio: opts.audio ?? false,\n  };\n  const mediaDevices = opts.mediaDevices ?? navigator.mediaDevices;\n  return mediaDevices.getUserMedia(constraints);\n}\n\n/**\n * Captures a screen / window / tab via\n * `navigator.mediaDevices.getDisplayMedia`, applying sensible defaults tuned to\n * avoid the HiDPI/Retina bandwidth trap.\n *\n * Defaults:\n * - `video`: `{ width: { max: 1920 }, frameRate: { ideal: 5, max: 10 } }`.\n *   The `width` is a **`max`, not an `ideal`**: on a 2x-Retina display the\n *   browser would otherwise capture at native resolution (often 3456px+ /\n *   effectively 4k), wasting upload bandwidth and downstream decode cost for no\n *   visible benefit. Capping the max roughly halves a 2x-Retina share while\n *   leaving smaller displays untouched. Screen content is mostly static, so the\n *   low frame rate saves further bandwidth.\n * - `audio`: `false`.\n *\n * IMPORTANT — do NOT add `resizeMode: \"none\"` here. That value forbids the\n * browser from downscaling the source, which turns the `width: { max: 1920 }`\n * cap into a no-op on exactly the Retina displays it targets. By omitting\n * `resizeMode` we let the user agent scale to satisfy the constraint (its\n * default behaviour), which is the entire point of this helper. It is tempting\n * to add `resizeMode: \"none\"` back for \"sharpness\" — don't.\n *\n * Any option you pass replaces the corresponding default outright (shallow\n * merge), so pass a full `video` constraints object if you want to tweak it.\n *\n * @example\n * ```ts\n * const stream = await captureScreen();\n * await publisher.start(stream);\n * ```\n */\nexport async function captureScreen(\n  opts: CaptureScreenOptions = {},\n): Promise<MediaStream> {\n  const constraints: MediaStreamConstraints = {\n    video: opts.video ?? {\n      width: { max: 1920 },\n      frameRate: { ideal: 5, max: 10 },\n    },\n    audio: opts.audio ?? false,\n  };\n  const mediaDevices = opts.mediaDevices ?? navigator.mediaDevices;\n  return mediaDevices.getDisplayMedia(constraints);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@furious.luke/argus-js",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Browser client for the Argus video streaming platform — publish WebRTC video to Argus media servers.",
   "keywords": [
     "argus",