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

package/build/esm/events.js

@@ -18,4 +18,7 @@ export function addRecordingInterruptionListener(listener) {
     });
     return subscription;
 }
+export function addMaxDurationReachedListener(listener) {
+    return emitter.addListener('MaxDurationReached', listener);
+}
 //# sourceMappingURL=events.js.map

package/build/esm/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,kBAAkB,EAA0B,MAAM,mBAAmB,CAAA;AAI9E,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AAEnD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;AAwBzD,MAAM,UAAU,qBAAqB,CACjC,QAAqD;IAErD,OAAO,OAAO,CAAC,WAAW,CAAoB,WAAW,EAAE,QAAQ,CAAC,CAAA;AACxE,CAAC;AAKD,MAAM,UAAU,wBAAwB,CACpC,QAAsD;IAEtD,OAAO,OAAO,CAAC,WAAW,CAAqB,eAAe,EAAE,QAAQ,CAAC,CAAA;AAC7E,CAAC;AAED,MAAM,UAAU,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;AAEtC,OAAO,EAAE,kBAAkB,EAA0B,MAAM,mBAAmB,CAAA;AAO9E,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AAEnD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;AAwBzD,MAAM,UAAU,qBAAqB,CACjC,QAAqD;IAErD,OAAO,OAAO,CAAC,WAAW,CAAoB,WAAW,EAAE,QAAQ,CAAC,CAAA;AACxE,CAAC;AAKD,MAAM,UAAU,wBAAwB,CACpC,QAAsD;IAEtD,OAAO,OAAO,CAAC,WAAW,CAAqB,eAAe,EAAE,QAAQ,CAAC,CAAA;AAC7E,CAAC;AAED,MAAM,UAAU,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,MAAM,UAAU,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/esm/index.js

@@ -9,6 +9,7 @@ import AudioStudioModule from './AudioStudioModule';
 import { getAudioDecodeCapabilities, streamAudioData, } from './streamAudioData';
 import { trimAudio } from './trimAudio';
 import { useAudioRecorder } from './useAudioRecorder';
+export { addMaxDurationReachedListener } from './events';
 export * from './utils/convertPCMToFloat32';
 export * from './utils/getWavFileInfo';
 export * from './utils/writeWavHeader';

package/build/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AAEf,OAAO,EACH,qBAAqB,EACrB,oBAAoB,GACvB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EACH,qBAAqB,EACrB,eAAe,GAClB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,EACH,oBAAoB,EACpB,mBAAmB,GACtB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EACH,qBAAqB,EACrB,sBAAsB,GACzB,MAAM,0BAA0B,CAAA;AACjC,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,EACH,0BAA0B,EAC1B,eAAe,GAClB,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;AAEtC,+BAA+B;AAC/B,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GAE1B,MAAM,iCAAiC,CAAA;AAExC,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE7E,8BAA8B;AAC9B,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;AAMtC,OAAO,EACH,gBAAgB,EAChB,cAAc,GACjB,MAAM,2BAA2B,CAAA;AAmBlC,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,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,OAAO,EACH,qBAAqB,EACrB,oBAAoB,GACvB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EACH,qBAAqB,EACrB,eAAe,GAClB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,OAAO,EACH,oBAAoB,EACpB,mBAAmB,GACtB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EACH,qBAAqB,EACrB,sBAAsB,GACzB,MAAM,0BAA0B,CAAA;AACjC,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,EACH,0BAA0B,EAC1B,eAAe,GAClB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAA;AAExD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AAEtC,+BAA+B;AAC/B,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GAE1B,MAAM,iCAAiC,CAAA;AAExC,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE7E,8BAA8B;AAC9B,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;AAMtC,OAAO,EACH,gBAAgB,EAChB,cAAc,GACjB,MAAM,2BAA2B,CAAA;AAmBlC,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,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/esm/useAudioRecorder.js

@@ -4,8 +4,8 @@ import { useCallback, useEffect, useReducer, useRef, useId } from 'react';
 import { audioDeviceManager } from './AudioDeviceManager';
 import AudioStudioModule from './AudioStudioModule';
 import { validateRecordingConfig } from './constants/platformLimitations';
-import { addAudioAnalysisListener, addAudioEventListener, addRecordingInterruptionListener, } from './events';
-import { cleanNativeOptions } from './utils/cleanNativeOptions';
+import { addAudioAnalysisListener, addAudioEventListener, addMaxDurationReachedListener, addRecordingInterruptionListener, } from './events';
+import { createNativeRecordingOptions } from './utils/nativeRecordingOptions';
 const defaultAnalysis = {
     segmentDurationMs: 100,
     bitDepth: 32,
@@ -24,6 +24,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':
@@ -35,6 +60,9 @@ function audioRecorderReducer(state, action) {
                 size: 0,
                 compression: undefined,
                 analysisData: defaultAnalysis,
+                maxDurationMs: undefined,
+                maxDurationReached: false,
+                lastRecordingReason: undefined,
             };
         case 'STOP':
             return {
@@ -45,6 +73,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 };
@@ -69,9 +100,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,
@@ -96,6 +135,9 @@ export function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl,
         size: 0,
         compression: undefined,
         analysisData: undefined,
+        maxDurationMs: undefined,
+        maxDurationReached: false,
+        lastRecordingReason: undefined,
     });
     const startResultRef = useRef(null);
     const analysisListenerRef = useRef(null);
@@ -120,8 +162,12 @@ export function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl,
         durationMs: 0,
         size: 0,
         compression: undefined,
+        maxDurationMs: undefined,
+        maxDurationReached: false,
     });
     const recordingConfigRef = useRef(null);
+    const maxDurationHandledRef = useRef(false);
+    const stopFinalizationRef = useRef(null);
     // Generate unique instance ID for debugging
     const instanceId = useId().replace(/:/g, '').slice(0, 5);
     const handleAudioAnalysis = useCallback(async ({ analysis, visualizationDuration, }) => {
@@ -287,10 +333,105 @@ export function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl,
             logger?.error(`Error processing audio event:`, error);
         }
     }, []);
+    const finalizeRecordingStop = 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 = 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 = 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) {
@@ -304,17 +445,34 @@ export 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,
                     },
                 });
             }
@@ -322,7 +480,7 @@ export 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
     useEffect(() => {
         stateRef.current = {
@@ -331,6 +489,8 @@ export function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl,
             durationMs: state.durationMs,
             size: state.size,
             compression: state.compression,
+            maxDurationMs: state.maxDurationMs,
+            maxDurationReached: state.maxDurationReached ?? false,
         };
     }, [
         state.isRecording,
@@ -338,6 +498,8 @@ export function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl,
         state.durationMs,
         state.size,
         state.compression,
+        state.maxDurationMs,
+        state.maxDurationReached,
     ]);
     const startRecording = useCallback(async (recordingOptions) => {
         // Validate the encoding configuration
@@ -356,11 +518,11 @@ export 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;
@@ -369,8 +531,10 @@ export 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 = 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 = createNativeRecordingOptions(validatedOptions);
         const startResult = await audioStudio.startRecording(cleanOptions);
         dispatch({ type: 'START' });
         startResultRef.current = startResult;
@@ -396,7 +560,7 @@ export 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;
@@ -405,34 +569,16 @@ export 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 = cleanNativeOptions(options);
+        // Strip hook-only values and undefineds that can't cross the native bridge.
+        const cleanOptions = createNativeRecordingOptions(recordingOptions);
         // Call the native prepareRecording method
         await audioStudio.prepareRecording(cleanOptions);
         logger?.debug(`recording prepared successfully`);
     }, []);
     const stopRecording = 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 = useCallback(async () => {
         logger?.debug(`pause recording`);
         const pauseResult = await audioStudio.pauseRecording();
@@ -445,6 +591,14 @@ export function useAudioRecorder({ logger, audioWorkletUrl, featuresExtratorUrl,
         dispatch({ type: 'RESUME' });
         return resumeResult;
     }, [dispatch]);
+    useEffect(() => {
+        const subscription = addMaxDurationReachedListener(async (event) => {
+            await handleMaxDurationReached(event);
+        });
+        return () => {
+            subscription.remove();
+        };
+    }, [handleMaxDurationReached]);
     useEffect(() => {
         let intervalId;
         if (state.isRecording || state.isPaused) {
@@ -542,6 +696,9 @@ export 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