sarvam-conv-ai-sdk 0.0.5 → 0.0.6

package/dist/index.d.ts

@@ -2,5 +2,6 @@ export { ConversationAgent, createConversation } from "./conversation";
 export type { Platform } from "./types";
 export type { AsyncAudioInterface, AudioData } from "./types";
 export { BrowserAudioInterface } from "./interfaces/browser";
+export { RNAudioInterface } from "./interfaces/react-native";
 export * from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAG9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAG9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -2,6 +2,9 @@
 export { ConversationAgent, createConversation } from "./conversation";
 // Browser audio interfaces
 export { BrowserAudioInterface } from "./interfaces/browser";
+// React Native audio interface
+// Note: This requires peer dependencies: react-native-audio-recorder-player, react-native-fs, react-native-sound
+export { RNAudioInterface } from "./interfaces/react-native";
 // Messages and types
 export * from "./types";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMvE,2BAA2B;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,qBAAqB;AACrB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMvE,2BAA2B;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,+BAA+B;AAC/B,iHAAiH;AACjH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,qBAAqB;AACrB,cAAc,SAAS,CAAC"}

package/dist/interfaces/react-native.d.ts

@@ -0,0 +1,133 @@
+/**
+ * React Native audio interface implementation for Sarvam Conversational AI SDK.
+ *
+ * This interface provides audio input/output capabilities for React Native applications
+ * using native audio libraries.
+ *
+ * Required peer dependencies for bare React Native:
+ * - react-native-audio-recorder-player
+ * - react-native-fs
+ * - react-native-sound
+ *
+ * Install with:
+ * npm install react-native-audio-recorder-player react-native-fs react-native-sound
+ *
+ * For iOS, also run: cd ios && pod install
+ */
+import { AsyncAudioInterface, AudioData } from "../types";
+/**
+ * React Native Audio Interface for capturing microphone input and playing audio output.
+ * Uses react-native-audio-recorder-player for recording and react-native-sound for playback.
+ *
+ * Features:
+ * - Microphone capture with configurable sample rate
+ * - Audio buffering for smooth playback
+ * - Playback with seamless chunk transitions
+ * - Interrupt support for stopping ongoing playback
+ */
+export declare class RNAudioInterface implements AsyncAudioInterface {
+    private audioRecorderPlayer;
+    private sound;
+    private nextSound;
+    private nextSoundTempFile;
+    private inputCallback;
+    private isRunning;
+    private audioQueue;
+    private isPlaying;
+    private sampleRate;
+    private recordingInterval;
+    private tempAudioFiles;
+    private isPreparingNext;
+    private audioBuffer;
+    private lastBufferTime;
+    private bufferTimeout;
+    private hasScheduledNext;
+    private currentRecordingPath;
+    private lastReadPosition;
+    private AudioRecorderPlayerClass;
+    private SoundClass;
+    private RNFS;
+    private Platform;
+    private PermissionsAndroid;
+    private readonly OVERLAP_MS;
+    private readonly MIN_BUFFER_SIZE;
+    private readonly BUFFER_FLUSH_DELAY_MS;
+    /**
+     * Create a new React Native audio interface
+     * @param sampleRate - Target sample rate for audio capture (default: 16000 Hz)
+     */
+    constructor(sampleRate?: number);
+    /**
+     * Request audio recording permissions.
+     */
+    private requestPermissions;
+    /**
+     * Start capturing audio from the microphone
+     * @param inputCallback - Callback to receive audio chunks
+     */
+    start(inputCallback: (audioData: AudioData, frameCount: number) => Promise<void>): Promise<void>;
+    /**
+     * Stop capturing audio and clean up resources
+     */
+    stop(): Promise<void>;
+    /**
+     * Output audio to the speakers
+     * Buffers small chunks together for smoother playback with reduced gaps.
+     * @param audio - Audio data in 16-bit PCM mono format
+     * @param sampleRate - Sample rate of the audio (default: 16000 Hz)
+     */
+    output(audio: AudioData, sampleRate?: number): Promise<void>;
+    /**
+     * Interrupt and stop all ongoing audio playback
+     */
+    interrupt(): void;
+    /**
+     * Flush buffered audio chunks to the playback queue.
+     */
+    private flushAudioBuffer;
+    /**
+     * Process the audio queue for playback with pre-loading for seamless transitions.
+     */
+    private processAudioQueue;
+    /**
+     * Play a sound file using react-native-sound.
+     */
+    private playSound;
+    /**
+     * Start the next prepared chunk (overlap technique).
+     */
+    private startNextChunk;
+    /**
+     * Pre-load the next audio chunk for seamless playback.
+     */
+    private prepareNextChunk;
+    /**
+     * Read audio file and extract PCM data.
+     */
+    private readAudioFile;
+    /**
+     * Convert base64 string to binary string.
+     */
+    private base64ToBinary;
+    /**
+     * Create a complete WAV file from PCM data.
+     */
+    private createWavFile;
+    /**
+     * Write a string to a DataView.
+     */
+    private writeString;
+    /**
+     * Convert ArrayBuffer to base64 string.
+     */
+    private arrayBufferToBase64;
+    /**
+     * Clean up a single temporary audio file.
+     */
+    private cleanupTempFile;
+    /**
+     * Clean up all temporary audio files.
+     */
+    private cleanupAllTempFiles;
+}
+//# sourceMappingURL=react-native.d.ts.map

package/dist/interfaces/react-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native.d.ts","sourceRoot":"","sources":["../../src/interfaces/react-native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAa1D;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,aAAa,CAA8E;IACnG,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,gBAAgB,CAAK;IAG7B,OAAO,CAAC,wBAAwB,CAAM;IACtC,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,kBAAkB,CAAM;IAGhC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAO;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAM;IAE5C;;;OAGG;gBACS,UAAU,GAAE,MAAc;IA0CtC;;OAEG;YACW,kBAAkB;IA+BhC;;;OAGG;IACG,KAAK,CACT,aAAa,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACzE,OAAO,CAAC,IAAI,CAAC;IAsEhB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmE3B;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCzE;;OAEG;IACH,SAAS,IAAI,IAAI;IAgDjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;YACW,iBAAiB;IAsD/B;;OAEG;IACH,OAAO,CAAC,SAAS;IAqDjB;;OAEG;IACH,OAAO,CAAC,cAAc;IA8CtB;;OAEG;YACW,gBAAgB;IAyD9B;;OAEG;YACW,aAAa;IAgC3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAyBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAwCrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;OAEG;YACW,eAAe;IAa7B;;OAEG;YACW,mBAAmB;CAalC"}