valtech-components 2.0.833 → 2.0.835

package/lib/components/organisms/change-password-modal/change-password-modal.component.d.ts

@@ -1,17 +1,21 @@
 import { EventEmitter } from '@angular/core';
 import { FormMetadata, FormSubmit } from '../../types';
 import * as i0 from "@angular/core";
+/** Modo del modal, resuelto al abrir según si el user ya tiene contraseña. */
+type PasswordModalMode = 'loading' | 'change' | 'set';
 /**
- * `val-change-password-modal` — modal para que un usuario autenticado cambie
- * su contraseña. Análogo al modal de "recuperar contraseña" del `val-login`,
- * pero para una sesión activa (vista de seguridad / settings).
+ * `val-change-password-modal` — modal de gestión de contraseña para un usuario
+ * autenticado. Análogo al modal de "recuperar contraseña" del `val-login`.
  *
- * Self-contained: inyecta `AuthService` y llama `changePassword()` directo —
- * la app solo controla la visibilidad y reacciona a los eventos.
+ * Es dual-mode: al abrirse consulta `AuthService.checkHasPassword()` y se adapta:
+ *  - **change** — el user ya tiene contraseña → pide actual + nueva →
+ *    `changePassword()`.
+ *  - **set** — el user es OAuth-only (sin contraseña) → pide solo la nueva,
+ *    pide confirmación explícita (no pierde el acceso social, es aditivo) →
+ *    `setPasswordForOAuthUser()`.
  *
- * El gate de apertura lo controla el padre vía `[isOpen]`. El componente emite
- * `changed` al éxito y `dismissed` cuando el user cierra el modal — el padre
- * pone `isOpen` en `false` en ambos casos.
+ * Self-contained: inyecta `AuthService` y llama el endpoint directo — la app
+ * solo controla `[isOpen]` y reacciona a `(changed)` / `(dismissed)`.
  *
  * i18n: usa el namespace compartido `_auth` (mismas claves que `val-login`).
  *
@@ -25,9 +29,14 @@ import * as i0 from "@angular/core";
  * ```
  */
 export declare class ChangePasswordModalComponent {
-    /** Controla la visibilidad del modal. Lo decide el componente padre. */
-    isOpen: boolean;
-    /** Emite al cambiar la contraseña con éxito. El padre debe cerrar el modal. */
+    private _isOpen;
+    /**
+     * Controla la visibilidad del modal. Lo decide el componente padre. Cada vez
+     * que pasa de cerrado a abierto se resuelve el modo (change vs set).
+     */
+    set isOpen(value: boolean);
+    get isOpen(): boolean;
+    /** Emite al cambiar/crear la contraseña con éxito. El padre cierra el modal. */
     changed: EventEmitter<void>;
     /** Emite cuando el user cierra el modal (botón X o backdrop). */
     dismissed: EventEmitter<void>;
@@ -35,17 +44,34 @@ export declare class ChangePasswordModalComponent {
     private toast;
     private i18n;
     private i18nHelper;
+    private confirmDialog;
+    private readonly _mode;
+    /** Modo actual — `loading` mientras se consulta `checkHasPassword()`. */
+    readonly mode: import("@angular/core").Signal<PasswordModalMode>;
     private readonly _formState;
     constructor();
     /** Traduce una clave del namespace `_auth`. */
     t(key: string): string;
     readonly formProps: import("@angular/core").Signal<FormMetadata>;
+    /** Campo "nueva contraseña" — compartido por ambos modos. */
+    private newPasswordField;
     /** Cierre iniciado por el user (X / backdrop). */
     close(): void;
-    submitHandler(event: FormSubmit): void;
+    /** Consulta si el user ya tiene contraseña para elegir el modo del modal. */
+    private resolveMode;
+    submitHandler(event: FormSubmit): Promise<void>;
+    /** Flujo normal: el user tiene contraseña y la cambia. */
+    private handleChangePassword;
+    /**
+     * Flujo OAuth-only: el user no tiene contraseña. Antes de crearla pide
+     * confirmación explícita — es un cambio de cuenta, aunque aditivo (conserva
+     * el acceso social).
+     */
+    private handleSetPassword;
     /** Mapea los códigos de error del backend a mensajes del namespace `_auth`. */
     private resolveError;
     private showToast;
     static ɵfac: i0.ɵɵFactoryDeclaration<ChangePasswordModalComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ChangePasswordModalComponent, "val-change-password-modal", never, { "isOpen": { "alias": "isOpen"; "required": false; }; }, { "changed": "changed"; "dismissed": "dismissed"; }, never, never, true, never>;
 }
+export {};

package/lib/components/organisms/mfa-modal/mfa-modal.component.d.ts

@@ -0,0 +1,114 @@
+import { EventEmitter, OnDestroy } from '@angular/core';
+import { FormControl } from '@angular/forms';
+import { MFAMethod, TOTPSetupResponse } from '../../../services/auth/types';
+import { QrResult } from '../../../services/qr-generator/types';
+import * as i0 from "@angular/core";
+/** Paso del flujo del modal. */
+type MfaStep = 'loading' | 'status' | 'method-select' | 'totp-setup' | 'code-confirm' | 'disable';
+/**
+ * `val-mfa-modal` — modal de gestión de autenticación de dos factores (MFA)
+ * para un usuario autenticado. Mismo patrón que `val-change-password-modal`.
+ *
+ * Flujo (máquina de estados interna):
+ *  - `loading` → `getProfile()` para conocer el estado MFA.
+ *  - `status` → muestra MFA habilitado/deshabilitado. Si está habilitado:
+ *    gestión de backup codes (TOTP) + deshabilitar. Si no: botón habilitar.
+ *  - `method-select` → elegir TOTP / EMAIL / SMS.
+ *  - `totp-setup` → QR + secreto manual + backup codes → verificar código.
+ *  - `code-confirm` → (EMAIL/SMS) ingresar código recibido, con reenvío.
+ *  - `disable` → contraseña para deshabilitar MFA.
+ *
+ * El QR se genera **client-side** (`QrGeneratorService`) — el secreto TOTP
+ * nunca sale del navegador.
+ *
+ * Self-contained: inyecta `AuthService` y llama los endpoints directo. La app
+ * controla `[isOpen]` y reacciona a `(changed)` / `(dismissed)`.
+ *
+ * i18n: namespace compartido `_auth`.
+ *
+ * @example
+ * ```html
+ * <val-mfa-modal
+ *   [isOpen]="isModalOpen()"
+ *   (dismissed)="isModalOpen.set(false)"
+ * />
+ * ```
+ */
+export declare class MfaModalComponent implements OnDestroy {
+    private _isOpen;
+    /** Controla la visibilidad. Cada apertura re-resuelve el estado MFA. */
+    set isOpen(value: boolean);
+    get isOpen(): boolean;
+    /** Emite cuando el estado MFA cambia (habilitado / deshabilitado). */
+    changed: EventEmitter<void>;
+    /** Emite cuando el user cierra el modal (botón X o backdrop). */
+    dismissed: EventEmitter<void>;
+    private auth;
+    private toast;
+    private i18n;
+    private qrGen;
+    private readonly _step;
+    /** Paso actual del flujo. */
+    readonly step: import("@angular/core").Signal<MfaStep>;
+    /** `true` mientras una llamada al backend está en curso. */
+    readonly working: import("@angular/core").WritableSignal<boolean>;
+    readonly mfaEnabled: import("@angular/core").WritableSignal<boolean>;
+    readonly mfaMethod: import("@angular/core").WritableSignal<MFAMethod>;
+    readonly userPhone: import("@angular/core").WritableSignal<string>;
+    readonly backupCodesCount: import("@angular/core").WritableSignal<number>;
+    readonly selectedMethod: import("@angular/core").WritableSignal<MFAMethod>;
+    readonly totpSetup: import("@angular/core").WritableSignal<TOTPSetupResponse>;
+    readonly totpQr: import("@angular/core").WritableSignal<QrResult>;
+    /** Códigos de respaldo recién regenerados — se muestran una sola vez. */
+    readonly regeneratedCodes: import("@angular/core").WritableSignal<string[]>;
+    readonly resendCooldown: import("@angular/core").WritableSignal<number>;
+    readonly pinControl: FormControl<string>;
+    readonly passwordControl: FormControl<string>;
+    readonly phoneControl: FormControl<string>;
+    readonly pinInputProps: {
+        control: FormControl<string>;
+        token: string;
+        length: number;
+        allowNumbersOnly: boolean;
+        autoFocus: boolean;
+    };
+    private resendTimer;
+    constructor();
+    ngOnDestroy(): void;
+    /** Traduce una clave del namespace `_auth`. */
+    t(key: string): string;
+    /** Cierre iniciado por el user (X / backdrop). */
+    close(): void;
+    /** Consulta el perfil para conocer el estado MFA y posicionar el flujo. */
+    private resolveStatus;
+    private loadBackupCount;
+    goToMethodSelect(): void;
+    goToDisable(): void;
+    backToStatus(): void;
+    /** Continúa desde el selector de método al setup correspondiente. */
+    proceedWithMethod(): void;
+    private setupTotp;
+    /** Verifica el código TOTP de la app de autenticación y activa MFA. */
+    verifyTotp(): void;
+    /** Confirma el código EMAIL/SMS y activa MFA. */
+    confirmCode(): void;
+    /** Reenvía el código EMAIL/SMS (re-ejecuta el setup). */
+    resendCode(): void;
+    /** Regenera los códigos de respaldo TOTP y los muestra una vez. */
+    regenerateBackupCodes(): void;
+    /** Deshabilita MFA — requiere la contraseña de la cuenta. */
+    confirmDisable(): void;
+    /** Copia una lista de códigos de respaldo al portapapeles. */
+    copyCodes(codes: string[]): Promise<void>;
+    /** Etiqueta i18n legible para un método MFA. */
+    methodLabel(method: MFAMethod | null): string;
+    private resetFlow;
+    private startCooldown;
+    private stopCooldown;
+    /** Mapea los códigos de error MFA del backend a mensajes del namespace `_auth`. */
+    private resolveError;
+    private showToast;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MfaModalComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MfaModalComponent, "val-mfa-modal", never, { "isOpen": { "alias": "isOpen"; "required": false; }; }, { "changed": "changed"; "dismissed": "dismissed"; }, never, never, true, never>;
+}
+export {};

package/lib/version.d.ts

@@ -2,4 +2,4 @@
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-export declare const VERSION = "2.0.833";
+export declare const VERSION = "2.0.835";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "2.0.833",
+  "version": "2.0.835",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"

package/public-api.d.ts

@@ -191,6 +191,7 @@ export * from './lib/components/organisms/form/form-footer/form-footer.component
 export * from './lib/components/organisms/form/form.component';
 export * from './lib/components/organisms/header/header.component';
 export * from './lib/components/organisms/header/types';
+export * from './lib/components/organisms/mfa-modal/mfa-modal.component';
 export * from './lib/components/organisms/item-list/item-list.component';
 export * from './lib/components/organisms/item-list/types';
 export * from './lib/components/organisms/no-content/no-content.component';