@neofaceid/web-sdk 1.43.0 → 1.44.0

package/dist/index.d.ts

@@ -645,9 +645,41 @@ export declare interface DetectionResult {
     details?: any;
 }
 
+/** Desfecho da inscrição de aparelho. */
+export declare type DeviceEnrollmentOutcome = {
+    status: 'enrolled';
+    deviceLabel: string | null;
+    enrolledAt?: string;
+} | {
+    status: 'expired';
+} | {
+    status: 'cancelled';
+};
+
 /** Token de inscrição de aparelho, devolvido por {@link requestDeviceEnrollmentToken}. */
 export declare interface DeviceEnrollmentToken {
-    /** JWT RS256 de uso único. Vira o conteúdo do QR. */
+    /**
+     * Identificador curto, no formato `XXXX-XXXX`, de um alfabeto sem os pares
+     * que se confundem (`0/O`, `1/I/L`, `U/V`).
+     *
+     * **É isto que o QR deve carregar**, não o {@link token}. O JWT inteiro vira
+     * uma grade densa que exige tela grande e câmera boa, e deixa o segredo
+     * óptico — exposto em qualquer foto da tela. O handle fotografado vale muito
+     * menos: não carrega `person_id`, `consumer_id` nem assinatura, e morre na
+     * primeira troca. Como é legível, também serve para ditar por telefone ou
+     * digitar à mão quando a câmera falha.
+     */
+    handle: string;
+    /**
+     * Identificador da solicitação. É a chave do canal SSE que avisa quando o
+     * aparelho for inscrito: `/api/v1/devices/enrollment/{jti}/events/`.
+     */
+    jti: string;
+    /**
+     * JWT RS256 de uso único. Continua vindo por compatibilidade, mas **não deve
+     * ir para o QR** — quem resolve o handle é o Push, contra o core, por canal
+     * interno.
+     */
     token: string;
     /** Validade em segundos (o core emite 300). */
     expiresIn: number;
@@ -1603,7 +1635,7 @@ export declare const registerPersonWithoutFace: (personData: {
 /**
  * Data de lançamento da versão atual
  */
-export declare const RELEASE_DATE = "2026-09-15";
+export declare const RELEASE_DATE = "2026-09-16";
 
 declare interface RequestChallengeWithSessionParams {
     applicationToken: string;
@@ -1908,6 +1940,42 @@ export declare function startBiometricRegistration(personData: {
     onCannotGesture?: () => void;
 }): void;
 
+/**
+ * Abre o fluxo de inscrição de aparelho: mostra o código, aguarda o celular
+ * lê-lo e confirma o vínculo.
+ *
+ * Exige uma pessoa autenticada — o core pede o Bearer do DONOR junto do
+ * `X-App-Token`, e por isso a inscrição só existe no autosserviço.
+ *
+ * O QR carrega o **handle curto**, nunca o JWT: um código denso exige tela
+ * grande e câmera boa, e o token inteiro ficaria exposto em qualquer foto da
+ * tela. Quem resolve o handle é a plataforma Push, contra o core, por canal
+ * interno — o navegador não participa dessa troca.
+ *
+ * @example
+ * ```ts
+ * const r = await startDeviceEnrollment({
+ *   userAccessToken: sessao.accessToken,
+ *   applicationToken: TOKEN,
+ * });
+ * if (r.status === 'enrolled') {
+ *   // r.deviceLabel pode ser null enquanto o Push não envia o rótulo
+ * }
+ * ```
+ */
+export declare function startDeviceEnrollment(options: StartDeviceEnrollmentOptions): Promise<DeviceEnrollmentOutcome>;
+
+export declare interface StartDeviceEnrollmentOptions {
+    /**
+     * Access token do DONOR autenticado. A inscrição só existe no autosserviço,
+     * com a pessoa logada — o core exige este Bearer **junto** do `X-App-Token`.
+     */
+    userAccessToken: string;
+    applicationToken: string;
+    /** Nome do integrador (fallback: `init({ appName })`). */
+    appName?: string;
+}
+
 /**
  * Função auxiliar para iniciar a captura de documento
  */
@@ -2040,7 +2108,7 @@ export declare const validateToken: (applicationToken: string) => Promise<boolea
  * MINOR: Incrementado quando adicionamos funcionalidades mantendo compatibilidade
  * PATCH: Incrementado quando corrigimos bugs mantendo compatibilidade
  */
-export declare const VERSION = "1.43.0";
+export declare const VERSION = "1.44.0";
 
 /**
  * Executa `fn(sessionId)`. Se o servidor devolver 410 (sessão consumida/expirada),

package/dist/neoface-id-sdk.es.js

@@ -5678,7 +5678,6 @@ const loginWithEmail = async (email2, password, applicationToken) => {
   }
 };
 const requestDeviceEnrollmentToken = async (userAccessToken, applicationToken) => {
-  var _a2, _b, _c;
   if (!userAccessToken) {
     throw new NeoFaceError(
       "Inscrição de aparelho exige um usuário autenticado (access token ausente).",
@@ -5697,23 +5696,36 @@ const requestDeviceEnrollmentToken = async (userAccessToken, applicationToken) =
       signal: controller.signal
     });
     if (!response.ok) {
-      if (response.status === 401 || response.status === 403) {
+      if (response.status === 401) {
+        throw new NeoFaceError(
+          "Sua sessão expirou. Entre novamente para inscrever o aparelho.",
+          ErrorType.INVALID_TOKEN
+        );
+      }
+      if (response.status === 403) {
         throw new NeoFaceError(
-          "Não foi possível inscrever o aparelho: sessão expirada ou conta sem permissão. Faça login novamente.",
+          "Esta conta não pode inscrever aparelhos. Procure o suporte.",
           ErrorType.INVALID_TOKEN
         );
       }
       throw new NeoFaceError(`API Error ${response.status}`, ErrorType.API_ERROR);
     }
     const data = await response.json();
-    const token = data.token ?? ((_a2 = data.data) == null ? void 0 : _a2.token);
-    if (!token) {
-      throw new NeoFaceError("Resposta sem token de inscrição", ErrorType.API_ERROR);
+    const body = data.data ?? data;
+    const token = body.token;
+    const handle = body.handle;
+    if (!token || !handle) {
+      throw new NeoFaceError(
+        "Resposta de inscrição incompleta (token ou handle ausente)",
+        ErrorType.API_ERROR
+      );
     }
     return {
+      handle,
+      jti: body.jti ?? "",
       token,
-      expiresIn: data.expires_in ?? ((_b = data.data) == null ? void 0 : _b.expires_in) ?? 300,
-      purpose: data.purpose ?? ((_c = data.data) == null ? void 0 : _c.purpose) ?? "device-enrollment"
+      expiresIn: body.expires_in ?? 300,
+      purpose: body.purpose ?? "device-enrollment"
     };
   } catch (error) {
     if (error instanceof NeoFaceError) throw error;
@@ -8886,8 +8898,8 @@ function BiometricRegistrationModal({
     /* @__PURE__ */ jsx("canvas", { ref: canvasRef })
   ] });
 }
-const VERSION = "1.43.0";
-const RELEASE_DATE = "2026-09-15";
+const VERSION = "1.44.0";
+const RELEASE_DATE = "2026-09-16";
 const CONSENT_TRAIL_STORAGE_KEY = "neoface_consent_trail_v1";
 const CONSENT_TRAIL_MAX_LIMIT = 100;
 async function hashString(inputStr) {
@@ -9599,8 +9611,8 @@ function StatusPill({ tone, children, icon, className }) {
     }
   );
 }
-const STYLE_ID$2 = "neofaceid-awaiting-push-styles";
-const CSS$1 = `
+const STYLE_ID$3 = "neofaceid-awaiting-push-styles";
+const CSS$2 = `
 .neofaceid-root .nfid-push {
   display: flex; flex-direction: column; align-items: center; text-align: center; gap: 10px;
   padding: 8px 8px 4px;
@@ -9651,7 +9663,7 @@ const CSS$1 = `
   .neofaceid-root .nfid-push-pulse { animation: none; }
 }
 `;
-function formatRemaining(seconds) {
+function formatRemaining$1(seconds) {
   const safe = Math.max(0, seconds);
   const mm = Math.floor(safe / 60);
   const ss = safe % 60;
@@ -9665,7 +9677,7 @@ function AwaitingPushView({
 }) {
   useEffect(() => {
     injectThemeStyles();
-    injectScopedStyles(STYLE_ID$2, CSS$1);
+    injectScopedStyles(STYLE_ID$3, CSS$2);
   }, []);
   return /* @__PURE__ */ jsxs("div", { className: "nfid-push", role: "status", "aria-live": "polite", children: [
     /* @__PURE__ */ jsx(StatusPill, { tone: "attention", children: "Aguardando confirmação" }),
@@ -9705,7 +9717,7 @@ function AwaitingPushView({
     ] }),
     /* @__PURE__ */ jsxs("p", { className: "nfid-push-countdown", children: [
       "Expira em ",
-      formatRemaining(remainingSeconds)
+      formatRemaining$1(remainingSeconds)
     ] }),
     /* @__PURE__ */ jsx("div", { className: "nfid-push-actions", children: /* @__PURE__ */ jsx(Button, { variant: "ghost", onClick: onCancel, children: "Cancelar" }) }),
     /* @__PURE__ */ jsx("div", { className: "nfid-push-footer", children: /* @__PURE__ */ jsx(BrandFooter, {}) })
@@ -9714,7 +9726,7 @@ function AwaitingPushView({
 function PushExpiredView({ onFallback, onCancel }) {
   useEffect(() => {
     injectThemeStyles();
-    injectScopedStyles(STYLE_ID$2, CSS$1);
+    injectScopedStyles(STYLE_ID$3, CSS$2);
   }, []);
   return /* @__PURE__ */ jsxs("div", { className: "nfid-push", role: "alert", "aria-live": "assertive", children: [
     /* @__PURE__ */ jsxs(
@@ -9751,7 +9763,7 @@ function PushCancelledView({
 }) {
   useEffect(() => {
     injectThemeStyles();
-    injectScopedStyles(STYLE_ID$2, CSS$1);
+    injectScopedStyles(STYLE_ID$3, CSS$2);
   }, []);
   return /* @__PURE__ */ jsxs("div", { className: "nfid-push", role: "alert", "aria-live": "assertive", children: [
     /* @__PURE__ */ jsxs(
@@ -9789,7 +9801,7 @@ function PushCancelledView({
 function PushDeniedView({ appName, onCancel }) {
   useEffect(() => {
     injectThemeStyles();
-    injectScopedStyles(STYLE_ID$2, CSS$1);
+    injectScopedStyles(STYLE_ID$3, CSS$2);
   }, []);
   return /* @__PURE__ */ jsxs("div", { className: "nfid-push", role: "alert", "aria-live": "assertive", children: [
     /* @__PURE__ */ jsxs(
@@ -9820,7 +9832,7 @@ function PushDeniedView({ appName, onCancel }) {
     /* @__PURE__ */ jsx("div", { className: "nfid-push-footer", children: /* @__PURE__ */ jsx(BrandFooter, {}) })
   ] });
 }
-const CONTAINER_ID = "neofaceid-push-approval-container";
+const CONTAINER_ID$1 = "neofaceid-push-approval-container";
 function classifyAuthorizationFrame(frame) {
   var _a2, _b, _c;
   switch (frame.status) {
@@ -9976,7 +9988,7 @@ function PushApprovalModal({
 function awaitPushApproval(options) {
   return new Promise((resolve) => {
     const container = document.createElement("div");
-    container.id = CONTAINER_ID;
+    container.id = CONTAINER_ID$1;
     document.body.appendChild(container);
     const root = createRoot(container);
     const settle = (outcome) => {
@@ -9987,6 +9999,392 @@ function awaitPushApproval(options) {
     root.render(/* @__PURE__ */ jsx(PushApprovalModal, { ...options, onSettle: settle }));
   });
 }
+const STYLE_ID$2 = "neofaceid-device-enrollment-styles";
+const CSS$1 = `
+.neofaceid-root .nfid-enroll {
+  display: flex; flex-direction: column; align-items: center; text-align: center; gap: 10px;
+  padding: 8px 8px 4px;
+}
+.neofaceid-root .nfid-enroll h2 {
+  margin: 6px 0 0; font-size: 20px; font-weight: 700; color: var(--nfid-text); line-height: 1.25;
+  letter-spacing: -0.015em;
+}
+.neofaceid-root .nfid-enroll p {
+  margin: 0; font-size: 14px; color: var(--nfid-text-muted); line-height: 1.5;
+}
+/* O QR é sempre escuro sobre branco, independente do tema: leitor de código
+   falha com contraste invertido, e a moldura clara faz a zona de silêncio. */
+.neofaceid-root .nfid-enroll-qr {
+  background: #FFFFFF; padding: 14px; border-radius: 16px; margin-top: 12px;
+  line-height: 0; box-shadow: 0 0 0 1px var(--nfid-line);
+}
+.neofaceid-root .nfid-enroll-qr svg { display: block; width: 184px; height: 184px; }
+.neofaceid-root .nfid-enroll-handle {
+  display: flex; flex-direction: column; align-items: center; gap: 4px;
+  margin-top: 14px; padding: 12px 24px;
+  background: var(--nfid-surface-muted); border-radius: 12px; width: 100%;
+}
+.neofaceid-root .nfid-enroll-handle-label {
+  font-size: 11px; font-weight: 600; letter-spacing: 0.08em; text-transform: uppercase;
+  color: var(--nfid-text-subtle);
+}
+.neofaceid-root .nfid-enroll-handle-value {
+  font-size: 26px; font-weight: 800; line-height: 1.1; letter-spacing: 0.12em;
+  color: var(--nfid-text); font-variant-numeric: tabular-nums;
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+}
+.neofaceid-root .nfid-enroll-countdown {
+  font-size: 13px; color: var(--nfid-text-muted); font-variant-numeric: tabular-nums;
+  margin-top: 10px;
+}
+.neofaceid-root .nfid-enroll-actions {
+  display: flex; flex-direction: column; gap: 10px; width: 100%; margin-top: 16px;
+}
+.neofaceid-root .nfid-enroll-note {
+  font-size: 12px; line-height: 1.45; color: var(--nfid-text-muted);
+  background: var(--nfid-surface-muted); border-radius: 10px;
+  padding: 10px 14px; margin-top: 12px; text-align: left; width: 100%;
+}
+.neofaceid-root .nfid-enroll-icon { width: 56px; height: 56px; }
+.neofaceid-root .nfid-enroll-footer {
+  display: flex; justify-content: center; margin-top: 16px; padding-top: 12px;
+  border-top: 1px solid var(--nfid-line); width: 100%;
+}
+`;
+function formatRemaining(seconds) {
+  const safe = Math.max(0, seconds);
+  const mm = Math.floor(safe / 60);
+  const ss = safe % 60;
+  return `${mm}:${String(ss).padStart(2, "0")}`;
+}
+function QrCode({ value }) {
+  const [path, setPath] = useState(null);
+  useEffect(() => {
+    let cancelled = false;
+    import("./qrcode-DYfGiWu6.js").then((mod) => {
+      if (cancelled) return;
+      const qrcode = mod.default ?? mod;
+      const qr = qrcode(0, "M");
+      qr.addData(value);
+      qr.make();
+      const count = qr.getModuleCount();
+      const parts = [];
+      for (let r = 0; r < count; r += 1) {
+        for (let c = 0; c < count; c += 1) {
+          if (qr.isDark(r, c)) parts.push(`M${c} ${r}h1v1h-1z`);
+        }
+      }
+      setPath({ d: parts.join(""), count });
+    }).catch(() => {
+      if (!cancelled) setPath(null);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [value]);
+  if (!path) {
+    return /* @__PURE__ */ jsx("svg", { viewBox: "0 0 21 21", "aria-hidden": "true" });
+  }
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      viewBox: `0 0 ${path.count} ${path.count}`,
+      shapeRendering: "crispEdges",
+      role: "img",
+      "aria-label": `Código para inscrição do aparelho: ${value.split("").join(" ")}`,
+      children: /* @__PURE__ */ jsx("path", { d: path.d, fill: "#000000" })
+    }
+  );
+}
+function DeviceEnrollmentView({
+  appName,
+  handle,
+  remainingSeconds,
+  onCancel
+}) {
+  useEffect(() => {
+    injectThemeStyles();
+    injectScopedStyles(STYLE_ID$2, CSS$1);
+  }, []);
+  return /* @__PURE__ */ jsxs("div", { className: "nfid-enroll", role: "status", "aria-live": "polite", children: [
+    /* @__PURE__ */ jsx(StatusPill, { tone: "attention", children: "Aguardando o aparelho" }),
+    /* @__PURE__ */ jsx("h2", { children: "Vincule seu celular" }),
+    /* @__PURE__ */ jsxs("p", { children: [
+      "Abra o NeoFaceID Push no celular e aponte para este código para vinculá-lo à sua conta no",
+      " ",
+      appName,
+      "."
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "nfid-enroll-qr", children: /* @__PURE__ */ jsx(QrCode, { value: handle }) }),
+    /* @__PURE__ */ jsxs("div", { className: "nfid-enroll-handle", children: [
+      /* @__PURE__ */ jsx("span", { className: "nfid-enroll-handle-label", children: "Ou digite este código" }),
+      /* @__PURE__ */ jsx("span", { className: "nfid-enroll-handle-value", children: handle })
+    ] }),
+    /* @__PURE__ */ jsxs("p", { className: "nfid-enroll-countdown", children: [
+      "O código expira em ",
+      formatRemaining(remainingSeconds)
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "nfid-enroll-actions", children: /* @__PURE__ */ jsx(Button, { variant: "ghost", onClick: onCancel, children: "Cancelar" }) }),
+    /* @__PURE__ */ jsx("div", { className: "nfid-enroll-footer", children: /* @__PURE__ */ jsx(BrandFooter, {}) })
+  ] });
+}
+function DeviceEnrolledView({ deviceLabel, onDone }) {
+  useEffect(() => {
+    injectThemeStyles();
+    injectScopedStyles(STYLE_ID$2, CSS$1);
+  }, []);
+  return /* @__PURE__ */ jsxs("div", { className: "nfid-enroll", role: "alert", "aria-live": "assertive", children: [
+    /* @__PURE__ */ jsxs(
+      "svg",
+      {
+        className: "nfid-enroll-icon",
+        viewBox: "0 0 24 24",
+        fill: "none",
+        stroke: "currentColor",
+        strokeWidth: "1.75",
+        strokeLinecap: "round",
+        strokeLinejoin: "round",
+        "aria-hidden": "true",
+        style: { color: "#1E9E6A" },
+        children: [
+          /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "9" }),
+          /* @__PURE__ */ jsx("path", { d: "M8.5 12.5l2.5 2.5 4.5-5" })
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsx("h2", { children: "Aparelho vinculado" }),
+    deviceLabel ? /* @__PURE__ */ jsxs("p", { children: [
+      /* @__PURE__ */ jsx("strong", { children: deviceLabel }),
+      " agora pode confirmar suas operações."
+    ] }) : /* @__PURE__ */ jsx("p", { children: "Um aparelho acabou de ser vinculado à sua conta." }),
+    /* @__PURE__ */ jsx("div", { className: "nfid-enroll-note", children: deviceLabel ? /* @__PURE__ */ jsx(Fragment, { children: "Se este não é o seu aparelho, procure o suporte agora — alguém pode ter vinculado um celular à sua conta." }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("strong", { children: "Não conseguimos identificar qual aparelho foi vinculado." }),
+      " Se não foi você quem acabou de fazer isso, procure o suporte agora — alguém pode ter vinculado um celular à sua conta."
+    ] }) }),
+    /* @__PURE__ */ jsx("div", { className: "nfid-enroll-actions", children: /* @__PURE__ */ jsx(Button, { variant: "primary", onClick: onDone, children: "Entendi" }) }),
+    /* @__PURE__ */ jsx("div", { className: "nfid-enroll-footer", children: /* @__PURE__ */ jsx(BrandFooter, {}) })
+  ] });
+}
+function DeviceEnrollmentExpiredView({
+  onRetry,
+  onCancel
+}) {
+  useEffect(() => {
+    injectThemeStyles();
+    injectScopedStyles(STYLE_ID$2, CSS$1);
+  }, []);
+  return /* @__PURE__ */ jsxs("div", { className: "nfid-enroll", role: "alert", "aria-live": "assertive", children: [
+    /* @__PURE__ */ jsxs(
+      "svg",
+      {
+        className: "nfid-enroll-icon",
+        viewBox: "0 0 24 24",
+        fill: "none",
+        stroke: "currentColor",
+        strokeWidth: "1.75",
+        strokeLinecap: "round",
+        strokeLinejoin: "round",
+        "aria-hidden": "true",
+        style: { color: "var(--nfid-text-muted)" },
+        children: [
+          /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "9" }),
+          /* @__PURE__ */ jsx("path", { d: "M12 7v5l3 2" })
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsx("h2", { children: "O código expirou" }),
+    /* @__PURE__ */ jsx("p", { children: "Códigos de vinculação valem poucos minutos, por segurança. Gere um novo para tentar." }),
+    /* @__PURE__ */ jsxs("div", { className: "nfid-enroll-actions", children: [
+      /* @__PURE__ */ jsx(Button, { variant: "primary", onClick: onRetry, children: "Gerar novo código" }),
+      /* @__PURE__ */ jsx(Button, { variant: "ghost", onClick: onCancel, children: "Agora não" })
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "nfid-enroll-footer", children: /* @__PURE__ */ jsx(BrandFooter, {}) })
+  ] });
+}
+const CONTAINER_ID = "neofaceid-device-enrollment-container";
+function classifyEnrollmentFrame(frame) {
+  var _a2, _b, _c;
+  switch (frame.status) {
+    case "enrolled":
+      return {
+        kind: "resolve",
+        value: {
+          status: "enrolled",
+          // Vem `null` enquanto a PUSH-133 não sai. Propagamos o nulo em vez de
+          // inventar um rótulo: a tela precisa poder dizer que não identificou.
+          deviceLabel: ((_a2 = frame.data) == null ? void 0 : _a2.device_label) ?? null,
+          enrolledAt: (_b = frame.data) == null ? void 0 : _b.enrolled_at
+        }
+      };
+    case "expired":
+      return { kind: "resolve", value: { status: "expired" } };
+    case "error":
+    case "failed":
+      return {
+        kind: "reject",
+        error: new NeoFaceError(
+          frame.message ?? ((_c = frame.data) == null ? void 0 : _c.message) ?? "Falha ao inscrever o aparelho",
+          ErrorType.API_ERROR
+        )
+      };
+    default:
+      return { kind: "pending" };
+  }
+}
+function DeviceEnrollmentModal({
+  userAccessToken,
+  applicationToken,
+  appName,
+  attempt,
+  onSettle,
+  onRetry,
+  onFatal
+}) {
+  const headerAppName = appName ?? getAppName() ?? "sua aplicação";
+  const [phase, setPhase] = useState({ kind: "loading" });
+  const [remaining, setRemaining] = useState(0);
+  useEffect(() => {
+    const controller = new AbortController();
+    let done = false;
+    (async () => {
+      let issued;
+      try {
+        issued = await requestDeviceEnrollmentToken(userAccessToken, applicationToken);
+      } catch (err) {
+        if (!done) onFatal(err);
+        return;
+      }
+      if (done) return;
+      setPhase({
+        kind: "waiting",
+        handle: issued.handle,
+        jti: issued.jti,
+        expiresIn: issued.expiresIn
+      });
+      setRemaining(issued.expiresIn);
+      const base = getBaseUrl();
+      const channel = `${base}/api/v1/devices/enrollment/${encodeURIComponent(issued.jti)}/events/`;
+      try {
+        const outcome = await consumeSseStream({
+          signal: controller.signal,
+          timeoutMs: (issued.expiresIn + 30) * 1e3,
+          requestTicket: async () => {
+            var _a2;
+            const res = await fetch(`${channel}ticket/`, {
+              method: "POST",
+              headers: { "Content-Type": "application/json", "X-App-Token": applicationToken }
+            });
+            if (!res.ok) {
+              throw new NeoFaceError(
+                `Falha ao abrir o canal de inscrição: ${res.status}`,
+                res.status === 401 || res.status === 403 ? ErrorType.INVALID_TOKEN : ErrorType.NETWORK
+              );
+            }
+            const body = await res.json();
+            const ticket = ((_a2 = body == null ? void 0 : body.data) == null ? void 0 : _a2.ticket) ?? (body == null ? void 0 : body.ticket);
+            if (!ticket) {
+              throw new NeoFaceError("Canal de inscrição sem ticket", ErrorType.API_ERROR);
+            }
+            return ticket;
+          },
+          buildUrl: (ticket) => `${channel}?ticket=${encodeURIComponent(ticket)}`,
+          classify: classifyEnrollmentFrame
+        });
+        if (done) return;
+        if (outcome.status === "enrolled") {
+          setPhase({
+            kind: "enrolled",
+            deviceLabel: outcome.deviceLabel,
+            enrolledAt: outcome.enrolledAt
+          });
+          return;
+        }
+        setPhase({ kind: "expired" });
+      } catch {
+        if (done || controller.signal.aborted) return;
+        setPhase({ kind: "expired" });
+      }
+    })();
+    return () => {
+      done = true;
+      controller.abort();
+    };
+  }, [attempt]);
+  useEffect(() => {
+    if (phase.kind !== "waiting") return void 0;
+    const id = setInterval(() => setRemaining((r) => r > 0 ? r - 1 : 0), 1e3);
+    return () => clearInterval(id);
+  }, [phase.kind]);
+  if (phase.kind === "loading") return null;
+  if (phase.kind === "enrolled") {
+    return /* @__PURE__ */ jsx(Sheet, { open: true, dismissOnOverlay: false, ariaLabel: "Aparelho vinculado", children: /* @__PURE__ */ jsx(
+      DeviceEnrolledView,
+      {
+        deviceLabel: phase.deviceLabel,
+        onDone: () => onSettle({
+          status: "enrolled",
+          deviceLabel: phase.deviceLabel,
+          enrolledAt: phase.enrolledAt
+        })
+      }
+    ) });
+  }
+  if (phase.kind === "expired") {
+    return /* @__PURE__ */ jsx(Sheet, { open: true, dismissOnOverlay: false, ariaLabel: "Código expirado", children: /* @__PURE__ */ jsx(
+      DeviceEnrollmentExpiredView,
+      {
+        onRetry,
+        onCancel: () => onSettle({ status: "expired" })
+      }
+    ) });
+  }
+  return /* @__PURE__ */ jsx(Sheet, { open: true, dismissOnOverlay: false, ariaLabel: "Vincular aparelho", children: /* @__PURE__ */ jsx(
+    DeviceEnrollmentView,
+    {
+      appName: headerAppName,
+      handle: phase.handle,
+      remainingSeconds: remaining,
+      onCancel: () => onSettle({ status: "cancelled" })
+    }
+  ) });
+}
+function startDeviceEnrollment(options) {
+  return new Promise((resolve, reject) => {
+    const container = document.createElement("div");
+    container.id = CONTAINER_ID;
+    document.body.appendChild(container);
+    const root = createRoot(container);
+    let attempt = 0;
+    const cleanup = () => {
+      root.unmount();
+      if (document.body.contains(container)) document.body.removeChild(container);
+    };
+    const render = () => {
+      root.render(
+        /* @__PURE__ */ jsx(
+          DeviceEnrollmentModal,
+          {
+            ...options,
+            attempt,
+            onSettle: (outcome) => {
+              cleanup();
+              resolve(outcome);
+            },
+            onRetry: () => {
+              attempt += 1;
+              render();
+            },
+            onFatal: (error) => {
+              cleanup();
+              reject(error);
+            }
+          }
+        )
+      );
+    };
+    render();
+  });
+}
 function evaluateFacePosition(box, videoWidth, videoHeight) {
   if (!box || !videoWidth || !videoHeight) {
     return {
@@ -15503,6 +15901,7 @@ export {
   start,
   startAutoLogin,
   startBiometricRegistration,
+  startDeviceEnrollment,
   startDocumentCapture,
   startFaceLogin,
   startHandLogin,