@siteed/audio-studio 3.1.1 → 3.2.0-beta.1

package/build/esm/errors/AudioStreamError.js

@@ -0,0 +1,147 @@
+const RECOVERABLE = [
+    'ERR_AUDIO_STREAM_CANCELLED',
+    'ERR_AUDIO_STREAM_BUSY',
+    'ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT',
+    'ERR_AUDIO_STREAM_PERMISSION_DENIED',
+];
+export class AudioStreamError extends Error {
+    code;
+    recoverable;
+    fileUri;
+    platform;
+    nativeCode;
+    nativeMessage;
+    constructor(payload) {
+        super(payload.message);
+        this.name = 'AudioStreamError';
+        this.code = payload.code;
+        this.recoverable = payload.recoverable;
+        this.fileUri = payload.fileUri;
+        this.platform = payload.platform;
+        this.nativeCode = payload.nativeCode;
+        this.nativeMessage = payload.nativeMessage;
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            recoverable: this.recoverable,
+            fileUri: this.fileUri,
+            platform: this.platform,
+            nativeCode: this.nativeCode,
+            nativeMessage: this.nativeMessage,
+        };
+    }
+}
+function getNativeMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === 'string')
+        return err;
+    try {
+        return JSON.stringify(err) ?? String(err);
+    }
+    catch {
+        return String(err);
+    }
+}
+function getNativeCode(err) {
+    if (err && typeof err === 'object' && 'code' in err) {
+        const code = err.code;
+        if (typeof code === 'string')
+            return code;
+    }
+    return undefined;
+}
+function normalizeCode(raw) {
+    if (!raw)
+        return null;
+    const upper = raw.toUpperCase();
+    if (upper.startsWith('ERR_AUDIO_STREAM_')) {
+        const known = [
+            'ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT',
+            'ERR_AUDIO_STREAM_INVALID_RANGE',
+            'ERR_AUDIO_STREAM_DECODE_FAILED',
+            'ERR_AUDIO_STREAM_CANCELLED',
+            'ERR_AUDIO_STREAM_PERMISSION_DENIED',
+            'ERR_AUDIO_STREAM_FILE_NOT_FOUND',
+            'ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT',
+            'ERR_AUDIO_STREAM_NATIVE_UNAVAILABLE',
+            'ERR_AUDIO_STREAM_BUSY',
+            'ERR_AUDIO_STREAM_UNKNOWN',
+        ];
+        if (known.includes(upper)) {
+            return upper;
+        }
+    }
+    if (upper.includes('FILE_NOT_FOUND') || upper === 'ENOENT') {
+        return 'ERR_AUDIO_STREAM_FILE_NOT_FOUND';
+    }
+    if (upper.includes('PERMISSION') || upper === 'EACCES') {
+        return 'ERR_AUDIO_STREAM_PERMISSION_DENIED';
+    }
+    if (upper.includes('UNSUPPORTED') ||
+        upper.includes('NO_SUITABLE_CODEC') ||
+        upper.includes('NO SUITABLE CODEC') ||
+        upper.includes('NOT SUPPORTED')) {
+        return 'ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT';
+    }
+    if (upper.includes('INVALID_RANGE') ||
+        upper.includes('OUT_OF_RANGE') ||
+        upper.includes('INVALID_TIME')) {
+        return 'ERR_AUDIO_STREAM_INVALID_RANGE';
+    }
+    if (upper.includes('CANCELLED') || upper.includes('CANCELED')) {
+        return 'ERR_AUDIO_STREAM_CANCELLED';
+    }
+    if (upper.includes('BUSY')) {
+        return 'ERR_AUDIO_STREAM_BUSY';
+    }
+    if (upper.includes('BACKPRESSURE')) {
+        return 'ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT';
+    }
+    if (upper.includes('DECODE') ||
+        upper.includes('CODEC') ||
+        upper.includes('MALFORMED')) {
+        return 'ERR_AUDIO_STREAM_DECODE_FAILED';
+    }
+    return null;
+}
+export function mapStreamError(err, fileUri, platform) {
+    if (err instanceof AudioStreamError)
+        return err;
+    const nativeMessage = getNativeMessage(err);
+    const nativeCode = getNativeCode(err);
+    const lower = nativeMessage.toLowerCase();
+    let code = normalizeCode(nativeCode) ??
+        normalizeCode(nativeMessage) ??
+        'ERR_AUDIO_STREAM_UNKNOWN';
+    if (code === 'ERR_AUDIO_STREAM_UNKNOWN') {
+        if (lower.includes('not found') || lower.includes('does not exist')) {
+            code = 'ERR_AUDIO_STREAM_FILE_NOT_FOUND';
+        }
+        else if (lower.includes('unsupported') ||
+            lower.includes('no suitable codec')) {
+            code = 'ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT';
+        }
+        else if (lower.includes('permission') || lower.includes('denied')) {
+            code = 'ERR_AUDIO_STREAM_PERMISSION_DENIED';
+        }
+        else if (lower.includes('decode') || lower.includes('codec')) {
+            code = 'ERR_AUDIO_STREAM_DECODE_FAILED';
+        }
+        else if (lower.includes('cancel')) {
+            code = 'ERR_AUDIO_STREAM_CANCELLED';
+        }
+    }
+    return new AudioStreamError({
+        code,
+        message: `Audio stream failed (${code}): ${nativeMessage}`,
+        recoverable: RECOVERABLE.includes(code),
+        fileUri,
+        platform,
+        nativeCode,
+        nativeMessage,
+    });
+}
+//# sourceMappingURL=AudioStreamError.js.map

package/build/esm/errors/AudioStreamError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioStreamError.js","sourceRoot":"","sources":["../../../src/errors/AudioStreamError.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Stable typed errors for `streamAudioData`. Callers can switch on `code`.\n */\nexport type AudioStreamErrorCode =\n    | 'ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT'\n    | 'ERR_AUDIO_STREAM_INVALID_RANGE'\n    | 'ERR_AUDIO_STREAM_DECODE_FAILED'\n    | 'ERR_AUDIO_STREAM_CANCELLED'\n    | 'ERR_AUDIO_STREAM_PERMISSION_DENIED'\n    | 'ERR_AUDIO_STREAM_FILE_NOT_FOUND'\n    | 'ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT'\n    | 'ERR_AUDIO_STREAM_NATIVE_UNAVAILABLE'\n    | 'ERR_AUDIO_STREAM_BUSY'\n    | 'ERR_AUDIO_STREAM_UNKNOWN'\n\nexport interface AudioStreamErrorPayload {\n    code: AudioStreamErrorCode\n    message: string\n    recoverable: boolean\n    fileUri?: string\n    platform?: string\n    nativeCode?: string\n    nativeMessage?: string\n}\n\nconst RECOVERABLE: AudioStreamErrorCode[] = [\n    'ERR_AUDIO_STREAM_CANCELLED',\n    'ERR_AUDIO_STREAM_BUSY',\n    'ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT',\n    'ERR_AUDIO_STREAM_PERMISSION_DENIED',\n]\n\nexport class AudioStreamError extends Error {\n    readonly code: AudioStreamErrorCode\n    readonly recoverable: boolean\n    readonly fileUri?: string\n    readonly platform?: string\n    readonly nativeCode?: string\n    readonly nativeMessage?: string\n\n    constructor(payload: AudioStreamErrorPayload) {\n        super(payload.message)\n        this.name = 'AudioStreamError'\n        this.code = payload.code\n        this.recoverable = payload.recoverable\n        this.fileUri = payload.fileUri\n        this.platform = payload.platform\n        this.nativeCode = payload.nativeCode\n        this.nativeMessage = payload.nativeMessage\n    }\n\n    toJSON(): AudioStreamErrorPayload {\n        return {\n            code: this.code,\n            message: this.message,\n            recoverable: this.recoverable,\n            fileUri: this.fileUri,\n            platform: this.platform,\n            nativeCode: this.nativeCode,\n            nativeMessage: this.nativeMessage,\n        }\n    }\n}\n\nfunction getNativeMessage(err: unknown): string {\n    if (err instanceof Error) return err.message\n    if (typeof err === 'string') return err\n    try {\n        return JSON.stringify(err) ?? String(err)\n    } catch {\n        return String(err)\n    }\n}\n\nfunction getNativeCode(err: unknown): string | undefined {\n    if (err && typeof err === 'object' && 'code' in err) {\n        const code = (err as { code?: unknown }).code\n        if (typeof code === 'string') return code\n    }\n    return undefined\n}\n\nfunction normalizeCode(raw: string | undefined): AudioStreamErrorCode | null {\n    if (!raw) return null\n    const upper = raw.toUpperCase()\n    if (upper.startsWith('ERR_AUDIO_STREAM_')) {\n        const known: AudioStreamErrorCode[] = [\n            'ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT',\n            'ERR_AUDIO_STREAM_INVALID_RANGE',\n            'ERR_AUDIO_STREAM_DECODE_FAILED',\n            'ERR_AUDIO_STREAM_CANCELLED',\n            'ERR_AUDIO_STREAM_PERMISSION_DENIED',\n            'ERR_AUDIO_STREAM_FILE_NOT_FOUND',\n            'ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT',\n            'ERR_AUDIO_STREAM_NATIVE_UNAVAILABLE',\n            'ERR_AUDIO_STREAM_BUSY',\n            'ERR_AUDIO_STREAM_UNKNOWN',\n        ]\n        if ((known as string[]).includes(upper)) {\n            return upper as AudioStreamErrorCode\n        }\n    }\n    if (upper.includes('FILE_NOT_FOUND') || upper === 'ENOENT') {\n        return 'ERR_AUDIO_STREAM_FILE_NOT_FOUND'\n    }\n    if (upper.includes('PERMISSION') || upper === 'EACCES') {\n        return 'ERR_AUDIO_STREAM_PERMISSION_DENIED'\n    }\n    if (\n        upper.includes('UNSUPPORTED') ||\n        upper.includes('NO_SUITABLE_CODEC') ||\n        upper.includes('NO SUITABLE CODEC') ||\n        upper.includes('NOT SUPPORTED')\n    ) {\n        return 'ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT'\n    }\n    if (\n        upper.includes('INVALID_RANGE') ||\n        upper.includes('OUT_OF_RANGE') ||\n        upper.includes('INVALID_TIME')\n    ) {\n        return 'ERR_AUDIO_STREAM_INVALID_RANGE'\n    }\n    if (upper.includes('CANCELLED') || upper.includes('CANCELED')) {\n        return 'ERR_AUDIO_STREAM_CANCELLED'\n    }\n    if (upper.includes('BUSY')) {\n        return 'ERR_AUDIO_STREAM_BUSY'\n    }\n    if (upper.includes('BACKPRESSURE')) {\n        return 'ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT'\n    }\n    if (\n        upper.includes('DECODE') ||\n        upper.includes('CODEC') ||\n        upper.includes('MALFORMED')\n    ) {\n        return 'ERR_AUDIO_STREAM_DECODE_FAILED'\n    }\n    return null\n}\n\nexport function mapStreamError(\n    err: unknown,\n    fileUri?: string,\n    platform?: string\n): AudioStreamError {\n    if (err instanceof AudioStreamError) return err\n\n    const nativeMessage = getNativeMessage(err)\n    const nativeCode = getNativeCode(err)\n    const lower = nativeMessage.toLowerCase()\n\n    let code =\n        normalizeCode(nativeCode) ??\n        normalizeCode(nativeMessage) ??\n        'ERR_AUDIO_STREAM_UNKNOWN'\n\n    if (code === 'ERR_AUDIO_STREAM_UNKNOWN') {\n        if (lower.includes('not found') || lower.includes('does not exist')) {\n            code = 'ERR_AUDIO_STREAM_FILE_NOT_FOUND'\n        } else if (\n            lower.includes('unsupported') ||\n            lower.includes('no suitable codec')\n        ) {\n            code = 'ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT'\n        } else if (lower.includes('permission') || lower.includes('denied')) {\n            code = 'ERR_AUDIO_STREAM_PERMISSION_DENIED'\n        } else if (lower.includes('decode') || lower.includes('codec')) {\n            code = 'ERR_AUDIO_STREAM_DECODE_FAILED'\n        } else if (lower.includes('cancel')) {\n            code = 'ERR_AUDIO_STREAM_CANCELLED'\n        }\n    }\n\n    return new AudioStreamError({\n        code,\n        message: `Audio stream failed (${code}): ${nativeMessage}`,\n        recoverable: RECOVERABLE.includes(code),\n        fileUri,\n        platform,\n        nativeCode,\n        nativeMessage,\n    })\n}\n"]}

package/build/esm/errors/AudioStreamError.test.js

@@ -0,0 +1,59 @@
+import { AudioStreamError, mapStreamError } from './AudioStreamError';
+describe('AudioStreamError', () => {
+    it('passes through an existing AudioStreamError unchanged', () => {
+        const original = new AudioStreamError({
+            code: 'ERR_AUDIO_STREAM_CANCELLED',
+            message: 'aborted',
+            recoverable: true,
+        });
+        expect(mapStreamError(original)).toBe(original);
+    });
+    it('maps native FILE_NOT_FOUND code', () => {
+        const mapped = mapStreamError({ code: 'FILE_NOT_FOUND', message: 'gone' });
+        expect(mapped.code).toBe('ERR_AUDIO_STREAM_FILE_NOT_FOUND');
+        expect(mapped.recoverable).toBe(false);
+    });
+    it('maps unsupported codec text', () => {
+        const mapped = mapStreamError(new Error('No suitable codec for audio/opus'));
+        expect(mapped.code).toBe('ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT');
+    });
+    it('marks cancellation as recoverable', () => {
+        const mapped = mapStreamError({
+            code: 'ERR_AUDIO_STREAM_CANCELLED',
+            message: 'user cancelled',
+        });
+        expect(mapped.code).toBe('ERR_AUDIO_STREAM_CANCELLED');
+        expect(mapped.recoverable).toBe(true);
+    });
+    it('falls back to UNKNOWN', () => {
+        const mapped = mapStreamError({});
+        expect(mapped.code).toBe('ERR_AUDIO_STREAM_UNKNOWN');
+    });
+    it('preserves nativeCode and nativeMessage', () => {
+        const mapped = mapStreamError({
+            code: 'WEIRD_NATIVE_CODE',
+            message: 'something went wrong on the bridge',
+        });
+        expect(mapped.nativeCode).toBe('WEIRD_NATIVE_CODE');
+        expect(mapped.nativeMessage).toContain('bridge');
+    });
+    it('serialises to a stable JSON payload', () => {
+        const err = new AudioStreamError({
+            code: 'ERR_AUDIO_STREAM_DECODE_FAILED',
+            message: 'decoder bust',
+            recoverable: false,
+            fileUri: 'file:///a.m4a',
+            platform: 'ios',
+        });
+        expect(err.toJSON()).toEqual({
+            code: 'ERR_AUDIO_STREAM_DECODE_FAILED',
+            message: 'decoder bust',
+            recoverable: false,
+            fileUri: 'file:///a.m4a',
+            platform: 'ios',
+            nativeCode: undefined,
+            nativeMessage: undefined,
+        });
+    });
+});
+//# sourceMappingURL=AudioStreamError.test.js.map

package/build/esm/errors/AudioStreamError.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioStreamError.test.js","sourceRoot":"","sources":["../../../src/errors/AudioStreamError.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { AudioStreamError, mapStreamError } from './AudioStreamError'\n\ndescribe('AudioStreamError', () => {\n    it('passes through an existing AudioStreamError unchanged', () => {\n        const original = new AudioStreamError({\n            code: 'ERR_AUDIO_STREAM_CANCELLED',\n            message: 'aborted',\n            recoverable: true,\n        })\n        expect(mapStreamError(original)).toBe(original)\n    })\n\n    it('maps native FILE_NOT_FOUND code', () => {\n        const mapped = mapStreamError({ code: 'FILE_NOT_FOUND', message: 'gone' })\n        expect(mapped.code).toBe('ERR_AUDIO_STREAM_FILE_NOT_FOUND')\n        expect(mapped.recoverable).toBe(false)\n    })\n\n    it('maps unsupported codec text', () => {\n        const mapped = mapStreamError(new Error('No suitable codec for audio/opus'))\n        expect(mapped.code).toBe('ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT')\n    })\n\n    it('marks cancellation as recoverable', () => {\n        const mapped = mapStreamError({\n            code: 'ERR_AUDIO_STREAM_CANCELLED',\n            message: 'user cancelled',\n        })\n        expect(mapped.code).toBe('ERR_AUDIO_STREAM_CANCELLED')\n        expect(mapped.recoverable).toBe(true)\n    })\n\n    it('falls back to UNKNOWN', () => {\n        const mapped = mapStreamError({})\n        expect(mapped.code).toBe('ERR_AUDIO_STREAM_UNKNOWN')\n    })\n\n    it('preserves nativeCode and nativeMessage', () => {\n        const mapped = mapStreamError({\n            code: 'WEIRD_NATIVE_CODE',\n            message: 'something went wrong on the bridge',\n        })\n        expect(mapped.nativeCode).toBe('WEIRD_NATIVE_CODE')\n        expect(mapped.nativeMessage).toContain('bridge')\n    })\n\n    it('serialises to a stable JSON payload', () => {\n        const err = new AudioStreamError({\n            code: 'ERR_AUDIO_STREAM_DECODE_FAILED',\n            message: 'decoder bust',\n            recoverable: false,\n            fileUri: 'file:///a.m4a',\n            platform: 'ios',\n        })\n        expect(err.toJSON()).toEqual({\n            code: 'ERR_AUDIO_STREAM_DECODE_FAILED',\n            message: 'decoder bust',\n            recoverable: false,\n            fileUri: 'file:///a.m4a',\n            platform: 'ios',\n            nativeCode: undefined,\n            nativeMessage: undefined,\n        })\n    })\n})\n"]}

package/build/esm/index.js

@@ -6,6 +6,7 @@ import { extractPreview } from './AudioAnalysis/extractPreview';
 import { initMelStreamingWasm, computeMelFrameWasm, } from './AudioAnalysis/melSpectrogramWasm';
 import { AudioRecorderProvider, useSharedAudioRecorder, } from './AudioRecorder.provider';
 import AudioStudioModule from './AudioStudioModule';
+import { getAudioDecodeCapabilities, streamAudioData, } from './streamAudioData';
 import { trimAudio } from './trimAudio';
 import { useAudioRecorder } from './useAudioRecorder';
 export * from './utils/convertPCMToFloat32';
@@ -19,8 +20,9 @@ export { AudioDeviceManager, audioDeviceManager } from './AudioDeviceManager';
 export { useAudioDevices } from './hooks/useAudioDevices';
 export { setMelSpectrogramWasmUrl } from './AudioAnalysis/wasmConfig';
 export { extractPreviewBars } from './AudioAnalysis/extractPreviewBars';
-export { AudioRecorderProvider, AudioStudioModule, extractRawWavAnalysis, extractAudioAnalysis, extractPreview, trimAudio, extractAudioData, extractMelSpectrogram, initMelStreamingWasm, computeMelFrameWasm, MAX_DURATION_MS, useAudioRecorder, useSharedAudioRecorder, };
+export { AudioRecorderProvider, AudioStudioModule, extractRawWavAnalysis, extractAudioAnalysis, extractPreview, trimAudio, extractAudioData, streamAudioData, getAudioDecodeCapabilities, extractMelSpectrogram, initMelStreamingWasm, computeMelFrameWasm, MAX_DURATION_MS, useAudioRecorder, useSharedAudioRecorder, };
 export { AudioExtractionError, mapExtractionError, } from './errors/AudioExtractionError';
+export { AudioStreamError, mapStreamError, } from './errors/AudioStreamError';
 /** @deprecated Use AudioStudioModule instead */
 export const ExpoAudioStreamModule = AudioStudioModule;
 //# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AAEf,OAAO,EACH,qBAAqB,EACrB,oBAAoB,GACvB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EACH,qBAAqB,EACrB,eAAe,GAClB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,EACH,oBAAoB,EACpB,mBAAmB,GACtB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EACH,qBAAqB,EACrB,sBAAsB,GACzB,MAAM,0BAA0B,CAAA;AACjC,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AAEtC,+BAA+B;AAC/B,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GAE1B,MAAM,iCAAiC,CAAA;AAExC,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE7E,8BAA8B;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AAEvE,OAAO,EACH,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,GACzB,CAAA;AAED,OAAO,EACH,oBAAoB,EACpB,kBAAkB,GACrB,MAAM,+BAA+B,CAAA;AAUtC,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAA","sourcesContent":["// src/index.ts\n\nimport {\n    extractRawWavAnalysis,\n    extractAudioAnalysis,\n} from './AudioAnalysis/extractAudioAnalysis'\nimport { extractAudioData } from './AudioAnalysis/extractAudioData'\nimport {\n    extractMelSpectrogram,\n    MAX_DURATION_MS,\n} from './AudioAnalysis/extractMelSpectrogram'\nimport { extractPreview } from './AudioAnalysis/extractPreview'\nimport {\n    initMelStreamingWasm,\n    computeMelFrameWasm,\n} from './AudioAnalysis/melSpectrogramWasm'\nimport {\n    AudioRecorderProvider,\n    useSharedAudioRecorder,\n} from './AudioRecorder.provider'\nimport AudioStudioModule from './AudioStudioModule'\nimport { trimAudio } from './trimAudio'\nimport { useAudioRecorder } from './useAudioRecorder'\n\nexport * from './utils/convertPCMToFloat32'\nexport * from './utils/getWavFileInfo'\nexport * from './utils/writeWavHeader'\n\n// Export platform capabilities\nexport {\n    getPlatformCapabilities,\n    isEncodingSupported,\n    isBitDepthSupported,\n    getFallbackEncoding,\n    getFallbackBitDepth,\n    validateRecordingConfig,\n    type PlatformCapabilities,\n} from './constants/platformLimitations'\n\n// Export AudioDeviceManager\nexport { AudioDeviceManager, audioDeviceManager } from './AudioDeviceManager'\n\n// Export useAudioDevices hook\nexport { useAudioDevices } from './hooks/useAudioDevices'\n\nexport { setMelSpectrogramWasmUrl } from './AudioAnalysis/wasmConfig'\nexport { extractPreviewBars } from './AudioAnalysis/extractPreviewBars'\n\nexport {\n    AudioRecorderProvider,\n    AudioStudioModule,\n    extractRawWavAnalysis,\n    extractAudioAnalysis,\n    extractPreview,\n    trimAudio,\n    extractAudioData,\n    extractMelSpectrogram,\n    initMelStreamingWasm,\n    computeMelFrameWasm,\n    MAX_DURATION_MS,\n    useAudioRecorder,\n    useSharedAudioRecorder,\n}\n\nexport {\n    AudioExtractionError,\n    mapExtractionError,\n} from './errors/AudioExtractionError'\nexport type {\n    AudioExtractionErrorCode,\n    AudioExtractionErrorPayload,\n} from './errors/AudioExtractionError'\n\n// Export all types\nexport type * from './AudioAnalysis/AudioAnalysis.types'\nexport type * from './AudioStudio.types'\n\n/** @deprecated Use AudioStudioModule instead */\nexport const ExpoAudioStreamModule = AudioStudioModule\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AAEf,OAAO,EACH,qBAAqB,EACrB,oBAAoB,GACvB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EACH,qBAAqB,EACrB,eAAe,GAClB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,EACH,oBAAoB,EACpB,mBAAmB,GACtB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EACH,qBAAqB,EACrB,sBAAsB,GACzB,MAAM,0BAA0B,CAAA;AACjC,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,EACH,0BAA0B,EAC1B,eAAe,GAClB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AAEtC,+BAA+B;AAC/B,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GAE1B,MAAM,iCAAiC,CAAA;AAExC,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE7E,8BAA8B;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AAEvE,OAAO,EACH,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,GACzB,CAAA;AAED,OAAO,EACH,oBAAoB,EACpB,kBAAkB,GACrB,MAAM,+BAA+B,CAAA;AAMtC,OAAO,EACH,gBAAgB,EAChB,cAAc,GACjB,MAAM,2BAA2B,CAAA;AAmBlC,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAA","sourcesContent":["// src/index.ts\n\nimport {\n    extractRawWavAnalysis,\n    extractAudioAnalysis,\n} from './AudioAnalysis/extractAudioAnalysis'\nimport { extractAudioData } from './AudioAnalysis/extractAudioData'\nimport {\n    extractMelSpectrogram,\n    MAX_DURATION_MS,\n} from './AudioAnalysis/extractMelSpectrogram'\nimport { extractPreview } from './AudioAnalysis/extractPreview'\nimport {\n    initMelStreamingWasm,\n    computeMelFrameWasm,\n} from './AudioAnalysis/melSpectrogramWasm'\nimport {\n    AudioRecorderProvider,\n    useSharedAudioRecorder,\n} from './AudioRecorder.provider'\nimport AudioStudioModule from './AudioStudioModule'\nimport {\n    getAudioDecodeCapabilities,\n    streamAudioData,\n} from './streamAudioData'\nimport { trimAudio } from './trimAudio'\nimport { useAudioRecorder } from './useAudioRecorder'\n\nexport * from './utils/convertPCMToFloat32'\nexport * from './utils/getWavFileInfo'\nexport * from './utils/writeWavHeader'\n\n// Export platform capabilities\nexport {\n    getPlatformCapabilities,\n    isEncodingSupported,\n    isBitDepthSupported,\n    getFallbackEncoding,\n    getFallbackBitDepth,\n    validateRecordingConfig,\n    type PlatformCapabilities,\n} from './constants/platformLimitations'\n\n// Export AudioDeviceManager\nexport { AudioDeviceManager, audioDeviceManager } from './AudioDeviceManager'\n\n// Export useAudioDevices hook\nexport { useAudioDevices } from './hooks/useAudioDevices'\n\nexport { setMelSpectrogramWasmUrl } from './AudioAnalysis/wasmConfig'\nexport { extractPreviewBars } from './AudioAnalysis/extractPreviewBars'\n\nexport {\n    AudioRecorderProvider,\n    AudioStudioModule,\n    extractRawWavAnalysis,\n    extractAudioAnalysis,\n    extractPreview,\n    trimAudio,\n    extractAudioData,\n    streamAudioData,\n    getAudioDecodeCapabilities,\n    extractMelSpectrogram,\n    initMelStreamingWasm,\n    computeMelFrameWasm,\n    MAX_DURATION_MS,\n    useAudioRecorder,\n    useSharedAudioRecorder,\n}\n\nexport {\n    AudioExtractionError,\n    mapExtractionError,\n} from './errors/AudioExtractionError'\nexport type {\n    AudioExtractionErrorCode,\n    AudioExtractionErrorPayload,\n} from './errors/AudioExtractionError'\n\nexport {\n    AudioStreamError,\n    mapStreamError,\n} from './errors/AudioStreamError'\nexport type {\n    AudioStreamErrorCode,\n    AudioStreamErrorPayload,\n} from './errors/AudioStreamError'\n\nexport type {\n    StreamAudioDataOptions,\n    StreamAudioDataChunk,\n    StreamAudioDataProgress,\n    StreamAudioDataResult,\n    StreamAudioDataCallbacks,\n    AudioDecodeCapabilities,\n} from './streamAudioData'\n\n// Export all types\nexport type * from './AudioAnalysis/AudioAnalysis.types'\nexport type * from './AudioStudio.types'\n\n/** @deprecated Use AudioStudioModule instead */\nexport const ExpoAudioStreamModule = AudioStudioModule\n"]}