@siteed/audio-studio 3.1.1 → 3.2.0

package/build/cjs/streamAudioData.js

@@ -0,0 +1,534 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.streamAudioData = streamAudioData;
+exports.getAudioDecodeCapabilities = getAudioDecodeCapabilities;
+const expo_modules_core_1 = require("expo-modules-core");
+const AudioStudioModule_1 = __importDefault(require("./AudioStudioModule"));
+const constants_1 = require("./constants");
+const AudioStreamError_1 = require("./errors/AudioStreamError");
+const audioProcessing_1 = require("./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 expo_modules_core_1.LegacyEventEmitter(AudioStudioModule_1.default);
+    }
+    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 floatLength = Math.floor(bytes.byteLength / 4);
+        if (bytes.byteOffset % 4 === 0) {
+            return new Float32Array(bytes.buffer, bytes.byteOffset, floatLength);
+        }
+        const sliced = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+        return new Float32Array(sliced, 0, Math.floor(sliced.byteLength / 4));
+    }
+    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 rejectInvalidRange(message) {
+    throw new AudioStreamError_1.AudioStreamError({
+        code: 'ERR_AUDIO_STREAM_INVALID_RANGE',
+        message,
+        recoverable: false,
+    });
+}
+function assertPositiveFiniteOption(value, name, integer = false) {
+    if (value === undefined)
+        return;
+    if (!Number.isFinite(value) ||
+        value <= 0 ||
+        (integer && !Number.isInteger(value))) {
+        rejectInvalidRange(`${name} must be a positive${integer ? ' integer' : ''}`);
+    }
+}
+function validateOptions(options) {
+    if (!options.fileUri) {
+        rejectInvalidRange('fileUri is required');
+    }
+    if (options.startTimeMs !== undefined &&
+        options.endTimeMs !== undefined &&
+        options.startTimeMs >= options.endTimeMs) {
+        rejectInvalidRange('startTimeMs must be < endTimeMs');
+    }
+    if (options.endTimeMs !== undefined && options.endTimeMs <= 0) {
+        rejectInvalidRange('endTimeMs must be > 0');
+    }
+    if (options.startTimeMs !== undefined && options.startTimeMs < 0) {
+        rejectInvalidRange('startTimeMs must be >= 0');
+    }
+    if (options.chunkDurationMs !== undefined &&
+        (options.chunkDurationMs < 10 || options.chunkDurationMs > 60000)) {
+        rejectInvalidRange('chunkDurationMs must be in [10, 60000]');
+    }
+    if (options.backpressureTimeoutMs !== undefined &&
+        options.backpressureTimeoutMs < 0) {
+        rejectInvalidRange('backpressureTimeoutMs must be >= 0');
+    }
+    assertPositiveFiniteOption(options.targetSampleRate, 'targetSampleRate');
+    assertPositiveFiniteOption(options.sampleRate, 'sampleRate');
+    assertPositiveFiniteOption(options.channels, 'channels', true);
+    assertPositiveFiniteOption(options.maxBufferedChunks, 'maxBufferedChunks', true);
+    assertPositiveFiniteOption(options.maxChunkBytes, 'maxChunkBytes', true);
+    if (options.streamFormat !== undefined &&
+        options.streamFormat !== 'float32') {
+        throw new AudioStreamError_1.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.
+ */
+async function streamAudioData(options, callbacks) {
+    validateOptions(options);
+    if (constants_1.isWeb) {
+        return streamAudioDataWeb(options, callbacks);
+    }
+    return streamAudioDataNative(options, callbacks);
+}
+/** Discover what the running platform supports. */
+async function getAudioDecodeCapabilities() {
+    if (constants_1.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_1.default.getAudioDecodeCapabilities === 'function') {
+        try {
+            const caps = await AudioStudioModule_1.default.getAudioDecodeCapabilities();
+            return caps;
+        }
+        catch (err) {
+            throw (0, AudioStreamError_1.mapStreamError)(err, undefined, 'native');
+        }
+    }
+    throw new AudioStreamError_1.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_1.default.streamAudioData !== 'function') {
+        throw new AudioStreamError_1.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;
+    let lastProgress = 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_1.default.cancelStreamAudioData?.(requestId);
+                }
+                catch {
+                    /* noop */
+                }
+            }, 'reject', (0, AudioStreamError_1.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_1.default.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;
+                lastProgress = evt;
+                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 > 0
+                        ? evt.durationMs
+                        : (lastProgress?.durationMs ?? 0),
+                    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: lastProgress?.durationMs ?? 0,
+                        sampleRate: options.targetSampleRate ??
+                            options.sampleRate ??
+                            0,
+                        channels: options.channels ?? 1,
+                        chunks: chunkCount,
+                        samples: sampleCount,
+                        cancelled: true,
+                    });
+                });
+                return;
+            }
+            handleError(new AudioStreamError_1.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: lastProgress?.durationMs ?? 0,
+                    sampleRate: options.targetSampleRate ?? options.sampleRate ?? 0,
+                    channels: options.channels ?? 1,
+                    chunks: 0,
+                    samples: 0,
+                    cancelled: true,
+                });
+                return;
+            }
+            abortListener = () => {
+                try {
+                    AudioStudioModule_1.default.cancelStreamAudioData?.(requestId);
+                }
+                catch {
+                    /* noop */
+                }
+            };
+            options.signal.addEventListener('abort', abortListener);
+        }
+        const { signal: _signal, ...nativeOptions } = options;
+        AudioStudioModule_1.default.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 (0, audioProcessing_1.processAudioBuffer)({
+            fileUri: options.fileUri,
+            targetSampleRate: options.targetSampleRate,
+            targetChannels: options.channels,
+            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(channels, Math.floor((chunkDurationMs / 1000) * sampleRate) * channels);
+        if (options.maxChunkBytes) {
+            // Round down to a multiple of `channels` so we never split an
+            // interleaved frame across two chunks (that would produce a
+            // fractional `startSample` for the next chunk).
+            const rawMax = Math.floor(options.maxChunkBytes / 4);
+            const maxSamples = Math.max(channels, Math.floor(rawMax / channels) * channels);
+            samplesPerChunk = Math.max(channels, Math.min(samplesPerChunk, maxSamples));
+        }
+        const all = sanitizeFloat32(interleaveBuffer(processed.buffer, channels), options.normalizeAudio ?? true);
+        // Chunk timestamps are absolute (range start + offset) on every
+        // platform; progress is *elapsed within the range* so the
+        // `processedMs / durationMs` fraction stays in [0, 1] regardless of
+        // `startTimeMs`. The native decoders use the same split.
+        const rangeStartMs = options.startTimeMs ?? 0;
+        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 startMs = Math.round((startSample / sampleRate) * 1000) + rangeStartMs;
+            const endMs = Math.round((endSample / sampleRate) * 1000) + rangeStartMs;
+            const chunk = {
+                requestId,
+                chunkIndex,
+                startTimeMs: startMs,
+                endTimeMs: endMs,
+                durationMs: Math.round(((endSample - startSample) / sampleRate) * 1000),
+                startSample,
+                sampleCount: slice.length,
+                sampleRate,
+                channels,
+                samples: slice,
+                isFinal: end >= all.length,
+            };
+            await callbacks.onChunk(chunk);
+            // Resample rounding (Math.ceil in processAudioBuffer) can push
+            // elapsed past the source-rate-derived range duration on the tail
+            // chunk. Cap so onProgress consumers always see a [0, 1] ratio,
+            // matching the native `coerceIn(0, 1)` / `min(1, max(0, …))`
+            // clamp.
+            const rawElapsedMs = Math.round((endSample / sampleRate) * 1000);
+            const elapsedMs = durationMs > 0
+                ? Math.min(rawElapsedMs, durationMs)
+                : rawElapsedMs;
+            callbacks.onProgress?.({
+                requestId,
+                processedMs: elapsedMs,
+                durationMs,
+                progress: durationMs > 0
+                    ? Math.min(1, Math.max(0, elapsedMs / durationMs))
+                    : 1,
+                emittedChunks: chunkIndex + 1,
+            });
+            chunkIndex += 1;
+            emittedSamples += slice.length;
+        }
+        return {
+            requestId,
+            durationMs,
+            sampleRate,
+            channels,
+            chunks: chunkIndex,
+            samples: emittedSamples,
+            cancelled: false,
+        };
+    }
+    catch (err) {
+        throw (0, AudioStreamError_1.mapStreamError)(err, options.fileUri, 'web');
+    }
+}
+function interleaveBuffer(buffer, channels) {
+    const numCh = Math.max(1, Math.min(channels, buffer.numberOfChannels));
+    const framesPerCh = buffer.length;
+    if (numCh === 1) {
+        // Cheap path: clone channel 0 so downstream mutation doesn't touch the
+        // underlying AudioBuffer storage.
+        return new Float32Array(buffer.getChannelData(0));
+    }
+    const out = new Float32Array(framesPerCh * numCh);
+    const channelData = [];
+    for (let c = 0; c < numCh; c++) {
+        channelData.push(buffer.getChannelData(c));
+    }
+    for (let f = 0; f < framesPerCh; f++) {
+        for (let c = 0; c < numCh; c++) {
+            out[f * numCh + c] = channelData[c][f];
+        }
+    }
+    return out;
+}
+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/cjs/streamAudioData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamAudioData.js","sourceRoot":"","sources":["../../src/streamAudioData.ts"],"names":[],"mappings":"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","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    /**\n     * Optional timeout for a chunk acknowledgement while backpressure is active.\n     * Undefined/0 disables timeout so long transcription callbacks can run.\n     */\n    backpressureTimeoutMs?: 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 floatLength = Math.floor(bytes.byteLength / 4)\n        if (bytes.byteOffset % 4 === 0) {\n            return new Float32Array(bytes.buffer, bytes.byteOffset, floatLength)\n        }\n        const sliced = bytes.buffer.slice(\n            bytes.byteOffset,\n            bytes.byteOffset + bytes.byteLength\n        )\n        return new Float32Array(sliced, 0, Math.floor(sliced.byteLength / 4))\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 = (\n            globalThis as {\n                Buffer?: {\n                    from: (input: string, encoding: string) => Uint8Array\n                }\n            }\n        ).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 rejectInvalidRange(message: string): never {\n    throw new AudioStreamError({\n        code: 'ERR_AUDIO_STREAM_INVALID_RANGE',\n        message,\n        recoverable: false,\n    })\n}\n\nfunction assertPositiveFiniteOption(\n    value: number | undefined,\n    name: string,\n    integer = false\n): void {\n    if (value === undefined) return\n    if (\n        !Number.isFinite(value) ||\n        value <= 0 ||\n        (integer && !Number.isInteger(value))\n    ) {\n        rejectInvalidRange(\n            `${name} must be a positive${integer ? ' integer' : ''}`\n        )\n    }\n}\n\nfunction validateOptions(options: StreamAudioDataOptions): void {\n    if (!options.fileUri) {\n        rejectInvalidRange('fileUri is required')\n    }\n    if (\n        options.startTimeMs !== undefined &&\n        options.endTimeMs !== undefined &&\n        options.startTimeMs >= options.endTimeMs\n    ) {\n        rejectInvalidRange('startTimeMs must be < endTimeMs')\n    }\n    if (options.endTimeMs !== undefined && options.endTimeMs <= 0) {\n        rejectInvalidRange('endTimeMs must be > 0')\n    }\n    if (options.startTimeMs !== undefined && options.startTimeMs < 0) {\n        rejectInvalidRange('startTimeMs must be >= 0')\n    }\n    if (\n        options.chunkDurationMs !== undefined &&\n        (options.chunkDurationMs < 10 || options.chunkDurationMs > 60000)\n    ) {\n        rejectInvalidRange('chunkDurationMs must be in [10, 60000]')\n    }\n    if (\n        options.backpressureTimeoutMs !== undefined &&\n        options.backpressureTimeoutMs < 0\n    ) {\n        rejectInvalidRange('backpressureTimeoutMs must be >= 0')\n    }\n    assertPositiveFiniteOption(options.targetSampleRate, 'targetSampleRate')\n    assertPositiveFiniteOption(options.sampleRate, 'sampleRate')\n    assertPositiveFiniteOption(options.channels, 'channels', true)\n    assertPositiveFiniteOption(\n        options.maxBufferedChunks,\n        'maxBufferedChunks',\n        true\n    )\n    assertPositiveFiniteOption(options.maxChunkBytes, 'maxChunkBytes', true)\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    let lastProgress: StreamAudioDataProgress | 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                    lastProgress = evt\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:\n                                evt.durationMs > 0\n                                    ? evt.durationMs\n                                    : (lastProgress?.durationMs ?? 0),\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: lastProgress?.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: lastProgress?.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,\n            targetChannels: options.channels,\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            channels,\n            Math.floor((chunkDurationMs / 1000) * sampleRate) * channels\n        )\n        if (options.maxChunkBytes) {\n            // Round down to a multiple of `channels` so we never split an\n            // interleaved frame across two chunks (that would produce a\n            // fractional `startSample` for the next chunk).\n            const rawMax = Math.floor(options.maxChunkBytes / 4)\n            const maxSamples = Math.max(\n                channels,\n                Math.floor(rawMax / channels) * channels\n            )\n            samplesPerChunk = Math.max(\n                channels,\n                Math.min(samplesPerChunk, maxSamples)\n            )\n        }\n\n        const all = sanitizeFloat32(\n            interleaveBuffer(processed.buffer, channels),\n            options.normalizeAudio ?? true\n        )\n\n        // Chunk timestamps are absolute (range start + offset) on every\n        // platform; progress is *elapsed within the range* so the\n        // `processedMs / durationMs` fraction stays in [0, 1] regardless of\n        // `startTimeMs`. The native decoders use the same split.\n        const rangeStartMs = options.startTimeMs ?? 0\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 startMs =\n                Math.round((startSample / sampleRate) * 1000) + rangeStartMs\n            const endMs =\n                Math.round((endSample / sampleRate) * 1000) + rangeStartMs\n            const chunk: StreamAudioDataChunk = {\n                requestId,\n                chunkIndex,\n                startTimeMs: startMs,\n                endTimeMs: endMs,\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            // Resample rounding (Math.ceil in processAudioBuffer) can push\n            // elapsed past the source-rate-derived range duration on the tail\n            // chunk. Cap so onProgress consumers always see a [0, 1] ratio,\n            // matching the native `coerceIn(0, 1)` / `min(1, max(0, …))`\n            // clamp.\n            const rawElapsedMs = Math.round((endSample / sampleRate) * 1000)\n            const elapsedMs =\n                durationMs > 0\n                    ? Math.min(rawElapsedMs, durationMs)\n                    : rawElapsedMs\n            callbacks.onProgress?.({\n                requestId,\n                processedMs: elapsedMs,\n                durationMs,\n                progress:\n                    durationMs > 0\n                        ? Math.min(1, Math.max(0, elapsedMs / durationMs))\n                        : 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 interleaveBuffer(buffer: AudioBuffer, channels: number): Float32Array {\n    const numCh = Math.max(1, Math.min(channels, buffer.numberOfChannels))\n    const framesPerCh = buffer.length\n    if (numCh === 1) {\n        // Cheap path: clone channel 0 so downstream mutation doesn't touch the\n        // underlying AudioBuffer storage.\n        return new Float32Array(buffer.getChannelData(0))\n    }\n    const out = new Float32Array(framesPerCh * numCh)\n    const channelData: Float32Array[] = []\n    for (let c = 0; c < numCh; c++) {\n        channelData.push(buffer.getChannelData(c))\n    }\n    for (let f = 0; f < framesPerCh; f++) {\n        for (let c = 0; c < numCh; c++) {\n            out[f * numCh + c] = channelData[c][f]\n        }\n    }\n    return out\n}\n\nfunction sanitizeFloat32(input: Float32Array, clamp: boolean): 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"]}