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

package/android/src/main/java/{com/tchvu3/capacitorvoicerecorder → app/independo/capacitorvoicerecorder/platform}/CustomMediaRecorder.java

@@ -1,4 +1,4 @@
-package com.tchvu3.capacitorvoicerecorder;
+package app.independo.capacitorvoicerecorder.platform;
 
 import android.content.Context;
 import android.media.AudioAttributes;
@@ -7,21 +7,34 @@ import android.media.AudioManager;
 import android.media.MediaRecorder;
 import android.os.Build;
 import android.os.Environment;
+import app.independo.capacitorvoicerecorder.adapters.RecorderAdapter;
+import app.independo.capacitorvoicerecorder.core.CurrentRecordingStatus;
+import app.independo.capacitorvoicerecorder.core.RecordOptions;
 import java.io.File;
 import java.io.IOException;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
-public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListener {
+/** MediaRecorder wrapper that manages audio focus and interruptions. */
+public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListener, RecorderAdapter {
 
+    /** Android context for file paths and system services. */
     private final Context context;
+    /** Recording options passed from the service layer. */
     private final RecordOptions options;
+    /** Active MediaRecorder instance for the session. */
     private MediaRecorder mediaRecorder;
+    /** Output file for the current recording session. */
     private File outputFile;
+    /** Current session status tracked locally. */
     private CurrentRecordingStatus currentRecordingStatus = CurrentRecordingStatus.NONE;
+    /** Audio manager for focus changes. */
     private AudioManager audioManager;
+    /** Focus request for Android O and above. */
     private AudioFocusRequest audioFocusRequest;
+    /** Callback invoked when an interruption begins. */
     private Runnable onInterruptionBegan;
+    /** Callback invoked when an interruption ends. */
     private Runnable onInterruptionEnded;
 
     public CustomMediaRecorder(Context context, RecordOptions options) throws IOException {
@@ -31,14 +44,17 @@ public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListe
         generateMediaRecorder();
     }
 
+    /** Sets the callback for interruption begin events. */
     public void setOnInterruptionBegan(Runnable callback) {
         this.onInterruptionBegan = callback;
     }
 
+    /** Sets the callback for interruption end events. */
     public void setOnInterruptionEnded(Runnable callback) {
         this.onInterruptionEnded = callback;
     }
 
+    /** Configures the MediaRecorder with audio settings. */
     private void generateMediaRecorder() throws IOException {
         mediaRecorder = new MediaRecorder();
         mediaRecorder.setAudioSource(MediaRecorder.AudioSource.MIC);
@@ -50,6 +66,7 @@ public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListe
         mediaRecorder.prepare();
     }
 
+    /** Picks a directory and allocates the output file for this session. */
     private void setRecorderOutputFile() throws IOException {
         File outputDir = context.getCacheDir();
 
@@ -79,6 +96,7 @@ public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListe
         mediaRecorder.setOutputFile(outputFile.getAbsolutePath());
     }
 
+    /** Maps directory strings to Android file locations. */
     private File getDirectory(String directory) {
         return switch (directory) {
             case "DOCUMENTS" -> Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS);
@@ -90,12 +108,14 @@ public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListe
         };
     }
 
+    /** Starts recording and requests audio focus. */
     public void startRecording() {
         requestAudioFocus();
         mediaRecorder.start();
         currentRecordingStatus = CurrentRecordingStatus.RECORDING;
     }
 
+    /** Stops recording and releases audio resources. */
     public void stopRecording() {
         if (mediaRecorder == null) {
             abandonAudioFocus();
@@ -118,14 +138,17 @@ public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListe
         }
     }
 
+    /** Returns the output file for the current session. */
     public File getOutputFile() {
         return outputFile;
     }
 
+    /** Returns the options provided at start time. */
     public RecordOptions getRecordOptions() {
         return options;
     }
 
+    /** Pauses recording when supported by the OS version. */
     public boolean pauseRecording() throws NotSupportedOsVersion {
         if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) {
             throw new NotSupportedOsVersion();
@@ -140,6 +163,7 @@ public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListe
         }
     }
 
+    /** Resumes a paused or interrupted recording session. */
     public boolean resumeRecording() throws NotSupportedOsVersion {
         if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) {
             throw new NotSupportedOsVersion();
@@ -155,18 +179,22 @@ public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListe
         }
     }
 
+    /** Returns the current recording status. */
     public CurrentRecordingStatus getCurrentStatus() {
         return currentRecordingStatus;
     }
 
+    /** Deletes the output file from disk. */
     public boolean deleteOutputFile() {
         return outputFile.delete();
     }
 
+    /** Simple capability check used for device validation. */
     public static boolean canPhoneCreateMediaRecorder(Context context) {
         return true;
     }
 
+    /** Attempts to record a short sample to validate permission and hardware. */
     private static boolean canPhoneCreateMediaRecorderWhileHavingPermission(Context context) {
         CustomMediaRecorder tempMediaRecorder = null;
         try {
@@ -181,6 +209,7 @@ public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListe
         }
     }
 
+    /** Requests audio focus for the recording session. */
     private void requestAudioFocus() {
         if (audioManager == null) {
             return;
@@ -203,6 +232,7 @@ public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListe
         }
     }
 
+    /** Releases audio focus when recording completes. */
     private void abandonAudioFocus() {
         if (audioManager == null) {
             return;
@@ -216,6 +246,7 @@ public class CustomMediaRecorder implements AudioManager.OnAudioFocusChangeListe
         }
     }
 
+    /** Handles audio focus changes as recording interruptions. */
     @Override
     public void onAudioFocusChange(int focusChange) {
         switch (focusChange) {

package/android/src/main/java/app/independo/capacitorvoicerecorder/platform/DefaultRecorderPlatform.java

@@ -0,0 +1,86 @@
+package app.independo.capacitorvoicerecorder.platform;
+
+import android.content.Context;
+import android.media.AudioManager;
+import android.media.MediaPlayer;
+import android.net.Uri;
+import android.util.Base64;
+import app.independo.capacitorvoicerecorder.adapters.RecorderAdapter;
+import app.independo.capacitorvoicerecorder.adapters.RecorderPlatform;
+import app.independo.capacitorvoicerecorder.core.RecordOptions;
+import java.io.BufferedInputStream;
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+
+/** Default Android platform adapter for recording and file IO. */
+public class DefaultRecorderPlatform implements RecorderPlatform {
+
+    /** Android context used to access system services. */
+    private final Context context;
+
+    public DefaultRecorderPlatform(Context context) {
+        this.context = context;
+    }
+
+    /** Returns whether the device can create a MediaRecorder instance. */
+    @Override
+    public boolean canDeviceVoiceRecord() {
+        return CustomMediaRecorder.canPhoneCreateMediaRecorder(context);
+    }
+
+    /** Returns true when the system audio mode indicates another recorder. */
+    @Override
+    public boolean isMicrophoneOccupied() {
+        AudioManager audioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
+        if (audioManager == null) return true;
+        return audioManager.getMode() != AudioManager.MODE_NORMAL;
+    }
+
+    /** Creates the recorder adapter for the provided options. */
+    @Override
+    public RecorderAdapter createRecorder(RecordOptions options) throws Exception {
+        return new CustomMediaRecorder(context, options);
+    }
+
+    /** Reads the recorded file as base64, returning null on failure. */
+    @Override
+    public String readFileAsBase64(File recordedFile) {
+        try (BufferedInputStream bufferedInputStream = new BufferedInputStream(new FileInputStream(recordedFile))) {
+            ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
+            byte[] buffer = new byte[8192];
+            int bytesRead;
+            while ((bytesRead = bufferedInputStream.read(buffer)) != -1) {
+                outputStream.write(buffer, 0, bytesRead);
+            }
+            return Base64.encodeToString(outputStream.toByteArray(), Base64.DEFAULT);
+        } catch (IOException exp) {
+            return null;
+        }
+    }
+
+    /** Returns the file duration in milliseconds, or -1 on failure. */
+    @Override
+    public int getDurationMs(File recordedFile) {
+        MediaPlayer mediaPlayer = null;
+        try {
+            mediaPlayer = new MediaPlayer();
+            mediaPlayer.setDataSource(recordedFile.getAbsolutePath());
+            mediaPlayer.prepare();
+            return mediaPlayer.getDuration();
+        } catch (Exception ignore) {
+            return -1;
+        } finally {
+            if (mediaPlayer != null) {
+                mediaPlayer.release();
+            }
+        }
+    }
+
+    /** Returns a file:// URI for the given recording. */
+    @Override
+    public String toUri(File recordedFile) {
+        return Uri.fromFile(recordedFile).toString();
+    }
+}

package/android/src/main/java/app/independo/capacitorvoicerecorder/platform/NotSupportedOsVersion.java

@@ -0,0 +1,4 @@
+package app.independo.capacitorvoicerecorder.platform;
+
+/** Signals that a feature is not supported on the current OS version. */
+public class NotSupportedOsVersion extends Exception {}

package/android/src/main/java/app/independo/capacitorvoicerecorder/service/VoiceRecorderService.java

@@ -0,0 +1,144 @@
+package app.independo.capacitorvoicerecorder.service;
+
+import app.independo.capacitorvoicerecorder.adapters.PermissionChecker;
+import app.independo.capacitorvoicerecorder.adapters.RecorderAdapter;
+import app.independo.capacitorvoicerecorder.adapters.RecorderPlatform;
+import app.independo.capacitorvoicerecorder.core.CurrentRecordingStatus;
+import app.independo.capacitorvoicerecorder.core.ErrorCodes;
+import app.independo.capacitorvoicerecorder.core.RecordData;
+import app.independo.capacitorvoicerecorder.core.RecordOptions;
+import app.independo.capacitorvoicerecorder.platform.NotSupportedOsVersion;
+import java.io.File;
+
+/** Service layer that orchestrates recording operations. */
+public class VoiceRecorderService {
+
+    /** Platform adapter that owns file and recorder creation. */
+    private final RecorderPlatform platform;
+    /** Permission checker injected from the bridge layer. */
+    private final PermissionChecker permissionChecker;
+    /** Current recorder instance for an active session. */
+    private RecorderAdapter recorder;
+
+    public VoiceRecorderService(RecorderPlatform platform, PermissionChecker permissionChecker) {
+        this.platform = platform;
+        this.permissionChecker = permissionChecker;
+    }
+
+    /** Returns whether the device can record audio. */
+    public boolean canDeviceVoiceRecord() {
+        return platform.canDeviceVoiceRecord();
+    }
+
+    /** Returns whether the app has microphone permission. */
+    public boolean hasAudioRecordingPermission() {
+        return permissionChecker.hasAudioPermission();
+    }
+
+    /** Starts a recording session or throws a service exception. */
+    public void startRecording(
+        RecordOptions options,
+        Runnable onInterruptionBegan,
+        Runnable onInterruptionEnded
+    ) throws VoiceRecorderServiceException {
+        if (!platform.canDeviceVoiceRecord()) {
+            throw new VoiceRecorderServiceException(ErrorCodes.DEVICE_CANNOT_VOICE_RECORD);
+        }
+
+        if (!permissionChecker.hasAudioPermission()) {
+            throw new VoiceRecorderServiceException(ErrorCodes.MISSING_PERMISSION);
+        }
+
+        if (platform.isMicrophoneOccupied()) {
+            throw new VoiceRecorderServiceException(ErrorCodes.MICROPHONE_BEING_USED);
+        }
+
+        if (recorder != null) {
+            throw new VoiceRecorderServiceException(ErrorCodes.ALREADY_RECORDING);
+        }
+
+        try {
+            recorder = platform.createRecorder(options);
+            recorder.setOnInterruptionBegan(onInterruptionBegan);
+            recorder.setOnInterruptionEnded(onInterruptionEnded);
+            recorder.startRecording();
+        } catch (Exception exp) {
+            recorder = null;
+            throw new VoiceRecorderServiceException(ErrorCodes.FAILED_TO_RECORD, exp);
+        }
+    }
+
+    /** Stops the active recording session and returns the payload. */
+    public RecordData stopRecording() throws VoiceRecorderServiceException {
+        if (recorder == null) {
+            throw new VoiceRecorderServiceException(ErrorCodes.RECORDING_HAS_NOT_STARTED);
+        }
+
+        RecordOptions options = recorder.getRecordOptions();
+
+        try {
+            recorder.stopRecording();
+            File recordedFile = recorder.getOutputFile();
+            if (recordedFile == null) {
+                throw new VoiceRecorderServiceException(ErrorCodes.FAILED_TO_FETCH_RECORDING);
+            }
+
+            String recordDataBase64 = null;
+            String uri = null;
+            if (options.directory() != null) {
+                uri = platform.toUri(recordedFile);
+            } else {
+                recordDataBase64 = platform.readFileAsBase64(recordedFile);
+            }
+
+            int duration = platform.getDurationMs(recordedFile);
+            RecordData recordData = new RecordData(recordDataBase64, duration, "audio/aac", uri);
+            if ((recordDataBase64 == null && uri == null) || recordData.getMsDuration() < 0) {
+                throw new VoiceRecorderServiceException(ErrorCodes.EMPTY_RECORDING);
+            }
+
+            return recordData;
+        } catch (VoiceRecorderServiceException exp) {
+            throw exp;
+        } catch (Exception exp) {
+            throw new VoiceRecorderServiceException(ErrorCodes.FAILED_TO_FETCH_RECORDING, exp);
+        } finally {
+            if (options.directory() == null && recorder != null) {
+                recorder.deleteOutputFile();
+            }
+            recorder = null;
+        }
+    }
+
+    /** Pauses the active recording session. */
+    public boolean pauseRecording() throws VoiceRecorderServiceException {
+        if (recorder == null) {
+            throw new VoiceRecorderServiceException(ErrorCodes.RECORDING_HAS_NOT_STARTED);
+        }
+        try {
+            return recorder.pauseRecording();
+        } catch (NotSupportedOsVersion exception) {
+            throw new VoiceRecorderServiceException(ErrorCodes.NOT_SUPPORTED_OS_VERSION, exception);
+        }
+    }
+
+    /** Resumes a paused recording session. */
+    public boolean resumeRecording() throws VoiceRecorderServiceException {
+        if (recorder == null) {
+            throw new VoiceRecorderServiceException(ErrorCodes.RECORDING_HAS_NOT_STARTED);
+        }
+        try {
+            return recorder.resumeRecording();
+        } catch (NotSupportedOsVersion exception) {
+            throw new VoiceRecorderServiceException(ErrorCodes.NOT_SUPPORTED_OS_VERSION, exception);
+        }
+    }
+
+    /** Returns the current recording status. */
+    public CurrentRecordingStatus getCurrentStatus() {
+        if (recorder == null) {
+            return CurrentRecordingStatus.NONE;
+        }
+        return recorder.getCurrentStatus();
+    }
+}

package/android/src/main/java/app/independo/capacitorvoicerecorder/service/VoiceRecorderServiceException.java

@@ -0,0 +1,23 @@
+package app.independo.capacitorvoicerecorder.service;
+
+/** Exception wrapper that carries a canonical error code. */
+public class VoiceRecorderServiceException extends Exception {
+
+    /** Canonical error code mapped to plugin responses. */
+    private final String code;
+
+    public VoiceRecorderServiceException(String code) {
+        super(code);
+        this.code = code;
+    }
+
+    public VoiceRecorderServiceException(String code, Exception cause) {
+        super(code, cause);
+        this.code = code;
+    }
+
+    /** Returns the canonical error code for this failure. */
+    public String getCode() {
+        return code;
+    }
+}

package/dist/esm/adapters/VoiceRecorderWebAdapter.d.ts

@@ -0,0 +1,23 @@
+import type { CurrentRecordingStatus, GenericResponse, RecordingData, RecordingOptions } from '../definitions';
+import type { VoiceRecorderPlatform } from '../service/VoiceRecorderService';
+/** Web adapter that delegates to the browser-specific implementation. */
+export declare class VoiceRecorderWebAdapter implements VoiceRecorderPlatform {
+    /** Browser implementation that talks to MediaRecorder APIs. */
+    private readonly voiceRecorderImpl;
+    /** Checks whether the browser can record audio. */
+    canDeviceVoiceRecord(): Promise<GenericResponse>;
+    /** Returns whether the browser has microphone permission. */
+    hasAudioRecordingPermission(): Promise<GenericResponse>;
+    /** Requests microphone permission through the browser. */
+    requestAudioRecordingPermission(): Promise<GenericResponse>;
+    /** Starts a recording session using MediaRecorder. */
+    startRecording(options?: RecordingOptions): Promise<GenericResponse>;
+    /** Stops the 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/adapters/VoiceRecorderWebAdapter.js

@@ -0,0 +1,41 @@
+import { VoiceRecorderImpl } from '../platform/web/VoiceRecorderImpl';
+/** Web adapter that delegates to the browser-specific implementation. */
+export class VoiceRecorderWebAdapter {
+    constructor() {
+        /** Browser implementation that talks to MediaRecorder APIs. */
+        this.voiceRecorderImpl = new VoiceRecorderImpl();
+    }
+    /** Checks whether the browser can record audio. */
+    canDeviceVoiceRecord() {
+        return VoiceRecorderImpl.canDeviceVoiceRecord();
+    }
+    /** Returns whether the browser has microphone permission. */
+    hasAudioRecordingPermission() {
+        return VoiceRecorderImpl.hasAudioRecordingPermission();
+    }
+    /** Requests microphone permission through the browser. */
+    requestAudioRecordingPermission() {
+        return VoiceRecorderImpl.requestAudioRecordingPermission();
+    }
+    /** Starts a recording session using MediaRecorder. */
+    startRecording(options) {
+        return this.voiceRecorderImpl.startRecording(options);
+    }
+    /** Stops the recording session and returns the payload. */
+    stopRecording() {
+        return this.voiceRecorderImpl.stopRecording();
+    }
+    /** Pauses the recording session when supported. */
+    pauseRecording() {
+        return this.voiceRecorderImpl.pauseRecording();
+    }
+    /** Resumes a paused recording session when supported. */
+    resumeRecording() {
+        return this.voiceRecorderImpl.resumeRecording();
+    }
+    /** Returns the current recording state. */
+    getCurrentStatus() {
+        return this.voiceRecorderImpl.getCurrentStatus();
+    }
+}
+//# sourceMappingURL=VoiceRecorderWebAdapter.js.map

package/dist/esm/adapters/VoiceRecorderWebAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceRecorderWebAdapter.js","sourceRoot":"","sources":["../../../src/adapters/VoiceRecorderWebAdapter.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAGtE,yEAAyE;AACzE,MAAM,OAAO,uBAAuB;IAApC;QACI,+DAA+D;QAC9C,sBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAyCjE,CAAC;IAvCG,mDAAmD;IAC5C,oBAAoB;QACvB,OAAO,iBAAiB,CAAC,oBAAoB,EAAE,CAAC;IACpD,CAAC;IAED,6DAA6D;IACtD,2BAA2B;QAC9B,OAAO,iBAAiB,CAAC,2BAA2B,EAAE,CAAC;IAC3D,CAAC;IAED,0DAA0D;IACnD,+BAA+B;QAClC,OAAO,iBAAiB,CAAC,+BAA+B,EAAE,CAAC;IAC/D,CAAC;IAED,sDAAsD;IAC/C,cAAc,CAAC,OAA0B;QAC5C,OAAO,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,2DAA2D;IACpD,aAAa;QAChB,OAAO,IAAI,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC;IAClD,CAAC;IAED,mDAAmD;IAC5C,cAAc;QACjB,OAAO,IAAI,CAAC,iBAAiB,CAAC,cAAc,EAAE,CAAC;IACnD,CAAC;IAED,yDAAyD;IAClD,eAAe;QAClB,OAAO,IAAI,CAAC,iBAAiB,CAAC,eAAe,EAAE,CAAC;IACpD,CAAC;IAED,2CAA2C;IACpC,gBAAgB;QACnB,OAAO,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,CAAC;IACrD,CAAC;CACJ","sourcesContent":["import type {\n    CurrentRecordingStatus,\n    GenericResponse,\n    RecordingData,\n    RecordingOptions,\n} from '../definitions';\nimport { VoiceRecorderImpl } from '../platform/web/VoiceRecorderImpl';\nimport type { VoiceRecorderPlatform } from '../service/VoiceRecorderService';\n\n/** Web adapter that delegates to the browser-specific implementation. */\nexport class VoiceRecorderWebAdapter implements VoiceRecorderPlatform {\n    /** Browser implementation that talks to MediaRecorder APIs. */\n    private readonly voiceRecorderImpl = new VoiceRecorderImpl();\n\n    /** Checks whether the browser can record audio. */\n    public canDeviceVoiceRecord(): Promise<GenericResponse> {\n        return VoiceRecorderImpl.canDeviceVoiceRecord();\n    }\n\n    /** Returns whether the browser has microphone permission. */\n    public hasAudioRecordingPermission(): Promise<GenericResponse> {\n        return VoiceRecorderImpl.hasAudioRecordingPermission();\n    }\n\n    /** Requests microphone permission through the browser. */\n    public requestAudioRecordingPermission(): Promise<GenericResponse> {\n        return VoiceRecorderImpl.requestAudioRecordingPermission();\n    }\n\n    /** Starts a recording session using MediaRecorder. */\n    public startRecording(options?: RecordingOptions): Promise<GenericResponse> {\n        return this.voiceRecorderImpl.startRecording(options);\n    }\n\n    /** Stops the recording session and returns the payload. */\n    public stopRecording(): Promise<RecordingData> {\n        return this.voiceRecorderImpl.stopRecording();\n    }\n\n    /** Pauses the recording session when supported. */\n    public pauseRecording(): Promise<GenericResponse> {\n        return this.voiceRecorderImpl.pauseRecording();\n    }\n\n    /** Resumes a paused recording session when supported. */\n    public resumeRecording(): Promise<GenericResponse> {\n        return this.voiceRecorderImpl.resumeRecording();\n    }\n\n    /** Returns the current recording state. */\n    public getCurrentStatus(): Promise<CurrentRecordingStatus> {\n        return this.voiceRecorderImpl.getCurrentStatus();\n    }\n}\n"]}

package/dist/esm/core/error-codes.d.ts

@@ -0,0 +1,4 @@
+/** Normalizes legacy error messages into canonical error codes. */
+export declare const toCanonicalErrorCode: (legacyMessage: string) => string;
+/** Adds a canonical `code` field to Error-like objects when possible. */
+export declare const attachCanonicalErrorCode: (error: unknown) => void;

package/dist/esm/core/error-codes.js

@@ -0,0 +1,21 @@
+/** Maps legacy error messages to canonical error codes. */
+const legacyToCanonical = {
+    CANNOT_RECORD_ON_THIS_PHONE: 'DEVICE_CANNOT_VOICE_RECORD',
+};
+/** Normalizes legacy error messages into canonical error codes. */
+export const toCanonicalErrorCode = (legacyMessage) => {
+    var _a;
+    return (_a = legacyToCanonical[legacyMessage]) !== null && _a !== void 0 ? _a : legacyMessage;
+};
+/** Adds a canonical `code` field to Error-like objects when possible. */
+export const attachCanonicalErrorCode = (error) => {
+    if (!error || typeof error !== 'object') {
+        return;
+    }
+    const messageValue = error.message;
+    if (typeof messageValue !== 'string') {
+        return;
+    }
+    error.code = toCanonicalErrorCode(messageValue);
+};
+//# sourceMappingURL=error-codes.js.map

package/dist/esm/core/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","sourceRoot":"","sources":["../../../src/core/error-codes.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,iBAAiB,GAA2B;IAC9C,2BAA2B,EAAE,4BAA4B;CAC5D,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,aAAqB,EAAU,EAAE;;IAClE,OAAO,MAAA,iBAAiB,CAAC,aAAa,CAAC,mCAAI,aAAa,CAAC;AAC7D,CAAC,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAc,EAAQ,EAAE;IAC7D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO;IACX,CAAC;IACD,MAAM,YAAY,GAAI,KAA+B,CAAC,OAAO,CAAC;IAC9D,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO;IACX,CAAC;IACA,KAA2B,CAAC,IAAI,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;AAC3E,CAAC,CAAC","sourcesContent":["/** Maps legacy error messages to canonical error codes. */\nconst legacyToCanonical: Record<string, string> = {\n    CANNOT_RECORD_ON_THIS_PHONE: 'DEVICE_CANNOT_VOICE_RECORD',\n};\n\n/** Normalizes legacy error messages into canonical error codes. */\nexport const toCanonicalErrorCode = (legacyMessage: string): string => {\n    return legacyToCanonical[legacyMessage] ?? legacyMessage;\n};\n\n/** Adds a canonical `code` field to Error-like objects when possible. */\nexport const attachCanonicalErrorCode = (error: unknown): void => {\n    if (!error || typeof error !== 'object') {\n        return;\n    }\n    const messageValue = (error as { message?: unknown }).message;\n    if (typeof messageValue !== 'string') {\n        return;\n    }\n    (error as { code?: string }).code = toCanonicalErrorCode(messageValue);\n};\n"]}

package/dist/esm/core/recording-contract.d.ts

@@ -0,0 +1,3 @@
+import type { RecordingData } from '../definitions';
+/** Normalizes recording payloads into a stable contract shape. */
+export declare const normalizeRecordingData: (data: RecordingData) => RecordingData;

package/dist/esm/core/recording-contract.js

@@ -0,0 +1,15 @@
+/** Normalizes recording payloads into a stable contract shape. */
+export const normalizeRecordingData = (data) => {
+    const { recordDataBase64, uri, msDuration, mimeType } = data.value;
+    const normalizedValue = { msDuration, mimeType };
+    const trimmedUri = typeof uri === 'string' && uri.length > 0 ? uri : undefined;
+    const trimmedBase64 = typeof recordDataBase64 === 'string' && recordDataBase64.length > 0 ? recordDataBase64 : undefined;
+    if (trimmedUri) {
+        normalizedValue.uri = trimmedUri;
+    }
+    else if (trimmedBase64) {
+        normalizedValue.recordDataBase64 = trimmedBase64;
+    }
+    return { value: normalizedValue };
+};
+//# sourceMappingURL=recording-contract.js.map

package/dist/esm/core/recording-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-contract.js","sourceRoot":"","sources":["../../../src/core/recording-contract.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAAmB,EAAiB,EAAE;IACzE,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;IACnE,MAAM,eAAe,GAA4B,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC1E,MAAM,UAAU,GAAG,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,MAAM,aAAa,GAAG,OAAO,gBAAgB,KAAK,QAAQ,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;IAEzH,IAAI,UAAU,EAAE,CAAC;QACb,eAAe,CAAC,GAAG,GAAG,UAAU,CAAC;IACrC,CAAC;SAAM,IAAI,aAAa,EAAE,CAAC;QACvB,eAAe,CAAC,gBAAgB,GAAG,aAAa,CAAC;IACrD,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,eAAe,EAAmB,CAAC;AACvD,CAAC,CAAC","sourcesContent":["import type { RecordingData } from '../definitions';\n\n/** Normalizes recording payloads into a stable contract shape. */\nexport const normalizeRecordingData = (data: RecordingData): RecordingData => {\n    const { recordDataBase64, uri, msDuration, mimeType } = data.value;\n    const normalizedValue: Record<string, unknown> = { msDuration, mimeType };\n    const trimmedUri = typeof uri === 'string' && uri.length > 0 ? uri : undefined;\n    const trimmedBase64 = typeof recordDataBase64 === 'string' && recordDataBase64.length > 0 ? recordDataBase64 : undefined;\n\n    if (trimmedUri) {\n        normalizedValue.uri = trimmedUri;\n    } else if (trimmedBase64) {\n        normalizedValue.recordDataBase64 = trimmedBase64;\n    }\n\n    return { value: normalizedValue } as RecordingData;\n};\n"]}

package/dist/esm/core/response-format.d.ts

@@ -0,0 +1,8 @@
+/** Supported response shapes for plugin results. */
+export type ResponseFormat = 'legacy' | 'normalized';
+/** Default response shape when no config is provided. */
+export declare const DEFAULT_RESPONSE_FORMAT: ResponseFormat;
+/** Parses a user-provided response format into a supported value. */
+export declare const resolveResponseFormat: (value: unknown) => ResponseFormat;
+/** Reads the response format from a Capacitor plugin config object. */
+export declare const getResponseFormatFromConfig: (config: unknown) => ResponseFormat;

package/dist/esm/core/response-format.js

@@ -0,0 +1,17 @@
+/** Default response shape when no config is provided. */
+export const DEFAULT_RESPONSE_FORMAT = 'legacy';
+/** Parses a user-provided response format into a supported value. */
+export const resolveResponseFormat = (value) => {
+    if (typeof value === 'string' && value.toLowerCase() === 'normalized') {
+        return 'normalized';
+    }
+    return DEFAULT_RESPONSE_FORMAT;
+};
+/** Reads the response format from a Capacitor plugin config object. */
+export const getResponseFormatFromConfig = (config) => {
+    if (config && typeof config === 'object' && 'responseFormat' in config) {
+        return resolveResponseFormat(config.responseFormat);
+    }
+    return DEFAULT_RESPONSE_FORMAT;
+};
+//# sourceMappingURL=response-format.js.map

package/dist/esm/core/response-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-format.js","sourceRoot":"","sources":["../../../src/core/response-format.ts"],"names":[],"mappings":"AAGA,yDAAyD;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAmB,QAAQ,CAAC;AAEhE,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAc,EAAkB,EAAE;IACpE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,YAAY,EAAE,CAAC;QACpE,OAAO,YAAY,CAAC;IACxB,CAAC;IACD,OAAO,uBAAuB,CAAC;AACnC,CAAC,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,MAAe,EAAkB,EAAE;IAC3E,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,gBAAgB,IAAI,MAAM,EAAE,CAAC;QACrE,OAAO,qBAAqB,CAAE,MAAuC,CAAC,cAAc,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,uBAAuB,CAAC;AACnC,CAAC,CAAC","sourcesContent":["/** Supported response shapes for plugin results. */\nexport type ResponseFormat = 'legacy' | 'normalized';\n\n/** Default response shape when no config is provided. */\nexport const DEFAULT_RESPONSE_FORMAT: ResponseFormat = 'legacy';\n\n/** Parses a user-provided response format into a supported value. */\nexport const resolveResponseFormat = (value: unknown): ResponseFormat => {\n    if (typeof value === 'string' && value.toLowerCase() === 'normalized') {\n        return 'normalized';\n    }\n    return DEFAULT_RESPONSE_FORMAT;\n};\n\n/** Reads the response format from a Capacitor plugin config object. */\nexport const getResponseFormatFromConfig = (config: unknown): ResponseFormat => {\n    if (config && typeof config === 'object' && 'responseFormat' in config) {\n        return resolveResponseFormat((config as { responseFormat?: unknown }).responseFormat);\n    }\n    return DEFAULT_RESPONSE_FORMAT;\n};\n"]}

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

@@ -0,0 +1,45 @@
+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;
+};
+/** Browser implementation backed by MediaRecorder and Capacitor Filesystem. */
+export declare class VoiceRecorderImpl {
+    /** Active MediaRecorder instance, if recording. */
+    private mediaRecorder;
+    /** 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. */
+    startRecording(options?: RecordingOptions): Promise<GenericResponse>;
+    /** Stops the current recording and resolves the pending payload. */
+    stopRecording(): Promise<RecordingData>;
+    /** Returns whether the browser has microphone permission. */
+    static hasAudioRecordingPermission(): Promise<GenericResponse>;
+    /** Requests microphone permission from the browser. */
+    static requestAudioRecordingPermission(): Promise<GenericResponse>;
+    /** Pauses the recording session when supported. */
+    pauseRecording(): Promise<GenericResponse>;
+    /** Resumes a paused recording session when supported. */
+    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;
+    /** Initializes MediaRecorder and wires up handlers. */
+    private onSuccessfullyStartedRecording;
+    /** Handles failures from getUserMedia. */
+    private onFailedToStartRecording;
+    /** Converts a Blob payload into a base64 string. */
+    private static blobToBase64;
+    /** Resets state for the next recording attempt. */
+    private prepareInstanceForNextOperation;
+}
+export {};