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

package/android/src/main/java/net/siteed/audiostudio/AudioStudioModule.kt

@@ -664,6 +664,21 @@ class AudioStudioModule : Module(), EventSender, AudioStreamDecoderDelegate {
             // while keeping the same module instance, and a fully cancelled
             // scope would silently no-op every subsequent launch.
             coroutineScope.coroutineContext.cancelChildren()
+            // Cancel any in-flight streamAudioData decoders before teardown.
+            // Their worker threads are not children of `coroutineScope` and
+            // would otherwise keep running, emitting events through a
+            // destroyed module. We clear the map *before* cancelling so that
+            // any terminal events the worker emits after observing
+            // `cancel()` are dropped by `streamDecoderEmit` (which gates on
+            // map membership). The map itself stays usable so Expo can
+            // recreate decoders on a dev-client reload without resetting any
+            // global flag.
+            val inflight = synchronized(streamDecodersLock) {
+                val snapshot = streamDecoders.values.toList()
+                streamDecoders.clear()
+                snapshot
+            }
+            inflight.forEach { it.cancel() }
             AudioRecorderManager.destroy()
         }
 
@@ -1021,20 +1036,29 @@ class AudioStudioModule : Module(), EventSender, AudioStreamDecoderDelegate {
                 val context = appContext.reactContext
                     ?: throw IllegalStateException("React context not available")
 
+                val chunkDurationMs = (options["chunkDurationMs"] as? Number)?.toInt() ?: 1000
+                if (chunkDurationMs !in 10..60000) {
+                    promise.reject(
+                        "ERR_AUDIO_STREAM_INVALID_RANGE",
+                        "chunkDurationMs must be in [10, 60000]",
+                        null
+                    )
+                    return@AsyncFunction
+                }
+
                 val decoderOptions = AudioStreamDecoder.Options(
                     requestId = requestId,
                     fileUri = fileUri,
                     startTimeMs = (options["startTimeMs"] as? Number)?.toLong(),
                     endTimeMs = (options["endTimeMs"] as? Number)?.toLong(),
-                    targetSampleRate = (options["targetSampleRate"] as? Number)?.toInt()
-                        ?: (options["sampleRate"] as? Number)?.toInt(),
+                    targetSampleRate = (options["targetSampleRate"] as? Number)?.toInt(),
                     channels = (options["channels"] as? Number)?.toInt(),
                     normalizeAudio = (options["normalizeAudio"] as? Boolean) ?: true,
-                    chunkDurationMs = ((options["chunkDurationMs"] as? Number)?.toInt() ?: 1000)
-                        .coerceIn(10, 60000),
+                    chunkDurationMs = chunkDurationMs,
                     maxChunkBytes = (options["maxChunkBytes"] as? Number)?.toInt(),
                     maxBufferedChunks = ((options["maxBufferedChunks"] as? Number)?.toInt() ?: 4)
                         .coerceAtLeast(1),
+                    backpressureTimeoutMs = (options["backpressureTimeoutMs"] as? Number)?.toLong(),
                 )
 
                 val decoder = AudioStreamDecoder(context, decoderOptions, this@AudioStudioModule)
@@ -1113,14 +1137,23 @@ class AudioStudioModule : Module(), EventSender, AudioStreamDecoderDelegate {
     }
 
     override fun streamDecoderEmit(eventName: String, payload: Bundle) {
+        // Drop events from decoders that are no longer tracked. This catches
+        // both the OnDestroy teardown path (map cleared before `cancel()`) and
+        // post-completion stragglers, without depending on a one-way shutdown
+        // flag that would survive Expo's `definition()` re-runs.
+        val requestId = payload.getString("requestId") ?: return
+        val isActive = synchronized(streamDecodersLock) {
+            streamDecoders.containsKey(requestId)
+        }
+        if (!isActive) return
         when (eventName) {
             Constants.AUDIO_STREAM_COMPLETE_EVENT -> {
-                (payload.getString("requestId"))?.let { releaseStreamDecoder(it) }
+                releaseStreamDecoder(requestId)
             }
             Constants.AUDIO_STREAM_ERROR_EVENT -> {
                 val code = payload.getString("code") ?: ""
                 if (code != "ERR_AUDIO_STREAM_CANCELLED") {
-                    payload.getString("requestId")?.let { releaseStreamDecoder(it) }
+                    releaseStreamDecoder(requestId)
                 }
             }
         }

package/build/cjs/errors/AudioStreamError.js

@@ -58,6 +58,12 @@ function getNativeCode(err) {
     }
     return undefined;
 }
+function isUnknownAudioStreamCode(raw) {
+    if (!raw)
+        return false;
+    return (raw.toUpperCase().startsWith('ERR_AUDIO_STREAM_') &&
+        normalizeCode(raw) === null);
+}
 function normalizeCode(raw) {
     if (!raw)
         return null;
@@ -118,6 +124,9 @@ function mapStreamError(err, fileUri, platform) {
     const nativeMessage = getNativeMessage(err);
     const nativeCode = getNativeCode(err);
     const lower = nativeMessage.toLowerCase();
+    if (isUnknownAudioStreamCode(nativeCode)) {
+        console.warn(`[AudioStreamError] Unknown native audio stream error code: ${nativeCode}`);
+    }
     let code = normalizeCode(nativeCode) ??
         normalizeCode(nativeMessage) ??
         'ERR_AUDIO_STREAM_UNKNOWN';

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

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

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

@@ -11,7 +11,10 @@ describe('AudioStreamError', () => {
         expect((0, AudioStreamError_1.mapStreamError)(original)).toBe(original);
     });
     it('maps native FILE_NOT_FOUND code', () => {
-        const mapped = (0, AudioStreamError_1.mapStreamError)({ code: 'FILE_NOT_FOUND', message: 'gone' });
+        const mapped = (0, AudioStreamError_1.mapStreamError)({
+            code: 'FILE_NOT_FOUND',
+            message: 'gone',
+        });
         expect(mapped.code).toBe('ERR_AUDIO_STREAM_FILE_NOT_FOUND');
         expect(mapped.recoverable).toBe(false);
     });
@@ -27,10 +30,28 @@ describe('AudioStreamError', () => {
         expect(mapped.code).toBe('ERR_AUDIO_STREAM_CANCELLED');
         expect(mapped.recoverable).toBe(true);
     });
+    it('maps backpressure timeout as recoverable', () => {
+        const mapped = (0, AudioStreamError_1.mapStreamError)({
+            code: 'ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT',
+            message: 'ack timed out',
+        });
+        expect(mapped.code).toBe('ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT');
+        expect(mapped.recoverable).toBe(true);
+    });
     it('falls back to UNKNOWN', () => {
         const mapped = (0, AudioStreamError_1.mapStreamError)({});
         expect(mapped.code).toBe('ERR_AUDIO_STREAM_UNKNOWN');
     });
+    it('warns when native returns an unknown audio stream code', () => {
+        const warn = jest.spyOn(console, 'warn').mockImplementation(() => { });
+        const mapped = (0, AudioStreamError_1.mapStreamError)({
+            code: 'ERR_AUDIO_STREAM_FOOBAR',
+            message: 'new native code',
+        });
+        expect(mapped.code).toBe('ERR_AUDIO_STREAM_UNKNOWN');
+        expect(warn).toHaveBeenCalledWith('[AudioStreamError] Unknown native audio stream error code: ERR_AUDIO_STREAM_FOOBAR');
+        warn.mockRestore();
+    });
     it('preserves nativeCode and nativeMessage', () => {
         const mapped = (0, AudioStreamError_1.mapStreamError)({
             code: 'WEIRD_NATIVE_CODE',

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

@@ -1 +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"]}
+{"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({\n            code: 'FILE_NOT_FOUND',\n            message: 'gone',\n        })\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(\n            new Error('No suitable codec for audio/opus')\n        )\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('maps backpressure timeout as recoverable', () => {\n        const mapped = mapStreamError({\n            code: 'ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT',\n            message: 'ack timed out',\n        })\n        expect(mapped.code).toBe('ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT')\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('warns when native returns an unknown audio stream code', () => {\n        const warn = jest.spyOn(console, 'warn').mockImplementation(() => {})\n        const mapped = mapStreamError({\n            code: 'ERR_AUDIO_STREAM_FOOBAR',\n            message: 'new native code',\n        })\n        expect(mapped.code).toBe('ERR_AUDIO_STREAM_UNKNOWN')\n        expect(warn).toHaveBeenCalledWith(\n            '[AudioStreamError] Unknown native audio stream error code: ERR_AUDIO_STREAM_FOOBAR'\n        )\n        warn.mockRestore()\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/cjs/streamAudioData.js

@@ -48,10 +48,12 @@ function toFloat32(samples) {
     }
     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);
+        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
@@ -80,31 +82,50 @@ function base64ToBytes(input) {
         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) {
-        throw new AudioStreamError_1.AudioStreamError({
-            code: 'ERR_AUDIO_STREAM_INVALID_RANGE',
-            message: 'fileUri is required',
-            recoverable: false,
-        });
+        rejectInvalidRange('fileUri is required');
     }
     if (options.startTimeMs !== undefined &&
         options.endTimeMs !== undefined &&
         options.startTimeMs >= options.endTimeMs) {
-        throw new AudioStreamError_1.AudioStreamError({
-            code: 'ERR_AUDIO_STREAM_INVALID_RANGE',
-            message: 'startTimeMs must be < endTimeMs',
-            recoverable: false,
-        });
+        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)) {
-        throw new AudioStreamError_1.AudioStreamError({
-            code: 'ERR_AUDIO_STREAM_INVALID_RANGE',
-            message: 'chunkDurationMs must be in [10, 60000]',
-            recoverable: false,
-        });
+        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({
@@ -189,6 +210,7 @@ async function streamAudioDataNative(options, callbacks) {
     let processingChain = Promise.resolve();
     let settled = false;
     let abortListener = null;
+    let lastProgress = null;
     const finalize = () => {
         for (const sub of subs) {
             try {
@@ -263,6 +285,7 @@ async function streamAudioDataNative(options, callbacks) {
                 const evt = raw;
                 if (evt.requestId !== requestId)
                     return;
+                lastProgress = evt;
                 callbacks.onProgress(evt);
             }));
         }
@@ -275,7 +298,9 @@ async function streamAudioDataNative(options, callbacks) {
                 .then(() => {
                 settle(() => { }, 'resolve', {
                     requestId,
-                    durationMs: evt.durationMs,
+                    durationMs: evt.durationMs > 0
+                        ? evt.durationMs
+                        : (lastProgress?.durationMs ?? 0),
                     sampleRate: evt.sampleRate,
                     channels: evt.channels,
                     chunks: evt.chunks ?? chunkCount,
@@ -295,7 +320,7 @@ async function streamAudioDataNative(options, callbacks) {
                     .then(() => {
                     settle(() => { }, 'resolve', {
                         requestId,
-                        durationMs: 0,
+                        durationMs: lastProgress?.durationMs ?? 0,
                         sampleRate: options.targetSampleRate ??
                             options.sampleRate ??
                             0,
@@ -321,7 +346,7 @@ async function streamAudioDataNative(options, callbacks) {
             if (options.signal.aborted) {
                 settle(() => { }, 'resolve', {
                     requestId,
-                    durationMs: 0,
+                    durationMs: lastProgress?.durationMs ?? 0,
                     sampleRate: options.targetSampleRate ?? options.sampleRate ?? 0,
                     channels: options.channels ?? 1,
                     chunks: 0,
@@ -368,8 +393,8 @@ async function streamAudioDataWeb(options, callbacks) {
     try {
         const processed = await (0, audioProcessing_1.processAudioBuffer)({
             fileUri: options.fileUri,
-            targetSampleRate: options.targetSampleRate ?? 16000,
-            targetChannels: options.channels ?? 1,
+            targetSampleRate: options.targetSampleRate,
+            targetChannels: options.channels,
             normalizeAudio: options.normalizeAudio ?? true,
             startTimeMs: options.startTimeMs,
             endTimeMs: options.endTimeMs,
@@ -378,12 +403,21 @@ async function streamAudioDataWeb(options, callbacks) {
         const channels = processed.channels;
         const durationMs = processed.durationMs;
         const chunkDurationMs = options.chunkDurationMs ?? 1000;
-        let samplesPerChunk = Math.max(1, Math.floor((chunkDurationMs / 1000) * sampleRate) * channels);
+        let samplesPerChunk = Math.max(channels, Math.floor((chunkDurationMs / 1000) * sampleRate) * channels);
         if (options.maxChunkBytes) {
-            const maxSamples = Math.floor(options.maxChunkBytes / 4);
-            samplesPerChunk = Math.min(samplesPerChunk, maxSamples);
+            // 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(processed.channelData, options.normalizeAudio ?? true);
+        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) {
@@ -402,11 +436,13 @@ async function streamAudioDataWeb(options, callbacks) {
             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: Math.round((startSample / sampleRate) * 1000),
-                endTimeMs: Math.round((endSample / sampleRate) * 1000),
+                startTimeMs: startMs,
+                endTimeMs: endMs,
                 durationMs: Math.round(((endSample - startSample) / sampleRate) * 1000),
                 startSample,
                 sampleCount: slice.length,
@@ -416,11 +452,22 @@ async function streamAudioDataWeb(options, callbacks) {
                 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: chunk.endTimeMs,
+                processedMs: elapsedMs,
                 durationMs,
-                progress: durationMs > 0 ? chunk.endTimeMs / durationMs : 1,
+                progress: durationMs > 0
+                    ? Math.min(1, Math.max(0, elapsedMs / durationMs))
+                    : 1,
                 emittedChunks: chunkIndex + 1,
             });
             chunkIndex += 1;
@@ -440,6 +487,26 @@ async function streamAudioDataWeb(options, callbacks) {
         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