@ikonai/sdk 0.0.14 → 0.0.16

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

@@ -1,40 +1,29 @@
 import { IkonClient } from '../client/ikon-client';
 export interface IkonAudioOutputConfig {
     /**
-     * Target output sample rate.
+     * Multi-stream normalization configuration.
      *
-     * The browser ultimately controls the AudioContext sample rate, so this is best-effort.
-     * The decode worker resamples into the actual output rate used by the playback graph.
+     * When enabled, normalizes mixed output by the number of active streams.
      */
-    sampleRate?: number;
-    /**
-     * Target output channel count.
-     *
-     * This is used to normalize decoded streams into a single mixing format.
-     */
-    channels?: number;
-    /**
-     * Startup buffer size (seconds).
-     *
-     * This is the minimum buffered audio required before playback begins after a reset.
-     */
-    minBufferSizeSeconds?: number;
+    multiStreamNormalization?: {
+        enabled: boolean;
+    };
     /**
-     * Maximum buffered audio (seconds).
+     * Audio debugging/diagnostics configuration.
      *
-     * Larger buffers improve robustness under jitter but increase latency.
+     * When enabled, logs audio events and periodic status information.
      */
-    maxBufferSizeSeconds?: number;
+    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;
-    /**
-     * Called when the browser requires a user gesture to start audio playback.
-     */
-    onAudioUnlockRequired?: () => void;
     /**
      * Worker and transport preferences.
      *
@@ -46,7 +35,6 @@ export interface IkonAudioPlaybackConfig {
      * All of these have fallbacks for restrictive embed environments.
      */
     threading?: {
-        decodeWorker?: 'auto' | 'disabled';
         preferSharedArrayBuffer?: boolean;
         preferAudioWorklet?: boolean;
         preferWebCodecs?: boolean;
@@ -69,7 +57,6 @@ export declare class IkonAudioPlayback {
     private enabled;
     private prepared;
     private stateUnsubscribe;
-    private unlockRequiredSignaled;
     private readonly isIos;
     private recreateOnNextResume;
     private boundVisibilityChange;
@@ -79,9 +66,12 @@ export declare class IkonAudioPlayback {
     /** Timeout for AudioContext.resume() - normally resolves instantly, but some browsers hang indefinitely */
     private static readonly RESUME_TIMEOUT_MS;
     private audioContext;
+    private outputSampleRateHz;
     private audioWorkletNode;
     private scriptProcessorNode;
+    private scriptDiagnosticsTimer;
     private workletModuleUrl;
+    private workletModuleKey;
     private workletReady;
     private pendingWorkletMessages;
     private audioWorker;
@@ -137,9 +127,12 @@ export declare class IkonAudioPlayback {
      * Some browsers return a Promise that never resolves in certain edge cases.
      */
     private resumeWithTimeout;
-    private signalUnlockRequired;
     private ensureAudioWorklet;
     private ensureScriptProcessor;
+    private skipFromFallbackQueue;
+    private trimFallbackQueue;
+    private stopScriptProcessorDiagnostics;
+    private ensureScriptProcessorDiagnostics;
     private readFromFallbackQueue;
     private resumeAudioContextIfPossible;
     private recoverAudioContext;

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

@@ -13,12 +13,6 @@ export interface IkonImageCaptureResult {
     data: Uint8Array;
 }
 export declare class IkonImageCapture {
-    private readonly requestUserGesture;
-    constructor(requestUserGesture: (req: {
-        kind: 'image';
-        resume: () => void;
-        cancel?: () => void;
-    }) => void);
     private acquireCameraStream;
     captureFromCamera(request?: IkonImageCaptureRequest): Promise<IkonImageCaptureResult>;
 }

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

@@ -23,7 +23,6 @@ export declare class IkonVideoCapture {
     private ensureWorker;
     private ensurePorts;
     private getMediaStream;
-    private acquireStreamWithGestureFallback;
     start(request: IkonVideoCaptureRequest): Promise<IkonVideoCaptureHandle>;
     startCamera(options?: Omit<IkonVideoCaptureRequest, 'source'>): Promise<IkonVideoCaptureHandle>;
     startScreen(options?: Omit<IkonVideoCaptureRequest, 'source'>): Promise<IkonVideoCaptureHandle>;

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

@@ -7,7 +7,6 @@ export interface IkonVideoPlaybackConfig {
      * which avoids scheduling heavy work on the UI thread during high-frequency streaming.
      */
     threading?: {
-        decodeWorker?: 'auto' | 'disabled';
         preferOffscreenCanvas?: boolean;
     };
 }

package/media/ring-buffer.d.ts

@@ -18,4 +18,5 @@ export declare class RingBuffer<TArray extends Float32Array = Float32Array> {
     availableWrite(): number;
     push(input: Float32Array): number;
     pop(target: Float32Array): number;
+    skip(count: number): number;
 }

package/package.json

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