scandoc-ai-components 0.1.18 → 0.1.20

package/dist/index.js

@@ -11170,25 +11170,15 @@ __webpack_require__.r(__webpack_exports__);
 
 const DOCUMENT_DETECTOR = new _ai_detect_document__WEBPACK_IMPORTED_MODULE_0__["default"]();
 class ExtractorVideo {
-  static DEBUG = true;
   static FREQUENCY_MS = 10;
   static VALIDATION_BATCH_SIZE = 1;
   static VALIDATION_IMG_WIDTH = 384;
   static VALIDATION_IMG_HEIGHT = 384;
-  static VIDEO_CANDIDATE_SETTINGS = Object.freeze([{
-    width: 1920,
-    height: 1080
-  }, {
-    width: 1280,
-    height: 960
-  }, {
-    width: 1280,
-    height: 720
-  }]);
   constructor(onExtractedResults) {
     this.candidateImages = [];
     this.extractionImages = {};
     this.onExtractedResults = onExtractedResults;
+    this.onCameraSelected = null;
     this.pastBlurValues = [];
     this.isRunning = false;
     this.scanStartTime = null;
@@ -11198,47 +11188,8 @@ class ExtractorVideo {
     this.waitingForSecondSide = false;
     this.hasShownTurnMessage = false;
     this.turnMessageTimer = null;
-    this.debugLog = [];
-    this.onExtractedResults = onExtractedResults;
-  }
-  logDebug(event, data = {}) {
-    if (!ExtractorVideo.DEBUG) return;
-    const entry = {
-      ts: new Date().toISOString(),
-      event,
-      data
-    };
-    this.debugLog.push(entry);
-    try {
-      console.log("[ScanDocAI]", event, data);
-    } catch (_) {}
-  }
-  getDebugDump() {
-    return {
-      userAgent: navigator.userAgent,
-      secureContext: window.isSecureContext,
-      location: window.location.href,
-      videoPresent: !!this.video,
-      videoReadyState: this.video?.readyState,
-      videoNetworkState: this.video?.networkState,
-      videoPaused: this.video?.paused,
-      videoMuted: this.video?.muted,
-      videoAutoplay: this.video?.autoplay,
-      videoPlaysInline: this.video?.playsInline,
-      videoDimensions: {
-        videoWidth: this.video?.videoWidth || 0,
-        videoHeight: this.video?.videoHeight || 0,
-        clientWidth: this.video?.clientWidth || 0,
-        clientHeight: this.video?.clientHeight || 0
-      },
-      streamTracks: this.video?.srcObject ? this.video.srcObject.getTracks().map(t => ({
-        kind: t.kind,
-        label: t.label,
-        readyState: t.readyState,
-        enabled: t.enabled
-      })) : [],
-      log: this.debugLog
-    };
+    this.currentStream = null;
+    this.lastCameraInfo = null;
   }
   reset() {
     this.stopVideo();
@@ -11254,18 +11205,32 @@ class ExtractorVideo {
     this.lastMessage = null;
     this.waitingForSecondSide = false;
     this.hasShownTurnMessage = false;
+    this.lastCameraInfo = null;
     clearTimeout(this.turnMessageTimer);
     this.turnMessageTimer = null;
-    this.debugLog = [];
+  }
+  emitCameraInfo(cameraInfo) {
+    this.lastCameraInfo = cameraInfo;
+    try {
+      if (typeof this.onCameraSelected === "function") {
+        this.onCameraSelected(cameraInfo);
+      }
+    } catch (err) {
+      console.warn("onCameraSelected callback failed:", err);
+    }
+    try {
+      window.dispatchEvent(new CustomEvent("ScanDocAICameraSelected", {
+        detail: cameraInfo
+      }));
+    } catch (err) {
+      console.warn("Could not dispatch ScanDocAICameraSelected event:", err);
+    }
   }
   async analyzeVideoStream() {
     if (!this.isRunning) return;
     const now = Date.now();
     const cfgValues = (0,_config__WEBPACK_IMPORTED_MODULE_1__.getScanDocAIConfigValues)();
     if (this.scanStartTime && now - this.scanStartTime > cfgValues.MAX_SCAN_DURATION_MS) {
-      this.logDebug("scan_timeout", {
-        elapsedMs: now - this.scanStartTime
-      });
       this.stopVideo();
       this.onExtractedResults({
         success: false,
@@ -11276,16 +11241,7 @@ class ExtractorVideo {
     }
     const canvas = document.createElement("canvas");
     const video = document.getElementById("ScanDocAIVideoElement");
-    if (!video) {
-      this.logDebug("analyze_no_video_element");
-      setTimeout(() => this.analyzeVideoStream(), ExtractorVideo.FREQUENCY_MS);
-      return;
-    }
-    if (video.videoWidth < video.videoHeight) {
-      this.logDebug("portrait_video_detected", {
-        videoWidth: video.videoWidth,
-        videoHeight: video.videoHeight
-      });
+    if (video && video.videoWidth < video.videoHeight) {
       this.showMessage("Please rotate your device to landscape mode.");
       this.candidateImages = [];
       setTimeout(() => this.analyzeVideoStream(), ExtractorVideo.FREQUENCY_MS);
@@ -11304,9 +11260,6 @@ class ExtractorVideo {
       const [isValidationOk, response] = await (0,_requests_validation__WEBPACK_IMPORTED_MODULE_3__["default"])(images.map(e => e.validationImg), this.pastBlurValues, {});
       if (!isValidationOk) {
         const msg = Array.isArray(response) ? response.join(", ") : String(response || "");
-        this.logDebug("validation_failed", {
-          response: msg
-        });
         if (msg.toLowerCase().includes("token expired/invalid")) {
           this.stopVideo();
           this.showMessage("Token expired/invalid. Please provide a new token.", true);
@@ -11321,7 +11274,6 @@ class ExtractorVideo {
         return;
       }
       if (response?.InfoCode === "1006" && response?.TransactionID) {
-        this.logDebug("unsupported_document", response);
         const frontImage = this.candidateImages[this.candidateImages.length - 1].fullImg;
         await (0,_requests_error_logging__WEBPACK_IMPORTED_MODULE_4__["default"])(frontImage, "", response.TransactionID, response.OS, response.Device, response.Browser);
         this.showMessage("Document not supported.", true);
@@ -11403,10 +11355,6 @@ class ExtractorVideo {
         return;
       }
       this.candidateImages = [];
-    }).catch(err => {
-      this.logDebug("document_detector_error", {
-        message: err?.message || String(err)
-      });
     }).finally(() => {
       setTimeout(() => this.analyzeVideoStream(), ExtractorVideo.FREQUENCY_MS);
     });
@@ -11427,7 +11375,7 @@ class ExtractorVideo {
     this.turnMessageTimer = null;
     this.stopVideo();
     if (isExtractionOk) {
-      this.showMessage("Success - data extracted", "success");
+      this.showMessage("Success - data extracted", true);
       const shouldStop = this.onExtractedResults({
         success: true,
         code: "001",
@@ -11435,7 +11383,7 @@ class ExtractorVideo {
         data: extractionData
       });
       if (shouldStop === true) {
-        setTimeout(() => this.analyzeVideoStream(), ExtractorVideo.FREQUENCY_MS);
+        setTimeout(() => this.startVideo(), ExtractorVideo.FREQUENCY_MS);
       }
     } else {
       this.onExtractedResults({
@@ -11443,509 +11391,89 @@ class ExtractorVideo {
         code: "005",
         info: "Document validation passed but extraction failed."
       });
-      setTimeout(() => this.analyzeVideoStream(), ExtractorVideo.FREQUENCY_MS);
-    }
-  }
-  getSupportedConstraintsSafe() {
-    if (!navigator.mediaDevices?.getSupportedConstraints) return {};
-    try {
-      return navigator.mediaDevices.getSupportedConstraints();
-    } catch (_) {
-      return {};
-    }
-  }
-  getAspectRatio(settings) {
-    if (typeof settings?.aspectRatio === "number" && settings.aspectRatio > 0) {
-      return settings.aspectRatio;
-    }
-    if (settings?.width && settings?.height) {
-      return settings.width / settings.height;
-    }
-    return null;
-  }
-  isLandscape(settings) {
-    return (settings?.width || 0) > (settings?.height || 0);
-  }
-  isFrontLabel(label) {
-    const l = (label || "").toLowerCase();
-    return l.includes("front") || l.includes("selfie") || l.includes("user facing") || l.includes("facing front");
-  }
-  isRearLikeLabel(label) {
-    const l = (label || "").toLowerCase();
-    return l.includes("rear") || l.includes("back") || l.includes("environment") || l.includes("facing back") || l.includes("facing rear");
-  }
-  scoreTrack({
-    settings,
-    label
-  }) {
-    const width = settings?.width || 0;
-    const height = settings?.height || 0;
-    const pixels = width * height;
-    const aspectRatio = this.getAspectRatio(settings) || 0;
-    let score = pixels;
-    if (width > height) score += 1_000_000_000;
-    if (aspectRatio >= 1.3) score += 100_000_000;
-    if (this.isRearLikeLabel(label)) score += 10_000_000;
-    if (this.isFrontLabel(label)) score -= 10_000_000_000;
-    return score;
-  }
-  buildVideoConstraints({
-    width,
-    height,
-    mode,
-    deviceId
-  }) {
-    const supported = this.getSupportedConstraintsSafe();
-    const video = {};
-    if (deviceId) {
-      video.deviceId = {
-        exact: deviceId
-      };
-    } else if (supported.facingMode) {
-      if (typeof mode === "string") {
-        video.facingMode = {
-          ideal: mode
-        };
-      } else if (mode && typeof mode === "object") {
-        video.facingMode = mode;
-      } else {
-        video.facingMode = {
-          ideal: "environment"
-        };
-      }
-    }
-    if (supported.width) video.width = {
-      ideal: width
-    };
-    if (supported.height) video.height = {
-      ideal: height
-    };
-    if (supported.aspectRatio) video.aspectRatio = {
-      ideal: width / height
-    };
-    return {
-      video,
-      audio: false
-    };
-  }
-  async pauseBetweenCameraOps(ms = 180) {
-    await new Promise(resolve => setTimeout(resolve, ms));
-  }
-  async stopMediaStream(stream) {
-    if (!stream) return;
-    try {
-      stream.getTracks().forEach(t => t.stop());
-    } catch (_) {}
-    await this.pauseBetweenCameraOps();
-  }
-  async tryEnableDocumentFocus(stream) {
-    const track = stream?.getVideoTracks?.()[0];
-    if (!track) {
-      this.logDebug("focus_no_track");
-      return {
-        ok: false,
-        reason: "No video track found"
-      };
-    }
-    if (!track.getCapabilities || !track.applyConstraints) {
-      this.logDebug("focus_api_unavailable");
-      return {
-        ok: false,
-        reason: "Focus APIs unavailable on this browser/device",
-        settingsBefore: track.getSettings ? track.getSettings() : null
-      };
+      setTimeout(() => this.startVideo(), ExtractorVideo.FREQUENCY_MS);
     }
-    const caps = track.getCapabilities();
-    const result = {
-      ok: true,
-      capabilities: caps,
-      attempts: [],
-      settingsBefore: track.getSettings ? track.getSettings() : null
-    };
-    try {
-      let applied = false;
-      if (Array.isArray(caps.focusMode) && caps.focusMode.includes("continuous")) {
-        await track.applyConstraints({
-          advanced: [{
-            focusMode: "continuous"
-          }]
-        });
-        result.attempts.push("Applied focusMode=continuous");
-        applied = true;
-      }
-      if (caps.focusDistance) {
-        const min = caps.focusDistance.min;
-        const max = caps.focusDistance.max;
-        const docDistance = min + (max - min) * 0.30;
-        const advanced = [];
-        if (Array.isArray(caps.focusMode) && caps.focusMode.includes("manual")) {
-          advanced.push({
-            focusMode: "manual"
-          });
-        }
-        advanced.push({
-          focusDistance: docDistance
-        });
-        await track.applyConstraints({
-          advanced
-        });
-        result.attempts.push(`Applied focusDistance=${docDistance}`);
-        applied = true;
-      }
-      if (!applied) {
-        result.ok = false;
-        result.reason = "No supported focus controls were exposed";
-      }
-      result.settingsAfter = track.getSettings ? track.getSettings() : null;
-      this.logDebug("focus_result", result);
-      return result;
-    } catch (err) {
-      result.ok = false;
-      result.error = err.message || String(err);
-      result.settingsAfter = track.getSettings ? track.getSettings() : null;
-      this.logDebug("focus_error", result);
-      return result;
-    }
-  }
-  async openCandidateStream({
-    mode,
-    deviceId,
-    width,
-    height
-  }) {
-    const constraints = this.buildVideoConstraints({
-      width,
-      height,
-      mode,
-      deviceId
-    });
-    this.logDebug("getUserMedia_attempt", {
-      constraints
-    });
-    const stream = await navigator.mediaDevices.getUserMedia(constraints);
-    this.logDebug("getUserMedia_success", {
-      deviceId,
-      width,
-      height,
-      trackLabels: stream.getTracks().map(t => t.label)
-    });
-    return stream;
-  }
-  async testDeviceAtPreferredResolutions(device, mode) {
-    const attempts = [];
-    for (const size of ExtractorVideo.VIDEO_CANDIDATE_SETTINGS) {
-      let stream = null;
-      try {
-        stream = await this.openCandidateStream({
-          mode,
-          deviceId: device?.deviceId,
-          width: size.width,
-          height: size.height
-        });
-        const track = stream.getVideoTracks()[0];
-        const settings = track.getSettings();
-        const label = track.label || device?.label || "";
-        const aspectRatio = this.getAspectRatio(settings);
-        const result = {
-          stream,
-          label,
-          settings,
-          aspectRatio,
-          landscape: this.isLandscape(settings),
-          score: this.scoreTrack({
-            settings,
-            label
-          }),
-          requested: size
-        };
-        attempts.push({
-          ok: true,
-          requested: size,
-          returnedWidth: settings.width,
-          returnedHeight: settings.height,
-          aspectRatio,
-          label
-        });
-        this.logDebug("device_test_success", {
-          deviceLabel: device?.label,
-          deviceId: device?.deviceId,
-          requested: size,
-          settings,
-          label
-        });
-        return {
-          result,
-          attempts
-        };
-      } catch (err) {
-        attempts.push({
-          ok: false,
-          requested: size,
-          error: err.message || String(err)
-        });
-        this.logDebug("device_test_error", {
-          deviceLabel: device?.label,
-          deviceId: device?.deviceId,
-          requested: size,
-          error: err?.message || String(err),
-          name: err?.name
-        });
-        await this.stopMediaStream(stream);
-      }
-    }
-    return {
-      result: null,
-      attempts
-    };
-  }
-  async pickBestPhoneCamera(mode = "environment") {
-    const debug = {
-      mode,
-      tested: []
-    };
-    let warmupStream = null;
-    let warmupResult = null;
-    try {
-      const warmupSize = ExtractorVideo.VIDEO_CANDIDATE_SETTINGS[2];
-      warmupStream = await this.openCandidateStream({
-        mode,
-        width: warmupSize.width,
-        height: warmupSize.height
-      });
-      const track = warmupStream.getVideoTracks()[0];
-      const settings = track.getSettings();
-      const label = track.label || "";
-      warmupResult = {
-        stream: warmupStream,
-        label,
-        settings,
-        aspectRatio: this.getAspectRatio(settings),
-        landscape: this.isLandscape(settings),
-        score: this.scoreTrack({
-          settings,
-          label
-        }),
-        requested: warmupSize
-      };
-      this.logDebug("warmup_success", {
-        label,
-        settings
-      });
-    } catch (err) {
-      this.logDebug("warmup_error", {
-        name: err?.name,
-        message: err?.message || String(err)
-      });
-      warmupStream = null;
-    }
-    let devices = [];
-    try {
-      devices = await navigator.mediaDevices.enumerateDevices();
-      this.logDebug("enumerate_devices", {
-        devices: devices.map(d => ({
-          kind: d.kind,
-          label: d.label,
-          deviceId: d.deviceId
-        }))
-      });
-    } catch (err) {
-      this.logDebug("enumerate_devices_error", {
-        name: err?.name,
-        message: err?.message || String(err)
-      });
-      devices = [];
-    }
-    const videoInputs = devices.filter(d => d.kind === "videoinput");
-    const candidateDevices = mode === "environment" ? videoInputs.filter(d => !this.isFrontLabel(d.label)) : videoInputs;
-    if (warmupStream) {
-      await this.stopMediaStream(warmupStream);
-      warmupStream = null;
-    }
-    const usableResults = [];
-    for (let i = 0; i < candidateDevices.length; i += 1) {
-      const device = candidateDevices[i];
-      const {
-        result,
-        attempts
-      } = await this.testDeviceAtPreferredResolutions(device, mode);
-      debug.tested.push({
-        deviceId: device.deviceId,
-        label: device.label,
-        attempts,
-        final: result ? {
-          label: result.label,
-          settings: result.settings,
-          aspectRatio: result.aspectRatio,
-          landscape: result.landscape,
-          score: result.score,
-          requested: result.requested
-        } : null
-      });
-      if (result) {
-        const frontRejected = mode === "environment" && this.isFrontLabel(result.label);
-        const geometryOk = result.landscape;
-        if (!frontRejected && geometryOk) {
-          usableResults.push(result);
-        } else {
-          await this.stopMediaStream(result.stream);
-        }
-      }
-    }
-    if (usableResults.length > 0) {
-      usableResults.sort((a, b) => b.score - a.score);
-      const chosen = usableResults[0];
-      for (const candidate of usableResults) {
-        if (candidate !== chosen) {
-          await this.stopMediaStream(candidate.stream);
-        }
-      }
-      debug.chosen = {
-        label: chosen.label,
-        settings: chosen.settings,
-        aspectRatio: chosen.aspectRatio,
-        requested: chosen.requested,
-        source: "device-test"
-      };
-      this.logDebug("camera_chosen", debug.chosen);
-      return {
-        chosen,
-        debug
-      };
-    }
-    for (const size of ExtractorVideo.VIDEO_CANDIDATE_SETTINGS) {
-      try {
-        const stream = await this.openCandidateStream({
-          mode,
-          width: size.width,
-          height: size.height
-        });
-        const track = stream.getVideoTracks()[0];
-        const settings = track.getSettings();
-        const label = track.label || "";
-        const aspectRatio = this.getAspectRatio(settings);
-        const landscape = this.isLandscape(settings);
-        if (mode === "environment" && !landscape) {
-          await this.stopMediaStream(stream);
-          continue;
-        }
-        const chosen = {
-          stream,
-          label,
-          settings,
-          aspectRatio,
-          landscape,
-          score: this.scoreTrack({
-            settings,
-            label
-          }),
-          requested: size
-        };
-        debug.chosen = {
-          label,
-          settings,
-          aspectRatio,
-          requested: size,
-          source: "fallback-facingMode"
-        };
-        this.logDebug("camera_chosen_fallback", debug.chosen);
-        return {
-          chosen,
-          debug
-        };
-      } catch (err) {
-        this.logDebug("fallback_open_error", {
-          requested: size,
-          name: err?.name,
-          message: err?.message || String(err)
-        });
-      }
-    }
-    throw new Error("Could not start a suitable camera.");
   }
   async startVideo() {
     try {
-      this.logDebug("startVideo_begin");
       const serviceConfig = (0,_config__WEBPACK_IMPORTED_MODULE_1__.getScanDocAIConfig)();
       await serviceConfig.getAccessToken(false);
       const videoElem = document.getElementById("ScanDocAIVideoElement");
       if (!videoElem) {
         throw new Error("Video element not found.");
       }
+      if (!navigator.mediaDevices || !navigator.mediaDevices.getUserMedia) {
+        throw new Error("getUserMedia is not available");
+      }
+      if (!window.isSecureContext) {
+        throw new Error("Camera requires HTTPS / secure context");
+      }
       this.video = videoElem;
       this.isRunning = true;
       this.scanStartTime = Date.now();
       const cfgValues = (0,_config__WEBPACK_IMPORTED_MODULE_1__.getScanDocAIConfigValues)();
       const mode = cfgValues.VIDEO_FACING_MODE ?? "environment";
-      const {
-        chosen,
-        debug
-      } = await this.pickBestPhoneCamera(mode);
-      this.video.srcObject = chosen.stream;
-      this.logDebug("srcObject_assigned", {
-        label: chosen.label,
-        settings: chosen.settings
+      await this.stopCurrentStream();
+      const cameraResult = await openBestDocumentCamera({
+        videoElement: this.video,
+        preferredFacingMode: mode
       });
+      this.currentStream = cameraResult.stream;
+      this.lastCameraInfo = cameraResult;
+      this.emitCameraInfo(cameraResult);
       try {
-        await this.video.play();
-        this.logDebug("video_play_success", {
-          readyState: this.video.readyState,
-          videoWidth: this.video.videoWidth,
-          videoHeight: this.video.videoHeight
-        });
-      } catch (e) {
-        this.logDebug("video_play_error", {
-          name: e?.name,
-          message: e?.message || String(e)
-        });
-        throw e;
+        const focusResult = await tryEnableDocumentFocus(this.currentStream);
+        console.log("Focus result:", focusResult);
+      } catch (focusError) {
+        console.warn("Could not apply focus settings:", focusError);
+      }
+      if (!this._boundLoadedDataHandler) {
+        this._boundLoadedDataHandler = () => this.adjustOverlayPosition();
+        this.video.addEventListener("loadeddata", this._boundLoadedDataHandler);
+      }
+      if (!this._boundResizeHandler) {
+        this._boundResizeHandler = () => this.adjustOverlayPosition();
+        window.addEventListener("resize", this._boundResizeHandler);
       }
-      this.focusDebug = await this.tryEnableDocumentFocus(chosen.stream);
-      this.cameraDebug = debug;
-      this.video.addEventListener("loadeddata", () => {
-        this.logDebug("video_loadeddata", {
-          videoWidth: this.video.videoWidth,
-          videoHeight: this.video.videoHeight
-        });
-        this.adjustOverlayPosition();
-      });
-      this.video.addEventListener("error", () => {
-        this.logDebug("video_element_error", {
-          error: this.video?.error ? {
-            code: this.video.error.code,
-            message: this.video.error.message
-          } : null
-        });
-      });
-      window.addEventListener("resize", () => this.adjustOverlayPosition());
       setTimeout(() => this.adjustOverlayPosition(), 500);
       this.scanStartTime = Date.now();
       setTimeout(() => this.analyzeVideoStream(), ExtractorVideo.FREQUENCY_MS);
       this.showMessage("Starting scanning");
-      this.logDebug("startVideo_success", this.getDebugDump());
+      console.log("Chosen camera:", {
+        label: cameraResult.label,
+        deviceId: cameraResult.deviceId,
+        strategy: cameraResult.strategy,
+        settings: cameraResult.settings,
+        score: cameraResult.score,
+        tested: cameraResult.tested
+      });
       return true;
     } catch (error) {
       console.error("startVideo failed:", error);
-      this.logDebug("startVideo_failed", {
-        name: error?.name,
-        message: error?.message || String(error),
-        dump: this.getDebugDump()
-      });
       this.isRunning = false;
       this.stopVideo();
       this.onExtractedResults({
         success: false,
         code: error.status === 401 || error.status === 403 ? "004" : "005",
-        info: error.status === 401 || error.status === 403 ? "Authentication failed: Invalid API key/token." : "Startup failed: " + (error.message || "Unknown error"),
-        debug: ExtractorVideo.DEBUG ? this.getDebugDump() : undefined
+        info: error.status === 401 || error.status === 403 ? "Authentication failed: Invalid API key/token." : "Startup failed: " + (error.message || "Unknown error")
       });
       return false;
     }
   }
+  async stopCurrentStream() {
+    await stopStream(this.currentStream);
+    this.currentStream = null;
+    if (this.video) {
+      this.video.srcObject = null;
+    }
+    await delay(200);
+  }
   stopVideo() {
     this.isRunning = false;
-    this.logDebug("stopVideo_called");
     if (this.video) {
-      this.video.pause();
+      try {
+        this.video.pause();
+      } catch (_) {}
       if (this.video.srcObject !== undefined && this.video.srcObject !== null) {
         try {
           this.video.srcObject.getTracks().forEach(t => t.stop());
@@ -11953,17 +11481,26 @@ class ExtractorVideo {
       }
       this.video.srcObject = null;
     }
+    if (this.currentStream) {
+      try {
+        this.currentStream.getTracks().forEach(t => t.stop());
+      } catch (_) {}
+    }
+    this.currentStream = null;
     clearTimeout(this.turnMessageTimer);
     this.turnMessageTimer = null;
   }
   adjustOverlayPosition() {
     const video = this.video;
     const dot = document.querySelector(".centerGuideDot");
-    if (!video || !dot || video.videoWidth === 0 || video.videoHeight === 0) return;
+    if (!video || !dot || video.videoWidth === 0 || video.videoHeight === 0) {
+      return;
+    }
     const videoRatio = video.videoWidth / video.videoHeight;
     const container = video.parentElement;
     const containerRatio = container.clientWidth / container.clientHeight;
-    let scaleWidth, scaleHeight;
+    let scaleWidth;
+    let scaleHeight;
     if (videoRatio > containerRatio) {
       scaleWidth = container.clientWidth;
       scaleHeight = container.clientWidth / videoRatio;
@@ -12047,81 +11584,98 @@ class ExtractorVideo {
 					}
 				</style>
 			`;
-    } else {
-      return `
-				<div class="desktopFeedback" id="ScanDocAIMessage"></div>
-				<div class="desktopVideoArea">
-					<div class="desktopVideoHolder">
-						<video id="ScanDocAIVideoElement" class="desktopVideo" autoplay muted playsinline></video>
-						<div class="backgroundOverlay"></div>
-						<div class="centerGuideDot"></div>
-					</div>
-				</div>
-		
-				<style>
-					.desktopVideoArea {
-						display: flex;
-						flex-direction: column;
-						gap: 8px;
-						padding: 16px;
-						background-color: rgba(255, 255, 255, 0.05);
-						border: 1px solid ${borderColor};
-						border-radius: 15px;
-						margin-left: 20%;
-						margin-right: 20%;
-					}
-					.desktopVideoHolder {
-						position: relative;
-						width: 100%;
-						overflow: hidden;
-					}
-					.desktopVideo {
-						width: 100%;
-						height: auto;
-						margin-left: auto;
-						margin-right: auto;
-						max-width: 100vw;
-						max-height: 100vh;
-					}
-					.centerGuideDot {
-						position: absolute;
-						width: 16px;
-						height: 16px;
-						background-color: #00ff55;
-						border-radius: 50%;
-						box-shadow: 0 0 8px 2px rgba(0, 255, 100, 0.8);
-						z-index: 4;
-						animation: flicker 1s infinite;
-						pointer-events: none;
-						display: none;
-					}
-					@keyframes flicker {
-						0%, 100% { opacity: 1; }
-						50% { opacity: 0.3; }
-					}
-					.backgroundOverlay {
-						position: absolute;
-						top: 0;
-						left: 0;
-						width: 100%;
-						height: 100%;
-						background-color: rgba(0, 0, 0, 0.051);
-						z-index: 2;
-						pointer-events: none;
-					}
-					.desktopFeedback {
-						position: relative;
-						display: flex;
-						font-size: 22px;
-						font-weight: 600;
-						min-height: 36px;
-						justify-content: center;
-						align-items: center;
-						color: ${messageColor};
-					}
-				</style>
-			`;
     }
+    return `
+			<div class="desktopFeedback" id="ScanDocAIMessage"></div>
+			<div class="desktopVideoArea">
+				<div class="desktopVideoHolder">
+					<video id="ScanDocAIVideoElement" class="desktopVideo" autoplay muted playsinline></video>
+					<div class="backgroundOverlay"></div>
+					<div class="centerGuideDot"></div>
+				</div>
+			</div>
+	
+			<style>
+				.desktopVideoArea {
+					display: flex;
+					flex-direction: column;
+					gap: 8px;
+					padding: 16px;
+					background-color: rgba(255, 255, 255, 0.05);
+					border: 1px solid ${borderColor};
+					border-radius: 15px;
+					margin-left: 20%;
+					margin-right: 20%;
+				}
+	
+				.desktopVideoHolder {
+					position: relative;
+					width: 100%;
+					overflow: hidden;
+				}
+
+				.desktopVideo {
+					width: 100%;
+					height: auto;
+					margin-left: auto;
+					margin-right: auto;
+					max-width: 100vw;
+					max-height: 100vh;
+				}
+				
+				.centerGuideDot {
+					position: absolute;
+					width: 16px;
+					height: 16px;
+					background-color: #00ff55;
+					border-radius: 50%;
+					box-shadow: 0 0 8px 2px rgba(0, 255, 100, 0.8);
+					z-index: 4;
+					animation: flicker 1s infinite;
+					pointer-events: none;
+					display: none;
+				}
+
+				@keyframes flicker {
+					0%, 100% { opacity: 1; }
+					50% { opacity: 0.3; }
+				}
+
+				.backgroundOverlay {
+					position: absolute;
+					top: 0;
+					left: 0;
+					width: 100%;
+					height: 100%;
+					background-color: rgba(0, 0, 0, 0.051);
+					z-index: 2;
+					pointer-events: none;
+				}
+	
+				.desktopFeedback {
+					position: relative;
+					display: flex;
+					font-size: 22px;
+					font-weight: 600;
+					min-height: 36px;
+					justify-content: center;
+					align-items: center;
+					color: ${messageColor};
+				}
+				.scandoc-camera-debug {
+					margin-top: 12px;
+					padding: 10px;
+					max-width: 95vw;
+					overflow: auto;
+					font-size: 12px;
+					background: #f3f3f3;
+					border: 1px solid #ddd;
+					border-radius: 8px;
+					white-space: pre-wrap;
+					word-break: break-word;
+				}
+			</style>
+		`;
   }
 }
 let EXTRACTION_VIDEO = undefined;
@@ -12151,6 +11705,339 @@ function getExtractionVideo(tokenOrCallback, maybeCallback) {
   }
   return EXTRACTION_VIDEO;
 }
+function delay(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+async function stopStream(stream) {
+  if (!stream) return;
+  for (const track of stream.getTracks()) {
+    try {
+      track.stop();
+    } catch (_) {}
+  }
+}
+function getAspectRatio(settings = {}) {
+  if (typeof settings.aspectRatio === "number" && settings.aspectRatio > 0) {
+    return settings.aspectRatio;
+  }
+  if (settings.width && settings.height) {
+    return settings.width / settings.height;
+  }
+  return null;
+}
+async function attachStreamToVideo(videoEl, stream) {
+  if (!videoEl) return;
+  videoEl.srcObject = stream;
+  try {
+    await videoEl.play();
+  } catch (_) {}
+}
+function getSupportedConstraintsSafe() {
+  try {
+    return navigator.mediaDevices?.getSupportedConstraints?.() || {};
+  } catch (_) {
+    return {};
+  }
+}
+function buildDocumentScanConstraints(mode = "environment") {
+  const supported = getSupportedConstraintsSafe();
+  const video = {};
+  if (supported.facingMode) {
+    video.facingMode = typeof mode === "string" ? {
+      ideal: mode
+    } : mode || {
+      ideal: "environment"
+    };
+  }
+  if (supported.width) {
+    video.width = {
+      ideal: 1920
+    };
+  }
+  if (supported.height) {
+    video.height = {
+      ideal: 1080
+    };
+  }
+  if (supported.aspectRatio) {
+    video.aspectRatio = {
+      ideal: 16 / 9
+    };
+  }
+  return {
+    video,
+    audio: false
+  };
+}
+function buildDeviceConstraints(deviceId) {
+  const supported = getSupportedConstraintsSafe();
+  const video = {
+    deviceId: {
+      exact: deviceId
+    }
+  };
+  if (supported.width) {
+    video.width = {
+      ideal: 1920
+    };
+  }
+  if (supported.height) {
+    video.height = {
+      ideal: 1080
+    };
+  }
+  if (supported.aspectRatio) {
+    video.aspectRatio = {
+      ideal: 16 / 9
+    };
+  }
+  return {
+    video,
+    audio: false
+  };
+}
+async function enumerateVideoInputDevices() {
+  if (!navigator.mediaDevices?.enumerateDevices) return [];
+  try {
+    const devices = await navigator.mediaDevices.enumerateDevices();
+    return devices.filter(d => d.kind === "videoinput");
+  } catch (error) {
+    console.warn("enumerateDevices failed:", error);
+    return [];
+  }
+}
+function normalizeLabel(label = "") {
+  return String(label).trim().toLowerCase();
+}
+function isLikelyRearCamera(label = "") {
+  const v = normalizeLabel(label);
+  return v.includes("back") || v.includes("rear") || v.includes("environment") || v.includes("world");
+}
+function isLikelyFrontCamera(label = "") {
+  const v = normalizeLabel(label);
+  return v.includes("front") || v.includes("user") || v.includes("facetime") || v.includes("selfie");
+}
+function isLikelyUltraWideOrMacro(label = "") {
+  const v = normalizeLabel(label);
+  return v.includes("ultra") || v.includes("ultrawide") || v.includes("wide angle") || v.includes("0.5") || v.includes("macro") || v.includes("fisheye");
+}
+function isLikelyTelephoto(label = "") {
+  const v = normalizeLabel(label);
+  return v.includes("tele") || v.includes("zoom") || v.includes("3x") || v.includes("5x") || v.includes("10x");
+}
+function getPixelCount(settings = {}) {
+  return Number(settings.width || 0) * Number(settings.height || 0);
+}
+function scoreCameraCandidate({
+  label,
+  settings,
+  isBootstrap = false
+}) {
+  const width = Number(settings?.width || 0);
+  const height = Number(settings?.height || 0);
+  const pixels = getPixelCount(settings);
+  const aspectRatio = getAspectRatio(settings) || 0;
+  let score = 0;
+  score += pixels;
+  if (isBootstrap) {
+    score += 400000;
+  }
+  if (isLikelyRearCamera(label)) {
+    score += 4000000;
+  }
+  if (isLikelyFrontCamera(label)) {
+    score -= 12000000;
+  }
+  if (isLikelyUltraWideOrMacro(label)) {
+    score -= 10000000;
+  }
+  if (isLikelyTelephoto(label)) {
+    score -= 2500000;
+  }
+  if (aspectRatio >= 1.6 && aspectRatio <= 1.9) {
+    score += 700000;
+  }
+  if (aspectRatio > 2.05) {
+    score -= 1500000;
+  }
+  if (width >= 1920) {
+    score += 500000;
+  }
+  if (width < 1280 || height < 720) {
+    score -= 4000000;
+  }
+  return score;
+}
+async function probeCameraCandidate(device) {
+  let stream = null;
+  try {
+    stream = await navigator.mediaDevices.getUserMedia(buildDeviceConstraints(device.deviceId));
+    const track = stream.getVideoTracks?.()[0];
+    const settings = track?.getSettings?.() || {};
+    const label = track?.label || device.label || "";
+    const score = scoreCameraCandidate({
+      label,
+      settings
+    });
+    return {
+      ok: true,
+      device,
+      stream,
+      label,
+      deviceId: settings.deviceId || device.deviceId,
+      settings,
+      aspectRatio: getAspectRatio(settings),
+      score
+    };
+  } catch (error) {
+    if (stream) {
+      await stopStream(stream);
+    }
+    return {
+      ok: false,
+      device,
+      error,
+      score: Number.NEGATIVE_INFINITY
+    };
+  }
+}
+function isIOSLike() {
+  const ua = navigator.userAgent || "";
+  return /iPhone|iPad|iPod/i.test(ua);
+}
+async function tryEnableDocumentFocus(stream) {
+  const track = stream?.getVideoTracks?.()[0];
+  if (!track) {
+    return {
+      ok: false,
+      reason: "No video track found"
+    };
+  }
+  if (!track.getCapabilities || !track.applyConstraints) {
+    return {
+      ok: false,
+      reason: "Focus APIs unavailable on this browser/device",
+      settingsBefore: track.getSettings ? track.getSettings() : null
+    };
+  }
+  const caps = track.getCapabilities();
+  const result = {
+    ok: true,
+    capabilities: caps,
+    attempts: [],
+    settingsBefore: track.getSettings ? track.getSettings() : null
+  };
+  try {
+    let applied = false;
+    if (Array.isArray(caps.focusMode) && caps.focusMode.includes("continuous")) {
+      await track.applyConstraints({
+        advanced: [{
+          focusMode: "continuous"
+        }]
+      });
+      result.attempts.push("Applied focusMode=continuous");
+      applied = true;
+    }
+    if (caps.focusDistance) {
+      const min = caps.focusDistance.min ?? 0;
+      const max = caps.focusDistance.max ?? 0;
+      const docDistance = min + (max - min) * 0.3;
+      const advanced = [];
+      if (Array.isArray(caps.focusMode) && caps.focusMode.includes("manual")) {
+        advanced.push({
+          focusMode: "manual"
+        });
+      }
+      advanced.push({
+        focusDistance: docDistance
+      });
+      await track.applyConstraints({
+        advanced
+      });
+      result.attempts.push(`Applied focusDistance=${docDistance}`);
+      applied = true;
+    }
+    if (!applied) {
+      result.ok = false;
+      result.reason = "No supported focus controls were exposed";
+    }
+    result.settingsAfter = track.getSettings ? track.getSettings() : null;
+    return result;
+  } catch (err) {
+    result.ok = false;
+    result.error = err.message || String(err);
+    result.settingsAfter = track.getSettings ? track.getSettings() : null;
+    return result;
+  }
+}
+async function openBestDocumentCamera({
+  videoElement,
+  preferredFacingMode = "environment"
+}) {
+  if (!navigator.mediaDevices || !navigator.mediaDevices.getUserMedia) {
+    throw new Error("getUserMedia is not available");
+  }
+  if (!window.isSecureContext) {
+    throw new Error("Camera requires HTTPS / secure context");
+  }
+  let bootstrapStream;
+  try {
+    bootstrapStream = await navigator.mediaDevices.getUserMedia(buildDocumentScanConstraints(preferredFacingMode));
+  } catch (preferredError) {
+    console.warn("Preferred camera open failed, falling back:", preferredError);
+    bootstrapStream = await navigator.mediaDevices.getUserMedia({
+      video: true,
+      audio: false
+    });
+  }
+  const bootstrapTrack = bootstrapStream.getVideoTracks?.()[0];
+  const bootstrapSettings = bootstrapTrack?.getSettings?.() || {};
+  const bootstrapLabel = bootstrapTrack?.label || "";
+  const bootstrapDeviceId = bootstrapSettings.deviceId || null;
+  let best = {
+    stream: bootstrapStream,
+    label: bootstrapLabel,
+    deviceId: bootstrapDeviceId,
+    settings: bootstrapSettings,
+    aspectRatio: getAspectRatio(bootstrapSettings),
+    score: scoreCameraCandidate({
+      label: bootstrapLabel,
+      settings: bootstrapSettings,
+      isBootstrap: true
+    }),
+    strategy: "bootstrap-environment",
+    tested: []
+  };
+  const devices = await enumerateVideoInputDevices();
+  const rearDevices = devices.filter(d => isLikelyRearCamera(d.label));
+  const candidatesBase = rearDevices.length > 0 ? rearDevices : devices;
+  const candidates = candidatesBase.filter(d => d.deviceId && d.deviceId !== bootstrapDeviceId).filter(d => !isLikelyFrontCamera(d.label)).slice(0, isIOSLike() ? 2 : 4);
+  for (const device of candidates) {
+    const probed = await probeCameraCandidate(device);
+    best.tested.push({
+      label: device.label || "",
+      deviceId: device.deviceId,
+      ok: probed.ok,
+      settings: probed.settings || null,
+      score: probed.score,
+      error: probed.ok ? null : String(probed.error?.message || probed.error || "")
+    });
+    if (!probed.ok) continue;
+    const clearlyBetter = probed.score > best.score + 1000000;
+    if (clearlyBetter) {
+      await stopStream(best.stream);
+      best = {
+        ...probed,
+        strategy: "switched-after-ranking",
+        tested: best.tested
+      };
+    } else {
+      await stopStream(probed.stream);
+    }
+  }
+  await attachStreamToVideo(videoElement, best.stream);
+  return best;
+}
 
 /***/ }),
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "scandoc-ai-components",
   "author": "ScanDoc-AI",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "private": false,
   "description": "Pure JavaScript package for integrating ScanDoc-AI services.",
   "keywords": [