@neofaceid/web-sdk 1.28.2 → 1.30.0

package/dist/index.d.ts

@@ -503,12 +503,6 @@ export declare interface EmailPasswordOptions {
     subtitle?: string;
 }
 
-/**
- * SDK Global Configuration
- *
- * Este módulo gerencia a configuração global do SDK, permitindo
- * inicialização com detecção automática de ambiente ou override manual.
- */
 export declare type Environment = 'development' | 'sandbox' | 'production';
 
 /**
@@ -596,11 +590,17 @@ export declare interface GestureResponse {
     images: string[];
 }
 
+/** Retorna a cor de acento configurada, se houver (antes do validador de contraste). */
+export declare function getAccent(): string | null;
+
 /**
  * Retorna o token de aplicação configurado, se houver.
  */
 export declare function getApplicationToken(): string | null;
 
+/** Retorna o nome do integrador configurado, se houver. */
+export declare function getAppName(): string | null;
+
 /**
  * Retorna a URL base configurada para a API.
  * Se o SDK não foi inicializado, retorna o fallback para sandbox.
@@ -619,6 +619,22 @@ export declare function getConfig(): Readonly<SDKConfig>;
  */
 export declare function getEnvironment(): Environment | 'custom';
 
+/** Retorna o locale configurado (padrão 'pt-BR'). */
+export declare function getLocale(): string;
+
+/** Retorna o raio base configurado (padrão 16). */
+export declare function getRadius(): SDKRadius;
+
+/**
+ * Retorna o modo de tema resolvido para a superfície de UI (light | dark).
+ * Considera 'auto' + `prefers-color-scheme`. Útil para consumidores que
+ * precisam alinhar visualmente algum elemento próprio ao SDK.
+ */
+export declare function getResolvedThemeMode(): ThemeMode;
+
+/** Retorna o modo de tema configurado (padrão 'light'). */
+export declare function getTheme(): SDKTheme;
+
 /**
  * Identifies a person from an image and returns name and age
  * @param image The image blob to process
@@ -1239,7 +1255,7 @@ export declare const registerPersonWithoutFace: (personData: {
 /**
  * Data de lançamento da versão atual
  */
-export declare const RELEASE_DATE = "2026-09-01";
+export declare const RELEASE_DATE = "2026-09-02";
 
 declare interface RequestChallengeWithSessionParams {
     applicationToken: string;
@@ -1286,6 +1302,15 @@ export declare function requestPasswordReset(email: string, applicationToken: st
 
 export declare function resetCaptureSession(): void;
 
+declare interface ResolvedTheme {
+    mode: ThemeMode;
+    tokens: ThemeTokens;
+    radius: 8 | 16 | 24;
+    accent: string;
+    /** True quando o `accent` do integrador foi rejeitado por contraste. */
+    accentFellBack: boolean;
+}
+
 /**
  * Orquestra o fluxo completo:
  * 1. Abre `capture/session`
@@ -1319,6 +1344,12 @@ declare interface SDKConfig {
     applicationToken: string | null;
     environment: Environment | 'custom';
     initialized: boolean;
+    appName: string | null;
+    accent: string | null;
+    radius: SDKRadius;
+    theme: SDKTheme;
+    locale: string;
+    resolvedTheme: ResolvedTheme | null;
 }
 
 /**
@@ -1340,8 +1371,42 @@ export declare interface SDKInitOptions {
      * Obtido através do painel administrativo do NeoFaceID.
      */
     applicationToken?: string;
+    /**
+     * Nome do integrador — mostrado no topo dos modais do SDK ("Banco Exemplo" >
+     * NeoFaceID). Obrigatório na prática: omitir gera `console.warn` e cai para o
+     * fallback "sua aplicação".
+     */
+    appName?: string;
+    /**
+     * Cor de acento do integrador. Pinta APENAS o preenchimento do botão primário.
+     * Nunca o anel de captura, o arco de desafio, os colchetes Focus Frame, os
+     * glifos ou o selo de resultado — o visor precisa ser idêntico em toda parte
+     * para que uma tela falsa não engane.
+     *
+     * Validado em runtime: contraste vs `#FFFFFF` < 4.5 = fallback para `#0059C4`
+     * + `console.warn`. É segurança, não gosto.
+     */
+    accent?: string;
+    /**
+     * Raio base dos containers. Restrito aos três raios do sistema: 8, 16 ou 24.
+     * Padrão 16. Valor fora dos três permitidos = `console.warn` + fallback 16.
+     */
+    radius?: SDKRadius;
+    /**
+     * Modo do tema para a superfície dos modais. Padrão `light`. `auto` respeita
+     * `prefers-color-scheme`. O visor de captura é sempre escuro nos dois modos.
+     */
+    theme?: SDKTheme;
+    /**
+     * Locale da UI. Padrão `pt-BR`.
+     */
+    locale?: string;
 }
 
+export declare type SDKRadius = 8 | 16 | 24;
+
+export declare type SDKTheme = 'light' | 'dark' | 'auto';
+
 /**
  * Session data interface for external integrations
  */
@@ -1476,6 +1541,24 @@ export declare interface SubmitLivenessChallengeParams {
     gestures: GestureResponse[];
 }
 
+declare type ThemeMode = 'light' | 'dark';
+
+/** Tokens semânticos por tema — o que os componentes consomem. */
+declare interface ThemeTokens {
+    ground: string;
+    surface: string;
+    surfaceMuted: string;
+    line: string;
+    text: string;
+    textMuted: string;
+    textSubtle: string;
+    action: string;
+    actionText: string;
+    accent: string;
+    overlay: string;
+    focusRing: string;
+}
+
 /**
  * Result of user existence check
  */
@@ -1512,7 +1595,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.28.2";
+export declare const VERSION = "1.30.0";
 
 /**
  * Executa `fn(sessionId)`. Se o servidor devolver 410 (sessão consumida/expirada),