@siteed/audio-studio 3.2.1-beta.0 → 3.2.1-beta.2

package/build/cjs/events.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.addAudioEventListener = addAudioEventListener;
 exports.addAudioAnalysisListener = addAudioAnalysisListener;
 exports.addRecordingInterruptionListener = addRecordingInterruptionListener;
+exports.addMaxDurationReachedListener = addMaxDurationReachedListener;
 const expo_modules_core_1 = require("expo-modules-core");
 const AudioStudioModule_1 = __importDefault(require("./AudioStudioModule"));
 const emitter = new expo_modules_core_1.LegacyEventEmitter(AudioStudioModule_1.default);
@@ -26,4 +27,7 @@ function addRecordingInterruptionListener(listener) {
     });
     return subscription;
 }
+function addMaxDurationReachedListener(listener) {
+    return emitter.addListener('MaxDurationReached', listener);
+}
 //# sourceMappingURL=events.js.map

package/build/cjs/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;;;AAgCtC,sDAIC;AAKD,4DAIC;AAED,4EAeC;AA5DD,yDAA8E;AAI9E,4EAAmD;AAEnD,MAAM,OAAO,GAAG,IAAI,sCAAkB,CAAC,2BAAiB,CAAC,CAAA;AAwBzD,SAAgB,qBAAqB,CACjC,QAAqD;IAErD,OAAO,OAAO,CAAC,WAAW,CAAoB,WAAW,EAAE,QAAQ,CAAC,CAAA;AACxE,CAAC;AAKD,SAAgB,wBAAwB,CACpC,QAAsD;IAEtD,OAAO,OAAO,CAAC,WAAW,CAAqB,eAAe,EAAE,QAAQ,CAAC,CAAA;AAC7E,CAAC;AAED,SAAgB,gCAAgC,CAC5C,QAAqD;IAErD,oBAAoB;IACpB,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAEvD,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,CACpC,wBAAwB,EAAE,+CAA+C;IACzE,CAAC,KAAK,EAAE,EAAE;QACN,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAA;QAC9D,QAAQ,CAAC,KAAK,CAAC,CAAA;IACnB,CAAC,CACJ,CAAA;IAED,OAAO,YAAY,CAAA;AACvB,CAAC","sourcesContent":["// packages/audio-studio/src/events.ts\n\nimport { LegacyEventEmitter, type EventSubscription } from 'expo-modules-core'\n\nimport { AudioAnalysis } from './AudioAnalysis/AudioAnalysis.types'\nimport { RecordingInterruptionEvent } from './AudioStudio.types'\nimport AudioStudioModule from './AudioStudioModule'\n\nconst emitter = new LegacyEventEmitter(AudioStudioModule)\n\n// Internal event payload from native module\nexport interface AudioEventPayload {\n    encoded?: string\n    /** Float32 samples in [-1, 1] — sent by native when streamFormat='float32'.\n     *  Android new arch delivers Float32Array; iOS delivers number[]. */\n    pcmFloat32?: Float32Array | number[]\n    buffer?: Float32Array\n    fileUri: string\n    lastEmittedSize: number\n    position: number\n    deltaSize: number\n    totalSize: number\n    mimeType: string\n    streamUuid: string\n    compression?: {\n        data?: string | Blob // Base64 (native) or Float32Array (web) encoded compressed data chunk\n        position: number\n        eventDataSize: number\n        totalSize: number\n    }\n}\n\nexport function addAudioEventListener(\n    listener: (event: AudioEventPayload) => Promise<void>\n): EventSubscription {\n    return emitter.addListener<AudioEventPayload>('AudioData', listener)\n}\n\n// Only aliasing the AudioAnalysis type for the event payload\nexport interface AudioAnalysisEvent extends AudioAnalysis {}\n\nexport function addAudioAnalysisListener(\n    listener: (event: AudioAnalysisEvent) => Promise<void>\n): EventSubscription {\n    return emitter.addListener<AudioAnalysisEvent>('AudioAnalysis', listener)\n}\n\nexport function addRecordingInterruptionListener(\n    listener: (event: RecordingInterruptionEvent) => void\n): EventSubscription {\n    // Add debug logging\n    console.debug('Adding recording interruption listener')\n\n    const subscription = emitter.addListener<RecordingInterruptionEvent>(\n        'onRecordingInterrupted', // Make sure this matches the native event name\n        (event) => {\n            console.debug('Recording interruption event received:', event)\n            listener(event)\n        }\n    )\n\n    return subscription\n}\n"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":";AAAA,sCAAsC;;;;;AAmCtC,sDAIC;AAKD,4DAIC;AAED,4EAeC;AAED,sEAOC;AAxED,yDAA8E;AAO9E,4EAAmD;AAEnD,MAAM,OAAO,GAAG,IAAI,sCAAkB,CAAC,2BAAiB,CAAC,CAAA;AAwBzD,SAAgB,qBAAqB,CACjC,QAAqD;IAErD,OAAO,OAAO,CAAC,WAAW,CAAoB,WAAW,EAAE,QAAQ,CAAC,CAAA;AACxE,CAAC;AAKD,SAAgB,wBAAwB,CACpC,QAAsD;IAEtD,OAAO,OAAO,CAAC,WAAW,CAAqB,eAAe,EAAE,QAAQ,CAAC,CAAA;AAC7E,CAAC;AAED,SAAgB,gCAAgC,CAC5C,QAAqD;IAErD,oBAAoB;IACpB,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAEvD,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,CACpC,wBAAwB,EAAE,+CAA+C;IACzE,CAAC,KAAK,EAAE,EAAE;QACN,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAA;QAC9D,QAAQ,CAAC,KAAK,CAAC,CAAA;IACnB,CAAC,CACJ,CAAA;IAED,OAAO,YAAY,CAAA;AACvB,CAAC;AAED,SAAgB,6BAA6B,CACzC,QAAkD;IAElD,OAAO,OAAO,CAAC,WAAW,CACtB,oBAAoB,EACpB,QAAQ,CACX,CAAA;AACL,CAAC","sourcesContent":["// packages/audio-studio/src/events.ts\n\nimport { LegacyEventEmitter, type EventSubscription } from 'expo-modules-core'\n\nimport { AudioAnalysis } from './AudioAnalysis/AudioAnalysis.types'\nimport type {\n    MaxDurationReachedEvent,\n    RecordingInterruptionEvent,\n} from './AudioStudio.types'\nimport AudioStudioModule from './AudioStudioModule'\n\nconst emitter = new LegacyEventEmitter(AudioStudioModule)\n\n// Internal event payload from native module\nexport interface AudioEventPayload {\n    encoded?: string\n    /** Float32 samples in [-1, 1] — sent by native when streamFormat='float32'.\n     *  Android new arch delivers Float32Array; iOS delivers number[]. */\n    pcmFloat32?: Float32Array | number[]\n    buffer?: Float32Array\n    fileUri: string\n    lastEmittedSize: number\n    position: number\n    deltaSize: number\n    totalSize: number\n    mimeType: string\n    streamUuid: string\n    compression?: {\n        data?: string | Blob // Base64 (native) or Float32Array (web) encoded compressed data chunk\n        position: number\n        eventDataSize: number\n        totalSize: number\n    }\n}\n\nexport function addAudioEventListener(\n    listener: (event: AudioEventPayload) => Promise<void>\n): EventSubscription {\n    return emitter.addListener<AudioEventPayload>('AudioData', listener)\n}\n\n// Only aliasing the AudioAnalysis type for the event payload\nexport interface AudioAnalysisEvent extends AudioAnalysis {}\n\nexport function addAudioAnalysisListener(\n    listener: (event: AudioAnalysisEvent) => Promise<void>\n): EventSubscription {\n    return emitter.addListener<AudioAnalysisEvent>('AudioAnalysis', listener)\n}\n\nexport function addRecordingInterruptionListener(\n    listener: (event: RecordingInterruptionEvent) => void\n): EventSubscription {\n    // Add debug logging\n    console.debug('Adding recording interruption listener')\n\n    const subscription = emitter.addListener<RecordingInterruptionEvent>(\n        'onRecordingInterrupted', // Make sure this matches the native event name\n        (event) => {\n            console.debug('Recording interruption event received:', event)\n            listener(event)\n        }\n    )\n\n    return subscription\n}\n\nexport function addMaxDurationReachedListener(\n    listener: (event: MaxDurationReachedEvent) => void\n): EventSubscription {\n    return emitter.addListener<MaxDurationReachedEvent>(\n        'MaxDurationReached',\n        listener\n    )\n}\n"]}

package/build/cjs/index.js

@@ -18,7 +18,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExpoAudioStreamModule = exports.mapStreamError = exports.AudioStreamError = exports.mapExtractionError = exports.AudioExtractionError = exports.useSharedAudioRecorder = exports.useAudioRecorder = exports.MAX_DURATION_MS = exports.computeMelFrameWasm = exports.initMelStreamingWasm = exports.extractMelSpectrogram = exports.getAudioDecodeCapabilities = exports.streamAudioData = exports.extractAudioData = exports.trimAudio = exports.extractPreview = exports.extractAudioAnalysis = exports.extractRawWavAnalysis = exports.AudioStudioModule = exports.AudioRecorderProvider = exports.extractPreviewBars = exports.setMelSpectrogramWasmUrl = exports.useAudioDevices = exports.audioDeviceManager = exports.AudioDeviceManager = exports.validateRecordingConfig = exports.getFallbackBitDepth = exports.getFallbackEncoding = exports.isBitDepthSupported = exports.isEncodingSupported = exports.getPlatformCapabilities = void 0;
+exports.ExpoAudioStreamModule = exports.mapStreamError = exports.AudioStreamError = exports.mapExtractionError = exports.AudioExtractionError = exports.useSharedAudioRecorder = exports.useAudioRecorder = exports.MAX_DURATION_MS = exports.computeMelFrameWasm = exports.initMelStreamingWasm = exports.extractMelSpectrogram = exports.getAudioDecodeCapabilities = exports.streamAudioData = exports.extractAudioData = exports.trimAudio = exports.extractPreview = exports.extractAudioAnalysis = exports.extractRawWavAnalysis = exports.AudioStudioModule = exports.AudioRecorderProvider = exports.extractPreviewBars = exports.setMelSpectrogramWasmUrl = exports.useAudioDevices = exports.audioDeviceManager = exports.AudioDeviceManager = exports.validateRecordingConfig = exports.getFallbackBitDepth = exports.getFallbackEncoding = exports.isBitDepthSupported = exports.isEncodingSupported = exports.getPlatformCapabilities = exports.addMaxDurationReachedListener = void 0;
 const extractAudioAnalysis_1 = require("./AudioAnalysis/extractAudioAnalysis");
 Object.defineProperty(exports, "extractRawWavAnalysis", { enumerable: true, get: function () { return extractAudioAnalysis_1.extractRawWavAnalysis; } });
 Object.defineProperty(exports, "extractAudioAnalysis", { enumerable: true, get: function () { return extractAudioAnalysis_1.extractAudioAnalysis; } });
@@ -44,6 +44,8 @@ const trimAudio_1 = require("./trimAudio");
 Object.defineProperty(exports, "trimAudio", { enumerable: true, get: function () { return trimAudio_1.trimAudio; } });
 const useAudioRecorder_1 = require("./useAudioRecorder");
 Object.defineProperty(exports, "useAudioRecorder", { enumerable: true, get: function () { return useAudioRecorder_1.useAudioRecorder; } });
+var events_1 = require("./events");
+Object.defineProperty(exports, "addMaxDurationReachedListener", { enumerable: true, get: function () { return events_1.addMaxDurationReachedListener; } });
 __exportStar(require("./utils/convertPCMToFloat32"), exports);
 __exportStar(require("./utils/getWavFileInfo"), exports);
 __exportStar(require("./utils/writeWavHeader"), exports);

package/build/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,eAAe;;;;;;;;;;;;;;;;;;;;AAEf,+EAG6C;AAkDzC,sGApDA,4CAAqB,OAoDA;AACrB,qGApDA,2CAAoB,OAoDA;AAlDxB,uEAAmE;AAqD/D,iGArDK,mCAAgB,OAqDL;AApDpB,iFAG8C;AAoD1C,sGAtDA,6CAAqB,OAsDA;AAGrB,gGAxDA,uCAAe,OAwDA;AAtDnB,mEAA+D;AA8C3D,+FA9CK,+BAAc,OA8CL;AA7ClB,2EAG2C;AAgDvC,qGAlDA,yCAAoB,OAkDA;AACpB,oGAlDA,wCAAmB,OAkDA;AAhDvB,qEAGiC;AAkC7B,sGApCA,8CAAqB,OAoCA;AAcrB,uGAjDA,+CAAsB,OAiDA;AA/C1B,4EAAmD;AAkC/C,4BAlCG,2BAAiB,CAkCH;AAjCrB,uDAG0B;AAqCtB,2GAvCA,4CAA0B,OAuCA;AAD1B,gGArCA,iCAAe,OAqCA;AAnCnB,2CAAuC;AAiCnC,0FAjCK,qBAAS,OAiCL;AAhCb,yDAAqD;AAwCjD,iGAxCK,mCAAgB,OAwCL;AAtCpB,8DAA2C;AAC3C,yDAAsC;AACtC,yDAAsC;AAEtC,+BAA+B;AAC/B,uEAQwC;AAPpC,8HAAA,uBAAuB,OAAA;AACvB,0HAAA,mBAAmB,OAAA;AACnB,0HAAA,mBAAmB,OAAA;AACnB,0HAAA,mBAAmB,OAAA;AACnB,0HAAA,mBAAmB,OAAA;AACnB,8HAAA,uBAAuB,OAAA;AAI3B,4BAA4B;AAC5B,2DAA6E;AAApE,wHAAA,kBAAkB,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAE/C,8BAA8B;AAC9B,2DAAyD;AAAhD,kHAAA,eAAe,OAAA;AAExB,yDAAqE;AAA5D,sHAAA,wBAAwB,OAAA;AACjC,yEAAuE;AAA9D,wHAAA,kBAAkB,OAAA;AAoB3B,sEAGsC;AAFlC,4HAAA,oBAAoB,OAAA;AACpB,0HAAA,kBAAkB,OAAA;AAOtB,8DAGkC;AAF9B,oHAAA,gBAAgB,OAAA;AAChB,kHAAA,cAAc,OAAA;AAoBlB,gDAAgD;AACnC,QAAA,qBAAqB,GAAG,2BAAiB,CAAA","sourcesContent":["// src/index.ts\n\nimport {\n    extractRawWavAnalysis,\n    extractAudioAnalysis,\n} from './AudioAnalysis/extractAudioAnalysis'\nimport { extractAudioData } from './AudioAnalysis/extractAudioData'\nimport {\n    extractMelSpectrogram,\n    MAX_DURATION_MS,\n} from './AudioAnalysis/extractMelSpectrogram'\nimport { extractPreview } from './AudioAnalysis/extractPreview'\nimport {\n    initMelStreamingWasm,\n    computeMelFrameWasm,\n} from './AudioAnalysis/melSpectrogramWasm'\nimport {\n    AudioRecorderProvider,\n    useSharedAudioRecorder,\n} from './AudioRecorder.provider'\nimport AudioStudioModule from './AudioStudioModule'\nimport {\n    getAudioDecodeCapabilities,\n    streamAudioData,\n} from './streamAudioData'\nimport { trimAudio } from './trimAudio'\nimport { useAudioRecorder } from './useAudioRecorder'\n\nexport * from './utils/convertPCMToFloat32'\nexport * from './utils/getWavFileInfo'\nexport * from './utils/writeWavHeader'\n\n// Export platform capabilities\nexport {\n    getPlatformCapabilities,\n    isEncodingSupported,\n    isBitDepthSupported,\n    getFallbackEncoding,\n    getFallbackBitDepth,\n    validateRecordingConfig,\n    type PlatformCapabilities,\n} from './constants/platformLimitations'\n\n// Export AudioDeviceManager\nexport { AudioDeviceManager, audioDeviceManager } from './AudioDeviceManager'\n\n// Export useAudioDevices hook\nexport { useAudioDevices } from './hooks/useAudioDevices'\n\nexport { setMelSpectrogramWasmUrl } from './AudioAnalysis/wasmConfig'\nexport { extractPreviewBars } from './AudioAnalysis/extractPreviewBars'\n\nexport {\n    AudioRecorderProvider,\n    AudioStudioModule,\n    extractRawWavAnalysis,\n    extractAudioAnalysis,\n    extractPreview,\n    trimAudio,\n    extractAudioData,\n    streamAudioData,\n    getAudioDecodeCapabilities,\n    extractMelSpectrogram,\n    initMelStreamingWasm,\n    computeMelFrameWasm,\n    MAX_DURATION_MS,\n    useAudioRecorder,\n    useSharedAudioRecorder,\n}\n\nexport {\n    AudioExtractionError,\n    mapExtractionError,\n} from './errors/AudioExtractionError'\nexport type {\n    AudioExtractionErrorCode,\n    AudioExtractionErrorPayload,\n} from './errors/AudioExtractionError'\n\nexport {\n    AudioStreamError,\n    mapStreamError,\n} from './errors/AudioStreamError'\nexport type {\n    AudioStreamErrorCode,\n    AudioStreamErrorPayload,\n} from './errors/AudioStreamError'\n\nexport type {\n    StreamAudioDataOptions,\n    StreamAudioDataChunk,\n    StreamAudioDataProgress,\n    StreamAudioDataResult,\n    StreamAudioDataCallbacks,\n    AudioDecodeCapabilities,\n} from './streamAudioData'\n\n// Export all types\nexport type * from './AudioAnalysis/AudioAnalysis.types'\nexport type * from './AudioStudio.types'\n\n/** @deprecated Use AudioStudioModule instead */\nexport const ExpoAudioStreamModule = AudioStudioModule\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,eAAe;;;;;;;;;;;;;;;;;;;;AAEf,+EAG6C;AAmDzC,sGArDA,4CAAqB,OAqDA;AACrB,qGArDA,2CAAoB,OAqDA;AAnDxB,uEAAmE;AAsD/D,iGAtDK,mCAAgB,OAsDL;AArDpB,iFAG8C;AAqD1C,sGAvDA,6CAAqB,OAuDA;AAGrB,gGAzDA,uCAAe,OAyDA;AAvDnB,mEAA+D;AA+C3D,+FA/CK,+BAAc,OA+CL;AA9ClB,2EAG2C;AAiDvC,qGAnDA,yCAAoB,OAmDA;AACpB,oGAnDA,wCAAmB,OAmDA;AAjDvB,qEAGiC;AAmC7B,sGArCA,8CAAqB,OAqCA;AAcrB,uGAlDA,+CAAsB,OAkDA;AAhD1B,4EAAmD;AAmC/C,4BAnCG,2BAAiB,CAmCH;AAlCrB,uDAG0B;AAsCtB,2GAxCA,4CAA0B,OAwCA;AAD1B,gGAtCA,iCAAe,OAsCA;AApCnB,2CAAuC;AAkCnC,0FAlCK,qBAAS,OAkCL;AAjCb,yDAAqD;AAyCjD,iGAzCK,mCAAgB,OAyCL;AAxCpB,mCAAwD;AAA/C,uHAAA,6BAA6B,OAAA;AAEtC,8DAA2C;AAC3C,yDAAsC;AACtC,yDAAsC;AAEtC,+BAA+B;AAC/B,uEAQwC;AAPpC,8HAAA,uBAAuB,OAAA;AACvB,0HAAA,mBAAmB,OAAA;AACnB,0HAAA,mBAAmB,OAAA;AACnB,0HAAA,mBAAmB,OAAA;AACnB,0HAAA,mBAAmB,OAAA;AACnB,8HAAA,uBAAuB,OAAA;AAI3B,4BAA4B;AAC5B,2DAA6E;AAApE,wHAAA,kBAAkB,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAE/C,8BAA8B;AAC9B,2DAAyD;AAAhD,kHAAA,eAAe,OAAA;AAExB,yDAAqE;AAA5D,sHAAA,wBAAwB,OAAA;AACjC,yEAAuE;AAA9D,wHAAA,kBAAkB,OAAA;AAoB3B,sEAGsC;AAFlC,4HAAA,oBAAoB,OAAA;AACpB,0HAAA,kBAAkB,OAAA;AAOtB,8DAGkC;AAF9B,oHAAA,gBAAgB,OAAA;AAChB,kHAAA,cAAc,OAAA;AAoBlB,gDAAgD;AACnC,QAAA,qBAAqB,GAAG,2BAAiB,CAAA","sourcesContent":["// src/index.ts\n\nimport {\n    extractRawWavAnalysis,\n    extractAudioAnalysis,\n} from './AudioAnalysis/extractAudioAnalysis'\nimport { extractAudioData } from './AudioAnalysis/extractAudioData'\nimport {\n    extractMelSpectrogram,\n    MAX_DURATION_MS,\n} from './AudioAnalysis/extractMelSpectrogram'\nimport { extractPreview } from './AudioAnalysis/extractPreview'\nimport {\n    initMelStreamingWasm,\n    computeMelFrameWasm,\n} from './AudioAnalysis/melSpectrogramWasm'\nimport {\n    AudioRecorderProvider,\n    useSharedAudioRecorder,\n} from './AudioRecorder.provider'\nimport AudioStudioModule from './AudioStudioModule'\nimport {\n    getAudioDecodeCapabilities,\n    streamAudioData,\n} from './streamAudioData'\nimport { trimAudio } from './trimAudio'\nimport { useAudioRecorder } from './useAudioRecorder'\nexport { addMaxDurationReachedListener } from './events'\n\nexport * from './utils/convertPCMToFloat32'\nexport * from './utils/getWavFileInfo'\nexport * from './utils/writeWavHeader'\n\n// Export platform capabilities\nexport {\n    getPlatformCapabilities,\n    isEncodingSupported,\n    isBitDepthSupported,\n    getFallbackEncoding,\n    getFallbackBitDepth,\n    validateRecordingConfig,\n    type PlatformCapabilities,\n} from './constants/platformLimitations'\n\n// Export AudioDeviceManager\nexport { AudioDeviceManager, audioDeviceManager } from './AudioDeviceManager'\n\n// Export useAudioDevices hook\nexport { useAudioDevices } from './hooks/useAudioDevices'\n\nexport { setMelSpectrogramWasmUrl } from './AudioAnalysis/wasmConfig'\nexport { extractPreviewBars } from './AudioAnalysis/extractPreviewBars'\n\nexport {\n    AudioRecorderProvider,\n    AudioStudioModule,\n    extractRawWavAnalysis,\n    extractAudioAnalysis,\n    extractPreview,\n    trimAudio,\n    extractAudioData,\n    streamAudioData,\n    getAudioDecodeCapabilities,\n    extractMelSpectrogram,\n    initMelStreamingWasm,\n    computeMelFrameWasm,\n    MAX_DURATION_MS,\n    useAudioRecorder,\n    useSharedAudioRecorder,\n}\n\nexport {\n    AudioExtractionError,\n    mapExtractionError,\n} from './errors/AudioExtractionError'\nexport type {\n    AudioExtractionErrorCode,\n    AudioExtractionErrorPayload,\n} from './errors/AudioExtractionError'\n\nexport {\n    AudioStreamError,\n    mapStreamError,\n} from './errors/AudioStreamError'\nexport type {\n    AudioStreamErrorCode,\n    AudioStreamErrorPayload,\n} from './errors/AudioStreamError'\n\nexport type {\n    StreamAudioDataOptions,\n    StreamAudioDataChunk,\n    StreamAudioDataProgress,\n    StreamAudioDataResult,\n    StreamAudioDataCallbacks,\n    AudioDecodeCapabilities,\n} from './streamAudioData'\n\n// Export all types\nexport type * from './AudioAnalysis/AudioAnalysis.types'\nexport type * from './AudioStudio.types'\n\n/** @deprecated Use AudioStudioModule instead */\nexport const ExpoAudioStreamModule = AudioStudioModule\n"]}

package/build/cjs/useAudioRecorder.js

@@ -11,7 +11,7 @@ const AudioDeviceManager_1 = require("./AudioDeviceManager");
 const AudioStudioModule_1 = __importDefault(require("./AudioStudioModule"));
 const platformLimitations_1 = require("./constants/platformLimitations");
 const events_1 = require("./events");
-const cleanNativeOptions_1 = require("./utils/cleanNativeOptions");
+const nativeRecordingOptions_1 = require("./utils/nativeRecordingOptions");
 const defaultAnalysis = {
     segmentDurationMs: 100,
     bitDepth: 32,
@@ -30,6 +30,31 @@ const defaultAnalysis = {
     },
     extractionTimeMs: 0,
 };
+function finiteOrZero(value) {
+    return Number.isFinite(value) ? value : 0;
+}
+function sanitizeSerializableValue(value) {
+    if (typeof value === 'number') {
+        return finiteOrZero(value);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => sanitizeSerializableValue(item));
+    }
+    if (value && typeof value === 'object') {
+        const sanitized = {};
+        for (const [key, nestedValue] of Object.entries(value)) {
+            sanitized[key] = sanitizeSerializableValue(nestedValue);
+        }
+        return sanitized;
+    }
+    return value;
+}
+function createSerializableAnalysis(analysis) {
+    return sanitizeSerializableValue(analysis);
+}
+function createRecordingSnapshot(recording) {
+    return sanitizeSerializableValue(recording);
+}
 function audioRecorderReducer(state, action) {
     switch (action.type) {
         case 'START':
@@ -41,6 +66,9 @@ function audioRecorderReducer(state, action) {
                 size: 0,
                 compression: undefined,
                 analysisData: defaultAnalysis,
+                maxDurationMs: undefined,
+                maxDurationReached: false,
+                lastRecordingReason: undefined,
             };
         case 'STOP':
             return {
@@ -51,6 +79,9 @@ function audioRecorderReducer(state, action) {
                 size: 0,
                 compression: undefined,
                 analysisData: undefined,
+                lastRecordingReason: action.payload.reason,
+                // Preserve max-duration state after stop so UI and agentic
+                // validation can explain why recording ended. START resets it.
             };
         case 'PAUSE':
             return { ...state, isPaused: true, isRecording: false };
@@ -75,9 +106,17 @@ function audioRecorderReducer(state, action) {
                         format: action.payload.compression.format,
                     }
                     : undefined,
+                maxDurationMs: action.payload.maxDurationMs,
+                maxDurationReached: action.payload.maxDurationReached,
             };
             return newState;
         }
+        case 'MAX_DURATION_REACHED':
+            return {
+                ...state,
+                maxDurationMs: action.payload.maxDurationMs,
+                maxDurationReached: true,
+            };
         case 'UPDATE_ANALYSIS':
             return {
                 ...state,
@@ -102,6 +141,9 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
         size: 0,
         compression: undefined,
         analysisData: undefined,
+        maxDurationMs: undefined,
+        maxDurationReached: false,
+        lastRecordingReason: undefined,
     });
     const startResultRef = (0, react_1.useRef)(null);
     const analysisListenerRef = (0, react_1.useRef)(null);
@@ -126,8 +168,12 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
         durationMs: 0,
         size: 0,
         compression: undefined,
+        maxDurationMs: undefined,
+        maxDurationReached: false,
     });
     const recordingConfigRef = (0, react_1.useRef)(null);
+    const maxDurationHandledRef = (0, react_1.useRef)(false);
+    const stopFinalizationRef = (0, react_1.useRef)(null);
     // Generate unique instance ID for debugging
     const instanceId = (0, react_1.useId)().replace(/:/g, '').slice(0, 5);
     const handleAudioAnalysis = (0, react_1.useCallback)(async ({ analysis, visualizationDuration, }) => {
@@ -293,10 +339,105 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
             logger?.error(`Error processing audio event:`, error);
         }
     }, []);
+    const finalizeRecordingStop = (0, react_1.useCallback)(async (reason) => {
+        if (stopFinalizationRef.current) {
+            return stopFinalizationRef.current;
+        }
+        const finalizePromise = (async () => {
+            const nativeStopResult = await audioStudio.stopRecording();
+            if (!nativeStopResult) {
+                throw new Error('Failed to stop recording');
+            }
+            const stopResult = createRecordingSnapshot(nativeStopResult);
+            if (shouldKeepFullAnalysis(recordingConfigRef.current)) {
+                stopResult.analysisData = createSerializableAnalysis(fullAnalysisRef.current);
+            }
+            else {
+                // `keepFullAnalysis` is a hook-level retention policy. If a platform
+                // starts returning native analysisData in the future, keep opt-out
+                // semantics explicit and avoid leaking a full history here.
+                delete stopResult.analysisData;
+            }
+            if (analysisListenerRef.current) {
+                analysisListenerRef.current.remove();
+                analysisListenerRef.current = null;
+            }
+            onAudioStreamRef.current = null;
+            stateRef.current.isRecording = false;
+            stateRef.current.isPaused = false;
+            // Note: We deliberately DON'T clear recordingConfigRef here to preserve callbacks.
+            logger?.debug(`recording stopped`, stopResult);
+            maxDurationHandledRef.current = false;
+            dispatch({
+                type: 'STOP',
+                payload: { reason },
+            });
+            const stoppedCallback = recordingConfigRef.current?.onRecordingStopped;
+            if (stoppedCallback) {
+                try {
+                    void Promise.resolve(stoppedCallback(stopResult, reason)).catch((error) => {
+                        logger?.error(`Error in recording stopped callback:`, error);
+                    });
+                }
+                catch (error) {
+                    logger?.error(`Error in recording stopped callback:`, error);
+                }
+            }
+            return stopResult;
+        })();
+        stopFinalizationRef.current = finalizePromise;
+        try {
+            return await finalizePromise;
+        }
+        finally {
+            stopFinalizationRef.current = null;
+        }
+    }, [audioStudio, dispatch, logger]);
+    const handleMaxDurationReached = (0, react_1.useCallback)(async (event) => {
+        if (maxDurationHandledRef.current) {
+            return;
+        }
+        maxDurationHandledRef.current = true;
+        const config = recordingConfigRef.current;
+        const callbackEvent = {
+            ...event,
+            autoStopped: event.autoStopped || !!config?.autoStopOnMaxDuration,
+        };
+        stateRef.current.maxDurationMs = callbackEvent.maxDurationMs;
+        stateRef.current.maxDurationReached = true;
+        dispatch({
+            type: 'MAX_DURATION_REACHED',
+            payload: callbackEvent,
+        });
+        try {
+            config?.onMaxDurationReached?.(callbackEvent);
+        }
+        catch (error) {
+            logger?.error(`Error in max duration callback:`, error);
+        }
+        if (config?.autoStopOnMaxDuration && stateRef.current.isRecording) {
+            try {
+                await finalizeRecordingStop('maxDuration');
+            }
+            catch (error) {
+                logger?.error(`Error auto-stopping on max duration:`, error);
+            }
+        }
+    }, [dispatch, finalizeRecordingStop, logger]);
     const checkStatus = (0, react_1.useCallback)(async () => {
         try {
             const status = audioStudio.status();
             logger?.debug(`Status: paused: ${status.isPaused} isRecording: ${status.isRecording} durationMs: ${status.durationMs} size: ${status.size}`, status.compression);
+            if (status.maxDurationReached === true &&
+                status.maxDurationMs != null &&
+                !stateRef.current.maxDurationReached) {
+                await handleMaxDurationReached({
+                    durationMs: status.durationMs,
+                    maxDurationMs: status.maxDurationMs,
+                    overrunMs: Math.max(0, status.durationMs - status.maxDurationMs),
+                    autoStopped: false,
+                });
+            }
             // Only dispatch if values actually changed
             if (status.isRecording !== stateRef.current.isRecording ||
                 status.isPaused !== stateRef.current.isPaused) {
@@ -310,17 +451,34 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
                     },
                 });
             }
+            const statusMaxDurationReached = status.maxDurationReached ?? false;
+            const preserveStoppedMaxDuration = !status.isRecording &&
+                !status.isPaused &&
+                stateRef.current.maxDurationReached &&
+                !statusMaxDurationReached;
+            const nextMaxDurationMs = preserveStoppedMaxDuration
+                ? stateRef.current.maxDurationMs
+                : status.maxDurationMs;
+            const nextMaxDurationReached = preserveStoppedMaxDuration
+                ? true
+                : statusMaxDurationReached;
             if (status.durationMs !== stateRef.current.durationMs ||
-                status.size !== stateRef.current.size) {
+                status.size !== stateRef.current.size ||
+                nextMaxDurationMs !== stateRef.current.maxDurationMs ||
+                nextMaxDurationReached !== stateRef.current.maxDurationReached) {
                 stateRef.current.durationMs = status.durationMs;
                 stateRef.current.size = status.size;
                 stateRef.current.compression = status.compression;
+                stateRef.current.maxDurationMs = nextMaxDurationMs;
+                stateRef.current.maxDurationReached = nextMaxDurationReached;
                 dispatch({
                     type: 'UPDATE_STATUS',
                     payload: {
                         durationMs: status.durationMs,
                         size: status.size,
                         compression: status.compression,
+                        maxDurationMs: nextMaxDurationMs,
+                        maxDurationReached: nextMaxDurationReached,
                     },
                 });
             }
@@ -328,7 +486,7 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
         catch (error) {
             logger?.error(`Error getting status:`, error);
         }
-    }, [audioStudio, logger]); // Only depend on audioStudio and logger
+    }, [audioStudio, handleMaxDurationReached, logger]);
     // Update ref when state changes
     (0, react_1.useEffect)(() => {
         stateRef.current = {
@@ -337,6 +495,8 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
             durationMs: state.durationMs,
             size: state.size,
             compression: state.compression,
+            maxDurationMs: state.maxDurationMs,
+            maxDurationReached: state.maxDurationReached ?? false,
         };
     }, [
         state.isRecording,
@@ -344,6 +504,8 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
         state.durationMs,
         state.size,
         state.compression,
+        state.maxDurationMs,
+        state.maxDurationReached,
     ]);
     const startRecording = (0, react_1.useCallback)(async (recordingOptions) => {
         // Validate the encoding configuration
@@ -362,11 +524,11 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
             encoding: validationResult.encoding,
         };
         recordingConfigRef.current = validatedOptions;
+        maxDurationHandledRef.current = false;
         logger?.debug(`start recording with validated config`, validatedOptions);
         analysisRef.current = { ...defaultAnalysis }; // Reset analysis data
         fullAnalysisRef.current = { ...defaultAnalysis };
-        const { onAudioStream, onRecordingInterrupted, onAudioAnalysis, keepFullAnalysis: _keepFullAnalysis, ...options } = validatedOptions;
-        const { enableProcessing } = options;
+        const { onAudioStream, enableProcessing } = validatedOptions;
         const maxRecentDataDuration = 10000; // TODO compute maxRecentDataDuration based on screen dimensions
         if (typeof onAudioStream === 'function') {
             onAudioStreamRef.current = onAudioStream;
@@ -375,8 +537,10 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
             logger?.warn(`onAudioStream is not a function`, onAudioStream);
             onAudioStreamRef.current = null;
         }
-        // Strip undefined values and functions that can't cross the native bridge
-        const cleanOptions = (0, cleanNativeOptions_1.cleanNativeOptions)(options);
+        // Strip hook-only values and undefineds that can't cross the native bridge.
+        // autoStopOnMaxDuration stays hook-owned so finalization can expose
+        // the same AudioRecording result as a manual stop.
+        const cleanOptions = (0, nativeRecordingOptions_1.createNativeRecordingOptions)(validatedOptions);
         const startResult = await audioStudio.startRecording(cleanOptions);
         dispatch({ type: 'START' });
         startResultRef.current = startResult;
@@ -402,7 +566,7 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
         logger?.debug(`preparing recording`, recordingOptions);
         analysisRef.current = { ...defaultAnalysis }; // Reset analysis data
         fullAnalysisRef.current = { ...defaultAnalysis };
-        const { onAudioStream, onRecordingInterrupted, onAudioAnalysis, keepFullAnalysis: _keepFullAnalysis, ...options } = recordingOptions;
+        const { onAudioStream } = recordingOptions;
         // Store onAudioStream for later use when recording starts
         if (typeof onAudioStream === 'function') {
             onAudioStreamRef.current = onAudioStream;
@@ -411,34 +575,16 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
             logger?.warn(`onAudioStream is not a function`, onAudioStream);
             onAudioStreamRef.current = null;
         }
-        // Strip undefined values and functions that can't cross the native bridge
-        const cleanOptions = (0, cleanNativeOptions_1.cleanNativeOptions)(options);
+        // Strip hook-only values and undefineds that can't cross the native bridge.
+        const cleanOptions = (0, nativeRecordingOptions_1.createNativeRecordingOptions)(recordingOptions);
         // Call the native prepareRecording method
         await audioStudio.prepareRecording(cleanOptions);
         logger?.debug(`recording prepared successfully`);
     }, []);
     const stopRecording = (0, react_1.useCallback)(async () => {
         logger?.debug(`stoping recording`);
-        const stopResult = await audioStudio.stopRecording();
-        if (shouldKeepFullAnalysis(recordingConfigRef.current)) {
-            stopResult.analysisData = fullAnalysisRef.current;
-        }
-        else {
-            // `keepFullAnalysis` is a hook-level retention policy. If a platform
-            // starts returning native analysisData in the future, keep opt-out
-            // semantics explicit and avoid leaking a full history here.
-            delete stopResult.analysisData;
-        }
-        if (analysisListenerRef.current) {
-            analysisListenerRef.current.remove();
-            analysisListenerRef.current = null;
-        }
-        onAudioStreamRef.current = null;
-        // Note: We deliberately DON'T clear recordingConfigRef here to preserve interruption callback
-        logger?.debug(`recording stopped`, stopResult);
-        dispatch({ type: 'STOP' });
-        return stopResult;
-    }, [dispatch]);
+        return finalizeRecordingStop('manual');
+    }, [finalizeRecordingStop, logger]);
     const pauseRecording = (0, react_1.useCallback)(async () => {
         logger?.debug(`pause recording`);
         const pauseResult = await audioStudio.pauseRecording();
@@ -451,6 +597,14 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
         dispatch({ type: 'RESUME' });
         return resumeResult;
     }, [dispatch]);
+    (0, react_1.useEffect)(() => {
+        const subscription = (0, events_1.addMaxDurationReachedListener)(async (event) => {
+            await handleMaxDurationReached(event);
+        });
+        return () => {
+            subscription.remove();
+        };
+    }, [handleMaxDurationReached]);
     (0, react_1.useEffect)(() => {
         let intervalId;
         if (state.isRecording || state.isPaused) {
@@ -548,6 +702,9 @@ function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl, } = {}
         size: state.size,
         compression: state.compression,
         analysisData: state.analysisData,
+        maxDurationMs: state.maxDurationMs,
+        maxDurationReached: state.maxDurationReached,
+        lastRecordingReason: state.lastRecordingReason,
     };
 }
 //# sourceMappingURL=useAudioRecorder.js.map