@ikonai/sdk 1.0.45 → 1.0.46

package/media/ikon-audio-capture.d.ts

@@ -63,6 +63,12 @@ export interface IkonAudioCaptureRequest {
         bitrate?: number;
         targetIds?: number[];
     };
+    /**
+     * Optional correlation identifier embedded in the AudioStreamBegin payload. Used by the
+     * server-side CaptureButton to derive onCaptureStart/onCaptureStop from the audio path
+     * itself, eliminating any race between UI action dispatch and the audio stream.
+     */
+    correlationId?: string;
     onStopped?: () => void;
     /**
      * Called when capture encounters an error.
@@ -87,8 +93,15 @@ export interface IkonAudioCaptureHandle {
     readonly currentConstraints: MediaTrackConstraints;
     /** The current audio options (bitrate, etc.) applied to the capture. */
     readonly currentOptions: IkonAudioCaptureOptions;
-    startSegment(): void;
-    endSegment(): void;
+    /**
+     * Start a new logical recording segment. Optional correlationId identifies the originator
+     * (e.g., a CaptureButton instance) and is propagated to the server so the
+     * CaptureCorrelationBridge can fire onCaptureStart for the right registration. For the
+     * worker-encoded path the correlationId is fixed at startMic time and this argument is
+     * ignored; for the WebRTC path it is sent with each segment-start signal.
+     */
+    startSegment(correlationId?: string): void;
+    endSegment(correlationId?: string): void;
     stop(): Promise<void>;
     /** Update audio constraints on the active capture. Returns true if successful. */
     updateConstraints(constraints: MediaTrackConstraints): Promise<boolean>;

package/media/ikon-video-capture.d.ts

@@ -7,6 +7,13 @@ export interface IkonVideoCaptureRequest {
     options?: IkonVideoCaptureOptions;
     userGesture?: boolean;
     constraints?: MediaTrackConstraints;
+    /**
+     * Optional correlation identifier sent to the server-side WebRtcMediaBridge so the next
+     * VideoStreamBegin it emits for this sender carries it. Used by the CaptureCorrelationBridge
+     * to route onCaptureStart/onCaptureStop dispatches to the originating CaptureButton without
+     * racing with the UI action channel.
+     */
+    correlationId?: string;
     onStopped?: () => void;
 }
 export interface IkonVideoCaptureHandle {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikonai/sdk",
-  "version": "1.0.45",
+  "version": "1.0.46",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",

package/transport/transport.d.ts

@@ -36,9 +36,8 @@ export interface TransportCallbacks {
      * Called when the connection is closed.
      * @param reason - Optional reason for the close
      * @param wasClean - Whether the close was clean (normal)
-     * @param isServerClose - Whether the close code was 1000 or 1001, indicating server-initiated close
      */
-    onClose: (reason?: string, wasClean?: boolean, isServerClose?: boolean) => void;
+    onClose: (reason?: string, wasClean?: boolean) => void;
     /**
      * Called when an error occurs.
      */

package/utils/query-params.d.ts

@@ -8,7 +8,7 @@
  * Supported parameters:
  * - ikon-proxy        Force proxy mode on (true) or off (false)
  * - ikon-websocket    Force WebSocket transport on (true) or off (false)
- * - ikon-webtransport Force WebTransport on (true) or off (false)
+ * - ikon-webtransport Force WebTransport on (true); default is off. `false` is accepted for parity.
  * - ikon-debug        Enable SDK debug logging (true)
  * - ikon-lang         Override language detection (e.g., "en", "fi")
  * - ikon-server-url   External connect URL for shareable preview links
@@ -19,7 +19,7 @@
  * - ikon-webrtc       Force WebRTC on (true) or off (false)
  * - ikon-inspect      Enable element inspection overlay (true)
  * - ikon-retry        Enable retry loops in auth/channel connect (default true; set false to fail fast)
- * - ikon-api          Route backend API calls through same-origin /ikon/api path (true) instead of api.{env}.ikon.live
+ * - ikon-api          Route backend API calls through same-origin /ikon/api (default true on deployed apps; false to force direct calls to api.{env}.ikon.live; always off in local dev)
  */
 export declare const IKON_PARAM_PROXY = "ikon-proxy";
 export declare const IKON_PARAM_WEBSOCKET = "ikon-websocket";

package/webrtc/webrtc-signaling.d.ts

@@ -37,11 +37,23 @@ export declare class WebRTCSignaling {
      * Returns the first active video capture MediaStream, if any.
      */
     getActiveVideoCaptureStream(): MediaStream | null;
+    /**
+     * Look up a local video capture MediaStream by its app-level streamId.
+     * Capture streamId format: `webrtc_video_${sessionId}_${trackIndex}` (see sendVideoStreamBegin).
+     * Returns null if no local capture matches.
+     */
+    getLocalVideoCaptureStreamByStreamId(streamId: string): MediaStream | null;
     startAudioCapture(constraints?: MediaTrackConstraints): Promise<void>;
-    startAudioSegment(): void;
-    endAudioSegment(): void;
-    startVideoCapture(constraints?: MediaTrackConstraints, bitrate?: number, senderIndex?: number): Promise<void>;
-    startScreenCapture(constraints?: MediaTrackConstraints, bitrate?: number, senderIndex?: number): Promise<MediaStream>;
+    startAudioSegment(correlationId?: string): void;
+    endAudioSegment(correlationId?: string): void;
+    /**
+     * Communicate the originator's correlation id for a video capture sender to the server-side
+     * WebRtcMediaBridge so the next VideoStreamBegin it emits for this sender carries it.
+     * Called by the video capture path when starting a CaptureButton-initiated stream.
+     */
+    sendVideoCaptureCorrelation(senderIndex: number, correlationId?: string): void;
+    startVideoCapture(constraints?: MediaTrackConstraints, bitrate?: number, senderIndex?: number, correlationId?: string): Promise<void>;
+    startScreenCapture(constraints?: MediaTrackConstraints, bitrate?: number, senderIndex?: number, correlationId?: string): Promise<MediaStream>;
     stopVideoCapture(senderIndex: number): Promise<void>;
     private sendVideoStreamBegin;
     private sendVideoStreamEnd;