@ikonai/sdk 0.0.28 → 0.0.29

package/media/audio-constants.d.ts

@@ -0,0 +1,20 @@
+export declare const REQUESTED_OUTPUT_SAMPLE_RATE = 48000;
+export declare const OUTPUT_CHANNELS = 2;
+export declare const AUDIO_BUFFER_MAX_MS = 1500;
+export declare const MAX_PENDING_WORKLET_MESSAGES = 512;
+export declare const AUDIO_CONTEXT_LATENCY_HINT: AudioContextOptions['latencyHint'];
+export declare const BUFFER_TARGET_MIN_MS = 120;
+export declare const BUFFER_TARGET_MAX_MS = 300;
+export declare const JITTER_MULTIPLIER = 4;
+export declare const CONTROL_PERIOD_MS = 200;
+export declare const UNDERRUN_JUMP_MS = 100;
+export declare const STABLE_TIME_TO_DECREASE_MS = 8000;
+export declare const DECREASE_STEP_MS = 10;
+export declare const FADE_IN_DURATION_MS = 100;
+export declare const FADE_OUT_DURATION_MS = 50;
+export declare const RENDER_QUANTUM_SIZE = 128;
+export declare const BUFFER_REDUCTION_CROSSFADE_MS = 20;
+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;

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

@@ -45,7 +45,7 @@ export interface IkonAudioPlaybackConfig {
  *
  * The key separation of responsibilities is:
  * - protocol I/O: handled by IkonClient (optionally in ProtocolWorker)
- * - decoding: done in a dedicated AudioWorker
+ * - decoding: done in a dedicated AudioPlaybackWorker
  * - rendering: done in AudioWorklet when available
  *
  * This keeps frequent audio frames off the UI thread and avoids forcing the SDK

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

@@ -21,19 +21,11 @@ export declare class IkonVideoPlayback {
     private readonly client;
     private readonly config;
     private enabled;
-    private prepared;
     private stateUnsubscribe;
     private worker;
     private protocolPort;
     private readonly surfaces;
     constructor(client: IkonClient, config?: IkonVideoPlaybackConfig);
-    /**
-     * Prepare the video pipeline. This can reduce time-to-first-frame by creating
-     * the worker and attaching the protocol subscription early.
-     *
-     * Video still requires an explicit canvas surface to actually present frames.
-     */
-    prepare(): Promise<void>;
     /**
      * Attach a canvas for a specific video stream id.
      *

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@ikonai/sdk",
-  "version": "0.0.28",
+  "version": "0.0.29",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",
+  "sideEffects": false,
   "exports": {
     ".": {
       "import": "./index.js",

package/transport/transport.d.ts

@@ -1,4 +1,4 @@
-import { ProtocolMessage } from '../../../../shared/generated/src/index.ts';
+import { ProtocolMessage } from '../../../../shared/protocol/src/index.ts';
 /**
  * Transport interface for Ikon server connections.
  * Designed to support both WebSocket and WebTransport implementations.

package/transport/web-socket-transport.d.ts

@@ -1,4 +1,4 @@
-import { ProtocolMessage } from '../../../../shared/generated/src/index.ts';
+import { ProtocolMessage } from '../../../../shared/protocol/src/index.ts';
 import { Transport, TransportConfig } from './transport';
 /**
  * WebSocket transport implementation for Ikon server connections.
@@ -6,6 +6,7 @@ import { Transport, TransportConfig } from './transport';
 export declare class WebSocketTransport implements Transport {
     private ws;
     private keepaliveTimeout;
+    private keepaliveResponseMessage;
     private readonly keepaliveTimeoutMs;
     private readonly callbacks;
     private readonly sessionId;
@@ -14,6 +15,10 @@ export declare class WebSocketTransport implements Transport {
     connect(uri: string, authTicket: Uint8Array): Promise<void>;
     send(message: ProtocolMessage): void;
     close(): void;
+    /**
+     * Get or create a cached keepalive response message.
+     */
+    private getKeepaliveResponse;
     private handleProtocolMessage;
     private resetKeepaliveTimeout;
     private clearKeepaliveTimeout;

package/transport/web-transport-transport.d.ts

@@ -1,4 +1,4 @@
-import { ProtocolMessage } from '../../../../shared/generated/src/index.ts';
+import { ProtocolMessage } from '../../../../shared/protocol/src/index.ts';
 import { Transport, TransportConfig } from './transport';
 /**
  * Check if WebTransport is supported in the current environment.
@@ -22,6 +22,11 @@ export declare class WebTransportTransport implements Transport {
     private keepaliveTimeout;
     private readLoopActive;
     private receiveBuffer;
+    private receiveBufferOffset;
+    private receiveBufferLength;
+    private receiveDataView;
+    private receiveDataViewBuffer;
+    private keepaliveResponseMessage;
     private readonly keepaliveTimeoutMs;
     private readonly callbacks;
     private readonly sessionId;
@@ -35,12 +40,22 @@ export declare class WebTransportTransport implements Transport {
      */
     private startReadLoop;
     /**
-     * Append incoming data to the receive buffer.
+     * Append incoming data to the receive buffer using grow-only strategy.
+     * Compacts when offset exceeds half capacity and data is sparse.
      */
     private appendToBuffer;
+    /**
+     * Get or create a cached DataView for the receive buffer.
+     */
+    private getReceiveDataView;
+    /**
+     * Get or create a cached keepalive response message.
+     */
+    private getKeepaliveResponse;
     /**
      * Process complete messages from the receive buffer.
      * Protocol messages start with a 4-byte little-endian length field.
+     * Uses subarray views to avoid per-message allocations.
      */
     private processBufferedMessages;
     /**

package/{media/audio-worker-messages.d.ts → worker/audio-playback-worker.d.ts}

@@ -1,26 +1,26 @@
-export type AudioWorkerTransport = 'sab' | 'pcm';
-export type AudioWorkerConfigureMessage = {
+export type AudioPlaybackWorkerTransport = 'sab' | 'pcm';
+export type AudioPlaybackWorkerConfigureMessage = {
     type: 'configure';
-    transport: AudioWorkerTransport;
+    transport: AudioPlaybackWorkerTransport;
     outputSampleRate: number;
     outputChannels: number;
     preferWebCodecs?: boolean;
 };
-export type AudioWorkerAttachProtocolPortMessage = {
+export type AudioPlaybackWorkerAttachProtocolPortMessage = {
     type: 'attachProtocolPort';
     port: MessagePort;
 };
-export type AudioWorkerRebindMessage = {
+export type AudioPlaybackWorkerRebindMessage = {
     type: 'rebind';
-    transport: AudioWorkerTransport;
+    transport: AudioPlaybackWorkerTransport;
     outputSampleRate?: number;
     outputChannels?: number;
 };
-export type AudioWorkerDisposeMessage = {
+export type AudioPlaybackWorkerDisposeMessage = {
     type: 'dispose';
 };
-export type AudioWorkerIn = AudioWorkerConfigureMessage | AudioWorkerAttachProtocolPortMessage | AudioWorkerRebindMessage | AudioWorkerDisposeMessage;
-export type AudioWorkerOut = {
+export type AudioPlaybackWorkerIn = AudioPlaybackWorkerConfigureMessage | AudioPlaybackWorkerAttachProtocolPortMessage | AudioPlaybackWorkerRebindMessage | AudioPlaybackWorkerDisposeMessage;
+export type AudioPlaybackWorkerOut = {
     type: 'streamBegin';
     streamId: string;
     sharedArrayBuffer?: SharedArrayBuffer;
@@ -43,7 +43,7 @@ export type AudioWorkerOut = {
     type: 'frame';
     streamId: string;
     epoch: number;
-    tsInterleavedSamples: number;
+    timestampInterleavedSamples: number;
     frameSizeInterleavedSamples: number;
     isFirst: boolean;
     isLast: boolean;

package/worker/video-playback-worker.d.ts

@@ -0,0 +1,59 @@
+import { VideoCodec } from '../../../../shared/protocol/src/index.ts';
+export type VideoPlaybackWorkerConfigureMessage = {
+    type: 'configure';
+};
+export type VideoPlaybackWorkerAttachProtocolPortMessage = {
+    type: 'attachProtocolPort';
+    port: MessagePort;
+};
+export type VideoPlaybackWorkerAttachSurfaceMessage = {
+    type: 'attachSurface';
+    streamId: string;
+    canvas: OffscreenCanvas;
+};
+export type VideoPlaybackWorkerDetachSurfaceMessage = {
+    type: 'detachSurface';
+    streamId: string;
+};
+export type VideoPlaybackWorkerWatchStreamMessage = {
+    type: 'watchStream';
+    streamId: string;
+};
+export type VideoPlaybackWorkerUnwatchStreamMessage = {
+    type: 'unwatchStream';
+    streamId: string;
+};
+export type VideoPlaybackWorkerSetEnabledMessage = {
+    type: 'setEnabled';
+    enabled: boolean;
+};
+export type VideoPlaybackWorkerDisposeMessage = {
+    type: 'dispose';
+};
+export type VideoPlaybackWorkerIn = VideoPlaybackWorkerConfigureMessage | VideoPlaybackWorkerAttachProtocolPortMessage | VideoPlaybackWorkerAttachSurfaceMessage | VideoPlaybackWorkerDetachSurfaceMessage | VideoPlaybackWorkerWatchStreamMessage | VideoPlaybackWorkerUnwatchStreamMessage | VideoPlaybackWorkerSetEnabledMessage | VideoPlaybackWorkerDisposeMessage;
+export type VideoPlaybackWorkerOut = {
+    type: 'streamBegin';
+    streamId: string;
+    width: number;
+    height: number;
+    codec: VideoCodec;
+} | {
+    type: 'streamEnd';
+    streamId: string;
+} | {
+    type: 'frame';
+    streamId: string;
+    width: number;
+    height: number;
+    bitmap: ImageBitmap;
+} | {
+    type: 'requestIdr';
+    streamId: string;
+} | {
+    type: 'error';
+    error: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+};