@ikonai/sdk 0.0.36 → 0.0.37

package/media/audio-constants.d.ts

@@ -19,5 +19,10 @@ export declare const PCM_POST_TARGET_MS = 80;
 export declare const PCM_POST_MAX_INTERVAL_MS = 50;
 export declare const MAX_PENDING_FRAMES = 64;
 export declare const MULTI_STREAM_NORMALIZATION_ENABLED = true;
+export declare const AUDIO_CAPTURE_DEFAULT_SAMPLE_RATE = 48000;
+export declare const AUDIO_CAPTURE_DEFAULT_CHANNELS = 1;
 export declare const AUDIO_CAPTURE_FRAME_DURATION_MS = 20;
 export declare const AUDIO_CAPTURE_DEFAULT_BITRATE = 32000;
+export declare const AUDIO_CAPTURE_DEFAULT_COMPLEXITY = 5;
+export declare const AUDIO_CAPTURE_MIN_BITRATE = 8000;
+export declare const AUDIO_CAPTURE_MAX_BITRATE = 128000;

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

@@ -1,4 +1,14 @@
 import { IkonClient } from '../client/ikon-client';
+export interface IkonAudioCaptureConfig {
+    /**
+     * Threading preferences for audio capture.
+     * These mirror the playback threading options where applicable.
+     */
+    threading?: {
+        /** Prefer WebCodecs AudioEncoder over WASM Opus. Default: false */
+        preferWebCodecs?: boolean;
+    };
+}
 export interface IkonAudioCaptureRequest {
     userGesture?: boolean;
     constraints?: MediaTrackConstraints;
@@ -22,7 +32,8 @@ export declare class IkonAudioCapture {
     private audioContext;
     private nextTrackId;
     private captures;
-    constructor(client: IkonClient);
+    private readonly config;
+    constructor(client: IkonClient, config?: IkonAudioCaptureConfig);
     private allocateTrackId;
     private ensureWorker;
     private ensureSendPort;

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

@@ -28,15 +28,6 @@ export interface IkonAudioPlaybackConfig {
         /** Allow background audio on mobile. Default: false */
         allowOnMobile?: boolean;
     };
-    /**
-     * Media Session metadata for notifications/lock screen.
-     */
-    mediaSession?: {
-        /** Title shown in media notifications. Default: 'Audio' */
-        title?: string;
-        /** Artist shown in media notifications. Default: 'Ikon AI App' */
-        artist?: string;
-    };
     /**
      * Audio debugging/diagnostics configuration.
      */
@@ -84,7 +75,15 @@ export declare class IkonAudioPlayback {
     private silentAudioElement;
     private readonly fallbackQueues;
     private readonly activeStreams;
+    private mediaSessionConfig;
     constructor(client: IkonClient, config?: IkonAudioPlaybackConfig);
+    /**
+     * Set Media Session metadata for OS-level media controls (lock screen, notifications).
+     */
+    setMediaSession(config: {
+        title?: string;
+        artist?: string;
+    } | null): void;
     /**
      * Enable or disable audio playback.
      *

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

@@ -1,11 +1,14 @@
 import { IkonClient } from '../client/ikon-client';
-import { IkonAudioCapture } from './ikon-audio-capture';
+import { IkonAudioCapture, IkonAudioCaptureConfig } from './ikon-audio-capture';
 import { IkonImageCapture } from './ikon-image-capture';
 import { IkonVideoCapture } from './ikon-video-capture';
+export interface IkonMediaCaptureConfig {
+    audio?: IkonAudioCaptureConfig;
+}
 export declare class IkonMediaCapture {
     readonly audio: IkonAudioCapture;
     readonly video: IkonVideoCapture;
     readonly image: IkonImageCapture;
-    constructor(client: IkonClient);
+    constructor(client: IkonClient, config?: IkonMediaCaptureConfig);
     dispose(): void;
 }

package/media/ikon-media.d.ts

@@ -1,9 +1,17 @@
 import { IkonClient } from '../client/ikon-client';
 import { IkonAudioPlayback, IkonAudioPlaybackConfig } from './ikon-audio-playback';
 import { IkonVideoPlayback, IkonVideoPlaybackConfig } from './ikon-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;
+}
 export interface IkonMediaConfig {
     audio?: IkonAudioPlaybackConfig;
     video?: IkonVideoPlaybackConfig;
+    /** Media Session metadata for OS-level media controls (lock screen, notifications). */
+    mediaSession?: MediaSessionConfig;
 }
 /**
  * Convenience wrapper for SDK-provided media pipelines.

package/media/index.d.ts

@@ -1,14 +1,15 @@
 export { IkonMedia } from './ikon-media';
-export type { IkonMediaConfig } from './ikon-media';
+export type { IkonMediaConfig, MediaSessionConfig } from './ikon-media';
 export { IkonAudioPlayback } from './ikon-audio-playback';
 export type { IkonAudioPlaybackConfig } from './ikon-audio-playback';
 export { IkonVideoPlayback } from './ikon-video-playback';
 export type { IkonVideoPlaybackConfig } from './ikon-video-playback';
 export { isSharedArrayBufferSupported, isAudioWorkletSupported } from './capabilities';
 export { IkonMediaCapture } from './ikon-media-capture';
+export type { IkonMediaCaptureConfig } from './ikon-media-capture';
 export { IkonVideoCapture } from './ikon-video-capture';
 export type { IkonVideoCaptureHandle, IkonVideoCaptureRequest, VideoCaptureSource } from './ikon-video-capture';
 export { IkonAudioCapture } from './ikon-audio-capture';
-export type { IkonAudioCaptureHandle, IkonAudioCaptureRequest } from './ikon-audio-capture';
+export type { IkonAudioCaptureHandle, IkonAudioCaptureRequest, IkonAudioCaptureConfig } from './ikon-audio-capture';
 export { IkonImageCapture } from './ikon-image-capture';
 export type { IkonImageCaptureRequest, IkonImageCaptureResult } from './ikon-image-capture';

package/package.json

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