@scr2em/capacitor-scanner 6.0.24 → 6.0.26

package/README.md

@@ -183,12 +183,14 @@ removeAllListeners() => any
 ### enableObjectDetection(...)
 
 ```typescript
-enableObjectDetection(options: ObjectDetectionOptions) => any
+enableObjectDetection(options?: ObjectDetectionOptions | undefined) => any
 ```
 
-| Param         | Type                                                                      |
-| ------------- | ------------------------------------------------------------------------- |
-| **`options`** | <code><a href="#objectdetectionoptions">ObjectDetectionOptions</a></code> |
+Enable object detection (business card). This will start detecting business cards.
+
+| Param         | Type                                                                      | Description                                   |
+| ------------- | ------------------------------------------------------------------------- | --------------------------------------------- |
+| **`options`** | <code><a href="#objectdetectionoptions">ObjectDetectionOptions</a></code> | - Optional configuration for object detection |
 
 **Returns:** <code>any</code>
 
@@ -201,6 +203,8 @@ enableObjectDetection(options: ObjectDetectionOptions) => any
 disableObjectDetection() => any
 ```
 
+Disable object detection. This will stop detecting business cards.
+
 **Returns:** <code>any</code>
 
 --------------------
@@ -258,7 +262,7 @@ Set the camera zoom level.
 
 #### StartOptions
 
-<code>{ /** * Barcode formats to detect when barcodeDetection is enabled. */ formats?: BarcodeFormat[]; /** * Camera direction to use. Defaults to 'BACK'. */ cameraDirection?: 'BACK' | 'FRONT'; /** * Enable barcode detection on start. Defaults to false. * When enabled, the camera will automatically detect barcodes and emit 'barcodeScanned' events. */ barcodeDetection?: boolean; /** * Whether to show the highlight overlay for detected barcodes. Defaults to false. * Only applies when barcodeDetection is true. */ barcodeHighlight?: boolean; /** * Enable object detection (business card) on start. Defaults to false. * When enabled, the camera will automatically detect business cards and emit 'rectangleDetected' events. */ objectDetection?: boolean; /** * Whether to show the highlight overlay for detected business cards. Defaults to true. * Only applies when objectDetection is true. */ objectHighlight?: boolean; debounceTimeInMilli?: number; /** * Optional regex pattern to filter scanned barcodes. * If provided, only barcodes matching this pattern will be reported. */ regex?: string; /** * Optional regex flags (e.g., 'i' for case-insensitive, 'm' for multiline). */ regexFlags?: string; }</code>
+<code>{ /** * Barcode formats to detect when barcodeDetection is enabled. */ formats?: BarcodeFormat[]; /** * Camera direction to use. Defaults to 'BACK'. */ cameraDirection?: 'BACK' | 'FRONT'; /** * Enable barcode detection on start. Defaults to false. * When enabled, the camera will automatically detect barcodes and emit 'barcodeScanned' events. */ barcodeDetection?: boolean; /** * Whether to show the highlight overlay for detected barcodes. Defaults to false. * Only applies when barcodeDetection is true. */ barcodeHighlight?: boolean; /** * Enable object detection (business card) on start. Defaults to false. * When enabled, the camera will automatically detect business cards and emit 'rectangleDetected' events. */ objectDetection?: boolean; /** * Whether to show the highlight overlay for detected business cards. Defaults to true. * Only applies when objectDetection is true. */ objectHighlight?: boolean; /** * Minimum interval in seconds between consecutive 'rectangleDetected' events. * Only applies when objectDetection is true. * Defaults to 0 (no throttling beyond initial stability check). */ rectangleEmitIntervalSeconds?: number; debounceTimeInMilli?: number; /** * Optional regex pattern to filter scanned barcodes. * If provided, only barcodes matching this pattern will be reported. */ regex?: string; /** * Optional regex flags (e.g., 'i' for case-insensitive, 'm' for multiline). */ regexFlags?: string; }</code>
 
 
 #### CapturePhotoOptions
@@ -293,7 +297,7 @@ Set the camera zoom level.
 
 #### ObjectDetectionOptions
 
-<code>{ /** * Detection types to enable. Only 'businessCard' is supported. * For barcode detection, use enableBarcodeDetection() instead. */ types: ('businessCard')[], /** * Optional padding ratio to apply around detected rectangles when cropping. * Value must be between 0 and 1, where: * - 0 = no padding * - 1 = 100% padding (not recommended) * Default is 0.01 (1%) if not specified. */ paddingRatio?: number, /** * Whether to show the highlight overlay for detected business cards. * Defaults to true. */ showHighlight?: boolean }</code>
+<code>{ /** * Whether to show the highlight overlay for detected business cards. * Defaults to true. */ showHighlight?: boolean, /** * Minimum interval in seconds between consecutive 'rectangleDetected' events. * After an event is emitted, no new events will be emitted until this interval passes. * Set to 0 to emit events as soon as stability is detected. * Defaults to 0 (no throttling beyond initial stability check). */ emitIntervalSeconds?: number }</code>
 
 
 #### BarcodeDetectionOptions

package/android/src/main/java/com/leadliaion/capacitorscanner/CapacitorScannerPlugin.java

@@ -140,6 +140,9 @@ public class CapacitorScannerPlugin extends Plugin {
     private long lastRectangleDetectionTime = 0; // Tracks when we last had a valid rectangle detection
     private int processingFrequency = 10; // Default: 10 rectangle detections per second
 
+    // Configurable interval between rectangle detection event emissions (in milliseconds)
+    private long rectangleEmitIntervalMs = 0; // Default: 0 (no throttling)
+
     /**
      * Calculates the processing interval in milliseconds based on the desired
      * frequency per second.
@@ -212,6 +215,19 @@ public class CapacitorScannerPlugin extends Plugin {
                 if (enableObjectHighlight) {
                     enabledHighlightTypes.add("businessCard");
                 }
+                // Read rectangleEmitIntervalSeconds if provided
+                if (call.getData().has("rectangleEmitIntervalSeconds")) {
+                    try {
+                        double intervalSeconds = call.getData().getDouble("rectangleEmitIntervalSeconds");
+                        rectangleEmitIntervalMs = Math.max(0, (long) (intervalSeconds * 1000));
+                        echo("Using custom rectangleEmitIntervalSeconds: " + intervalSeconds + "s (" + rectangleEmitIntervalMs + "ms)");
+                    } catch (Exception e) {
+                        echo("Error parsing rectangleEmitIntervalSeconds: " + e.getMessage() + ". Using default 0ms");
+                        rectangleEmitIntervalMs = 0;
+                    }
+                } else {
+                    rectangleEmitIntervalMs = 0;
+                }
             }
 
             try {
@@ -867,10 +883,8 @@ public class CapacitorScannerPlugin extends Plugin {
         long currentTime = System.currentTimeMillis();
 
         if (!rectangles.isEmpty()) {
-            // Only notify if 1 second has passed since last notification
-            // 1 second interval
-            long NOTIFICATION_INTERVAL_MS = 1000;
-            if (currentTime - lastRectangleNotificationTime >= NOTIFICATION_INTERVAL_MS) {
+            // Only notify if the configured interval has passed since last notification
+            if (currentTime - lastRectangleNotificationTime >= rectangleEmitIntervalMs) {
                 // Find the largest rectangle if multiple are detected
                 Rectangle largestRectangle = null;
                 float largestArea = 0;
@@ -1127,6 +1141,7 @@ public class CapacitorScannerPlugin extends Plugin {
         lastRectangleNotificationTime = 0;
         lastRectangleProcessingTime = 0;
         lastRectangleDetectionTime = 0;
+        rectangleEmitIntervalMs = 0;
 
         // Clear detection histories and caches
         enabledDetectionTypes.clear();
@@ -1147,9 +1162,12 @@ public class CapacitorScannerPlugin extends Plugin {
     @PluginMethod
     public void enableObjectDetection(PluginCall call) {
         echo("enableObjectDetection");
-        JSArray types = call.getArray("types");
-        if (types == null || types.length() == 0) {
-            call.reject("No detection types specified");
+
+        // If object detection is already enabled, just return success
+        if (enabledDetectionTypes.contains("businessCard")) {
+            JSObject result = new JSObject();
+            result.put("enabled", true);
+            call.resolve(result);
             return;
         }
 
@@ -1172,27 +1190,25 @@ public class CapacitorScannerPlugin extends Plugin {
         // Read showHighlight option (defaults to true for businessCard)
         boolean showHighlight = call.getBoolean("showHighlight", true);
 
-        // Only accept "businessCard" type - barcode detection is handled separately
-        List<String> addedTypes = new ArrayList<>();
-        try {
-            for (int i = 0; i < types.length(); i++) {
-                String type = types.getString(i);
-                if ("businessCard".equals(type)) {
-                    enabledDetectionTypes.add(type);
-                    if (showHighlight) {
-                        enabledHighlightTypes.add(type);
-                    }
-                    addedTypes.add(type);
-                }
-            }
-        } catch (Exception e) {
-            call.reject("Error processing types array.", e);
-            return;
+        // Enable businessCard detection
+        enabledDetectionTypes.add("businessCard");
+        if (showHighlight) {
+            enabledHighlightTypes.add("businessCard");
         }
 
-        if (addedTypes.isEmpty()) {
-            call.reject("No valid detection types provided. Only 'businessCard' is supported. Use enableBarcodeDetection() for barcode detection.");
-            return;
+        // Read the optional emitIntervalSeconds parameter
+        if (call.getData().has("emitIntervalSeconds")) {
+            try {
+                double intervalSeconds = call.getData().getDouble("emitIntervalSeconds");
+                rectangleEmitIntervalMs = Math.max(0, (long) (intervalSeconds * 1000));
+                echo("Using custom emitIntervalSeconds: " + intervalSeconds + "s (" + rectangleEmitIntervalMs + "ms)");
+            } catch (Exception e) {
+                echo("Error parsing emitIntervalSeconds: " + e.getMessage() + ". Using default 0ms");
+                rectangleEmitIntervalMs = 0;
+            }
+        } else {
+            // Reset to default if not specified
+            rectangleEmitIntervalMs = 0;
         }
 
         // Read the optional paddingRatio parameter
@@ -1222,11 +1238,6 @@ public class CapacitorScannerPlugin extends Plugin {
 
         JSObject result = new JSObject();
         result.put("enabled", true);
-        try {
-            result.put("types", new JSArray(addedTypes));
-        } catch (Exception e) {
-            // this should not happen
-        }
 
         if (enabledHighlightTypes.contains("businessCard")) {
             getActivity().runOnUiThread(() -> {
@@ -1261,7 +1272,6 @@ public class CapacitorScannerPlugin extends Plugin {
 
         JSObject result = new JSObject();
         result.put("enabled", false);
-        result.put("types", new JSArray());
         call.resolve(result);
     }
 

package/dist/docs.json

@@ -171,17 +171,22 @@
       },
       {
         "name": "enableObjectDetection",
-        "signature": "(options: ObjectDetectionOptions) => any",
+        "signature": "(options?: ObjectDetectionOptions | undefined) => any",
         "parameters": [
           {
             "name": "options",
-            "docs": "",
-            "type": "ObjectDetectionOptions"
+            "docs": "- Optional configuration for object detection",
+            "type": "ObjectDetectionOptions | undefined"
           }
         ],
         "returns": "any",
-        "tags": [],
-        "docs": "",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options - Optional configuration for object detection"
+          }
+        ],
+        "docs": "Enable object detection (business card). This will start detecting business cards.",
         "complexTypes": [
           "ObjectDetectionOptions"
         ],
@@ -193,7 +198,7 @@
         "parameters": [],
         "returns": "any",
         "tags": [],
-        "docs": "",
+        "docs": "Disable object detection. This will stop detecting business cards.",
         "complexTypes": [],
         "slug": "disableobjectdetection"
       },
@@ -339,7 +344,7 @@
       "docs": "",
       "types": [
         {
-          "text": "{\n  /**\n   * Barcode formats to detect when barcodeDetection is enabled.\n   */\n  formats?: BarcodeFormat[];\n  /**\n   * Camera direction to use. Defaults to 'BACK'.\n   */\n  cameraDirection?: 'BACK' | 'FRONT';\n  /**\n   * Enable barcode detection on start. Defaults to false.\n   * When enabled, the camera will automatically detect barcodes and emit 'barcodeScanned' events.\n   */\n  barcodeDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected barcodes. Defaults to false.\n   * Only applies when barcodeDetection is true.\n   */\n  barcodeHighlight?: boolean;\n  /**\n   * Enable object detection (business card) on start. Defaults to false.\n   * When enabled, the camera will automatically detect business cards and emit 'rectangleDetected' events.\n   */\n  objectDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected business cards. Defaults to true.\n   * Only applies when objectDetection is true.\n   */\n  objectHighlight?: boolean;\n  debounceTimeInMilli?: number;\n  /**\n   * Optional regex pattern to filter scanned barcodes.\n   * If provided, only barcodes matching this pattern will be reported.\n   */\n  regex?: string;\n  /**\n   * Optional regex flags (e.g., 'i' for case-insensitive, 'm' for multiline).\n   */\n  regexFlags?: string;\n}",
+          "text": "{\n  /**\n   * Barcode formats to detect when barcodeDetection is enabled.\n   */\n  formats?: BarcodeFormat[];\n  /**\n   * Camera direction to use. Defaults to 'BACK'.\n   */\n  cameraDirection?: 'BACK' | 'FRONT';\n  /**\n   * Enable barcode detection on start. Defaults to false.\n   * When enabled, the camera will automatically detect barcodes and emit 'barcodeScanned' events.\n   */\n  barcodeDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected barcodes. Defaults to false.\n   * Only applies when barcodeDetection is true.\n   */\n  barcodeHighlight?: boolean;\n  /**\n   * Enable object detection (business card) on start. Defaults to false.\n   * When enabled, the camera will automatically detect business cards and emit 'rectangleDetected' events.\n   */\n  objectDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected business cards. Defaults to true.\n   * Only applies when objectDetection is true.\n   */\n  objectHighlight?: boolean;\n  /**\n   * Minimum interval in seconds between consecutive 'rectangleDetected' events.\n   * Only applies when objectDetection is true.\n   * Defaults to 0 (no throttling beyond initial stability check).\n   */\n  rectangleEmitIntervalSeconds?: number;\n  debounceTimeInMilli?: number;\n  /**\n   * Optional regex pattern to filter scanned barcodes.\n   * If provided, only barcodes matching this pattern will be reported.\n   */\n  regex?: string;\n  /**\n   * Optional regex flags (e.g., 'i' for case-insensitive, 'm' for multiline).\n   */\n  regexFlags?: string;\n}",
           "complexTypes": [
             "BarcodeFormat"
           ]
@@ -418,7 +423,7 @@
       "docs": "",
       "types": [
         {
-          "text": "{\n  /**\n   * Detection types to enable. Only 'businessCard' is supported.\n   * For barcode detection, use enableBarcodeDetection() instead.\n   */\n  types: ('businessCard')[],\n  /**\n   * Optional padding ratio to apply around detected rectangles when cropping.\n   * Value must be between 0 and 1, where:\n   * - 0 = no padding\n   * - 1 = 100% padding (not recommended)\n   * Default is 0.01 (1%) if not specified.\n   */\n  paddingRatio?: number,\n  /**\n   * Whether to show the highlight overlay for detected business cards.\n   * Defaults to true.\n   */\n  showHighlight?: boolean\n}",
+          "text": "{\n  /**\n   * Whether to show the highlight overlay for detected business cards.\n   * Defaults to true.\n   */\n  showHighlight?: boolean,\n  /**\n   * Minimum interval in seconds between consecutive 'rectangleDetected' events.\n   * After an event is emitted, no new events will be emitted until this interval passes.\n   * Set to 0 to emit events as soon as stability is detected.\n   * Defaults to 0 (no throttling beyond initial stability check).\n   */\n  emitIntervalSeconds?: number\n}",
           "complexTypes": []
         }
       ]

package/dist/esm/definitions.d.ts

@@ -17,10 +17,18 @@ export interface CapacitorScannerPlugin {
     addListener(event: 'barcodeScanned', listenerFunc: (result: BarcodeScannedEvent) => void): Promise<void>;
     addListener(event: 'rectangleDetected', listenerFunc: (result: RectangleDetectedEvent) => void): Promise<void>;
     removeAllListeners(): Promise<void>;
-    enableObjectDetection(options: ObjectDetectionOptions): Promise<void>;
+    /**
+     * Enable object detection (business card). This will start detecting business cards.
+     * @param options - Optional configuration for object detection
+     */
+    enableObjectDetection(options?: ObjectDetectionOptions): Promise<{
+        enabled: true;
+    }>;
+    /**
+     * Disable object detection. This will stop detecting business cards.
+     */
     disableObjectDetection(): Promise<{
         enabled: false;
-        types: [];
     }>;
     /**
      * Enable barcode detection. This will start detecting barcodes.
@@ -49,24 +57,18 @@ export declare type BarcodeDetectionOptions = {
     showHighlight?: boolean;
 };
 export declare type ObjectDetectionOptions = {
-    /**
-     * Detection types to enable. Only 'businessCard' is supported.
-     * For barcode detection, use enableBarcodeDetection() instead.
-     */
-    types: ('businessCard')[];
-    /**
-     * Optional padding ratio to apply around detected rectangles when cropping.
-     * Value must be between 0 and 1, where:
-     * - 0 = no padding
-     * - 1 = 100% padding (not recommended)
-     * Default is 0.01 (1%) if not specified.
-     */
-    paddingRatio?: number;
     /**
      * Whether to show the highlight overlay for detected business cards.
      * Defaults to true.
      */
     showHighlight?: boolean;
+    /**
+     * Minimum interval in seconds between consecutive 'rectangleDetected' events.
+     * After an event is emitted, no new events will be emitted until this interval passes.
+     * Set to 0 to emit events as soon as stability is detected.
+     * Defaults to 0 (no throttling beyond initial stability check).
+     */
+    emitIntervalSeconds?: number;
 };
 export declare type StartOptions = {
     /**
@@ -97,6 +99,12 @@ export declare type StartOptions = {
      * Only applies when objectDetection is true.
      */
     objectHighlight?: boolean;
+    /**
+     * Minimum interval in seconds between consecutive 'rectangleDetected' events.
+     * Only applies when objectDetection is true.
+     * Defaults to 0 (no throttling beyond initial stability check).
+     */
+    rectangleEmitIntervalSeconds?: number;
     debounceTimeInMilli?: number;
     /**
      * Optional regex pattern to filter scanned barcodes.

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AA4JA,MAAM,CAAN,IAAY,aAYX;AAZD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,mCAAkB,CAAA;IAClB,mCAAkB,CAAA;IAClB,qCAAoB,CAAA;IACpB,2CAA0B,CAAA;IAC1B,+BAAc,CAAA;IACd,iCAAgB,CAAA;IAChB,gCAAe,CAAA;IACf,mCAAkB,CAAA;IAClB,mCAAkB,CAAA;IAClB,+BAAc,CAAA;AAChB,CAAC,EAZW,aAAa,KAAb,aAAa,QAYxB","sourcesContent":["export interface CapacitorScannerPlugin {\n  /**\n   * Start the camera preview with optional barcode and object detection.\n   * @param options - Configuration options for the camera and detection\n   */\n  start(options?: StartOptions): Promise<void>;\n\n  /**\n   * Stop the camera preview and all detection.\n   */\n  stop(): Promise<void>;\n\n  openSettings(): Promise<void>;\n\n  capturePhoto(options?: CapturePhotoOptions): Promise<CapturePhotoResult>;\n\n  checkPermissions(): Promise<PermissionsResult>;\n\n  requestPermissions(): Promise<PermissionsResult>;\n\n  flipCamera(): Promise<void>;\n\n  toggleFlash(): Promise<FlashResult>;\n\n  addListener(event: 'barcodeScanned', listenerFunc: (result: BarcodeScannedEvent) => void): Promise<void>;\n\n  addListener(event: 'rectangleDetected', listenerFunc: (result: RectangleDetectedEvent) => void): Promise<void>;\n\n  removeAllListeners(): Promise<void>;\n\n  enableObjectDetection(options: ObjectDetectionOptions): Promise<void>;\n\n  disableObjectDetection(): Promise<{ enabled: false, types: [] }>;\n\n  /**\n   * Enable barcode detection. This will start detecting barcodes.\n   * @param options - Optional configuration for barcode detection\n   */\n  enableBarcodeDetection(options?: BarcodeDetectionOptions): Promise<{ enabled: true }>;\n\n  /**\n   * Disable barcode detection. This will stop detecting barcodes and clear cached barcodes.\n   */\n  disableBarcodeDetection(): Promise<{ enabled: false }>;\n\n  /**\n   * Set the camera zoom level.\n   * @param options - The zoom options containing the level (1, 2, or 3)\n   */\n  zoom(options: ZoomOptions): Promise<ZoomResult>;\n}\n\nexport type BarcodeDetectionOptions = {\n  /**\n   * Whether to show the highlight overlay for detected barcodes.\n   * Defaults to false.\n   */\n  showHighlight?: boolean;\n}\n\nexport type ObjectDetectionOptions = {\n  /**\n   * Detection types to enable. Only 'businessCard' is supported.\n   * For barcode detection, use enableBarcodeDetection() instead.\n   */\n  types: ('businessCard')[],\n  /**\n   * Optional padding ratio to apply around detected rectangles when cropping.\n   * Value must be between 0 and 1, where:\n   * - 0 = no padding\n   * - 1 = 100% padding (not recommended)\n   * Default is 0.01 (1%) if not specified.\n   */\n  paddingRatio?: number,\n  /**\n   * Whether to show the highlight overlay for detected business cards.\n   * Defaults to true.\n   */\n  showHighlight?: boolean\n}\n\nexport type StartOptions = {\n  /**\n   * Barcode formats to detect when barcodeDetection is enabled.\n   */\n  formats?: BarcodeFormat[];\n  /**\n   * Camera direction to use. Defaults to 'BACK'.\n   */\n  cameraDirection?: 'BACK' | 'FRONT';\n  /**\n   * Enable barcode detection on start. Defaults to false.\n   * When enabled, the camera will automatically detect barcodes and emit 'barcodeScanned' events.\n   */\n  barcodeDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected barcodes. Defaults to false.\n   * Only applies when barcodeDetection is true.\n   */\n  barcodeHighlight?: boolean;\n  /**\n   * Enable object detection (business card) on start. Defaults to false.\n   * When enabled, the camera will automatically detect business cards and emit 'rectangleDetected' events.\n   */\n  objectDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected business cards. Defaults to true.\n   * Only applies when objectDetection is true.\n   */\n  objectHighlight?: boolean;\n  debounceTimeInMilli?: number;\n  /**\n   * Optional regex pattern to filter scanned barcodes.\n   * If provided, only barcodes matching this pattern will be reported.\n   */\n  regex?: string;\n  /**\n   * Optional regex flags (e.g., 'i' for case-insensitive, 'm' for multiline).\n   */\n  regexFlags?: string;\n};\n\nexport type BarcodeScannedEvent = { scannedCode: string; format: string };\n\n\nexport type RectangleDetectedEvent = {\n  detected: true\n};\n\nexport type CapturePhotoOptions = {\n  /**\n   * The desired quality of the captured image, expressed as a value between 0.0 (lowest quality, smallest file size)\n   * and 1.0 (highest quality, largest file size). Defaults to 1.0.\n   * This parameter directly influences the compression level of the resulting JPEG image.\n   */\n  qualityRatio?: number;\n};\n\nexport type PermissionsResult = { camera: 'prompt' | 'denied' | 'granted' };\n\nexport type CapturePhotoResult = { imageBase64: string };\n\nexport type FlashResult = { enabled: boolean };\n\nexport type ZoomOptions = {\n  /**\n   * The zoom level to set. Must be 1, 2, or 3.\n   * - 1 = 1.0x (no zoom)\n   * - 2 = 2.0x\n   * - 3 = 3.0x\n   */\n  level: 1 | 2 | 3;\n};\n\nexport type ZoomResult = { level: number };\n\nexport enum BarcodeFormat {\n  Aztec = 'AZTEC',\n  Code39 = 'CODE_39',\n  Code93 = 'CODE_93',\n  Code128 = 'CODE_128',\n  DataMatrix = 'DATA_MATRIX',\n  Ean8 = 'EAN_8',\n  Ean13 = 'EAN_13',\n  Itf14 = 'ITF14',\n  Pdf417 = 'PDF_417',\n  QrCode = 'QR_CODE',\n  UpcE = 'UPC_E',\n}\n\ndeclare global {\n  interface PluginRegistry {\n    QRScanner: CapacitorScannerPlugin;\n  }\n}"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAmKA,MAAM,CAAN,IAAY,aAYX;AAZD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,mCAAkB,CAAA;IAClB,mCAAkB,CAAA;IAClB,qCAAoB,CAAA;IACpB,2CAA0B,CAAA;IAC1B,+BAAc,CAAA;IACd,iCAAgB,CAAA;IAChB,gCAAe,CAAA;IACf,mCAAkB,CAAA;IAClB,mCAAkB,CAAA;IAClB,+BAAc,CAAA;AAChB,CAAC,EAZW,aAAa,KAAb,aAAa,QAYxB","sourcesContent":["export interface CapacitorScannerPlugin {\n  /**\n   * Start the camera preview with optional barcode and object detection.\n   * @param options - Configuration options for the camera and detection\n   */\n  start(options?: StartOptions): Promise<void>;\n\n  /**\n   * Stop the camera preview and all detection.\n   */\n  stop(): Promise<void>;\n\n  openSettings(): Promise<void>;\n\n  capturePhoto(options?: CapturePhotoOptions): Promise<CapturePhotoResult>;\n\n  checkPermissions(): Promise<PermissionsResult>;\n\n  requestPermissions(): Promise<PermissionsResult>;\n\n  flipCamera(): Promise<void>;\n\n  toggleFlash(): Promise<FlashResult>;\n\n  addListener(event: 'barcodeScanned', listenerFunc: (result: BarcodeScannedEvent) => void): Promise<void>;\n\n  addListener(event: 'rectangleDetected', listenerFunc: (result: RectangleDetectedEvent) => void): Promise<void>;\n\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Enable object detection (business card). This will start detecting business cards.\n   * @param options - Optional configuration for object detection\n   */\n  enableObjectDetection(options?: ObjectDetectionOptions): Promise<{ enabled: true }>;\n\n  /**\n   * Disable object detection. This will stop detecting business cards.\n   */\n  disableObjectDetection(): Promise<{ enabled: false }>;\n\n  /**\n   * Enable barcode detection. This will start detecting barcodes.\n   * @param options - Optional configuration for barcode detection\n   */\n  enableBarcodeDetection(options?: BarcodeDetectionOptions): Promise<{ enabled: true }>;\n\n  /**\n   * Disable barcode detection. This will stop detecting barcodes and clear cached barcodes.\n   */\n  disableBarcodeDetection(): Promise<{ enabled: false }>;\n\n  /**\n   * Set the camera zoom level.\n   * @param options - The zoom options containing the level (1, 2, or 3)\n   */\n  zoom(options: ZoomOptions): Promise<ZoomResult>;\n}\n\nexport type BarcodeDetectionOptions = {\n  /**\n   * Whether to show the highlight overlay for detected barcodes.\n   * Defaults to false.\n   */\n  showHighlight?: boolean;\n}\n\nexport type ObjectDetectionOptions = {\n  /**\n   * Whether to show the highlight overlay for detected business cards.\n   * Defaults to true.\n   */\n  showHighlight?: boolean,\n  /**\n   * Minimum interval in seconds between consecutive 'rectangleDetected' events.\n   * After an event is emitted, no new events will be emitted until this interval passes.\n   * Set to 0 to emit events as soon as stability is detected.\n   * Defaults to 0 (no throttling beyond initial stability check).\n   */\n  emitIntervalSeconds?: number\n}\n\nexport type StartOptions = {\n  /**\n   * Barcode formats to detect when barcodeDetection is enabled.\n   */\n  formats?: BarcodeFormat[];\n  /**\n   * Camera direction to use. Defaults to 'BACK'.\n   */\n  cameraDirection?: 'BACK' | 'FRONT';\n  /**\n   * Enable barcode detection on start. Defaults to false.\n   * When enabled, the camera will automatically detect barcodes and emit 'barcodeScanned' events.\n   */\n  barcodeDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected barcodes. Defaults to false.\n   * Only applies when barcodeDetection is true.\n   */\n  barcodeHighlight?: boolean;\n  /**\n   * Enable object detection (business card) on start. Defaults to false.\n   * When enabled, the camera will automatically detect business cards and emit 'rectangleDetected' events.\n   */\n  objectDetection?: boolean;\n  /**\n   * Whether to show the highlight overlay for detected business cards. Defaults to true.\n   * Only applies when objectDetection is true.\n   */\n  objectHighlight?: boolean;\n  /**\n   * Minimum interval in seconds between consecutive 'rectangleDetected' events.\n   * Only applies when objectDetection is true.\n   * Defaults to 0 (no throttling beyond initial stability check).\n   */\n  rectangleEmitIntervalSeconds?: number;\n  debounceTimeInMilli?: number;\n  /**\n   * Optional regex pattern to filter scanned barcodes.\n   * If provided, only barcodes matching this pattern will be reported.\n   */\n  regex?: string;\n  /**\n   * Optional regex flags (e.g., 'i' for case-insensitive, 'm' for multiline).\n   */\n  regexFlags?: string;\n};\n\nexport type BarcodeScannedEvent = { scannedCode: string; format: string };\n\n\nexport type RectangleDetectedEvent = {\n  detected: true\n};\n\nexport type CapturePhotoOptions = {\n  /**\n   * The desired quality of the captured image, expressed as a value between 0.0 (lowest quality, smallest file size)\n   * and 1.0 (highest quality, largest file size). Defaults to 1.0.\n   * This parameter directly influences the compression level of the resulting JPEG image.\n   */\n  qualityRatio?: number;\n};\n\nexport type PermissionsResult = { camera: 'prompt' | 'denied' | 'granted' };\n\nexport type CapturePhotoResult = { imageBase64: string };\n\nexport type FlashResult = { enabled: boolean };\n\nexport type ZoomOptions = {\n  /**\n   * The zoom level to set. Must be 1, 2, or 3.\n   * - 1 = 1.0x (no zoom)\n   * - 2 = 2.0x\n   * - 3 = 3.0x\n   */\n  level: 1 | 2 | 3;\n};\n\nexport type ZoomResult = { level: number };\n\nexport enum BarcodeFormat {\n  Aztec = 'AZTEC',\n  Code39 = 'CODE_39',\n  Code93 = 'CODE_93',\n  Code128 = 'CODE_128',\n  DataMatrix = 'DATA_MATRIX',\n  Ean8 = 'EAN_8',\n  Ean13 = 'EAN_13',\n  Itf14 = 'ITF14',\n  Pdf417 = 'PDF_417',\n  QrCode = 'QR_CODE',\n  UpcE = 'UPC_E',\n}\n\ndeclare global {\n  interface PluginRegistry {\n    QRScanner: CapacitorScannerPlugin;\n  }\n}"]}

package/ios/Sources/CapacitorScannerPlugin/CapacitorScannerPlugin.swift

@@ -76,20 +76,16 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 	}()
 
 	@objc func enableObjectDetection(_ call: CAPPluginCall) {
-		guard let types = call.getArray("types", String.self) else {
-			call.reject("Missing or invalid 'type' parameter. Expected array of strings.")
-			return
-		}
-
-		// Only accept "businessCard" - barcode detection is handled separately
-		let filteredTypes = types.filter { $0 == "businessCard" }
-
-		if filteredTypes.isEmpty {
-			call.reject("No valid detection types provided. Only 'businessCard' is supported. Use enableBarcodeDetection() for barcode detection.")
+		// If object detection is already enabled, just return success
+		if self.enabledDetectionTypes.contains("businessCard") {
+			call.resolve([
+				"enabled": true,
+			])
 			return
 		}
 
 		let showHighlight = call.getBool("showHighlight", true)
+		let emitIntervalSeconds = call.getDouble("emitIntervalSeconds") ?? 0
 
 		DispatchQueue.main.async {
 			self.enabledDetectionTypes.insert("businessCard")
@@ -100,15 +96,17 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 				self.rectangleDetector?.delegate = self
 			}
 
+			// Set the emit interval
+			self.rectangleDetector?.setEmitInterval(emitIntervalSeconds)
+
 			if showHighlight {
 				self.enabledHighlightTypes.insert("businessCard")
+				self.rectangleDetector?.isHighlightEnabled = true
 				self.setupOverlayView()
-				self.rectangleDetector?.enableHighlight()
 			}
 
 			call.resolve([
 				"enabled": true,
-				"types": filteredTypes,
 			])
 		}
 	}
@@ -124,14 +122,17 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 
 			call.resolve([
 				"enabled": false,
-				"types": [],
 			])
 		}
 	}
 
 	private func setupOverlayView() {
 		guard let cameraView = self.cameraView,
-		      let previewLayer = self.previewLayer else { return }
+		      let previewLayer = self.previewLayer else {
+			print("[CapacitorScanner] setupOverlayView: cameraView or previewLayer is nil")
+			return
+		}
+		print("[CapacitorScanner] setupOverlayView: setting up overlay")
 
 		// Remove existing overlay if present
 		self.overlayView?.removeFromSuperview()
@@ -432,6 +433,9 @@ public class CapacitorScannerPlugin: CAPPlugin, CAPBridgedPlugin, AVCaptureMetad
 				if enableObjectHighlight {
 					self.rectangleDetector?.isHighlightEnabled = true
 				}
+				// Set emit interval if provided
+				let emitInterval = call.getDouble("rectangleEmitIntervalSeconds") ?? 0
+				self.rectangleDetector?.setEmitInterval(emitInterval)
 			}
 
 			// Handle Regex Filter

package/ios/Sources/CapacitorScannerPlugin/RectangleDetector.swift

@@ -33,6 +33,9 @@ class RectangleDetector {
     private let stabilityThreshold: CGFloat = 0.2  // Max movement (normalized) to be considered stable
     private let stabilityDuration: TimeInterval = 0.8  // Seconds of stability before emitting event
 
+    /// Minimum interval between consecutive event emissions. Set via `setEmitInterval(_:)`.
+    private var emitIntervalSeconds: TimeInterval = 0
+
     // MARK: - State
 
     private(set) var lastDetectedRectangle: DetectedRectangle?
@@ -42,7 +45,7 @@ class RectangleDetector {
     // Stability tracking
     private var previousCorners: RectangleCorners?
     private var stabilityStartTime: Date?
-    private var hasEmittedForCurrentStability: Bool = false
+    private var lastEmitTime: Date?
 
     private var smoother: RectangleSmoother?
     private weak var overlayParentLayer: CALayer?
@@ -70,6 +73,7 @@ class RectangleDetector {
 
     /// Configure the detector with overlay support
     func configure(overlayLayer: CALayer, previewLayer: AVCaptureVideoPreviewLayer) {
+        print("[RectangleDetector] configure called, isHighlightEnabled: \(isHighlightEnabled)")
         self.overlayParentLayer = overlayLayer
         self.previewLayer = previewLayer
 
@@ -91,6 +95,11 @@ class RectangleDetector {
         smoother = nil
     }
 
+    /// Set the minimum interval between consecutive event emissions
+    func setEmitInterval(_ seconds: TimeInterval) {
+        emitIntervalSeconds = max(0, seconds)
+    }
+
     /// Update the current pixel buffer for snapshot capture
     func updatePixelBuffer(_ pixelBuffer: CVPixelBuffer) {
         self.currentPixelBuffer = pixelBuffer
@@ -114,7 +123,7 @@ class RectangleDetector {
         currentPixelBuffer = nil
         previousCorners = nil
         stabilityStartTime = nil
-        hasEmittedForCurrentStability = false
+        lastEmitTime = nil
         smoother?.clear()
         smoother = nil
     }
@@ -122,7 +131,11 @@ class RectangleDetector {
     // MARK: - Private Implementation
 
     private func setupSmoother() {
-        guard let parentLayer = overlayParentLayer, smoother == nil else { return }
+        guard let parentLayer = overlayParentLayer, smoother == nil else {
+            print("[RectangleDetector] setupSmoother: skipped (parentLayer nil: \(overlayParentLayer == nil), smoother exists: \(smoother != nil))")
+            return
+        }
+        print("[RectangleDetector] setupSmoother: creating smoother")
         smoother = RectangleSmoother()
         smoother?.setup(in: parentLayer)
     }
@@ -191,14 +204,13 @@ class RectangleDetector {
     // MARK: - Stability Tracking
 
     private func updateStability(with corners: RectangleCorners) {
-        print("[RectangleDetector] updateStability - hasPrevious: \(previousCorners != nil), timerActive: \(stabilityStartTime != nil), hasEmitted: \(hasEmittedForCurrentStability)")
+        print("[RectangleDetector] updateStability - hasPrevious: \(previousCorners != nil), timerActive: \(stabilityStartTime != nil)")
 
         // First detection - just store corners, don't start timer yet
         guard let previous = previousCorners else {
             print("[RectangleDetector] First detection - storing corners, no timer yet")
             previousCorners = corners
             stabilityStartTime = nil
-            hasEmittedForCurrentStability = false
             return
         }
 
@@ -213,7 +225,6 @@ class RectangleDetector {
         if movement >= stabilityThreshold {
             print("[RectangleDetector] Too much movement (\(movement) >= \(stabilityThreshold)) - resetting timer")
             stabilityStartTime = nil
-            hasEmittedForCurrentStability = false
             return
         }
 
@@ -231,9 +242,22 @@ class RectangleDetector {
         let elapsed = now.timeIntervalSince(stabilityStartTime!)
         print("[RectangleDetector] Stability elapsed: \(String(format: "%.2f", elapsed))s / \(stabilityDuration)s required")
 
-        if elapsed >= stabilityDuration && !hasEmittedForCurrentStability {
+        // Need to be stable for the required duration before any emission
+        guard elapsed >= stabilityDuration else { return }
+
+        // Check if we can emit (either first time, or interval has passed)
+        let canEmit: Bool
+        if let lastEmit = lastEmitTime {
+            let timeSinceLastEmit = now.timeIntervalSince(lastEmit)
+            canEmit = timeSinceLastEmit >= emitIntervalSeconds
+            print("[RectangleDetector] Time since last emit: \(String(format: "%.2f", timeSinceLastEmit))s, interval: \(emitIntervalSeconds)s")
+        } else {
+            canEmit = true
+        }
+
+        if canEmit {
             print("[RectangleDetector] STABLE for \(elapsed)s - emitting event")
-            hasEmittedForCurrentStability = true
+            lastEmitTime = now
             delegate?.rectangleDetector(self, didDetect: corners)
         }
     }
@@ -244,7 +268,6 @@ class RectangleDetector {
             print("[RectangleDetector] No detection - resetting stability timer")
         }
         stabilityStartTime = nil
-        hasEmittedForCurrentStability = false
         previousCorners = nil
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scr2em/capacitor-scanner",
-  "version": "6.0.24",
+  "version": "6.0.26",
   "description": "scan codes",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",