@agicash/qr-scanner 0.1.0 → 0.1.2

package/README.md

@@ -94,6 +94,16 @@ QrScanner.scanImage(source, options?): Promise<ScanResult>
 QrScanner.preload(): Promise<void>
 QrScanner.configureWasm(overrides): void
 QrScanner.setWorkerUrl(url): void
+QrScanner.setDebug(enabled): void
+```
+
+## Debug Logging
+
+The library includes performance profiling logs (camera acquisition timing, best-camera selection, etc.) that are **off by default**. Enable them at runtime for debugging:
+
+```ts
+QrScanner.setDebug(true);  // logs appear in console
+QrScanner.setDebug(false); // back to silent (default)
 ```
 
 ## Worker Loading

package/dist/index.cjs

@@ -26,6 +26,15 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/debug.ts
+var enabled = false;
+function setDebug(on) {
+  enabled = on;
+}
+function debug(...args) {
+  if (enabled) console.debug(...args);
+}
+
 // src/camera.ts
 var CameraPermissionError = class extends Error {
   constructor(message = "Camera access denied. Please grant camera permission and try again.") {
@@ -53,6 +62,12 @@ function setCachedDeviceId(facingMode, deviceId) {
   } catch {
   }
 }
+function clearCachedDeviceId(facingMode) {
+  try {
+    localStorage.removeItem(`${CACHE_KEY_PREFIX}${facingMode}`);
+  } catch {
+  }
+}
 var CameraManager = class {
   constructor(config = {}) {
     this.stream = null;
@@ -66,16 +81,16 @@ var CameraManager = class {
     const t0 = performance.now();
     this.stream = await this.acquireStream();
     const t1 = performance.now();
-    console.debug(`[QrScanner] acquireStream: ${(t1 - t0).toFixed(0)}ms`);
+    debug(`[QrScanner] acquireStream: ${(t1 - t0).toFixed(0)}ms`);
     await this.ensureBestCamera();
     const t2 = performance.now();
-    console.debug(`[QrScanner] ensureBestCamera: ${(t2 - t1).toFixed(0)}ms`);
+    debug(`[QrScanner] ensureBestCamera: ${(t2 - t1).toFixed(0)}ms`);
     video.srcObject = this.stream;
     video.setAttribute("playsinline", "true");
     await video.play();
     const t3 = performance.now();
-    console.debug(`[QrScanner] video.play: ${(t3 - t2).toFixed(0)}ms`);
-    console.debug(`[QrScanner] camera.start total: ${(t3 - t0).toFixed(0)}ms`);
+    debug(`[QrScanner] video.play: ${(t3 - t2).toFixed(0)}ms`);
+    debug(`[QrScanner] camera.start total: ${(t3 - t0).toFixed(0)}ms`);
     if (this.facingMode === "environment" || this.facingMode === "user") {
       const finalDeviceId = this.getVideoTrack()?.getSettings().deviceId;
       if (finalDeviceId) {
@@ -150,9 +165,7 @@ var CameraManager = class {
    */
   async ensureBestCamera() {
     if (this.facingMode !== "environment" && this.facingMode !== "user") {
-      console.debug(
-        "[QrScanner] ensureBestCamera: skipped (specific deviceId)"
-      );
+      debug("[QrScanner] ensureBestCamera: skipped (specific deviceId)");
       return;
     }
     const track = this.getVideoTrack();
@@ -160,29 +173,35 @@ var CameraManager = class {
     try {
       const capabilities = track.getCapabilities();
       if (!capabilities.focusMode || capabilities.focusMode.includes("continuous")) {
-        console.debug(
+        debug(
           `[QrScanner] ensureBestCamera: skipped (focusMode: ${JSON.stringify(capabilities.focusMode)})`
         );
         return;
       }
-      console.debug(
+      debug(
         `[QrScanner] ensureBestCamera: current camera lacks autofocus (focusMode: ${JSON.stringify(capabilities.focusMode)})`
       );
-    } catch {
+    } catch (err) {
+      debug(
+        `[QrScanner] ensureBestCamera: skipped (getCapabilities failed: ${err instanceof Error ? err.message : err})`
+      );
       return;
     }
     const currentDeviceId = track.getSettings().deviceId;
     let devices;
     try {
       devices = await navigator.mediaDevices.enumerateDevices();
-    } catch {
+    } catch (err) {
+      debug(
+        `[QrScanner] ensureBestCamera: skipped (enumerateDevices failed: ${err instanceof Error ? err.message : err})`
+      );
       return;
     }
     if (!Array.isArray(devices)) return;
     const candidates = devices.filter(
       (d) => d.kind === "videoinput" && d.deviceId !== currentDeviceId
     );
-    console.debug(
+    debug(
       `[QrScanner] ensureBestCamera: testing ${candidates.length} candidate camera(s)`
     );
     if (candidates.length === 0) return;
@@ -199,13 +218,16 @@ var CameraManager = class {
           },
           audio: false
         });
-        console.debug(
+        debug(
           `[QrScanner] ensureBestCamera: candidate ${candidate.label || candidate.deviceId.slice(0, 8)}: getUserMedia ${(performance.now() - t).toFixed(0)}ms`
         );
-      } catch {
-        console.debug(
-          `[QrScanner] ensureBestCamera: candidate ${candidate.label || candidate.deviceId.slice(0, 8)}: getUserMedia failed ${(performance.now() - t).toFixed(0)}ms`
+      } catch (err) {
+        debug(
+          `[QrScanner] ensureBestCamera: candidate ${candidate.label || candidate.deviceId.slice(0, 8)}: getUserMedia failed ${(performance.now() - t).toFixed(0)}ms \u2014 ${err instanceof Error ? err.name : err}`
         );
+        if (err instanceof DOMException && err.name === "NotAllowedError") {
+          throw new CameraPermissionError();
+        }
         continue;
       }
       const candidateTrack = candidateStream.getVideoTracks()[0];
@@ -224,27 +246,52 @@ var CameraManager = class {
           this.stream = candidateStream;
           return;
         }
-      } catch {
+      } catch (err) {
+        debug(
+          `[QrScanner] ensureBestCamera: candidate getCapabilities failed \u2014 ${err instanceof Error ? err.message : err}`
+        );
       }
       for (const t2 of candidateStream.getTracks()) t2.stop();
     }
-    try {
-      this.stream = await navigator.mediaDevices.getUserMedia({
+    const recoveryAttempts = [
+      // Original deviceId + resolution
+      {
         video: {
           deviceId: currentDeviceId ? { exact: currentDeviceId } : void 0,
           width: this.resolution?.width ?? { ideal: 1920 },
           height: this.resolution?.height ?? { ideal: 1080 }
         },
         audio: false
-      });
-    } catch {
+      },
+      // facingMode + resolution
+      this.buildConstraints(),
+      // facingMode only
+      this.buildConstraints(false),
+      // Bare minimum — should always succeed if a camera exists
+      { video: true, audio: false }
+    ];
+    let lastRecoveryError;
+    for (const constraints of recoveryAttempts) {
       try {
-        this.stream = await navigator.mediaDevices.getUserMedia(
-          this.buildConstraints()
+        this.stream = await navigator.mediaDevices.getUserMedia(constraints);
+        return;
+      } catch (err) {
+        if (err instanceof DOMException && err.name === "NotAllowedError") {
+          throw new CameraPermissionError();
+        }
+        if (err instanceof DOMException && err.name === "NotFoundError") {
+          throw new CameraNotFoundError();
+        }
+        lastRecoveryError = err;
+        debug(
+          `[QrScanner] ensureBestCamera recovery failed: ${err instanceof Error ? err.name : err}`
         );
-      } catch {
+        continue;
       }
     }
+    debug(
+      `[QrScanner] ensureBestCamera: all recovery attempts failed, last error: ${lastRecoveryError instanceof Error ? lastRecoveryError.message : lastRecoveryError}`
+    );
   }
   getVideoTrack() {
     if (!this.stream) return null;
@@ -259,12 +306,10 @@ var CameraManager = class {
    * fewer constraints lets us still open the camera on those browsers.
    */
   async acquireStream() {
-    const labels = [];
     const attempts = [];
     if (this.facingMode === "environment" || this.facingMode === "user") {
       const cachedId = getCachedDeviceId(this.facingMode);
       if (cachedId) {
-        labels.push("cached deviceId");
         const video = {
           deviceId: { exact: cachedId }
         };
@@ -272,42 +317,50 @@ var CameraManager = class {
         else video.width = { ideal: 1920 };
         if (this.resolution?.height) video.height = this.resolution.height;
         else video.height = { ideal: 1080 };
-        attempts.push({ video, audio: false });
+        attempts.push({
+          label: "cached deviceId",
+          constraints: { video, audio: false },
+          isCachedDeviceId: true
+        });
       }
     }
-    labels.push("full constraints", "no resolution", "bare minimum");
     attempts.push(
-      // facingMode/deviceId + resolution
-      this.buildConstraints(),
-      // facingMode/deviceId only, no resolution
-      this.buildConstraints(false),
-      // Bare minimum
-      { video: true, audio: false }
+      { label: "full constraints", constraints: this.buildConstraints() },
+      { label: "no resolution", constraints: this.buildConstraints(false) },
+      { label: "bare minimum", constraints: { video: true, audio: false } }
     );
     let lastError;
-    for (let i = 0; i < attempts.length; i++) {
+    for (const attempt of attempts) {
       const t = performance.now();
       try {
-        const stream = await navigator.mediaDevices.getUserMedia(attempts[i]);
-        console.debug(
-          `[QrScanner] getUserMedia(${labels[i]}): ${(performance.now() - t).toFixed(0)}ms \u2713`
+        const stream = await navigator.mediaDevices.getUserMedia(
+          attempt.constraints
+        );
+        debug(
+          `[QrScanner] getUserMedia(${attempt.label}): ${(performance.now() - t).toFixed(0)}ms \u2713`
         );
         return stream;
       } catch (err) {
-        console.debug(
-          `[QrScanner] getUserMedia(${labels[i]}): ${(performance.now() - t).toFixed(0)}ms \u2717 ${err instanceof DOMException ? err.name : err}`
+        debug(
+          `[QrScanner] getUserMedia(${attempt.label}): ${(performance.now() - t).toFixed(0)}ms \u2717 ${err instanceof Error ? err.name : err}`
         );
-        if (err instanceof DOMException) {
-          if (err.name === "NotAllowedError") {
-            throw new CameraPermissionError();
-          }
-          if (err.name === "NotFoundError") {
-            throw new CameraNotFoundError();
-          }
-          lastError = err;
-          continue;
+        if (err instanceof DOMException && err.name === "NotAllowedError") {
+          throw new CameraPermissionError();
         }
-        throw err;
+        if (err instanceof DOMException && err.name === "NotFoundError") {
+          throw new CameraNotFoundError();
+        }
+        if (!(err instanceof DOMException) && !(err instanceof OverconstrainedError)) {
+          throw err;
+        }
+        if (attempt.isCachedDeviceId) {
+          clearCachedDeviceId(this.facingMode);
+          debug(
+            `[QrScanner] cleared stale cached deviceId for "${this.facingMode}"`
+          );
+        }
+        lastError = err;
+        continue;
       }
     }
     throw lastError;
@@ -417,9 +470,6 @@ var FrameExtractor = class {
   markWorkerIdle() {
     this.workerBusy = false;
   }
-  markWorkerBusy() {
-    this.workerBusy = true;
-  }
 };
 
 // src/overlay.ts
@@ -429,22 +479,9 @@ function getRenderedVideoRect(video) {
   const videoWidth = video.videoWidth || 1;
   const videoHeight = video.videoHeight || 1;
   const objectFit = getComputedStyle(video).objectFit;
-  if (objectFit === "cover") {
-    const scale = Math.max(
-      elementWidth / videoWidth,
-      elementHeight / videoHeight
-    );
-    const renderedWidth = videoWidth * scale;
-    const renderedHeight = videoHeight * scale;
-    return {
-      offsetX: (elementWidth - renderedWidth) / 2,
-      offsetY: (elementHeight - renderedHeight) / 2,
-      width: renderedWidth,
-      height: renderedHeight
-    };
-  }
-  if (objectFit === "contain") {
-    const scale = Math.min(
+  if (objectFit === "cover" || objectFit === "contain") {
+    const scaleFn = objectFit === "cover" ? Math.max : Math.min;
+    const scale = scaleFn(
       elementWidth / videoWidth,
       elementHeight / videoHeight
     );
@@ -683,7 +720,7 @@ var Scanner = class {
       }
     }
     await this.camera.start(this.video);
-    console.debug(
+    debug(
       `[QrScanner] start: camera ready ${(performance.now() - t0).toFixed(0)}ms`
     );
     if (this.overlay) {
@@ -692,7 +729,7 @@ var Scanner = class {
     if (!this.worker) {
       const tw = performance.now();
       this.worker = this.createWorker();
-      console.debug(
+      debug(
         `[QrScanner] start: worker created ${(performance.now() - tw).toFixed(0)}ms`
       );
     }
@@ -707,9 +744,7 @@ var Scanner = class {
     });
     this.active = true;
     this.paused = false;
-    console.debug(
-      `[QrScanner] start: total ${(performance.now() - t0).toFixed(0)}ms`
-    );
+    debug(`[QrScanner] start: total ${(performance.now() - t0).toFixed(0)}ms`);
   }
   stop() {
     this.frameExtractor?.stop();
@@ -768,18 +803,9 @@ var Scanner = class {
   }
   setInversionMode(mode) {
     if (!this.worker) return;
-    const options = {};
-    switch (mode) {
-      case "original":
-        options.tryInvert = false;
-        break;
-      case "invert":
-        options.tryInvert = true;
-        break;
-      case "both":
-        options.tryInvert = true;
-        break;
-    }
+    const options = {
+      tryInvert: mode !== "original"
+    };
     const msg = { type: "configure", options };
     this.worker.postMessage(msg);
   }
@@ -912,8 +938,8 @@ async function createImageBitmapFromBlob(blob) {
   }
 }
 
-// src/scan-image.ts
-var defaultReaderOptions = {
+// src/decoder-utils.ts
+var DEFAULT_READER_OPTIONS = {
   formats: ["QRCode"],
   tryHarder: true,
   tryInvert: true,
@@ -930,12 +956,14 @@ function mapPosition(position) {
     position.bottomLeft
   ];
 }
+
+// src/scan-image.ts
 function isDirectInput(source) {
   return source instanceof Blob || source instanceof ArrayBuffer || source instanceof Uint8Array || typeof ImageData !== "undefined" && source instanceof ImageData;
 }
 async function scanImage(source, options) {
   const readerOptions = {
-    ...defaultReaderOptions,
+    ...DEFAULT_READER_OPTIONS,
     ...options?.decoderOptions,
     formats: ["QRCode"]
   };
@@ -1051,6 +1079,15 @@ var QrScanner = class {
   static setWorkerUrl(url) {
     setWorkerUrl(url);
   }
+  /**
+   * Enable or disable debug logging (performance timings, camera selection).
+   * Off by default. Useful for diagnosing camera issues in the browser console.
+   * @example
+   * QrScanner.setDebug(true);
+   */
+  static setDebug(enabled2) {
+    setDebug(enabled2);
+  }
   /** Scan a single image (not a video stream). */
   static scanImage(source, options) {
     return scanImage(source, options);