@independo/capacitor-voice-recorder 8.1.0-dev.1 → 8.1.0-dev.2

package/dist/esm/{VoiceRecorderImpl.js → platform/web/VoiceRecorderImpl.js}

@@ -1,8 +1,8 @@
 import { Filesystem } from '@capacitor/filesystem';
 import write_blob from 'capacitor-blob-writer';
-import getBlobDuration from "./helper/get-blob-duration";
+import getBlobDuration from './get-blob-duration';
 import { alreadyRecordingError, couldNotQueryPermissionStatusError, deviceCannotVoiceRecordError, emptyRecordingError, failedToFetchRecordingError, failedToRecordError, failureResponse, missingPermissionError, recordingHasNotStartedError, successResponse, } from './predefined-web-responses';
-// these mime types will be checked one by one in order until one of them is found to be supported by the current browser
+/** Preferred MIME types to probe in order of fallback. */
 const POSSIBLE_MIME_TYPES = {
     'audio/aac': '.aac',
     'audio/webm;codecs=opus': '.ogg',
@@ -10,13 +10,19 @@ const POSSIBLE_MIME_TYPES = {
     'audio/webm': '.ogg',
     'audio/ogg;codecs=opus': '.ogg',
 };
+/** Creates a promise that never resolves. */
 const neverResolvingPromise = () => new Promise(() => undefined);
+/** Browser implementation backed by MediaRecorder and Capacitor Filesystem. */
 export class VoiceRecorderImpl {
     constructor() {
+        /** Active MediaRecorder instance, if recording. */
         this.mediaRecorder = 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() {
         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) {
@@ -26,6 +32,7 @@ export class VoiceRecorderImpl {
             return successResponse();
         }
     }
+    /** Starts a recording session using MediaRecorder. */
     async startRecording(options) {
         if (this.mediaRecorder != null) {
             throw alreadyRecordingError();
@@ -43,6 +50,7 @@ export class VoiceRecorderImpl {
             .then((stream) => this.onSuccessfullyStartedRecording(stream, options))
             .catch(this.onFailedToStartRecording.bind(this));
     }
+    /** Stops the current recording and resolves the pending payload. */
     async stopRecording() {
         if (this.mediaRecorder == null) {
             throw recordingHasNotStartedError();
@@ -59,6 +67,7 @@ export class VoiceRecorderImpl {
             this.prepareInstanceForNextOperation();
         }
     }
+    /** Returns whether the browser has microphone permission. */
     static async hasAudioRecordingPermission() {
         // Safari does not support navigator.permissions.query
         if (!navigator.permissions.query) {
@@ -78,6 +87,7 @@ export class VoiceRecorderImpl {
             throw couldNotQueryPermissionStatusError();
         });
     }
+    /** Requests microphone permission from the browser. */
     static async requestAudioRecordingPermission() {
         const havingPermission = await VoiceRecorderImpl.hasAudioRecordingPermission().catch(() => failureResponse());
         if (havingPermission.value) {
@@ -88,6 +98,7 @@ export class VoiceRecorderImpl {
             .then(() => successResponse())
             .catch(() => failureResponse());
     }
+    /** Pauses the recording session when supported. */
     pauseRecording() {
         if (this.mediaRecorder == null) {
             throw recordingHasNotStartedError();
@@ -100,6 +111,7 @@ export class VoiceRecorderImpl {
             return Promise.resolve(failureResponse());
         }
     }
+    /** Resumes a paused recording session when supported. */
     resumeRecording() {
         if (this.mediaRecorder == null) {
             throw recordingHasNotStartedError();
@@ -112,6 +124,7 @@ export class VoiceRecorderImpl {
             return Promise.resolve(failureResponse());
         }
     }
+    /** Returns the current recording status from MediaRecorder. */
     getCurrentStatus() {
         if (this.mediaRecorder == null) {
             return Promise.resolve({ status: 'NONE' });
@@ -126,12 +139,14 @@ export class VoiceRecorderImpl {
             return Promise.resolve({ status: 'NONE' });
         }
     }
+    /** Returns the first supported MIME type, if any. */
     static getSupportedMimeType() {
         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;
     }
+    /** Initializes MediaRecorder and wires up handlers. */
     onSuccessfullyStartedRecording(stream, options) {
         this.pendingResult = new Promise((resolve, reject) => {
             this.mediaRecorder = new MediaRecorder(stream);
@@ -179,10 +194,12 @@ export class VoiceRecorderImpl {
         });
         return successResponse();
     }
+    /** Handles failures from getUserMedia. */
     onFailedToStartRecording() {
         this.prepareInstanceForNextOperation();
         throw failedToRecordError();
     }
+    /** Converts a Blob payload into a base64 string. */
     static blobToBase64(blob) {
         return new Promise((resolve) => {
             const reader = new FileReader();
@@ -195,6 +212,7 @@ export class VoiceRecorderImpl {
             reader.readAsDataURL(blob);
         });
     }
+    /** Resets state for the next recording attempt. */
     prepareInstanceForNextOperation() {
         if (this.mediaRecorder != null && this.mediaRecorder.state === 'recording') {
             try {

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

@@ -0,0 +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"]}

package/dist/esm/platform/web/get-blob-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-blob-duration.js","sourceRoot":"","sources":["../../../../src/platform/web/get-blob-duration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,IAAmB;IACvD,MAAM,WAAW,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtD,WAAW,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,GAAG,EAAE;YAChD,2EAA2E;YAC3E,IAAI,WAAW,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACpC,WAAW,CAAC,WAAW,GAAG,MAAM,CAAC,gBAAgB,CAAC;gBAClD,WAAW,CAAC,YAAY,GAAG,GAAG,EAAE;oBAC5B,WAAW,CAAC,YAAY,GAAG,IAAI,CAAC;oBAChC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;oBAC9B,WAAW,CAAC,WAAW,GAAG,CAAC,CAAC;gBAChC,CAAC,CAAC;YACN,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,WAAW,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;YAC5B,MAAM,KAAK,GAAI,KAAoB,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACjF,MAAM,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,WAAW,CAAC,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAE9E,OAAO,SAAS,CAAC;AACrB,CAAC","sourcesContent":["/**\n * @param {Blob | string} blob\n * @returns {Promise<number>} Blob duration in seconds.\n */\nexport default function getBlobDuration(blob: Blob | string): Promise<number> {\n    const tempVideoEl = document.createElement('video');\n    if (!tempVideoEl) throw new Error('Failed to create video element');\n    const durationP = new Promise<number>((resolve, reject) => {\n        tempVideoEl.addEventListener('loadedmetadata', () => {\n            // Chrome bug: https://bugs.chromium.org/p/chromium/issues/detail?id=642012\n            if (tempVideoEl.duration === Infinity) {\n                tempVideoEl.currentTime = Number.MAX_SAFE_INTEGER;\n                tempVideoEl.ontimeupdate = () => {\n                    tempVideoEl.ontimeupdate = null;\n                    resolve(tempVideoEl.duration);\n                    tempVideoEl.currentTime = 0;\n                };\n            } else {\n                resolve(tempVideoEl.duration);\n            }\n        });\n\n        tempVideoEl.onerror = (event) => {\n            const error = (event as ErrorEvent).error || new Error('Unknown error occurred');\n            reject(error);\n        };\n    });\n\n    tempVideoEl.src = typeof blob === 'string' ? blob : URL.createObjectURL(blob);\n\n    return durationP;\n}\n"]}

package/dist/esm/{predefined-web-responses.d.ts → platform/web/predefined-web-responses.d.ts}

@@ -1,12 +1,23 @@
-import type { GenericResponse } from './definitions';
+import type { GenericResponse } from '../../definitions';
+/** Success wrapper for boolean plugin responses. */
 export declare const successResponse: () => GenericResponse;
+/** Failure wrapper for boolean plugin responses. */
 export declare const failureResponse: () => GenericResponse;
+/** Error for missing microphone permission. */
 export declare const missingPermissionError: () => Error;
+/** Error for attempting to start while already recording. */
 export declare const alreadyRecordingError: () => Error;
+/** Error for microphone in use by another app or recorder. */
 export declare const microphoneBeingUsedError: () => Error;
+/** Error for devices that cannot record audio. */
 export declare const deviceCannotVoiceRecordError: () => Error;
+/** Error for recorder start failures. */
 export declare const failedToRecordError: () => Error;
+/** Error for empty or zero-length recordings. */
 export declare const emptyRecordingError: () => Error;
+/** Error for stopping without an active recording. */
 export declare const recordingHasNotStartedError: () => Error;
+/** Error for failures when fetching recording data. */
 export declare const failedToFetchRecordingError: () => Error;
+/** Error for browsers that do not support permission queries. */
 export declare const couldNotQueryPermissionStatusError: () => Error;

package/dist/esm/{predefined-web-responses.js → platform/web/predefined-web-responses.js}

@@ -1,12 +1,23 @@
+/** Success wrapper for boolean plugin responses. */
 export const successResponse = () => ({ value: true });
+/** Failure wrapper for boolean plugin responses. */
 export const failureResponse = () => ({ value: false });
+/** Error for missing microphone permission. */
 export const missingPermissionError = () => new Error('MISSING_PERMISSION');
+/** Error for attempting to start while already recording. */
 export const alreadyRecordingError = () => new Error('ALREADY_RECORDING');
+/** Error for microphone in use by another app or recorder. */
 export const microphoneBeingUsedError = () => new Error('MICROPHONE_BEING_USED');
+/** Error for devices that cannot record audio. */
 export const deviceCannotVoiceRecordError = () => new Error('DEVICE_CANNOT_VOICE_RECORD');
+/** Error for recorder start failures. */
 export const failedToRecordError = () => new Error('FAILED_TO_RECORD');
+/** Error for empty or zero-length recordings. */
 export const emptyRecordingError = () => new Error('EMPTY_RECORDING');
+/** Error for stopping without an active recording. */
 export const recordingHasNotStartedError = () => new Error('RECORDING_HAS_NOT_STARTED');
+/** Error for failures when fetching recording data. */
 export const failedToFetchRecordingError = () => new Error('FAILED_TO_FETCH_RECORDING');
+/** Error for browsers that do not support permission queries. */
 export const couldNotQueryPermissionStatusError = () => new Error('COULD_NOT_QUERY_PERMISSION_STATUS');
 //# sourceMappingURL=predefined-web-responses.js.map

package/dist/esm/platform/web/predefined-web-responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predefined-web-responses.js","sourceRoot":"","sources":["../../../../src/platform/web/predefined-web-responses.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAoB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACxE,oDAAoD;AACpD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAoB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAEzE,+CAA+C;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAU,EAAE,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;AACnF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAU,EAAE,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;AACjF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAU,EAAE,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;AACxF,kDAAkD;AAClD,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAU,EAAE,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;AACjG,yCAAyC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAU,EAAE,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;AAC9E,iDAAiD;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAU,EAAE,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;AAE7E,sDAAsD;AACtD,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAU,EAAE,CAAC,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;AAC/F,uDAAuD;AACvD,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAU,EAAE,CAAC,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;AAE/F,iEAAiE;AACjE,MAAM,CAAC,MAAM,kCAAkC,GAAG,GAAU,EAAE,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC","sourcesContent":["import type { GenericResponse } from '../../definitions';\n\n/** Success wrapper for boolean plugin responses. */\nexport const successResponse = (): GenericResponse => ({ value: true });\n/** Failure wrapper for boolean plugin responses. */\nexport const failureResponse = (): GenericResponse => ({ value: false });\n\n/** Error for missing microphone permission. */\nexport const missingPermissionError = (): Error => new Error('MISSING_PERMISSION');\n/** Error for attempting to start while already recording. */\nexport const alreadyRecordingError = (): Error => new Error('ALREADY_RECORDING');\n/** Error for microphone in use by another app or recorder. */\nexport const microphoneBeingUsedError = (): Error => new Error('MICROPHONE_BEING_USED');\n/** Error for devices that cannot record audio. */\nexport const deviceCannotVoiceRecordError = (): Error => new Error('DEVICE_CANNOT_VOICE_RECORD');\n/** Error for recorder start failures. */\nexport const failedToRecordError = (): Error => new Error('FAILED_TO_RECORD');\n/** Error for empty or zero-length recordings. */\nexport const emptyRecordingError = (): Error => new Error('EMPTY_RECORDING');\n\n/** Error for stopping without an active recording. */\nexport const recordingHasNotStartedError = (): Error => new Error('RECORDING_HAS_NOT_STARTED');\n/** Error for failures when fetching recording data. */\nexport const failedToFetchRecordingError = (): Error => new Error('FAILED_TO_FETCH_RECORDING');\n\n/** Error for browsers that do not support permission queries. */\nexport const couldNotQueryPermissionStatusError = (): Error => new Error('COULD_NOT_QUERY_PERMISSION_STATUS');\n"]}

package/dist/esm/service/VoiceRecorderService.d.ts

@@ -0,0 +1,47 @@
+import type { ResponseFormat } from '../core/response-format';
+import type { CurrentRecordingStatus, GenericResponse, RecordingData, RecordingOptions } from '../definitions';
+/** Platform abstraction used by the service layer. */
+export interface VoiceRecorderPlatform {
+    /** Checks whether the device can record audio. */
+    canDeviceVoiceRecord(): Promise<GenericResponse>;
+    /** Returns whether microphone permission is currently granted. */
+    hasAudioRecordingPermission(): Promise<GenericResponse>;
+    /** Requests microphone permission from the user. */
+    requestAudioRecordingPermission(): Promise<GenericResponse>;
+    /** Starts a recording session. */
+    startRecording(options?: RecordingOptions): Promise<GenericResponse>;
+    /** Stops the current recording session and returns the payload. */
+    stopRecording(): Promise<RecordingData>;
+    /** Pauses the recording session when supported. */
+    pauseRecording(): Promise<GenericResponse>;
+    /** Resumes a paused recording session when supported. */
+    resumeRecording(): Promise<GenericResponse>;
+    /** Returns the current recording state. */
+    getCurrentStatus(): Promise<CurrentRecordingStatus>;
+}
+/** Orchestrates platform calls and normalizes responses when requested. */
+export declare class VoiceRecorderService {
+    /** Selected response format derived from plugin config. */
+    private readonly responseFormat;
+    /** Platform adapter that performs the actual recording work. */
+    private readonly platform;
+    constructor(platform: VoiceRecorderPlatform, responseFormat: ResponseFormat);
+    /** Checks whether the device can record audio. */
+    canDeviceVoiceRecord(): Promise<GenericResponse>;
+    /** Returns whether microphone permission is currently granted. */
+    hasAudioRecordingPermission(): Promise<GenericResponse>;
+    /** Requests microphone permission from the user. */
+    requestAudioRecordingPermission(): Promise<GenericResponse>;
+    /** Starts a recording session. */
+    startRecording(options?: RecordingOptions): Promise<GenericResponse>;
+    /** Stops the recording session and formats the payload if needed. */
+    stopRecording(): Promise<RecordingData>;
+    /** Pauses the recording session when supported. */
+    pauseRecording(): Promise<GenericResponse>;
+    /** Resumes a paused recording session when supported. */
+    resumeRecording(): Promise<GenericResponse>;
+    /** Returns the current recording state. */
+    getCurrentStatus(): Promise<CurrentRecordingStatus>;
+    /** Wraps calls to apply canonical error codes when requested. */
+    private execute;
+}

package/dist/esm/service/VoiceRecorderService.js

@@ -0,0 +1,60 @@
+import { attachCanonicalErrorCode } from '../core/error-codes';
+import { normalizeRecordingData } from '../core/recording-contract';
+/** Orchestrates platform calls and normalizes responses when requested. */
+export class VoiceRecorderService {
+    constructor(platform, responseFormat) {
+        this.platform = platform;
+        this.responseFormat = responseFormat;
+    }
+    /** Checks whether the device can record audio. */
+    canDeviceVoiceRecord() {
+        return this.execute(() => this.platform.canDeviceVoiceRecord());
+    }
+    /** Returns whether microphone permission is currently granted. */
+    hasAudioRecordingPermission() {
+        return this.execute(() => this.platform.hasAudioRecordingPermission());
+    }
+    /** Requests microphone permission from the user. */
+    requestAudioRecordingPermission() {
+        return this.execute(() => this.platform.requestAudioRecordingPermission());
+    }
+    /** Starts a recording session. */
+    startRecording(options) {
+        return this.execute(() => this.platform.startRecording(options));
+    }
+    /** Stops the recording session and formats the payload if needed. */
+    async stopRecording() {
+        return this.execute(async () => {
+            const data = await this.platform.stopRecording();
+            if (this.responseFormat === 'normalized') {
+                return normalizeRecordingData(data);
+            }
+            return data;
+        });
+    }
+    /** Pauses the recording session when supported. */
+    pauseRecording() {
+        return this.execute(() => this.platform.pauseRecording());
+    }
+    /** Resumes a paused recording session when supported. */
+    resumeRecording() {
+        return this.execute(() => this.platform.resumeRecording());
+    }
+    /** Returns the current recording state. */
+    getCurrentStatus() {
+        return this.execute(() => this.platform.getCurrentStatus());
+    }
+    /** Wraps calls to apply canonical error codes when requested. */
+    async execute(fn) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            if (this.responseFormat === 'normalized') {
+                attachCanonicalErrorCode(error);
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=VoiceRecorderService.js.map

package/dist/esm/service/VoiceRecorderService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceRecorderService.js","sourceRoot":"","sources":["../../../src/service/VoiceRecorderService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AA6BpE,2EAA2E;AAC3E,MAAM,OAAO,oBAAoB;IAM7B,YAAmB,QAA+B,EAAE,cAA8B;QAC9E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACzC,CAAC;IAED,kDAAkD;IAC3C,oBAAoB;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,kEAAkE;IAC3D,2BAA2B;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,2BAA2B,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,oDAAoD;IAC7C,+BAA+B;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,+BAA+B,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,kCAAkC;IAC3B,cAAc,CAAC,OAA0B;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,qEAAqE;IAC9D,KAAK,CAAC,aAAa;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;YACjD,IAAI,IAAI,CAAC,cAAc,KAAK,YAAY,EAAE,CAAC;gBACvC,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,IAAI,CAAC;QAChB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,mDAAmD;IAC5C,cAAc;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,yDAAyD;IAClD,eAAe;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,2CAA2C;IACpC,gBAAgB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,iEAAiE;IACzD,KAAK,CAAC,OAAO,CAAI,EAAoB;QACzC,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,cAAc,KAAK,YAAY,EAAE,CAAC;gBACvC,wBAAwB,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;CACJ","sourcesContent":["import { attachCanonicalErrorCode } from '../core/error-codes';\nimport { normalizeRecordingData } from '../core/recording-contract';\nimport type { ResponseFormat } from '../core/response-format';\nimport type {\n    CurrentRecordingStatus,\n    GenericResponse,\n    RecordingData,\n    RecordingOptions,\n} from '../definitions';\n\n/** Platform abstraction used by the service layer. */\nexport interface VoiceRecorderPlatform {\n    /** Checks whether the device can record audio. */\n    canDeviceVoiceRecord(): Promise<GenericResponse>;\n    /** Returns whether microphone permission is currently granted. */\n    hasAudioRecordingPermission(): Promise<GenericResponse>;\n    /** Requests microphone permission from the user. */\n    requestAudioRecordingPermission(): Promise<GenericResponse>;\n    /** Starts a recording session. */\n    startRecording(options?: RecordingOptions): Promise<GenericResponse>;\n    /** Stops the current recording session and returns the payload. */\n    stopRecording(): Promise<RecordingData>;\n    /** Pauses the recording session when supported. */\n    pauseRecording(): Promise<GenericResponse>;\n    /** Resumes a paused recording session when supported. */\n    resumeRecording(): Promise<GenericResponse>;\n    /** Returns the current recording state. */\n    getCurrentStatus(): Promise<CurrentRecordingStatus>;\n}\n\n/** Orchestrates platform calls and normalizes responses when requested. */\nexport class VoiceRecorderService {\n    /** Selected response format derived from plugin config. */\n    private readonly responseFormat: ResponseFormat;\n    /** Platform adapter that performs the actual recording work. */\n    private readonly platform: VoiceRecorderPlatform;\n\n    public constructor(platform: VoiceRecorderPlatform, responseFormat: ResponseFormat) {\n        this.platform = platform;\n        this.responseFormat = responseFormat;\n    }\n\n    /** Checks whether the device can record audio. */\n    public canDeviceVoiceRecord(): Promise<GenericResponse> {\n        return this.execute(() => this.platform.canDeviceVoiceRecord());\n    }\n\n    /** Returns whether microphone permission is currently granted. */\n    public hasAudioRecordingPermission(): Promise<GenericResponse> {\n        return this.execute(() => this.platform.hasAudioRecordingPermission());\n    }\n\n    /** Requests microphone permission from the user. */\n    public requestAudioRecordingPermission(): Promise<GenericResponse> {\n        return this.execute(() => this.platform.requestAudioRecordingPermission());\n    }\n\n    /** Starts a recording session. */\n    public startRecording(options?: RecordingOptions): Promise<GenericResponse> {\n        return this.execute(() => this.platform.startRecording(options));\n    }\n\n    /** Stops the recording session and formats the payload if needed. */\n    public async stopRecording(): Promise<RecordingData> {\n        return this.execute(async () => {\n            const data = await this.platform.stopRecording();\n            if (this.responseFormat === 'normalized') {\n                return normalizeRecordingData(data);\n            }\n            return data;\n        });\n    }\n\n    /** Pauses the recording session when supported. */\n    public pauseRecording(): Promise<GenericResponse> {\n        return this.execute(() => this.platform.pauseRecording());\n    }\n\n    /** Resumes a paused recording session when supported. */\n    public resumeRecording(): Promise<GenericResponse> {\n        return this.execute(() => this.platform.resumeRecording());\n    }\n\n    /** Returns the current recording state. */\n    public getCurrentStatus(): Promise<CurrentRecordingStatus> {\n        return this.execute(() => this.platform.getCurrentStatus());\n    }\n\n    /** Wraps calls to apply canonical error codes when requested. */\n    private async execute<T>(fn: () => Promise<T>): Promise<T> {\n        try {\n            return await fn();\n        } catch (error) {\n            if (this.responseFormat === 'normalized') {\n                attachCanonicalErrorCode(error);\n            }\n            throw error;\n        }\n    }\n}\n"]}

package/dist/esm/web.d.ts

@@ -1,13 +1,24 @@
 import { WebPlugin } from '@capacitor/core';
 import type { CurrentRecordingStatus, GenericResponse, RecordingData, RecordingOptions, VoiceRecorderPlugin } from './definitions';
+/** Web implementation of the VoiceRecorder Capacitor plugin. */
 export declare class VoiceRecorderWeb extends WebPlugin implements VoiceRecorderPlugin {
-    private voiceRecorderInstance;
+    /** Service layer that normalizes behavior and errors. */
+    private readonly service;
+    constructor();
+    /** Checks whether the browser can record audio. */
     canDeviceVoiceRecord(): Promise<GenericResponse>;
+    /** Returns whether microphone permission is currently granted. */
     hasAudioRecordingPermission(): Promise<GenericResponse>;
+    /** Requests microphone permission from the user. */
     requestAudioRecordingPermission(): Promise<GenericResponse>;
+    /** Starts a recording session. */
     startRecording(options?: RecordingOptions): Promise<GenericResponse>;
+    /** Stops the current recording session and returns the payload. */
     stopRecording(): Promise<RecordingData>;
+    /** Pauses the recording session when supported. */
     pauseRecording(): Promise<GenericResponse>;
+    /** Resumes a paused recording session when supported. */
     resumeRecording(): Promise<GenericResponse>;
+    /** Returns the current recording state. */
     getCurrentStatus(): Promise<CurrentRecordingStatus>;
 }

package/dist/esm/web.js

@@ -1,33 +1,47 @@
-import { WebPlugin } from '@capacitor/core';
-import { VoiceRecorderImpl } from './VoiceRecorderImpl';
+import { Capacitor, WebPlugin } from '@capacitor/core';
+import { VoiceRecorderWebAdapter } from './adapters/VoiceRecorderWebAdapter';
+import { getResponseFormatFromConfig } from './core/response-format';
+import { VoiceRecorderService } from './service/VoiceRecorderService';
+/** Web implementation of the VoiceRecorder Capacitor plugin. */
 export class VoiceRecorderWeb extends WebPlugin {
     constructor() {
-        super(...arguments);
-        this.voiceRecorderInstance = new VoiceRecorderImpl();
+        var _a, _b;
+        super();
+        const pluginConfig = (_b = (_a = Capacitor === null || Capacitor === void 0 ? void 0 : Capacitor.config) === null || _a === void 0 ? void 0 : _a.plugins) === null || _b === void 0 ? void 0 : _b.VoiceRecorder;
+        const responseFormat = getResponseFormatFromConfig(pluginConfig);
+        this.service = new VoiceRecorderService(new VoiceRecorderWebAdapter(), responseFormat);
     }
+    /** Checks whether the browser can record audio. */
     canDeviceVoiceRecord() {
-        return VoiceRecorderImpl.canDeviceVoiceRecord();
+        return this.service.canDeviceVoiceRecord();
     }
+    /** Returns whether microphone permission is currently granted. */
     hasAudioRecordingPermission() {
-        return VoiceRecorderImpl.hasAudioRecordingPermission();
+        return this.service.hasAudioRecordingPermission();
     }
+    /** Requests microphone permission from the user. */
     requestAudioRecordingPermission() {
-        return VoiceRecorderImpl.requestAudioRecordingPermission();
+        return this.service.requestAudioRecordingPermission();
     }
+    /** Starts a recording session. */
     startRecording(options) {
-        return this.voiceRecorderInstance.startRecording(options);
+        return this.service.startRecording(options);
     }
+    /** Stops the current recording session and returns the payload. */
     stopRecording() {
-        return this.voiceRecorderInstance.stopRecording();
+        return this.service.stopRecording();
     }
+    /** Pauses the recording session when supported. */
     pauseRecording() {
-        return this.voiceRecorderInstance.pauseRecording();
+        return this.service.pauseRecording();
     }
+    /** Resumes a paused recording session when supported. */
     resumeRecording() {
-        return this.voiceRecorderInstance.resumeRecording();
+        return this.service.resumeRecording();
     }
+    /** Returns the current recording state. */
     getCurrentStatus() {
-        return this.voiceRecorderInstance.getCurrentStatus();
+        return this.service.getCurrentStatus();
     }
 }
 //# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AASxD,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAA/C;;QACU,0BAAqB,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAiC1D,CAAC;IA/BQ,oBAAoB;QACzB,OAAO,iBAAiB,CAAC,oBAAoB,EAAE,CAAC;IAClD,CAAC;IAEM,2BAA2B;QAChC,OAAO,iBAAiB,CAAC,2BAA2B,EAAE,CAAC;IACzD,CAAC;IAEM,+BAA+B;QACpC,OAAO,iBAAiB,CAAC,+BAA+B,EAAE,CAAC;IAC7D,CAAC;IAEM,cAAc,CAAC,OAA0B;QAC9C,OAAO,IAAI,CAAC,qBAAqB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;IAEM,aAAa;QAClB,OAAO,IAAI,CAAC,qBAAqB,CAAC,aAAa,EAAE,CAAC;IACpD,CAAC;IAEM,cAAc;QACnB,OAAO,IAAI,CAAC,qBAAqB,CAAC,cAAc,EAAE,CAAC;IACrD,CAAC;IAEM,eAAe;QACpB,OAAO,IAAI,CAAC,qBAAqB,CAAC,eAAe,EAAE,CAAC;IACtD,CAAC;IAEM,gBAAgB;QACrB,OAAO,IAAI,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,CAAC;IACvD,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport { VoiceRecorderImpl } from './VoiceRecorderImpl';\nimport type {\n  CurrentRecordingStatus,\n  GenericResponse,\n  RecordingData,\n  RecordingOptions,\n  VoiceRecorderPlugin,\n} from './definitions';\n\nexport class VoiceRecorderWeb extends WebPlugin implements VoiceRecorderPlugin {\n  private voiceRecorderInstance = new VoiceRecorderImpl();\n\n  public canDeviceVoiceRecord(): Promise<GenericResponse> {\n    return VoiceRecorderImpl.canDeviceVoiceRecord();\n  }\n\n  public hasAudioRecordingPermission(): Promise<GenericResponse> {\n    return VoiceRecorderImpl.hasAudioRecordingPermission();\n  }\n\n  public requestAudioRecordingPermission(): Promise<GenericResponse> {\n    return VoiceRecorderImpl.requestAudioRecordingPermission();\n  }\n\n  public startRecording(options?: RecordingOptions): Promise<GenericResponse> {\n    return this.voiceRecorderInstance.startRecording(options);\n  }\n\n  public stopRecording(): Promise<RecordingData> {\n    return this.voiceRecorderInstance.stopRecording();\n  }\n\n  public pauseRecording(): Promise<GenericResponse> {\n    return this.voiceRecorderInstance.pauseRecording();\n  }\n\n  public resumeRecording(): Promise<GenericResponse> {\n    return this.voiceRecorderInstance.resumeRecording();\n  }\n\n  public getCurrentStatus(): Promise<CurrentRecordingStatus> {\n    return this.voiceRecorderInstance.getCurrentStatus();\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAQrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE,gEAAgE;AAChE,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAI7C;;QACE,KAAK,EAAE,CAAC;QACR,MAAM,YAAY,GAAG,MAAA,MAAC,SAAiB,aAAjB,SAAS,uBAAT,SAAS,CAAU,MAAM,0CAAE,OAAO,0CAAE,aAAa,CAAC;QACxE,MAAM,cAAc,GAAG,2BAA2B,CAAC,YAAY,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,GAAG,IAAI,oBAAoB,CAAC,IAAI,uBAAuB,EAAE,EAAE,cAAc,CAAC,CAAC;IACzF,CAAC;IAED,mDAAmD;IAC5C,oBAAoB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAC7C,CAAC;IAED,kEAAkE;IAC3D,2BAA2B;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,2BAA2B,EAAE,CAAC;IACpD,CAAC;IAED,oDAAoD;IAC7C,+BAA+B;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,+BAA+B,EAAE,CAAC;IACxD,CAAC;IAED,kCAAkC;IAC3B,cAAc,CAAC,OAA0B;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,mEAAmE;IAC5D,aAAa;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACtC,CAAC;IAED,mDAAmD;IAC5C,cAAc;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;IACvC,CAAC;IAED,yDAAyD;IAClD,eAAe;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;IACxC,CAAC;IAED,2CAA2C;IACpC,gBAAgB;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IACzC,CAAC;CACF","sourcesContent":["import { Capacitor, WebPlugin } from '@capacitor/core';\n\nimport { VoiceRecorderWebAdapter } from './adapters/VoiceRecorderWebAdapter';\nimport { getResponseFormatFromConfig } from './core/response-format';\nimport type {\n  CurrentRecordingStatus,\n  GenericResponse,\n  RecordingData,\n  RecordingOptions,\n  VoiceRecorderPlugin,\n} from './definitions';\nimport { VoiceRecorderService } from './service/VoiceRecorderService';\n\n/** Web implementation of the VoiceRecorder Capacitor plugin. */\nexport class VoiceRecorderWeb extends WebPlugin implements VoiceRecorderPlugin {\n  /** Service layer that normalizes behavior and errors. */\n  private readonly service: VoiceRecorderService;\n\n  public constructor() {\n    super();\n    const pluginConfig = (Capacitor as any)?.config?.plugins?.VoiceRecorder;\n    const responseFormat = getResponseFormatFromConfig(pluginConfig);\n    this.service = new VoiceRecorderService(new VoiceRecorderWebAdapter(), responseFormat);\n  }\n\n  /** Checks whether the browser can record audio. */\n  public canDeviceVoiceRecord(): Promise<GenericResponse> {\n    return this.service.canDeviceVoiceRecord();\n  }\n\n  /** Returns whether microphone permission is currently granted. */\n  public hasAudioRecordingPermission(): Promise<GenericResponse> {\n    return this.service.hasAudioRecordingPermission();\n  }\n\n  /** Requests microphone permission from the user. */\n  public requestAudioRecordingPermission(): Promise<GenericResponse> {\n    return this.service.requestAudioRecordingPermission();\n  }\n\n  /** Starts a recording session. */\n  public startRecording(options?: RecordingOptions): Promise<GenericResponse> {\n    return this.service.startRecording(options);\n  }\n\n  /** Stops the current recording session and returns the payload. */\n  public stopRecording(): Promise<RecordingData> {\n    return this.service.stopRecording();\n  }\n\n  /** Pauses the recording session when supported. */\n  public pauseRecording(): Promise<GenericResponse> {\n    return this.service.pauseRecording();\n  }\n\n  /** Resumes a paused recording session when supported. */\n  public resumeRecording(): Promise<GenericResponse> {\n    return this.service.resumeRecording();\n  }\n\n  /** Returns the current recording state. */\n  public getCurrentStatus(): Promise<CurrentRecordingStatus> {\n    return this.service.getCurrentStatus();\n  }\n}\n"]}