@layercode/js-sdk 2.8.2 → 2.8.4

package/dist/types/index.d.ts

@@ -55,7 +55,7 @@ interface ILayercodeClient {
         default: boolean;
     }>) => void;
     mute(): void;
-    unmute(): void;
+    unmute(): Promise<void>;
     sendClientResponseText(text: string): Promise<void>;
     sendClientResponseData(data: any): Promise<void>;
     readonly status: string;
@@ -84,6 +84,13 @@ interface LayercodeClientOptions {
     audioInput?: boolean;
     /** Whether audio output is enabled. I.e. do we play the sound in the browser client */
     audioOutput?: boolean;
+    /**
+     * When true, defers actual audio hardware initialization (AudioContext, mic permissions)
+     * until setAudioInput(true) or setAudioOutput(true) is called.
+     * The server will still be told this is a voice session, but no browser audio APIs are touched until needed.
+     * This avoids Chrome's autoplay policy blocking AudioContext before user gesture.
+     */
+    deferAudioInit?: boolean;
     /** Fired when audio input flag changes */
     audioInputChanged?: (audioInput: boolean) => void;
     /** Fired when audio output flag changes */
@@ -147,6 +154,7 @@ declare class LayercodeClient implements ILayercodeClient {
     private recorderStarted;
     private readySent;
     private currentTurnId;
+    private sentReplayFinishedForDisabledOutput;
     private audioBuffer;
     private vadConfig;
     private deviceId;
@@ -158,6 +166,7 @@ declare class LayercodeClient implements ILayercodeClient {
     private stopRecorderAmplitude?;
     private deviceChangeListener;
     private recorderRestartChain;
+    private _skipFirstDeviceCallback;
     private deviceListenerReady;
     private resolveDeviceListenerReady;
     _websocketUrl: string;
@@ -218,6 +227,12 @@ declare class LayercodeClient implements ILayercodeClient {
     private _stopPlayerAmplitudeMonitoring;
     private _stopRecorderAmplitudeMonitoring;
     audioInputConnect(): Promise<void>;
+    /**
+     * Starts the recorder with a specific device (or default if undefined)
+     * This is the single point where getUserMedia is called during initial setup.
+     * Idempotent: returns early if recorder is already started or has a live stream.
+     */
+    private _startRecorderWithDevice;
     audioInputDisconnect(): Promise<void>;
     setAudioInput(state: boolean): Promise<void>;
     setAudioOutput(state: boolean): Promise<void>;
@@ -270,7 +285,6 @@ declare class LayercodeClient implements ILayercodeClient {
      */
     private _restartAudioRecording;
     private _queueRecorderRestart;
-    private _initializeRecorderWithDefaultDevice;
     /**
      * Disconnect VAD
      */
@@ -286,6 +300,10 @@ declare class LayercodeClient implements ILayercodeClient {
     private _teardownDeviceListeners;
     private _performDisconnectCleanup;
     private _getDeviceComparisonKey;
+    private _getUserActivationState;
+    private _isMicrophonePermissionDenied;
+    private _microphonePermissionDeniedError;
+    private _shouldWarnAudioDevicesRequireUserGesture;
     /**
      * Mutes the microphone to stop sending audio to the server
      * The connection and recording remain active for quick unmute
@@ -294,7 +312,7 @@ declare class LayercodeClient implements ILayercodeClient {
     /**
      * Unmutes the microphone to resume sending audio to the server
      */
-    unmute(): void;
+    unmute(): Promise<void>;
 }
 export default LayercodeClient;
 export type { ILayercodeClient, LayercodeClientOptions, AuthorizeSessionRequest, AuthorizeSessionRequestParams };

package/dist/types/interfaces.d.ts

@@ -1,4 +1,4 @@
-export type LayercodeMessageType = 'client.audio' | 'trigger.turn.start' | 'trigger.turn.end' | 'trigger.response.audio.replay_finished' | 'vad_events' | 'client.ready' | 'client.response.text' | 'client.response.data' | 'turn.start' | 'response.audio' | 'response.text' | 'response.data' | 'user.transcript.interim_delta' | 'user.transcript.delta' | 'user.transcript';
+export type LayercodeMessageType = 'client.audio' | 'trigger.turn.start' | 'trigger.turn.end' | 'trigger.response.audio.replay_finished' | 'vad_events' | 'client.ready' | 'client.response.text' | 'client.response.data' | 'turn.start' | 'response.audio' | 'response.text' | 'response.data' | 'response.end' | 'user.transcript.interim_delta' | 'user.transcript.delta' | 'user.transcript';
 export interface BaseLayercodeMessage {
     type: LayercodeMessageType;
     event_id?: string;
@@ -68,6 +68,10 @@ export interface ServerResponseUserTranscript extends BaseLayercodeMessage {
     content: string;
     turn_id: string;
 }
-export type ServerMessage = ServerTurnMessage | ServerResponseAudioMessage | ServerResponseTextMessage | ServerResponseDataMessage | ServerResponseUserTranscriptInterimDelta | ServerResponseUserTranscriptDelta | ServerResponseUserTranscript;
+export interface ServerResponseEndMessage extends BaseLayercodeMessage {
+    type: 'response.end';
+    turn_id: string;
+}
+export type ServerMessage = ServerTurnMessage | ServerResponseAudioMessage | ServerResponseTextMessage | ServerResponseDataMessage | ServerResponseEndMessage | ServerResponseUserTranscriptInterimDelta | ServerResponseUserTranscriptDelta | ServerResponseUserTranscript;
 export type ClientMessage = ClientAudioMessage | ClientTriggerTurnMessage | ClientTriggerResponseAudioReplayFinishedMessage | ClientVadEventsMessage | ClientReadyMessage | ClientResponseTextMessage | ClientResponseDataMessage;
 export type LayercodeMessage = ClientMessage | ServerMessage;

package/dist/types/wavtools/lib/analysis/audio_analysis.d.ts

@@ -31,7 +31,7 @@ export class AudioAnalysis {
     constructor(audioElement: HTMLAudioElement, audioBuffer?: AudioBuffer | null);
     fftResults: any[];
     audio: HTMLAudioElement;
-    context: OfflineAudioContext | AudioContext;
+    context: AudioContext | OfflineAudioContext;
     analyser: AnalyserNode;
     sampleRate: number;
     audioBuffer: AudioBuffer | null;

package/package.json

@@ -2,7 +2,7 @@
   "author": "Layercode",
   "license": "MIT",
   "name": "@layercode/js-sdk",
-  "version": "2.8.2",
+  "version": "2.8.4",
   "description": "Layercode JavaScript SDK for browser usage",
   "type": "module",
   "main": "dist/layercode-js-sdk.esm.js",