capacitor-camera-view 2.2.0-rc.1 → 2.3.0

package/README.md

@@ -443,7 +443,7 @@ Camera must be running. Throws if already recording.
 | ------------- | ----------------------------------------------------------------------- | ---------------------------------- |
 | **`options`** | <code><a href="#videorecordingoptions">VideoRecordingOptions</a></code> | - Optional recording configuration |
 
-**Since:** 2.2.0
+**Since:** 2.3.0
 
 --------------------
 
@@ -459,7 +459,7 @@ Throws if no recording is in progress.
 
 **Returns:** <code>Promise&lt;<a href="#videorecordingresponse">VideoRecordingResponse</a>&gt;</code>
 
-**Since:** 2.2.0
+**Since:** 2.3.0
 
 --------------------
 
@@ -737,8 +737,8 @@ Configuration options for video recording.
 
 | Prop               | Type                                                                    | Description                                                                          | Default                | Since |
 | ------------------ | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ---------------------- | ----- |
-| **`enableAudio`**  | <code>boolean</code>                                                    | Whether to record audio with the video. Requires microphone permission.              | <code>false</code>     | 2.2.0 |
-| **`videoQuality`** | <code><a href="#videorecordingquality">VideoRecordingQuality</a></code> | Video recording quality preset. Native platforms only (iOS/Android). Ignored on web. | <code>'highest'</code> | 2.2.0 |
+| **`enableAudio`**  | <code>boolean</code>                                                    | Whether to record audio with the video. Requires microphone permission.              | <code>false</code>     | 2.3.0 |
+| **`videoQuality`** | <code><a href="#videorecordingquality">VideoRecordingQuality</a></code> | Video recording quality preset. Native platforms only (iOS/Android). Ignored on web. | <code>'highest'</code> | 2.3.0 |
 
 
 #### VideoRecordingResponse
@@ -747,7 +747,7 @@ Response from stopping a video recording.
 
 | Prop          | Type                | Description                                                                                                                                       | Since |
 | ------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
-| **`webPath`** | <code>string</code> | Web-accessible path to the recorded video file. On web, this is a blob URL. On iOS/Android, this is a path accessible via Capacitor's filesystem. | 2.2.0 |
+| **`webPath`** | <code>string</code> | Web-accessible path to the recorded video file. On web, this is a blob URL. On iOS/Android, this is a path accessible via Capacitor's filesystem. | 2.3.0 |
 
 
 #### GetAvailableDevicesResponse
@@ -840,12 +840,13 @@ Response for the camera and microphone permission status.
 
 Data for a detected barcode.
 
-| Prop               | Type                                                  | Description                                                      |
-| ------------------ | ----------------------------------------------------- | ---------------------------------------------------------------- |
-| **`value`**        | <code>string</code>                                   | The decoded string value of the barcode                          |
-| **`displayValue`** | <code>string</code>                                   | The display value of the barcode (may differ from the raw value) |
-| **`type`**         | <code>string</code>                                   | The type/format of the barcode (e.g., 'qr', 'code128', etc.)     |
-| **`boundingRect`** | <code><a href="#boundingrect">BoundingRect</a></code> | The bounding rectangle of the barcode in the camera frame.       |
+| Prop               | Type                                                  | Description                                                                                                                                                                                                                                                                                          | Since |
+| ------------------ | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| **`value`**        | <code>string</code>                                   | The decoded string value of the barcode                                                                                                                                                                                                                                                              |       |
+| **`rawBytes`**     | <code>number[]</code>                                 | Raw bytes as they were encoded in the barcode. On Android, this is forwarded from ML Kit. On iOS, this is available for descriptor-backed formats such as QR, Aztec, PDF417, and Data Matrix. On web, this is not available because the Barcode Detection API only exposes the decoded string value. | 2.2.0 |
+| **`displayValue`** | <code>string</code>                                   | The display value of the barcode on Android. This is forwarded from ML Kit and may contain a formatted, human-readable representation that differs from the raw decoded value. iOS and web do not expose a separate display value, so this property is only emitted on Android.                      |       |
+| **`type`**         | <code>string</code>                                   | The type/format of the barcode (e.g., 'qr', 'code128', etc.)                                                                                                                                                                                                                                         |       |
+| **`boundingRect`** | <code><a href="#boundingrect">BoundingRect</a></code> | The bounding rectangle of the barcode in the camera frame.                                                                                                                                                                                                                                           |       |
 
 
 #### BoundingRect

package/android/src/main/java/com/michaelwolz/capacitorcameraview/CameraView.kt

@@ -108,6 +108,9 @@ class CameraView(plugin: Plugin) {
     // Track the output file for the current recording
     private var currentRecordingFile: File? = null
 
+    // Enabled CameraX use cases before video recording temporarily changes them.
+    private var enabledUseCasesBeforeRecording: Int? = null
+
     // Plugin context
     private var lifecycleOwner: LifecycleOwner? = null
     private var pluginDelegate: Plugin = plugin
@@ -409,6 +412,7 @@ class CameraView(plugin: Plugin) {
             controller.videoCaptureQualitySelector = videoQuality.toQualitySelector()
 
             // Enable VIDEO_CAPTURE use case alongside IMAGE_CAPTURE
+            enabledUseCasesBeforeRecording = controller.currentEnabledUseCases()
             controller.setEnabledUseCases(
                 CameraController.IMAGE_CAPTURE or CameraController.VIDEO_CAPTURE
             )
@@ -419,13 +423,11 @@ class CameraView(plugin: Plugin) {
             startCameraRecording(controller, outputOptions, audioConfig, continuation)
         } catch (e: SecurityException) {
             Log.e(TAG, "Security exception when starting recording. Missing permission?", e)
-            // Restore normal use cases on permission error
-            cameraController?.setEnabledUseCases(CameraController.IMAGE_CAPTURE)
+            restoreUseCasesAfterRecording()
             continuation.resume(CameraResult.Error(e))
         } catch (e: Exception) {
             Log.e(TAG, "Error starting recording", e)
-            // Restore normal use cases on error
-            cameraController?.setEnabledUseCases(CameraController.IMAGE_CAPTURE)
+            restoreUseCasesAfterRecording()
             continuation.resume(CameraResult.Error(e))
         }
     }
@@ -543,7 +545,7 @@ class CameraView(plugin: Plugin) {
     private fun finalizeRecordingAndNotifyStopCallback(event: VideoRecordEvent.Finalize) {
         mainHandler.post {
             // CameraX requires use case changes on the main thread.
-            cameraController?.setEnabledUseCases(CameraController.IMAGE_CAPTURE)
+            restoreUseCasesAfterRecording()
 
             val callback = pendingStopCallback
             pendingStopCallback = null
@@ -576,6 +578,26 @@ class CameraView(plugin: Plugin) {
         }
     }
 
+    private fun LifecycleCameraController.currentEnabledUseCases(): Int {
+        var enabledUseCases = 0
+        if (isImageCaptureEnabled) {
+            enabledUseCases = enabledUseCases or CameraController.IMAGE_CAPTURE
+        }
+        if (isImageAnalysisEnabled) {
+            enabledUseCases = enabledUseCases or CameraController.IMAGE_ANALYSIS
+        }
+        if (isVideoCaptureEnabled) {
+            enabledUseCases = enabledUseCases or CameraController.VIDEO_CAPTURE
+        }
+        return enabledUseCases
+    }
+
+    private fun restoreUseCasesAfterRecording() {
+        val useCases = enabledUseCasesBeforeRecording ?: CameraController.IMAGE_CAPTURE
+        enabledUseCasesBeforeRecording = null
+        cameraController?.setEnabledUseCases(useCases)
+    }
+
     private fun VideoRecordingQuality.toQualitySelector(): QualitySelector {
         return when (this) {
             VideoRecordingQuality.LOWEST -> QualitySelector.from(Quality.LOWEST)
@@ -1007,6 +1029,7 @@ class CameraView(plugin: Plugin) {
         val barcodeResult =
             BarcodeDetectionResult(
                 value = barcode.rawValue ?: "",
+                rawBytes = barcode.rawBytes ?: ByteArray(0),
                 displayValue = barcode.displayValue ?: "",
                 type = getBarcodeFormatString(barcode.format),
                 boundingRect = webBoundingRect

package/android/src/main/java/com/michaelwolz/capacitorcameraview/CameraViewPlugin.kt

@@ -399,8 +399,14 @@ class CameraViewPlugin : Plugin() {
      * Called by the CameraView when a barcode is detected.
      */
     fun notifyBarcodeDetected(result: BarcodeDetectionResult) {
+        val rawBytesArray = JSArray().apply {
+            result.rawBytes.forEach { put(it.toInt() and 0xFF) }
+        }
+
         val jsObject = JSObject().apply {
             put("value", result.value)
+            put("displayValue", result.displayValue)
+            put("rawBytes", rawBytesArray)
             put("type", result.type)
             put("boundingRect", JSObject().apply {
                 put("x", result.boundingRect.x)

package/android/src/main/java/com/michaelwolz/capacitorcameraview/model/BarcodeDetectionResult.kt

@@ -5,6 +5,7 @@ package com.michaelwolz.capacitorcameraview.model
  */
 data class BarcodeDetectionResult(
     val value: String,
+    val rawBytes: ByteArray,
     val displayValue: String,
     val type: String,
     val boundingRect: WebBoundingRect

package/dist/docs.json

@@ -169,7 +169,7 @@
           },
           {
             "name": "since",
-            "text": "2.2.0"
+            "text": "2.3.0"
           }
         ],
         "docs": "Start recording video from the current camera.\nCamera must be running. Throws if already recording.",
@@ -190,7 +190,7 @@
           },
           {
             "name": "since",
-            "text": "2.2.0"
+            "text": "2.3.0"
           }
         ],
         "docs": "Stop the current video recording and return the result.\nThrows if no recording is in progress.",
@@ -792,7 +792,7 @@
       "docs": "Configuration options for video recording.",
       "tags": [
         {
-          "text": "2.2.0",
+          "text": "2.3.0",
           "name": "since"
         }
       ],
@@ -806,7 +806,7 @@
               "name": "default"
             },
             {
-              "text": "2.2.0",
+              "text": "2.3.0",
               "name": "since"
             }
           ],
@@ -822,7 +822,7 @@
               "name": "default"
             },
             {
-              "text": "2.2.0",
+              "text": "2.3.0",
               "name": "since"
             }
           ],
@@ -840,7 +840,7 @@
       "docs": "Response from stopping a video recording.",
       "tags": [
         {
-          "text": "2.2.0",
+          "text": "2.3.0",
           "name": "since"
         }
       ],
@@ -850,7 +850,7 @@
           "name": "webPath",
           "tags": [
             {
-              "text": "2.2.0",
+              "text": "2.3.0",
               "name": "since"
             }
           ],
@@ -1126,10 +1126,22 @@
           "complexTypes": [],
           "type": "string"
         },
+        {
+          "name": "rawBytes",
+          "tags": [
+            {
+              "text": "2.2.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Raw bytes as they were encoded in the barcode.\n\nOn Android, this is forwarded from ML Kit.\nOn iOS, this is available for descriptor-backed formats such as QR, Aztec, PDF417, and Data Matrix.\nOn web, this is not available because the Barcode Detection API only exposes the decoded string value.",
+          "complexTypes": [],
+          "type": "number[] | undefined"
+        },
         {
           "name": "displayValue",
           "tags": [],
-          "docs": "The display value of the barcode (may differ from the raw value)",
+          "docs": "The display value of the barcode on Android.\n\nThis is forwarded from ML Kit and may contain a formatted, human-readable\nrepresentation that differs from the raw decoded value. iOS and web do not\nexpose a separate display value, so this property is only emitted on Android.",
           "complexTypes": [],
           "type": "string | undefined"
         },

package/dist/esm/definitions.d.ts

@@ -63,7 +63,7 @@ export interface CameraViewPlugin {
      * @param options - Optional recording configuration
      * @returns A promise that resolves when recording has started
      *
-     * @since 2.2.0
+     * @since 2.3.0
      */
     startRecording(options?: VideoRecordingOptions): Promise<void>;
     /**
@@ -72,7 +72,7 @@ export interface CameraViewPlugin {
      *
      * @returns A promise that resolves with the recorded video file path
      *
-     * @since 2.2.0
+     * @since 2.3.0
      */
     stopRecording(): Promise<VideoRecordingResponse>;
     /**
@@ -262,7 +262,7 @@ export type FlashMode = 'off' | 'on' | 'auto';
  * On iOS this maps to `AVCaptureSession.Preset` values.
  * On Android this maps to CameraX `QualitySelector` values.
  *
- * @since 2.2.0
+ * @since 2.3.0
  */
 export type VideoRecordingQuality = 'lowest' | 'sd' | 'hd' | 'fhd' | 'uhd' | 'highest';
 /**
@@ -420,34 +420,34 @@ export interface CaptureOptions {
 }
 /**
  * Configuration options for video recording.
- * @since 2.2.0
+ * @since 2.3.0
  */
 export interface VideoRecordingOptions {
     /**
      * Whether to record audio with the video.
      * Requires microphone permission.
      * @default false
-     * @since 2.2.0
+     * @since 2.3.0
      */
     enableAudio?: boolean;
     /**
      * Video recording quality preset.
      * Native platforms only (iOS/Android). Ignored on web.
      * @default 'highest'
-     * @since 2.2.0
+     * @since 2.3.0
      */
     videoQuality?: VideoRecordingQuality;
 }
 /**
  * Response from stopping a video recording.
- * @since 2.2.0
+ * @since 2.3.0
  */
 export interface VideoRecordingResponse {
     /**
      * Web-accessible path to the recorded video file.
      * On web, this is a blob URL.
      * On iOS/Android, this is a path accessible via Capacitor's filesystem.
-     * @since 2.2.0
+     * @since 2.3.0
      */
     webPath: string;
 }
@@ -541,7 +541,23 @@ export interface GetTorchModeResponse {
 export interface BarcodeDetectionData {
     /** The decoded string value of the barcode */
     value: string;
-    /** The display value of the barcode (may differ from the raw value) */
+    /**
+     * Raw bytes as they were encoded in the barcode.
+     *
+     * On Android, this is forwarded from ML Kit.
+     * On iOS, this is available for descriptor-backed formats such as QR, Aztec, PDF417, and Data Matrix.
+     * On web, this is not available because the Barcode Detection API only exposes the decoded string value.
+     *
+     * @since 2.2.0
+     */
+    rawBytes?: number[];
+    /**
+     * The display value of the barcode on Android.
+     *
+     * This is forwarded from ML Kit and may contain a formatted, human-readable
+     * representation that differs from the raw decoded value. iOS and web do not
+     * expose a separate display value, so this property is only emitted on Android.
+     */
     displayValue?: string;
     /** The type/format of the barcode (e.g., 'qr', 'code128', etc.) */
     type: string;
@@ -569,7 +585,7 @@ export interface BoundingRect {
  * - 'camera': Camera access permission
  * - 'microphone': Microphone access permission (needed for video recording with audio)
  *
- * @since 2.2.0
+ * @since 2.3.0
  */
 export type CameraPermissionType = 'camera' | 'microphone';
 /**

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Main plugin interface for Capacitor Camera View functionality.\n *\n * @since 1.0.0\n */\nexport interface CameraViewPlugin {\n  /**\n   * Start the camera view with optional configuration.\n   *\n   * @param options - Configuration options for the camera session\n   * @returns A promise that resolves when the camera has started\n   *\n   * @since 1.0.0\n   */\n  start(options?: CameraSessionConfiguration): Promise<void>;\n\n  /**\n   * Stop the camera view and release resources.\n   *\n   * @returns A promise that resolves when the camera has stopped\n   *\n   * @since 1.0.0\n   */\n  stop(): Promise<void>;\n\n  /**\n   * Check if the camera view is currently running.\n   *\n   * @returns A promise that resolves with an object containing the running state of the camera\n   *\n   * @since 1.0.0\n   */\n  isRunning(): Promise<IsRunningResponse>;\n\n  /**\n   * Capture a photo using the current camera configuration.\n   *\n   * @param options - Capture configuration options\n   * @returns A promise that resolves with an object containing either a base64 encoded string or file path of the captured photo\n   *\n   * @since 1.0.0\n   */\n  capture<T extends CaptureOptions>(options: T): Promise<CaptureResponse<T>>;\n\n  /**\n   * Captures a frame from the current camera preview without using the full camera capture pipeline.\n   *\n   * Unlike `capture()` which may trigger hardware-level photo capture on native platforms,\n   * this method quickly samples the current video stream. This is suitable computer vision or\n   * simple snapshots where high fidelity is not required.\n   *\n   * On web this method does exactly the same as `capture()` as it only captures a frame from the video stream\n   * because unfortunately [ImageCapture API](https://developer.mozilla.org/en-US/docs/Web/API/ImageCapture) is\n   * not yet well supported on the web.\n   *\n   * @param options - Capture configuration options\n   * @returns A promise that resolves with an object containing either a base64 encoded string or file path of the captured sample\n   *\n   * @since 1.0.0\n   */\n  captureSample<T extends CaptureOptions>(options: T): Promise<CaptureResponse<T>>;\n\n  /**\n   * Start recording video from the current camera.\n   * Camera must be running. Throws if already recording.\n   *\n   * @param options - Optional recording configuration\n   * @returns A promise that resolves when recording has started\n   *\n   * @since 2.2.0\n   */\n  startRecording(options?: VideoRecordingOptions): Promise<void>;\n\n  /**\n   * Stop the current video recording and return the result.\n   * Throws if no recording is in progress.\n   *\n   * @returns A promise that resolves with the recorded video file path\n   *\n   * @since 2.2.0\n   */\n  stopRecording(): Promise<VideoRecordingResponse>;\n\n  /**\n   * Switch between front and back camera.\n   *\n   * @returns A promise that resolves when the camera has been flipped\n   *\n   * @since 1.0.0\n   */\n  flipCamera(): Promise<void>;\n\n  /**\n   * Get available camera devices for capturing photos.\n   *\n   * @returns A promise that resolves with an object containing an array of available capture devices\n   *\n   * @since 1.0.0\n   */\n  getAvailableDevices(): Promise<GetAvailableDevicesResponse>;\n\n  /**\n   * Get current zoom level information and available range.\n   *\n   * @remarks\n   * Make sure the camera is properly initialized before calling this method. Otherwise, this might\n   * lead to returning default values on android.\n   *\n   * @returns A promise that resolves with an object containing min, max and current zoom levels\n   *\n   * @since 1.0.0\n   */\n  getZoom(): Promise<GetZoomResponse>;\n\n  /**\n   * Set the camera zoom level.\n   *\n   * @param options - Zoom configuration options\n   * @param options.level - The zoom level to set\n   * @param options.ramp - Whether to animate the zoom level change, defaults to false (iOS only)\n   * @returns A promise that resolves when the zoom level has been set\n   *\n   * @remarks\n   * On web platforms, zoom functionality may be limited by browser support.\n   * When native zoom is not available, a CSS-based zoom simulation is applied.\n   *\n   * @since 1.0.0\n   */\n  setZoom(options: { level: number; ramp?: boolean }): Promise<void>;\n\n  /**\n   * Get current flash mode setting.\n   *\n   * @returns A promise that resolves with an object containing the current flash mode\n   *\n   * @since 1.0.0\n   */\n  getFlashMode(): Promise<GetFlashModeResponse>;\n\n  /**\n   * Get supported flash modes for the current camera.\n   *\n   * @returns A promise that resolves with an object containing an array of supported flash modes\n   *\n   * @since 1.0.0\n   */\n  getSupportedFlashModes(): Promise<GetSupportedFlashModesResponse>;\n\n  /**\n   * Set the camera flash mode.\n   *\n   * @param options - Flash mode configuration options\n   * @param options.mode - The flash mode to set\n   * @returns A promise that resolves when the flash mode has been set\n   *\n   * @since 1.0.0\n   */\n  setFlashMode(options: { mode: FlashMode }): Promise<void>;\n\n  /**\n   * Check if the device supports torch (flashlight) functionality.\n   *\n   * @remarks\n   * **Important**: You must call this method and verify torch availability before using\n   * `setTorchMode()` or `getTorchMode()`. Calling torch methods on devices without\n   * torch support will throw an exception.\n   *\n   * @returns A promise that resolves with an object containing torch availability status\n   *\n   * @since 1.2.0\n   */\n  isTorchAvailable(): Promise<IsTorchAvailableResponse>;\n\n  /**\n   * Get the current torch (flashlight) state.\n   *\n   * @remarks\n   * **Important**: Call `isTorchAvailable()` first to ensure the device supports torch\n   * functionality. This method will throw an exception if torch is not supported.\n   *\n   * @returns A promise that resolves with an object containing the current torch state\n   *\n   * @since 1.2.0\n   */\n  getTorchMode(): Promise<GetTorchModeResponse>;\n\n  /**\n   * Set the torch (flashlight) mode and intensity.\n   *\n   * @remarks\n   * **Important**: Call `isTorchAvailable()` first to ensure the device supports torch\n   * functionality. This method will throw an exception if torch is not supported.\n   *\n   * The torch provides continuous illumination, unlike flash which only activates during photo capture.\n   * On iOS, you can control the torch intensity level. On Android, the torch is either on or off.\n   *\n   * @param options - Torch configuration options\n   * @param options.enabled - Whether to enable or disable the torch\n   * @param options.level - The torch intensity level (0.0 to 1.0, iOS only). Defaults to 1.0 when enabled\n   * @returns A promise that resolves when the torch mode has been set\n   *\n   * @since 1.2.0\n   */\n  setTorchMode(options: { enabled: boolean; level?: number }): Promise<void>;\n\n  /**\n   * Check camera and microphone permission status without requesting permissions.\n   *\n   * @returns A promise that resolves with an object containing the camera and microphone permission status\n   *\n   * @since 1.0.0\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Request camera and/or microphone permissions from the user.\n   *\n   * By default, only camera permission is requested. To also request microphone\n   * permission (needed for video recording with audio), pass `{ permissions: ['camera', 'microphone'] }`.\n   *\n   * @param options - Optional object specifying which permissions to request\n   * @returns A promise that resolves with an object containing the camera and microphone permission status\n   *\n   * @since 1.0.0\n   */\n  requestPermissions(options?: { permissions?: CameraPermissionType[] }): Promise<PermissionStatus>;\n\n  /**\n   * Listen for barcode detection events.\n   * This event is emitted when a barcode is detected in the camera preview.\n   *\n   * @param eventName - The name of the event to listen for ('barcodeDetected')\n   * @param listenerFunc - The callback function to execute when a barcode is detected\n   * @returns A promise that resolves with an event subscription\n   *\n   * @since 1.0.0\n   */\n  addListener(\n    eventName: 'barcodeDetected',\n    listenerFunc: (data: BarcodeDetectionData) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @param eventName - Optional event name to remove listeners for\n   * @returns A promise that resolves when the listeners are removed\n   *\n   * @since 1.0.0\n   */\n  removeAllListeners(eventName?: string): Promise<void>;\n}\n\n// ------------------------------------------------------------------------------\n// Camera Configuration Types\n// ------------------------------------------------------------------------------\n\n/**\n * Position options for the camera.\n * - 'front': Front-facing camera\n * - 'back': Rear-facing camera\n *\n * @since 1.0.0\n */\nexport type CameraPosition = 'front' | 'back';\n\n/**\n * Flash mode options for the camera.\n * - 'off': Flash disabled\n * - 'on': Flash always on\n * - 'auto': Flash automatically enabled in low-light conditions\n *\n * @since 1.0.0\n */\nexport type FlashMode = 'off' | 'on' | 'auto';\n\n/**\n * Video recording quality presets.\n *\n * @remarks\n * On iOS this maps to `AVCaptureSession.Preset` values.\n * On Android this maps to CameraX `QualitySelector` values.\n *\n * @since 2.2.0\n */\nexport type VideoRecordingQuality = 'lowest' | 'sd' | 'hd' | 'fhd' | 'uhd' | 'highest';\n\n/**\n * Represents a physical camera device on the device.\n *\n * @since 1.0.0\n */\nexport interface CameraDevice {\n  /** The unique identifier of the camera device */\n  id: string;\n\n  /** The human-readable name of the camera device */\n  name: string;\n\n  /** The position of the camera device (front or back) */\n  position: CameraPosition;\n\n  /** The type of the camera device (e.g., wide, ultra-wide, telephoto) - iOS only */\n  deviceType?: CameraDeviceType;\n}\n\n/**\n * Available camera device types for iOS.\n * Maps to AVCaptureDevice DeviceTypes in iOS.\n *\n * @see https://developer.apple.com/documentation/avfoundation/avcapturedevice/devicetype-swift.struct\n *\n * @since 1.0.0\n */\nexport type CameraDeviceType =\n  /** builtInWideAngleCamera - standard camera */\n  | 'wideAngle'\n  /** builtInUltraWideCamera - 0.5x zoom level */\n  | 'ultraWide'\n  /** builtInTelephotoCamera - 2x/3x zoom level */\n  | 'telephoto'\n  /** builtInDualCamera - wide + telephoto combination */\n  | 'dual'\n  /** builtInDualWideCamera - wide + ultraWide combination */\n  | 'dualWide'\n  /** builtInTripleCamera - wide + ultraWide + telephoto */\n  | 'triple'\n  /** builtInTrueDepthCamera - front-facing camera with depth sensing */\n  | 'trueDepth';\n\n/**\n * Supported barcode types for detection.\n * Specifying only the barcode types you need can improve performance\n * and reduce battery consumption.\n *\n * @since 2.1.0\n */\nexport type BarcodeType =\n  /** QR Code */\n  | 'qr'\n  /** Code 128 barcode */\n  | 'code128'\n  /** Code 39 barcode */\n  | 'code39'\n  /** Code 39 Mod 43 barcode */\n  | 'code39Mod43'\n  /** Code 93 barcode */\n  | 'code93'\n  /** EAN-8 barcode */\n  | 'ean8'\n  /** EAN-13 barcode */\n  | 'ean13'\n  /** Interleaved 2 of 5 barcode */\n  | 'interleaved2of5'\n  /** ITF-14 barcode */\n  | 'itf14'\n  /** PDF417 barcode */\n  | 'pdf417'\n  /** Aztec code */\n  | 'aztec'\n  /** Data Matrix code */\n  | 'dataMatrix'\n  /** UPC-E barcode */\n  | 'upce';\n\n/**\n * Configuration options for starting a camera session.\n *\n * @since 1.0.0\n */\nexport interface CameraSessionConfiguration {\n  /**\n   * Enables the barcode detection functionality\n   * @default false\n   */\n  enableBarcodeDetection?: boolean;\n\n  /**\n   * Specific barcode types to detect. If not provided, all supported types are detected.\n   * Specifying only the types you need can significantly improve performance and reduce\n   * battery consumption, especially on mobile devices.\n   *\n   * @example ['qr', 'code128'] // Only detect QR codes and Code 128 barcodes\n   * @default undefined - all supported types are detected\n   * @since 2.1.0\n   */\n  barcodeTypes?: BarcodeType[];\n\n  /**\n   * Position of the camera to use\n   * @default 'back'\n   */\n  position?: CameraPosition;\n\n  /**\n   * Specific device ID of the camera to use\n   * If provided, takes precedence over position\n   */\n  deviceId?: string;\n\n  /**\n   * Whether to use the triple camera if available (iPhone Pro models only)\n   * @default false\n   */\n  useTripleCameraIfAvailable?: boolean;\n\n  /**\n   * Ordered list of preferred camera device types to use (iOS only).\n   * The system will attempt to use the first available camera type in the list.\n   * If position is also provided, the system will use the first available camera type\n   * that matches the position and is in the list.\n   *\n   * This will fallback to the default camera type if none of the preferred types are available.\n   *\n   * @example [CameraDeviceType.WideAngle, CameraDeviceType.UltraWide, CameraDeviceType.Telephoto]\n   * @default undefined - system will decide based on position/deviceId\n   */\n  preferredCameraDeviceTypes?: CameraDeviceType[];\n\n  /**\n   * The initial zoom factor to use\n   * @default 1.0\n   */\n  zoomFactor?: number;\n\n  /**\n   * Optional HTML ID of the container element where the camera view should be rendered.\n   * If not provided, the camera view will be appended to the document body. Web only.\n   * @example 'cameraContainer'\n   */\n  containerElementId?: string;\n}\n\n/**\n * Configuration options for capturing photos and samples.\n *\n * @since 1.1.0\n */\nexport interface CaptureOptions {\n  /**\n   * The JPEG quality of the captured photo/sample on a scale of 0-100\n   * @since 1.1.0\n   */\n  quality: number;\n\n  /**\n   * If true, saves to a temporary file and returns the web path instead of base64.\n   * The web path can be used to set the src attribute of an image for efficient loading and rendering.\n   * This reduces the data that needs to be transferred over the bridge, which can improve performance\n   * especially for high-resolution images.\n   * @default false\n   * @since 1.1.0\n   */\n  saveToFile?: boolean;\n}\n\n/**\n * Configuration options for video recording.\n * @since 2.2.0\n */\nexport interface VideoRecordingOptions {\n  /**\n   * Whether to record audio with the video.\n   * Requires microphone permission.\n   * @default false\n   * @since 2.2.0\n   */\n  enableAudio?: boolean;\n\n  /**\n   * Video recording quality preset.\n   * Native platforms only (iOS/Android). Ignored on web.\n   * @default 'highest'\n   * @since 2.2.0\n   */\n  videoQuality?: VideoRecordingQuality;\n}\n\n/**\n * Response from stopping a video recording.\n * @since 2.2.0\n */\nexport interface VideoRecordingResponse {\n  /**\n   * Web-accessible path to the recorded video file.\n   * On web, this is a blob URL.\n   * On iOS/Android, this is a path accessible via Capacitor's filesystem.\n   * @since 2.2.0\n   */\n  webPath: string;\n}\n\n// ------------------------------------------------------------------------------\n// Response Interfaces\n// ------------------------------------------------------------------------------\n\n/**\n * Response for checking if the camera view is running.\n *\n * @since 1.0.0\n */\nexport interface IsRunningResponse {\n  /** Indicates if the camera view is currently active and running */\n  isRunning: boolean;\n}\n\n/**\n * Response for capturing a photo\n * This will contain either a base64 encoded string or a web path to the captured photo,\n * depending on the `saveToFile` option in the CaptureOptions.\n * @since 1.0.0\n */\nexport type CaptureResponse<T extends CaptureOptions = CaptureOptions> = T['saveToFile'] extends true\n  ? {\n      /** The web path to the captured photo that can be used to set the src attribute of an image for efficient loading and rendering (when saveToFile is true) */\n      webPath: string;\n    }\n  : {\n      /** The base64 encoded string of the captured photo (when saveToFile is false or undefined) */\n      photo: string;\n    };\n\n/**\n * Response for getting available camera devices.\n *\n * @since 1.0.0\n */\nexport interface GetAvailableDevicesResponse {\n  /** An array of available camera devices */\n  devices: CameraDevice[];\n}\n\n/**\n * Response for getting zoom level information.\n *\n * @since 1.0.0\n */\nexport interface GetZoomResponse {\n  /** The minimum zoom level supported */\n  min: number;\n\n  /** The maximum zoom level supported */\n  max: number;\n\n  /** The current zoom level */\n  current: number;\n}\n\n/**\n * Response for getting the current flash mode.\n *\n * @since 1.0.0\n */\nexport interface GetFlashModeResponse {\n  /** The current flash mode setting */\n  flashMode: FlashMode;\n}\n\n/**\n * Response for getting supported flash modes.\n *\n * @since 1.0.0\n */\nexport interface GetSupportedFlashModesResponse {\n  /** An array of flash modes supported by the current camera */\n  flashModes: FlashMode[];\n}\n\n/**\n * Response for checking torch availability.\n *\n * @since 1.2.0\n */\nexport interface IsTorchAvailableResponse {\n  /** Indicates if the device supports torch (flashlight) functionality */\n  available: boolean;\n}\n\n/**\n * Response for getting the current torch mode.\n *\n * @since 1.2.0\n */\nexport interface GetTorchModeResponse {\n  /** Indicates if the torch is currently enabled */\n  enabled: boolean;\n  /** The current torch intensity level (0.0 to 1.0, iOS only). Always 1.0 on Android when enabled */\n  level: number;\n}\n\n/**\n * Data for a detected barcode.\n *\n * @since 1.0.0\n */\nexport interface BarcodeDetectionData {\n  /** The decoded string value of the barcode */\n  value: string;\n\n  /** The display value of the barcode (may differ from the raw value) */\n  displayValue?: string;\n\n  /** The type/format of the barcode (e.g., 'qr', 'code128', etc.) */\n  type: string;\n\n  /** The bounding rectangle of the barcode in the camera frame. */\n  boundingRect: BoundingRect;\n}\n\n/**\n * Rectangle defining the boundary of the barcode in the camera frame.\n * Coordinates are normalized between 0 and 1 relative to the camera frame.\n *\n * @since 1.0.0\n */\nexport interface BoundingRect {\n  /** X-coordinate of the top-left corner */\n  x: number;\n  /** Y-coordinate of the top-left corner */\n  y: number;\n  /** Width of the bounding rectangle (should match the actual width of the barcode) */\n  width: number;\n  /** Height of the bounding rectangle (should match the actual height of the barcode) */\n  height: number;\n}\n\n/**\n * Permission types that can be requested.\n * - 'camera': Camera access permission\n * - 'microphone': Microphone access permission (needed for video recording with audio)\n *\n * @since 2.2.0\n */\nexport type CameraPermissionType = 'camera' | 'microphone';\n\n/**\n * Response for the camera and microphone permission status.\n *\n * @since 1.0.0\n */\nexport interface PermissionStatus {\n  /** The state of the camera permission */\n  camera: PermissionState;\n  /** The state of the microphone permission */\n  microphone: PermissionState;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Main plugin interface for Capacitor Camera View functionality.\n *\n * @since 1.0.0\n */\nexport interface CameraViewPlugin {\n  /**\n   * Start the camera view with optional configuration.\n   *\n   * @param options - Configuration options for the camera session\n   * @returns A promise that resolves when the camera has started\n   *\n   * @since 1.0.0\n   */\n  start(options?: CameraSessionConfiguration): Promise<void>;\n\n  /**\n   * Stop the camera view and release resources.\n   *\n   * @returns A promise that resolves when the camera has stopped\n   *\n   * @since 1.0.0\n   */\n  stop(): Promise<void>;\n\n  /**\n   * Check if the camera view is currently running.\n   *\n   * @returns A promise that resolves with an object containing the running state of the camera\n   *\n   * @since 1.0.0\n   */\n  isRunning(): Promise<IsRunningResponse>;\n\n  /**\n   * Capture a photo using the current camera configuration.\n   *\n   * @param options - Capture configuration options\n   * @returns A promise that resolves with an object containing either a base64 encoded string or file path of the captured photo\n   *\n   * @since 1.0.0\n   */\n  capture<T extends CaptureOptions>(options: T): Promise<CaptureResponse<T>>;\n\n  /**\n   * Captures a frame from the current camera preview without using the full camera capture pipeline.\n   *\n   * Unlike `capture()` which may trigger hardware-level photo capture on native platforms,\n   * this method quickly samples the current video stream. This is suitable computer vision or\n   * simple snapshots where high fidelity is not required.\n   *\n   * On web this method does exactly the same as `capture()` as it only captures a frame from the video stream\n   * because unfortunately [ImageCapture API](https://developer.mozilla.org/en-US/docs/Web/API/ImageCapture) is\n   * not yet well supported on the web.\n   *\n   * @param options - Capture configuration options\n   * @returns A promise that resolves with an object containing either a base64 encoded string or file path of the captured sample\n   *\n   * @since 1.0.0\n   */\n  captureSample<T extends CaptureOptions>(options: T): Promise<CaptureResponse<T>>;\n\n  /**\n   * Start recording video from the current camera.\n   * Camera must be running. Throws if already recording.\n   *\n   * @param options - Optional recording configuration\n   * @returns A promise that resolves when recording has started\n   *\n   * @since 2.3.0\n   */\n  startRecording(options?: VideoRecordingOptions): Promise<void>;\n\n  /**\n   * Stop the current video recording and return the result.\n   * Throws if no recording is in progress.\n   *\n   * @returns A promise that resolves with the recorded video file path\n   *\n   * @since 2.3.0\n   */\n  stopRecording(): Promise<VideoRecordingResponse>;\n\n  /**\n   * Switch between front and back camera.\n   *\n   * @returns A promise that resolves when the camera has been flipped\n   *\n   * @since 1.0.0\n   */\n  flipCamera(): Promise<void>;\n\n  /**\n   * Get available camera devices for capturing photos.\n   *\n   * @returns A promise that resolves with an object containing an array of available capture devices\n   *\n   * @since 1.0.0\n   */\n  getAvailableDevices(): Promise<GetAvailableDevicesResponse>;\n\n  /**\n   * Get current zoom level information and available range.\n   *\n   * @remarks\n   * Make sure the camera is properly initialized before calling this method. Otherwise, this might\n   * lead to returning default values on android.\n   *\n   * @returns A promise that resolves with an object containing min, max and current zoom levels\n   *\n   * @since 1.0.0\n   */\n  getZoom(): Promise<GetZoomResponse>;\n\n  /**\n   * Set the camera zoom level.\n   *\n   * @param options - Zoom configuration options\n   * @param options.level - The zoom level to set\n   * @param options.ramp - Whether to animate the zoom level change, defaults to false (iOS only)\n   * @returns A promise that resolves when the zoom level has been set\n   *\n   * @remarks\n   * On web platforms, zoom functionality may be limited by browser support.\n   * When native zoom is not available, a CSS-based zoom simulation is applied.\n   *\n   * @since 1.0.0\n   */\n  setZoom(options: { level: number; ramp?: boolean }): Promise<void>;\n\n  /**\n   * Get current flash mode setting.\n   *\n   * @returns A promise that resolves with an object containing the current flash mode\n   *\n   * @since 1.0.0\n   */\n  getFlashMode(): Promise<GetFlashModeResponse>;\n\n  /**\n   * Get supported flash modes for the current camera.\n   *\n   * @returns A promise that resolves with an object containing an array of supported flash modes\n   *\n   * @since 1.0.0\n   */\n  getSupportedFlashModes(): Promise<GetSupportedFlashModesResponse>;\n\n  /**\n   * Set the camera flash mode.\n   *\n   * @param options - Flash mode configuration options\n   * @param options.mode - The flash mode to set\n   * @returns A promise that resolves when the flash mode has been set\n   *\n   * @since 1.0.0\n   */\n  setFlashMode(options: { mode: FlashMode }): Promise<void>;\n\n  /**\n   * Check if the device supports torch (flashlight) functionality.\n   *\n   * @remarks\n   * **Important**: You must call this method and verify torch availability before using\n   * `setTorchMode()` or `getTorchMode()`. Calling torch methods on devices without\n   * torch support will throw an exception.\n   *\n   * @returns A promise that resolves with an object containing torch availability status\n   *\n   * @since 1.2.0\n   */\n  isTorchAvailable(): Promise<IsTorchAvailableResponse>;\n\n  /**\n   * Get the current torch (flashlight) state.\n   *\n   * @remarks\n   * **Important**: Call `isTorchAvailable()` first to ensure the device supports torch\n   * functionality. This method will throw an exception if torch is not supported.\n   *\n   * @returns A promise that resolves with an object containing the current torch state\n   *\n   * @since 1.2.0\n   */\n  getTorchMode(): Promise<GetTorchModeResponse>;\n\n  /**\n   * Set the torch (flashlight) mode and intensity.\n   *\n   * @remarks\n   * **Important**: Call `isTorchAvailable()` first to ensure the device supports torch\n   * functionality. This method will throw an exception if torch is not supported.\n   *\n   * The torch provides continuous illumination, unlike flash which only activates during photo capture.\n   * On iOS, you can control the torch intensity level. On Android, the torch is either on or off.\n   *\n   * @param options - Torch configuration options\n   * @param options.enabled - Whether to enable or disable the torch\n   * @param options.level - The torch intensity level (0.0 to 1.0, iOS only). Defaults to 1.0 when enabled\n   * @returns A promise that resolves when the torch mode has been set\n   *\n   * @since 1.2.0\n   */\n  setTorchMode(options: { enabled: boolean; level?: number }): Promise<void>;\n\n  /**\n   * Check camera and microphone permission status without requesting permissions.\n   *\n   * @returns A promise that resolves with an object containing the camera and microphone permission status\n   *\n   * @since 1.0.0\n   */\n  checkPermissions(): Promise<PermissionStatus>;\n\n  /**\n   * Request camera and/or microphone permissions from the user.\n   *\n   * By default, only camera permission is requested. To also request microphone\n   * permission (needed for video recording with audio), pass `{ permissions: ['camera', 'microphone'] }`.\n   *\n   * @param options - Optional object specifying which permissions to request\n   * @returns A promise that resolves with an object containing the camera and microphone permission status\n   *\n   * @since 1.0.0\n   */\n  requestPermissions(options?: { permissions?: CameraPermissionType[] }): Promise<PermissionStatus>;\n\n  /**\n   * Listen for barcode detection events.\n   * This event is emitted when a barcode is detected in the camera preview.\n   *\n   * @param eventName - The name of the event to listen for ('barcodeDetected')\n   * @param listenerFunc - The callback function to execute when a barcode is detected\n   * @returns A promise that resolves with an event subscription\n   *\n   * @since 1.0.0\n   */\n  addListener(\n    eventName: 'barcodeDetected',\n    listenerFunc: (data: BarcodeDetectionData) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @param eventName - Optional event name to remove listeners for\n   * @returns A promise that resolves when the listeners are removed\n   *\n   * @since 1.0.0\n   */\n  removeAllListeners(eventName?: string): Promise<void>;\n}\n\n// ------------------------------------------------------------------------------\n// Camera Configuration Types\n// ------------------------------------------------------------------------------\n\n/**\n * Position options for the camera.\n * - 'front': Front-facing camera\n * - 'back': Rear-facing camera\n *\n * @since 1.0.0\n */\nexport type CameraPosition = 'front' | 'back';\n\n/**\n * Flash mode options for the camera.\n * - 'off': Flash disabled\n * - 'on': Flash always on\n * - 'auto': Flash automatically enabled in low-light conditions\n *\n * @since 1.0.0\n */\nexport type FlashMode = 'off' | 'on' | 'auto';\n\n/**\n * Video recording quality presets.\n *\n * @remarks\n * On iOS this maps to `AVCaptureSession.Preset` values.\n * On Android this maps to CameraX `QualitySelector` values.\n *\n * @since 2.3.0\n */\nexport type VideoRecordingQuality = 'lowest' | 'sd' | 'hd' | 'fhd' | 'uhd' | 'highest';\n\n/**\n * Represents a physical camera device on the device.\n *\n * @since 1.0.0\n */\nexport interface CameraDevice {\n  /** The unique identifier of the camera device */\n  id: string;\n\n  /** The human-readable name of the camera device */\n  name: string;\n\n  /** The position of the camera device (front or back) */\n  position: CameraPosition;\n\n  /** The type of the camera device (e.g., wide, ultra-wide, telephoto) - iOS only */\n  deviceType?: CameraDeviceType;\n}\n\n/**\n * Available camera device types for iOS.\n * Maps to AVCaptureDevice DeviceTypes in iOS.\n *\n * @see https://developer.apple.com/documentation/avfoundation/avcapturedevice/devicetype-swift.struct\n *\n * @since 1.0.0\n */\nexport type CameraDeviceType =\n  /** builtInWideAngleCamera - standard camera */\n  | 'wideAngle'\n  /** builtInUltraWideCamera - 0.5x zoom level */\n  | 'ultraWide'\n  /** builtInTelephotoCamera - 2x/3x zoom level */\n  | 'telephoto'\n  /** builtInDualCamera - wide + telephoto combination */\n  | 'dual'\n  /** builtInDualWideCamera - wide + ultraWide combination */\n  | 'dualWide'\n  /** builtInTripleCamera - wide + ultraWide + telephoto */\n  | 'triple'\n  /** builtInTrueDepthCamera - front-facing camera with depth sensing */\n  | 'trueDepth';\n\n/**\n * Supported barcode types for detection.\n * Specifying only the barcode types you need can improve performance\n * and reduce battery consumption.\n *\n * @since 2.1.0\n */\nexport type BarcodeType =\n  /** QR Code */\n  | 'qr'\n  /** Code 128 barcode */\n  | 'code128'\n  /** Code 39 barcode */\n  | 'code39'\n  /** Code 39 Mod 43 barcode */\n  | 'code39Mod43'\n  /** Code 93 barcode */\n  | 'code93'\n  /** EAN-8 barcode */\n  | 'ean8'\n  /** EAN-13 barcode */\n  | 'ean13'\n  /** Interleaved 2 of 5 barcode */\n  | 'interleaved2of5'\n  /** ITF-14 barcode */\n  | 'itf14'\n  /** PDF417 barcode */\n  | 'pdf417'\n  /** Aztec code */\n  | 'aztec'\n  /** Data Matrix code */\n  | 'dataMatrix'\n  /** UPC-E barcode */\n  | 'upce';\n\n/**\n * Configuration options for starting a camera session.\n *\n * @since 1.0.0\n */\nexport interface CameraSessionConfiguration {\n  /**\n   * Enables the barcode detection functionality\n   * @default false\n   */\n  enableBarcodeDetection?: boolean;\n\n  /**\n   * Specific barcode types to detect. If not provided, all supported types are detected.\n   * Specifying only the types you need can significantly improve performance and reduce\n   * battery consumption, especially on mobile devices.\n   *\n   * @example ['qr', 'code128'] // Only detect QR codes and Code 128 barcodes\n   * @default undefined - all supported types are detected\n   * @since 2.1.0\n   */\n  barcodeTypes?: BarcodeType[];\n\n  /**\n   * Position of the camera to use\n   * @default 'back'\n   */\n  position?: CameraPosition;\n\n  /**\n   * Specific device ID of the camera to use\n   * If provided, takes precedence over position\n   */\n  deviceId?: string;\n\n  /**\n   * Whether to use the triple camera if available (iPhone Pro models only)\n   * @default false\n   */\n  useTripleCameraIfAvailable?: boolean;\n\n  /**\n   * Ordered list of preferred camera device types to use (iOS only).\n   * The system will attempt to use the first available camera type in the list.\n   * If position is also provided, the system will use the first available camera type\n   * that matches the position and is in the list.\n   *\n   * This will fallback to the default camera type if none of the preferred types are available.\n   *\n   * @example [CameraDeviceType.WideAngle, CameraDeviceType.UltraWide, CameraDeviceType.Telephoto]\n   * @default undefined - system will decide based on position/deviceId\n   */\n  preferredCameraDeviceTypes?: CameraDeviceType[];\n\n  /**\n   * The initial zoom factor to use\n   * @default 1.0\n   */\n  zoomFactor?: number;\n\n  /**\n   * Optional HTML ID of the container element where the camera view should be rendered.\n   * If not provided, the camera view will be appended to the document body. Web only.\n   * @example 'cameraContainer'\n   */\n  containerElementId?: string;\n}\n\n/**\n * Configuration options for capturing photos and samples.\n *\n * @since 1.1.0\n */\nexport interface CaptureOptions {\n  /**\n   * The JPEG quality of the captured photo/sample on a scale of 0-100\n   * @since 1.1.0\n   */\n  quality: number;\n\n  /**\n   * If true, saves to a temporary file and returns the web path instead of base64.\n   * The web path can be used to set the src attribute of an image for efficient loading and rendering.\n   * This reduces the data that needs to be transferred over the bridge, which can improve performance\n   * especially for high-resolution images.\n   * @default false\n   * @since 1.1.0\n   */\n  saveToFile?: boolean;\n}\n\n/**\n * Configuration options for video recording.\n * @since 2.3.0\n */\nexport interface VideoRecordingOptions {\n  /**\n   * Whether to record audio with the video.\n   * Requires microphone permission.\n   * @default false\n   * @since 2.3.0\n   */\n  enableAudio?: boolean;\n\n  /**\n   * Video recording quality preset.\n   * Native platforms only (iOS/Android). Ignored on web.\n   * @default 'highest'\n   * @since 2.3.0\n   */\n  videoQuality?: VideoRecordingQuality;\n}\n\n/**\n * Response from stopping a video recording.\n * @since 2.3.0\n */\nexport interface VideoRecordingResponse {\n  /**\n   * Web-accessible path to the recorded video file.\n   * On web, this is a blob URL.\n   * On iOS/Android, this is a path accessible via Capacitor's filesystem.\n   * @since 2.3.0\n   */\n  webPath: string;\n}\n\n// ------------------------------------------------------------------------------\n// Response Interfaces\n// ------------------------------------------------------------------------------\n\n/**\n * Response for checking if the camera view is running.\n *\n * @since 1.0.0\n */\nexport interface IsRunningResponse {\n  /** Indicates if the camera view is currently active and running */\n  isRunning: boolean;\n}\n\n/**\n * Response for capturing a photo\n * This will contain either a base64 encoded string or a web path to the captured photo,\n * depending on the `saveToFile` option in the CaptureOptions.\n * @since 1.0.0\n */\nexport type CaptureResponse<T extends CaptureOptions = CaptureOptions> = T['saveToFile'] extends true\n  ? {\n      /** The web path to the captured photo that can be used to set the src attribute of an image for efficient loading and rendering (when saveToFile is true) */\n      webPath: string;\n    }\n  : {\n      /** The base64 encoded string of the captured photo (when saveToFile is false or undefined) */\n      photo: string;\n    };\n\n/**\n * Response for getting available camera devices.\n *\n * @since 1.0.0\n */\nexport interface GetAvailableDevicesResponse {\n  /** An array of available camera devices */\n  devices: CameraDevice[];\n}\n\n/**\n * Response for getting zoom level information.\n *\n * @since 1.0.0\n */\nexport interface GetZoomResponse {\n  /** The minimum zoom level supported */\n  min: number;\n\n  /** The maximum zoom level supported */\n  max: number;\n\n  /** The current zoom level */\n  current: number;\n}\n\n/**\n * Response for getting the current flash mode.\n *\n * @since 1.0.0\n */\nexport interface GetFlashModeResponse {\n  /** The current flash mode setting */\n  flashMode: FlashMode;\n}\n\n/**\n * Response for getting supported flash modes.\n *\n * @since 1.0.0\n */\nexport interface GetSupportedFlashModesResponse {\n  /** An array of flash modes supported by the current camera */\n  flashModes: FlashMode[];\n}\n\n/**\n * Response for checking torch availability.\n *\n * @since 1.2.0\n */\nexport interface IsTorchAvailableResponse {\n  /** Indicates if the device supports torch (flashlight) functionality */\n  available: boolean;\n}\n\n/**\n * Response for getting the current torch mode.\n *\n * @since 1.2.0\n */\nexport interface GetTorchModeResponse {\n  /** Indicates if the torch is currently enabled */\n  enabled: boolean;\n  /** The current torch intensity level (0.0 to 1.0, iOS only). Always 1.0 on Android when enabled */\n  level: number;\n}\n\n/**\n * Data for a detected barcode.\n *\n * @since 1.0.0\n */\nexport interface BarcodeDetectionData {\n  /** The decoded string value of the barcode */\n  value: string;\n\n  /**\n   * Raw bytes as they were encoded in the barcode.\n   *\n   * On Android, this is forwarded from ML Kit.\n   * On iOS, this is available for descriptor-backed formats such as QR, Aztec, PDF417, and Data Matrix.\n   * On web, this is not available because the Barcode Detection API only exposes the decoded string value.\n   *\n   * @since 2.2.0\n   */\n  rawBytes?: number[];\n\n  /**\n   * The display value of the barcode on Android.\n   *\n   * This is forwarded from ML Kit and may contain a formatted, human-readable\n   * representation that differs from the raw decoded value. iOS and web do not\n   * expose a separate display value, so this property is only emitted on Android.\n   */\n  displayValue?: string;\n\n  /** The type/format of the barcode (e.g., 'qr', 'code128', etc.) */\n  type: string;\n\n  /** The bounding rectangle of the barcode in the camera frame. */\n  boundingRect: BoundingRect;\n}\n\n/**\n * Rectangle defining the boundary of the barcode in the camera frame.\n * Coordinates are normalized between 0 and 1 relative to the camera frame.\n *\n * @since 1.0.0\n */\nexport interface BoundingRect {\n  /** X-coordinate of the top-left corner */\n  x: number;\n  /** Y-coordinate of the top-left corner */\n  y: number;\n  /** Width of the bounding rectangle (should match the actual width of the barcode) */\n  width: number;\n  /** Height of the bounding rectangle (should match the actual height of the barcode) */\n  height: number;\n}\n\n/**\n * Permission types that can be requested.\n * - 'camera': Camera access permission\n * - 'microphone': Microphone access permission (needed for video recording with audio)\n *\n * @since 2.3.0\n */\nexport type CameraPermissionType = 'camera' | 'microphone';\n\n/**\n * Response for the camera and microphone permission status.\n *\n * @since 1.0.0\n */\nexport interface PermissionStatus {\n  /** The state of the camera permission */\n  camera: PermissionState;\n  /** The state of the microphone permission */\n  microphone: PermissionState;\n}\n"]}

package/dist/esm/web.js

@@ -260,6 +260,12 @@ export class CameraViewWeb extends WebPlugin {
             this.mediaRecorder.start(100); // Collect data in 100ms chunks
         }
         catch (err) {
+            if (this.recordingAudioTrack) {
+                this.recordingAudioTrack.stop();
+                this.recordingAudioTrack = null;
+            }
+            this.mediaRecorder = null;
+            this.recordedChunks = [];
             throw new Error(`Failed to start recording: ${this.formatError(err)}`);
         }
     }