@ikonai/sdk 0.0.32 → 0.0.34

package/media/audio-constants.d.ts

@@ -18,3 +18,6 @@ export declare const JITTER_EMA_DIVISOR = 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_FRAME_DURATION_MS = 20;
+export declare const AUDIO_CAPTURE_DEFAULT_BITRATE = 32000;

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

@@ -4,11 +4,12 @@ export interface IkonAudioCaptureRequest {
     constraints?: MediaTrackConstraints;
     options?: {
         bitrate?: number;
-        frameDurationMs?: number;
     };
 }
 export interface IkonAudioCaptureHandle {
     captureId: string;
+    startSegment(): void;
+    endSegment(): void;
     stop(): Promise<void>;
 }
 export declare class IkonAudioCapture {
@@ -30,5 +31,7 @@ export declare class IkonAudioCapture {
     private ensureWorklet;
     startMic(request?: IkonAudioCaptureRequest): Promise<IkonAudioCaptureHandle>;
     stop(captureId: string): Promise<boolean>;
+    startSegment(captureId: string): boolean;
+    endSegment(captureId: string): boolean;
     dispose(): void;
 }

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

@@ -1,29 +1,5 @@
 import { IkonClient } from '../client/ikon-client';
-export interface IkonAudioOutputConfig {
-    /**
-     * Multi-stream normalization configuration.
-     *
-     * When enabled, normalizes mixed output by the number of active streams.
-     */
-    multiStreamNormalization?: {
-        enabled: boolean;
-    };
-    /**
-     * Audio debugging/diagnostics configuration.
-     *
-     * When enabled, logs audio events and periodic status information.
-     */
-    diagnostics?: {
-        enabled: boolean;
-        /** Interval for periodic status logs in seconds. Default: 5 */
-        statusInterval?: number;
-    };
-}
 export interface IkonAudioPlaybackConfig {
-    /**
-     * Output format used by the mixing graph.
-     */
-    output?: IkonAudioOutputConfig;
     /**
      * Worker and transport preferences.
      *
@@ -39,6 +15,36 @@ export interface IkonAudioPlaybackConfig {
         preferAudioWorklet?: boolean;
         preferWebCodecs?: boolean;
     };
+    /**
+     * Background audio playback configuration.
+     *
+     * Controls whether audio continues playing when the tab/app is backgrounded.
+     * When background audio is allowed, the SDK sets up Media Session API for
+     * OS-level media controls (lock screen, media keys).
+     */
+    background?: {
+        /** Allow background audio on desktop. Default: true */
+        allowOnDesktop?: boolean;
+        /** 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.
+     */
+    diagnostics?: {
+        enabled?: boolean;
+        /** Interval for periodic status logs in milliseconds. Default: 1000 */
+        statusIntervalMs?: number;
+    };
 }
 /**
  * Audio playback pipeline for Ikon protocol audio streams.
@@ -56,9 +62,9 @@ export declare class IkonAudioPlayback {
     private readonly config;
     private enabled;
     private stateUnsubscribe;
-    private readonly isIos;
-    private recreateOnNextResume;
+    private readonly isMobile;
     private boundVisibilityChange;
+    private boundPageHide;
     private unlockHandler;
     private awaitingUnlock;
     private recoveryTask;
@@ -75,6 +81,7 @@ export declare class IkonAudioPlayback {
     private pendingWorkletMessages;
     private audioWorker;
     private protocolPort;
+    private silentAudioElement;
     private readonly fallbackQueues;
     private readonly activeStreams;
     constructor(client: IkonClient, config?: IkonAudioPlaybackConfig);
@@ -98,14 +105,28 @@ export declare class IkonAudioPlayback {
      * Convenience wrapper for `setEnabled(false)`.
      */
     disable(): Promise<void>;
+    /**
+     * Pause audio output without tearing down the audio graph.
+     * Fast operation - just disconnects nodes from destination.
+     * Use this for temporary muting (e.g., Media Session pause).
+     */
+    pause(): void;
+    /**
+     * Resume audio output after pause().
+     * Fast operation - reconnects nodes to destination.
+     */
+    resume(): void;
     /**
      * Dispose of resources. After calling this, the instance should not be reused.
      */
     dispose(): void;
-    private resolveOutputConfig;
+    private resolveDiagnosticsConfig;
+    private resolveBackgroundConfig;
     private ensureAudioGraph;
     private attachAudioContextHealthHandlers;
     private attachVisibilityHandler;
+    private setupMediaSession;
+    private cleanupMediaSession;
     private removeVisibilityHandler;
     private getContextState;
     private addUnlockHandler;
@@ -126,11 +147,11 @@ export declare class IkonAudioPlayback {
     private resumeAudioContextIfPossible;
     private recoverAudioContext;
     private recoverAudioContextInternal;
-    private recreateAudioGraph;
     private rebindWorkerTransportIfNeeded;
     private ensureWorkers;
     private onAudioWorkerMessage;
     private postToWorklet;
+    private notifyPlaybackActive;
     private enqueuePendingWorkletMessage;
     private stopAudioWorklet;
     private stopScriptProcessor;

package/media/index.d.ts

@@ -1,7 +1,7 @@
 export { IkonMedia } from './ikon-media';
 export type { IkonMediaConfig } from './ikon-media';
 export { IkonAudioPlayback } from './ikon-audio-playback';
-export type { IkonAudioPlaybackConfig, IkonAudioOutputConfig } 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';

package/package.json

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