@ikonai/sdk 1.0.42 → 1.0.44

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

@@ -13,6 +13,11 @@ export interface IkonImageCaptureResult {
     data: Uint8Array;
 }
 export declare class IkonImageCapture {
+    /**
+     * Capture a single frame from an existing MediaStream (e.g., from an active screen share).
+     * The caller is responsible for managing the stream lifecycle.
+     */
+    captureFromStream(stream: MediaStream, request?: IkonImageCaptureRequest): Promise<IkonImageCaptureResult>;
     private acquireCameraStream;
     captureFromCamera(request?: IkonImageCaptureRequest): Promise<IkonImageCaptureResult>;
 }

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

@@ -35,5 +35,9 @@ export declare class IkonVideoCapture {
     startCamera(options?: Omit<IkonVideoCaptureRequest, 'sourceType'>): Promise<IkonVideoCaptureHandle>;
     startScreen(options?: Omit<IkonVideoCaptureRequest, 'sourceType'>): Promise<IkonVideoCaptureHandle>;
     stop(captureId: string): Promise<boolean>;
+    /**
+     * Returns the MediaStream of an active screen capture, if any.
+     */
+    getActiveScreenStream(): MediaStream | null;
     dispose(): void;
 }

package/package.json

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

package/utils/query-params.d.ts

@@ -18,7 +18,6 @@
  * - ikon-video        Force video on (true) or off (false)
  * - ikon-webrtc       Force WebRTC on (true) or off (false)
  * - ikon-inspect      Enable element inspection overlay (true)
- * - ikon-init         Enable optimized channel init flow (true)
  */
 export declare const IKON_PARAM_PROXY = "ikon-proxy";
 export declare const IKON_PARAM_WEBSOCKET = "ikon-websocket";
@@ -32,7 +31,6 @@ export declare const IKON_PARAM_AUDIO = "ikon-audio";
 export declare const IKON_PARAM_VIDEO = "ikon-video";
 export declare const IKON_PARAM_WEBRTC = "ikon-webrtc";
 export declare const IKON_PARAM_INSPECT = "ikon-inspect";
-export declare const IKON_PARAM_INIT = "ikon-init";
 /**
  * Set an SDK query parameter in the URL via history.replaceState.
  */
@@ -47,4 +45,3 @@ export declare function getAudioParam(): boolean | null;
 export declare function getVideoParam(): boolean | null;
 export declare function getWebRtcParam(): boolean | null;
 export declare function getInspectParam(): boolean;
-export declare function getInitParam(): boolean;

package/webrtc/index.d.ts

@@ -1,3 +1,3 @@
 export { WebRTCConnection, type WebRTCConnectionConfig, type WebRTCConnectionState } from './webrtc-connection';
 export { WebRTCSignaling, type WebRTCSignalingConfig } from './webrtc-signaling';
-export { WEBRTC_AUDIO_CODEC, WEBRTC_AUDIO_SAMPLE_RATE, WEBRTC_AUDIO_CHANNELS, WEBRTC_AUDIO_BITRATE, WEBRTC_AUDIO_JITTER_BUFFER_TARGET_MS, WEBRTC_VIDEO_CODEC, WEBRTC_VIDEO_MAX_BITRATE, WEBRTC_VIDEO_MAX_FRAMERATE, WEBRTC_MAX_AUDIO_TRACKS, WEBRTC_MAX_VIDEO_TRACKS, WEBRTC_BUNDLE_POLICY, WEBRTC_RTCP_MUX_POLICY, WEBRTC_ICE_SERVERS, WEBRTC_DATA_CHANNEL_LABEL, WEBRTC_DATA_CHANNEL_ORDERED, WEBRTC_DATA_CHANNEL_MAX_RETRANSMITS, } from './webrtc-config';
+export { WEBRTC_AUDIO_CODEC, WEBRTC_AUDIO_SAMPLE_RATE, WEBRTC_AUDIO_CHANNELS, WEBRTC_AUDIO_BITRATE, WEBRTC_AUDIO_JITTER_BUFFER_TARGET_MS, WEBRTC_VIDEO_CODEC, WEBRTC_VIDEO_MAX_BITRATE, WEBRTC_VIDEO_MAX_FRAMERATE, WEBRTC_MAX_AUDIO_TRACKS, WEBRTC_MAX_VIDEO_TRACKS, WEBRTC_BUNDLE_POLICY, WEBRTC_RTCP_MUX_POLICY, WEBRTC_DATA_CHANNEL_LABEL, WEBRTC_DATA_CHANNEL_ORDERED, WEBRTC_DATA_CHANNEL_MAX_RETRANSMITS, } from './webrtc-config';

package/webrtc/webrtc-config.d.ts

@@ -9,7 +9,6 @@ export declare const WEBRTC_VIDEO_MAX_FRAMERATE = 30;
 export declare const WEBRTC_VIDEO_PLAYOUT_DELAY_HINT_S = 0.05;
 export declare const WEBRTC_BUNDLE_POLICY: RTCBundlePolicy;
 export declare const WEBRTC_RTCP_MUX_POLICY: RTCRtcpMuxPolicy;
-export declare const WEBRTC_ICE_SERVERS: RTCIceServer[];
 export declare const WEBRTC_MAX_AUDIO_TRACKS = 16;
 export declare const WEBRTC_MAX_VIDEO_TRACKS = 16;
 export declare const WEBRTC_DATA_CHANNEL_LABEL = "ikon-data";

package/webrtc/webrtc-connection.d.ts

@@ -3,6 +3,7 @@ export interface WebRTCConnectionConfig {
     useAudioTrack: boolean;
     useVideoTrack: boolean;
     useDataChannel: boolean;
+    iceServers?: RTCIceServer[];
     onIceCandidate?: (candidate: RTCIceCandidate | null) => void;
     onStateChange?: (state: WebRTCConnectionState) => void;
     onDataChannelMessage?: (data: ArrayBuffer) => void;

package/webrtc/webrtc-signaling.d.ts

@@ -7,6 +7,7 @@ export interface WebRTCSignalingConfig {
     useAudioTrack: boolean;
     useVideoTrack: boolean;
     useDataChannel: boolean;
+    iceServers?: RTCIceServer[];
     onStateChange?: (state: WebRTCConnectionState) => void;
     onDataChannelMessage?: (data: ArrayBuffer) => void;
     onDataChannelOpen?: () => void;
@@ -32,6 +33,10 @@ export declare class WebRTCSignaling {
     sendDataChannelMessage(data: ArrayBuffer): void;
     private audioCaptureStream;
     private videoCaptureStreams;
+    /**
+     * Returns the first active video capture MediaStream, if any.
+     */
+    getActiveVideoCaptureStream(): MediaStream | null;
     startAudioCapture(constraints?: MediaTrackConstraints): Promise<void>;
     startAudioSegment(): void;
     endAudioSegment(): void;