@ikonai/sdk 0.0.34 → 0.0.37

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

@@ -187,6 +187,50 @@ export interface TimeoutConfig {
      */
     maxReconnectAttempts?: number;
 }
+/**
+ * Media Session metadata for OS-level media controls (lock screen, notifications).
+ * Shared across audio and video playback.
+ */
+export interface MediaSessionConfig {
+    /** Title shown in media notifications. Default: 'Audio' */
+    title?: string;
+    /** Artist shown in media notifications. Default: 'Ikon AI App' */
+    artist?: string;
+}
+/**
+ * Audio playback pipeline configuration.
+ */
+export interface AudioConfig {
+    /**
+     * When enabled, 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.).
+     */
+    enabled?: boolean;
+    /**
+     * Threading and capability preferences for audio.
+     */
+    threading?: IkonAudioPlaybackConfig['threading'];
+    /**
+     * Background audio playback configuration.
+     */
+    background?: IkonAudioPlaybackConfig['background'];
+    /**
+     * Audio debugging/diagnostics configuration.
+     */
+    diagnostics?: IkonAudioPlaybackConfig['diagnostics'];
+}
+/**
+ * Video playback pipeline configuration.
+ *
+ * Video rendering requires an explicit surface (canvas) provided by the app.
+ * The SDK can still prepare worker/decoder plumbing to reduce time-to-first-frame.
+ */
+export interface VideoConfig {
+    enabled?: boolean;
+    threading?: IkonVideoPlaybackConfig['threading'];
+}
 /**
  * Configuration for IkonClient.
  */
@@ -216,63 +260,18 @@ export interface IkonClientConfig {
      */
     debug?: DebugConfig;
     /**
-     * Threading and worker configuration.
+     * Audio playback pipeline configuration.
      */
-    threading?: {
-        /**
-         * Move protocol send/receive to a WebWorker when possible.
-         * - 'auto': try to use a worker and fall back to main thread on failure
-         * - 'disabled': always use main thread transports
-         */
-        protocolWorker?: 'auto' | 'disabled';
-    };
+    audio?: AudioConfig;
     /**
-     * Media (audio/video) playback configuration.
-     *
-     * The SDK treats protocol messages as the canonical representation of streams.
-     * This section controls whether the SDK should create and prepare media pipelines
-     * (workers, decoders, AudioWorklet) to reduce time-to-first-audio/video.
-     */
-    media?: {
-        /**
-         * Audio playback pipeline.
-         */
-        audio?: {
-            /**
-             * When enabled, 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.).
-             */
-            enabled?: boolean;
-            /**
-             * Threading and capability preferences for audio.
-             */
-            threading?: IkonAudioPlaybackConfig['threading'];
-            /**
-             * Background audio playback configuration.
-             */
-            background?: IkonAudioPlaybackConfig['background'];
-            /**
-             * Media Session metadata for notifications/lock screen.
-             */
-            mediaSession?: IkonAudioPlaybackConfig['mediaSession'];
-            /**
-             * Audio debugging/diagnostics configuration.
-             */
-            diagnostics?: IkonAudioPlaybackConfig['diagnostics'];
-        };
-        /**
-         * Video playback pipeline.
-         *
-         * Video rendering requires an explicit surface (canvas) provided by the app.
-         * The SDK can still prepare worker/decoder plumbing to reduce time-to-first-frame.
-         */
-        video?: {
-            enabled?: boolean;
-            threading?: IkonVideoPlaybackConfig['threading'];
-        };
-    };
+     * Video playback pipeline configuration.
+     */
+    video?: VideoConfig;
+    /**
+     * Media Session metadata for OS-level media controls (lock screen, notifications).
+     * Shared across audio and video playback.
+     */
+    mediaSession?: MediaSessionConfig;
     /**
      * Callback when a protocol message is received.
      * The SDK handles keepalive internally; other messages are passed to this callback.

package/index.d.ts

@@ -1,5 +1,5 @@
 export { IkonClient, type ProtocolMessageHandler, type StateHandler, type ProtocolMessageSubscriptionOptions, type ProtocolMessagePort, type ProtocolSendPort } from './client/ikon-client';
-export type { IkonClientConfig, LocalConfig, ApiKeyConfig, SessionTokenConfig, CloudConnectionConfig, CommonConnectionConfig, TimeoutConfig, DebugConfig, BackendType } from './client/ikon-client-config';
+export type { IkonClientConfig, LocalConfig, ApiKeyConfig, SessionTokenConfig, CloudConnectionConfig, CommonConnectionConfig, TimeoutConfig, DebugConfig, BackendType, AudioConfig, VideoConfig, MediaSessionConfig } from './client/ikon-client-config';
 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';
@@ -13,8 +13,8 @@ export { isWebTransportSupported } from './transport/web-transport-transport';
 export { setLogLevel, setLogSink, getLogLevel, getLogSink, createLogger, LogLevel } from './utils/logger';
 export type { LogEntry, LogSink, Logger } from './utils/logger';
 export { getOpcodeName } from './utils/opcode-names';
-export { initializeLogSink, setSendLogsCallback, getBufferedLogs, takeBufferedLogs, flushLogs, clearLogBuffer, getLogBufferSize } from './utils/logSink';
-export type { LogSinkConfig } from './utils/logSink';
+export { initializeLogSink, setSendLogsCallback, getBufferedLogs, takeBufferedLogs, flushLogs, clearLogBuffer, getLogBufferSize } from './utils/log-sink';
+export type { LogSinkConfig } from './utils/log-sink';
 export { FunctionRegistry, registerBrowserFunctions, isBrowserEnvironment, type FunctionRegistryConfig } from './functions';
 export { withResultData } from './functions';
 export type { ValueDescriptor, NormalizedValueDescriptor, PrimitiveValueKind, FunctionParameterDefinition, FunctionDefinition, FunctionHandler, FunctionResultWithData } from './functions';