@asteby/storefront-react 0.22.0 → 0.24.0

package/dist/fiscal.cjs

@@ -146,6 +146,26 @@ function personTypeByLength(lengths) {
     return Object.keys(lengths).find((t) => lengths[t] === n) ?? null;
   };
 }
+function personTypeFromPatterns(fid, taxId) {
+  const patterns = fid?.person_patterns;
+  if (!patterns) return null;
+  const v = normalizeTaxId(taxId);
+  for (const type of Object.keys(patterns).sort()) {
+    const re = compile(patterns[type]);
+    if (re?.test(v)) return type;
+  }
+  return null;
+}
+function personTypeResolver(fid, override) {
+  return override ?? ((taxId) => personTypeFromPatterns(fid, taxId));
+}
+function suggestInvoiceUse(fid, regime) {
+  if (!fid || !regime) return null;
+  const allowed = usesFor(fid, regime);
+  const preferred = fid.default_invoice_use;
+  if (preferred && allowed.some((u) => u.code === preferred)) return preferred;
+  return allowed.find((u) => u.suggested_for_regimes?.includes(regime))?.code ?? null;
+}
 function regimesFor(fid, personType) {
   const all = fid?.regimes ?? [];
   if (!personType) return all;
@@ -156,8 +176,9 @@ function usesFor(fid, regime) {
   if (!regime) return all;
   return all.filter((u) => !u.allowed_regimes || u.allowed_regimes.length === 0 || u.allowed_regimes.includes(regime));
 }
-function validateFiscalValues(region, v, personTypeOf) {
+function validateFiscalValues(region, v, personTypeOverride) {
   const fid = region.fiscal_id;
+  const personTypeOf = personTypeResolver(fid, personTypeOverride);
   const out = {};
   const tax = taxIdProblem(fid, v.tax_id ?? "");
   if (tax) out.tax_id = tax;
@@ -215,6 +236,7 @@ var ES2 = {
     useHint: "Solo mostramos los usos que admite tu r\xE9gimen.",
     useChoose: "Elige el uso",
     fromDocument: "De tu {document}",
+    suggested: "Sugerido",
     errors: {
       required: "Completa este campo.",
       taxIdFormat: "Revisa el formato: {kind} no v\xE1lido.",
@@ -247,14 +269,34 @@ var ES2 = {
       qrMismatch: "El c\xF3digo QR de tu documento no coincide con los datos le\xEDdos. Revisa con calma tu RFC y tu nombre.",
       stale: "Tu documento tiene {days} d\xEDas de emitido. Si algo cambi\xF3 en tu registro, descarga uno nuevo.",
       regimeMissing: "No pudimos detectar tu r\xE9gimen. El\xEDgelo de la lista.",
-      fieldsMissing: "No encontramos algunos datos en el documento. Compl\xE9talos para continuar."
+      fieldsMissing: "No encontramos algunos datos en el documento. Compl\xE9talos para continuar.",
+      qrPartial: "Del c\xF3digo QR solo le\xEDmos tu identificador fiscal. Completa los dem\xE1s datos o sube el PDF."
+    },
+    scan: {
+      title: "Escanea tu {document}",
+      photo: "Tomar foto del QR",
+      photoHint: "Enfoca el c\xF3digo QR de tu documento.",
+      camera: "Escanear con la c\xE1mara",
+      cameraTitle: "Apunta al c\xF3digo QR",
+      cameraGuide: "Centra el c\xF3digo QR dentro del marco.",
+      cameraStarting: "Abriendo la c\xE1mara\u2026",
+      cameraRead: "C\xF3digo le\xEDdo",
+      cameraDenied: "No pudimos usar la c\xE1mara. Elige una foto o sube el PDF.",
+      cameraUnavailable: "Este dispositivo no permite usar la c\xE1mara aqu\xED. Elige una foto o sube el PDF.",
+      closeCamera: "Cerrar la c\xE1mara",
+      choosePhoto: "Elegir una foto",
+      open: "Escanear {document}",
+      manual: "Capturar a mano",
+      close: "Cerrar"
     },
     errors: {
       not_pdf: "Ese archivo no es un PDF. Sube el PDF que descargaste o captura tus datos a mano.",
       too_large: "El archivo pesa m\xE1s de {size}. Sube el PDF original o captura tus datos a mano.",
       no_text: "Este PDF parece una imagen escaneada y no podemos leerlo. Captura tus datos a mano.",
       password: "Este PDF tiene contrase\xF1a y no podemos abrirlo. Desc\xE1rgalo de nuevo sin contrase\xF1a o captura tus datos a mano.",
-      unreadable: "No pudimos leer este archivo. Int\xE9ntalo con otro o captura tus datos a mano."
+      unreadable: "No pudimos leer este archivo. Int\xE9ntalo con otro o captura tus datos a mano.",
+      no_qr: "No encontramos el c\xF3digo QR en la foto. Ac\xE9rcate, evita reflejos o sube el PDF.",
+      not_image: "Ese archivo no es una foto que podamos leer. Toma otra foto o sube el PDF."
     },
     summaryTitleOne: "Revisa 1 campo para continuar",
     summaryTitleMany: "Revisa {n} campos para continuar"
@@ -297,7 +339,14 @@ var ES2 = {
     windowTitle: "Ya pas\xF3 el plazo para facturar",
     windowBody: "Este pedido est\xE1 fuera del plazo para pedir factura. Si necesitas ayuda, contacta a la tienda.",
     unavailableTitle: "Factura no disponible",
-    unavailableBody: "Esta tienda no emite factura de este pedido. Si la necesitas, cont\xE1ctala.",
+    unavailableBody: "Este pedido no se puede facturar por ahora. Si la necesitas, contacta a la tienda.",
+    notEnabledTitle: "Facturaci\xF3n a\xFAn no activa",
+    notEnabledBody: "La tienda todav\xEDa no tiene la facturaci\xF3n en l\xEDnea activa. Si necesitas factura, cont\xE1ctala.",
+    unknownTitle: "Factura",
+    unknownBody: "Por ahora no podemos mostrar el estado de la facturaci\xF3n de este pedido. Si necesitas factura, contacta a la tienda.",
+    unreachableBody: "No pudimos verificar la facturaci\xF3n en este momento. Int\xE9ntalo de nuevo en unos minutos o contacta a la tienda.",
+    sandbox: "Facturaci\xF3n en pruebas (sandbox): las facturas no tienen validez fiscal.",
+    windowNote: "Puedes pedirla hasta {days} d\xEDas despu\xE9s de la compra.",
     cancelledTitle: "Factura cancelada",
     cancelledBody: "Esta factura fue cancelada. Si necesitas una nueva, contacta a la tienda.",
     reasons: {
@@ -334,6 +383,7 @@ var EN2 = {
     useHint: "We only list the uses your regime admits.",
     useChoose: "Choose the use",
     fromDocument: "From your {document}",
+    suggested: "Suggested",
     errors: {
       required: "Fill in this field.",
       taxIdFormat: "Check the format: not a valid {kind}.",
@@ -366,14 +416,34 @@ var EN2 = {
       qrMismatch: "The QR code of your document does not match what we read. Check your tax ID and name carefully.",
       stale: "Your document was issued {days} days ago. If something changed in your registration, download a new one.",
       regimeMissing: "We could not detect your regime. Choose it from the list.",
-      fieldsMissing: "We did not find some details in the document. Fill them in to continue."
+      fieldsMissing: "We did not find some details in the document. Fill them in to continue.",
+      qrPartial: "The QR code only gave us your tax ID. Fill in the rest or upload the PDF."
+    },
+    scan: {
+      title: "Scan your {document}",
+      photo: "Take a photo of the QR",
+      photoHint: "Point at the QR code of your document.",
+      camera: "Scan with the camera",
+      cameraTitle: "Point at the QR code",
+      cameraGuide: "Center the QR code inside the frame.",
+      cameraStarting: "Opening the camera\u2026",
+      cameraRead: "Code read",
+      cameraDenied: "We could not use the camera. Choose a photo or upload the PDF.",
+      cameraUnavailable: "This device does not allow the camera here. Choose a photo or upload the PDF.",
+      closeCamera: "Close the camera",
+      choosePhoto: "Choose a photo",
+      open: "Scan {document}",
+      manual: "Enter by hand",
+      close: "Close"
     },
     errors: {
       not_pdf: "That file is not a PDF. Upload the PDF you downloaded or enter your details by hand.",
       too_large: "The file is larger than {size}. Upload the original PDF or enter your details by hand.",
       no_text: "This PDF looks like a scanned image and we cannot read it. Enter your details by hand.",
       password: "This PDF is password protected and we cannot open it. Download it again without a password or enter your details by hand.",
-      unreadable: "We could not read this file. Try another one or enter your details by hand."
+      unreadable: "We could not read this file. Try another one or enter your details by hand.",
+      no_qr: "We could not find the QR code in the photo. Move closer, avoid glare or upload the PDF.",
+      not_image: "That file is not a photo we can read. Take another photo or upload the PDF."
     },
     summaryTitleOne: "Check 1 field to continue",
     summaryTitleMany: "Check {n} fields to continue"
@@ -416,7 +486,14 @@ var EN2 = {
     windowTitle: "The invoicing period has ended",
     windowBody: "This order is outside the period to request an invoice. If you need help, contact the store.",
     unavailableTitle: "Invoice not available",
-    unavailableBody: "This store does not issue an invoice for this order. If you need one, contact them.",
+    unavailableBody: "This order cannot be invoiced right now. If you need one, contact the store.",
+    notEnabledTitle: "Invoicing not active yet",
+    notEnabledBody: "The store has not turned on online invoicing yet. If you need an invoice, contact them.",
+    unknownTitle: "Invoice",
+    unknownBody: "We cannot show the invoicing status of this order right now. If you need an invoice, contact the store.",
+    unreachableBody: "We could not check invoicing right now. Try again in a few minutes or contact the store.",
+    sandbox: "Invoicing in test mode (sandbox): invoices have no fiscal validity.",
+    windowNote: "You can request it up to {days} days after the purchase.",
     cancelledTitle: "Invoice cancelled",
     cancelledBody: "This invoice was cancelled. If you need a new one, contact the store.",
     reasons: {
@@ -480,7 +557,8 @@ function FiscalIdentityFields({
   errors = {},
   namePrefix = "invoice",
   idPrefix,
-  personTypeOf,
+  personTypeOf: personTypeOverride,
+  suggestedUse,
   disabled,
   locale: localeProp,
   messages,
@@ -495,6 +573,8 @@ function FiscalIdentityFields({
   const base = idPrefix ?? `sf-fiscal-${reactId.replace(/:/g, "")}`;
   const [v, setV] = react.useState({ ...EMPTY, ...values });
   const [shown, setShown] = react.useState(/* @__PURE__ */ new Set());
+  const [autoUse, setAutoUse] = react.useState(null);
+  const personTypeOf = react.useMemo(() => personTypeResolver(region.fiscal_id, personTypeOverride), [region.fiscal_id, personTypeOverride]);
   const root = react.useRef(null);
   const valuesKey = JSON.stringify(values ?? null);
   const first2 = react.useRef(true);
@@ -509,10 +589,17 @@ function FiscalIdentityFields({
   const set = (patch) => {
     const next = { ...v, ...patch };
     if (patch.tax_regime !== void 0 && next.use && !usesFor(fid, next.tax_regime).some((u) => u.code === next.use)) next.use = "";
+    if (patch.tax_regime !== void 0 && !next.use) {
+      const suggestion = suggestInvoiceUse(fid, next.tax_regime);
+      if (suggestion) {
+        next.use = suggestion;
+        setAutoUse(suggestion);
+      } else setAutoUse(null);
+    } else if (patch.use !== void 0) setAutoUse(null);
     setV(next);
     onChange?.(next);
   };
-  const person = personTypeOf?.(v.tax_id) ?? null;
+  const person = personTypeOf(v.tax_id);
   const taxIdOk = !validateFiscalValues(region, { tax_id: v.tax_id }, personTypeOf).tax_id;
   const problems = react.useMemo(() => validateFiscalValues(region, v, personTypeOf), [region, v, personTypeOf]);
   const candidates = regimeCandidates?.length ? regimeCandidates : null;
@@ -680,7 +767,12 @@ function FiscalIdentityFields({
         name: name("use"),
         id: `${base}-use`,
         label: m.use,
-        hint: m.useHint,
+        hint: v.use && (v.use === autoUse || v.use === suggestedUse) ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: cx.mark, "data-sf-suggested": true, children: m.suggested }),
+          " ",
+          "\xB7 ",
+          m.useHint
+        ] }) : m.useHint,
         value: v.use,
         onChange: (e) => set({ use: e.target.value }),
         onBlur: () => touch("use"),
@@ -731,10 +823,93 @@ function summarizeExtraction(x, evidence, validRegimes) {
     evidence
   };
 }
+function cameraSupported() {
+  return typeof navigator !== "undefined" && typeof navigator.mediaDevices?.getUserMedia === "function";
+}
+function useCameraQr({ active, onCode, intervalMs = 250 }) {
+  const videoRef = react.useRef(null);
+  const [status, setStatus] = react.useState("idle");
+  const streamRef = react.useRef(null);
+  const onCodeRef = react.useRef(onCode);
+  onCodeRef.current = onCode;
+  const stop = react.useCallback(() => {
+    for (const track of streamRef.current?.getTracks() ?? []) track.stop();
+    streamRef.current = null;
+    const v = videoRef.current;
+    if (v) v.srcObject = null;
+    setStatus((s) => s === "denied" || s === "unsupported" ? s : "idle");
+  }, []);
+  react.useEffect(() => {
+    if (!active) return;
+    if (!cameraSupported()) {
+      setStatus("unsupported");
+      return;
+    }
+    let cancelled = false;
+    let timer;
+    let busy = false;
+    setStatus("starting");
+    const onHidden = () => {
+      if (document.visibilityState === "hidden") stop();
+    };
+    document.addEventListener("visibilitychange", onHidden);
+    (async () => {
+      let stream;
+      try {
+        stream = await navigator.mediaDevices.getUserMedia({ video: { facingMode: { ideal: "environment" } }, audio: false });
+      } catch {
+        if (!cancelled) setStatus("denied");
+        return;
+      }
+      if (cancelled) {
+        for (const t of stream.getTracks()) t.stop();
+        return;
+      }
+      streamRef.current = stream;
+      const video = videoRef.current;
+      if (!video) {
+        for (const t of stream.getTracks()) t.stop();
+        streamRef.current = null;
+        return;
+      }
+      video.srcObject = stream;
+      video.muted = true;
+      void video.play?.().catch(() => void 0);
+      setStatus("scanning");
+      const eng = await import('@asteby/storefront/fiscal-document');
+      timer = setInterval(async () => {
+        if (busy || cancelled || !videoRef.current || videoRef.current.readyState < 2) return;
+        busy = true;
+        try {
+          const text = await eng.decodeImageQr(videoRef.current);
+          if (text && !cancelled) {
+            cancelled = true;
+            clearInterval(timer);
+            stop();
+            onCodeRef.current(text);
+          }
+        } catch {
+        } finally {
+          busy = false;
+        }
+      }, intervalMs);
+    })();
+    return () => {
+      cancelled = true;
+      if (timer) clearInterval(timer);
+      document.removeEventListener("visibilitychange", onHidden);
+      for (const t of streamRef.current?.getTracks() ?? []) t.stop();
+      streamRef.current = null;
+      if (videoRef.current) videoRef.current.srcObject = null;
+    };
+  }, [active, intervalMs, stop]);
+  return { videoRef, status, stop };
+}
 var isPdf = (f, accept) => {
   const okType = f.type ? accept.some((a) => a === f.type) || f.type === "application/pdf" : false;
   return okType || /\.pdf$/i.test(f.name);
 };
+var isImage = (f) => f.type.startsWith("image/") || /\.(jpe?g|png|webp|heic|heif)$/i.test(f.name);
 var mib = (bytes) => `${Math.round(bytes / (1024 * 1024) * 10) / 10} MB`;
 function IdentityDocumentReader(props) {
   const { region, workerSrc, onConfirm, onManual, initialValues, data, canSave, serverUpload, personTypeOf, now, namePrefix = "invoice", messages, classNames: cx = {}, confirmLabel } = props;
@@ -766,14 +941,29 @@ function IdentityDocumentReader(props) {
   react.useEffect(() => () => abort.current?.abort(), []);
   react.useEffect(() => {
     if (!fromServer) return;
-    setValues((cur) => ({ ...cur, ...fromServer.values }));
+    setValues((cur) => {
+      const next = { ...cur, ...fromServer.values };
+      const suggestion = next.tax_regime && !next.use ? suggestInvoiceUse(region.fiscal_id, next.tax_regime) : null;
+      if (suggestion) {
+        next.use = suggestion;
+        setSuggestedUse(suggestion);
+      }
+      return next;
+    });
     setPhase({ kind: "review", extraction: fromServer, revision: 1 });
   }, [fromServer]);
   react.useEffect(() => {
     if (phase.kind === "error") errorRef.current?.focus();
     if (phase.kind === "review" && phase.revision > 0) reviewRef.current?.focus();
   }, [phase]);
-  const accept = react.useMemo(() => spec?.accept?.length ? spec.accept.join(",") : "application/pdf", [spec]);
+  const accept = react.useMemo(() => {
+    const files = (spec?.accept ?? []).filter((a) => !a.startsWith("image/"));
+    return files.length ? files.join(",") : "application/pdf";
+  }, [spec]);
+  const imageMode = spec?.image_mode && spec.image_mode !== "none" ? spec.image_mode : null;
+  const photoInput = react.useRef(null);
+  const [suggestedUse, setSuggestedUse] = react.useState(null);
+  const cameraActive = phase.kind === "camera";
   const fieldErrors = react.useMemo(() => {
     const out = {};
     for (const [k, v] of Object.entries(data?.fieldErrors ?? {})) out[k] = all.server.errors[v] ?? v;
@@ -790,9 +980,70 @@ function IdentityDocumentReader(props) {
     setPhase({ kind: "review", extraction: null, revision: 1 });
     setLive("");
   }, [onManual]);
+  const showExtraction = react.useCallback(
+    (sum) => {
+      const base = { tax_id: "", legal_name: "", postal_code: "", tax_regime: "", use: "", ...sum.values };
+      const suggestion = base.tax_regime ? suggestInvoiceUse(region.fiscal_id, base.tax_regime) : null;
+      if (suggestion && !base.use) base.use = suggestion;
+      setSuggestedUse(suggestion && base.use === suggestion ? suggestion : null);
+      setValues(base);
+      setSummary(null);
+      setPhase({ kind: "review", extraction: sum, revision: 1 });
+      setLive(m.done);
+    },
+    [region.fiscal_id, m.done]
+  );
+  const readQr = react.useCallback(
+    async (text) => {
+      if (!spec) return;
+      if (!text) return setPhase({ kind: "error", code: "no_qr" });
+      const eng = await import('@asteby/storefront/fiscal-document');
+      const x = eng.extractIdentityDocument("", spec, {
+        catalogs: region.fiscal_id ? eng.catalogsFromRegion(region.fiscal_id) : {},
+        qr: text,
+        ...now ? { now: now() } : {}
+      });
+      if (!x.fields.tax_id) return setPhase({ kind: "error", code: "no_qr" });
+      const evidence = eng.buildDocumentEvidence(x, { sha256: null, source: "qr" });
+      showExtraction(summarizeExtraction(x, evidence, region.fiscal_id?.regimes.map((r) => r.code)));
+    },
+    [spec, region, now, showExtraction]
+  );
+  const readImage = react.useCallback(
+    async (file) => {
+      if (!spec) return;
+      if (file.size > spec.max_bytes) return setPhase({ kind: "error", code: "too_large", sizeLimit: spec.max_bytes });
+      const ctl = new AbortController();
+      abort.current = ctl;
+      setPhase({ kind: "reading", fileName: file.name });
+      setLive(fill(m.reading, { document: documentName }));
+      try {
+        const eng = await import('@asteby/storefront/fiscal-document');
+        const text = await eng.decodeImageQr(file, { maxBytes: spec.max_bytes, signal: ctl.signal });
+        if (ctl.signal.aborted) return;
+        await readQr(text);
+      } catch (err) {
+        if (ctl.signal.aborted) return;
+        const code = err?.code;
+        setLive("");
+        setPhase({ kind: "error", code: code === "too_large" ? "too_large" : code === "not_image" ? "not_image" : "unreadable", sizeLimit: spec.max_bytes });
+      } finally {
+        if (abort.current === ctl) abort.current = null;
+        if (photoInput.current) photoInput.current.value = "";
+      }
+    },
+    [spec, documentName, m.reading, readQr]
+  );
+  const camera = useCameraQr({
+    active: cameraActive,
+    onCode: (text) => {
+      void readQr(text).then(() => setLive(`${m.scan.cameraRead}. ${m.done}`)).catch(() => setPhase({ kind: "error", code: "unreadable" }));
+    }
+  });
   const read = react.useCallback(
     async (file) => {
       if (!spec) return;
+      if (imageMode && isImage(file)) return readImage(file);
       if (!isPdf(file, spec.accept ?? [])) return setPhase({ kind: "error", code: "not_pdf" });
       if (file.size > spec.max_bytes) return setPhase({ kind: "error", code: "too_large", sizeLimit: spec.max_bytes });
       const ctl = new AbortController();
@@ -817,10 +1068,7 @@ function IdentityDocumentReader(props) {
         });
         const evidence = eng.buildDocumentEvidence(x, { sha256, source: "pdf_client" });
         const sum = summarizeExtraction(x, evidence, region.fiscal_id?.regimes.map((r) => r.code));
-        setValues({ tax_id: "", legal_name: "", postal_code: "", tax_regime: "", use: "", ...sum.values });
-        setSummary(null);
-        setPhase({ kind: "review", extraction: sum, revision: 1 });
-        setLive(m.done);
+        showExtraction(sum);
       } catch (err) {
         if (ctl.signal.aborted) return;
         const code = err?.code;
@@ -835,7 +1083,7 @@ function IdentityDocumentReader(props) {
         if (fileInput.current) fileInput.current.value = "";
       }
     },
-    [spec, workerSrc, region, now, documentName, m.reading, m.done]
+    [spec, workerSrc, region, now, documentName, m.reading, imageMode, readImage, showExtraction]
   );
   if (!spec) return null;
   const onDrop = (e) => {
@@ -845,7 +1093,7 @@ function IdentityDocumentReader(props) {
     if (f) void read(f);
   };
   const confirm = () => {
-    const problems = validateFiscalValues(region, values, personTypeOf);
+    const problems = validateFiscalValues(region, values, personTypeResolver(region.fiscal_id, personTypeOf));
     const keys = Object.keys(problems);
     if (keys.length) {
       const labels = {
@@ -910,6 +1158,27 @@ function IdentityDocumentReader(props) {
         ]
       }
     ),
+    imageMode ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cx.actions, "data-sf-reader-scan": true, children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "input",
+        {
+          ref: photoInput,
+          type: "file",
+          accept: "image/*",
+          capture: "environment",
+          hidden: true,
+          tabIndex: -1,
+          "aria-label": m.scan.photo,
+          "data-sf-reader-photo-input": true,
+          onChange: (e) => {
+            const f = e.target.files?.[0];
+            if (f) void readImage(f);
+          }
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: cx.secondary, onClick: () => photoInput.current?.click(), "data-sf-reader-photo": true, children: m.scan.photo }),
+      hydrated && cameraSupported() ? /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: cx.secondary, onClick: () => setPhase({ kind: "camera" }), "data-sf-reader-camera": true, children: m.scan.camera }) : null
+    ] }) : null,
     /* @__PURE__ */ jsxRuntime.jsx("p", { id: helpId, className: cx.privacy, "data-sf-reader-privacy": true, children: privacy }),
     serverUpload ? /* @__PURE__ */ jsxRuntime.jsx("noscript", { children: /* @__PURE__ */ jsxRuntime.jsx("button", { type: "submit", name: "intent", value: "extract-document", formEncType: "multipart/form-data", formMethod: "post", formNoValidate: true, className: cx.secondary, "data-sf-reader-upload": true, children: m.uploadServer }) }) : null,
     /* @__PURE__ */ jsxRuntime.jsxs("p", { "data-sf-reader-links": true, children: [
@@ -926,6 +1195,48 @@ function IdentityDocumentReader(props) {
     ] }),
     /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: cx.secondary, onClick: cancel, "data-sf-reader-cancel": true, children: m.cancel })
   ] });
+  const cameraView = phase.kind === "camera" && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cx.root, "data-sf-reader": true, "data-state": "camera", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("h3", { "data-sf-reader-title": true, children: m.scan.cameraTitle }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { "data-sf-reader-viewfinder": true, children: [
+      /* @__PURE__ */ jsxRuntime.jsx("video", { ref: camera.videoRef, playsInline: true, muted: true, "aria-label": m.scan.cameraGuide, "data-sf-reader-video": true }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { "aria-hidden": "true", "data-sf-reader-frame": true })
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx("p", { className: cx.status, "data-sf-reader-camera-status": camera.status, children: camera.status === "denied" ? m.scan.cameraDenied : camera.status === "unsupported" ? m.scan.cameraUnavailable : camera.status === "starting" ? m.scan.cameraStarting : m.scan.cameraGuide }),
+    /* @__PURE__ */ jsxRuntime.jsx("p", { className: cx.privacy, "data-sf-reader-privacy": true, children: privacy }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cx.actions, "data-sf-reader-actions": true, children: [
+      /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: cx.secondary, onClick: () => photoInput.current?.click(), "data-sf-reader-photo": true, children: m.scan.choosePhoto }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          className: cx.primary,
+          onClick: () => {
+            camera.stop();
+            setPhase({ kind: "idle" });
+          },
+          "data-sf-reader-camera-close": true,
+          children: m.scan.closeCamera
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "input",
+      {
+        ref: photoInput,
+        type: "file",
+        accept: "image/*",
+        capture: "environment",
+        hidden: true,
+        tabIndex: -1,
+        "aria-label": m.scan.choosePhoto,
+        "data-sf-reader-photo-input": true,
+        onChange: (e) => {
+          const f = e.target.files?.[0];
+          if (f) void readImage(f);
+        }
+      }
+    )
+  ] });
   const errored = phase.kind === "error" && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cx.root, "data-sf-reader": true, "data-state": "error", children: [
     /* @__PURE__ */ jsxRuntime.jsx("div", { ref: errorRef, role: "alert", tabIndex: -1, className: cx.error, "data-sf-reader-error": phase.code, children: fill(m.errors[phase.code], { size: mib(phase.sizeLimit ?? spec.max_bytes) }) }),
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cx.actions, "data-sf-reader-actions": true, children: [
@@ -958,6 +1269,7 @@ function IdentityDocumentReader(props) {
         fromDocument: phase.extraction?.from_document ?? [],
         documentName,
         regimeCandidates: phase.extraction && phase.extraction.regime_candidates.length > 1 ? phase.extraction.regime_candidates : void 0,
+        suggestedUse,
         ...personTypeOf ? { personTypeOf } : {},
         locale,
         ...messages ? { messages } : {},
@@ -985,6 +1297,7 @@ function IdentityDocumentReader(props) {
     /* @__PURE__ */ jsxRuntime.jsx("div", { role: "status", "aria-live": "polite", className: cx.status, "data-sf-reader-live": true, style: visuallyHidden, children: live }),
     phase.kind === "idle" ? idle : null,
     reading || null,
+    cameraView || null,
     errored || null,
     review || null
   ] });
@@ -994,7 +1307,8 @@ function Warnings({ x, m, cx }) {
   const items = [];
   if (x.qr_match === false) items.push(m.warnings.qrMismatch);
   if (x.stale === true && x.age_days !== null) items.push(fill(m.warnings.stale, { days: x.age_days }));
-  if (x.regime_candidates.length === 0 && !x.values.tax_regime) items.push(m.warnings.regimeMissing);
+  if (x.evidence.source === "qr") items.push(m.warnings.qrPartial);
+  else if (x.regime_candidates.length === 0 && !x.values.tax_regime) items.push(m.warnings.regimeMissing);
   else if (x.missing.some((k) => k !== "tax_regime" && k !== "document_id" && k !== "issued_on")) items.push(m.warnings.fieldsMissing);
   if (!items.length) return null;
   return /* @__PURE__ */ jsxRuntime.jsx("ul", { className: cx.warning, "data-sf-reader-warnings": true, children: items.map((t) => /* @__PURE__ */ jsxRuntime.jsxs("li", { "data-sf-reader-warning": true, children: [
@@ -1002,6 +1316,101 @@ function Warnings({ x, m, cx }) {
     t
   ] }, t)) });
 }
+function useModalDialog({ open, onClose, initialFocus }) {
+  const ref = react.useRef(null);
+  const opener = react.useRef(null);
+  const onCloseRef = react.useRef(onClose);
+  onCloseRef.current = onClose;
+  react.useEffect(() => {
+    const el = ref.current;
+    if (!el || !open) return;
+    opener.current = typeof document !== "undefined" ? document.activeElement : null;
+    const hasModal = typeof el.showModal === "function";
+    if (!el.open) {
+      if (hasModal) {
+        try {
+          el.showModal();
+        } catch {
+          el.setAttribute("open", "");
+        }
+      } else el.setAttribute("open", "");
+    }
+    const target = initialFocus?.current ?? el.querySelector("[data-sf-autofocus]") ?? el;
+    if (!target.hasAttribute("tabindex") && target === el) el.setAttribute("tabindex", "-1");
+    target.focus({ preventScroll: true });
+    const onCancel = (e) => {
+      e.preventDefault();
+      onCloseRef.current("esc");
+    };
+    const onKey = (e) => {
+      if (e.key === "Escape") {
+        e.preventDefault();
+        onCloseRef.current("esc");
+      }
+    };
+    el.addEventListener("cancel", onCancel);
+    if (!hasModal) el.addEventListener("keydown", onKey);
+    return () => {
+      el.removeEventListener("cancel", onCancel);
+      el.removeEventListener("keydown", onKey);
+      if (el.open) {
+        if (typeof el.close === "function") {
+          try {
+            el.close();
+          } catch {
+            el.removeAttribute("open");
+          }
+        } else el.removeAttribute("open");
+      }
+      const back = opener.current;
+      if (back instanceof HTMLElement && back.isConnected) back.focus({ preventScroll: true });
+    };
+  }, [open]);
+  const onBackdropClick = react.useCallback((e) => {
+    if (e.target === e.currentTarget) onCloseRef.current("backdrop");
+  }, []);
+  return { ref, onBackdropClick };
+}
+function ScanTaxDocument(props) {
+  const { onConfirm, onManual, classNames: cx = {}, messages, confirmLabel, ...reader } = props;
+  const locale = useResolvedLocale(props.locale);
+  const m = fiscalMessages(locale, messages).reader;
+  const spec = props.document ?? props.region.fiscal_id?.documents?.[0];
+  const [open, setOpen] = react.useState(false);
+  const titleId = react.useId();
+  const { ref, onBackdropClick } = useModalDialog({ open, onClose: () => setOpen(false) });
+  const opener = react.useRef(null);
+  if (!spec) return null;
+  const name = props.documentName ?? spec.label.toLowerCase();
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cx.actions, "data-sf-scan": true, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("button", { ref: opener, type: "button", className: cx.trigger ?? cx.primary, onClick: () => setOpen(true), "aria-haspopup": "dialog", "data-sf-scan-open": true, children: fill(m.scan.open, { document: spec.label }) }),
+    /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: cx.manual ?? cx.secondary, onClick: onManual, "data-sf-scan-manual": true, children: m.scan.manual }),
+    open ? /* @__PURE__ */ jsxRuntime.jsx("dialog", { ref, role: "dialog", "aria-modal": "true", "aria-labelledby": titleId, onClick: onBackdropClick, onClose: () => setOpen(false), className: cx.sheet, "data-sf-scan-sheet": true, children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cx.sheetPanel, "data-sf-scan-panel": true, children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cx.sheetHeader, "data-sf-scan-header": true, children: [
+        /* @__PURE__ */ jsxRuntime.jsx("h2", { id: titleId, className: cx.sheetTitle, "data-sf-scan-title": true, children: fill(m.scan.title, { document: name }) }),
+        /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: cx.sheetClose, onClick: () => setOpen(false), "aria-label": m.scan.close, "data-sf-scan-close": true, "data-sf-autofocus": true, children: /* @__PURE__ */ jsxRuntime.jsx("span", { "aria-hidden": "true", children: "\u2715" }) })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        IdentityDocumentReader,
+        {
+          ...reader,
+          locale,
+          ...messages ? { messages } : {},
+          ...confirmLabel ? { confirmLabel } : {},
+          classNames: cx,
+          onConfirm: (result) => {
+            setOpen(false);
+            onConfirm(result);
+          },
+          onManual: () => {
+            setOpen(false);
+            onManual();
+          }
+        }
+      )
+    ] }) }) : null
+  ] });
+}
 var profileValues = (p) => ({
   tax_id: p.tax_id,
   legal_name: p.legal_name,
@@ -1187,8 +1596,7 @@ function labelOf(list, code, locale) {
   const e = list?.find((x) => x.code === code);
   return e ? `${e.code} \xB7 ${entryLabel(e, locale)}` : code;
 }
-function invoiceCardState(invoice, available = true) {
-  if (!available) return "unavailable";
+function orderState(invoice) {
   if (!invoice) return "not_requested";
   const stage = invoice.stage ?? "";
   const blocked = invoice.blocked_reason ?? "";
@@ -1203,11 +1611,18 @@ function invoiceCardState(invoice, available = true) {
   if (invoice.can_request === false && blocked) return "unavailable";
   return "not_requested";
 }
+function invoiceCardState(invoice, available = true, reason) {
+  if (available) return orderState(invoice);
+  if (reason === "off" || reason === "no_region") return "not_enabled";
+  const own = orderState(invoice);
+  if (invoice && (own !== "not_requested" || invoice.can_request === true || invoice.action === "request")) return own;
+  return reason === "unreachable" ? "unreachable" : "unknown";
+}
 function InvoiceStatusCard(props) {
-  const { invoice, available = true, onRequest, requestHref, onCorrect, correctHref, onRefresh, refreshMs = 1e4, refreshForMs = 6e4, contact, messages, classNames: cx = {}, headingLevel = 3 } = props;
+  const { invoice, available = true, availability, testMode, windowDays, onRequest, requestHref, onCorrect, correctHref, onRefresh, refreshMs = 1e4, refreshForMs = 6e4, contact, messages, classNames: cx = {}, headingLevel = 3 } = props;
   const locale = useResolvedLocale(props.locale);
   const m = fiscalMessages(locale, messages).status;
-  const state = invoiceCardState(invoice, available);
+  const state = invoiceCardState(invoice, available, availability);
   const titleId = `sf-invoice-card-${react.useId().replace(/:/g, "")}`;
   const [tired, setTired] = react.useState(false);
   const refresh = react.useRef(onRefresh);
@@ -1240,7 +1655,10 @@ function InvoiceStatusCard(props) {
   switch (state) {
     case "not_requested": {
       title = m.title;
-      body = /* @__PURE__ */ jsxRuntime.jsx("p", { className: cx.body, children: m.requestHelp });
+      body = /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("p", { className: cx.body, children: m.requestHelp }),
+        windowDays && windowDays > 0 ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: cx.meta, "data-sf-invoice-window": true, children: fill(m.windowNote, { days: windowDays }) }) : null
+      ] });
       const can = invoice?.can_request !== false;
       if (can && (onRequest || requestHref)) {
         actions = onRequest ? /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: cx.primary, onClick: onRequest, "data-sf-invoice-request": true, children: m.request }) : /* @__PURE__ */ jsxRuntime.jsx("a", { href: requestHref, className: cx.primary, "data-sf-invoice-request": true, children: m.request });
@@ -1298,6 +1716,18 @@ function InvoiceStatusCard(props) {
       title = m.cancelledTitle;
       body = /* @__PURE__ */ jsxRuntime.jsx("p", { className: cx.body, children: m.cancelledBody });
       break;
+    case "not_enabled":
+    case "unknown":
+    case "unreachable": {
+      title = state === "not_enabled" ? m.notEnabledTitle : m.unknownTitle;
+      body = /* @__PURE__ */ jsxRuntime.jsx("p", { className: cx.body, children: state === "not_enabled" ? m.notEnabledBody : state === "unreachable" ? m.unreachableBody : m.unknownBody });
+      const mail = contact?.url ?? (contact?.email ? `mailto:${contact.email}` : null);
+      actions = /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+        state === "unreachable" && onRefresh ? /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: cx.secondary, onClick: manualRefresh, "data-sf-invoice-refresh": true, children: m.refresh }) : null,
+        mail ? /* @__PURE__ */ jsxRuntime.jsx("a", { href: mail, className: cx.secondary, "data-sf-invoice-contact": true, children: m.contact }) : null
+      ] });
+      break;
+    }
     default:
       title = m.unavailableTitle;
       body = /* @__PURE__ */ jsxRuntime.jsx("p", { className: cx.body, children: m.unavailableBody });
@@ -1309,6 +1739,7 @@ function InvoiceStatusCard(props) {
       title
     ] }),
     /* @__PURE__ */ jsxRuntime.jsx("div", { "aria-live": live || state === "issued" ? "polite" : void 0, "data-sf-invoice-live": true, children: body }),
+    testMode ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: cx.meta, "data-sf-invoice-sandbox": true, children: m.sandbox }) : null,
     actions ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: cx.actions, "data-sf-invoice-actions": true, children: actions }) : null
   ] });
 }
@@ -1321,6 +1752,9 @@ var ICON = {
   needs_review: "\u25D0",
   window_closed: "\u2013",
   unavailable: "\u2013",
+  not_enabled: "\u2013",
+  unknown: "?",
+  unreachable: "?",
   cancelled: "\xD7"
 };
 
@@ -1328,17 +1762,23 @@ exports.FiscalIdentityFields = FiscalIdentityFields;
 exports.IdentityDocumentReader = IdentityDocumentReader;
 exports.InvoiceStatusCard = InvoiceStatusCard;
 exports.InvoiceToggle = InvoiceToggle;
+exports.ScanTaxDocument = ScanTaxDocument;
+exports.cameraSupported = cameraSupported;
 exports.entryLabel = entryLabel;
 exports.fiscalMessages = fiscalMessages;
 exports.invoiceCardState = invoiceCardState;
 exports.maskTaxId = maskTaxId;
 exports.normalizeTaxId = normalizeTaxId;
 exports.personTypeByLength = personTypeByLength;
+exports.personTypeFromPatterns = personTypeFromPatterns;
+exports.personTypeResolver = personTypeResolver;
 exports.postalCodeProblem = postalCodeProblem;
 exports.regimesFor = regimesFor;
+exports.suggestInvoiceUse = suggestInvoiceUse;
 exports.summarizeExtraction = summarizeExtraction;
 exports.taxIdProblem = taxIdProblem;
 exports.toInvoiceRequest = toInvoiceRequest;
+exports.useCameraQr = useCameraQr;
 exports.usesFor = usesFor;
 exports.validateFiscalValues = validateFiscalValues;
 //# sourceMappingURL=fiscal.cjs.map