@independo/capacitor-voice-recorder 8.1.8 → 8.1.9-dev.1

package/README.md

@@ -322,10 +322,11 @@ Interface representing a generic response with a boolean value.
 
 Can be used to specify options for the recording.
 
-| Prop               | Type                                            | Description                                                                                                                                                                                                        |
-| ------------------ | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| **`directory`**    | <code><a href="#directory">Directory</a></code> | The capacitor filesystem directory where the recording should be saved. If not specified, the recording will be stored in a base64 string and returned in the <a href="#recordingdata">`RecordingData`</a> object. |
-| **`subDirectory`** | <code>string</code>                             | An optional subdirectory in the specified directory where the recording should be saved.                                                                                                                           |
+| Prop                         | Type                                            | Description                                                                                                                                                                                                                                                                                                                                                                                                      |
+| ---------------------------- | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`directory`**              | <code><a href="#directory">Directory</a></code> | The capacitor filesystem directory where the recording should be saved. If not specified, the recording will be stored in a base64 string and returned in the <a href="#recordingdata">`RecordingData`</a> object.                                                                                                                                                                                               |
+| **`subDirectory`**           | <code>string</code>                             | An optional subdirectory in the specified directory where the recording should be saved.                                                                                                                                                                                                                                                                                                                         |
+| **`requirePlaybackSupport`** | <code>boolean</code>                            | Whether the web implementation should require the selected recording MIME type to also be playable by the browser's native HTML `&lt;audio&gt;` element. Defaults to `true` on web to reduce cases where `MediaRecorder` reports support for a format but the recorded file cannot be played back in the same browser (observed on some Safari/iOS/WKWebView combinations). Native platforms ignore this option. |
 
 
 #### RecordingData

package/dist/docs.json

@@ -315,6 +315,13 @@
           "docs": "An optional subdirectory in the specified directory where the recording should be saved.",
           "complexTypes": [],
           "type": "string | undefined"
+        },
+        {
+          "name": "requirePlaybackSupport",
+          "tags": [],
+          "docs": "Whether the web implementation should require the selected recording MIME type\nto also be playable by the browser's native HTML `<audio>` element.\n\nDefaults to `true` on web to reduce cases where `MediaRecorder` reports support\nfor a format but the recorded file cannot be played back in the same browser\n(observed on some Safari/iOS/WKWebView combinations).\n\nNative platforms ignore this option.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
         }
       ]
     },

package/dist/esm/definitions.d.ts

@@ -19,6 +19,17 @@ export interface RecordingOptions {
      * An optional subdirectory in the specified directory where the recording should be saved.
      */
     subDirectory?: string;
+    /**
+     * Whether the web implementation should require the selected recording MIME type
+     * to also be playable by the browser's native HTML `<audio>` element.
+     *
+     * Defaults to `true` on web to reduce cases where `MediaRecorder` reports support
+     * for a format but the recorded file cannot be played back in the same browser
+     * (observed on some Safari/iOS/WKWebView combinations).
+     *
+     * Native platforms ignore this option.
+     */
+    requirePlaybackSupport?: boolean;
 }
 /**
  * Interface representing the data of a recording.

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type {PluginListenerHandle} from \"@capacitor/core\";\nimport type {Directory} from \"@capacitor/filesystem\";\n\n/**\n * Represents a Base64 encoded string.\n */\nexport type Base64String = string;\n\n/**\n * Can be used to specify options for the recording.\n */\nexport interface RecordingOptions {\n    /**\n     * The capacitor filesystem directory where the recording should be saved.\n     *\n     * If not specified, the recording will be stored in a base64 string and returned in the `RecordingData` object.\n     * @see RecordingData\n     */\n    directory?: Directory;\n\n    /**\n     * An optional subdirectory in the specified directory where the recording should be saved.\n     */\n    subDirectory?: string;\n}\n\n/**\n * Interface representing the data of a recording.\n */\nexport interface RecordingData {\n    /**\n     * The value containing the recording details.\n     */\n    value: {\n        /**\n         * The recorded data as a Base64 encoded string.\n         */\n        recordDataBase64: Base64String;\n        /**\n         * The duration of the recording in milliseconds.\n         */\n        msDuration: number;\n        /**\n         * The MIME type of the recorded file.\n         */\n        mimeType: string;\n\n        /**\n         * The URI of the recording file.\n         */\n        uri?: string;\n    };\n}\n\n/**\n * Interface representing a generic response with a boolean value.\n */\nexport interface GenericResponse {\n    /**\n     * The result of the operation as a boolean value.\n     */\n    value: boolean;\n}\n\n/**\n * Interface representing the current status of the voice recorder.\n */\nexport interface CurrentRecordingStatus {\n    /**\n     * The current status of the recorder, which can be one of the following values: 'RECORDING', 'PAUSED', 'INTERRUPTED', 'NONE'.\n     */\n    status: 'RECORDING' | 'PAUSED' | 'INTERRUPTED' | 'NONE';\n}\n\n/**\n * Event payload for voiceRecordingInterrupted event (empty - no data).\n */\nexport type VoiceRecordingInterruptedEvent = Record<string, never>;\n\n/**\n * Event payload for voiceRecordingInterruptionEnded event (empty - no data).\n */\nexport type VoiceRecordingInterruptionEndedEvent = Record<string, never>;\n\n/**\n * Interface for the VoiceRecorderPlugin which provides methods to record audio.\n */\nexport interface VoiceRecorderPlugin {\n    /**\n     * Checks if the current device can record audio.\n     * On mobile, this function will always resolve to `{ value: true }`.\n     * In a browser, it will resolve to `{ value: true }` or `{ value: false }` based on the browser's ability to record.\n     * This method does not take into account the permission status, only if the browser itself is capable of recording at all.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with code \"COULD_NOT_QUERY_PERMISSION_STATUS\" if the device cannot query the permission status.\n     */\n    canDeviceVoiceRecord(): Promise<GenericResponse>;\n\n    /**\n     * Requests audio recording permission from the user.\n     * If the permission has already been provided, the promise will resolve with `{ value: true }`.\n     * Otherwise, the promise will resolve to `{ value: true }` or `{ value: false }` based on the user's response.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error if the permission request fails.\n     */\n    requestAudioRecordingPermission(): Promise<GenericResponse>;\n\n    /**\n     * Checks if audio recording permission has been granted.\n     * Will resolve to `{ value: true }` or `{ value: false }` based on the status of the permission.\n     * The web implementation of this plugin uses the Permissions API, which is not widespread.\n     * If the status of the permission cannot be checked, the promise will reject with `COULD_NOT_QUERY_PERMISSION_STATUS`.\n     * In that case, use `requestAudioRecordingPermission` or `startRecording` and capture any exception that is thrown.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with code \"COULD_NOT_QUERY_PERMISSION_STATUS\" if the device cannot query the permission status.\n     */\n    hasAudioRecordingPermission(): Promise<GenericResponse>;\n\n    /**\n     * Starts audio recording.\n     * On success, the promise will resolve to { value: true }.\n     * On error, the promise will reject with one of the following error codes:\n     * \"MISSING_PERMISSION\", \"ALREADY_RECORDING\", \"MICROPHONE_BEING_USED\", \"DEVICE_CANNOT_VOICE_RECORD\", or \"FAILED_TO_RECORD\".\n     * @param options The options for the recording.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with one of the specified error codes if the recording cannot be started.\n     */\n    startRecording(options?: RecordingOptions): Promise<GenericResponse>;\n\n    /**\n     * Stops audio recording.\n     * Will stop the recording that has been previously started.\n     * If the function `startRecording` has not been called beforehand, the promise will reject with `RECORDING_HAS_NOT_STARTED`.\n     * If the recording has been stopped immediately after it has been started, the promise will reject with `EMPTY_RECORDING`.\n     * In a case of unknown error, the promise will reject with `FAILED_TO_FETCH_RECORDING`.\n     * On iOS, if a recording interrupted by the system cannot be merged, the promise will reject with `FAILED_TO_MERGE_RECORDING`.\n     * In case of success, the promise resolves to RecordingData containing the recording in base-64, the duration of the recording in milliseconds, and the MIME type.\n     * @returns A promise that resolves to RecordingData.\n     * @throws Error with one of the specified error codes if the recording cannot be stopped.\n     */\n    stopRecording(): Promise<RecordingData>;\n\n    /**\n     * Pauses the ongoing audio recording.\n     * If the recording has not started yet, the promise will reject with an error code `RECORDING_HAS_NOT_STARTED`.\n     * On success, the promise will resolve to { value: true } if the pause was successful or { value: false } if the recording is already paused.\n     * On certain mobile OS versions, this function is not supported and will reject with `NOT_SUPPORTED_OS_VERSION`.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with one of the specified error codes if the recording cannot be paused.\n     */\n    pauseRecording(): Promise<GenericResponse>;\n\n    /**\n     * Resumes a paused or interrupted audio recording.\n     * If the recording has not started yet, the promise will reject with an error code `RECORDING_HAS_NOT_STARTED`.\n     * On success, the promise will resolve to { value: true } if the resume was successful or { value: false } if the recording is already running.\n     * On certain mobile OS versions, this function is not supported and will reject with `NOT_SUPPORTED_OS_VERSION`.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with one of the specified error codes if the recording cannot be resumed.\n     */\n    resumeRecording(): Promise<GenericResponse>;\n\n    /**\n     * Gets the current status of the voice recorder.\n     * Will resolve with one of the following values:\n     * `{ status: \"NONE\" }` if the plugin is idle and waiting to start a new recording.\n     * `{ status: \"RECORDING\" }` if the plugin is in the middle of recording.\n     * `{ status: \"PAUSED\" }` if the recording is paused.\n     * `{ status: \"INTERRUPTED\" }` if the recording was paused due to a system interruption.\n     * @returns A promise that resolves to a CurrentRecordingStatus.\n     * @throws Error if the status cannot be fetched.\n     */\n    getCurrentStatus(): Promise<CurrentRecordingStatus>;\n\n    /**\n     * Listen for audio recording interruptions (e.g., phone calls, other apps using microphone).\n     * Available on iOS and Android only.\n     *\n     * @param eventName The name of the event to listen for.\n     * @param listenerFunc The callback function to invoke when the event occurs.\n     * @returns A promise that resolves to a PluginListenerHandle.\n     */\n    addListener(\n        eventName: 'voiceRecordingInterrupted',\n        listenerFunc: (event: VoiceRecordingInterruptedEvent) => void,\n    ): Promise<PluginListenerHandle>;\n\n    /**\n     * Listen for audio recording interruption end events.\n     * Available on iOS and Android only.\n     *\n     * @param eventName The name of the event to listen for.\n     * @param listenerFunc The callback function to invoke when the event occurs.\n     * @returns A promise that resolves to a PluginListenerHandle.\n     */\n    addListener(\n        eventName: 'voiceRecordingInterruptionEnded',\n        listenerFunc: (event: VoiceRecordingInterruptionEndedEvent) => void,\n    ): Promise<PluginListenerHandle>;\n\n    /**\n     * Remove all listeners for this plugin.\n     */\n    removeAllListeners(): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type {PluginListenerHandle} from \"@capacitor/core\";\nimport type {Directory} from \"@capacitor/filesystem\";\n\n/**\n * Represents a Base64 encoded string.\n */\nexport type Base64String = string;\n\n/**\n * Can be used to specify options for the recording.\n */\nexport interface RecordingOptions {\n    /**\n     * The capacitor filesystem directory where the recording should be saved.\n     *\n     * If not specified, the recording will be stored in a base64 string and returned in the `RecordingData` object.\n     * @see RecordingData\n     */\n    directory?: Directory;\n\n    /**\n     * An optional subdirectory in the specified directory where the recording should be saved.\n     */\n    subDirectory?: string;\n\n    /**\n     * Whether the web implementation should require the selected recording MIME type\n     * to also be playable by the browser's native HTML `<audio>` element.\n     *\n     * Defaults to `true` on web to reduce cases where `MediaRecorder` reports support\n     * for a format but the recorded file cannot be played back in the same browser\n     * (observed on some Safari/iOS/WKWebView combinations).\n     *\n     * Native platforms ignore this option.\n     */\n    requirePlaybackSupport?: boolean;\n}\n\n/**\n * Interface representing the data of a recording.\n */\nexport interface RecordingData {\n    /**\n     * The value containing the recording details.\n     */\n    value: {\n        /**\n         * The recorded data as a Base64 encoded string.\n         */\n        recordDataBase64: Base64String;\n        /**\n         * The duration of the recording in milliseconds.\n         */\n        msDuration: number;\n        /**\n         * The MIME type of the recorded file.\n         */\n        mimeType: string;\n\n        /**\n         * The URI of the recording file.\n         */\n        uri?: string;\n    };\n}\n\n/**\n * Interface representing a generic response with a boolean value.\n */\nexport interface GenericResponse {\n    /**\n     * The result of the operation as a boolean value.\n     */\n    value: boolean;\n}\n\n/**\n * Interface representing the current status of the voice recorder.\n */\nexport interface CurrentRecordingStatus {\n    /**\n     * The current status of the recorder, which can be one of the following values: 'RECORDING', 'PAUSED', 'INTERRUPTED', 'NONE'.\n     */\n    status: 'RECORDING' | 'PAUSED' | 'INTERRUPTED' | 'NONE';\n}\n\n/**\n * Event payload for voiceRecordingInterrupted event (empty - no data).\n */\nexport type VoiceRecordingInterruptedEvent = Record<string, never>;\n\n/**\n * Event payload for voiceRecordingInterruptionEnded event (empty - no data).\n */\nexport type VoiceRecordingInterruptionEndedEvent = Record<string, never>;\n\n/**\n * Interface for the VoiceRecorderPlugin which provides methods to record audio.\n */\nexport interface VoiceRecorderPlugin {\n    /**\n     * Checks if the current device can record audio.\n     * On mobile, this function will always resolve to `{ value: true }`.\n     * In a browser, it will resolve to `{ value: true }` or `{ value: false }` based on the browser's ability to record.\n     * This method does not take into account the permission status, only if the browser itself is capable of recording at all.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with code \"COULD_NOT_QUERY_PERMISSION_STATUS\" if the device cannot query the permission status.\n     */\n    canDeviceVoiceRecord(): Promise<GenericResponse>;\n\n    /**\n     * Requests audio recording permission from the user.\n     * If the permission has already been provided, the promise will resolve with `{ value: true }`.\n     * Otherwise, the promise will resolve to `{ value: true }` or `{ value: false }` based on the user's response.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error if the permission request fails.\n     */\n    requestAudioRecordingPermission(): Promise<GenericResponse>;\n\n    /**\n     * Checks if audio recording permission has been granted.\n     * Will resolve to `{ value: true }` or `{ value: false }` based on the status of the permission.\n     * The web implementation of this plugin uses the Permissions API, which is not widespread.\n     * If the status of the permission cannot be checked, the promise will reject with `COULD_NOT_QUERY_PERMISSION_STATUS`.\n     * In that case, use `requestAudioRecordingPermission` or `startRecording` and capture any exception that is thrown.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with code \"COULD_NOT_QUERY_PERMISSION_STATUS\" if the device cannot query the permission status.\n     */\n    hasAudioRecordingPermission(): Promise<GenericResponse>;\n\n    /**\n     * Starts audio recording.\n     * On success, the promise will resolve to { value: true }.\n     * On error, the promise will reject with one of the following error codes:\n     * \"MISSING_PERMISSION\", \"ALREADY_RECORDING\", \"MICROPHONE_BEING_USED\", \"DEVICE_CANNOT_VOICE_RECORD\", or \"FAILED_TO_RECORD\".\n     * @param options The options for the recording.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with one of the specified error codes if the recording cannot be started.\n     */\n    startRecording(options?: RecordingOptions): Promise<GenericResponse>;\n\n    /**\n     * Stops audio recording.\n     * Will stop the recording that has been previously started.\n     * If the function `startRecording` has not been called beforehand, the promise will reject with `RECORDING_HAS_NOT_STARTED`.\n     * If the recording has been stopped immediately after it has been started, the promise will reject with `EMPTY_RECORDING`.\n     * In a case of unknown error, the promise will reject with `FAILED_TO_FETCH_RECORDING`.\n     * On iOS, if a recording interrupted by the system cannot be merged, the promise will reject with `FAILED_TO_MERGE_RECORDING`.\n     * In case of success, the promise resolves to RecordingData containing the recording in base-64, the duration of the recording in milliseconds, and the MIME type.\n     * @returns A promise that resolves to RecordingData.\n     * @throws Error with one of the specified error codes if the recording cannot be stopped.\n     */\n    stopRecording(): Promise<RecordingData>;\n\n    /**\n     * Pauses the ongoing audio recording.\n     * If the recording has not started yet, the promise will reject with an error code `RECORDING_HAS_NOT_STARTED`.\n     * On success, the promise will resolve to { value: true } if the pause was successful or { value: false } if the recording is already paused.\n     * On certain mobile OS versions, this function is not supported and will reject with `NOT_SUPPORTED_OS_VERSION`.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with one of the specified error codes if the recording cannot be paused.\n     */\n    pauseRecording(): Promise<GenericResponse>;\n\n    /**\n     * Resumes a paused or interrupted audio recording.\n     * If the recording has not started yet, the promise will reject with an error code `RECORDING_HAS_NOT_STARTED`.\n     * On success, the promise will resolve to { value: true } if the resume was successful or { value: false } if the recording is already running.\n     * On certain mobile OS versions, this function is not supported and will reject with `NOT_SUPPORTED_OS_VERSION`.\n     * @returns A promise that resolves to a GenericResponse.\n     * @throws Error with one of the specified error codes if the recording cannot be resumed.\n     */\n    resumeRecording(): Promise<GenericResponse>;\n\n    /**\n     * Gets the current status of the voice recorder.\n     * Will resolve with one of the following values:\n     * `{ status: \"NONE\" }` if the plugin is idle and waiting to start a new recording.\n     * `{ status: \"RECORDING\" }` if the plugin is in the middle of recording.\n     * `{ status: \"PAUSED\" }` if the recording is paused.\n     * `{ status: \"INTERRUPTED\" }` if the recording was paused due to a system interruption.\n     * @returns A promise that resolves to a CurrentRecordingStatus.\n     * @throws Error if the status cannot be fetched.\n     */\n    getCurrentStatus(): Promise<CurrentRecordingStatus>;\n\n    /**\n     * Listen for audio recording interruptions (e.g., phone calls, other apps using microphone).\n     * Available on iOS and Android only.\n     *\n     * @param eventName The name of the event to listen for.\n     * @param listenerFunc The callback function to invoke when the event occurs.\n     * @returns A promise that resolves to a PluginListenerHandle.\n     */\n    addListener(\n        eventName: 'voiceRecordingInterrupted',\n        listenerFunc: (event: VoiceRecordingInterruptedEvent) => void,\n    ): Promise<PluginListenerHandle>;\n\n    /**\n     * Listen for audio recording interruption end events.\n     * Available on iOS and Android only.\n     *\n     * @param eventName The name of the event to listen for.\n     * @param listenerFunc The callback function to invoke when the event occurs.\n     * @returns A promise that resolves to a PluginListenerHandle.\n     */\n    addListener(\n        eventName: 'voiceRecordingInterruptionEnded',\n        listenerFunc: (event: VoiceRecordingInterruptionEndedEvent) => void,\n    ): Promise<PluginListenerHandle>;\n\n    /**\n     * Remove all listeners for this plugin.\n     */\n    removeAllListeners(): Promise<void>;\n}\n"]}

package/dist/esm/platform/web/VoiceRecorderImpl.d.ts

@@ -1,23 +1,66 @@
 import type { CurrentRecordingStatus, GenericResponse, RecordingData, RecordingOptions } from '../../definitions';
-/** Preferred MIME types to probe in order of fallback. */
-declare const POSSIBLE_MIME_TYPES: {
-    'audio/aac': string;
-    'audio/webm;codecs=opus': string;
-    'audio/mp4': string;
-    'audio/webm': string;
-    'audio/ogg;codecs=opus': string;
-};
+/**
+ * Ordered MIME types to probe for audio recording via `MediaRecorder.isTypeSupported()`.
+ *
+ * ⚠️ The order is intentional and MUST remain stable unless you also update the
+ * selection policy in code and test on Safari/iOS + WebViews.
+ *
+ * ✅ What this list is used for
+ * - Selecting a `mimeType` for `new MediaRecorder(stream, { mimeType })`.
+ *
+ * ❌ What this list does NOT guarantee
+ * - It does NOT guarantee that the recorded output will be playable via the
+ *   HTML `<audio>` element in the same browser.
+ *
+ * Real-world caveat (important):
+ * - We have observed cases where `MediaRecorder.isTypeSupported('audio/webm;codecs=opus')`
+ *   returned `true`, the recorder produced a Blob, but `<audio>` could not play it.
+ *   This can happen due to container/codec playback support differences, platform
+ *   quirks (especially Safari/iOS / WKWebView), or incomplete WebM playback support.
+ *
+ * Current selection behavior in this implementation:
+ * - By default, MIME selection treats recorder support and playback support as separate
+ *   capabilities and probes both:
+ *   - Recorder capability: `MediaRecorder.isTypeSupported(type)`
+ *   - Playback capability: `audio.canPlayType(type)`
+ * - This default can be disabled via `RecordingOptions.requirePlaybackSupport = false`
+ *   to fall back to recorder-only probing.
+ *
+ * Keeping legacy keys:
+ * - Some entries are kept even if they overlap (e.g. `audio/mp4` and explicit codec),
+ *   to maximize compatibility across differing browser implementations.
+ */
+declare const POSSIBLE_MIME_TYPES: Record<string, string>;
 /** Browser implementation backed by MediaRecorder and Capacitor Filesystem. */
 export declare class VoiceRecorderImpl {
+    /** Default behavior for web MIME selection: require recorder + playback support. */
+    private static readonly DEFAULT_REQUIRE_PLAYBACK_SUPPORT;
     /** Active MediaRecorder instance, if recording. */
     private mediaRecorder;
+    /** MIME type selected at start time for the active recording. */
+    private activeMimeType;
     /** Collected data chunks from MediaRecorder. */
     private chunks;
     /** Promise resolved when the recorder stops and payload is ready. */
     private pendingResult;
-    /** Returns whether the browser can start a recording session. */
-    static canDeviceVoiceRecord(): Promise<GenericResponse>;
-    /** Starts a recording session using MediaRecorder. */
+    /**
+     * Returns whether the browser can start a recording session.
+     *
+     * On web this checks:
+     * - `navigator.mediaDevices.getUserMedia`
+     * - at least one supported recording MIME type using {@link getSupportedMimeType}
+     *
+     * The optional `requirePlaybackSupport` flag is forwarded to MIME selection and defaults
+     * to `true` when omitted.
+     */
+    static canDeviceVoiceRecord(options?: Pick<RecordingOptions, 'requirePlaybackSupport'>): Promise<GenericResponse>;
+    /**
+     * Starts a recording session using `MediaRecorder`.
+     *
+     * The selected MIME type is resolved once at start time (using the optional
+     * `requirePlaybackSupport` flag from `RecordingOptions`) and reused for the final Blob
+     * and file extension to keep the recording payload internally consistent.
+     */
     startRecording(options?: RecordingOptions): Promise<GenericResponse>;
     /** Stops the current recording and resolves the pending payload. */
     stopRecording(): Promise<RecordingData>;
@@ -31,8 +74,41 @@ export declare class VoiceRecorderImpl {
     resumeRecording(): Promise<GenericResponse>;
     /** Returns the current recording status from MediaRecorder. */
     getCurrentStatus(): Promise<CurrentRecordingStatus>;
-    /** Returns the first supported MIME type, if any. */
-    static getSupportedMimeType<T extends keyof typeof POSSIBLE_MIME_TYPES>(): T | null;
+    /**
+     * Returns the first MIME type (key of {@link POSSIBLE_MIME_TYPES}) that the current
+     * environment reports as supported for recording via `MediaRecorder.isTypeSupported()`,
+     * optionally requiring native HTML `<audio>` playback support too.
+     *
+     * The search order is the iteration order of {@link POSSIBLE_MIME_TYPES}.
+     *
+     * @typeParam T - A MIME type string that exists as a key in {@link POSSIBLE_MIME_TYPES}.
+     *
+     * @returns The first supported MIME type for `MediaRecorder`, or `null` if:
+     * - `MediaRecorder` is unavailable, or
+     * - no configured MIME types are supported.
+     *
+     * ⚠️ Important: `MediaRecorder` support ≠ `<audio>` playback support
+     *
+     * Some browsers/platforms can claim support for recording a format (notably WebM/Opus)
+     * but still fail to play the resulting Blob through the native HTML audio pipeline.
+     * This mismatch is especially likely on Safari/iOS / WKWebView variants, so the default
+     * behavior also probes `HTMLAudioElement.canPlayType(type)` when available.
+     *
+     * Selection policy when playback probing is enabled:
+     * - keep the global priority order from {@link POSSIBLE_MIME_TYPES}
+     * - among recordable types, prefer the first `"probably"` playable candidate
+     * - otherwise return the first `"maybe"` playable candidate
+     * - treat `""` as not playable
+     *
+     * Note: The <audio> element is never attached to the DOM, so it won't appear to users or assistive tech.
+     *
+     * Fallback behavior:
+     * - If `document` / `audio.canPlayType` is unavailable (e.g. SSR-like environments),
+     *   this falls back to record-only probing.
+     */
+    static getSupportedMimeType<T extends keyof typeof POSSIBLE_MIME_TYPES>(options?: {
+        requirePlaybackSupport?: boolean;
+    }): T | null;
     /** Initializes MediaRecorder and wires up handlers. */
     private onSuccessfullyStartedRecording;
     /** Handles failures from getUserMedia. */

package/dist/esm/platform/web/VoiceRecorderImpl.js

@@ -2,13 +2,51 @@ import { Filesystem } from '@capacitor/filesystem';
 import write_blob from 'capacitor-blob-writer';
 import getBlobDuration from './get-blob-duration';
 import { alreadyRecordingError, couldNotQueryPermissionStatusError, deviceCannotVoiceRecordError, emptyRecordingError, failedToFetchRecordingError, failedToRecordError, failureResponse, missingPermissionError, recordingHasNotStartedError, successResponse, } from './predefined-web-responses';
-/** Preferred MIME types to probe in order of fallback. */
+/**
+ * Ordered MIME types to probe for audio recording via `MediaRecorder.isTypeSupported()`.
+ *
+ * ⚠️ The order is intentional and MUST remain stable unless you also update the
+ * selection policy in code and test on Safari/iOS + WebViews.
+ *
+ * ✅ What this list is used for
+ * - Selecting a `mimeType` for `new MediaRecorder(stream, { mimeType })`.
+ *
+ * ❌ What this list does NOT guarantee
+ * - It does NOT guarantee that the recorded output will be playable via the
+ *   HTML `<audio>` element in the same browser.
+ *
+ * Real-world caveat (important):
+ * - We have observed cases where `MediaRecorder.isTypeSupported('audio/webm;codecs=opus')`
+ *   returned `true`, the recorder produced a Blob, but `<audio>` could not play it.
+ *   This can happen due to container/codec playback support differences, platform
+ *   quirks (especially Safari/iOS / WKWebView), or incomplete WebM playback support.
+ *
+ * Current selection behavior in this implementation:
+ * - By default, MIME selection treats recorder support and playback support as separate
+ *   capabilities and probes both:
+ *   - Recorder capability: `MediaRecorder.isTypeSupported(type)`
+ *   - Playback capability: `audio.canPlayType(type)`
+ * - This default can be disabled via `RecordingOptions.requirePlaybackSupport = false`
+ *   to fall back to recorder-only probing.
+ *
+ * Keeping legacy keys:
+ * - Some entries are kept even if they overlap (e.g. `audio/mp4` and explicit codec),
+ *   to maximize compatibility across differing browser implementations.
+ */
 const POSSIBLE_MIME_TYPES = {
-    'audio/aac': '.aac',
-    'audio/webm;codecs=opus': '.ogg',
-    'audio/mp4': '.mp3',
-    'audio/webm': '.ogg',
-    'audio/ogg;codecs=opus': '.ogg',
+    // ✅ Most universal
+    'audio/mp4;codecs="mp4a.40.2"': '.m4a', // AAC in MP4 (explicit codec helps detection)
+    'audio/mp4': '.m4a', // (legacy key kept; broad support)
+    'audio/aac': '.aac', // (legacy key kept; less common in the wild)
+    'audio/mpeg': '.mp3', // MP3 (universal)
+    'audio/wav': '.wav', // WAV (universal, big files)
+    // ✅ Modern high-quality (very widely supported, but slightly less “universal” than MP3/AAC)
+    'audio/webm;codecs="opus"': '.webm', // Opus in WebM (explicit codec helps detection)
+    'audio/webm;codecs=opus': '.webm', // (legacy key kept)
+    'audio/webm': '.webm', // (legacy key kept; container-only, codec-dependent)
+    // ⚠️ Least universal (Safari/iOS historically the limiting factor)
+    'audio/ogg;codecs=opus': '.ogg', // (legacy key kept)
+    'audio/ogg;codecs=vorbis': '.ogg', // Ogg Vorbis (weakest mainstream support)
 };
 /** Creates a promise that never resolves. */
 const neverResolvingPromise = () => new Promise(() => undefined);
@@ -17,27 +55,47 @@ export class VoiceRecorderImpl {
     constructor() {
         /** Active MediaRecorder instance, if recording. */
         this.mediaRecorder = null;
+        /** MIME type selected at start time for the active recording. */
+        this.activeMimeType = null;
         /** Collected data chunks from MediaRecorder. */
         this.chunks = [];
         /** Promise resolved when the recorder stops and payload is ready. */
         this.pendingResult = neverResolvingPromise();
     }
-    /** Returns whether the browser can start a recording session. */
-    static async canDeviceVoiceRecord() {
+    /**
+     * Returns whether the browser can start a recording session.
+     *
+     * On web this checks:
+     * - `navigator.mediaDevices.getUserMedia`
+     * - at least one supported recording MIME type using {@link getSupportedMimeType}
+     *
+     * The optional `requirePlaybackSupport` flag is forwarded to MIME selection and defaults
+     * to `true` when omitted.
+     */
+    static async canDeviceVoiceRecord(options) {
         var _a;
-        if (((_a = navigator === null || navigator === void 0 ? void 0 : navigator.mediaDevices) === null || _a === void 0 ? void 0 : _a.getUserMedia) == null || VoiceRecorderImpl.getSupportedMimeType() == null) {
+        if (((_a = navigator === null || navigator === void 0 ? void 0 : navigator.mediaDevices) === null || _a === void 0 ? void 0 : _a.getUserMedia) == null ||
+            VoiceRecorderImpl.getSupportedMimeType({
+                requirePlaybackSupport: options === null || options === void 0 ? void 0 : options.requirePlaybackSupport,
+            }) == null) {
             return failureResponse();
         }
         else {
             return successResponse();
         }
     }
-    /** Starts a recording session using MediaRecorder. */
+    /**
+     * Starts a recording session using `MediaRecorder`.
+     *
+     * The selected MIME type is resolved once at start time (using the optional
+     * `requirePlaybackSupport` flag from `RecordingOptions`) and reused for the final Blob
+     * and file extension to keep the recording payload internally consistent.
+     */
     async startRecording(options) {
         if (this.mediaRecorder != null) {
             throw alreadyRecordingError();
         }
-        const deviceCanRecord = await VoiceRecorderImpl.canDeviceVoiceRecord();
+        const deviceCanRecord = await VoiceRecorderImpl.canDeviceVoiceRecord(options);
         if (!deviceCanRecord.value) {
             throw deviceCannotVoiceRecordError();
         }
@@ -139,30 +197,97 @@ export class VoiceRecorderImpl {
             return Promise.resolve({ status: 'NONE' });
         }
     }
-    /** Returns the first supported MIME type, if any. */
-    static getSupportedMimeType() {
+    /**
+     * Returns the first MIME type (key of {@link POSSIBLE_MIME_TYPES}) that the current
+     * environment reports as supported for recording via `MediaRecorder.isTypeSupported()`,
+     * optionally requiring native HTML `<audio>` playback support too.
+     *
+     * The search order is the iteration order of {@link POSSIBLE_MIME_TYPES}.
+     *
+     * @typeParam T - A MIME type string that exists as a key in {@link POSSIBLE_MIME_TYPES}.
+     *
+     * @returns The first supported MIME type for `MediaRecorder`, or `null` if:
+     * - `MediaRecorder` is unavailable, or
+     * - no configured MIME types are supported.
+     *
+     * ⚠️ Important: `MediaRecorder` support ≠ `<audio>` playback support
+     *
+     * Some browsers/platforms can claim support for recording a format (notably WebM/Opus)
+     * but still fail to play the resulting Blob through the native HTML audio pipeline.
+     * This mismatch is especially likely on Safari/iOS / WKWebView variants, so the default
+     * behavior also probes `HTMLAudioElement.canPlayType(type)` when available.
+     *
+     * Selection policy when playback probing is enabled:
+     * - keep the global priority order from {@link POSSIBLE_MIME_TYPES}
+     * - among recordable types, prefer the first `"probably"` playable candidate
+     * - otherwise return the first `"maybe"` playable candidate
+     * - treat `""` as not playable
+     *
+     * Note: The <audio> element is never attached to the DOM, so it won't appear to users or assistive tech.
+     *
+     * Fallback behavior:
+     * - If `document` / `audio.canPlayType` is unavailable (e.g. SSR-like environments),
+     *   this falls back to record-only probing.
+     */
+    static getSupportedMimeType(options) {
+        var _a, _b, _c, _d, _e;
         if ((MediaRecorder === null || MediaRecorder === void 0 ? void 0 : MediaRecorder.isTypeSupported) == null)
             return null;
-        const foundSupportedType = Object.keys(POSSIBLE_MIME_TYPES).find((type) => MediaRecorder.isTypeSupported(type));
-        return foundSupportedType !== null && foundSupportedType !== void 0 ? foundSupportedType : null;
+        const orderedTypes = Object.keys(POSSIBLE_MIME_TYPES);
+        const recordSupportedTypes = orderedTypes.filter((type) => MediaRecorder.isTypeSupported(type));
+        if (recordSupportedTypes.length === 0)
+            return null;
+        const requirePlaybackSupport = (_a = options === null || options === void 0 ? void 0 : options.requirePlaybackSupport) !== null && _a !== void 0 ? _a : VoiceRecorderImpl.DEFAULT_REQUIRE_PLAYBACK_SUPPORT;
+        if (!requirePlaybackSupport) {
+            return (_b = recordSupportedTypes[0]) !== null && _b !== void 0 ? _b : null;
+        }
+        if (typeof document === 'undefined' || typeof document.createElement !== 'function') {
+            return (_c = recordSupportedTypes[0]) !== null && _c !== void 0 ? _c : null;
+        }
+        const audioElement = document.createElement('audio');
+        if (typeof audioElement.canPlayType !== 'function') {
+            return (_d = recordSupportedTypes[0]) !== null && _d !== void 0 ? _d : null;
+        }
+        let firstProbably = null;
+        let firstMaybe = null;
+        for (const type of recordSupportedTypes) {
+            const playbackSupport = audioElement.canPlayType(type);
+            if (playbackSupport === 'probably') {
+                firstProbably = type;
+                break;
+            }
+            if (playbackSupport === 'maybe' && firstMaybe == null) {
+                firstMaybe = type;
+            }
+        }
+        return (_e = firstProbably !== null && firstProbably !== void 0 ? firstProbably : firstMaybe) !== null && _e !== void 0 ? _e : null;
     }
     /** Initializes MediaRecorder and wires up handlers. */
     onSuccessfullyStartedRecording(stream, options) {
         this.pendingResult = new Promise((resolve, reject) => {
-            this.mediaRecorder = new MediaRecorder(stream);
+            const mimeType = VoiceRecorderImpl.getSupportedMimeType({
+                requirePlaybackSupport: options === null || options === void 0 ? void 0 : options.requirePlaybackSupport,
+            });
+            if (mimeType == null) {
+                this.prepareInstanceForNextOperation();
+                reject(failedToRecordError());
+                return;
+            }
+            this.activeMimeType = mimeType;
+            this.mediaRecorder = new MediaRecorder(stream, { mimeType });
             this.mediaRecorder.onerror = () => {
                 this.prepareInstanceForNextOperation();
                 reject(failedToRecordError());
             };
             this.mediaRecorder.onstop = async () => {
                 var _a, _b, _c;
-                const mimeType = VoiceRecorderImpl.getSupportedMimeType();
-                if (mimeType == null) {
+                const finalMimeType = this.activeMimeType;
+                if (finalMimeType == null) {
                     this.prepareInstanceForNextOperation();
                     reject(failedToFetchRecordingError());
                     return;
                 }
-                const blobVoiceRecording = new Blob(this.chunks, { type: mimeType });
+                const blobVoiceRecording = new Blob(this.chunks, { type: finalMimeType });
                 if (blobVoiceRecording.size <= 0) {
                     this.prepareInstanceForNextOperation();
                     reject(emptyRecordingError());
@@ -172,7 +297,7 @@ export class VoiceRecorderImpl {
                 let recordDataBase64 = '';
                 if (options === null || options === void 0 ? void 0 : options.directory) {
                     const subDirectory = (_c = (_b = (_a = options.subDirectory) === null || _a === void 0 ? void 0 : _a.match(/^\/?(.+[^/])\/?$/)) === null || _b === void 0 ? void 0 : _b[1]) !== null && _c !== void 0 ? _c : '';
-                    const path = `${subDirectory}/recording-${new Date().getTime()}${POSSIBLE_MIME_TYPES[mimeType]}`;
+                    const path = `${subDirectory}/recording-${new Date().getTime()}${POSSIBLE_MIME_TYPES[finalMimeType]}`;
                     await write_blob({
                         blob: blobVoiceRecording,
                         directory: options.directory,
@@ -187,7 +312,14 @@ export class VoiceRecorderImpl {
                 }
                 const recordingDuration = await getBlobDuration(blobVoiceRecording);
                 this.prepareInstanceForNextOperation();
-                resolve({ value: { recordDataBase64, mimeType, msDuration: recordingDuration * 1000, uri } });
+                resolve({
+                    value: {
+                        recordDataBase64,
+                        mimeType: finalMimeType,
+                        msDuration: recordingDuration * 1000,
+                        uri
+                    }
+                });
             };
             this.mediaRecorder.ondataavailable = (event) => this.chunks.push(event.data);
             this.mediaRecorder.start();
@@ -224,7 +356,10 @@ export class VoiceRecorderImpl {
         }
         this.pendingResult = neverResolvingPromise();
         this.mediaRecorder = null;
+        this.activeMimeType = null;
         this.chunks = [];
     }
 }
+/** Default behavior for web MIME selection: require recorder + playback support. */
+VoiceRecorderImpl.DEFAULT_REQUIRE_PLAYBACK_SUPPORT = true;
 //# sourceMappingURL=VoiceRecorderImpl.js.map

package/dist/esm/platform/web/VoiceRecorderImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"VoiceRecorderImpl.js","sourceRoot":"","sources":["../../../../src/platform/web/VoiceRecorderImpl.ts"],"names":[],"mappings":"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","sourcesContent":["import {Filesystem} from '@capacitor/filesystem';\nimport write_blob from 'capacitor-blob-writer';\n\nimport type {\n    Base64String,\n    CurrentRecordingStatus,\n    GenericResponse,\n    RecordingData,\n    RecordingOptions,\n} from '../../definitions';\n\nimport getBlobDuration from './get-blob-duration';\nimport {\n    alreadyRecordingError,\n    couldNotQueryPermissionStatusError,\n    deviceCannotVoiceRecordError,\n    emptyRecordingError,\n    failedToFetchRecordingError,\n    failedToRecordError,\n    failureResponse,\n    missingPermissionError,\n    recordingHasNotStartedError,\n    successResponse,\n} from './predefined-web-responses';\n\n/** Preferred MIME types to probe in order of fallback. */\nconst POSSIBLE_MIME_TYPES = {\n    'audio/aac': '.aac',\n    'audio/webm;codecs=opus': '.ogg',\n    'audio/mp4': '.mp3',\n    'audio/webm': '.ogg',\n    'audio/ogg;codecs=opus': '.ogg',\n};\n\n/** Creates a promise that never resolves. */\nconst neverResolvingPromise = (): Promise<any> => new Promise(() => undefined);\n\n/** Browser implementation backed by MediaRecorder and Capacitor Filesystem. */\nexport class VoiceRecorderImpl {\n    /** Active MediaRecorder instance, if recording. */\n    private mediaRecorder: MediaRecorder | null = null;\n    /** Collected data chunks from MediaRecorder. */\n    private chunks: any[] = [];\n    /** Promise resolved when the recorder stops and payload is ready. */\n    private pendingResult: Promise<RecordingData> = neverResolvingPromise();\n\n    /** Returns whether the browser can start a recording session. */\n    public static async canDeviceVoiceRecord(): Promise<GenericResponse> {\n        if (navigator?.mediaDevices?.getUserMedia == null || VoiceRecorderImpl.getSupportedMimeType() == null) {\n            return failureResponse();\n        } else {\n            return successResponse();\n        }\n    }\n\n    /** Starts a recording session using MediaRecorder. */\n    public async startRecording(options?: RecordingOptions): Promise<GenericResponse> {\n        if (this.mediaRecorder != null) {\n            throw alreadyRecordingError();\n        }\n        const deviceCanRecord = await VoiceRecorderImpl.canDeviceVoiceRecord();\n        if (!deviceCanRecord.value) {\n            throw deviceCannotVoiceRecordError();\n        }\n        const havingPermission = await VoiceRecorderImpl.hasAudioRecordingPermission().catch(() => successResponse());\n        if (!havingPermission.value) {\n            throw missingPermissionError();\n        }\n\n        return navigator.mediaDevices\n            .getUserMedia({audio: true})\n            .then((stream) => this.onSuccessfullyStartedRecording(stream, options))\n            .catch(this.onFailedToStartRecording.bind(this));\n    }\n\n    /** Stops the current recording and resolves the pending payload. */\n    public async stopRecording(): Promise<RecordingData> {\n        if (this.mediaRecorder == null) {\n            throw recordingHasNotStartedError();\n        }\n        try {\n            this.mediaRecorder.stop();\n            this.mediaRecorder.stream.getTracks().forEach((track) => track.stop());\n            return this.pendingResult;\n        } catch (ignore) {\n            throw failedToFetchRecordingError();\n        } finally {\n            this.prepareInstanceForNextOperation();\n        }\n    }\n\n    /** Returns whether the browser has microphone permission. */\n    public static async hasAudioRecordingPermission(): Promise<GenericResponse> {\n        // Safari does not support navigator.permissions.query\n        if (!navigator.permissions.query) {\n            if (navigator.mediaDevices !== undefined) {\n                return navigator.mediaDevices\n                    .getUserMedia({audio: true})\n                    .then(() => successResponse())\n                    .catch(() => {\n                        throw couldNotQueryPermissionStatusError();\n                    });\n            }\n        }\n        return navigator.permissions\n            .query({name: 'microphone' as any})\n            .then((result) => ({value: result.state === 'granted'}))\n            .catch(() => {\n                throw couldNotQueryPermissionStatusError();\n            });\n    }\n\n    /** Requests microphone permission from the browser. */\n    public static async requestAudioRecordingPermission(): Promise<GenericResponse> {\n        const havingPermission = await VoiceRecorderImpl.hasAudioRecordingPermission().catch(() => failureResponse());\n        if (havingPermission.value) {\n            return successResponse();\n        }\n\n        return navigator.mediaDevices\n            .getUserMedia({audio: true})\n            .then(() => successResponse())\n            .catch(() => failureResponse());\n    }\n\n    /** Pauses the recording session when supported. */\n    public pauseRecording(): Promise<GenericResponse> {\n        if (this.mediaRecorder == null) {\n            throw recordingHasNotStartedError();\n        } else if (this.mediaRecorder.state === 'recording') {\n            this.mediaRecorder.pause();\n            return Promise.resolve(successResponse());\n        } else {\n            return Promise.resolve(failureResponse());\n        }\n    }\n\n    /** Resumes a paused recording session when supported. */\n    public resumeRecording(): Promise<GenericResponse> {\n        if (this.mediaRecorder == null) {\n            throw recordingHasNotStartedError();\n        } else if (this.mediaRecorder.state === 'paused') {\n            this.mediaRecorder.resume();\n            return Promise.resolve(successResponse());\n        } else {\n            return Promise.resolve(failureResponse());\n        }\n    }\n\n    /** Returns the current recording status from MediaRecorder. */\n    public getCurrentStatus(): Promise<CurrentRecordingStatus> {\n        if (this.mediaRecorder == null) {\n            return Promise.resolve({status: 'NONE'});\n        } else if (this.mediaRecorder.state === 'recording') {\n            return Promise.resolve({status: 'RECORDING'});\n        } else if (this.mediaRecorder.state === 'paused') {\n            return Promise.resolve({status: 'PAUSED'});\n        } else {\n            return Promise.resolve({status: 'NONE'});\n        }\n    }\n\n    /** Returns the first supported MIME type, if any. */\n    public static getSupportedMimeType<T extends keyof typeof POSSIBLE_MIME_TYPES>(): T | null {\n        if (MediaRecorder?.isTypeSupported == null) return null;\n\n        const foundSupportedType = Object.keys(POSSIBLE_MIME_TYPES).find((type) => MediaRecorder.isTypeSupported(type)) as\n            | T\n            | undefined;\n\n        return foundSupportedType ?? null;\n    }\n\n    /** Initializes MediaRecorder and wires up handlers. */\n    private onSuccessfullyStartedRecording(stream: MediaStream, options?: RecordingOptions): GenericResponse {\n        this.pendingResult = new Promise((resolve, reject) => {\n            this.mediaRecorder = new MediaRecorder(stream);\n            this.mediaRecorder.onerror = () => {\n                this.prepareInstanceForNextOperation();\n                reject(failedToRecordError());\n            };\n            this.mediaRecorder.onstop = async () => {\n                const mimeType = VoiceRecorderImpl.getSupportedMimeType();\n                if (mimeType == null) {\n                    this.prepareInstanceForNextOperation();\n                    reject(failedToFetchRecordingError());\n                    return;\n                }\n                const blobVoiceRecording = new Blob(this.chunks, {type: mimeType});\n                if (blobVoiceRecording.size <= 0) {\n                    this.prepareInstanceForNextOperation();\n                    reject(emptyRecordingError());\n                    return;\n                }\n\n                let uri: string | undefined = undefined;\n                let recordDataBase64 = '';\n                if (options?.directory) {\n                    const subDirectory = options.subDirectory?.match(/^\\/?(.+[^/])\\/?$/)?.[1] ?? '';\n                    const path = `${subDirectory}/recording-${new Date().getTime()}${POSSIBLE_MIME_TYPES[mimeType]}`;\n\n                    await write_blob({\n                        blob: blobVoiceRecording,\n                        directory: options.directory,\n                        fast_mode: true,\n                        path,\n                        recursive: true,\n                    });\n\n                    ({uri} = await Filesystem.getUri({directory: options.directory, path}));\n                } else {\n                    recordDataBase64 = await VoiceRecorderImpl.blobToBase64(blobVoiceRecording);\n                }\n\n                const recordingDuration = await getBlobDuration(blobVoiceRecording);\n                this.prepareInstanceForNextOperation();\n                resolve({value: {recordDataBase64, mimeType, msDuration: recordingDuration * 1000, uri}});\n            };\n            this.mediaRecorder.ondataavailable = (event: any) => this.chunks.push(event.data);\n            this.mediaRecorder.start();\n        });\n        return successResponse();\n    }\n\n    /** Handles failures from getUserMedia. */\n    private onFailedToStartRecording(): GenericResponse {\n        this.prepareInstanceForNextOperation();\n        throw failedToRecordError();\n    }\n\n    /** Converts a Blob payload into a base64 string. */\n    private static blobToBase64(blob: Blob): Promise<Base64String> {\n        return new Promise((resolve) => {\n            const reader = new FileReader();\n            reader.onloadend = () => {\n                const recordingResult = String(reader.result);\n                const splitResult = recordingResult.split('base64,');\n                const toResolve = splitResult.length > 1 ? splitResult[1] : recordingResult;\n                resolve(toResolve.trim());\n            };\n            reader.readAsDataURL(blob);\n        });\n    }\n\n    /** Resets state for the next recording attempt. */\n    private prepareInstanceForNextOperation(): void {\n        if (this.mediaRecorder != null && this.mediaRecorder.state === 'recording') {\n            try {\n                this.mediaRecorder.stop();\n            } catch (ignore) {\n                console.warn('Failed to stop recording during cleanup');\n            }\n        }\n        this.pendingResult = neverResolvingPromise();\n        this.mediaRecorder = null;\n        this.chunks = [];\n    }\n}\n"]}
+{"version":3,"file":"VoiceRecorderImpl.js","sourceRoot":"","sources":["../../../../src/platform/web/VoiceRecorderImpl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,uBAAuB,CAAC;AACjD,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAU/C,OAAO,eAAe,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACH,qBAAqB,EACrB,kCAAkC,EAClC,4BAA4B,EAC5B,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,2BAA2B,EAC3B,eAAe,GAClB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,mBAAmB,GAA2B;IAChD,mBAAmB;IACnB,8BAA8B,EAAE,MAAM,EAAO,8CAA8C;IAC3F,WAAW,EAAE,MAAM,EAA0B,mCAAmC;IAChF,WAAW,EAAE,MAAM,EAA0B,6CAA6C;IAC1F,YAAY,EAAE,MAAM,EAAyB,kBAAkB;IAC/D,WAAW,EAAE,MAAM,EAA0B,6BAA6B;IAE1E,4FAA4F;IAC5F,0BAA0B,EAAE,OAAO,EAAU,gDAAgD;IAC7F,wBAAwB,EAAE,OAAO,EAAY,oBAAoB;IACjE,YAAY,EAAE,OAAO,EAAwB,qDAAqD;IAElG,mEAAmE;IACnE,uBAAuB,EAAE,MAAM,EAAc,oBAAoB;IACjE,yBAAyB,EAAE,MAAM,EAAY,0CAA0C;CAC1F,CAAC;AAEF,6CAA6C;AAC7C,MAAM,qBAAqB,GAAG,GAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAE/E,+EAA+E;AAC/E,MAAM,OAAO,iBAAiB;IAA9B;QAGI,mDAAmD;QAC3C,kBAAa,GAAyB,IAAI,CAAC;QACnD,iEAAiE;QACzD,mBAAc,GAA4C,IAAI,CAAC;QACvE,gDAAgD;QACxC,WAAM,GAAU,EAAE,CAAC;QAC3B,qEAAqE;QAC7D,kBAAa,GAA2B,qBAAqB,EAAE,CAAC;IA2T5E,CAAC;IAzTG;;;;;;;;;OASG;IACI,MAAM,CAAC,KAAK,CAAC,oBAAoB,CACpC,OAA0D;;QAE1D,IACI,CAAA,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,YAAY,0CAAE,YAAY,KAAI,IAAI;YAC7C,iBAAiB,CAAC,oBAAoB,CAAC;gBACnC,sBAAsB,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,sBAAsB;aAC1D,CAAC,IAAI,IAAI,EACZ,CAAC;YACC,OAAO,eAAe,EAAE,CAAC;QAC7B,CAAC;aAAM,CAAC;YACJ,OAAO,eAAe,EAAE,CAAC;QAC7B,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,cAAc,CAAC,OAA0B;QAClD,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,qBAAqB,EAAE,CAAC;QAClC,CAAC;QACD,MAAM,eAAe,GAAG,MAAM,iBAAiB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC9E,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YACzB,MAAM,4BAA4B,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,gBAAgB,GAAG,MAAM,iBAAiB,CAAC,2BAA2B,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC;QAC9G,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;YAC1B,MAAM,sBAAsB,EAAE,CAAC;QACnC,CAAC;QAED,OAAO,SAAS,CAAC,YAAY;aACxB,YAAY,CAAC,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC;aAC3B,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;aACtE,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,oEAAoE;IAC7D,KAAK,CAAC,aAAa;QACtB,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,2BAA2B,EAAE,CAAC;QACxC,CAAC;QACD,IAAI,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACvE,OAAO,IAAI,CAAC,aAAa,CAAC;QAC9B,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YACd,MAAM,2BAA2B,EAAE,CAAC;QACxC,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,+BAA+B,EAAE,CAAC;QAC3C,CAAC;IACL,CAAC;IAED,6DAA6D;IACtD,MAAM,CAAC,KAAK,CAAC,2BAA2B;QAC3C,sDAAsD;QACtD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,SAAS,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACvC,OAAO,SAAS,CAAC,YAAY;qBACxB,YAAY,CAAC,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC;qBAC3B,IAAI,CAAC,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC;qBAC7B,KAAK,CAAC,GAAG,EAAE;oBACR,MAAM,kCAAkC,EAAE,CAAC;gBAC/C,CAAC,CAAC,CAAC;YACX,CAAC;QACL,CAAC;QACD,OAAO,SAAS,CAAC,WAAW;aACvB,KAAK,CAAC,EAAC,IAAI,EAAE,YAAmB,EAAC,CAAC;aAClC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAC,KAAK,EAAE,MAAM,CAAC,KAAK,KAAK,SAAS,EAAC,CAAC,CAAC;aACvD,KAAK,CAAC,GAAG,EAAE;YACR,MAAM,kCAAkC,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC;IACX,CAAC;IAED,uDAAuD;IAChD,MAAM,CAAC,KAAK,CAAC,+BAA+B;QAC/C,MAAM,gBAAgB,GAAG,MAAM,iBAAiB,CAAC,2BAA2B,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC;QAC9G,IAAI,gBAAgB,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,eAAe,EAAE,CAAC;QAC7B,CAAC;QAED,OAAO,SAAS,CAAC,YAAY;aACxB,YAAY,CAAC,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC;aAC3B,IAAI,CAAC,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC;aAC7B,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,mDAAmD;IAC5C,cAAc;QACjB,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,2BAA2B,EAAE,CAAC;QACxC,CAAC;aAAM,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAClD,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACJ,OAAO,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC;IAED,yDAAyD;IAClD,eAAe;QAClB,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,2BAA2B,EAAE,CAAC;QACxC,CAAC;aAAM,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/C,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;YAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACJ,OAAO,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC;IAED,+DAA+D;IACxD,gBAAgB;QACnB,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAC,MAAM,EAAE,MAAM,EAAC,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAClD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAC,MAAM,EAAE,WAAW,EAAC,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,EAAC,MAAM,EAAE,QAAQ,EAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACJ,OAAO,OAAO,CAAC,OAAO,CAAC,EAAC,MAAM,EAAE,MAAM,EAAC,CAAC,CAAC;QAC7C,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACI,MAAM,CAAC,oBAAoB,CAC9B,OAA8C;;QAE9C,IAAI,CAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,eAAe,KAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QAExD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAQ,CAAC;QAC7D,MAAM,oBAAoB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QAChG,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEnD,MAAM,sBAAsB,GACxB,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,sBAAsB,mCAAI,iBAAiB,CAAC,gCAAgC,CAAC;QAC1F,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAC1B,OAAO,MAAA,oBAAoB,CAAC,CAAC,CAAC,mCAAI,IAAI,CAAC;QAC3C,CAAC;QAED,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,OAAO,QAAQ,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;YAClF,OAAO,MAAA,oBAAoB,CAAC,CAAC,CAAC,mCAAI,IAAI,CAAC;QAC3C,CAAC;QAED,MAAM,YAAY,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAA8B,CAAC;QAClF,IAAI,OAAO,YAAY,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YACjD,OAAO,MAAA,oBAAoB,CAAC,CAAC,CAAC,mCAAI,IAAI,CAAC;QAC3C,CAAC;QAED,IAAI,aAAa,GAAa,IAAI,CAAC;QACnC,IAAI,UAAU,GAAa,IAAI,CAAC;QAEhC,KAAK,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;YACtC,MAAM,eAAe,GAAG,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACvD,IAAI,eAAe,KAAK,UAAU,EAAE,CAAC;gBACjC,aAAa,GAAG,IAAI,CAAC;gBACrB,MAAM;YACV,CAAC;YACD,IAAI,eAAe,KAAK,OAAO,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;gBACpD,UAAU,GAAG,IAAI,CAAC;YACtB,CAAC;QACL,CAAC;QAED,OAAO,MAAA,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,UAAU,mCAAI,IAAI,CAAC;IAC/C,CAAC;IAED,uDAAuD;IAC/C,8BAA8B,CAAC,MAAmB,EAAE,OAA0B;QAClF,IAAI,CAAC,aAAa,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACjD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,oBAAoB,CAAC;gBACpD,sBAAsB,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,sBAAsB;aAC1D,CAAC,CAAC;YACH,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;gBACnB,IAAI,CAAC,+BAA+B,EAAE,CAAC;gBACvC,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;gBAC9B,OAAO;YACX,CAAC;YAED,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;YAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,EAAC,QAAQ,EAAC,CAAC,CAAC;YAC3D,IAAI,CAAC,aAAa,CAAC,OAAO,GAAG,GAAG,EAAE;gBAC9B,IAAI,CAAC,+BAA+B,EAAE,CAAC;gBACvC,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;YAClC,CAAC,CAAC;YACF,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,KAAK,IAAI,EAAE;;gBACnC,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC;gBAC1C,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;oBACxB,IAAI,CAAC,+BAA+B,EAAE,CAAC;oBACvC,MAAM,CAAC,2BAA2B,EAAE,CAAC,CAAC;oBACtC,OAAO;gBACX,CAAC;gBACD,MAAM,kBAAkB,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAC,IAAI,EAAE,aAAa,EAAC,CAAC,CAAC;gBACxE,IAAI,kBAAkB,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;oBAC/B,IAAI,CAAC,+BAA+B,EAAE,CAAC;oBACvC,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;oBAC9B,OAAO;gBACX,CAAC;gBAED,IAAI,GAAG,GAAuB,SAAS,CAAC;gBACxC,IAAI,gBAAgB,GAAG,EAAE,CAAC;gBAC1B,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS,EAAE,CAAC;oBACrB,MAAM,YAAY,GAAG,MAAA,MAAA,MAAA,OAAO,CAAC,YAAY,0CAAE,KAAK,CAAC,kBAAkB,CAAC,0CAAG,CAAC,CAAC,mCAAI,EAAE,CAAC;oBAChF,MAAM,IAAI,GAAG,GAAG,YAAY,cAAc,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,mBAAmB,CAAC,aAAa,CAAC,EAAE,CAAC;oBAEtG,MAAM,UAAU,CAAC;wBACb,IAAI,EAAE,kBAAkB;wBACxB,SAAS,EAAE,OAAO,CAAC,SAAS;wBAC5B,SAAS,EAAE,IAAI;wBACf,IAAI;wBACJ,SAAS,EAAE,IAAI;qBAClB,CAAC,CAAC;oBAEH,CAAC,EAAC,GAAG,EAAC,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,EAAC,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC,CAAC;gBAC5E,CAAC;qBAAM,CAAC;oBACJ,gBAAgB,GAAG,MAAM,iBAAiB,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;gBAChF,CAAC;gBAED,MAAM,iBAAiB,GAAG,MAAM,eAAe,CAAC,kBAAkB,CAAC,CAAC;gBACpE,IAAI,CAAC,+BAA+B,EAAE,CAAC;gBACvC,OAAO,CAAC;oBACJ,KAAK,EAAE;wBACH,gBAAgB;wBAChB,QAAQ,EAAE,aAAa;wBACvB,UAAU,EAAE,iBAAiB,GAAG,IAAI;wBACpC,GAAG;qBACN;iBACJ,CAAC,CAAC;YACP,CAAC,CAAC;YACF,IAAI,CAAC,aAAa,CAAC,eAAe,GAAG,CAAC,KAAU,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClF,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;QACH,OAAO,eAAe,EAAE,CAAC;IAC7B,CAAC;IAED,0CAA0C;IAClC,wBAAwB;QAC5B,IAAI,CAAC,+BAA+B,EAAE,CAAC;QACvC,MAAM,mBAAmB,EAAE,CAAC;IAChC,CAAC;IAED,oDAAoD;IAC5C,MAAM,CAAC,YAAY,CAAC,IAAU;QAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAChC,MAAM,CAAC,SAAS,GAAG,GAAG,EAAE;gBACpB,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC9C,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACrD,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;gBAC5E,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9B,CAAC,CAAC;YACF,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACP,CAAC;IAED,mDAAmD;IAC3C,+BAA+B;QACnC,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YACzE,IAAI,CAAC;gBACD,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YAC9B,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;YAC5D,CAAC;QACL,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,qBAAqB,EAAE,CAAC;QAC7C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACrB,CAAC;;AAnUD,oFAAoF;AAC5D,kDAAgC,GAAG,IAAI,AAAP,CAAQ","sourcesContent":["import {Filesystem} from '@capacitor/filesystem';\nimport write_blob from 'capacitor-blob-writer';\n\nimport type {\n    Base64String,\n    CurrentRecordingStatus,\n    GenericResponse,\n    RecordingData,\n    RecordingOptions,\n} from '../../definitions';\n\nimport getBlobDuration from './get-blob-duration';\nimport {\n    alreadyRecordingError,\n    couldNotQueryPermissionStatusError,\n    deviceCannotVoiceRecordError,\n    emptyRecordingError,\n    failedToFetchRecordingError,\n    failedToRecordError,\n    failureResponse,\n    missingPermissionError,\n    recordingHasNotStartedError,\n    successResponse,\n} from './predefined-web-responses';\n\n/**\n * Ordered MIME types to probe for audio recording via `MediaRecorder.isTypeSupported()`.\n *\n * ⚠️ The order is intentional and MUST remain stable unless you also update the\n * selection policy in code and test on Safari/iOS + WebViews.\n *\n * ✅ What this list is used for\n * - Selecting a `mimeType` for `new MediaRecorder(stream, { mimeType })`.\n *\n * ❌ What this list does NOT guarantee\n * - It does NOT guarantee that the recorded output will be playable via the\n *   HTML `<audio>` element in the same browser.\n *\n * Real-world caveat (important):\n * - We have observed cases where `MediaRecorder.isTypeSupported('audio/webm;codecs=opus')`\n *   returned `true`, the recorder produced a Blob, but `<audio>` could not play it.\n *   This can happen due to container/codec playback support differences, platform\n *   quirks (especially Safari/iOS / WKWebView), or incomplete WebM playback support.\n *\n * Current selection behavior in this implementation:\n * - By default, MIME selection treats recorder support and playback support as separate\n *   capabilities and probes both:\n *   - Recorder capability: `MediaRecorder.isTypeSupported(type)`\n *   - Playback capability: `audio.canPlayType(type)`\n * - This default can be disabled via `RecordingOptions.requirePlaybackSupport = false`\n *   to fall back to recorder-only probing.\n *\n * Keeping legacy keys:\n * - Some entries are kept even if they overlap (e.g. `audio/mp4` and explicit codec),\n *   to maximize compatibility across differing browser implementations.\n */\nconst POSSIBLE_MIME_TYPES: Record<string, string> = {\n    // ✅ Most universal\n    'audio/mp4;codecs=\"mp4a.40.2\"': '.m4a',      // AAC in MP4 (explicit codec helps detection)\n    'audio/mp4': '.m4a',                         // (legacy key kept; broad support)\n    'audio/aac': '.aac',                         // (legacy key kept; less common in the wild)\n    'audio/mpeg': '.mp3',                        // MP3 (universal)\n    'audio/wav': '.wav',                         // WAV (universal, big files)\n\n    // ✅ Modern high-quality (very widely supported, but slightly less “universal” than MP3/AAC)\n    'audio/webm;codecs=\"opus\"': '.webm',         // Opus in WebM (explicit codec helps detection)\n    'audio/webm;codecs=opus': '.webm',           // (legacy key kept)\n    'audio/webm': '.webm',                       // (legacy key kept; container-only, codec-dependent)\n\n    // ⚠️ Least universal (Safari/iOS historically the limiting factor)\n    'audio/ogg;codecs=opus': '.ogg',             // (legacy key kept)\n    'audio/ogg;codecs=vorbis': '.ogg',           // Ogg Vorbis (weakest mainstream support)\n};\n\n/** Creates a promise that never resolves. */\nconst neverResolvingPromise = (): Promise<any> => new Promise(() => undefined);\n\n/** Browser implementation backed by MediaRecorder and Capacitor Filesystem. */\nexport class VoiceRecorderImpl {\n    /** Default behavior for web MIME selection: require recorder + playback support. */\n    private static readonly DEFAULT_REQUIRE_PLAYBACK_SUPPORT = true;\n    /** Active MediaRecorder instance, if recording. */\n    private mediaRecorder: MediaRecorder | null = null;\n    /** MIME type selected at start time for the active recording. */\n    private activeMimeType: keyof typeof POSSIBLE_MIME_TYPES | null = null;\n    /** Collected data chunks from MediaRecorder. */\n    private chunks: any[] = [];\n    /** Promise resolved when the recorder stops and payload is ready. */\n    private pendingResult: Promise<RecordingData> = neverResolvingPromise();\n\n    /**\n     * Returns whether the browser can start a recording session.\n     *\n     * On web this checks:\n     * - `navigator.mediaDevices.getUserMedia`\n     * - at least one supported recording MIME type using {@link getSupportedMimeType}\n     *\n     * The optional `requirePlaybackSupport` flag is forwarded to MIME selection and defaults\n     * to `true` when omitted.\n     */\n    public static async canDeviceVoiceRecord(\n        options?: Pick<RecordingOptions, 'requirePlaybackSupport'>,\n    ): Promise<GenericResponse> {\n        if (\n            navigator?.mediaDevices?.getUserMedia == null ||\n            VoiceRecorderImpl.getSupportedMimeType({\n                requirePlaybackSupport: options?.requirePlaybackSupport,\n            }) == null\n        ) {\n            return failureResponse();\n        } else {\n            return successResponse();\n        }\n    }\n\n    /**\n     * Starts a recording session using `MediaRecorder`.\n     *\n     * The selected MIME type is resolved once at start time (using the optional\n     * `requirePlaybackSupport` flag from `RecordingOptions`) and reused for the final Blob\n     * and file extension to keep the recording payload internally consistent.\n     */\n    public async startRecording(options?: RecordingOptions): Promise<GenericResponse> {\n        if (this.mediaRecorder != null) {\n            throw alreadyRecordingError();\n        }\n        const deviceCanRecord = await VoiceRecorderImpl.canDeviceVoiceRecord(options);\n        if (!deviceCanRecord.value) {\n            throw deviceCannotVoiceRecordError();\n        }\n        const havingPermission = await VoiceRecorderImpl.hasAudioRecordingPermission().catch(() => successResponse());\n        if (!havingPermission.value) {\n            throw missingPermissionError();\n        }\n\n        return navigator.mediaDevices\n            .getUserMedia({audio: true})\n            .then((stream) => this.onSuccessfullyStartedRecording(stream, options))\n            .catch(this.onFailedToStartRecording.bind(this));\n    }\n\n    /** Stops the current recording and resolves the pending payload. */\n    public async stopRecording(): Promise<RecordingData> {\n        if (this.mediaRecorder == null) {\n            throw recordingHasNotStartedError();\n        }\n        try {\n            this.mediaRecorder.stop();\n            this.mediaRecorder.stream.getTracks().forEach((track) => track.stop());\n            return this.pendingResult;\n        } catch (ignore) {\n            throw failedToFetchRecordingError();\n        } finally {\n            this.prepareInstanceForNextOperation();\n        }\n    }\n\n    /** Returns whether the browser has microphone permission. */\n    public static async hasAudioRecordingPermission(): Promise<GenericResponse> {\n        // Safari does not support navigator.permissions.query\n        if (!navigator.permissions.query) {\n            if (navigator.mediaDevices !== undefined) {\n                return navigator.mediaDevices\n                    .getUserMedia({audio: true})\n                    .then(() => successResponse())\n                    .catch(() => {\n                        throw couldNotQueryPermissionStatusError();\n                    });\n            }\n        }\n        return navigator.permissions\n            .query({name: 'microphone' as any})\n            .then((result) => ({value: result.state === 'granted'}))\n            .catch(() => {\n                throw couldNotQueryPermissionStatusError();\n            });\n    }\n\n    /** Requests microphone permission from the browser. */\n    public static async requestAudioRecordingPermission(): Promise<GenericResponse> {\n        const havingPermission = await VoiceRecorderImpl.hasAudioRecordingPermission().catch(() => failureResponse());\n        if (havingPermission.value) {\n            return successResponse();\n        }\n\n        return navigator.mediaDevices\n            .getUserMedia({audio: true})\n            .then(() => successResponse())\n            .catch(() => failureResponse());\n    }\n\n    /** Pauses the recording session when supported. */\n    public pauseRecording(): Promise<GenericResponse> {\n        if (this.mediaRecorder == null) {\n            throw recordingHasNotStartedError();\n        } else if (this.mediaRecorder.state === 'recording') {\n            this.mediaRecorder.pause();\n            return Promise.resolve(successResponse());\n        } else {\n            return Promise.resolve(failureResponse());\n        }\n    }\n\n    /** Resumes a paused recording session when supported. */\n    public resumeRecording(): Promise<GenericResponse> {\n        if (this.mediaRecorder == null) {\n            throw recordingHasNotStartedError();\n        } else if (this.mediaRecorder.state === 'paused') {\n            this.mediaRecorder.resume();\n            return Promise.resolve(successResponse());\n        } else {\n            return Promise.resolve(failureResponse());\n        }\n    }\n\n    /** Returns the current recording status from MediaRecorder. */\n    public getCurrentStatus(): Promise<CurrentRecordingStatus> {\n        if (this.mediaRecorder == null) {\n            return Promise.resolve({status: 'NONE'});\n        } else if (this.mediaRecorder.state === 'recording') {\n            return Promise.resolve({status: 'RECORDING'});\n        } else if (this.mediaRecorder.state === 'paused') {\n            return Promise.resolve({status: 'PAUSED'});\n        } else {\n            return Promise.resolve({status: 'NONE'});\n        }\n    }\n\n    /**\n     * Returns the first MIME type (key of {@link POSSIBLE_MIME_TYPES}) that the current\n     * environment reports as supported for recording via `MediaRecorder.isTypeSupported()`,\n     * optionally requiring native HTML `<audio>` playback support too.\n     *\n     * The search order is the iteration order of {@link POSSIBLE_MIME_TYPES}.\n     *\n     * @typeParam T - A MIME type string that exists as a key in {@link POSSIBLE_MIME_TYPES}.\n     *\n     * @returns The first supported MIME type for `MediaRecorder`, or `null` if:\n     * - `MediaRecorder` is unavailable, or\n     * - no configured MIME types are supported.\n     *\n     * ⚠️ Important: `MediaRecorder` support ≠ `<audio>` playback support\n     *\n     * Some browsers/platforms can claim support for recording a format (notably WebM/Opus)\n     * but still fail to play the resulting Blob through the native HTML audio pipeline.\n     * This mismatch is especially likely on Safari/iOS / WKWebView variants, so the default\n     * behavior also probes `HTMLAudioElement.canPlayType(type)` when available.\n     *\n     * Selection policy when playback probing is enabled:\n     * - keep the global priority order from {@link POSSIBLE_MIME_TYPES}\n     * - among recordable types, prefer the first `\"probably\"` playable candidate\n     * - otherwise return the first `\"maybe\"` playable candidate\n     * - treat `\"\"` as not playable\n     *\n     * Note: The <audio> element is never attached to the DOM, so it won't appear to users or assistive tech.\n     *\n     * Fallback behavior:\n     * - If `document` / `audio.canPlayType` is unavailable (e.g. SSR-like environments),\n     *   this falls back to record-only probing.\n     */\n    public static getSupportedMimeType<T extends keyof typeof POSSIBLE_MIME_TYPES>(\n        options?: { requirePlaybackSupport?: boolean },\n    ): T | null {\n        if (MediaRecorder?.isTypeSupported == null) return null;\n\n        const orderedTypes = Object.keys(POSSIBLE_MIME_TYPES) as T[];\n        const recordSupportedTypes = orderedTypes.filter((type) => MediaRecorder.isTypeSupported(type));\n        if (recordSupportedTypes.length === 0) return null;\n\n        const requirePlaybackSupport =\n            options?.requirePlaybackSupport ?? VoiceRecorderImpl.DEFAULT_REQUIRE_PLAYBACK_SUPPORT;\n        if (!requirePlaybackSupport) {\n            return recordSupportedTypes[0] ?? null;\n        }\n\n        if (typeof document === 'undefined' || typeof document.createElement !== 'function') {\n            return recordSupportedTypes[0] ?? null;\n        }\n\n        const audioElement = document.createElement('audio') as Partial<HTMLAudioElement>;\n        if (typeof audioElement.canPlayType !== 'function') {\n            return recordSupportedTypes[0] ?? null;\n        }\n\n        let firstProbably: T | null = null;\n        let firstMaybe: T | null = null;\n\n        for (const type of recordSupportedTypes) {\n            const playbackSupport = audioElement.canPlayType(type);\n            if (playbackSupport === 'probably') {\n                firstProbably = type;\n                break;\n            }\n            if (playbackSupport === 'maybe' && firstMaybe == null) {\n                firstMaybe = type;\n            }\n        }\n\n        return firstProbably ?? firstMaybe ?? null;\n    }\n\n    /** Initializes MediaRecorder and wires up handlers. */\n    private onSuccessfullyStartedRecording(stream: MediaStream, options?: RecordingOptions): GenericResponse {\n        this.pendingResult = new Promise((resolve, reject) => {\n            const mimeType = VoiceRecorderImpl.getSupportedMimeType({\n                requirePlaybackSupport: options?.requirePlaybackSupport,\n            });\n            if (mimeType == null) {\n                this.prepareInstanceForNextOperation();\n                reject(failedToRecordError());\n                return;\n            }\n\n            this.activeMimeType = mimeType;\n            this.mediaRecorder = new MediaRecorder(stream, {mimeType});\n            this.mediaRecorder.onerror = () => {\n                this.prepareInstanceForNextOperation();\n                reject(failedToRecordError());\n            };\n            this.mediaRecorder.onstop = async () => {\n                const finalMimeType = this.activeMimeType;\n                if (finalMimeType == null) {\n                    this.prepareInstanceForNextOperation();\n                    reject(failedToFetchRecordingError());\n                    return;\n                }\n                const blobVoiceRecording = new Blob(this.chunks, {type: finalMimeType});\n                if (blobVoiceRecording.size <= 0) {\n                    this.prepareInstanceForNextOperation();\n                    reject(emptyRecordingError());\n                    return;\n                }\n\n                let uri: string | undefined = undefined;\n                let recordDataBase64 = '';\n                if (options?.directory) {\n                    const subDirectory = options.subDirectory?.match(/^\\/?(.+[^/])\\/?$/)?.[1] ?? '';\n                    const path = `${subDirectory}/recording-${new Date().getTime()}${POSSIBLE_MIME_TYPES[finalMimeType]}`;\n\n                    await write_blob({\n                        blob: blobVoiceRecording,\n                        directory: options.directory,\n                        fast_mode: true,\n                        path,\n                        recursive: true,\n                    });\n\n                    ({uri} = await Filesystem.getUri({directory: options.directory, path}));\n                } else {\n                    recordDataBase64 = await VoiceRecorderImpl.blobToBase64(blobVoiceRecording);\n                }\n\n                const recordingDuration = await getBlobDuration(blobVoiceRecording);\n                this.prepareInstanceForNextOperation();\n                resolve({\n                    value: {\n                        recordDataBase64,\n                        mimeType: finalMimeType,\n                        msDuration: recordingDuration * 1000,\n                        uri\n                    }\n                });\n            };\n            this.mediaRecorder.ondataavailable = (event: any) => this.chunks.push(event.data);\n            this.mediaRecorder.start();\n        });\n        return successResponse();\n    }\n\n    /** Handles failures from getUserMedia. */\n    private onFailedToStartRecording(): GenericResponse {\n        this.prepareInstanceForNextOperation();\n        throw failedToRecordError();\n    }\n\n    /** Converts a Blob payload into a base64 string. */\n    private static blobToBase64(blob: Blob): Promise<Base64String> {\n        return new Promise((resolve) => {\n            const reader = new FileReader();\n            reader.onloadend = () => {\n                const recordingResult = String(reader.result);\n                const splitResult = recordingResult.split('base64,');\n                const toResolve = splitResult.length > 1 ? splitResult[1] : recordingResult;\n                resolve(toResolve.trim());\n            };\n            reader.readAsDataURL(blob);\n        });\n    }\n\n    /** Resets state for the next recording attempt. */\n    private prepareInstanceForNextOperation(): void {\n        if (this.mediaRecorder != null && this.mediaRecorder.state === 'recording') {\n            try {\n                this.mediaRecorder.stop();\n            } catch (ignore) {\n                console.warn('Failed to stop recording during cleanup');\n            }\n        }\n        this.pendingResult = neverResolvingPromise();\n        this.mediaRecorder = null;\n        this.activeMimeType = null;\n        this.chunks = [];\n    }\n}\n"]}