@edkimmel/expo-audio-stream 0.2.0

package/build/index.d.ts

@@ -0,0 +1,125 @@
+import type { EventSubscription } from "expo-modules-core";
+type Subscription = EventSubscription;
+import { AudioDataEvent, AudioRecording, RecordingConfig, StartRecordingResult, SoundConfig, PlaybackMode, Encoding, EncodingTypes, PlaybackModes, IAudioBufferConfig, IAudioPlayPayload, IAudioFrame, BufferHealthState, IBufferHealthMetrics, IAudioBufferManager, IFrameProcessor, IQualityMonitor, BufferedStreamConfig, SmartBufferConfig, SmartBufferMode, NetworkConditions } from "./types";
+import { SoundChunkPlayedEventPayload, AudioEvents, DeviceReconnectedReason, DeviceReconnectedEventPayload } from "./events";
+declare const SuspendSoundEventTurnId = "suspend-sound-events";
+export declare class ExpoPlayAudioStream {
+    /**
+     * Destroys the audio stream module, cleaning up all resources.
+     * This should be called when the module is no longer needed.
+     * It will reset all internal state and release audio resources.
+     */
+    static destroy(): void;
+    /**
+     * @deprecated Use the `Pipeline` class for more efficient audio streaming with better error handling and telemetry.
+     * Plays a sound.
+     * @param {string} audio - The audio to play.
+     * @param {string} turnId - The turn ID.
+     * @param {string} [encoding] - The encoding format of the audio data ('pcm_f32le' or 'pcm_s16le').
+     * @returns {Promise<void>}
+     * @throws {Error} If the sound fails to play.
+     */
+    static playSound(audio: string, turnId: string, encoding?: Encoding): Promise<void>;
+    /**
+     * @deprecated Use the `Pipeline` class for more efficient audio streaming with better error handling and telemetry.
+     * Stops the currently playing sound.
+     * @returns {Promise<void>}
+     * @throws {Error} If the sound fails to stop.
+     */
+    static stopSound(): Promise<void>;
+    /**
+     * @deprecated Use the `Pipeline` class for more efficient audio streaming with better error handling and telemetry.
+     * Clears the sound queue by turn ID.
+     * @param {string} turnId - The turn ID.
+     * @returns {Promise<void>}
+     * @throws {Error} If the sound queue fails to clear.
+     */
+    static clearSoundQueueByTurnId(turnId: string): Promise<void>;
+    /**
+     * Starts microphone streaming.
+     * @param {RecordingConfig} recordingConfig - The recording configuration.
+     * @returns {Promise<{recordingResult: StartRecordingResult, subscription: Subscription}>} A promise that resolves to an object containing the recording result and a subscription to audio events.
+     * @throws {Error} If the recording fails to start.
+     */
+    static startMicrophone(recordingConfig: RecordingConfig): Promise<{
+        recordingResult: StartRecordingResult;
+        subscription?: Subscription;
+    }>;
+    /**
+     * Stops the current microphone streaming.
+     * @returns {Promise<void>}
+     * @throws {Error} If the microphone streaming fails to stop.
+     */
+    static stopMicrophone(): Promise<AudioRecording | null>;
+    /**
+     * Subscribes to audio events emitted during recording/streaming.
+     * @param onMicrophoneStream - Callback function that will be called when audio data is received.
+     * The callback receives an AudioDataEvent containing:
+     * - data: Base64 encoded audio data at original sample rate
+     * - data16kHz: Optional base64 encoded audio data resampled to 16kHz
+     * - position: Current position in the audio stream
+     * - fileUri: URI of the recording file
+     * - eventDataSize: Size of the current audio data chunk
+     * - totalSize: Total size of recorded audio so far
+     * @returns {Subscription} A subscription object that can be used to unsubscribe from the events
+     * @throws {Error} If encoded audio data is missing from the event
+     */
+    static subscribeToAudioEvents(onMicrophoneStream: (event: AudioDataEvent) => Promise<void>): Subscription;
+    /**
+     * Subscribes to events emitted when a sound chunk has finished playing.
+     * @param onSoundChunkPlayed - Callback function that will be called when a sound chunk is played.
+     * The callback receives a SoundChunkPlayedEventPayload indicating if this was the final chunk.
+     * @returns {Subscription} A subscription object that can be used to unsubscribe from the events.
+     */
+    static subscribeToSoundChunkPlayed(onSoundChunkPlayed: (event: SoundChunkPlayedEventPayload) => Promise<void>): Subscription;
+    /**
+     * Subscribes to events emitted by the audio stream module, for advanced use cases.
+     * @param eventName - The name of the event to subscribe to.
+     * @param onEvent - Callback function that will be called when the event is emitted.
+     * @returns {Subscription} A subscription object that can be used to unsubscribe from the events.
+     */
+    static subscribe<T extends unknown>(eventName: string, onEvent: (event: T | undefined) => Promise<void>): Subscription;
+    /**
+     * Sets the sound player configuration.
+     * @param {SoundConfig} config - Configuration options for the sound player.
+     * @returns {Promise<void>}
+     * @throws {Error} If the configuration fails to update.
+     */
+    static setSoundConfig(config: SoundConfig): Promise<void>;
+    /**
+     * Prompts the user to select the microphone mode.
+     * @returns {Promise<void>}
+     * @throws {Error} If the microphone mode fails to prompt.
+     */
+    static promptMicrophoneModes(): void;
+    /**
+     * Toggles the silence state of the microphone.
+     * @returns {Promise<void>}
+     * @throws {Error} If the microphone fails to toggle silence.
+     */
+    static toggleSilence(isSilent: boolean): void;
+    /**
+     * Requests microphone permission from the user.
+     * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission result.
+     */
+    static requestPermissionsAsync(): Promise<{
+        granted: boolean;
+        canAskAgain?: boolean;
+        status?: string;
+    }>;
+    /**
+     * Gets the current microphone permission status.
+     * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission status.
+     */
+    static getPermissionsAsync(): Promise<{
+        granted: boolean;
+        canAskAgain?: boolean;
+        status?: string;
+    }>;
+}
+export { AudioDataEvent, SoundChunkPlayedEventPayload, DeviceReconnectedReason, DeviceReconnectedEventPayload, AudioRecording, RecordingConfig, StartRecordingResult, AudioEvents, SuspendSoundEventTurnId, SoundConfig, PlaybackMode, Encoding, EncodingTypes, PlaybackModes, IAudioBufferConfig, IAudioPlayPayload, IAudioFrame, BufferHealthState, IBufferHealthMetrics, IAudioBufferManager, IFrameProcessor, IQualityMonitor, BufferedStreamConfig, SmartBufferConfig, SmartBufferMode, NetworkConditions, };
+export type { EventSubscription } from "expo-modules-core";
+export type { Subscription } from "./events";
+export { Pipeline } from "./pipeline";
+export type { ConnectPipelineOptions, ConnectPipelineResult, PushPipelineAudioOptions, InvalidatePipelineTurnOptions, PipelineState, PipelineEventMap, PipelineEventName, PipelineBufferTelemetry, PipelineTelemetry, PipelineStateChangedEvent, PipelinePlaybackStartedEvent, PipelineErrorEvent, PipelineZombieDetectedEvent, PipelineUnderrunEvent, PipelineDrainedEvent, PipelineAudioFocusLostEvent, PipelineAudioFocusResumedEvent, } from "./pipeline";
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/index.js

@@ -0,0 +1,222 @@
+import ExpoPlayAudioStreamModule from "./ExpoPlayAudioStreamModule";
+import { EncodingTypes, PlaybackModes, } from "./types";
+import { addAudioEventListener, addSoundChunkPlayedListener, AudioEvents, subscribeToEvent, } from "./events";
+const SuspendSoundEventTurnId = "suspend-sound-events";
+export class ExpoPlayAudioStream {
+    /**
+     * Destroys the audio stream module, cleaning up all resources.
+     * This should be called when the module is no longer needed.
+     * It will reset all internal state and release audio resources.
+     */
+    static destroy() {
+        ExpoPlayAudioStreamModule.destroy();
+    }
+    /**
+     * @deprecated Use the `Pipeline` class for more efficient audio streaming with better error handling and telemetry.
+     * Plays a sound.
+     * @param {string} audio - The audio to play.
+     * @param {string} turnId - The turn ID.
+     * @param {string} [encoding] - The encoding format of the audio data ('pcm_f32le' or 'pcm_s16le').
+     * @returns {Promise<void>}
+     * @throws {Error} If the sound fails to play.
+     */
+    static async playSound(audio, turnId, encoding) {
+        try {
+            await ExpoPlayAudioStreamModule.playSound(audio, turnId, encoding ?? EncodingTypes.PCM_S16LE);
+        }
+        catch (error) {
+            console.error(error);
+            throw new Error(`Failed to enqueue audio: ${error}`);
+        }
+    }
+    /**
+     * @deprecated Use the `Pipeline` class for more efficient audio streaming with better error handling and telemetry.
+     * Stops the currently playing sound.
+     * @returns {Promise<void>}
+     * @throws {Error} If the sound fails to stop.
+     */
+    static async stopSound() {
+        try {
+            await ExpoPlayAudioStreamModule.stopSound();
+        }
+        catch (error) {
+            console.error(error);
+            throw new Error(`Failed to stop enqueued audio: ${error}`);
+        }
+    }
+    /**
+     * @deprecated Use the `Pipeline` class for more efficient audio streaming with better error handling and telemetry.
+     * Clears the sound queue by turn ID.
+     * @param {string} turnId - The turn ID.
+     * @returns {Promise<void>}
+     * @throws {Error} If the sound queue fails to clear.
+     */
+    static async clearSoundQueueByTurnId(turnId) {
+        try {
+            await ExpoPlayAudioStreamModule.clearSoundQueueByTurnId(turnId);
+        }
+        catch (error) {
+            console.error(error);
+            throw new Error(`Failed to clear sound queue: ${error}`);
+        }
+    }
+    /**
+     * Starts microphone streaming.
+     * @param {RecordingConfig} recordingConfig - The recording configuration.
+     * @returns {Promise<{recordingResult: StartRecordingResult, subscription: Subscription}>} A promise that resolves to an object containing the recording result and a subscription to audio events.
+     * @throws {Error} If the recording fails to start.
+     */
+    static async startMicrophone(recordingConfig) {
+        let subscription;
+        try {
+            const { onAudioStream, ...options } = recordingConfig;
+            if (onAudioStream && typeof onAudioStream == "function") {
+                subscription = addAudioEventListener(async (event) => {
+                    const { fileUri, deltaSize, totalSize, position, encoded, soundLevel, } = event;
+                    if (!encoded) {
+                        console.error(`[ExpoPlayAudioStream] Encoded audio data is missing`);
+                        throw new Error("Encoded audio data is missing");
+                    }
+                    onAudioStream?.({
+                        data: encoded,
+                        position,
+                        fileUri,
+                        eventDataSize: deltaSize,
+                        totalSize,
+                        soundLevel,
+                    });
+                });
+            }
+            const result = await ExpoPlayAudioStreamModule.startMicrophone(options);
+            return { recordingResult: result, subscription };
+        }
+        catch (error) {
+            console.error(error);
+            subscription?.remove();
+            throw new Error(`Failed to start recording: ${error}`);
+        }
+    }
+    /**
+     * Stops the current microphone streaming.
+     * @returns {Promise<void>}
+     * @throws {Error} If the microphone streaming fails to stop.
+     */
+    static async stopMicrophone() {
+        try {
+            return await ExpoPlayAudioStreamModule.stopMicrophone();
+        }
+        catch (error) {
+            console.error(error);
+            throw new Error(`Failed to stop mic stream: ${error}`);
+        }
+    }
+    /**
+     * Subscribes to audio events emitted during recording/streaming.
+     * @param onMicrophoneStream - Callback function that will be called when audio data is received.
+     * The callback receives an AudioDataEvent containing:
+     * - data: Base64 encoded audio data at original sample rate
+     * - data16kHz: Optional base64 encoded audio data resampled to 16kHz
+     * - position: Current position in the audio stream
+     * - fileUri: URI of the recording file
+     * - eventDataSize: Size of the current audio data chunk
+     * - totalSize: Total size of recorded audio so far
+     * @returns {Subscription} A subscription object that can be used to unsubscribe from the events
+     * @throws {Error} If encoded audio data is missing from the event
+     */
+    static subscribeToAudioEvents(onMicrophoneStream) {
+        return addAudioEventListener(async (event) => {
+            const { fileUri, deltaSize, totalSize, position, encoded, soundLevel } = event;
+            if (!encoded) {
+                console.error(`[ExpoPlayAudioStream] Encoded audio data is missing`);
+                throw new Error("Encoded audio data is missing");
+            }
+            onMicrophoneStream?.({
+                data: encoded,
+                position,
+                fileUri,
+                eventDataSize: deltaSize,
+                totalSize,
+                soundLevel,
+            });
+        });
+    }
+    /**
+     * Subscribes to events emitted when a sound chunk has finished playing.
+     * @param onSoundChunkPlayed - Callback function that will be called when a sound chunk is played.
+     * The callback receives a SoundChunkPlayedEventPayload indicating if this was the final chunk.
+     * @returns {Subscription} A subscription object that can be used to unsubscribe from the events.
+     */
+    static subscribeToSoundChunkPlayed(onSoundChunkPlayed) {
+        return addSoundChunkPlayedListener(onSoundChunkPlayed);
+    }
+    /**
+     * Subscribes to events emitted by the audio stream module, for advanced use cases.
+     * @param eventName - The name of the event to subscribe to.
+     * @param onEvent - Callback function that will be called when the event is emitted.
+     * @returns {Subscription} A subscription object that can be used to unsubscribe from the events.
+     */
+    static subscribe(eventName, onEvent) {
+        return subscribeToEvent(eventName, onEvent);
+    }
+    /**
+     * Sets the sound player configuration.
+     * @param {SoundConfig} config - Configuration options for the sound player.
+     * @returns {Promise<void>}
+     * @throws {Error} If the configuration fails to update.
+     */
+    static async setSoundConfig(config) {
+        try {
+            await ExpoPlayAudioStreamModule.setSoundConfig(config);
+        }
+        catch (error) {
+            console.error(error);
+            throw new Error(`Failed to set sound configuration: ${error}`);
+        }
+    }
+    /**
+     * Prompts the user to select the microphone mode.
+     * @returns {Promise<void>}
+     * @throws {Error} If the microphone mode fails to prompt.
+     */
+    static promptMicrophoneModes() {
+        ExpoPlayAudioStreamModule.promptMicrophoneModes();
+    }
+    /**
+     * Toggles the silence state of the microphone.
+     * @returns {Promise<void>}
+     * @throws {Error} If the microphone fails to toggle silence.
+     */
+    static toggleSilence(isSilent) {
+        ExpoPlayAudioStreamModule.toggleSilence(isSilent);
+    }
+    /**
+     * Requests microphone permission from the user.
+     * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission result.
+     */
+    static async requestPermissionsAsync() {
+        try {
+            return await ExpoPlayAudioStreamModule.requestPermissionsAsync();
+        }
+        catch (error) {
+            console.error(error);
+            throw new Error(`Failed to request permissions: ${error}`);
+        }
+    }
+    /**
+     * Gets the current microphone permission status.
+     * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission status.
+     */
+    static async getPermissionsAsync() {
+        try {
+            return await ExpoPlayAudioStreamModule.getPermissionsAsync();
+        }
+        catch (error) {
+            console.error(error);
+            throw new Error(`Failed to get permissions: ${error}`);
+        }
+    }
+}
+export { AudioEvents, SuspendSoundEventTurnId, EncodingTypes, PlaybackModes, };
+// Export native audio pipeline V3
+export { Pipeline } from "./pipeline";
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventSubscription } from \"expo-modules-core\";\nimport ExpoPlayAudioStreamModule from \"./ExpoPlayAudioStreamModule\";\n\n// Type alias for backwards compatibility\ntype Subscription = EventSubscription;\nimport {\n  AudioDataEvent,\n  AudioRecording,\n  RecordingConfig,\n  StartRecordingResult,\n  SoundConfig,\n  PlaybackMode,\n  Encoding,\n  EncodingTypes,\n  PlaybackModes,\n  // Audio jitter buffer types\n  IAudioBufferConfig,\n  IAudioPlayPayload,\n  IAudioFrame,\n  BufferHealthState,\n  IBufferHealthMetrics,\n  IAudioBufferManager,\n  IFrameProcessor,\n  IQualityMonitor,\n  BufferedStreamConfig,\n  SmartBufferConfig,\n  SmartBufferMode,\n  NetworkConditions,\n} from \"./types\";\n\nimport {\n  addAudioEventListener,\n  addSoundChunkPlayedListener,\n  AudioEventPayload,\n  SoundChunkPlayedEventPayload,\n  AudioEvents,\n  subscribeToEvent,\n  DeviceReconnectedReason,\n  DeviceReconnectedEventPayload,\n} from \"./events\";\n\nconst SuspendSoundEventTurnId = \"suspend-sound-events\";\n\nexport class ExpoPlayAudioStream {\n  /**\n   * Destroys the audio stream module, cleaning up all resources.\n   * This should be called when the module is no longer needed.\n   * It will reset all internal state and release audio resources.\n   */\n  static destroy() {\n    ExpoPlayAudioStreamModule.destroy();\n  }\n\n  /**\n   * @deprecated Use the `Pipeline` class for more efficient audio streaming with better error handling and telemetry.\n   * Plays a sound.\n   * @param {string} audio - The audio to play.\n   * @param {string} turnId - The turn ID.\n   * @param {string} [encoding] - The encoding format of the audio data ('pcm_f32le' or 'pcm_s16le').\n   * @returns {Promise<void>}\n   * @throws {Error} If the sound fails to play.\n   */\n  static async playSound(\n    audio: string,\n    turnId: string,\n    encoding?: Encoding\n  ): Promise<void> {\n    try {\n      await ExpoPlayAudioStreamModule.playSound(\n        audio,\n        turnId,\n        encoding ?? EncodingTypes.PCM_S16LE\n      );\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to enqueue audio: ${error}`);\n    }\n  }\n\n  /**\n   * @deprecated Use the `Pipeline` class for more efficient audio streaming with better error handling and telemetry.\n   * Stops the currently playing sound.\n   * @returns {Promise<void>}\n   * @throws {Error} If the sound fails to stop.\n   */\n  static async stopSound(): Promise<void> {\n    try {\n      await ExpoPlayAudioStreamModule.stopSound();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to stop enqueued audio: ${error}`);\n    }\n  }\n\n  /**\n   * @deprecated Use the `Pipeline` class for more efficient audio streaming with better error handling and telemetry.\n   * Clears the sound queue by turn ID.\n   * @param {string} turnId - The turn ID.\n   * @returns {Promise<void>}\n   * @throws {Error} If the sound queue fails to clear.\n   */\n  static async clearSoundQueueByTurnId(turnId: string): Promise<void> {\n    try {\n      await ExpoPlayAudioStreamModule.clearSoundQueueByTurnId(turnId);\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to clear sound queue: ${error}`);\n    }\n  }\n\n  /**\n   * Starts microphone streaming.\n   * @param {RecordingConfig} recordingConfig - The recording configuration.\n   * @returns {Promise<{recordingResult: StartRecordingResult, subscription: Subscription}>} A promise that resolves to an object containing the recording result and a subscription to audio events.\n   * @throws {Error} If the recording fails to start.\n   */\n  static async startMicrophone(recordingConfig: RecordingConfig): Promise<{\n    recordingResult: StartRecordingResult;\n    subscription?: Subscription;\n  }> {\n    let subscription: Subscription | undefined;\n    try {\n      const { onAudioStream, ...options } = recordingConfig;\n\n      if (onAudioStream && typeof onAudioStream == \"function\") {\n        subscription = addAudioEventListener(\n          async (event: AudioEventPayload) => {\n            const {\n              fileUri,\n              deltaSize,\n              totalSize,\n              position,\n              encoded,\n              soundLevel,\n            } = event;\n            if (!encoded) {\n              console.error(\n                `[ExpoPlayAudioStream] Encoded audio data is missing`\n              );\n              throw new Error(\"Encoded audio data is missing\");\n            }\n            onAudioStream?.({\n              data: encoded,\n              position,\n              fileUri,\n              eventDataSize: deltaSize,\n              totalSize,\n              soundLevel,\n            });\n          }\n        );\n      }\n\n      const result = await ExpoPlayAudioStreamModule.startMicrophone(options);\n\n      return { recordingResult: result, subscription };\n    } catch (error) {\n      console.error(error);\n      subscription?.remove();\n      throw new Error(`Failed to start recording: ${error}`);\n    }\n  }\n\n  /**\n   * Stops the current microphone streaming.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone streaming fails to stop.\n   */\n  static async stopMicrophone(): Promise<AudioRecording | null> {\n    try {\n      return await ExpoPlayAudioStreamModule.stopMicrophone();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to stop mic stream: ${error}`);\n    }\n  }\n\n  /**\n   * Subscribes to audio events emitted during recording/streaming.\n   * @param onMicrophoneStream - Callback function that will be called when audio data is received.\n   * The callback receives an AudioDataEvent containing:\n   * - data: Base64 encoded audio data at original sample rate\n   * - data16kHz: Optional base64 encoded audio data resampled to 16kHz\n   * - position: Current position in the audio stream\n   * - fileUri: URI of the recording file\n   * - eventDataSize: Size of the current audio data chunk\n   * - totalSize: Total size of recorded audio so far\n   * @returns {Subscription} A subscription object that can be used to unsubscribe from the events\n   * @throws {Error} If encoded audio data is missing from the event\n   */\n  static subscribeToAudioEvents(\n    onMicrophoneStream: (event: AudioDataEvent) => Promise<void>\n  ): Subscription {\n    return addAudioEventListener(async (event: AudioEventPayload) => {\n      const { fileUri, deltaSize, totalSize, position, encoded, soundLevel } =\n        event;\n      if (!encoded) {\n        console.error(`[ExpoPlayAudioStream] Encoded audio data is missing`);\n        throw new Error(\"Encoded audio data is missing\");\n      }\n      onMicrophoneStream?.({\n        data: encoded,\n        position,\n        fileUri,\n        eventDataSize: deltaSize,\n        totalSize,\n        soundLevel,\n      });\n    });\n  }\n\n  /**\n   * Subscribes to events emitted when a sound chunk has finished playing.\n   * @param onSoundChunkPlayed - Callback function that will be called when a sound chunk is played.\n   * The callback receives a SoundChunkPlayedEventPayload indicating if this was the final chunk.\n   * @returns {Subscription} A subscription object that can be used to unsubscribe from the events.\n   */\n  static subscribeToSoundChunkPlayed(\n    onSoundChunkPlayed: (event: SoundChunkPlayedEventPayload) => Promise<void>\n  ): Subscription {\n    return addSoundChunkPlayedListener(onSoundChunkPlayed);\n  }\n\n  /**\n   * Subscribes to events emitted by the audio stream module, for advanced use cases.\n   * @param eventName - The name of the event to subscribe to.\n   * @param onEvent - Callback function that will be called when the event is emitted.\n   * @returns {Subscription} A subscription object that can be used to unsubscribe from the events.\n   */\n  static subscribe<T extends unknown>(\n    eventName: string,\n    onEvent: (event: T | undefined) => Promise<void>\n  ): Subscription {\n    return subscribeToEvent(eventName, onEvent);\n  }\n\n  /**\n   * Sets the sound player configuration.\n   * @param {SoundConfig} config - Configuration options for the sound player.\n   * @returns {Promise<void>}\n   * @throws {Error} If the configuration fails to update.\n   */\n  static async setSoundConfig(config: SoundConfig): Promise<void> {\n    try {\n      await ExpoPlayAudioStreamModule.setSoundConfig(config);\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to set sound configuration: ${error}`);\n    }\n  }\n\n  /**\n   * Prompts the user to select the microphone mode.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone mode fails to prompt.\n   */\n  static promptMicrophoneModes() {\n    ExpoPlayAudioStreamModule.promptMicrophoneModes();\n  }\n\n  /**\n   * Toggles the silence state of the microphone.\n   * @returns {Promise<void>}\n   * @throws {Error} If the microphone fails to toggle silence.\n   */\n  static toggleSilence(isSilent: boolean) {\n    ExpoPlayAudioStreamModule.toggleSilence(isSilent);\n  }\n\n  /**\n   * Requests microphone permission from the user.\n   * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission result.\n   */\n  static async requestPermissionsAsync(): Promise<{\n    granted: boolean;\n    canAskAgain?: boolean;\n    status?: string;\n  }> {\n    try {\n      return await ExpoPlayAudioStreamModule.requestPermissionsAsync();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to request permissions: ${error}`);\n    }\n  }\n\n  /**\n   * Gets the current microphone permission status.\n   * @returns {Promise<{granted: boolean, canAskAgain?: boolean, status?: string}>} A promise that resolves to the permission status.\n   */\n  static async getPermissionsAsync(): Promise<{\n    granted: boolean;\n    canAskAgain?: boolean;\n    status?: string;\n  }> {\n    try {\n      return await ExpoPlayAudioStreamModule.getPermissionsAsync();\n    } catch (error) {\n      console.error(error);\n      throw new Error(`Failed to get permissions: ${error}`);\n    }\n  }\n}\n\nexport {\n  AudioDataEvent,\n  SoundChunkPlayedEventPayload,\n  DeviceReconnectedReason,\n  DeviceReconnectedEventPayload,\n  AudioRecording,\n  RecordingConfig,\n  StartRecordingResult,\n  AudioEvents,\n  SuspendSoundEventTurnId,\n  SoundConfig,\n  PlaybackMode,\n  Encoding,\n  EncodingTypes,\n  PlaybackModes,\n  // Audio jitter buffer types\n  IAudioBufferConfig,\n  IAudioPlayPayload,\n  IAudioFrame,\n  BufferHealthState,\n  IBufferHealthMetrics,\n  IAudioBufferManager,\n  IFrameProcessor,\n  IQualityMonitor,\n  BufferedStreamConfig,\n  SmartBufferConfig,\n  SmartBufferMode,\n  NetworkConditions,\n};\n\n// Re-export Subscription type for backwards compatibility\nexport type { EventSubscription } from \"expo-modules-core\";\nexport type { Subscription } from \"./events\";\n\n// Export native audio pipeline V3\nexport { Pipeline } from \"./pipeline\";\nexport type {\n  ConnectPipelineOptions,\n  ConnectPipelineResult,\n  PushPipelineAudioOptions,\n  InvalidatePipelineTurnOptions,\n  PipelineState,\n  PipelineEventMap,\n  PipelineEventName,\n  PipelineBufferTelemetry,\n  PipelineTelemetry,\n  PipelineStateChangedEvent,\n  PipelinePlaybackStartedEvent,\n  PipelineErrorEvent,\n  PipelineZombieDetectedEvent,\n  PipelineUnderrunEvent,\n  PipelineDrainedEvent,\n  PipelineAudioFocusLostEvent,\n  PipelineAudioFocusResumedEvent,\n} from \"./pipeline\";\n"]}

package/build/pipeline/index.d.ts

@@ -0,0 +1,81 @@
+import type { EventSubscription } from 'expo-modules-core';
+import type { ConnectPipelineOptions, ConnectPipelineResult, PushPipelineAudioOptions, InvalidatePipelineTurnOptions, PipelineState, PipelineEventMap, PipelineEventName, PipelineTelemetry } from './types';
+export declare class Pipeline {
+    /**
+     * Connect the native audio pipeline.
+     *
+     * Creates an AudioTrack (buffer size from device HAL), jitter buffer, and
+     * MAX_PRIORITY write thread. Config is immutable per session — disconnect
+     * and reconnect to change sample rate.
+     */
+    static connect(options?: ConnectPipelineOptions): Promise<ConnectPipelineResult>;
+    /**
+     * Disconnect the pipeline. Tears down AudioTrack, write thread, audio
+     * focus, volume guard, and zombie detection.
+     */
+    static disconnect(): Promise<void>;
+    /**
+     * Push base64-encoded PCM16 audio into the jitter buffer (async).
+     *
+     * Use this when you need error propagation via Promise rejection.
+     * For the hot path (e.g., inside a WebSocket message handler), prefer
+     * [pushAudioSync] which avoids Promise overhead.
+     */
+    static pushAudio(options: PushPipelineAudioOptions): Promise<void>;
+    /**
+     * Push base64-encoded PCM16 audio synchronously (no Promise overhead).
+     *
+     * Designed for the hot path — call this from your WebSocket onmessage
+     * handler for minimum latency. Returns `true` on success, `false` on
+     * failure (errors are also reported via PipelineError events).
+     */
+    static pushAudioSync(options: PushPipelineAudioOptions): boolean;
+    /**
+     * Invalidate the current turn. Resets the jitter buffer so stale audio
+     * from the old turn is discarded immediately.
+     */
+    static invalidateTurn(options: InvalidatePipelineTurnOptions): Promise<void>;
+    /** Get the current pipeline state synchronously. */
+    static getState(): PipelineState;
+    /** Get a telemetry snapshot (buffer levels, counters, etc.). */
+    static getTelemetry(): PipelineTelemetry;
+    /**
+     * Subscribe to a specific pipeline event with full type safety.
+     *
+     * @example
+     * ```ts
+     * const sub = Pipeline.subscribe('PipelineStateChanged', async (e) => {
+     *   console.log('State:', e.state);
+     * });
+     * // Later:
+     * sub.remove();
+     * ```
+     */
+    static subscribe<K extends PipelineEventName>(eventName: K, listener: (event: PipelineEventMap[K]) => Promise<void> | void): EventSubscription;
+    /**
+     * Convenience: subscribe to both PipelineError and PipelineZombieDetected.
+     *
+     * Useful for a single error handler that covers fatal and near-fatal
+     * conditions. The callback receives a normalized `{ code, message }`.
+     */
+    static onError(listener: (error: {
+        code: string;
+        message: string;
+    }) => void): {
+        remove: () => void;
+    };
+    /**
+     * Convenience: subscribe to audio focus loss and resumption events.
+     *
+     * During focus loss the pipeline writes silence instead of real audio.
+     * The caller should typically invalidateTurn + re-request audio from the
+     * AI backend on focus regain.
+     */
+    static onAudioFocus(listener: (event: {
+        focused: boolean;
+    }) => void): {
+        remove: () => void;
+    };
+}
+export type { ConnectPipelineOptions, ConnectPipelineResult, PushPipelineAudioOptions, InvalidatePipelineTurnOptions, PipelineState, PipelineEventMap, PipelineEventName, PipelineBufferTelemetry, PipelineTelemetry, PipelineStateChangedEvent, PipelinePlaybackStartedEvent, PipelineErrorEvent, PipelineZombieDetectedEvent, PipelineUnderrunEvent, PipelineDrainedEvent, PipelineAudioFocusLostEvent, PipelineAudioFocusResumedEvent, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/build/pipeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,qBAAa,QAAQ;IAKnB;;;;;;OAMG;WACU,OAAO,CAClB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC;IAIjC;;;OAGG;WACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxC;;;;;;OAMG;WACU,SAAS,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxE;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO;IAQhE;;;OAGG;WACU,cAAc,CACzB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,IAAI,CAAC;IAQhB,oDAAoD;IACpD,MAAM,CAAC,QAAQ,IAAI,aAAa;IAIhC,gEAAgE;IAChE,MAAM,CAAC,YAAY,IAAI,iBAAiB;IAQxC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,iBAAiB,EAC1C,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAC7D,iBAAiB;IAWpB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CACZ,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAC3D;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE;IAuBzB;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CACjB,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAC9C;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE;CAmB1B;AAGD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,SAAS,CAAC"}

package/build/pipeline/index.js

@@ -0,0 +1,140 @@
+// ────────────────────────────────────────────────────────────────────────────
+// Native Audio Pipeline — V3 TypeScript Wrapper
+// ────────────────────────────────────────────────────────────────────────────
+//
+// Thin wrapper over the existing ExpoPlayAudioStreamModule (not a new native
+// module). Uses static methods matching the existing codebase pattern.
+//
+// Hot path:  pushAudioSync() — synchronous Function call, no Promise overhead.
+// Cold path: pushAudio()     — async with error propagation via Promise.
+import ExpoPlayAudioStreamModule from '../ExpoPlayAudioStreamModule';
+import { subscribeToEvent } from '../events';
+export class Pipeline {
+    // ════════════════════════════════════════════════════════════════════════
+    // Lifecycle
+    // ════════════════════════════════════════════════════════════════════════
+    /**
+     * Connect the native audio pipeline.
+     *
+     * Creates an AudioTrack (buffer size from device HAL), jitter buffer, and
+     * MAX_PRIORITY write thread. Config is immutable per session — disconnect
+     * and reconnect to change sample rate.
+     */
+    static async connect(options = {}) {
+        return await ExpoPlayAudioStreamModule.connectPipeline(options);
+    }
+    /**
+     * Disconnect the pipeline. Tears down AudioTrack, write thread, audio
+     * focus, volume guard, and zombie detection.
+     */
+    static async disconnect() {
+        return await ExpoPlayAudioStreamModule.disconnectPipeline();
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // Push audio
+    // ════════════════════════════════════════════════════════════════════════
+    /**
+     * Push base64-encoded PCM16 audio into the jitter buffer (async).
+     *
+     * Use this when you need error propagation via Promise rejection.
+     * For the hot path (e.g., inside a WebSocket message handler), prefer
+     * [pushAudioSync] which avoids Promise overhead.
+     */
+    static async pushAudio(options) {
+        return await ExpoPlayAudioStreamModule.pushPipelineAudio(options);
+    }
+    /**
+     * Push base64-encoded PCM16 audio synchronously (no Promise overhead).
+     *
+     * Designed for the hot path — call this from your WebSocket onmessage
+     * handler for minimum latency. Returns `true` on success, `false` on
+     * failure (errors are also reported via PipelineError events).
+     */
+    static pushAudioSync(options) {
+        return ExpoPlayAudioStreamModule.pushPipelineAudioSync(options);
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // Turn management
+    // ════════════════════════════════════════════════════════════════════════
+    /**
+     * Invalidate the current turn. Resets the jitter buffer so stale audio
+     * from the old turn is discarded immediately.
+     */
+    static async invalidateTurn(options) {
+        return await ExpoPlayAudioStreamModule.invalidatePipelineTurn(options);
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // State & Telemetry
+    // ════════════════════════════════════════════════════════════════════════
+    /** Get the current pipeline state synchronously. */
+    static getState() {
+        return ExpoPlayAudioStreamModule.getPipelineState();
+    }
+    /** Get a telemetry snapshot (buffer levels, counters, etc.). */
+    static getTelemetry() {
+        return ExpoPlayAudioStreamModule.getPipelineTelemetry();
+    }
+    // ════════════════════════════════════════════════════════════════════════
+    // Event subscriptions
+    // ════════════════════════════════════════════════════════════════════════
+    /**
+     * Subscribe to a specific pipeline event with full type safety.
+     *
+     * @example
+     * ```ts
+     * const sub = Pipeline.subscribe('PipelineStateChanged', async (e) => {
+     *   console.log('State:', e.state);
+     * });
+     * // Later:
+     * sub.remove();
+     * ```
+     */
+    static subscribe(eventName, listener) {
+        return subscribeToEvent(eventName, async (event) => {
+            if (event !== undefined) {
+                await listener(event);
+            }
+        });
+    }
+    /**
+     * Convenience: subscribe to both PipelineError and PipelineZombieDetected.
+     *
+     * Useful for a single error handler that covers fatal and near-fatal
+     * conditions. The callback receives a normalized `{ code, message }`.
+     */
+    static onError(listener) {
+        const subs = [];
+        subs.push(Pipeline.subscribe('PipelineError', async (e) => {
+            listener({ code: e.code, message: e.message });
+        }));
+        subs.push(Pipeline.subscribe('PipelineZombieDetected', async (e) => {
+            listener({
+                code: 'ZOMBIE_DETECTED',
+                message: `AudioTrack stalled for ${e.stalledMs}ms at head=${e.playbackHead}`,
+            });
+        }));
+        return {
+            remove: () => subs.forEach((s) => s.remove()),
+        };
+    }
+    /**
+     * Convenience: subscribe to audio focus loss and resumption events.
+     *
+     * During focus loss the pipeline writes silence instead of real audio.
+     * The caller should typically invalidateTurn + re-request audio from the
+     * AI backend on focus regain.
+     */
+    static onAudioFocus(listener) {
+        const subs = [];
+        subs.push(Pipeline.subscribe('PipelineAudioFocusLost', async () => {
+            listener({ focused: false });
+        }));
+        subs.push(Pipeline.subscribe('PipelineAudioFocusResumed', async () => {
+            listener({ focused: true });
+        }));
+        return {
+            remove: () => subs.forEach((s) => s.remove()),
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/build/pipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"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","sourcesContent":["// ────────────────────────────────────────────────────────────────────────────\n// Native Audio Pipeline — V3 TypeScript Wrapper\n// ────────────────────────────────────────────────────────────────────────────\n//\n// Thin wrapper over the existing ExpoPlayAudioStreamModule (not a new native\n// module). Uses static methods matching the existing codebase pattern.\n//\n// Hot path:  pushAudioSync() — synchronous Function call, no Promise overhead.\n// Cold path: pushAudio()     — async with error propagation via Promise.\n\nimport type { EventSubscription } from 'expo-modules-core';\nimport ExpoPlayAudioStreamModule from '../ExpoPlayAudioStreamModule';\nimport { subscribeToEvent } from '../events';\n\nimport type {\n  ConnectPipelineOptions,\n  ConnectPipelineResult,\n  PushPipelineAudioOptions,\n  InvalidatePipelineTurnOptions,\n  PipelineState,\n  PipelineEventMap,\n  PipelineEventName,\n  PipelineTelemetry,\n} from './types';\n\nexport class Pipeline {\n  // ════════════════════════════════════════════════════════════════════════\n  // Lifecycle\n  // ════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Connect the native audio pipeline.\n   *\n   * Creates an AudioTrack (buffer size from device HAL), jitter buffer, and\n   * MAX_PRIORITY write thread. Config is immutable per session — disconnect\n   * and reconnect to change sample rate.\n   */\n  static async connect(\n    options: ConnectPipelineOptions = {}\n  ): Promise<ConnectPipelineResult> {\n    return await ExpoPlayAudioStreamModule.connectPipeline(options);\n  }\n\n  /**\n   * Disconnect the pipeline. Tears down AudioTrack, write thread, audio\n   * focus, volume guard, and zombie detection.\n   */\n  static async disconnect(): Promise<void> {\n    return await ExpoPlayAudioStreamModule.disconnectPipeline();\n  }\n\n  // ════════════════════════════════════════════════════════════════════════\n  // Push audio\n  // ════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Push base64-encoded PCM16 audio into the jitter buffer (async).\n   *\n   * Use this when you need error propagation via Promise rejection.\n   * For the hot path (e.g., inside a WebSocket message handler), prefer\n   * [pushAudioSync] which avoids Promise overhead.\n   */\n  static async pushAudio(options: PushPipelineAudioOptions): Promise<void> {\n    return await ExpoPlayAudioStreamModule.pushPipelineAudio(options);\n  }\n\n  /**\n   * Push base64-encoded PCM16 audio synchronously (no Promise overhead).\n   *\n   * Designed for the hot path — call this from your WebSocket onmessage\n   * handler for minimum latency. Returns `true` on success, `false` on\n   * failure (errors are also reported via PipelineError events).\n   */\n  static pushAudioSync(options: PushPipelineAudioOptions): boolean {\n    return ExpoPlayAudioStreamModule.pushPipelineAudioSync(options);\n  }\n\n  // ════════════════════════════════════════════════════════════════════════\n  // Turn management\n  // ════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Invalidate the current turn. Resets the jitter buffer so stale audio\n   * from the old turn is discarded immediately.\n   */\n  static async invalidateTurn(\n    options: InvalidatePipelineTurnOptions\n  ): Promise<void> {\n    return await ExpoPlayAudioStreamModule.invalidatePipelineTurn(options);\n  }\n\n  // ════════════════════════════════════════════════════════════════════════\n  // State & Telemetry\n  // ════════════════════════════════════════════════════════════════════════\n\n  /** Get the current pipeline state synchronously. */\n  static getState(): PipelineState {\n    return ExpoPlayAudioStreamModule.getPipelineState() as PipelineState;\n  }\n\n  /** Get a telemetry snapshot (buffer levels, counters, etc.). */\n  static getTelemetry(): PipelineTelemetry {\n    return ExpoPlayAudioStreamModule.getPipelineTelemetry() as PipelineTelemetry;\n  }\n\n  // ════════════════════════════════════════════════════════════════════════\n  // Event subscriptions\n  // ════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Subscribe to a specific pipeline event with full type safety.\n   *\n   * @example\n   * ```ts\n   * const sub = Pipeline.subscribe('PipelineStateChanged', async (e) => {\n   *   console.log('State:', e.state);\n   * });\n   * // Later:\n   * sub.remove();\n   * ```\n   */\n  static subscribe<K extends PipelineEventName>(\n    eventName: K,\n    listener: (event: PipelineEventMap[K]) => Promise<void> | void\n  ): EventSubscription {\n    return subscribeToEvent<PipelineEventMap[K]>(\n      eventName,\n      async (event) => {\n        if (event !== undefined) {\n          await listener(event);\n        }\n      }\n    );\n  }\n\n  /**\n   * Convenience: subscribe to both PipelineError and PipelineZombieDetected.\n   *\n   * Useful for a single error handler that covers fatal and near-fatal\n   * conditions. The callback receives a normalized `{ code, message }`.\n   */\n  static onError(\n    listener: (error: { code: string; message: string }) => void\n  ): { remove: () => void } {\n    const subs: EventSubscription[] = [];\n\n    subs.push(\n      Pipeline.subscribe('PipelineError', async (e) => {\n        listener({ code: e.code, message: e.message });\n      })\n    );\n\n    subs.push(\n      Pipeline.subscribe('PipelineZombieDetected', async (e) => {\n        listener({\n          code: 'ZOMBIE_DETECTED',\n          message: `AudioTrack stalled for ${e.stalledMs}ms at head=${e.playbackHead}`,\n        });\n      })\n    );\n\n    return {\n      remove: () => subs.forEach((s) => s.remove()),\n    };\n  }\n\n  /**\n   * Convenience: subscribe to audio focus loss and resumption events.\n   *\n   * During focus loss the pipeline writes silence instead of real audio.\n   * The caller should typically invalidateTurn + re-request audio from the\n   * AI backend on focus regain.\n   */\n  static onAudioFocus(\n    listener: (event: { focused: boolean }) => void\n  ): { remove: () => void } {\n    const subs: EventSubscription[] = [];\n\n    subs.push(\n      Pipeline.subscribe('PipelineAudioFocusLost', async () => {\n        listener({ focused: false });\n      })\n    );\n\n    subs.push(\n      Pipeline.subscribe('PipelineAudioFocusResumed', async () => {\n        listener({ focused: true });\n      })\n    );\n\n    return {\n      remove: () => subs.forEach((s) => s.remove()),\n    };\n  }\n}\n\n// Re-export all types for consumer convenience\nexport type {\n  ConnectPipelineOptions,\n  ConnectPipelineResult,\n  PushPipelineAudioOptions,\n  InvalidatePipelineTurnOptions,\n  PipelineState,\n  PipelineEventMap,\n  PipelineEventName,\n  PipelineBufferTelemetry,\n  PipelineTelemetry,\n  PipelineStateChangedEvent,\n  PipelinePlaybackStartedEvent,\n  PipelineErrorEvent,\n  PipelineZombieDetectedEvent,\n  PipelineUnderrunEvent,\n  PipelineDrainedEvent,\n  PipelineAudioFocusLostEvent,\n  PipelineAudioFocusResumedEvent,\n} from './types';\n"]}