@archbase/security 4.0.38 → 4.0.40

package/dist/src/ArchbaseAuthenticator.d.ts

@@ -5,6 +5,12 @@ export interface ArchbaseAuthenticator {
     refreshToken(refresh_token: string): Promise<ArchbaseAccessToken>;
     sendResetPasswordEmail(email: string): Promise<void>;
     resetPassword(email: string, passwordResetToken: string, newPassword: string): Promise<void>;
+    /**
+     * Completa o login em duas etapas quando o usuário tem MFA/2FA: recebe o token de desafio
+     * (retornado no `login`/`loginWithContext` como `mfa_required`) + o código do segundo fator
+     * (TOTP ou código de recuperação) e devolve os tokens reais.
+     */
+    verifyMfa?(challengeToken: string, code: string): Promise<ArchbaseAccessToken>;
     /** Login contextual com suporte a enrichers específicos da aplicação */
     loginWithContext?(request: ContextualAuthenticationRequest): Promise<ContextualAuthenticationResponse>;
     /** Login flexível com email ou telefone */

package/dist/src/ArchbaseLogin.d.ts

@@ -26,5 +26,15 @@ export interface ArchbaseLoginProps {
     disabledLogin?: boolean;
     isCheckingUsername?: boolean;
     showSignIn?: boolean;
+    /** Login em duas etapas (MFA): quando `true`, exibe o painel de código em vez do formulário. */
+    mfaRequired?: boolean;
+    /** Valida o código do segundo fator (TOTP ou de recuperação). */
+    onVerifyMfa?: (code: string) => Promise<void>;
+    /** Mensagem de erro específica da etapa de MFA. */
+    mfaError?: string;
+    /** Volta do painel de MFA para o formulário de login. */
+    onCancelMfa?: () => void;
+    /** Indica verificação em andamento (desabilita o botão). */
+    isVerifyingMfa?: boolean;
 }
-export declare function ArchbaseLogin({ onLogin, error, onClickForgotPassword, loginLabel, loginPlaceholder, afterInputs, showMockUsersSelector, mockUsers, mockUsersGroupMap, options, onChangeUsername, disabledLogin, isCheckingUsername, showSignIn, }: ArchbaseLoginProps): import("react/jsx-runtime").JSX.Element;
+export declare function ArchbaseLogin({ onLogin, error, onClickForgotPassword, loginLabel, loginPlaceholder, afterInputs, showMockUsersSelector, mockUsers, mockUsersGroupMap, options, onChangeUsername, disabledLogin, isCheckingUsername, showSignIn, mfaRequired, onVerifyMfa, mfaError, onCancelMfa, isVerifyingMfa, }: ArchbaseLoginProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/ArchbaseMfaSetup.d.ts

@@ -0,0 +1,24 @@
+/** Resultado do início da configuração de MFA (espelha o backend MfaSetup). */
+export interface ArchbaseMfaSetupData {
+    secret: string;
+    provisioningUri: string;
+}
+export interface ArchbaseMfaSetupProps {
+    /** Estado atual do MFA do usuário (vindo de GET /mfa/status). */
+    enabled: boolean;
+    /** Inicia a configuração: POST /mfa/setup → segredo + URI do QR. */
+    onSetup: () => Promise<ArchbaseMfaSetupData>;
+    /** Confirma o primeiro código: POST /mfa/enable → códigos de recuperação. */
+    onEnable: (code: string) => Promise<string[]>;
+    /** Desativa o MFA: POST /mfa/disable. */
+    onDisable: () => Promise<void>;
+    /** Notifica o app quando o estado de habilitação muda. */
+    onStatusChange?: (enabled: boolean) => void;
+}
+/**
+ * ArchbaseMfaSetup — configuração genérica do segundo fator (TOTP) do usuário autenticado.
+ * Presentational: recebe callbacks para os endpoints {@code /mfa/setup|enable|disable}. Fluxo:
+ * ativar → ler o QR / segredo no app autenticador → confirmar o código → guardar os códigos
+ * de recuperação. Também permite desativar quando já ativo.
+ */
+export declare function ArchbaseMfaSetup({ enabled, onSetup, onEnable, onDisable, onStatusChange, }: ArchbaseMfaSetupProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/hooks/useArchbaseAuthenticationManager.d.ts

@@ -10,6 +10,9 @@ export interface AuthenticationManagerReturnType {
     error: any;
     clearError: () => void;
     accessToken?: string | null;
+    mfaRequired: boolean;
+    verifyMfa?: (code: string) => Promise<void>;
+    cancelMfa: () => void;
     loginWithContext?: (request: ContextualAuthenticationRequest, rememberMe?: boolean) => Promise<void>;
     loginFlexible?: (request: FlexibleLoginRequest, rememberMe?: boolean) => Promise<void>;
     loginSocial?: (request: SocialLoginRequest) => Promise<void>;

package/dist/src/index.d.ts

@@ -14,6 +14,7 @@ export * from './ArchbaseApiTokenService';
 export * from './ArchbaseAccessTokenService';
 export * from './ArchbaseResourceService';
 export * from './ArchbaseLogin';
+export * from './ArchbaseMfaSetup';
 export * from './ArchbaseResetPassword';
 export * from './SecurityType';
 export * from './SecurityDomain';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archbase/security",
-  "version": "4.0.38",
+  "version": "4.0.40",
   "description": "Security and authentication components for Archbase React",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -37,10 +37,10 @@
     "reflect-metadata": "^0.1.13",
     "rxjs": "^7.8.2",
     "uuid": "^9.0.1",
-    "@archbase/components": "4.0.38",
-    "@archbase/core": "4.0.38",
-    "@archbase/data": "4.0.38",
-    "@archbase/layout": "4.0.38"
+    "@archbase/components": "4.0.40",
+    "@archbase/core": "4.0.40",
+    "@archbase/data": "4.0.40",
+    "@archbase/layout": "4.0.40"
   },
   "devDependencies": {
     "@types/crypto-js": "^4.1.1",