@ikonai/sdk 1.0.23 → 1.0.26

package/assets/{protocol-worker-ZToAZg1T.js → protocol-worker-Cj8zX_U0.js}

@@ -897,7 +897,7 @@ class yt {
    * Handle connection close.
    */
   handleClose(e, r) {
-    this.clearKeepaliveTimeout(), this.readLoopActive = !1, this.cleanup(), this.callbacks.onClose(e, r, r);
+    this.clearKeepaliveTimeout(), this.readLoopActive = !1, this.cleanup(), this.callbacks.onClose(e, r, !1);
   }
   /**
    * Reset the keepalive timeout.
@@ -1208,7 +1208,7 @@ class St {
    */
   handleChannelClose(e, r, s, n) {
     if (!(this.state === "idle" || this.state === "stopped" || this.state === "offline")) {
-      if (s || n) {
+      if (n) {
         I.debug("Channel closed by server"), this.shouldReconnect = !1, this.disconnectAll(), this.setState("stopped");
         return;
       }

package/client/endpoint-selector.d.ts

@@ -1,5 +1,12 @@
 import { Entrypoint, EntrypointType } from '../../../../shared/protocol/src/index.ts';
 import { LocalConfig } from './ikon-client-config';
+/**
+ * Proxy connection mode.
+ * - `force-proxy`: only try proxy URLs/transports (e.g. `?proxy=true`)
+ * - `force-direct`: only try direct URLs/transports (e.g. `?proxy=false`)
+ * - `auto`: try both, ordered by preference, with persistent learning
+ */
+export type ProxyMode = 'force-proxy' | 'force-direct' | 'auto';
 /**
  * EndpointSelector handles ordering and selection of endpoint types.
  *
@@ -9,10 +16,20 @@ import { LocalConfig } from './ikon-client-config';
  */
 export declare class EndpointSelector {
     private readonly isLocal;
+    private readonly _proxyMode;
+    private _proxyPreferred;
     private workingEndpointType;
     constructor(config: {
         local?: LocalConfig;
+        proxyMode?: ProxyMode;
     });
+    get proxyMode(): ProxyMode;
+    get proxyPreferred(): boolean;
+    /**
+     * Mark proxy as preferred and persist to localStorage.
+     * Called by IkonClient when auth-level proxy fallback succeeds in auto mode.
+     */
+    markProxyPreferred(): void;
     /**
      * Get ordered list of endpoint types to try.
      * Returns only types that exist in the provided map.
@@ -20,15 +37,13 @@ export declare class EndpointSelector {
     getOrderedTypes(byType: Map<EntrypointType, Entrypoint[]>): EntrypointType[];
     /**
      * Remember the working endpoint type for future connections.
-     * Only stores in cloud mode.
+     * In force modes, skip all localStorage persistence.
      */
     rememberWorkingType(type: EntrypointType): void;
     /**
      * Clear the remembered endpoint type.
      */
     clearRememberedType(): void;
-    /**
-     * Load remembered type from localStorage.
-     */
     private loadRememberedType;
+    private loadProxyPreference;
 }

package/client/ikon-client-config.d.ts

@@ -202,11 +202,15 @@ export interface MediaSessionConfig {
 /**
  * Audio playback pipeline configuration.
  *
- * Audio is always enabled by default. The SDK prepares the audio pipeline and starts
+ * Audio is enabled by default. The SDK prepares the audio pipeline and starts
  * decoding as soon as possible. Audio output still depends on browser autoplay policies.
  * The SDK automatically resumes the AudioContext on the first user gesture (click, touch, keypress, etc.).
  */
 export interface AudioConfig {
+    /**
+     * Enable audio playback pipeline. Default: true
+     */
+    enabled?: boolean;
     /**
      * Performance preferences for audio processing.
      */
@@ -223,10 +227,14 @@ export interface AudioConfig {
 /**
  * Video playback pipeline configuration.
  *
- * Video is always enabled by default. Video rendering requires an explicit surface (canvas)
+ * Video is enabled by default. Video rendering requires an explicit surface (canvas)
  * provided by the app. The SDK prepares worker/decoder plumbing to reduce time-to-first-frame.
  */
 export interface VideoConfig {
+    /**
+     * Enable video playback pipeline. Default: true
+     */
+    enabled?: boolean;
     performance?: IkonVideoPlaybackConfig['performance'];
 }
 /**

package/client/ikon-client.d.ts

@@ -119,10 +119,13 @@ export declare class IkonClient {
     private unregisterSoundFunctions;
     private nextProtocolPortId;
     private nextProtocolSendPortId;
+    private readonly _audioEnabled;
+    private readonly _videoEnabled;
     private readonly _media;
     private _mediaCapture;
     private _webRtcSignaling;
     private _webRtcAudioElements;
+    private _webRtcAudioStreams;
     private _webRtcVideoStreams;
     private _webRtcTrackMap;
     private _waitForExternalConnectUrl;
@@ -140,8 +143,17 @@ export declare class IkonClient {
      * These are only available in browser environments.
      */
     get mediaCapture(): IkonMediaCapture | null;
+    /**
+     * Whether audio playback is enabled.
+     */
+    get isAudioEnabled(): boolean;
+    /**
+     * Whether video playback is enabled.
+     */
+    get isVideoEnabled(): boolean;
     /**
      * Whether WebRTC is enabled for audio/video transport.
+     * Returns false if both audio and video are disabled, even if webRtc.enabled is true.
      */
     get isWebRtcEnabled(): boolean;
     /**
@@ -290,6 +302,7 @@ export declare class IkonClient {
     private _webRtcAudioUnlockHandler;
     private readonly _webRtcMediaSession;
     private playWebRtcAudioTrack;
+    private stopWebRtcAudioTrack;
     private setupWebRtcMediaSession;
     private removeWebRtcAudioUnlockHandler;
     private connectProtocolOnMainThread;

package/connection/authenticator.d.ts

@@ -1,10 +1,12 @@
 import { AuthResponse } from '../../../../shared/protocol/src/index.ts';
 import { ApiKeyConfig, LocalConfig, SessionTokenConfig } from '../client/ikon-client-config';
+import { ProxyMode } from '../client/endpoint-selector';
 /**
  * Result of authentication - contains the AuthResponse from the server.
  */
 export interface AuthResult {
     authResponse: AuthResponse;
+    usedProxyUrl?: boolean;
 }
 /**
  * Common authentication logic - fetch the connect URL and decode the AuthResponse.
@@ -29,7 +31,7 @@ export declare function authenticateLocal(config: LocalConfig, signal?: AbortSig
  * 5. POST /rooms/connect and poll until running
  * 6. Connect to the returned Ikon server URL
  */
-export declare function authenticateApiKey(config: ApiKeyConfig, signal?: AbortSignal): Promise<AuthResult>;
+export declare function authenticateApiKey(config: ApiKeyConfig, signal?: AbortSignal, proxyMode?: ProxyMode, proxyPreferred?: boolean): Promise<AuthResult>;
 /**
  * Authenticate with the Ikon backend using a pre-obtained session token.
  * Use this when the token was obtained from auth.ikonai.com (OAuth) or /auth/anonymous.
@@ -41,4 +43,4 @@ export declare function authenticateApiKey(config: ApiKeyConfig, signal?: AbortS
  * 4. POST /rooms/connect and poll until running
  * 5. Connect to the returned Ikon server URL
  */
-export declare function authenticateSessionToken(config: SessionTokenConfig, signal?: AbortSignal): Promise<AuthResult>;
+export declare function authenticateSessionToken(config: SessionTokenConfig, signal?: AbortSignal, proxyMode?: ProxyMode, proxyPreferred?: boolean): Promise<AuthResult>;

package/connection/urls.d.ts

@@ -45,6 +45,11 @@ export declare function deriveBackendType(): BackendType;
  * 4. Default → IKON_AUTH_URL_PROD
  */
 export declare function deriveAuthUrl(): string;
+/**
+ * Read the `?proxy=` query parameter.
+ * Returns `true` for `?proxy=true`, `false` for `?proxy=false`, `null` otherwise.
+ */
+export declare function getProxyQueryParam(): boolean | null;
 /**
  * Parse URL query parameters.
  */

package/index.d.ts

@@ -4,7 +4,7 @@ export type { ConnectionState } from './client/connection-state';
 export { isConnecting, isConnected, isOffline, isError } from './client/connection-state';
 export { ChannelManager, type ChannelManagerConfig, type ChannelManagerState } from './channel/channel-manager';
 export { Channel, type ChannelConfig, type ChannelState } from './channel/channel';
-export { EndpointSelector } from './client/endpoint-selector';
+export { EndpointSelector, type ProxyMode } from './client/endpoint-selector';
 export { ConnectionError, AuthenticationError, TransportError, KeepaliveTimeoutError, MaxRetriesExceededError, ProvisioningTimeoutError, ChannelNotFoundError, SpaceNotFoundError, NoChannelsError } from './errors';
 export { Opcode, EntrypointType, UserType, ClientType, ContextType } from '../../../shared/protocol/src/index.ts';
 export type { ClientReady, GlobalState, ProtocolMessage, ProtocolMessageHeaders } from '../../../shared/protocol/src/index.ts';