@capgo/camera-preview 7.3.9 → 7.4.0-beta.2

package/dist/esm/definitions.d.ts

@@ -1,175 +1,432 @@
 export type CameraPosition = "rear" | "front";
+export type FlashMode = CameraPreviewFlashMode;
+export declare enum DeviceType {
+    ULTRA_WIDE = "ultraWide",
+    WIDE_ANGLE = "wideAngle",
+    TELEPHOTO = "telephoto",
+    TRUE_DEPTH = "trueDepth",
+    DUAL = "dual",
+    DUAL_WIDE = "dualWide",
+    TRIPLE = "triple"
+}
+/**
+ * Represents a single camera lens on a device. A {@link CameraDevice} can have multiple lenses.
+ */
+export interface CameraLens {
+    /** A human-readable name for the lens, e.g., "Ultra-Wide". */
+    label: string;
+    /** The type of the camera lens. */
+    deviceType: DeviceType;
+    /** The focal length of the lens in millimeters. */
+    focalLength: number;
+    /** The base zoom factor for this lens (e.g., 0.5 for ultra-wide, 1.0 for wide). */
+    baseZoomRatio: number;
+    /** The minimum zoom factor supported by this specific lens. */
+    minZoom: number;
+    /** The maximum zoom factor supported by this specific lens. */
+    maxZoom: number;
+}
+/**
+ * Represents a physical camera on the device (e.g., the front-facing camera).
+ */
+export interface CameraDevice {
+    /** A unique identifier for the camera device. */
+    deviceId: string;
+    /** A human-readable name for the camera device. */
+    label: string;
+    /** The physical position of the camera on the device. */
+    position: CameraPosition;
+    /** A list of all available lenses for this camera device. */
+    lenses: CameraLens[];
+    /** The overall minimum zoom factor available across all lenses on this device. */
+    minZoom: number;
+    /** The overall maximum zoom factor available across all lenses on this device. */
+    maxZoom: number;
+    /** Identifies whether the device is a logical camera (composed of multiple physical lenses). */
+    isLogical: boolean;
+}
+/**
+ * Represents the detailed information of the currently active lens.
+ */
+export interface LensInfo {
+    /** The focal length of the active lens in millimeters. */
+    focalLength: number;
+    /** The device type of the active lens. */
+    deviceType: DeviceType;
+    /** The base zoom ratio of the active lens (e.g., 0.5x, 1.0x). */
+    baseZoomRatio: number;
+    /** The current digital zoom factor applied on top of the base zoom. */
+    digitalZoom: number;
+}
+/**
+ * Defines the configuration options for starting the camera preview.
+ */
 export interface CameraPreviewOptions {
-    /** Parent element to attach the video preview element to (applicable to the web platform only) */
+    /**
+     * The parent element to attach the video preview to.
+     * @platform web
+     */
     parent?: string;
-    /** Class name to add to the video preview element (applicable to the web platform only) */
+    /**
+     * A CSS class name to add to the preview element.
+     * @platform web
+     */
     className?: string;
-    /** The preview width in pixels, default window.screen.width */
+    /**
+     * The width of the preview in pixels. Defaults to the screen width.
+     * @platform android, ios, web
+     */
     width?: number;
-    /** The preview height in pixels, default window.screen.height */
+    /**
+     * The height of the preview in pixels. Defaults to the screen height.
+     * @platform android, ios, web
+     */
     height?: number;
-    /** The x origin, default 0 (applicable to the android and ios platforms only) */
+    /**
+     * The horizontal origin of the preview, in pixels.
+     * @platform android, ios
+     */
     x?: number;
-    /** The y origin, default 0 (applicable to the android and ios platforms only) */
+    /**
+     * The vertical origin of the preview, in pixels.
+     * @platform android, ios
+     */
     y?: number;
-    /** Whether to include safe area insets in y-position calculation, default false (applicable to the ios platform only) */
+    /**
+     * Adjusts the y-position to account for safe areas (e.g., notches).
+     * @platform ios
+     * @default false
+     */
     includeSafeAreaInsets?: boolean;
-    /**  Brings your html in front of your preview, default false (applicable to the android only) */
+    /**
+     * If true, places the preview behind the webview.
+     * @platform android
+     * @default true
+     */
     toBack?: boolean;
-    /** The preview bottom padding in pixes. Useful to keep the appropriate preview sizes when orientation changes (applicable to the android and ios platforms only) */
+    /**
+     * Bottom padding for the preview, in pixels.
+     * @platform android, ios
+     */
     paddingBottom?: number;
-    /** Rotate preview when orientation changes (applicable to the ios platforms only; default value is true) */
+    /**
+     * Whether to rotate the preview when the device orientation changes.
+     * @platform ios
+     * @default true
+     */
     rotateWhenOrientationChanged?: boolean;
-    /** Choose the camera to use 'front' or 'rear', default 'front' */
+    /**
+     * The camera to use.
+     * @default "rear"
+     */
     position?: CameraPosition | string;
-    /** Defaults to false - Capture images to a file and return the file path instead of returning base64 encoded data */
+    /**
+     * If true, saves the captured image to a file and returns the file path.
+     * If false, returns a base64 encoded string.
+     * @default false
+     */
     storeToFile?: boolean;
-    /** Defaults to false - Android Only - Disable automatic rotation of the image, and let the browser deal with it (keep reading on how to achieve it) */
+    /**
+     * If true, prevents the plugin from rotating the image based on EXIF data.
+     * @platform android
+     * @default false
+     */
     disableExifHeaderStripping?: boolean;
-    /** Defaults to false - iOS only - Activate high resolution image capture so that output images are from the highest resolution possible on the device **/
+    /**
+     * If true, enables high-resolution image capture.
+     * @platform ios
+     * @default false
+     */
     enableHighResolution?: boolean;
-    /** Defaults to false - Disables audio stream to prevent permission requests and output switching */
+    /**
+     * If true, disables the audio stream, preventing audio permission requests.
+     * @default false
+     */
     disableAudio?: boolean;
-    /**  Android Only - Locks device orientation when camera is showing. */
+    /**
+     * If true, locks the device orientation while the camera is active.
+     * @platform android
+     * @default false
+     */
     lockAndroidOrientation?: boolean;
-    /** Defaults to false - Android and Web only.  Set if camera preview can change opacity. */
+    /**
+     * If true, allows the camera preview's opacity to be changed.
+     * @platform android, web
+     * @default false
+     */
     enableOpacity?: boolean;
-    /** Defaults to false - Android only.  Set if camera preview will support pinch to zoom. */
+    /**
+     * If true, enables pinch-to-zoom functionality on the preview.
+     * @platform android
+     * @default false
+     */
     enableZoom?: boolean;
-    /** default to false - IOS only. Set the CameraPreview to use the video mode preset */
-    cameraMode?: boolean;
+    /**
+     * If true, uses the video-optimized preset for the camera session.
+     * @platform ios
+     * @default false
+     */
+    enableVideoMode?: boolean;
+    /**
+     * The `deviceId` of the camera to use. If provided, `position` is ignored.
+     * @platform ios
+     */
+    deviceId?: string;
 }
+/**
+ * Defines the options for capturing a picture.
+ */
 export interface CameraPreviewPictureOptions {
-    /** The picture height, optional, default 0 (Device default) */
+    /** The desired height of the picture in pixels. If not provided, the device default is used. */
     height?: number;
-    /** The picture width, optional, default 0 (Device default) */
+    /** The desired width of the picture in pixels. If not provided, the device default is used. */
     width?: number;
-    /** The picture quality, 0 - 100, default 85 */
+    /**
+     * The quality of the captured image, from 0 to 100.
+     * Does not apply to `png` format.
+     * @default 85
+     */
     quality?: number;
-    /** The picture format, jpeg or png, default jpeg on `Web`.
-     *
-     * quality has no effect on png */
+    /**
+     * The format of the captured image.
+     * @default "jpeg"
+     */
     format?: PictureFormat;
+    /**
+     * If true, the captured image will be saved to the user's gallery.
+     * @default false
+     * @since 7.5.0
+     */
+    saveToGallery?: boolean;
+}
+/** Represents EXIF data extracted from an image. */
+export interface ExifData {
+    [key: string]: any;
 }
 export type PictureFormat = "jpeg" | "png";
+/** Defines a standard picture size with width and height. */
+export interface PictureSize {
+    /** The width of the picture in pixels. */
+    width: number;
+    /** The height of the picture in pixels. */
+    height: number;
+}
+/** Represents the supported picture sizes for a camera facing a certain direction. */
+export interface SupportedPictureSizes {
+    /** The camera direction ("front" or "rear"). */
+    facing: string;
+    /** A list of supported picture sizes for this camera. */
+    supportedPictureSizes: PictureSize[];
+}
+/**
+ * Defines the options for capturing a sample frame from the camera preview.
+ */
 export interface CameraSampleOptions {
-    /** The picture quality, 0 - 100, default 85 */
+    /**
+     * The quality of the captured sample, from 0 to 100.
+     * @default 85
+     */
     quality?: number;
 }
-export type CameraPreviewFlashMode = "off" | "on" | "auto" | "red-eye" | "torch";
+/**
+ * The available flash modes for the camera.
+ * 'torch' is a continuous light mode.
+ */
+export type CameraPreviewFlashMode = "off" | "on" | "auto" | "torch";
+/**
+ * Defines the options for setting the camera preview's opacity.
+ */
 export interface CameraOpacityOptions {
-    /** The percent opacity to set for camera view, default 1 */
+    /**
+     * The opacity percentage, from 0.0 (fully transparent) to 1.0 (fully opaque).
+     * @default 1.0
+     */
     opacity?: number;
 }
+/**
+ * The main interface for the CameraPreview plugin.
+ */
 export interface CameraPreviewPlugin {
     /**
-     * Start the camera preview instance.
-     * @param {CameraPreviewOptions} options the options to start the camera preview with
-     * @returns {Promise<void>} an Promise that resolves when the instance is started
-     * @throws An error if the something went wrong
+     * Starts the camera preview.
+     *
+     * @param {CameraPreviewOptions} options - The configuration for the camera preview.
+     * @returns {Promise<void>} A promise that resolves when the camera preview is started.
      * @since 0.0.1
      */
     start(options: CameraPreviewOptions): Promise<void>;
     /**
-     * Stop the camera preview instance.
-     * @returns {Promise<void>} an Promise that resolves when the instance is stopped
-     * @throws An error if the something went wrong
+     * Stops the camera preview.
+     *
+     * @returns {Promise<void>} A promise that resolves when the camera preview is stopped.
      * @since 0.0.1
      */
     stop(): Promise<void>;
     /**
-     * Switch camera.
-     * @param {CameraPreviewOptions} options the options to switch the camera with
-     * @returns {Promise<void>} an Promise that resolves when the camera is switched
-     * @throws An error if the something went wrong
+     * Captures a picture from the camera.
+     *
+     * @param {CameraPreviewPictureOptions} options - The options for capturing the picture.
+     * @returns {Promise<{ value: string }>} A promise that resolves with the captured image data.
+     * The `value` is a base64 encoded string unless `storeToFile` is true, in which case it's a file path.
      * @since 0.0.1
      */
     capture(options: CameraPreviewPictureOptions): Promise<{
         value: string;
+        exif: ExifData;
     }>;
     /**
-     * Capture a sample image.
-     * @param {CameraSampleOptions} options the options to capture the sample image with
-     * @returns {Promise<string>} an Promise that resolves with the sample image as a base64 encoded string
-     * @throws An error if the something went wrong
+     * Captures a single frame from the camera preview stream.
+     *
+     * @param {CameraSampleOptions} options - The options for capturing the sample.
+     * @returns {Promise<{ value: string }>} A promise that resolves with the sample image as a base64 encoded string.
      * @since 0.0.1
      */
     captureSample(options: CameraSampleOptions): Promise<{
         value: string;
     }>;
     /**
-     * Get supported flash modes.
-     * @returns {Promise<CameraPreviewFlashMode[]>} an Promise that resolves with the supported flash modes
-     * @throws An error if the something went wrong
+     * Gets the flash modes supported by the active camera.
+     *
+     * @returns {Promise<{ result: CameraPreviewFlashMode[] }>} A promise that resolves with an array of supported flash modes.
      * @since 0.0.1
      */
     getSupportedFlashModes(): Promise<{
         result: CameraPreviewFlashMode[];
     }>;
     /**
-     * Get horizontal field of view.
-     * @returns {Promise<any>} an Promise that resolves with the horizontal field of view
-     * @throws An error if the something went wrong
+     * Gets the horizontal field of view (FoV) for the active camera.
+     * Note: This can be an estimate on some devices.
+     *
+     * @returns {Promise<{ result: number }>} A promise that resolves with the horizontal field of view in degrees.
      * @since 0.0.1
      */
     getHorizontalFov(): Promise<{
-        result: any;
+        result: number;
     }>;
     /**
-     * Gets the supported picture sizes for a given device.
-     * @returns {Promise<any>} an Promise that resolves with the supported picture sizes for a given device
-     * @throws An error if the something goes wrong
+     * Gets the supported picture sizes for all cameras.
+     *
+     * @returns {Promise<{ supportedPictureSizes: SupportedPictureSizes[] }>} A promise that resolves with the list of supported sizes.
+     * @since 7.4.0
      */
     getSupportedPictureSizes(): Promise<{
-        supportedPictureSizes: {
-            facing: string;
-            supportedPictureSizes: {
-                width: number;
-                height: number;
-            }[];
-        }[];
+        supportedPictureSizes: SupportedPictureSizes[];
     }>;
     /**
-     * Set flash mode.
-     * @param options the options to set the flash mode with
-     * @returns {Promise<void>} an Promise that resolves when the flash mode is set
-     * @throws An error if the something went wrong
+     * Sets the flash mode for the active camera.
+     *
+     * @param {{ flashMode: CameraPreviewFlashMode | string }} options - The desired flash mode.
+     * @returns {Promise<void>} A promise that resolves when the flash mode is set.
      * @since 0.0.1
      */
     setFlashMode(options: {
         flashMode: CameraPreviewFlashMode | string;
     }): Promise<void>;
     /**
-     * Flip camera.
-     * @returns {Promise<void>} an Promise that resolves when the camera is flipped
-     * @throws An error if the something went wrong
+     * Toggles between the front and rear cameras.
+     *
+     * @returns {Promise<void>} A promise that resolves when the camera is flipped.
      * @since 0.0.1
      */
     flip(): Promise<void>;
     /**
-     * Set opacity.
-     * @param {CameraOpacityOptions} options the options to set the camera opacity with
-     * @returns {Promise<void>} an Promise that resolves when the camera color effect is set
-     * @throws An error if the something went wrong
+     * Sets the opacity of the camera preview.
+     *
+     * @param {CameraOpacityOptions} options - The opacity options.
+     * @returns {Promise<void>} A promise that resolves when the opacity is set.
      * @since 0.0.1
      */
     setOpacity(options: CameraOpacityOptions): Promise<void>;
     /**
-     * Stop recording video.
-     * @param {CameraPreviewOptions} options the options to stop recording video with
-     * @returns {Promise<{videoFilePath: string}>} an Promise that resolves when the camera zoom is set
-     * @throws An error if the something went wrong
+     * Stops an ongoing video recording.
+     *
+     * @returns {Promise<{ videoFilePath: string }>} A promise that resolves with the path to the recorded video file.
      * @since 0.0.1
      */
     stopRecordVideo(): Promise<{
         videoFilePath: string;
     }>;
     /**
-     * Start recording video.
-     * @param {CameraPreviewOptions} options the options to start recording video with
-     * @returns {Promise<void>} an Promise that resolves when the video recording is started
-     * @throws An error if the something went wrong
+     * Starts recording a video.
+     *
+     * @param {CameraPreviewOptions} options - The options for video recording.
+     * @returns {Promise<void>} A promise that resolves when video recording starts.
      * @since 0.0.1
      */
     startRecordVideo(options: CameraPreviewOptions): Promise<void>;
+    /**
+     * Checks if the camera preview is currently running.
+     *
+     * @returns {Promise<{ isRunning: boolean }>} A promise that resolves with the running state.
+     * @since 7.4.0
+     */
+    isRunning(): Promise<{
+        isRunning: boolean;
+    }>;
+    /**
+     * Gets all available camera devices.
+     *
+     * @returns {Promise<{ devices: CameraDevice[] }>} A promise that resolves with the list of available camera devices.
+     * @since 7.4.0
+     */
+    getAvailableDevices(): Promise<{
+        devices: CameraDevice[];
+    }>;
+    /**
+     * Gets the current zoom state, including min/max and current lens info.
+     *
+     * @returns {Promise<{ min: number; max: number; current: number; lens: LensInfo }>} A promise that resolves with the zoom state.
+     * @since 7.4.0
+     */
+    getZoom(): Promise<{
+        min: number;
+        max: number;
+        current: number;
+        lens: LensInfo;
+    }>;
+    /**
+     * Sets the camera's zoom level.
+     *
+     * @param {{ level: number; ramp?: boolean }} options - The desired zoom level. `ramp` is currently unused.
+     * @returns {Promise<void>} A promise that resolves when the zoom level is set.
+     * @since 7.4.0
+     */
+    setZoom(options: {
+        level: number;
+        ramp?: boolean;
+    }): Promise<void>;
+    /**
+     * Gets the current flash mode.
+     *
+     * @returns {Promise<{ flashMode: FlashMode }>} A promise that resolves with the current flash mode.
+     * @since 7.4.0
+     */
+    getFlashMode(): Promise<{
+        flashMode: FlashMode;
+    }>;
+    /**
+     * Removes all registered listeners.
+     *
+     * @since 7.4.0
+     */
+    removeAllListeners(): Promise<void>;
+    /**
+     * Switches the active camera to the one with the specified `deviceId`.
+     *
+     * @param {{ deviceId: string }} options - The ID of the device to switch to.
+     * @returns {Promise<void>} A promise that resolves when the camera is switched.
+     * @since 7.4.0
+     */
+    setDeviceId(options: {
+        deviceId: string;
+    }): Promise<void>;
+    /**
+     * Gets the ID of the currently active camera device.
+     *
+     * @returns {Promise<{ deviceId: string }>} A promise that resolves with the current device ID.
+     * @since 7.4.0
+     */
+    getDeviceId(): Promise<{
+        deviceId: string;
+    }>;
 }

package/dist/esm/definitions.js

@@ -1,2 +1,11 @@
-export {};
+export var DeviceType;
+(function (DeviceType) {
+    DeviceType["ULTRA_WIDE"] = "ultraWide";
+    DeviceType["WIDE_ANGLE"] = "wideAngle";
+    DeviceType["TELEPHOTO"] = "telephoto";
+    DeviceType["TRUE_DEPTH"] = "trueDepth";
+    DeviceType["DUAL"] = "dual";
+    DeviceType["DUAL_WIDE"] = "dualWide";
+    DeviceType["TRIPLE"] = "triple";
+})(DeviceType || (DeviceType = {}));
 //# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export type CameraPosition = \"rear\" | \"front\";\nexport interface CameraPreviewOptions {\n  /** Parent element to attach the video preview element to (applicable to the web platform only) */\n  parent?: string;\n  /** Class name to add to the video preview element (applicable to the web platform only) */\n  className?: string;\n  /** The preview width in pixels, default window.screen.width */\n  width?: number;\n  /** The preview height in pixels, default window.screen.height */\n  height?: number;\n  /** The x origin, default 0 (applicable to the android and ios platforms only) */\n  x?: number;\n  /** The y origin, default 0 (applicable to the android and ios platforms only) */\n  y?: number;\n  /** Whether to include safe area insets in y-position calculation, default false (applicable to the ios platform only) */\n  includeSafeAreaInsets?: boolean;\n  /**  Brings your html in front of your preview, default false (applicable to the android only) */\n  toBack?: boolean;\n  /** The preview bottom padding in pixes. Useful to keep the appropriate preview sizes when orientation changes (applicable to the android and ios platforms only) */\n  paddingBottom?: number;\n  /** Rotate preview when orientation changes (applicable to the ios platforms only; default value is true) */\n  rotateWhenOrientationChanged?: boolean;\n  /** Choose the camera to use 'front' or 'rear', default 'front' */\n  position?: CameraPosition | string;\n  /** Defaults to false - Capture images to a file and return the file path instead of returning base64 encoded data */\n  storeToFile?: boolean;\n  /** Defaults to false - Android Only - Disable automatic rotation of the image, and let the browser deal with it (keep reading on how to achieve it) */\n  disableExifHeaderStripping?: boolean;\n  /** Defaults to false - iOS only - Activate high resolution image capture so that output images are from the highest resolution possible on the device **/\n  enableHighResolution?: boolean;\n  /** Defaults to false - Disables audio stream to prevent permission requests and output switching */\n  disableAudio?: boolean;\n  /**  Android Only - Locks device orientation when camera is showing. */\n  lockAndroidOrientation?: boolean;\n  /** Defaults to false - Android and Web only.  Set if camera preview can change opacity. */\n  enableOpacity?: boolean;\n  /** Defaults to false - Android only.  Set if camera preview will support pinch to zoom. */\n  enableZoom?: boolean;\n  /** default to false - IOS only. Set the CameraPreview to use the video mode preset */\n  cameraMode?: boolean;\n}\n\nexport interface CameraPreviewPictureOptions {\n  /** The picture height, optional, default 0 (Device default) */\n  height?: number;\n  /** The picture width, optional, default 0 (Device default) */\n  width?: number;\n  /** The picture quality, 0 - 100, default 85 */\n  quality?: number;\n  /** The picture format, jpeg or png, default jpeg on `Web`.\n   *\n   * quality has no effect on png */\n  format?: PictureFormat;\n}\n\nexport type PictureFormat = \"jpeg\" | \"png\";\n\nexport interface CameraSampleOptions {\n  /** The picture quality, 0 - 100, default 85 */\n  quality?: number;\n}\n\nexport type CameraPreviewFlashMode =\n  | \"off\"\n  | \"on\"\n  | \"auto\"\n  | \"red-eye\"\n  | \"torch\";\n\nexport interface CameraOpacityOptions {\n  /** The percent opacity to set for camera view, default 1 */\n  opacity?: number;\n}\n\nexport interface CameraPreviewPlugin {\n  /**\n   * Start the camera preview instance.\n   * @param {CameraPreviewOptions} options the options to start the camera preview with\n   * @returns {Promise<void>} an Promise that resolves when the instance is started\n   * @throws An error if the something went wrong\n   * @since 0.0.1\n   */\n  start(options: CameraPreviewOptions): Promise<void>;\n  /**\n   * Stop the camera preview instance.\n   * @returns {Promise<void>} an Promise that resolves when the instance is stopped\n   * @throws An error if the something went wrong\n   * @since 0.0.1\n   */\n  stop(): Promise<void>;\n  /**\n   * Switch camera.\n   * @param {CameraPreviewOptions} options the options to switch the camera with\n   * @returns {Promise<void>} an Promise that resolves when the camera is switched\n   * @throws An error if the something went wrong\n   * @since 0.0.1\n   */\n  capture(options: CameraPreviewPictureOptions): Promise<{ value: string }>;\n  /**\n   * Capture a sample image.\n   * @param {CameraSampleOptions} options the options to capture the sample image with\n   * @returns {Promise<string>} an Promise that resolves with the sample image as a base64 encoded string\n   * @throws An error if the something went wrong\n   * @since 0.0.1\n   */\n  captureSample(options: CameraSampleOptions): Promise<{ value: string }>;\n  /**\n   * Get supported flash modes.\n   * @returns {Promise<CameraPreviewFlashMode[]>} an Promise that resolves with the supported flash modes\n   * @throws An error if the something went wrong\n   * @since 0.0.1\n   */\n  getSupportedFlashModes(): Promise<{\n    result: CameraPreviewFlashMode[];\n  }>;\n  /**\n   * Get horizontal field of view.\n   * @returns {Promise<any>} an Promise that resolves with the horizontal field of view\n   * @throws An error if the something went wrong\n   * @since 0.0.1\n   */\n  getHorizontalFov(): Promise<{\n    result: any;\n  }>;\n  /**\n   * Gets the supported picture sizes for a given device.\n   * @returns {Promise<any>} an Promise that resolves with the supported picture sizes for a given device\n   * @throws An error if the something goes wrong\n   */\n  getSupportedPictureSizes(): Promise<{\n    supportedPictureSizes: {\n      facing: string;\n      supportedPictureSizes: { width: number; height: number }[];\n    }[];\n  }>;\n  /**\n   * Set flash mode.\n   * @param options the options to set the flash mode with\n   * @returns {Promise<void>} an Promise that resolves when the flash mode is set\n   * @throws An error if the something went wrong\n   * @since 0.0.1\n   */\n  setFlashMode(options: {\n    flashMode: CameraPreviewFlashMode | string;\n  }): Promise<void>;\n  /**\n   * Flip camera.\n   * @returns {Promise<void>} an Promise that resolves when the camera is flipped\n   * @throws An error if the something went wrong\n   * @since 0.0.1\n   */\n  flip(): Promise<void>;\n  /**\n   * Set opacity.\n   * @param {CameraOpacityOptions} options the options to set the camera opacity with\n   * @returns {Promise<void>} an Promise that resolves when the camera color effect is set\n   * @throws An error if the something went wrong\n   * @since 0.0.1\n   */\n  setOpacity(options: CameraOpacityOptions): Promise<void>;\n  /**\n   * Stop recording video.\n   * @param {CameraPreviewOptions} options the options to stop recording video with\n   * @returns {Promise<{videoFilePath: string}>} an Promise that resolves when the camera zoom is set\n   * @throws An error if the something went wrong\n   * @since 0.0.1\n   */\n  stopRecordVideo(): Promise<{ videoFilePath: string }>;\n  /**\n   * Start recording video.\n   * @param {CameraPreviewOptions} options the options to start recording video with\n   * @returns {Promise<void>} an Promise that resolves when the video recording is started\n   * @throws An error if the something went wrong\n   * @since 0.0.1\n   */\n  startRecordVideo(options: CameraPreviewOptions): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,UAQX;AARD,WAAY,UAAU;IACpB,sCAAwB,CAAA;IACxB,sCAAwB,CAAA;IACxB,qCAAuB,CAAA;IACvB,sCAAwB,CAAA;IACxB,2BAAa,CAAA;IACb,oCAAsB,CAAA;IACtB,+BAAiB,CAAA;AACnB,CAAC,EARW,UAAU,KAAV,UAAU,QAQrB","sourcesContent":["export type CameraPosition = \"rear\" | \"front\";\n\nexport type FlashMode = CameraPreviewFlashMode;\n\nexport enum DeviceType {\n  ULTRA_WIDE = \"ultraWide\",\n  WIDE_ANGLE = \"wideAngle\",\n  TELEPHOTO = \"telephoto\",\n  TRUE_DEPTH = \"trueDepth\",\n  DUAL = \"dual\",\n  DUAL_WIDE = \"dualWide\",\n  TRIPLE = \"triple\",\n}\n\n/**\n * Represents a single camera lens on a device. A {@link CameraDevice} can have multiple lenses.\n */\nexport interface CameraLens {\n  /** A human-readable name for the lens, e.g., \"Ultra-Wide\". */\n  label: string;\n  /** The type of the camera lens. */\n  deviceType: DeviceType;\n  /** The focal length of the lens in millimeters. */\n  focalLength: number;\n  /** The base zoom factor for this lens (e.g., 0.5 for ultra-wide, 1.0 for wide). */\n  baseZoomRatio: number;\n  /** The minimum zoom factor supported by this specific lens. */\n  minZoom: number;\n  /** The maximum zoom factor supported by this specific lens. */\n  maxZoom: number;\n}\n\n/**\n * Represents a physical camera on the device (e.g., the front-facing camera).\n */\nexport interface CameraDevice {\n  /** A unique identifier for the camera device. */\n  deviceId: string;\n  /** A human-readable name for the camera device. */\n  label: string;\n  /** The physical position of the camera on the device. */\n  position: CameraPosition;\n  /** A list of all available lenses for this camera device. */\n  lenses: CameraLens[];\n  /** The overall minimum zoom factor available across all lenses on this device. */\n  minZoom: number;\n  /** The overall maximum zoom factor available across all lenses on this device. */\n  maxZoom: number;\n  /** Identifies whether the device is a logical camera (composed of multiple physical lenses). */\n  isLogical: boolean;\n}\n\n/**\n * Represents the detailed information of the currently active lens.\n */\nexport interface LensInfo {\n  /** The focal length of the active lens in millimeters. */\n  focalLength: number;\n  /** The device type of the active lens. */\n  deviceType: DeviceType;\n  /** The base zoom ratio of the active lens (e.g., 0.5x, 1.0x). */\n  baseZoomRatio: number;\n  /** The current digital zoom factor applied on top of the base zoom. */\n  digitalZoom: number;\n}\n\n/**\n * Defines the configuration options for starting the camera preview.\n */\nexport interface CameraPreviewOptions {\n  /** \n   * The parent element to attach the video preview to.\n   * @platform web\n   */\n  parent?: string;\n  /** \n   * A CSS class name to add to the preview element.\n   * @platform web\n   */\n  className?: string;\n  /** \n   * The width of the preview in pixels. Defaults to the screen width.\n   * @platform android, ios, web\n   */\n  width?: number;\n  /** \n   * The height of the preview in pixels. Defaults to the screen height.\n   * @platform android, ios, web\n   */\n  height?: number;\n  /** \n   * The horizontal origin of the preview, in pixels.\n   * @platform android, ios\n   */\n  x?: number;\n  /** \n   * The vertical origin of the preview, in pixels.\n   * @platform android, ios\n   */\n  y?: number;\n  /** \n   * Adjusts the y-position to account for safe areas (e.g., notches).\n   * @platform ios\n   * @default false\n   */\n  includeSafeAreaInsets?: boolean;\n  /** \n   * If true, places the preview behind the webview.\n   * @platform android\n   * @default true\n   */\n  toBack?: boolean;\n  /** \n   * Bottom padding for the preview, in pixels.\n   * @platform android, ios\n   */\n  paddingBottom?: number;\n  /** \n   * Whether to rotate the preview when the device orientation changes.\n   * @platform ios\n   * @default true\n   */\n  rotateWhenOrientationChanged?: boolean;\n  /** \n   * The camera to use.\n   * @default \"rear\"\n   */\n  position?: CameraPosition | string;\n  /** \n   * If true, saves the captured image to a file and returns the file path.\n   * If false, returns a base64 encoded string.\n   * @default false\n   */\n  storeToFile?: boolean;\n  /** \n   * If true, prevents the plugin from rotating the image based on EXIF data.\n   * @platform android\n   * @default false\n   */\n  disableExifHeaderStripping?: boolean;\n  /** \n   * If true, enables high-resolution image capture.\n   * @platform ios\n   * @default false\n   */\n  enableHighResolution?: boolean;\n  /** \n   * If true, disables the audio stream, preventing audio permission requests.\n   * @default false\n   */\n  disableAudio?: boolean;\n  /** \n   * If true, locks the device orientation while the camera is active.\n   * @platform android\n   * @default false\n   */\n  lockAndroidOrientation?: boolean;\n  /** \n   * If true, allows the camera preview's opacity to be changed.\n   * @platform android, web\n   * @default false\n   */\n  enableOpacity?: boolean;\n  /** \n   * If true, enables pinch-to-zoom functionality on the preview.\n   * @platform android\n   * @default false\n   */\n  enableZoom?: boolean;\n  /** \n   * If true, uses the video-optimized preset for the camera session.\n   * @platform ios\n   * @default false\n   */\n  enableVideoMode?: boolean;\n  /** \n   * The `deviceId` of the camera to use. If provided, `position` is ignored.\n   * @platform ios\n   */\n  deviceId?: string;\n}\n\n/**\n * Defines the options for capturing a picture.\n */\nexport interface CameraPreviewPictureOptions {\n  /** The desired height of the picture in pixels. If not provided, the device default is used. */\n  height?: number;\n  /** The desired width of the picture in pixels. If not provided, the device default is used. */\n  width?: number;\n  /** \n   * The quality of the captured image, from 0 to 100.\n   * Does not apply to `png` format.\n   * @default 85\n   */\n  quality?: number;\n  /** \n   * The format of the captured image.\n   * @default \"jpeg\"\n   */\n  format?: PictureFormat;\n  /**\n   * If true, the captured image will be saved to the user's gallery.\n   * @default false\n   * @since 7.5.0\n   */\n  saveToGallery?: boolean;\n}\n\n/** Represents EXIF data extracted from an image. */\nexport interface ExifData {\n  [key: string]: any;\n}\n\nexport type PictureFormat = \"jpeg\" | \"png\";\n\n/** Defines a standard picture size with width and height. */\nexport interface PictureSize {\n  /** The width of the picture in pixels. */\n  width: number;\n  /** The height of the picture in pixels. */\n  height: number;\n}\n\n/** Represents the supported picture sizes for a camera facing a certain direction. */\nexport interface SupportedPictureSizes {\n  /** The camera direction (\"front\" or \"rear\"). */\n  facing: string;\n  /** A list of supported picture sizes for this camera. */\n  supportedPictureSizes: PictureSize[];\n}\n\n/**\n * Defines the options for capturing a sample frame from the camera preview.\n */\nexport interface CameraSampleOptions {\n  /** \n   * The quality of the captured sample, from 0 to 100.\n   * @default 85\n   */\n  quality?: number;\n}\n\n/**\n * The available flash modes for the camera.\n * 'torch' is a continuous light mode.\n */\nexport type CameraPreviewFlashMode =\n  | \"off\"\n  | \"on\"\n  | \"auto\"\n  | \"torch\";\n\n/**\n * Defines the options for setting the camera preview's opacity.\n */\nexport interface CameraOpacityOptions {\n  /** \n   * The opacity percentage, from 0.0 (fully transparent) to 1.0 (fully opaque).\n   * @default 1.0\n   */\n  opacity?: number;\n}\n\n/**\n * The main interface for the CameraPreview plugin.\n */\nexport interface CameraPreviewPlugin {\n  /**\n   * Starts the camera preview.\n   *\n   * @param {CameraPreviewOptions} options - The configuration for the camera preview.\n   * @returns {Promise<void>} A promise that resolves when the camera preview is started.\n   * @since 0.0.1\n   */\n  start(options: CameraPreviewOptions): Promise<void>;\n\n  /**\n   * Stops the camera preview.\n   *\n   * @returns {Promise<void>} A promise that resolves when the camera preview is stopped.\n   * @since 0.0.1\n   */\n  stop(): Promise<void>;\n\n  /**\n   * Captures a picture from the camera.\n   *\n   * @param {CameraPreviewPictureOptions} options - The options for capturing the picture.\n   * @returns {Promise<{ value: string }>} A promise that resolves with the captured image data.\n   * The `value` is a base64 encoded string unless `storeToFile` is true, in which case it's a file path.\n   * @since 0.0.1\n   */\n  capture(\n    options: CameraPreviewPictureOptions\n  ): Promise<{ value: string; exif: ExifData }>;\n\n  /**\n   * Captures a single frame from the camera preview stream.\n   *\n   * @param {CameraSampleOptions} options - The options for capturing the sample.\n   * @returns {Promise<{ value: string }>} A promise that resolves with the sample image as a base64 encoded string.\n   * @since 0.0.1\n   */\n  captureSample(options: CameraSampleOptions): Promise<{ value: string }>;\n\n  /**\n   * Gets the flash modes supported by the active camera.\n   *\n   * @returns {Promise<{ result: CameraPreviewFlashMode[] }>} A promise that resolves with an array of supported flash modes.\n   * @since 0.0.1\n   */\n  getSupportedFlashModes(): Promise<{\n    result: CameraPreviewFlashMode[];\n  }>;\n\n  /**\n   * Gets the horizontal field of view (FoV) for the active camera.\n   * Note: This can be an estimate on some devices.\n   *\n   * @returns {Promise<{ result: number }>} A promise that resolves with the horizontal field of view in degrees.\n   * @since 0.0.1\n   */\n  getHorizontalFov(): Promise<{\n    result: number;\n  }>;\n\n  /**\n   * Gets the supported picture sizes for all cameras.\n   *\n   * @returns {Promise<{ supportedPictureSizes: SupportedPictureSizes[] }>} A promise that resolves with the list of supported sizes.\n   * @since 7.4.0\n   */\n  getSupportedPictureSizes(): Promise<{\n    supportedPictureSizes: SupportedPictureSizes[];\n  }>;\n\n  /**\n   * Sets the flash mode for the active camera.\n   *\n   * @param {{ flashMode: CameraPreviewFlashMode | string }} options - The desired flash mode.\n   * @returns {Promise<void>} A promise that resolves when the flash mode is set.\n   * @since 0.0.1\n   */\n  setFlashMode(options: {\n    flashMode: CameraPreviewFlashMode | string;\n  }): Promise<void>;\n\n  /**\n   * Toggles between the front and rear cameras.\n   *\n   * @returns {Promise<void>} A promise that resolves when the camera is flipped.\n   * @since 0.0.1\n   */\n  flip(): Promise<void>;\n\n  /**\n   * Sets the opacity of the camera preview.\n   *\n   * @param {CameraOpacityOptions} options - The opacity options.\n   * @returns {Promise<void>} A promise that resolves when the opacity is set.\n   * @since 0.0.1\n   */\n  setOpacity(options: CameraOpacityOptions): Promise<void>;\n\n  /**\n   * Stops an ongoing video recording.\n   *\n   * @returns {Promise<{ videoFilePath: string }>} A promise that resolves with the path to the recorded video file.\n   * @since 0.0.1\n   */\n  stopRecordVideo(): Promise<{ videoFilePath: string }>;\n\n  /**\n   * Starts recording a video.\n   *\n   * @param {CameraPreviewOptions} options - The options for video recording.\n   * @returns {Promise<void>} A promise that resolves when video recording starts.\n   * @since 0.0.1\n   */\n  startRecordVideo(options: CameraPreviewOptions): Promise<void>;\n\n  /**\n   * Checks if the camera preview is currently running.\n   *\n   * @returns {Promise<{ isRunning: boolean }>} A promise that resolves with the running state.\n   * @since 7.4.0\n   */\n  isRunning(): Promise<{ isRunning: boolean }>;\n\n  /**\n   * Gets all available camera devices.\n   *\n   * @returns {Promise<{ devices: CameraDevice[] }>} A promise that resolves with the list of available camera devices.\n   * @since 7.4.0\n   */\n  getAvailableDevices(): Promise<{ devices: CameraDevice[] }>;\n\n  /**\n   * Gets the current zoom state, including min/max and current lens info.\n   *\n   * @returns {Promise<{ min: number; max: number; current: number; lens: LensInfo }>} A promise that resolves with the zoom state.\n   * @since 7.4.0\n   */\n  getZoom(): Promise<{ \n    min: number; \n    max: number; \n    current: number;\n    lens: LensInfo;\n  }>;\n\n  /**\n   * Sets the camera's zoom level.\n   *\n   * @param {{ level: number; ramp?: boolean }} options - The desired zoom level. `ramp` is currently unused.\n   * @returns {Promise<void>} A promise that resolves when the zoom level is set.\n   * @since 7.4.0\n   */\n  setZoom(options: { level: number; ramp?: boolean }): Promise<void>;\n\n  /**\n   * Gets the current flash mode.\n   *\n   * @returns {Promise<{ flashMode: FlashMode }>} A promise that resolves with the current flash mode.\n   * @since 7.4.0\n   */\n  getFlashMode(): Promise<{ flashMode: FlashMode }>;\n\n  /**\n   * Removes all registered listeners.\n   *\n   * @since 7.4.0\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Switches the active camera to the one with the specified `deviceId`.\n   *\n   * @param {{ deviceId: string }} options - The ID of the device to switch to.\n   * @returns {Promise<void>} A promise that resolves when the camera is switched.\n   * @since 7.4.0\n   */\n  setDeviceId(options: { deviceId: string }): Promise<void>;\n\n  /**\n   * Gets the ID of the currently active camera device.\n   *\n   * @returns {Promise<{ deviceId: string }>} A promise that resolves with the current device ID.\n   * @since 7.4.0\n   */\n  getDeviceId(): Promise<{ deviceId: string }>;\n}\n"]}

package/dist/esm/web.d.ts

@@ -1,11 +1,12 @@
 import { WebPlugin } from "@capacitor/core";
-import type { CameraOpacityOptions, CameraPreviewFlashMode, CameraPreviewOptions, CameraPreviewPictureOptions, CameraPreviewPlugin, CameraSampleOptions } from "./definitions";
+import type { CameraDevice, CameraOpacityOptions, CameraPreviewFlashMode, CameraPreviewOptions, CameraPreviewPictureOptions, CameraPreviewPlugin, CameraSampleOptions, FlashMode, LensInfo } from "./definitions";
 export declare class CameraPreviewWeb extends WebPlugin implements CameraPreviewPlugin {
     /**
      *  track which camera is used based on start options
      *  used in capture
      */
     private isBackCamera;
+    private currentDeviceId;
     constructor();
     getSupportedPictureSizes(): Promise<any>;
     start(options: CameraPreviewOptions): Promise<void>;
@@ -26,4 +27,29 @@ export declare class CameraPreviewWeb extends WebPlugin implements CameraPreview
     }): Promise<void>;
     flip(): Promise<void>;
     setOpacity(_options: CameraOpacityOptions): Promise<any>;
+    isRunning(): Promise<{
+        isRunning: boolean;
+    }>;
+    getAvailableDevices(): Promise<{
+        devices: CameraDevice[];
+    }>;
+    getZoom(): Promise<{
+        min: number;
+        max: number;
+        current: number;
+        lens: LensInfo;
+    }>;
+    setZoom(options: {
+        level: number;
+        ramp?: boolean;
+    }): Promise<void>;
+    getFlashMode(): Promise<{
+        flashMode: FlashMode;
+    }>;
+    getDeviceId(): Promise<{
+        deviceId: string;
+    }>;
+    setDeviceId(options: {
+        deviceId: string;
+    }): Promise<void>;
 }