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

package/build/esm/AudioAnalysis/extractPreview.js

@@ -1,25 +1,102 @@
+import { mapExtractionError } from '../errors/AudioExtractionError';
 import { extractAudioAnalysis } from './extractAudioAnalysis';
+const DEFAULT_SILENCE_THRESHOLD = 0.01;
+/**
+ * Apply a silence threshold to the data points by recomputing the `silent` flag from rms.
+ * Returns a new array (does not mutate the source).
+ */
+function applySilenceThreshold(dataPoints, threshold) {
+    return dataPoints.map((p) => ({
+        ...p,
+        silent: p.rms < threshold,
+    }));
+}
+const SMALL_TOTAL_INSTANT_THRESHOLD = 50;
+const PROGRESSIVE_BATCH_DELAY_MS = 30;
+const PROGRESSIVE_BATCH_COUNT = 8;
+/**
+ * Schedule progressive emission of points after the native one-shot resolve.
+ * Native progressive streaming is a future enhancement; today the points are
+ * micro-batched on the JS side so consumers (and the agentic recipe runner)
+ * can observe an in-flight `pointsReceived < totalPoints` window.
+ */
+function emitPointsProgressively(dataPoints, onPointReady, signal, logger) {
+    const total = dataPoints.length;
+    if (total === 0)
+        return;
+    const safeEmit = (point, index) => {
+        if (signal?.aborted)
+            return;
+        try {
+            onPointReady(point, index, total);
+        }
+        catch (err) {
+            // Swallow callback errors so a buggy consumer cannot break extraction.
+            logger?.warn?.('extractPreview onPointReady callback failed', err);
+        }
+    };
+    if (signal?.aborted)
+        return;
+    if (total <= SMALL_TOTAL_INSTANT_THRESHOLD) {
+        for (let i = 0; i < total; i++)
+            safeEmit(dataPoints[i], i);
+        return;
+    }
+    // First quarter flushes immediately so the UI shows something within a frame.
+    const firstFlushCount = Math.max(1, Math.floor(total / 4));
+    for (let i = 0; i < firstFlushCount; i++)
+        safeEmit(dataPoints[i], i);
+    if (firstFlushCount >= total)
+        return;
+    const remaining = total - firstFlushCount;
+    const batchSize = Math.max(1, Math.ceil(remaining / PROGRESSIVE_BATCH_COUNT));
+    let cursor = firstFlushCount;
+    const pump = () => {
+        if (signal?.aborted)
+            return;
+        const end = Math.min(total, cursor + batchSize);
+        for (let i = cursor; i < end; i++)
+            safeEmit(dataPoints[i], i);
+        cursor = end;
+        if (cursor < total) {
+            setTimeout(pump, PROGRESSIVE_BATCH_DELAY_MS);
+        }
+    };
+    setTimeout(pump, PROGRESSIVE_BATCH_DELAY_MS);
+}
 /**
  * Generates a simplified preview of the audio waveform for quick visualization.
  * Ideal for UI rendering with a specified number of points.
  *
  * @param options - The options for the preview, including file URI and time range.
  * @returns A promise that resolves to the audio preview data.
+ * @throws {AudioExtractionError} when the underlying extraction fails.
  */
-export async function extractPreview({ fileUri, numberOfPoints = 100, startTimeMs = 0, endTimeMs = 30000, // First 30 seconds
-decodingOptions, logger, }) {
-    const durationMs = endTimeMs - startTimeMs;
-    const segmentDurationMs = Math.floor(durationMs / numberOfPoints);
-    // Call extractAudioAnalysis with calculated parameters
-    const analysis = await extractAudioAnalysis({
-        fileUri,
-        startTimeMs,
-        endTimeMs,
-        logger,
-        segmentDurationMs,
-        decodingOptions,
-    });
-    // Transform the result into AudioPreview format
-    return analysis;
+export async function extractPreview({ fileUri, numberOfPoints = 100, startTimeMs = 0, endTimeMs = 30000, decodingOptions, logger, onPointReady, signal, }) {
+    const durationMs = Math.max(1, endTimeMs - startTimeMs);
+    const segmentDurationMs = Math.max(1, Math.floor(durationMs / numberOfPoints));
+    let analysis;
+    try {
+        analysis = await extractAudioAnalysis({
+            fileUri,
+            startTimeMs,
+            endTimeMs,
+            logger,
+            segmentDurationMs,
+            decodingOptions,
+        });
+    }
+    catch (err) {
+        throw mapExtractionError(err, fileUri);
+    }
+    const threshold = decodingOptions?.silenceRmsThreshold ?? DEFAULT_SILENCE_THRESHOLD;
+    const adjusted = {
+        ...analysis,
+        dataPoints: applySilenceThreshold(analysis.dataPoints, threshold),
+    };
+    if (onPointReady) {
+        emitPointsProgressively(adjusted.dataPoints, onPointReady, signal, logger);
+    }
+    return adjusted;
 }
 //# sourceMappingURL=extractPreview.js.map

package/build/esm/AudioAnalysis/extractPreview.js.map

@@ -1 +1 @@
-{"version":3,"file":"extractPreview.js","sourceRoot":"","sources":["../../../src/AudioAnalysis/extractPreview.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE7D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EACjC,OAAO,EACP,cAAc,GAAG,GAAG,EACpB,WAAW,GAAG,CAAC,EACf,SAAS,GAAG,KAAK,EAAE,mBAAmB;AACtC,eAAe,EACf,MAAM,GACO;IACb,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,CAAA;IAC1C,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,cAAc,CAAC,CAAA;IAEjE,uDAAuD;IACvD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC;QACxC,OAAO;QACP,WAAW;QACX,SAAS;QACT,MAAM;QACN,iBAAiB;QACjB,eAAe;KAClB,CAAC,CAAA;IAEF,gDAAgD;IAChD,OAAO,QAAQ,CAAA;AACnB,CAAC","sourcesContent":["import { PreviewOptions, AudioAnalysis } from './AudioAnalysis.types'\nimport { extractAudioAnalysis } from './extractAudioAnalysis'\n\n/**\n * Generates a simplified preview of the audio waveform for quick visualization.\n * Ideal for UI rendering with a specified number of points.\n *\n * @param options - The options for the preview, including file URI and time range.\n * @returns A promise that resolves to the audio preview data.\n */\nexport async function extractPreview({\n    fileUri,\n    numberOfPoints = 100,\n    startTimeMs = 0,\n    endTimeMs = 30000, // First 30 seconds\n    decodingOptions,\n    logger,\n}: PreviewOptions): Promise<AudioAnalysis> {\n    const durationMs = endTimeMs - startTimeMs\n    const segmentDurationMs = Math.floor(durationMs / numberOfPoints)\n\n    // Call extractAudioAnalysis with calculated parameters\n    const analysis = await extractAudioAnalysis({\n        fileUri,\n        startTimeMs,\n        endTimeMs,\n        logger,\n        segmentDurationMs,\n        decodingOptions,\n    })\n\n    // Transform the result into AudioPreview format\n    return analysis\n}\n"]}
+{"version":3,"file":"extractPreview.js","sourceRoot":"","sources":["../../../src/AudioAnalysis/extractPreview.ts"],"names":[],"mappings":"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","sourcesContent":["import { mapExtractionError } from '../errors/AudioExtractionError'\nimport { PreviewOptions, AudioAnalysis, DataPoint } from './AudioAnalysis.types'\nimport { extractAudioAnalysis } from './extractAudioAnalysis'\n\nconst DEFAULT_SILENCE_THRESHOLD = 0.01\n\n/**\n * Apply a silence threshold to the data points by recomputing the `silent` flag from rms.\n * Returns a new array (does not mutate the source).\n */\nfunction applySilenceThreshold(\n    dataPoints: DataPoint[],\n    threshold: number\n): DataPoint[] {\n    return dataPoints.map((p) => ({\n        ...p,\n        silent: p.rms < threshold,\n    }))\n}\n\nconst SMALL_TOTAL_INSTANT_THRESHOLD = 50\nconst PROGRESSIVE_BATCH_DELAY_MS = 30\nconst PROGRESSIVE_BATCH_COUNT = 8\n\n/**\n * Schedule progressive emission of points after the native one-shot resolve.\n * Native progressive streaming is a future enhancement; today the points are\n * micro-batched on the JS side so consumers (and the agentic recipe runner)\n * can observe an in-flight `pointsReceived < totalPoints` window.\n */\nfunction emitPointsProgressively(\n    dataPoints: DataPoint[],\n    onPointReady: NonNullable<PreviewOptions['onPointReady']>,\n    signal?: PreviewOptions['signal'],\n    logger?: PreviewOptions['logger']\n): void {\n    const total = dataPoints.length\n    if (total === 0) return\n\n    const safeEmit = (point: DataPoint, index: number) => {\n        if (signal?.aborted) return\n        try {\n            onPointReady(point, index, total)\n        } catch (err) {\n            // Swallow callback errors so a buggy consumer cannot break extraction.\n            logger?.warn?.('extractPreview onPointReady callback failed', err)\n        }\n    }\n\n    if (signal?.aborted) return\n    if (total <= SMALL_TOTAL_INSTANT_THRESHOLD) {\n        for (let i = 0; i < total; i++) safeEmit(dataPoints[i], i)\n        return\n    }\n\n    // First quarter flushes immediately so the UI shows something within a frame.\n    const firstFlushCount = Math.max(1, Math.floor(total / 4))\n    for (let i = 0; i < firstFlushCount; i++) safeEmit(dataPoints[i], i)\n\n    if (firstFlushCount >= total) return\n\n    const remaining = total - firstFlushCount\n    const batchSize = Math.max(\n        1,\n        Math.ceil(remaining / PROGRESSIVE_BATCH_COUNT)\n    )\n    let cursor = firstFlushCount\n    const pump = () => {\n        if (signal?.aborted) return\n        const end = Math.min(total, cursor + batchSize)\n        for (let i = cursor; i < end; i++) safeEmit(dataPoints[i], i)\n        cursor = end\n        if (cursor < total) {\n            setTimeout(pump, PROGRESSIVE_BATCH_DELAY_MS)\n        }\n    }\n    setTimeout(pump, PROGRESSIVE_BATCH_DELAY_MS)\n}\n\n/**\n * Generates a simplified preview of the audio waveform for quick visualization.\n * Ideal for UI rendering with a specified number of points.\n *\n * @param options - The options for the preview, including file URI and time range.\n * @returns A promise that resolves to the audio preview data.\n * @throws {AudioExtractionError} when the underlying extraction fails.\n */\nexport async function extractPreview({\n    fileUri,\n    numberOfPoints = 100,\n    startTimeMs = 0,\n    endTimeMs = 30000,\n    decodingOptions,\n    logger,\n    onPointReady,\n    signal,\n}: PreviewOptions): Promise<AudioAnalysis> {\n    const durationMs = Math.max(1, endTimeMs - startTimeMs)\n    const segmentDurationMs = Math.max(\n        1,\n        Math.floor(durationMs / numberOfPoints)\n    )\n\n    let analysis: AudioAnalysis\n    try {\n        analysis = await extractAudioAnalysis({\n            fileUri,\n            startTimeMs,\n            endTimeMs,\n            logger,\n            segmentDurationMs,\n            decodingOptions,\n        })\n    } catch (err) {\n        throw mapExtractionError(err, fileUri)\n    }\n\n    const threshold =\n        decodingOptions?.silenceRmsThreshold ?? DEFAULT_SILENCE_THRESHOLD\n    const adjusted: AudioAnalysis = {\n        ...analysis,\n        dataPoints: applySilenceThreshold(analysis.dataPoints, threshold),\n    }\n\n    if (onPointReady) {\n        emitPointsProgressively(\n            adjusted.dataPoints,\n            onPointReady,\n            signal,\n            logger\n        )\n    }\n\n    return adjusted\n}\n"]}

package/build/esm/AudioAnalysis/extractPreviewBars.js

@@ -0,0 +1,128 @@
+import { extractPreview } from './extractPreview';
+import AudioStudioModule from '../AudioStudioModule';
+import { mapExtractionError } from '../errors/AudioExtractionError';
+import { cleanNativeOptions } from '../utils/cleanNativeOptions';
+const DEFAULT_PREVIEW_BARS = 100;
+const DEFAULT_PREVIEW_END_TIME_MS = 30000;
+const DEFAULT_SILENCE_THRESHOLD = 0.01;
+function hasNativePreviewBars(module) {
+    return (module !== null &&
+        (typeof module === 'object' || typeof module === 'function') &&
+        typeof module.extractPreviewBars ===
+            'function');
+}
+function clamp01(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.max(0, Math.min(1, value));
+}
+function getPointTimeMs(value, fallbackMs) {
+    return typeof value === 'number' && Number.isFinite(value)
+        ? Math.round(value)
+        : fallbackMs;
+}
+function pointToPreviewBar(point, index, fallbackBarDurationMs, silenceRmsThreshold) {
+    const fallbackStartTimeMs = Math.round(index * fallbackBarDurationMs);
+    const fallbackEndTimeMs = Math.round((index + 1) * fallbackBarDurationMs);
+    const startTimeMs = getPointTimeMs(point.startTime, fallbackStartTimeMs);
+    const endTimeMs = getPointTimeMs(point.endTime, fallbackEndTimeMs);
+    const rms = clamp01(point.rms);
+    return {
+        id: point.id ?? index,
+        amplitude: clamp01(point.amplitude),
+        rms,
+        silent: point.silent ?? rms < silenceRmsThreshold,
+        startTimeMs,
+        endTimeMs: Math.max(startTimeMs, endTimeMs),
+    };
+}
+function calculateRange(values) {
+    if (values.length === 0) {
+        return { min: 0, max: 0 };
+    }
+    let min = Number.POSITIVE_INFINITY;
+    let max = Number.NEGATIVE_INFINITY;
+    for (const value of values) {
+        const safeValue = clamp01(value);
+        min = Math.min(min, safeValue);
+        max = Math.max(max, safeValue);
+    }
+    return { min, max };
+}
+function fromAudioAnalysis(analysis, requestedNumberOfBars, silenceRmsThreshold) {
+    const barDurationMs = analysis.segmentDurationMs ||
+        Math.max(1, analysis.durationMs / Math.max(1, analysis.dataPoints.length));
+    const bars = analysis.dataPoints.map((point, index) => pointToPreviewBar(point, index, barDurationMs, silenceRmsThreshold));
+    return {
+        bars,
+        durationMs: analysis.durationMs,
+        sampleRate: analysis.sampleRate,
+        numberOfChannels: analysis.numberOfChannels,
+        bitDepth: analysis.bitDepth,
+        samples: analysis.samples,
+        requestedNumberOfBars,
+        barDurationMs,
+        amplitudeRange: calculateRange(bars.map((bar) => bar.amplitude)),
+        rmsRange: calculateRange(bars.map((bar) => bar.rms)),
+        extractionTimeMs: analysis.extractionTimeMs,
+    };
+}
+function emitBarsProgressively(bars, onBarReady) {
+    const total = bars.length;
+    for (let index = 0; index < total; index++) {
+        onBarReady(bars[index], index, total);
+    }
+}
+/**
+ * Extracts compact waveform preview bars for UI rendering.
+ *
+ * Native platforms may provide a compact `extractPreviewBars` bridge. Until that
+ * bridge is available, this safely falls back to the existing `extractPreview`
+ * compatibility path and adapts `DataPoint` objects into compact bars.
+ *
+ * @throws {AudioExtractionError} when the underlying extraction fails.
+ */
+export async function extractPreviewBars({ fileUri, numberOfBars = DEFAULT_PREVIEW_BARS, startTimeMs = 0, endTimeMs = DEFAULT_PREVIEW_END_TIME_MS, decodingOptions, logger, onBarReady, }) {
+    const requestedNumberOfBars = Math.max(1, Math.floor(numberOfBars));
+    const nativeOptions = {
+        fileUri,
+        numberOfBars: requestedNumberOfBars,
+        startTimeMs,
+        endTimeMs,
+        decodingOptions,
+    };
+    const nativeModule = AudioStudioModule;
+    if (hasNativePreviewBars(nativeModule)) {
+        let result;
+        try {
+            result = await nativeModule.extractPreviewBars(cleanNativeOptions(nativeOptions));
+        }
+        catch (err) {
+            throw mapExtractionError(err, fileUri);
+        }
+        if (onBarReady) {
+            emitBarsProgressively(result.bars, onBarReady);
+        }
+        return result;
+    }
+    let analysis;
+    try {
+        analysis = await extractPreview({
+            fileUri,
+            numberOfPoints: requestedNumberOfBars,
+            startTimeMs,
+            endTimeMs,
+            decodingOptions,
+            logger,
+        });
+    }
+    catch (err) {
+        throw mapExtractionError(err, fileUri);
+    }
+    const result = fromAudioAnalysis(analysis, requestedNumberOfBars, decodingOptions?.silenceRmsThreshold ?? DEFAULT_SILENCE_THRESHOLD);
+    if (onBarReady) {
+        emitBarsProgressively(result.bars, onBarReady);
+    }
+    return result;
+}
+//# sourceMappingURL=extractPreviewBars.js.map

package/build/esm/AudioAnalysis/extractPreviewBars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractPreviewBars.js","sourceRoot":"","sources":["../../../src/AudioAnalysis/extractPreviewBars.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    AudioAnalysis,\n    DataPoint,\n    PreviewBar,\n    PreviewBarsOptions,\n    PreviewBarsResult,\n} from './AudioAnalysis.types'\nimport { extractPreview } from './extractPreview'\nimport AudioStudioModule from '../AudioStudioModule'\nimport { mapExtractionError } from '../errors/AudioExtractionError'\nimport { cleanNativeOptions } from '../utils/cleanNativeOptions'\n\nconst DEFAULT_PREVIEW_BARS = 100\nconst DEFAULT_PREVIEW_END_TIME_MS = 30000\nconst DEFAULT_SILENCE_THRESHOLD = 0.01\n\ninterface NativePreviewBarsModule {\n    extractPreviewBars: (\n        options: Record<string, unknown>\n    ) => Promise<PreviewBarsResult>\n}\n\nfunction hasNativePreviewBars(\n    module: unknown\n): module is NativePreviewBarsModule {\n    return (\n        module !== null &&\n        (typeof module === 'object' || typeof module === 'function') &&\n        typeof (module as NativePreviewBarsModule).extractPreviewBars ===\n            'function'\n    )\n}\n\nfunction clamp01(value: number): number {\n    if (!Number.isFinite(value)) return 0\n    return Math.max(0, Math.min(1, value))\n}\n\nfunction getPointTimeMs(value: number | undefined, fallbackMs: number): number {\n    return typeof value === 'number' && Number.isFinite(value)\n        ? Math.round(value)\n        : fallbackMs\n}\n\nfunction pointToPreviewBar(\n    point: DataPoint,\n    index: number,\n    fallbackBarDurationMs: number,\n    silenceRmsThreshold: number\n): PreviewBar {\n    const fallbackStartTimeMs = Math.round(index * fallbackBarDurationMs)\n    const fallbackEndTimeMs = Math.round((index + 1) * fallbackBarDurationMs)\n    const startTimeMs = getPointTimeMs(point.startTime, fallbackStartTimeMs)\n    const endTimeMs = getPointTimeMs(point.endTime, fallbackEndTimeMs)\n    const rms = clamp01(point.rms)\n\n    return {\n        id: point.id ?? index,\n        amplitude: clamp01(point.amplitude),\n        rms,\n        silent: point.silent ?? rms < silenceRmsThreshold,\n        startTimeMs,\n        endTimeMs: Math.max(startTimeMs, endTimeMs),\n    }\n}\n\nfunction calculateRange(values: number[]): { min: number; max: number } {\n    if (values.length === 0) {\n        return { min: 0, max: 0 }\n    }\n\n    let min = Number.POSITIVE_INFINITY\n    let max = Number.NEGATIVE_INFINITY\n\n    for (const value of values) {\n        const safeValue = clamp01(value)\n        min = Math.min(min, safeValue)\n        max = Math.max(max, safeValue)\n    }\n\n    return { min, max }\n}\n\nfunction fromAudioAnalysis(\n    analysis: AudioAnalysis,\n    requestedNumberOfBars: number,\n    silenceRmsThreshold: number\n): PreviewBarsResult {\n    const barDurationMs =\n        analysis.segmentDurationMs ||\n        Math.max(\n            1,\n            analysis.durationMs / Math.max(1, analysis.dataPoints.length)\n        )\n    const bars = analysis.dataPoints.map((point, index) =>\n        pointToPreviewBar(point, index, barDurationMs, silenceRmsThreshold)\n    )\n\n    return {\n        bars,\n        durationMs: analysis.durationMs,\n        sampleRate: analysis.sampleRate,\n        numberOfChannels: analysis.numberOfChannels,\n        bitDepth: analysis.bitDepth,\n        samples: analysis.samples,\n        requestedNumberOfBars,\n        barDurationMs,\n        amplitudeRange: calculateRange(bars.map((bar) => bar.amplitude)),\n        rmsRange: calculateRange(bars.map((bar) => bar.rms)),\n        extractionTimeMs: analysis.extractionTimeMs,\n    }\n}\n\nfunction emitBarsProgressively(\n    bars: PreviewBar[],\n    onBarReady: NonNullable<PreviewBarsOptions['onBarReady']>\n): void {\n    const total = bars.length\n    for (let index = 0; index < total; index++) {\n        onBarReady(bars[index], index, total)\n    }\n}\n\n/**\n * Extracts compact waveform preview bars for UI rendering.\n *\n * Native platforms may provide a compact `extractPreviewBars` bridge. Until that\n * bridge is available, this safely falls back to the existing `extractPreview`\n * compatibility path and adapts `DataPoint` objects into compact bars.\n *\n * @throws {AudioExtractionError} when the underlying extraction fails.\n */\nexport async function extractPreviewBars({\n    fileUri,\n    numberOfBars = DEFAULT_PREVIEW_BARS,\n    startTimeMs = 0,\n    endTimeMs = DEFAULT_PREVIEW_END_TIME_MS,\n    decodingOptions,\n    logger,\n    onBarReady,\n}: PreviewBarsOptions): Promise<PreviewBarsResult> {\n    const requestedNumberOfBars = Math.max(1, Math.floor(numberOfBars))\n    const nativeOptions = {\n        fileUri,\n        numberOfBars: requestedNumberOfBars,\n        startTimeMs,\n        endTimeMs,\n        decodingOptions,\n    }\n\n    const nativeModule = AudioStudioModule as unknown\n    if (hasNativePreviewBars(nativeModule)) {\n        let result: PreviewBarsResult\n        try {\n            result = await nativeModule.extractPreviewBars(\n                cleanNativeOptions(nativeOptions)\n            )\n        } catch (err) {\n            throw mapExtractionError(err, fileUri)\n        }\n\n        if (onBarReady) {\n            emitBarsProgressively(result.bars, onBarReady)\n        }\n        return result\n    }\n\n    let analysis: AudioAnalysis\n    try {\n        analysis = await extractPreview({\n            fileUri,\n            numberOfPoints: requestedNumberOfBars,\n            startTimeMs,\n            endTimeMs,\n            decodingOptions,\n            logger,\n        })\n    } catch (err) {\n        throw mapExtractionError(err, fileUri)\n    }\n\n    const result = fromAudioAnalysis(\n        analysis,\n        requestedNumberOfBars,\n        decodingOptions?.silenceRmsThreshold ?? DEFAULT_SILENCE_THRESHOLD\n    )\n\n    if (onBarReady) {\n        emitBarsProgressively(result.bars, onBarReady)\n    }\n\n    return result\n}\n"]}

package/build/esm/errors/AudioExtractionError.js

@@ -0,0 +1,122 @@
+export class AudioExtractionError extends Error {
+    code;
+    nativeMessage;
+    fileUri;
+    constructor(payload) {
+        super(payload.message);
+        this.name = 'AudioExtractionError';
+        this.code = payload.code;
+        this.nativeMessage = payload.nativeMessage;
+        this.fileUri = payload.fileUri;
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            nativeMessage: this.nativeMessage,
+            fileUri: this.fileUri,
+        };
+    }
+}
+function getNativeMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === 'string')
+        return err;
+    try {
+        return JSON.stringify(err) ?? String(err);
+    }
+    catch {
+        return String(err);
+    }
+}
+function getNativeCode(err) {
+    if (err && typeof err === 'object' && 'code' in err) {
+        const code = err.code;
+        if (typeof code === 'string')
+            return code;
+    }
+    return undefined;
+}
+function mapNativeCode(code) {
+    if (!code)
+        return null;
+    const normalized = code.toUpperCase();
+    if (normalized.includes('FILE_NOT_FOUND') ||
+        normalized === 'ENOENT' ||
+        normalized.includes('NO_SUCH_FILE')) {
+        return 'file_not_found';
+    }
+    if (normalized.includes('PERMISSION') ||
+        normalized === 'EACCES' ||
+        normalized.includes('NOT_AUTHORIZED')) {
+        return 'permission_denied';
+    }
+    if (normalized.includes('UNSUPPORTED') ||
+        normalized.includes('NO_SUITABLE_CODEC')) {
+        return 'unsupported_codec';
+    }
+    if (normalized.includes('INVALID_RANGE') ||
+        normalized.includes('INVALID_HEADER') ||
+        normalized.includes('MALFORMED') ||
+        normalized.includes('CORRUPT')) {
+        return 'malformed_file';
+    }
+    if (normalized.includes('PROCESSING_ERROR') ||
+        normalized.includes('AUDIO_READ_ERROR') ||
+        normalized.includes('DECODE')) {
+        return 'decode_failed';
+    }
+    return null;
+}
+/**
+ * Map a thrown native/JS value into an AudioExtractionError with a stable code.
+ * Heuristics inspect message text and known native error codes.
+ */
+export function mapExtractionError(err, fileUri) {
+    if (err instanceof AudioExtractionError)
+        return err;
+    const nativeMessage = getNativeMessage(err);
+    const lower = nativeMessage.toLowerCase();
+    let code = mapNativeCode(getNativeCode(err)) ?? 'unknown';
+    if (code === 'unknown' &&
+        (lower.includes('unsupported') ||
+            lower.includes('not supported') ||
+            lower.includes('no suitable codec') ||
+            lower.includes('no track'))) {
+        code = 'unsupported_codec';
+    }
+    else if (code === 'unknown' &&
+        (lower.includes('not found') ||
+            lower.includes('no such file') ||
+            lower.includes('does not exist'))) {
+        code = 'file_not_found';
+    }
+    else if (code === 'unknown' &&
+        (lower.includes('permission') ||
+            lower.includes('denied') ||
+            lower.includes('not authorized'))) {
+        code = 'permission_denied';
+    }
+    else if (code === 'unknown' &&
+        (lower.includes('malformed') ||
+            lower.includes('corrupt') ||
+            lower.includes('invalid header') ||
+            lower.includes('invalid wav'))) {
+        code = 'malformed_file';
+    }
+    else if (code === 'unknown' &&
+        (lower.includes('decode') ||
+            lower.includes('codec') ||
+            lower.includes('mediaextractor') ||
+            lower.includes('avaudio'))) {
+        code = 'decode_failed';
+    }
+    return new AudioExtractionError({
+        code,
+        message: `Audio extraction failed (${code}): ${nativeMessage}`,
+        nativeMessage,
+        fileUri,
+    });
+}
+//# sourceMappingURL=AudioExtractionError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AudioExtractionError.js","sourceRoot":"","sources":["../../../src/errors/AudioExtractionError.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Typed error class for audio extraction failures.\n * Wraps native module errors with stable codes consumers can switch on.\n */\nexport type AudioExtractionErrorCode =\n    | 'unsupported_codec'\n    | 'malformed_file'\n    | 'decode_failed'\n    | 'permission_denied'\n    | 'file_not_found'\n    | 'unknown'\n\nexport interface AudioExtractionErrorPayload {\n    code: AudioExtractionErrorCode\n    message: string\n    nativeMessage?: string\n    fileUri?: string\n}\n\nexport class AudioExtractionError extends Error {\n    readonly code: AudioExtractionErrorCode\n    readonly nativeMessage?: string\n    readonly fileUri?: string\n\n    constructor(payload: AudioExtractionErrorPayload) {\n        super(payload.message)\n        this.name = 'AudioExtractionError'\n        this.code = payload.code\n        this.nativeMessage = payload.nativeMessage\n        this.fileUri = payload.fileUri\n    }\n\n    toJSON(): AudioExtractionErrorPayload {\n        return {\n            code: this.code,\n            message: this.message,\n            nativeMessage: this.nativeMessage,\n            fileUri: this.fileUri,\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\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 mapNativeCode(\n    code: string | undefined\n): AudioExtractionErrorCode | null {\n    if (!code) return null\n\n    const normalized = code.toUpperCase()\n    if (\n        normalized.includes('FILE_NOT_FOUND') ||\n        normalized === 'ENOENT' ||\n        normalized.includes('NO_SUCH_FILE')\n    ) {\n        return 'file_not_found'\n    }\n    if (\n        normalized.includes('PERMISSION') ||\n        normalized === 'EACCES' ||\n        normalized.includes('NOT_AUTHORIZED')\n    ) {\n        return 'permission_denied'\n    }\n    if (\n        normalized.includes('UNSUPPORTED') ||\n        normalized.includes('NO_SUITABLE_CODEC')\n    ) {\n        return 'unsupported_codec'\n    }\n    if (\n        normalized.includes('INVALID_RANGE') ||\n        normalized.includes('INVALID_HEADER') ||\n        normalized.includes('MALFORMED') ||\n        normalized.includes('CORRUPT')\n    ) {\n        return 'malformed_file'\n    }\n    if (\n        normalized.includes('PROCESSING_ERROR') ||\n        normalized.includes('AUDIO_READ_ERROR') ||\n        normalized.includes('DECODE')\n    ) {\n        return 'decode_failed'\n    }\n\n    return null\n}\n\n/**\n * Map a thrown native/JS value into an AudioExtractionError with a stable code.\n * Heuristics inspect message text and known native error codes.\n */\nexport function mapExtractionError(\n    err: unknown,\n    fileUri?: string\n): AudioExtractionError {\n    if (err instanceof AudioExtractionError) return err\n\n    const nativeMessage = getNativeMessage(err)\n    const lower = nativeMessage.toLowerCase()\n\n    let code = mapNativeCode(getNativeCode(err)) ?? 'unknown'\n    if (\n        code === 'unknown' &&\n        (lower.includes('unsupported') ||\n            lower.includes('not supported') ||\n            lower.includes('no suitable codec') ||\n            lower.includes('no track'))\n    ) {\n        code = 'unsupported_codec'\n    } else if (\n        code === 'unknown' &&\n        (lower.includes('not found') ||\n            lower.includes('no such file') ||\n            lower.includes('does not exist'))\n    ) {\n        code = 'file_not_found'\n    } else if (\n        code === 'unknown' &&\n        (lower.includes('permission') ||\n            lower.includes('denied') ||\n            lower.includes('not authorized'))\n    ) {\n        code = 'permission_denied'\n    } else if (\n        code === 'unknown' &&\n        (lower.includes('malformed') ||\n            lower.includes('corrupt') ||\n            lower.includes('invalid header') ||\n            lower.includes('invalid wav'))\n    ) {\n        code = 'malformed_file'\n    } else if (\n        code === 'unknown' &&\n        (lower.includes('decode') ||\n            lower.includes('codec') ||\n            lower.includes('mediaextractor') ||\n            lower.includes('avaudio'))\n    ) {\n        code = 'decode_failed'\n    }\n\n    return new AudioExtractionError({\n        code,\n        message: `Audio extraction failed (${code}): ${nativeMessage}`,\n        nativeMessage,\n        fileUri,\n    })\n}\n"]}

package/build/esm/errors/AudioStreamError.js

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

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

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