@ikonai/sdk 1.0.21 → 1.0.23

package/client/ikon-client.d.ts

@@ -9,6 +9,15 @@ import { IkonClientConfig } from './ikon-client-config';
  * Protocol message handler callback type for subscribers.
  */
 export type ProtocolMessageHandler = (message: ProtocolMessage) => void;
+export interface WebRTCTrackMapInfo {
+    kind: string;
+    trackIndex: number;
+    senderId: number;
+    senderTrackId: number;
+    streamId: string;
+    sourceType: string;
+    active: boolean;
+}
 /**
  * A MessagePort that receives raw protocol messages as transferred ArrayBuffers.
  *
@@ -99,6 +108,7 @@ export declare class IkonClient {
     private boundBeforeUnload;
     private boundPageHide;
     private boundVisibilityChange;
+    private boundPopstate;
     private _globalState;
     private _globalStateReceived;
     private _channelsConnected;
@@ -112,9 +122,9 @@ export declare class IkonClient {
     private readonly _media;
     private _mediaCapture;
     private _webRtcSignaling;
-    private _webRtcAudioStream;
-    private _webRtcVideoStream;
-    private _webRtcScreenStream;
+    private _webRtcAudioElements;
+    private _webRtcVideoStreams;
+    private _webRtcTrackMap;
     private _waitForExternalConnectUrl;
     private _externalConnectUrlCleanup;
     /**
@@ -135,20 +145,22 @@ export declare class IkonClient {
      */
     get isWebRtcEnabled(): boolean;
     /**
-     * WebRTC audio MediaStream (when WebRTC enabled and connected).
-     * Attach to an `<audio>` element via `element.srcObject = stream`.
+     * All WebRTC video streams keyed by track index.
+     */
+    get webRtcVideoStreams(): Map<number, MediaStream>;
+    /**
+     * Track mapping info. Keys are "kind:trackIndex" (e.g. "audio:3", "video:0").
      */
-    get webRtcAudioStream(): MediaStream | null;
+    get webRtcTrackMap(): Map<string, WebRTCTrackMapInfo>;
     /**
-     * WebRTC video MediaStream for camera (when WebRTC enabled and connected).
-     * Attach to a `<video>` element via `element.srcObject = stream`.
+     * Callback fired when a WebRTC track map update is received from the server.
      */
-    get webRtcVideoStream(): MediaStream | null;
+    onWebRtcTrackMapChanged?: (info: WebRTCTrackMapInfo) => void;
     /**
-     * WebRTC video MediaStream for screen share (when WebRTC enabled and connected).
-     * Attach to a `<video>` element via `element.srcObject = stream`.
+     * Look up the WebRTC video MediaStream for a given app-level stream ID.
+     * Returns null if no track is mapped to this stream ID or if the stream is inactive.
      */
-    get webRtcScreenStream(): MediaStream | null;
+    getWebRtcVideoStreamByStreamId(streamId: string): MediaStream | null;
     /**
      * Get the WebRTC signaling instance (when WebRTC enabled and connected).
      * Used internally by capture functions.
@@ -275,10 +287,9 @@ export declare class IkonClient {
     private setErrorState;
     private connectProtocol;
     private setupWebRtcSignaling;
-    private _webRtcAudioElement;
     private _webRtcAudioUnlockHandler;
     private readonly _webRtcMediaSession;
-    private autoPlayWebRtcAudio;
+    private playWebRtcAudioTrack;
     private setupWebRtcMediaSession;
     private removeWebRtcAudioUnlockHandler;
     private connectProtocolOnMainThread;
@@ -312,6 +323,11 @@ export declare class IkonClient {
      * Check connection health when tab becomes visible again.
      */
     private handleVisibilityChange;
+    /**
+     * Handle browser popstate event (back/forward navigation).
+     * Sends the new URL path to the server.
+     */
+    private handlePopstate;
     /**
      * Check if the connection is still healthy after page was backgrounded.
      * If connection died while backgrounded, trigger reconnection.

package/connection/urls.d.ts

@@ -83,6 +83,11 @@ export declare function parseUrlParams(): UrlParams;
  * - SSR (typeof window === 'undefined')
  */
 export declare function isCloudEnvironment(): boolean;
+/**
+ * Get the initial path from the browser URL, stripping /c/[channelKey] or /s/[sessionId] prefix.
+ * Returns just the app-specific path portion (e.g. "/buttons"), or "/" if no path remains.
+ */
+export declare function getInitialPath(): string;
 /**
  * Remove sessionId and channelKey path patterns from the URL.
  * Replaces /s/[sessionId] or /c/[channelKey] paths with root.

package/index.d.ts

@@ -1,4 +1,4 @@
-export { IkonClient, type ProtocolMessageHandler, type StateHandler, type ProtocolMessageSubscriptionOptions, type ProtocolMessagePort, type ProtocolSendPort } from './client/ikon-client';
+export { IkonClient, type ProtocolMessageHandler, type StateHandler, type ProtocolMessageSubscriptionOptions, type ProtocolMessagePort, type ProtocolSendPort, type WebRTCTrackMapInfo } from './client/ikon-client';
 export type { IkonClientConfig, LocalConfig, ApiKeyConfig, SessionTokenConfig, CloudConnectionConfig, CommonConnectionConfig, TimeoutConfig, BackendType, AudioConfig, VideoConfig, MediaSessionConfig, WebRtcConfig } from './client/ikon-client-config';
 export type { ConnectionState } from './client/connection-state';
 export { isConnecting, isConnected, isOffline, isError } from './client/connection-state';
@@ -23,5 +23,5 @@ export { IKON_AUTH_BASE_URL, IKON_AUTH_URL_PROD, IKON_AUTH_URL_DEV, IKON_BACKEND
 export { getOrCreateDeviceId, clearDeviceId, extractUserIdFromToken } from './storage';
 export { IkonMedia, IkonAudioPlayback, IkonVideoPlayback, isSharedArrayBufferSupported, isAudioWorkletSupported, IkonMediaCapture, IkonVideoCapture, IkonAudioCapture, IkonImageCapture } from './media';
 export type { IkonMediaConfig, IkonAudioPlaybackConfig, IkonVideoPlaybackConfig, IkonVideoCaptureHandle, IkonVideoCaptureRequest, IkonVideoCaptureOptions, VideoCaptureSource, IkonAudioCaptureHandle, IkonAudioCaptureRequest, IkonAudioCaptureOptions, IkonImageCaptureRequest, IkonImageCaptureResult } from './media';
-export { WebRTCConnection, WebRTCSignaling, 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_BUNDLE_POLICY, WEBRTC_RTCP_MUX_POLICY, WEBRTC_ICE_SERVERS, WEBRTC_DATA_CHANNEL_LABEL, WEBRTC_DATA_CHANNEL_ORDERED, WEBRTC_DATA_CHANNEL_MAX_RETRANSMITS } from './webrtc';
+export { WebRTCConnection, WebRTCSignaling, 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_BUNDLE_POLICY, WEBRTC_RTCP_MUX_POLICY, WEBRTC_ICE_SERVERS, WEBRTC_DATA_CHANNEL_LABEL, WEBRTC_DATA_CHANNEL_ORDERED, WEBRTC_DATA_CHANNEL_MAX_RETRANSMITS, WEBRTC_MAX_AUDIO_TRACKS, WEBRTC_MAX_VIDEO_TRACKS } from './webrtc';
 export type { WebRTCConnectionConfig, WebRTCConnectionState, WebRTCSignalingConfig } from './webrtc';