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

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';
@@ -18,7 +19,10 @@ export { AudioDeviceManager, audioDeviceManager } from './AudioDeviceManager';
 // Export useAudioDevices hook
 export { useAudioDevices } from './hooks/useAudioDevices';
 export { setMelSpectrogramWasmUrl } from './AudioAnalysis/wasmConfig';
-export { AudioRecorderProvider, AudioStudioModule, extractRawWavAnalysis, extractAudioAnalysis, extractPreview, trimAudio, extractAudioData, extractMelSpectrogram, initMelStreamingWasm, computeMelFrameWasm, MAX_DURATION_MS, useAudioRecorder, useSharedAudioRecorder, };
+export { extractPreviewBars } from './AudioAnalysis/extractPreviewBars';
+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;AAErE,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;AAMD,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'\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\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"]}

package/build/esm/streamAudioData.js

@@ -0,0 +1,460 @@
+import { LegacyEventEmitter } from 'expo-modules-core';
+import AudioStudioModule from './AudioStudioModule';
+import { isWeb } from './constants';
+import { AudioStreamError, mapStreamError, } from './errors/AudioStreamError';
+import { processAudioBuffer } from './utils/audioProcessing';
+const CHUNK_EVENT = 'AudioDataStreamChunk';
+const PROGRESS_EVENT = 'AudioDataStreamProgress';
+const COMPLETE_EVENT = 'AudioDataStreamComplete';
+const ERROR_EVENT = 'AudioDataStreamError';
+let cachedEmitter = null;
+function getEmitter() {
+    if (!cachedEmitter) {
+        cachedEmitter = new LegacyEventEmitter(AudioStudioModule);
+    }
+    return cachedEmitter;
+}
+function generateRequestId() {
+    const g = globalThis;
+    if (typeof g.crypto?.randomUUID === 'function') {
+        try {
+            return g.crypto.randomUUID();
+        }
+        catch {
+            // fall through
+        }
+    }
+    return `asd_${Date.now().toString(36)}_${Math.random()
+        .toString(36)
+        .slice(2, 10)}`;
+}
+function toFloat32(samples) {
+    if (samples instanceof Float32Array)
+        return samples;
+    if (Array.isArray(samples)) {
+        const out = new Float32Array(samples.length);
+        for (let i = 0; i < samples.length; i++) {
+            const v = Number(samples[i]);
+            out[i] = Number.isFinite(v) ? v : 0;
+        }
+        return out;
+    }
+    if (typeof samples === 'string') {
+        const bytes = base64ToBytes(samples);
+        const aligned = bytes.byteOffset % 4 === 0
+            ? new Float32Array(bytes.buffer, bytes.byteOffset, bytes.byteLength / 4)
+            : new Float32Array(bytes.buffer.slice(bytes.byteOffset));
+        return new Float32Array(aligned);
+    }
+    if (samples && typeof samples === 'object' && 'length' in samples) {
+        // ArrayLike fallback
+        const arr = samples;
+        const out = new Float32Array(arr.length);
+        for (let i = 0; i < arr.length; i++) {
+            const v = Number(arr[i]);
+            out[i] = Number.isFinite(v) ? v : 0;
+        }
+        return out;
+    }
+    return new Float32Array(0);
+}
+function base64ToBytes(input) {
+    const g = globalThis;
+    if (typeof g.atob !== 'function') {
+        // Buffer path for environments without atob; React Native has atob.
+        const Buf = globalThis.Buffer;
+        if (Buf)
+            return new Uint8Array(Buf.from(input, 'base64'));
+        return new Uint8Array(0);
+    }
+    const bin = g.atob(input);
+    const out = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i++)
+        out[i] = bin.charCodeAt(i);
+    return out;
+}
+function validateOptions(options) {
+    if (!options.fileUri) {
+        throw new AudioStreamError({
+            code: 'ERR_AUDIO_STREAM_INVALID_RANGE',
+            message: 'fileUri is required',
+            recoverable: false,
+        });
+    }
+    if (options.startTimeMs !== undefined &&
+        options.endTimeMs !== undefined &&
+        options.startTimeMs >= options.endTimeMs) {
+        throw new AudioStreamError({
+            code: 'ERR_AUDIO_STREAM_INVALID_RANGE',
+            message: 'startTimeMs must be < endTimeMs',
+            recoverable: false,
+        });
+    }
+    if (options.chunkDurationMs !== undefined &&
+        (options.chunkDurationMs < 10 || options.chunkDurationMs > 60000)) {
+        throw new AudioStreamError({
+            code: 'ERR_AUDIO_STREAM_INVALID_RANGE',
+            message: 'chunkDurationMs must be in [10, 60000]',
+            recoverable: false,
+        });
+    }
+    if (options.streamFormat !== undefined &&
+        options.streamFormat !== 'float32') {
+        throw new AudioStreamError({
+            code: 'ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT',
+            message: `Unsupported streamFormat: ${options.streamFormat}`,
+            recoverable: false,
+        });
+    }
+}
+/**
+ * Stream decoded audio from a stored file as bounded Float32 PCM chunks.
+ *
+ * Memory bound:
+ *   `chunkDurationMs * sampleRate * channels * 4 * maxBufferedChunks` +
+ *   native decoder buffers.
+ *
+ * Cancellation: pass `options.signal` and call `abort()`. The returned promise
+ * resolves with `cancelled: true` (it does not reject) when cancellation wins.
+ *
+ * Backpressure: if `onChunk` returns a Promise, native decode is paused until
+ * it resolves; if it throws, the stream is aborted with a `decode_failed` error.
+ */
+export async function streamAudioData(options, callbacks) {
+    validateOptions(options);
+    if (isWeb) {
+        return streamAudioDataWeb(options, callbacks);
+    }
+    return streamAudioDataNative(options, callbacks);
+}
+/** Discover what the running platform supports. */
+export async function getAudioDecodeCapabilities() {
+    if (isWeb) {
+        return {
+            platform: 'web',
+            supportedInputFormats: [
+                'audio/wav',
+                'audio/mpeg',
+                'audio/mp4',
+                'audio/aac',
+                'audio/ogg',
+                'audio/webm',
+            ],
+            supportedOutputFormats: ['float32'],
+            supportsCancellation: true,
+            supportsBackpressure: true,
+            supportsTimeRange: true,
+            supportsTargetSampleRate: true,
+            supportsChannelMixing: true,
+            knownLimitations: [
+                'Web decodes the entire file via AudioContext.decodeAudioData before chunking; very long files may exceed browser memory.',
+            ],
+        };
+    }
+    if (typeof AudioStudioModule.getAudioDecodeCapabilities === 'function') {
+        try {
+            const caps = await AudioStudioModule.getAudioDecodeCapabilities();
+            return caps;
+        }
+        catch (err) {
+            throw mapStreamError(err, undefined, 'native');
+        }
+    }
+    throw new AudioStreamError({
+        code: 'ERR_AUDIO_STREAM_NATIVE_UNAVAILABLE',
+        message: 'getAudioDecodeCapabilities is not available on this build',
+        recoverable: false,
+    });
+}
+async function streamAudioDataNative(options, callbacks) {
+    if (typeof AudioStudioModule.streamAudioData !== 'function') {
+        throw new AudioStreamError({
+            code: 'ERR_AUDIO_STREAM_NATIVE_UNAVAILABLE',
+            message: 'streamAudioData native method missing — rebuild the host app with the latest @siteed/audio-studio.',
+            recoverable: false,
+        });
+    }
+    const requestId = generateRequestId();
+    const emitter = getEmitter();
+    const subs = [];
+    let chunkCount = 0;
+    let sampleCount = 0;
+    let processingChain = Promise.resolve();
+    let settled = false;
+    let abortListener = null;
+    const finalize = () => {
+        for (const sub of subs) {
+            try {
+                sub.remove();
+            }
+            catch {
+                /* noop */
+            }
+        }
+        subs.length = 0;
+        if (abortListener && options.signal) {
+            options.signal.removeEventListener('abort', abortListener);
+        }
+    };
+    return new Promise((resolve, reject) => {
+        const settle = (fn, mode, value) => {
+            if (settled)
+                return;
+            settled = true;
+            finalize();
+            fn();
+            if (mode === 'resolve') {
+                resolve(value);
+            }
+            else {
+                reject(value);
+            }
+        };
+        const handleError = (err) => {
+            settle(() => {
+                try {
+                    AudioStudioModule.cancelStreamAudioData?.(requestId);
+                }
+                catch {
+                    /* noop */
+                }
+            }, 'reject', mapStreamError(err, options.fileUri, 'native'));
+        };
+        subs.push(emitter.addListener(CHUNK_EVENT, (raw) => {
+            const evt = raw;
+            if (evt.requestId !== requestId)
+                return;
+            const chunk = {
+                requestId: evt.requestId,
+                chunkIndex: evt.chunkIndex,
+                startTimeMs: evt.startTimeMs,
+                endTimeMs: evt.endTimeMs,
+                durationMs: evt.endTimeMs - evt.startTimeMs,
+                startSample: evt.startSample,
+                sampleCount: evt.sampleCount,
+                sampleRate: evt.sampleRate,
+                channels: evt.channels,
+                samples: toFloat32(evt.samples),
+                isFinal: evt.isFinal,
+            };
+            chunkCount += 1;
+            sampleCount += chunk.sampleCount;
+            processingChain = processingChain
+                .then(async () => {
+                await callbacks.onChunk(chunk);
+                try {
+                    AudioStudioModule.acknowledgeStreamAudioChunk?.(requestId, chunk.chunkIndex);
+                }
+                catch {
+                    /* noop */
+                }
+            })
+                .catch(handleError);
+        }));
+        if (callbacks.onProgress) {
+            subs.push(emitter.addListener(PROGRESS_EVENT, (raw) => {
+                const evt = raw;
+                if (evt.requestId !== requestId)
+                    return;
+                callbacks.onProgress(evt);
+            }));
+        }
+        subs.push(emitter.addListener(COMPLETE_EVENT, (raw) => {
+            const evt = raw;
+            if (evt.requestId !== requestId)
+                return;
+            // Wait for in-flight onChunk callbacks before resolving.
+            processingChain
+                .then(() => {
+                settle(() => { }, 'resolve', {
+                    requestId,
+                    durationMs: evt.durationMs,
+                    sampleRate: evt.sampleRate,
+                    channels: evt.channels,
+                    chunks: evt.chunks ?? chunkCount,
+                    samples: evt.samples ?? sampleCount,
+                    cancelled: evt.cancelled,
+                });
+            })
+                .catch(handleError);
+        }));
+        subs.push(emitter.addListener(ERROR_EVENT, (raw) => {
+            const evt = raw;
+            if (evt.requestId !== requestId)
+                return;
+            if (evt.code === 'ERR_AUDIO_STREAM_CANCELLED') {
+                processingChain
+                    .catch(() => { })
+                    .then(() => {
+                    settle(() => { }, 'resolve', {
+                        requestId,
+                        durationMs: 0,
+                        sampleRate: options.targetSampleRate ??
+                            options.sampleRate ??
+                            0,
+                        channels: options.channels ?? 1,
+                        chunks: chunkCount,
+                        samples: sampleCount,
+                        cancelled: true,
+                    });
+                });
+                return;
+            }
+            handleError(new AudioStreamError({
+                code: evt.code ??
+                    'ERR_AUDIO_STREAM_UNKNOWN',
+                message: evt.message ?? 'native stream error',
+                nativeMessage: evt.nativeMessage,
+                fileUri: options.fileUri,
+                platform: 'native',
+                recoverable: false,
+            }));
+        }));
+        if (options.signal) {
+            if (options.signal.aborted) {
+                settle(() => { }, 'resolve', {
+                    requestId,
+                    durationMs: 0,
+                    sampleRate: options.targetSampleRate ?? options.sampleRate ?? 0,
+                    channels: options.channels ?? 1,
+                    chunks: 0,
+                    samples: 0,
+                    cancelled: true,
+                });
+                return;
+            }
+            abortListener = () => {
+                try {
+                    AudioStudioModule.cancelStreamAudioData?.(requestId);
+                }
+                catch {
+                    /* noop */
+                }
+            };
+            options.signal.addEventListener('abort', abortListener);
+        }
+        const { signal: _signal, ...nativeOptions } = options;
+        AudioStudioModule.streamAudioData({
+            ...nativeOptions,
+            requestId,
+            streamFormat: options.streamFormat ?? 'float32',
+            chunkDurationMs: options.chunkDurationMs ?? 1000,
+            maxBufferedChunks: options.maxBufferedChunks ?? 4,
+            normalizeAudio: options.normalizeAudio ?? true,
+        }).catch(handleError);
+    });
+}
+async function streamAudioDataWeb(options, callbacks) {
+    const requestId = generateRequestId();
+    const cancelled = () => options.signal?.aborted === true;
+    if (cancelled()) {
+        return {
+            requestId,
+            durationMs: 0,
+            sampleRate: options.targetSampleRate ?? options.sampleRate ?? 0,
+            channels: options.channels ?? 1,
+            chunks: 0,
+            samples: 0,
+            cancelled: true,
+        };
+    }
+    try {
+        const processed = await processAudioBuffer({
+            fileUri: options.fileUri,
+            targetSampleRate: options.targetSampleRate ?? 16000,
+            targetChannels: options.channels ?? 1,
+            normalizeAudio: options.normalizeAudio ?? true,
+            startTimeMs: options.startTimeMs,
+            endTimeMs: options.endTimeMs,
+        });
+        const sampleRate = processed.sampleRate;
+        const channels = processed.channels;
+        const durationMs = processed.durationMs;
+        const chunkDurationMs = options.chunkDurationMs ?? 1000;
+        let samplesPerChunk = Math.max(1, Math.floor((chunkDurationMs / 1000) * sampleRate) * channels);
+        if (options.maxChunkBytes) {
+            const maxSamples = Math.floor(options.maxChunkBytes / 4);
+            samplesPerChunk = Math.min(samplesPerChunk, maxSamples);
+        }
+        const all = sanitizeFloat32(processed.channelData, options.normalizeAudio ?? true);
+        let chunkIndex = 0;
+        let emittedSamples = 0;
+        for (let off = 0; off < all.length; off += samplesPerChunk) {
+            if (cancelled()) {
+                return {
+                    requestId,
+                    durationMs,
+                    sampleRate,
+                    channels,
+                    chunks: chunkIndex,
+                    samples: emittedSamples,
+                    cancelled: true,
+                };
+            }
+            const end = Math.min(off + samplesPerChunk, all.length);
+            const slice = all.slice(off, end);
+            const startSample = off / channels;
+            const endSample = end / channels;
+            const chunk = {
+                requestId,
+                chunkIndex,
+                startTimeMs: Math.round((startSample / sampleRate) * 1000),
+                endTimeMs: Math.round((endSample / sampleRate) * 1000),
+                durationMs: Math.round(((endSample - startSample) / sampleRate) * 1000),
+                startSample,
+                sampleCount: slice.length,
+                sampleRate,
+                channels,
+                samples: slice,
+                isFinal: end >= all.length,
+            };
+            await callbacks.onChunk(chunk);
+            callbacks.onProgress?.({
+                requestId,
+                processedMs: chunk.endTimeMs,
+                durationMs,
+                progress: durationMs > 0 ? chunk.endTimeMs / durationMs : 1,
+                emittedChunks: chunkIndex + 1,
+            });
+            chunkIndex += 1;
+            emittedSamples += slice.length;
+        }
+        return {
+            requestId,
+            durationMs,
+            sampleRate,
+            channels,
+            chunks: chunkIndex,
+            samples: emittedSamples,
+            cancelled: false,
+        };
+    }
+    catch (err) {
+        throw mapStreamError(err, options.fileUri, 'web');
+    }
+}
+function sanitizeFloat32(input, clamp) {
+    if (!clamp) {
+        // still need NaN/Inf sanitation
+        for (let i = 0; i < input.length; i++) {
+            const v = input[i];
+            if (!Number.isFinite(v))
+                input[i] = 0;
+        }
+        return input;
+    }
+    for (let i = 0; i < input.length; i++) {
+        const v = input[i];
+        if (!Number.isFinite(v)) {
+            input[i] = 0;
+        }
+        else if (v > 1) {
+            input[i] = 1;
+        }
+        else if (v < -1) {
+            input[i] = -1;
+        }
+    }
+    return input;
+}
+//# sourceMappingURL=streamAudioData.js.map

package/build/esm/streamAudioData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamAudioData.js","sourceRoot":"","sources":["../../src/streamAudioData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA0B,MAAM,mBAAmB,CAAA;AAE9E,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EACH,gBAAgB,EAEhB,cAAc,GACjB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAyG5D,MAAM,WAAW,GAAG,sBAAsB,CAAA;AAC1C,MAAM,cAAc,GAAG,yBAAyB,CAAA;AAChD,MAAM,cAAc,GAAG,yBAAyB,CAAA;AAChD,MAAM,WAAW,GAAG,sBAAsB,CAAA;AAE1C,IAAI,aAAa,GAA8B,IAAI,CAAA;AACnD,SAAS,UAAU;IACf,IAAI,CAAC,aAAa,EAAE,CAAC;QACjB,aAAa,GAAG,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;IAC7D,CAAC;IACD,OAAO,aAAa,CAAA;AACxB,CAAC;AAED,SAAS,iBAAiB;IACtB,MAAM,CAAC,GAAG,UAAwD,CAAA;IAClE,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,KAAK,UAAU,EAAE,CAAC;QAC7C,IAAI,CAAC;YACD,OAAO,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;QAChC,CAAC;QAAC,MAAM,CAAC;YACL,eAAe;QACnB,CAAC;IACL,CAAC;IACD,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE;SACjD,QAAQ,CAAC,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,OAAgB;IAC/B,IAAI,OAAO,YAAY,YAAY;QAAE,OAAO,OAAO,CAAA;IACnD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;YAC5B,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACvC,CAAC;QACD,OAAO,GAAG,CAAA;IACd,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;QACpC,MAAM,OAAO,GACT,KAAK,CAAC,UAAU,GAAG,CAAC,KAAK,CAAC;YACtB,CAAC,CAAC,IAAI,YAAY,CACZ,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,UAAU,GAAG,CAAC,CACvB;YACH,CAAC,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAA;QAChE,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC;IACD,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;QAChE,qBAAqB;QACrB,MAAM,GAAG,GAAG,OAA4B,CAAA;QACxC,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;YACxB,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACvC,CAAC;QACD,OAAO,GAAG,CAAA;IACd,CAAC;IACD,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,CAAA;AAC9B,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAChC,MAAM,CAAC,GAAG,UAA8C,CAAA;IACxD,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,oEAAoE;QACpE,MAAM,GAAG,GAAI,UAA8C,CAAC,MAAM,CAAA;QAClE,IAAI,GAAG;YAAE,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;QACzD,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;IAC5B,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IAC/D,OAAO,GAAG,CAAA;AACd,CAAC;AAED,SAAS,eAAe,CAAC,OAA+B;IACpD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,gBAAgB,CAAC;YACvB,IAAI,EAAE,gCAAgC;YACtC,OAAO,EAAE,qBAAqB;YAC9B,WAAW,EAAE,KAAK;SACrB,CAAC,CAAA;IACN,CAAC;IACD,IACI,OAAO,CAAC,WAAW,KAAK,SAAS;QACjC,OAAO,CAAC,SAAS,KAAK,SAAS;QAC/B,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,SAAS,EAC1C,CAAC;QACC,MAAM,IAAI,gBAAgB,CAAC;YACvB,IAAI,EAAE,gCAAgC;YACtC,OAAO,EAAE,iCAAiC;YAC1C,WAAW,EAAE,KAAK;SACrB,CAAC,CAAA;IACN,CAAC;IACD,IACI,OAAO,CAAC,eAAe,KAAK,SAAS;QACrC,CAAC,OAAO,CAAC,eAAe,GAAG,EAAE,IAAI,OAAO,CAAC,eAAe,GAAG,KAAK,CAAC,EACnE,CAAC;QACC,MAAM,IAAI,gBAAgB,CAAC;YACvB,IAAI,EAAE,gCAAgC;YACtC,OAAO,EAAE,wCAAwC;YACjD,WAAW,EAAE,KAAK;SACrB,CAAC,CAAA;IACN,CAAC;IACD,IACI,OAAO,CAAC,YAAY,KAAK,SAAS;QAClC,OAAO,CAAC,YAAY,KAAK,SAAS,EACpC,CAAC;QACC,MAAM,IAAI,gBAAgB,CAAC;YACvB,IAAI,EAAE,qCAAqC;YAC3C,OAAO,EAAE,6BAA6B,OAAO,CAAC,YAAY,EAAE;YAC5D,WAAW,EAAE,KAAK;SACrB,CAAC,CAAA;IACN,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,OAA+B,EAC/B,SAAmC;IAEnC,eAAe,CAAC,OAAO,CAAC,CAAA;IAExB,IAAI,KAAK,EAAE,CAAC;QACR,OAAO,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACjD,CAAC;IAED,OAAO,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;AACpD,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,0BAA0B;IAC5C,IAAI,KAAK,EAAE,CAAC;QACR,OAAO;YACH,QAAQ,EAAE,KAAK;YACf,qBAAqB,EAAE;gBACnB,WAAW;gBACX,YAAY;gBACZ,WAAW;gBACX,WAAW;gBACX,WAAW;gBACX,YAAY;aACf;YACD,sBAAsB,EAAE,CAAC,SAAS,CAAC;YACnC,oBAAoB,EAAE,IAAI;YAC1B,oBAAoB,EAAE,IAAI;YAC1B,iBAAiB,EAAE,IAAI;YACvB,wBAAwB,EAAE,IAAI;YAC9B,qBAAqB,EAAE,IAAI;YAC3B,gBAAgB,EAAE;gBACd,0HAA0H;aAC7H;SACJ,CAAA;IACL,CAAC;IACD,IAAI,OAAO,iBAAiB,CAAC,0BAA0B,KAAK,UAAU,EAAE,CAAC;QACrE,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,0BAA0B,EAAE,CAAA;YACjE,OAAO,IAA+B,CAAA;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;QAClD,CAAC;IACL,CAAC;IACD,MAAM,IAAI,gBAAgB,CAAC;QACvB,IAAI,EAAE,qCAAqC;QAC3C,OAAO,EAAE,2DAA2D;QACpE,WAAW,EAAE,KAAK;KACrB,CAAC,CAAA;AACN,CAAC;AAED,KAAK,UAAU,qBAAqB,CAChC,OAA+B,EAC/B,SAAmC;IAEnC,IAAI,OAAO,iBAAiB,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAC1D,MAAM,IAAI,gBAAgB,CAAC;YACvB,IAAI,EAAE,qCAAqC;YAC3C,OAAO,EACH,oGAAoG;YACxG,WAAW,EAAE,KAAK;SACrB,CAAC,CAAA;IACN,CAAC;IAED,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAA;IACrC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;IAC5B,MAAM,IAAI,GAAwB,EAAE,CAAA;IACpC,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,WAAW,GAAG,CAAC,CAAA;IACnB,IAAI,eAAe,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAA;IACtD,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,aAAa,GAAwB,IAAI,CAAA;IAE7C,MAAM,QAAQ,GAAG,GAAG,EAAE;QAClB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC;gBACD,GAAG,CAAC,MAAM,EAAE,CAAA;YAChB,CAAC;YAAC,MAAM,CAAC;gBACL,UAAU;YACd,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;QACf,IAAI,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;QAC9D,CAAC;IACL,CAAC,CAAA;IAED,OAAO,IAAI,OAAO,CAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1D,MAAM,MAAM,GAAG,CACX,EAAc,EACd,IAA0B,EAC1B,KAAc,EAChB,EAAE;YACA,IAAI,OAAO;gBAAE,OAAM;YACnB,OAAO,GAAG,IAAI,CAAA;YACd,QAAQ,EAAE,CAAA;YACV,EAAE,EAAE,CAAA;YACJ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACrB,OAAO,CAAC,KAA8B,CAAC,CAAA;YAC3C,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,KAAc,CAAC,CAAA;YAC1B,CAAC;QACL,CAAC,CAAA;QAED,MAAM,WAAW,GAAG,CAAC,GAAY,EAAE,EAAE;YACjC,MAAM,CACF,GAAG,EAAE;gBACD,IAAI,CAAC;oBACD,iBAAiB,CAAC,qBAAqB,EAAE,CAAC,SAAS,CAAC,CAAA;gBACxD,CAAC;gBAAC,MAAM,CAAC;oBACL,UAAU;gBACd,CAAC;YACL,CAAC,EACD,QAAQ,EACR,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CACjD,CAAA;QACL,CAAC,CAAA;QAED,IAAI,CAAC,IAAI,CACL,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,GAAY,EAAE,EAAE;YAC9C,MAAM,GAAG,GAAG,GAWX,CAAA;YACD,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;gBAAE,OAAM;YACvC,MAAM,KAAK,GAAyB;gBAChC,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,UAAU,EAAE,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,WAAW;gBAC3C,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC/B,OAAO,EAAE,GAAG,CAAC,OAAO;aACvB,CAAA;YACD,UAAU,IAAI,CAAC,CAAA;YACf,WAAW,IAAI,KAAK,CAAC,WAAW,CAAA;YAEhC,eAAe,GAAG,eAAe;iBAC5B,IAAI,CAAC,KAAK,IAAI,EAAE;gBACb,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;gBAC9B,IAAI,CAAC;oBACD,iBAAiB,CAAC,2BAA2B,EAAE,CAC3C,SAAS,EACT,KAAK,CAAC,UAAU,CACnB,CAAA;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACL,UAAU;gBACd,CAAC;YACL,CAAC,CAAC;iBACD,KAAK,CAAC,WAAW,CAAC,CAAA;QAC3B,CAAC,CAAC,CACL,CAAA;QAED,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CACL,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC,GAAY,EAAE,EAAE;gBACjD,MAAM,GAAG,GAAG,GAA8B,CAAA;gBAC1C,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;oBAAE,OAAM;gBACvC,SAAS,CAAC,UAAW,CAAC,GAAG,CAAC,CAAA;YAC9B,CAAC,CAAC,CACL,CAAA;QACL,CAAC;QAED,IAAI,CAAC,IAAI,CACL,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC,GAAY,EAAE,EAAE;YACjD,MAAM,GAAG,GAAG,GAQX,CAAA;YACD,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;gBAAE,OAAM;YACvC,yDAAyD;YACzD,eAAe;iBACV,IAAI,CAAC,GAAG,EAAE;gBACP,MAAM,CAAC,GAAG,EAAE,GAAE,CAAC,EAAE,SAAS,EAAE;oBACxB,SAAS;oBACT,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,UAAU;oBAChC,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,WAAW;oBACnC,SAAS,EAAE,GAAG,CAAC,SAAS;iBACK,CAAC,CAAA;YACtC,CAAC,CAAC;iBACD,KAAK,CAAC,WAAW,CAAC,CAAA;QAC3B,CAAC,CAAC,CACL,CAAA;QAED,IAAI,CAAC,IAAI,CACL,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,GAAY,EAAE,EAAE;YAC9C,MAAM,GAAG,GAAG,GAKX,CAAA;YACD,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;gBAAE,OAAM;YACvC,IAAI,GAAG,CAAC,IAAI,KAAK,4BAA4B,EAAE,CAAC;gBAC5C,eAAe;qBACV,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;qBACf,IAAI,CAAC,GAAG,EAAE;oBACP,MAAM,CAAC,GAAG,EAAE,GAAE,CAAC,EAAE,SAAS,EAAE;wBACxB,SAAS;wBACT,UAAU,EAAE,CAAC;wBACb,UAAU,EACN,OAAO,CAAC,gBAAgB;4BACxB,OAAO,CAAC,UAAU;4BAClB,CAAC;wBACL,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;wBAC/B,MAAM,EAAE,UAAU;wBAClB,OAAO,EAAE,WAAW;wBACpB,SAAS,EAAE,IAAI;qBACc,CAAC,CAAA;gBACtC,CAAC,CAAC,CAAA;gBACN,OAAM;YACV,CAAC;YACD,WAAW,CACP,IAAI,gBAAgB,CAAC;gBACjB,IAAI,EACC,GAAG,CAAC,IAA6B;oBAClC,0BAA0B;gBAC9B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,qBAAqB;gBAC7C,aAAa,EAAE,GAAG,CAAC,aAAa;gBAChC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,QAAQ;gBAClB,WAAW,EAAE,KAAK;aACrB,CAAC,CACL,CAAA;QACL,CAAC,CAAC,CACL,CAAA;QAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,CAAC,GAAG,EAAE,GAAE,CAAC,EAAE,SAAS,EAAE;oBACxB,SAAS;oBACT,UAAU,EAAE,CAAC;oBACb,UAAU,EACN,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC;oBACvD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;oBAC/B,MAAM,EAAE,CAAC;oBACT,OAAO,EAAE,CAAC;oBACV,SAAS,EAAE,IAAI;iBACc,CAAC,CAAA;gBAClC,OAAM;YACV,CAAC;YACD,aAAa,GAAG,GAAG,EAAE;gBACjB,IAAI,CAAC;oBACD,iBAAiB,CAAC,qBAAqB,EAAE,CAAC,SAAS,CAAC,CAAA;gBACxD,CAAC;gBAAC,MAAM,CAAC;oBACL,UAAU;gBACd,CAAC;YACL,CAAC,CAAA;YACD,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;QAC3D,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAA;QACrD,iBAAiB,CAAC,eAAe,CAAC;YAC9B,GAAG,aAAa;YAChB,SAAS;YACT,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,SAAS;YAC/C,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;YAChD,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,CAAC;YACjD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;SACjD,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;AACN,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC7B,OAA+B,EAC/B,SAAmC;IAEnC,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAA;IACrC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;IACxD,IAAI,SAAS,EAAE,EAAE,CAAC;QACd,OAAO;YACH,SAAS;YACT,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC;YAC/D,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;YAC/B,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,IAAI;SAClB,CAAA;IACL,CAAC;IAED,IAAI,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC;YACvC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,KAAK;YACnD,cAAc,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;YACrC,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;YAC9C,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,SAAS;SAC/B,CAAC,CAAA;QAEF,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;QACvC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAA;QACnC,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAA;QACvC,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAA;QACvD,IAAI,eAAe,GAAG,IAAI,CAAC,GAAG,CAC1B,CAAC,EACD,IAAI,CAAC,KAAK,CAAC,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,QAAQ,CAC/D,CAAA;QACD,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC,CAAA;YACxD,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,CAAA;QAC3D,CAAC;QAED,MAAM,GAAG,GAAG,eAAe,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,CAAA;QAElF,IAAI,UAAU,GAAG,CAAC,CAAA;QAClB,IAAI,cAAc,GAAG,CAAC,CAAA;QACtB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;YACzD,IAAI,SAAS,EAAE,EAAE,CAAC;gBACd,OAAO;oBACH,SAAS;oBACT,UAAU;oBACV,UAAU;oBACV,QAAQ;oBACR,MAAM,EAAE,UAAU;oBAClB,OAAO,EAAE,cAAc;oBACvB,SAAS,EAAE,IAAI;iBAClB,CAAA;YACL,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;YACvD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YACjC,MAAM,WAAW,GAAG,GAAG,GAAG,QAAQ,CAAA;YAClC,MAAM,SAAS,GAAG,GAAG,GAAG,QAAQ,CAAA;YAChC,MAAM,KAAK,GAAyB;gBAChC,SAAS;gBACT,UAAU;gBACV,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC;gBAC1D,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC;gBACtD,UAAU,EAAE,IAAI,CAAC,KAAK,CAClB,CAAC,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,UAAU,CAAC,GAAG,IAAI,CAClD;gBACD,WAAW;gBACX,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,UAAU;gBACV,QAAQ;gBACR,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,GAAG,IAAI,GAAG,CAAC,MAAM;aAC7B,CAAA;YACD,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAC9B,SAAS,CAAC,UAAU,EAAE,CAAC;gBACnB,SAAS;gBACT,WAAW,EAAE,KAAK,CAAC,SAAS;gBAC5B,UAAU;gBACV,QAAQ,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;gBAC3D,aAAa,EAAE,UAAU,GAAG,CAAC;aAChC,CAAC,CAAA;YACF,UAAU,IAAI,CAAC,CAAA;YACf,cAAc,IAAI,KAAK,CAAC,MAAM,CAAA;QAClC,CAAC;QAED,OAAO;YACH,SAAS;YACT,UAAU;YACV,UAAU;YACV,QAAQ;YACR,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,cAAc;YACvB,SAAS,EAAE,KAAK;SACnB,CAAA;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACrD,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACpB,KAAmB,EACnB,KAAc;IAEd,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,gCAAgC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YAClB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QACzC,CAAC;QACD,OAAO,KAAK,CAAA;IAChB,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QAClB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACf,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAChB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACjB,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAA;AAChB,CAAC","sourcesContent":["import { LegacyEventEmitter, type EventSubscription } from 'expo-modules-core'\n\nimport AudioStudioModule from './AudioStudioModule'\nimport { isWeb } from './constants'\nimport {\n    AudioStreamError,\n    AudioStreamErrorCode,\n    mapStreamError,\n} from './errors/AudioStreamError'\nimport { processAudioBuffer } from './utils/audioProcessing'\n\n/**\n * High-level API: stream decoded audio from a stored file as bounded Float32\n * chunks without materializing the full PCM range in memory.\n *\n * See `docs/STREAM_AUDIO_DATA.md` for the full contract and rollout notes.\n */\nexport interface StreamAudioDataOptions {\n    /** URI of the audio file to decode. */\n    fileUri: string\n    /** Start time in milliseconds (default: 0). */\n    startTimeMs?: number\n    /** End time in milliseconds (default: end-of-file). */\n    endTimeMs?: number\n    /**\n     * Source sample rate hint. Ignored if `targetSampleRate` is set; native\n     * decoders read the actual rate from the file.\n     */\n    sampleRate?: number\n    /** Output sample rate. Native resamples when this differs from the file. */\n    targetSampleRate?: number\n    /** Output channel count (1 = mono downmix, 2 = stereo passthrough). */\n    channels?: number\n    /** Clamp samples to [-1, 1] and replace non-finite values with 0. */\n    normalizeAudio?: boolean\n    /** Target chunk duration in ms (default: 1000, min: 10, max: 60000). */\n    chunkDurationMs?: number\n    /** Soft cap on chunk size in bytes (Float32 = 4 bytes/sample). */\n    maxChunkBytes?: number\n    /** Max chunks queued in native before JS ack pauses decode (default: 4). */\n    maxBufferedChunks?: number\n    /** Output PCM format; only `'float32'` supported today. */\n    streamFormat?: 'float32'\n    /** Abort the in-flight request. Resolves promise with `cancelled: true`. */\n    signal?: AbortSignal\n}\n\nexport interface StreamAudioDataChunk {\n    /** Native request id; constant across all chunks of one call. */\n    requestId: string\n    /** Zero-based monotonic chunk index. */\n    chunkIndex: number\n    /** Start time in output-rate ms (rounded to nearest sample). */\n    startTimeMs: number\n    /** End time in output-rate ms. */\n    endTimeMs: number\n    /** Duration in ms (`endTimeMs - startTimeMs`). */\n    durationMs: number\n    /** First sample index in the output timeline. */\n    startSample: number\n    /** Sample count in `samples` (interleaved if channels > 1). */\n    sampleCount: number\n    /** Output sample rate. */\n    sampleRate: number\n    /** Output channel count. */\n    channels: number\n    /** Interleaved Float32 samples in [-1, 1]. */\n    samples: Float32Array\n    /** True for the last chunk of a non-cancelled run. */\n    isFinal: boolean\n}\n\nexport interface StreamAudioDataProgress {\n    requestId: string\n    processedMs: number\n    durationMs: number\n    progress: number\n    emittedChunks: number\n    bufferedChunks?: number\n}\n\nexport interface StreamAudioDataResult {\n    requestId: string\n    durationMs: number\n    sampleRate: number\n    channels: number\n    chunks: number\n    samples: number\n    cancelled: boolean\n}\n\nexport interface StreamAudioDataCallbacks {\n    /**\n     * Called with each decoded chunk. If this returns a Promise, native decode\n     * pauses until it resolves (backpressure). Throwing aborts the stream with\n     * `ERR_AUDIO_STREAM_DECODE_FAILED`.\n     */\n    onChunk: (chunk: StreamAudioDataChunk) => void | Promise<void>\n    /** Called whenever native reports progress. */\n    onProgress?: (progress: StreamAudioDataProgress) => void\n}\n\nexport interface AudioDecodeCapabilities {\n    platform: 'ios' | 'android' | 'web'\n    supportedInputFormats: string[]\n    supportedOutputFormats: Array<'float32'>\n    supportsCancellation: boolean\n    supportsBackpressure: boolean\n    supportsTimeRange: boolean\n    supportsTargetSampleRate: boolean\n    supportsChannelMixing: boolean\n    knownLimitations?: string[]\n}\n\nconst CHUNK_EVENT = 'AudioDataStreamChunk'\nconst PROGRESS_EVENT = 'AudioDataStreamProgress'\nconst COMPLETE_EVENT = 'AudioDataStreamComplete'\nconst ERROR_EVENT = 'AudioDataStreamError'\n\nlet cachedEmitter: LegacyEventEmitter | null = null\nfunction getEmitter(): LegacyEventEmitter {\n    if (!cachedEmitter) {\n        cachedEmitter = new LegacyEventEmitter(AudioStudioModule)\n    }\n    return cachedEmitter\n}\n\nfunction generateRequestId(): string {\n    const g = globalThis as { crypto?: { randomUUID?: () => string } }\n    if (typeof g.crypto?.randomUUID === 'function') {\n        try {\n            return g.crypto.randomUUID()\n        } catch {\n            // fall through\n        }\n    }\n    return `asd_${Date.now().toString(36)}_${Math.random()\n        .toString(36)\n        .slice(2, 10)}`\n}\n\nfunction toFloat32(samples: unknown): Float32Array {\n    if (samples instanceof Float32Array) return samples\n    if (Array.isArray(samples)) {\n        const out = new Float32Array(samples.length)\n        for (let i = 0; i < samples.length; i++) {\n            const v = Number(samples[i])\n            out[i] = Number.isFinite(v) ? v : 0\n        }\n        return out\n    }\n    if (typeof samples === 'string') {\n        const bytes = base64ToBytes(samples)\n        const aligned =\n            bytes.byteOffset % 4 === 0\n                ? new Float32Array(\n                      bytes.buffer,\n                      bytes.byteOffset,\n                      bytes.byteLength / 4\n                  )\n                : new Float32Array(bytes.buffer.slice(bytes.byteOffset))\n        return new Float32Array(aligned)\n    }\n    if (samples && typeof samples === 'object' && 'length' in samples) {\n        // ArrayLike fallback\n        const arr = samples as ArrayLike<number>\n        const out = new Float32Array(arr.length)\n        for (let i = 0; i < arr.length; i++) {\n            const v = Number(arr[i])\n            out[i] = Number.isFinite(v) ? v : 0\n        }\n        return out\n    }\n    return new Float32Array(0)\n}\n\nfunction base64ToBytes(input: string): Uint8Array {\n    const g = globalThis as { atob?: (s: string) => string }\n    if (typeof g.atob !== 'function') {\n        // Buffer path for environments without atob; React Native has atob.\n        const Buf = (globalThis as { Buffer?: { from: Function } }).Buffer\n        if (Buf) return new Uint8Array(Buf.from(input, 'base64'))\n        return new Uint8Array(0)\n    }\n    const bin = g.atob(input)\n    const out = new Uint8Array(bin.length)\n    for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i)\n    return out\n}\n\nfunction validateOptions(options: StreamAudioDataOptions): void {\n    if (!options.fileUri) {\n        throw new AudioStreamError({\n            code: 'ERR_AUDIO_STREAM_INVALID_RANGE',\n            message: 'fileUri is required',\n            recoverable: false,\n        })\n    }\n    if (\n        options.startTimeMs !== undefined &&\n        options.endTimeMs !== undefined &&\n        options.startTimeMs >= options.endTimeMs\n    ) {\n        throw new AudioStreamError({\n            code: 'ERR_AUDIO_STREAM_INVALID_RANGE',\n            message: 'startTimeMs must be < endTimeMs',\n            recoverable: false,\n        })\n    }\n    if (\n        options.chunkDurationMs !== undefined &&\n        (options.chunkDurationMs < 10 || options.chunkDurationMs > 60000)\n    ) {\n        throw new AudioStreamError({\n            code: 'ERR_AUDIO_STREAM_INVALID_RANGE',\n            message: 'chunkDurationMs must be in [10, 60000]',\n            recoverable: false,\n        })\n    }\n    if (\n        options.streamFormat !== undefined &&\n        options.streamFormat !== 'float32'\n    ) {\n        throw new AudioStreamError({\n            code: 'ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT',\n            message: `Unsupported streamFormat: ${options.streamFormat}`,\n            recoverable: false,\n        })\n    }\n}\n\n/**\n * Stream decoded audio from a stored file as bounded Float32 PCM chunks.\n *\n * Memory bound:\n *   `chunkDurationMs * sampleRate * channels * 4 * maxBufferedChunks` +\n *   native decoder buffers.\n *\n * Cancellation: pass `options.signal` and call `abort()`. The returned promise\n * resolves with `cancelled: true` (it does not reject) when cancellation wins.\n *\n * Backpressure: if `onChunk` returns a Promise, native decode is paused until\n * it resolves; if it throws, the stream is aborted with a `decode_failed` error.\n */\nexport async function streamAudioData(\n    options: StreamAudioDataOptions,\n    callbacks: StreamAudioDataCallbacks\n): Promise<StreamAudioDataResult> {\n    validateOptions(options)\n\n    if (isWeb) {\n        return streamAudioDataWeb(options, callbacks)\n    }\n\n    return streamAudioDataNative(options, callbacks)\n}\n\n/** Discover what the running platform supports. */\nexport async function getAudioDecodeCapabilities(): Promise<AudioDecodeCapabilities> {\n    if (isWeb) {\n        return {\n            platform: 'web',\n            supportedInputFormats: [\n                'audio/wav',\n                'audio/mpeg',\n                'audio/mp4',\n                'audio/aac',\n                'audio/ogg',\n                'audio/webm',\n            ],\n            supportedOutputFormats: ['float32'],\n            supportsCancellation: true,\n            supportsBackpressure: true,\n            supportsTimeRange: true,\n            supportsTargetSampleRate: true,\n            supportsChannelMixing: true,\n            knownLimitations: [\n                'Web decodes the entire file via AudioContext.decodeAudioData before chunking; very long files may exceed browser memory.',\n            ],\n        }\n    }\n    if (typeof AudioStudioModule.getAudioDecodeCapabilities === 'function') {\n        try {\n            const caps = await AudioStudioModule.getAudioDecodeCapabilities()\n            return caps as AudioDecodeCapabilities\n        } catch (err) {\n            throw mapStreamError(err, undefined, 'native')\n        }\n    }\n    throw new AudioStreamError({\n        code: 'ERR_AUDIO_STREAM_NATIVE_UNAVAILABLE',\n        message: 'getAudioDecodeCapabilities is not available on this build',\n        recoverable: false,\n    })\n}\n\nasync function streamAudioDataNative(\n    options: StreamAudioDataOptions,\n    callbacks: StreamAudioDataCallbacks\n): Promise<StreamAudioDataResult> {\n    if (typeof AudioStudioModule.streamAudioData !== 'function') {\n        throw new AudioStreamError({\n            code: 'ERR_AUDIO_STREAM_NATIVE_UNAVAILABLE',\n            message:\n                'streamAudioData native method missing — rebuild the host app with the latest @siteed/audio-studio.',\n            recoverable: false,\n        })\n    }\n\n    const requestId = generateRequestId()\n    const emitter = getEmitter()\n    const subs: EventSubscription[] = []\n    let chunkCount = 0\n    let sampleCount = 0\n    let processingChain: Promise<void> = Promise.resolve()\n    let settled = false\n    let abortListener: (() => void) | null = null\n\n    const finalize = () => {\n        for (const sub of subs) {\n            try {\n                sub.remove()\n            } catch {\n                /* noop */\n            }\n        }\n        subs.length = 0\n        if (abortListener && options.signal) {\n            options.signal.removeEventListener('abort', abortListener)\n        }\n    }\n\n    return new Promise<StreamAudioDataResult>((resolve, reject) => {\n        const settle = (\n            fn: () => void,\n            mode: 'resolve' | 'reject',\n            value: unknown\n        ) => {\n            if (settled) return\n            settled = true\n            finalize()\n            fn()\n            if (mode === 'resolve') {\n                resolve(value as StreamAudioDataResult)\n            } else {\n                reject(value as Error)\n            }\n        }\n\n        const handleError = (err: unknown) => {\n            settle(\n                () => {\n                    try {\n                        AudioStudioModule.cancelStreamAudioData?.(requestId)\n                    } catch {\n                        /* noop */\n                    }\n                },\n                'reject',\n                mapStreamError(err, options.fileUri, 'native')\n            )\n        }\n\n        subs.push(\n            emitter.addListener(CHUNK_EVENT, (raw: unknown) => {\n                const evt = raw as {\n                    requestId: string\n                    chunkIndex: number\n                    startTimeMs: number\n                    endTimeMs: number\n                    startSample: number\n                    sampleCount: number\n                    sampleRate: number\n                    channels: number\n                    samples: Float32Array | number[] | string\n                    isFinal: boolean\n                }\n                if (evt.requestId !== requestId) return\n                const chunk: StreamAudioDataChunk = {\n                    requestId: evt.requestId,\n                    chunkIndex: evt.chunkIndex,\n                    startTimeMs: evt.startTimeMs,\n                    endTimeMs: evt.endTimeMs,\n                    durationMs: evt.endTimeMs - evt.startTimeMs,\n                    startSample: evt.startSample,\n                    sampleCount: evt.sampleCount,\n                    sampleRate: evt.sampleRate,\n                    channels: evt.channels,\n                    samples: toFloat32(evt.samples),\n                    isFinal: evt.isFinal,\n                }\n                chunkCount += 1\n                sampleCount += chunk.sampleCount\n\n                processingChain = processingChain\n                    .then(async () => {\n                        await callbacks.onChunk(chunk)\n                        try {\n                            AudioStudioModule.acknowledgeStreamAudioChunk?.(\n                                requestId,\n                                chunk.chunkIndex\n                            )\n                        } catch {\n                            /* noop */\n                        }\n                    })\n                    .catch(handleError)\n            })\n        )\n\n        if (callbacks.onProgress) {\n            subs.push(\n                emitter.addListener(PROGRESS_EVENT, (raw: unknown) => {\n                    const evt = raw as StreamAudioDataProgress\n                    if (evt.requestId !== requestId) return\n                    callbacks.onProgress!(evt)\n                })\n            )\n        }\n\n        subs.push(\n            emitter.addListener(COMPLETE_EVENT, (raw: unknown) => {\n                const evt = raw as {\n                    requestId: string\n                    durationMs: number\n                    sampleRate: number\n                    channels: number\n                    chunks?: number\n                    samples?: number\n                    cancelled: boolean\n                }\n                if (evt.requestId !== requestId) return\n                // Wait for in-flight onChunk callbacks before resolving.\n                processingChain\n                    .then(() => {\n                        settle(() => {}, 'resolve', {\n                            requestId,\n                            durationMs: evt.durationMs,\n                            sampleRate: evt.sampleRate,\n                            channels: evt.channels,\n                            chunks: evt.chunks ?? chunkCount,\n                            samples: evt.samples ?? sampleCount,\n                            cancelled: evt.cancelled,\n                        } satisfies StreamAudioDataResult)\n                    })\n                    .catch(handleError)\n            })\n        )\n\n        subs.push(\n            emitter.addListener(ERROR_EVENT, (raw: unknown) => {\n                const evt = raw as {\n                    requestId: string\n                    code?: string\n                    message?: string\n                    nativeMessage?: string\n                }\n                if (evt.requestId !== requestId) return\n                if (evt.code === 'ERR_AUDIO_STREAM_CANCELLED') {\n                    processingChain\n                        .catch(() => {})\n                        .then(() => {\n                            settle(() => {}, 'resolve', {\n                                requestId,\n                                durationMs: 0,\n                                sampleRate:\n                                    options.targetSampleRate ??\n                                    options.sampleRate ??\n                                    0,\n                                channels: options.channels ?? 1,\n                                chunks: chunkCount,\n                                samples: sampleCount,\n                                cancelled: true,\n                            } satisfies StreamAudioDataResult)\n                        })\n                    return\n                }\n                handleError(\n                    new AudioStreamError({\n                        code:\n                            (evt.code as AudioStreamErrorCode) ??\n                            'ERR_AUDIO_STREAM_UNKNOWN',\n                        message: evt.message ?? 'native stream error',\n                        nativeMessage: evt.nativeMessage,\n                        fileUri: options.fileUri,\n                        platform: 'native',\n                        recoverable: false,\n                    })\n                )\n            })\n        )\n\n        if (options.signal) {\n            if (options.signal.aborted) {\n                settle(() => {}, 'resolve', {\n                    requestId,\n                    durationMs: 0,\n                    sampleRate:\n                        options.targetSampleRate ?? options.sampleRate ?? 0,\n                    channels: options.channels ?? 1,\n                    chunks: 0,\n                    samples: 0,\n                    cancelled: true,\n                } satisfies StreamAudioDataResult)\n                return\n            }\n            abortListener = () => {\n                try {\n                    AudioStudioModule.cancelStreamAudioData?.(requestId)\n                } catch {\n                    /* noop */\n                }\n            }\n            options.signal.addEventListener('abort', abortListener)\n        }\n\n        const { signal: _signal, ...nativeOptions } = options\n        AudioStudioModule.streamAudioData({\n            ...nativeOptions,\n            requestId,\n            streamFormat: options.streamFormat ?? 'float32',\n            chunkDurationMs: options.chunkDurationMs ?? 1000,\n            maxBufferedChunks: options.maxBufferedChunks ?? 4,\n            normalizeAudio: options.normalizeAudio ?? true,\n        }).catch(handleError)\n    })\n}\n\nasync function streamAudioDataWeb(\n    options: StreamAudioDataOptions,\n    callbacks: StreamAudioDataCallbacks\n): Promise<StreamAudioDataResult> {\n    const requestId = generateRequestId()\n    const cancelled = () => options.signal?.aborted === true\n    if (cancelled()) {\n        return {\n            requestId,\n            durationMs: 0,\n            sampleRate: options.targetSampleRate ?? options.sampleRate ?? 0,\n            channels: options.channels ?? 1,\n            chunks: 0,\n            samples: 0,\n            cancelled: true,\n        }\n    }\n\n    try {\n        const processed = await processAudioBuffer({\n            fileUri: options.fileUri,\n            targetSampleRate: options.targetSampleRate ?? 16000,\n            targetChannels: options.channels ?? 1,\n            normalizeAudio: options.normalizeAudio ?? true,\n            startTimeMs: options.startTimeMs,\n            endTimeMs: options.endTimeMs,\n        })\n\n        const sampleRate = processed.sampleRate\n        const channels = processed.channels\n        const durationMs = processed.durationMs\n        const chunkDurationMs = options.chunkDurationMs ?? 1000\n        let samplesPerChunk = Math.max(\n            1,\n            Math.floor((chunkDurationMs / 1000) * sampleRate) * channels\n        )\n        if (options.maxChunkBytes) {\n            const maxSamples = Math.floor(options.maxChunkBytes / 4)\n            samplesPerChunk = Math.min(samplesPerChunk, maxSamples)\n        }\n\n        const all = sanitizeFloat32(processed.channelData, options.normalizeAudio ?? true)\n\n        let chunkIndex = 0\n        let emittedSamples = 0\n        for (let off = 0; off < all.length; off += samplesPerChunk) {\n            if (cancelled()) {\n                return {\n                    requestId,\n                    durationMs,\n                    sampleRate,\n                    channels,\n                    chunks: chunkIndex,\n                    samples: emittedSamples,\n                    cancelled: true,\n                }\n            }\n            const end = Math.min(off + samplesPerChunk, all.length)\n            const slice = all.slice(off, end)\n            const startSample = off / channels\n            const endSample = end / channels\n            const chunk: StreamAudioDataChunk = {\n                requestId,\n                chunkIndex,\n                startTimeMs: Math.round((startSample / sampleRate) * 1000),\n                endTimeMs: Math.round((endSample / sampleRate) * 1000),\n                durationMs: Math.round(\n                    ((endSample - startSample) / sampleRate) * 1000\n                ),\n                startSample,\n                sampleCount: slice.length,\n                sampleRate,\n                channels,\n                samples: slice,\n                isFinal: end >= all.length,\n            }\n            await callbacks.onChunk(chunk)\n            callbacks.onProgress?.({\n                requestId,\n                processedMs: chunk.endTimeMs,\n                durationMs,\n                progress: durationMs > 0 ? chunk.endTimeMs / durationMs : 1,\n                emittedChunks: chunkIndex + 1,\n            })\n            chunkIndex += 1\n            emittedSamples += slice.length\n        }\n\n        return {\n            requestId,\n            durationMs,\n            sampleRate,\n            channels,\n            chunks: chunkIndex,\n            samples: emittedSamples,\n            cancelled: false,\n        }\n    } catch (err) {\n        throw mapStreamError(err, options.fileUri, 'web')\n    }\n}\n\nfunction sanitizeFloat32(\n    input: Float32Array,\n    clamp: boolean\n): Float32Array {\n    if (!clamp) {\n        // still need NaN/Inf sanitation\n        for (let i = 0; i < input.length; i++) {\n            const v = input[i]\n            if (!Number.isFinite(v)) input[i] = 0\n        }\n        return input\n    }\n    for (let i = 0; i < input.length; i++) {\n        const v = input[i]\n        if (!Number.isFinite(v)) {\n            input[i] = 0\n        } else if (v > 1) {\n            input[i] = 1\n        } else if (v < -1) {\n            input[i] = -1\n        }\n    }\n    return input\n}\n"]}