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

package/build/types/AudioAnalysis/AudioAnalysis.types.d.ts

@@ -11,6 +11,12 @@ export interface DecodingConfig {
     targetBitDepth?: BitDepth;
     /** Whether to normalize audio levels (Android and Web) */
     normalizeAudio?: boolean;
+    /**
+     * RMS threshold below which a segment is flagged silent.
+     * Range 0..1. Default 0.01.
+     * Currently applied as a JS post-process so the same behavior holds across iOS/Android/Web.
+     */
+    silenceRmsThreshold?: number;
 }
 /**
  * Represents speech-related features extracted from audio.
@@ -136,6 +142,66 @@ export interface AudioRangeOptions {
  * Options for generating a quick preview of audio waveform.
  * This is optimized for UI rendering with a specified number of points.
  */
+export interface PreviewBar {
+    /** Stable zero-based bar identifier. */
+    id: number;
+    /** Peak amplitude for this bar, normalized to 0..1. */
+    amplitude: number;
+    /** Root mean square amplitude for this bar, normalized to 0..1. */
+    rms: number;
+    /** Whether this bar is below the configured silence RMS threshold. */
+    silent: boolean;
+    /** Bar start time in milliseconds from the extracted range start. */
+    startTimeMs: number;
+    /** Bar end time in milliseconds from the extracted range start. */
+    endTimeMs: number;
+}
+/**
+ * Compact preview-bars result for UI waveform rendering.
+ * Unlike `AudioAnalysis`, this intentionally omits full `DataPoint` feature data.
+ */
+export interface PreviewBarsResult {
+    bars: PreviewBar[];
+    durationMs: number;
+    sampleRate: number;
+    numberOfChannels: number;
+    bitDepth: number;
+    samples: number;
+    /** Requested bar count before native/platform clamping. */
+    requestedNumberOfBars: number;
+    /** Approximate duration represented by each bar. */
+    barDurationMs: number;
+    amplitudeRange: {
+        min: number;
+        max: number;
+    };
+    rmsRange: {
+        min: number;
+        max: number;
+    };
+    extractionTimeMs: number;
+}
+/**
+ * Options for extracting compact waveform preview bars for UI rendering.
+ */
+export interface PreviewBarsOptions extends AudioRangeOptions {
+    /** URI of the audio file to analyze */
+    fileUri: string;
+    /**
+     * Total number of bars to generate for the preview.
+     * @default 100
+     */
+    numberOfBars?: number;
+    /** Optional logger for debugging. */
+    logger?: ConsoleLike;
+    /** Optional configuration for decoding the audio file. */
+    decodingOptions?: DecodingConfig;
+    /**
+     * Optional callback fired once per compact bar after extraction resolves.
+     * Native progressive streaming is not implied by this callback.
+     */
+    onBarReady?: (bar: PreviewBar, index: number, total: number) => void;
+}
 export interface PreviewOptions extends AudioRangeOptions {
     /** URI of the audio file to analyze */
     fileUri: string;
@@ -157,6 +223,19 @@ export interface PreviewOptions extends AudioRangeOptions {
      * - normalizeAudio: false
      */
     decodingOptions?: DecodingConfig;
+    /**
+     * Optional callback fired once per data point as the preview becomes available.
+     * Today the native module returns the full analysis in one shot; the points are then
+     * micro-batched on the JS side so consumers can render bars incrementally.
+     * Native progressive streaming is a future enhancement.
+     */
+    onPointReady?: (point: DataPoint, index: number, total: number) => void;
+    /**
+     * Optional cancellation signal for JS-side progressive point emission.
+     * Aborting does not cancel native extraction after it has started, but it
+     * stops any queued `onPointReady` callbacks from an older request.
+     */
+    signal?: AbortSignal;
 }
 /**
  * Options for mel-spectrogram extraction

package/build/types/AudioAnalysis/AudioAnalysis.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AudioAnalysis.types.d.ts","sourceRoot":"","sources":["../../../src/AudioAnalysis/AudioAnalysis.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AudioAnalysis.types.d.ts","sourceRoot":"","sources":["../../../src/AudioAnalysis/AudioAnalysis.types.ts"],"names":[],"mappings":"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"}

package/build/types/AudioAnalysis/extractPreview.d.ts

@@ -5,7 +5,7 @@ import { PreviewOptions, AudioAnalysis } from './AudioAnalysis.types';
  *
  * @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 declare function extractPreview({ fileUri, numberOfPoints, startTimeMs, endTimeMs, // First 30 seconds
-decodingOptions, logger, }: PreviewOptions): Promise<AudioAnalysis>;
+export declare function extractPreview({ fileUri, numberOfPoints, startTimeMs, endTimeMs, decodingOptions, logger, onPointReady, signal, }: PreviewOptions): Promise<AudioAnalysis>;
 //# sourceMappingURL=extractPreview.d.ts.map

package/build/types/AudioAnalysis/extractPreview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractPreview.d.ts","sourceRoot":"","sources":["../../../src/AudioAnalysis/extractPreview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAGrE;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,EACjC,OAAO,EACP,cAAoB,EACpB,WAAe,EACf,SAAiB,EAAE,mBAAmB;AACtC,eAAe,EACf,MAAM,GACT,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAgBzC"}
+{"version":3,"file":"extractPreview.d.ts","sourceRoot":"","sources":["../../../src/AudioAnalysis/extractPreview.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAa,MAAM,uBAAuB,CAAA;AA8EhF;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,EACjC,OAAO,EACP,cAAoB,EACpB,WAAe,EACf,SAAiB,EACjB,eAAe,EACf,MAAM,EACN,YAAY,EACZ,MAAM,GACT,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAsCzC"}

package/build/types/AudioAnalysis/extractPreviewBars.d.ts

@@ -0,0 +1,12 @@
+import { PreviewBarsOptions, PreviewBarsResult } from './AudioAnalysis.types';
+/**
+ * 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 declare function extractPreviewBars({ fileUri, numberOfBars, startTimeMs, endTimeMs, decodingOptions, logger, onBarReady, }: PreviewBarsOptions): Promise<PreviewBarsResult>;
+//# sourceMappingURL=extractPreviewBars.d.ts.map

package/build/types/AudioAnalysis/extractPreviewBars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractPreviewBars.d.ts","sourceRoot":"","sources":["../../../src/AudioAnalysis/extractPreviewBars.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,kBAAkB,EAClB,iBAAiB,EACpB,MAAM,uBAAuB,CAAA;AAqH9B;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,EACrC,OAAO,EACP,YAAmC,EACnC,WAAe,EACf,SAAuC,EACvC,eAAe,EACf,MAAM,EACN,UAAU,GACb,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoDjD"}

package/build/types/errors/AudioExtractionError.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Typed error class for audio extraction failures.
+ * Wraps native module errors with stable codes consumers can switch on.
+ */
+export type AudioExtractionErrorCode = 'unsupported_codec' | 'malformed_file' | 'decode_failed' | 'permission_denied' | 'file_not_found' | 'unknown';
+export interface AudioExtractionErrorPayload {
+    code: AudioExtractionErrorCode;
+    message: string;
+    nativeMessage?: string;
+    fileUri?: string;
+}
+export declare class AudioExtractionError extends Error {
+    readonly code: AudioExtractionErrorCode;
+    readonly nativeMessage?: string;
+    readonly fileUri?: string;
+    constructor(payload: AudioExtractionErrorPayload);
+    toJSON(): AudioExtractionErrorPayload;
+}
+/**
+ * Map a thrown native/JS value into an AudioExtractionError with a stable code.
+ * Heuristics inspect message text and known native error codes.
+ */
+export declare function mapExtractionError(err: unknown, fileUri?: string): AudioExtractionError;
+//# sourceMappingURL=AudioExtractionError.d.ts.map

package/build/types/errors/AudioExtractionError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioExtractionError.d.ts","sourceRoot":"","sources":["../../../src/errors/AudioExtractionError.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAC9B,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,GACf,mBAAmB,GACnB,gBAAgB,GAChB,SAAS,CAAA;AAEf,MAAM,WAAW,2BAA2B;IACxC,IAAI,EAAE,wBAAwB,CAAA;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAA;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;gBAEb,OAAO,EAAE,2BAA2B;IAQhD,MAAM,IAAI,2BAA2B;CAQxC;AAkED;;;GAGG;AACH,wBAAgB,kBAAkB,CAC9B,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,MAAM,GACjB,oBAAoB,CAqDtB"}

package/build/types/errors/AudioStreamError.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Stable typed errors for `streamAudioData`. Callers can switch on `code`.
+ */
+export type AudioStreamErrorCode = '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';
+export interface AudioStreamErrorPayload {
+    code: AudioStreamErrorCode;
+    message: string;
+    recoverable: boolean;
+    fileUri?: string;
+    platform?: string;
+    nativeCode?: string;
+    nativeMessage?: string;
+}
+export declare class AudioStreamError extends Error {
+    readonly code: AudioStreamErrorCode;
+    readonly recoverable: boolean;
+    readonly fileUri?: string;
+    readonly platform?: string;
+    readonly nativeCode?: string;
+    readonly nativeMessage?: string;
+    constructor(payload: AudioStreamErrorPayload);
+    toJSON(): AudioStreamErrorPayload;
+}
+export declare function mapStreamError(err: unknown, fileUri?: string, platform?: string): AudioStreamError;
+//# sourceMappingURL=AudioStreamError.d.ts.map

package/build/types/errors/AudioStreamError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioStreamError.d.ts","sourceRoot":"","sources":["../../../src/errors/AudioStreamError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC1B,qCAAqC,GACrC,gCAAgC,GAChC,gCAAgC,GAChC,4BAA4B,GAC5B,oCAAoC,GACpC,iCAAiC,GACjC,uCAAuC,GACvC,qCAAqC,GACrC,uBAAuB,GACvB,0BAA0B,CAAA;AAEhC,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,oBAAoB,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;CACzB;AASD,qBAAa,gBAAiB,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;IACnC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;gBAEnB,OAAO,EAAE,uBAAuB;IAW5C,MAAM,IAAI,uBAAuB;CAWpC;AAgFD,wBAAgB,cAAc,CAC1B,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAClB,gBAAgB,CAsClB"}

package/build/types/errors/AudioStreamError.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AudioStreamError.test.d.ts.map

package/build/types/errors/AudioStreamError.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioStreamError.test.d.ts","sourceRoot":"","sources":["../../../src/errors/AudioStreamError.test.ts"],"names":[],"mappings":""}

package/build/types/index.d.ts

@@ -5,6 +5,7 @@ import { extractPreview } from './AudioAnalysis/extractPreview';
 import { initMelStreamingWasm, computeMelFrameWasm } from './AudioAnalysis/melSpectrogramWasm';
 import { AudioRecorderProvider, useSharedAudioRecorder } from './AudioRecorder.provider';
 import AudioStudioModule from './AudioStudioModule';
+import { getAudioDecodeCapabilities, streamAudioData } from './streamAudioData';
 import { trimAudio } from './trimAudio';
 import { useAudioRecorder } from './useAudioRecorder';
 export * from './utils/convertPCMToFloat32';
@@ -14,7 +15,13 @@ export { getPlatformCapabilities, isEncodingSupported, isBitDepthSupported, getF
 export { AudioDeviceManager, audioDeviceManager } from './AudioDeviceManager';
 export { useAudioDevices } from './hooks/useAudioDevices';
 export { setMelSpectrogramWasmUrl } from './AudioAnalysis/wasmConfig';
-export { AudioRecorderProvider, AudioStudioModule, extractRawWavAnalysis, extractAudioAnalysis, extractPreview, trimAudio, extractAudioData, extractMelSpectrogram, initMelStreamingWasm, computeMelFrameWasm, MAX_DURATION_MS, useAudioRecorder, useSharedAudioRecorder, };
+export { extractPreviewBars } from './AudioAnalysis/extractPreviewBars';
+export { AudioRecorderProvider, AudioStudioModule, extractRawWavAnalysis, extractAudioAnalysis, extractPreview, trimAudio, extractAudioData, streamAudioData, getAudioDecodeCapabilities, extractMelSpectrogram, initMelStreamingWasm, computeMelFrameWasm, MAX_DURATION_MS, useAudioRecorder, useSharedAudioRecorder, };
+export { AudioExtractionError, mapExtractionError, } from './errors/AudioExtractionError';
+export type { AudioExtractionErrorCode, AudioExtractionErrorPayload, } from './errors/AudioExtractionError';
+export { AudioStreamError, mapStreamError, } from './errors/AudioStreamError';
+export type { AudioStreamErrorCode, AudioStreamErrorPayload, } from './errors/AudioStreamError';
+export type { StreamAudioDataOptions, StreamAudioDataChunk, StreamAudioDataProgress, StreamAudioDataResult, StreamAudioDataCallbacks, AudioDecodeCapabilities, } from './streamAudioData';
 export type * from './AudioAnalysis/AudioAnalysis.types';
 export type * from './AudioStudio.types';
 /** @deprecated Use AudioStudioModule instead */

package/build/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,qBAAqB,EACrB,oBAAoB,EACvB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EACH,qBAAqB,EACrB,eAAe,EAClB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,EACH,oBAAoB,EACpB,mBAAmB,EACtB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EACH,qBAAqB,EACrB,sBAAsB,EACzB,MAAM,0BAA0B,CAAA;AACjC,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AAGtC,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,oBAAoB,GAC5B,MAAM,iCAAiC,CAAA;AAGxC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAG7E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AAErE,OAAO,EACH,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,GACzB,CAAA;AAGD,mBAAmB,qCAAqC,CAAA;AACxD,mBAAmB,qBAAqB,CAAA;AAExC,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,KAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,qBAAqB,EACrB,oBAAoB,EACvB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EACH,qBAAqB,EACrB,eAAe,EAClB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,EACH,oBAAoB,EACpB,mBAAmB,EACtB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EACH,qBAAqB,EACrB,sBAAsB,EACzB,MAAM,0BAA0B,CAAA;AACjC,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,EACH,0BAA0B,EAC1B,eAAe,EAClB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AAGtC,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,oBAAoB,GAC5B,MAAM,iCAAiC,CAAA;AAGxC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAG7E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAA;AAEvE,OAAO,EACH,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,GACzB,CAAA;AAED,OAAO,EACH,oBAAoB,EACpB,kBAAkB,GACrB,MAAM,+BAA+B,CAAA;AACtC,YAAY,EACR,wBAAwB,EACxB,2BAA2B,GAC9B,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EACH,gBAAgB,EAChB,cAAc,GACjB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EACR,oBAAoB,EACpB,uBAAuB,GAC1B,MAAM,2BAA2B,CAAA;AAElC,YAAY,EACR,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,GAC1B,MAAM,mBAAmB,CAAA;AAG1B,mBAAmB,qCAAqC,CAAA;AACxD,mBAAmB,qBAAqB,CAAA;AAExC,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,KAAoB,CAAA"}

package/build/types/streamAudioData.d.ts

@@ -0,0 +1,114 @@
+/**
+ * High-level API: stream decoded audio from a stored file as bounded Float32
+ * chunks without materializing the full PCM range in memory.
+ *
+ * See `docs/STREAM_AUDIO_DATA.md` for the full contract and rollout notes.
+ */
+export interface StreamAudioDataOptions {
+    /** URI of the audio file to decode. */
+    fileUri: string;
+    /** Start time in milliseconds (default: 0). */
+    startTimeMs?: number;
+    /** End time in milliseconds (default: end-of-file). */
+    endTimeMs?: number;
+    /**
+     * Source sample rate hint. Ignored if `targetSampleRate` is set; native
+     * decoders read the actual rate from the file.
+     */
+    sampleRate?: number;
+    /** Output sample rate. Native resamples when this differs from the file. */
+    targetSampleRate?: number;
+    /** Output channel count (1 = mono downmix, 2 = stereo passthrough). */
+    channels?: number;
+    /** Clamp samples to [-1, 1] and replace non-finite values with 0. */
+    normalizeAudio?: boolean;
+    /** Target chunk duration in ms (default: 1000, min: 10, max: 60000). */
+    chunkDurationMs?: number;
+    /** Soft cap on chunk size in bytes (Float32 = 4 bytes/sample). */
+    maxChunkBytes?: number;
+    /** Max chunks queued in native before JS ack pauses decode (default: 4). */
+    maxBufferedChunks?: number;
+    /** Output PCM format; only `'float32'` supported today. */
+    streamFormat?: 'float32';
+    /** Abort the in-flight request. Resolves promise with `cancelled: true`. */
+    signal?: AbortSignal;
+}
+export interface StreamAudioDataChunk {
+    /** Native request id; constant across all chunks of one call. */
+    requestId: string;
+    /** Zero-based monotonic chunk index. */
+    chunkIndex: number;
+    /** Start time in output-rate ms (rounded to nearest sample). */
+    startTimeMs: number;
+    /** End time in output-rate ms. */
+    endTimeMs: number;
+    /** Duration in ms (`endTimeMs - startTimeMs`). */
+    durationMs: number;
+    /** First sample index in the output timeline. */
+    startSample: number;
+    /** Sample count in `samples` (interleaved if channels > 1). */
+    sampleCount: number;
+    /** Output sample rate. */
+    sampleRate: number;
+    /** Output channel count. */
+    channels: number;
+    /** Interleaved Float32 samples in [-1, 1]. */
+    samples: Float32Array;
+    /** True for the last chunk of a non-cancelled run. */
+    isFinal: boolean;
+}
+export interface StreamAudioDataProgress {
+    requestId: string;
+    processedMs: number;
+    durationMs: number;
+    progress: number;
+    emittedChunks: number;
+    bufferedChunks?: number;
+}
+export interface StreamAudioDataResult {
+    requestId: string;
+    durationMs: number;
+    sampleRate: number;
+    channels: number;
+    chunks: number;
+    samples: number;
+    cancelled: boolean;
+}
+export interface StreamAudioDataCallbacks {
+    /**
+     * Called with each decoded chunk. If this returns a Promise, native decode
+     * pauses until it resolves (backpressure). Throwing aborts the stream with
+     * `ERR_AUDIO_STREAM_DECODE_FAILED`.
+     */
+    onChunk: (chunk: StreamAudioDataChunk) => void | Promise<void>;
+    /** Called whenever native reports progress. */
+    onProgress?: (progress: StreamAudioDataProgress) => void;
+}
+export interface AudioDecodeCapabilities {
+    platform: 'ios' | 'android' | 'web';
+    supportedInputFormats: string[];
+    supportedOutputFormats: Array<'float32'>;
+    supportsCancellation: boolean;
+    supportsBackpressure: boolean;
+    supportsTimeRange: boolean;
+    supportsTargetSampleRate: boolean;
+    supportsChannelMixing: boolean;
+    knownLimitations?: string[];
+}
+/**
+ * Stream decoded audio from a stored file as bounded Float32 PCM chunks.
+ *
+ * Memory bound:
+ *   `chunkDurationMs * sampleRate * channels * 4 * maxBufferedChunks` +
+ *   native decoder buffers.
+ *
+ * Cancellation: pass `options.signal` and call `abort()`. The returned promise
+ * resolves with `cancelled: true` (it does not reject) when cancellation wins.
+ *
+ * Backpressure: if `onChunk` returns a Promise, native decode is paused until
+ * it resolves; if it throws, the stream is aborted with a `decode_failed` error.
+ */
+export declare function streamAudioData(options: StreamAudioDataOptions, callbacks: StreamAudioDataCallbacks): Promise<StreamAudioDataResult>;
+/** Discover what the running platform supports. */
+export declare function getAudioDecodeCapabilities(): Promise<AudioDecodeCapabilities>;
+//# sourceMappingURL=streamAudioData.d.ts.map

package/build/types/streamAudioData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamAudioData.d.ts","sourceRoot":"","sources":["../../src/streamAudioData.ts"],"names":[],"mappings":"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"}

package/ios/AudioProcessingHelpers.swift

@@ -681,15 +681,20 @@ func extractRawAudioData(
         for channel in 0..<channels {
             let sample = floatData[channel][frame]
             
-            let normalizedSample = decodingConfig.normalizeAudio ? 
-                max(-1.0, min(1.0, sample)) : sample
-            
+            // Sanitize: replace NaN/Inf with 0 then clamp. Skip clamp when
+            // normalizeAudio=false so callers see the raw decoded magnitude,
+            // but always finite-check to avoid Swift's `Int16(_:)` /
+            // `Int32(_:)` trap on non-finite values.
+            let safeSample: Float = sample.isFinite ? sample : 0
+            let normalizedSample = decodingConfig.normalizeAudio ?
+                max(-1.0, min(1.0, safeSample)) : safeSample
+
             switch targetBitDepth {
             case 16:
-                let intValue = Int16(normalizedSample * Float(Int16.max))
+                let intValue = safeFloatToInt16(normalizedSample)
                 pcmData.append(contentsOf: withUnsafeBytes(of: intValue) { Array($0) })
             case 32:
-                let intValue = Int32(normalizedSample * Float(Int32.max))
+                let intValue = safeFloatToInt32(normalizedSample)
                 pcmData.append(contentsOf: withUnsafeBytes(of: intValue) { Array($0) })
             default:
                 throw NSError(domain: "AudioProcessing", code: -1, userInfo: [NSLocalizedDescriptionKey: "Unsupported bit depth \(targetBitDepth)"])

package/ios/AudioProcessor.swift

@@ -1022,6 +1022,105 @@ public class AudioProcessor {
     ///   - endTimeMs: Optional end time in milliseconds
     ///   - featureOptions: The features to extract
     /// - Returns: An `AudioAnalysisData` object containing the extracted features
+    public func extractPreviewBars(
+        numberOfBars: Int,
+        startTimeMs: Double? = nil,
+        endTimeMs: Double? = nil,
+        silenceRmsThreshold: Float = 0.01
+    ) -> [String: Any]? {
+        guard let audioFile = audioFile else {
+            reject("FILE_NOT_INITIALIZED", "Audio file is not initialized.")
+            return nil
+        }
+
+        let requestedBars = max(1, numberOfBars)
+        let sampleRate = audioFile.fileFormat.sampleRate
+        let totalDurationMs = Double(audioFile.length) / sampleRate * 1000
+        let effectiveStartMs = max(0, startTimeMs ?? 0)
+        let effectiveEndMs = min(endTimeMs ?? totalDurationMs, totalDurationMs)
+        let durationMs = max(1, effectiveEndMs - effectiveStartMs)
+        let startFrame = AVAudioFramePosition(effectiveStartMs * sampleRate / 1000.0)
+        let endFrame = AVAudioFramePosition(effectiveEndMs * sampleRate / 1000.0)
+        let samplesInRange = Int(endFrame - startFrame)
+
+        guard samplesInRange > 0 else {
+            reject("INVALID_RANGE", "Invalid sample range: contains no samples")
+            return nil
+        }
+
+        let framesPerBar = max(1, samplesInRange / requestedBars)
+        let startTime = CACurrentMediaTime()
+        var bars: [[String: Any]] = []
+        bars.reserveCapacity(requestedBars)
+        var minAmplitude: Float = .greatestFiniteMagnitude
+        var maxAmplitude: Float = -.greatestFiniteMagnitude
+        var minRms: Float = .greatestFiniteMagnitude
+        var maxRms: Float = -.greatestFiniteMagnitude
+
+        for index in 0..<requestedBars {
+            let barStartFrame = startFrame + AVAudioFramePosition(index * framesPerBar)
+            let barEndFrame = min(startFrame + AVAudioFramePosition((index + 1) * framesPerBar), endFrame)
+            let framesToRead = AVAudioFrameCount(barEndFrame - barStartFrame)
+            if framesToRead == 0 { break }
+
+            do {
+                audioFile.framePosition = barStartFrame
+                guard let buffer = AVAudioPCMBuffer(pcmFormat: audioFile.processingFormat, frameCapacity: framesToRead) else { continue }
+                try audioFile.read(into: buffer, frameCount: framesToRead)
+                guard let floatData = buffer.floatChannelData else { continue }
+
+                var sumSquares: Float = 0
+                var amplitude: Float = 0
+                for frame in 0..<Int(buffer.frameLength) {
+                    let value = floatData[0][frame]
+                    sumSquares += value * value
+                    amplitude = max(amplitude, abs(value))
+                }
+                let frameLength = max(1, Int(buffer.frameLength))
+                let rms = sqrt(sumSquares / Float(frameLength))
+                minAmplitude = min(minAmplitude, amplitude)
+                maxAmplitude = max(maxAmplitude, amplitude)
+                minRms = min(minRms, rms)
+                maxRms = max(maxRms, rms)
+
+                let startBarTimeMs = Double(barStartFrame - startFrame) / Double(samplesInRange) * durationMs
+                let endBarTimeMs = Double(barEndFrame - startFrame) / Double(samplesInRange) * durationMs
+                bars.append([
+                    "id": index,
+                    "amplitude": min(max(amplitude, 0), 1),
+                    "rms": min(max(rms, 0), 1),
+                    "silent": rms < silenceRmsThreshold,
+                    "startTimeMs": startBarTimeMs,
+                    "endTimeMs": max(startBarTimeMs, endBarTimeMs)
+                ])
+            } catch {
+                reject("AUDIO_READ_ERROR", "Error reading audio data: \(error.localizedDescription)")
+                return nil
+            }
+        }
+
+        guard !bars.isEmpty else {
+            reject("PROCESSING_ERROR", "No preview bars were generated")
+            return nil
+        }
+
+        let bitDepth = audioFile.fileFormat.settings[AVLinearPCMBitDepthKey] as? Int ?? 16
+        let extractionTimeMs = Float((CACurrentMediaTime() - startTime) * 1000)
+        return [
+            "bars": bars,
+            "durationMs": durationMs,
+            "sampleRate": Int(sampleRate),
+            "numberOfChannels": Int(audioFile.processingFormat.channelCount),
+            "bitDepth": bitDepth,
+            "samples": samplesInRange,
+            "requestedNumberOfBars": requestedBars,
+            "barDurationMs": durationMs / Double(bars.count),
+            "amplitudeRange": ["min": minAmplitude, "max": maxAmplitude],
+            "rmsRange": ["min": minRms, "max": maxRms],
+            "extractionTimeMs": extractionTimeMs
+        ]
+    }
+
     public func extractPreview(
         numberOfPoints: Int,
         startTimeMs: Double? = nil,