valtech-components 2.0.1009 → 2.0.1011

package/lib/components/molecules/date-input/date-input.component.d.ts

@@ -30,6 +30,22 @@ export declare class DateInputComponent implements OnInit, OnChanges {
     get cancelText(): string;
     /** Presentación del datetime (default: date). */
     get presentation(): string;
+    /** Locale del datetime — honra el prop del consumer (default es-ES). */
+    get datetimeLocale(): string;
+    /** Primer día de la semana — honra el prop del consumer (default lunes). */
+    get firstDayOfWeek(): number;
+    /**
+     * Opciones de formato para `ion-datetime` (binding, NO string). Honra el prop
+     * del consumer y cae a un default sensato (date medium / time short).
+     */
+    get datetimeFormatOptions(): {
+        date?: {
+            dateStyle?: 'full' | 'long' | 'medium' | 'short';
+        };
+        time?: {
+            timeStyle?: 'full' | 'long' | 'medium' | 'short';
+        };
+    };
     /** Texto del trigger cuando NO hay valor (placeholder explícito o default i18n). */
     get placeholderText(): string;
     /** Id del trigger/datetime — estable; se garantiza no vacío en resolveProps. */

package/lib/components/organisms/about-view/about-view.component.d.ts

@@ -0,0 +1,88 @@
+import { ActionCardMetadata } from '../../molecules/action-card/types';
+import { TitleMetadata } from '../../atoms/title/types';
+import { AboutAction, AboutViewConfig } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-about-view` — vista About full-feature autocontenida (organism).
+ * Promovida desde `showcase` bajo el proceso de ADR-021. Reúne:
+ *  - **HERO** — logo + nombre de marca + tagline + pill de versión (copiable).
+ *  - **Descripción** — título + cuerpo.
+ *  - **Acciones** — action-card de rating built-in (abre `val-content-reaction`
+ *    DIRECTAMENTE vía `ModalService`, sin wrapper local — decisión CTO) + las
+ *    acciones genéricas que el consumer aporte por `config.actions`.
+ *  - **Redes** — links sociales (`config.socialLinks`); sección oculta si vacía.
+ *  - **Footer** — copyright con el año actual.
+ *
+ * Lo app-specific (logo, nombre, versión, redes, acciones share/faq) viaja como
+ * DATA de config — NO como slots (ADR-021). La versión la pasa el consumer
+ * (`config.version` = su `APP_VERSION`); la lib NO importa el `version.ts` de la
+ * app. Si no se pasa versión, el pill se oculta.
+ *
+ * NO renderiza ion-content — vive dentro de val-page-wrapper. `ActivatedRoute`
+ * se inyecta `{ optional: true }` solo para leer el route data de config.
+ *
+ * Auto-registra sus defaults i18n (es/en) en el constructor si el consumer no
+ * proveyó el namespace configurado (default `Settings.About`).
+ *
+ * GOTCHA i18n ContentReaction: `val-content-reaction` exige su namespace
+ * `ContentReaction` registrado donde se use (key faltante en binding + CD =
+ * navegador congelado en dev). `ContentReactionComponent` se auto-registra ese
+ * namespace en SU constructor, y como se abre vía `ModalService` ese constructor
+ * corre antes de que su template binde — queda cubierto. Igual lo importamos
+ * como dependencia explícita de esta vista para que la garantía sea local.
+ */
+export declare class AboutViewComponent {
+    private nav;
+    private i18n;
+    private modalService;
+    private toast;
+    private route;
+    /**
+     * Config vía @Input (object-first). Si no se pasa, se cae al route data
+     * `aboutConfig` (poblado por `provideValtechAboutRoutes`). `resolvedConfig`
+     * mergea con los defaults — `@Input` gana sobre route data.
+     */
+    config?: AboutViewConfig;
+    readonly resolvedConfig: import("@angular/core").Signal<Required<Omit<AboutViewConfig, "onRated">> & Pick<AboutViewConfig, "onRated">>;
+    /** Namespace i18n resuelto (capturado para llamadas no-reactivas). */
+    private get ns();
+    readonly brandName: import("@angular/core").Signal<string>;
+    readonly logoSrc: import("@angular/core").Signal<string>;
+    readonly version: import("@angular/core").Signal<string>;
+    readonly socialLinks: import("@angular/core").Signal<{
+        icon: string;
+        url: string;
+        label: string;
+    }[]>;
+    readonly showRating: import("@angular/core").Signal<boolean>;
+    readonly actions: import("@angular/core").Signal<AboutAction[]>;
+    /** Copyright del footer — año actual interpolado en `copyrightText`. */
+    readonly copyright: import("@angular/core").Signal<string>;
+    /** Title metadata para secciones — bold + size small. */
+    readonly rateActionCard: import("@angular/core").Signal<ActionCardMetadata>;
+    constructor();
+    /** Helper i18n bound al namespace resuelto. Reactivo vía `lang()`. */
+    protected tt(key: string): string;
+    /** Title metadata para secciones — bold + size small. */
+    protected sectionTitle(key: string): TitleMetadata;
+    /** ActionCardMetadata para una acción genérica del consumer. */
+    protected extraActionCard(action: AboutAction): ActionCardMetadata;
+    /** Copia la versión al portapapeles + toast (color dark). */
+    copyVersion(): Promise<void>;
+    /** Abre una URL externa en nueva tab. `mailto:` queda en la misma tab. */
+    openUrl(url: string): void;
+    /**
+     * "Calificar la app" — abre `val-content-reaction` DIRECTAMENTE como sheet
+     * modal (sin wrapper local — decisión CTO). El componente persiste la reacción
+     * contra el backend de feedback y muestra su propio estado de "gracias"; el
+     * sheet se cierra arrastrando (breakpoint 0). El namespace i18n
+     * `ContentReaction` lo auto-registra `ContentReactionComponent` en su
+     * constructor, que corre al crear el modal — sin riesgo de key faltante.
+     *
+     * Sheet (bottom sheet): el contenido scrollea dentro y el botón "Enviar" queda
+     * siempre alcanzable, también en viewports chicos.
+     */
+    openRating(): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AboutViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AboutViewComponent, "val-about-view", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/organisms/about-view/about-view.i18n.d.ts

@@ -0,0 +1,14 @@
+import { LanguagesContent } from '../../../services/i18n/types';
+/**
+ * Defaults i18n (es/en) embebidos en `val-about-view`. Auto-registrados en el
+ * constructor del componente si el consumer no proveyó el namespace
+ * (`Settings.About` por default). SOLO incluye las keys que la vista usa.
+ *
+ * Textos portados EXACTOS del override `Settings.About` de showcase
+ * (`frontend/showcase/src/i18n/index.ts`). Las keys de las acciones
+ * showcase-specific (`feedback*`, `share*`, `faq*`, `donate*`) NO se incluyen:
+ * esas acciones se modelan ahora como `actions[]` de la config (el consumer
+ * aporta sus propios textos). `copyrightText` se incluye aquí (antes salía del
+ * namespace `Layout`) para que la vista sea autocontenida.
+ */
+export declare const ABOUT_VIEW_I18N: LanguagesContent;

package/lib/components/organisms/about-view/about.routes.d.ts

@@ -0,0 +1,31 @@
+import { Routes } from '@angular/router';
+import { AboutViewConfig } from './types';
+/**
+ * Helper para montar la vista About (`val-about-view`) como ruta en una app del
+ * factory. El `config` se pasa por route `data` (`aboutConfig`) y el componente
+ * lo lee como fallback de su `@Input() config` (el `@Input` gana).
+ *
+ * @example
+ * ```ts
+ * // settings.routes.ts
+ * import { APP_VERSION } from '../version';
+ *
+ * export const settingsRoutes: Routes = [
+ *   ...provideValtechAboutRoutes({ config: { version: APP_VERSION } }), // → /app/about
+ *   { path: 'preferences', loadComponent: () => ... },
+ * ];
+ *
+ * // con redes y acciones extra:
+ * ...provideValtechAboutRoutes({
+ *   config: {
+ *     version: APP_VERSION,
+ *     socialLinks: VALTECH_SOCIAL_LINKS.map(s => ({ icon: s.icon, url: s.url, label: s.name })),
+ *     actions: [{ label: 'Compartir', icon: 'share-social-outline', onClick: () => share() }],
+ *   },
+ * }),
+ * ```
+ */
+export declare function provideValtechAboutRoutes(opts?: {
+    path?: string;
+    config?: AboutViewConfig;
+}): Routes;

package/lib/components/organisms/about-view/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Configuración acotada de `val-about-view` (object-first). La vista About es
+ * app-specific por naturaleza (logo, nombre, versión, redes, acciones extra),
+ * así que lo propio de cada app se parametriza como **DATA de config** — NO como
+ * slots arbitrarios (ADR-021: una vista full-feature no abre slots; si falta
+ * algo, se promueve un nuevo punto de extensión).
+ *
+ * Ejes de variación permitidos:
+ *  - **branding** — `brand.name` / `brand.logoSrc` (qué muestra el HERO).
+ *  - **versión** — `version` la pasa el consumer (la lib NO puede importar el
+ *    `version.ts` de la app). Si no se pasa, se oculta el pill de versión.
+ *  - **redes** — `socialLinks`; si está vacío se oculta la sección social.
+ *  - **rating** — `showRating` + `ratingEntityId` + `onRated`.
+ *  - **acciones extra** — `actions[]` genéricas que el consumer agrega junto a
+ *    la acción de rating built-in.
+ *  - **branding i18n** — `i18nNamespace` (default `'Settings.About'`).
+ */
+/** Marca a mostrar en el HERO (logo + nombre). */
+export interface AboutBrand {
+    /** Nombre de la marca. Default `'Valtech'`. */
+    name?: string;
+    /** Ruta del logo. Default `'assets/images/main-icon.png'`. */
+    logoSrc?: string;
+}
+/**
+ * Acción genérica extra de la sección "Acciones" (además del rating built-in).
+ * El consumer la modela completa (label/descripción/ícono + handler). Las
+ * acciones share/faq de showcase NO son genéricas (Web Share API y ruta interna
+ * de la app), por eso se exponen como `actions` para que cada app aporte las
+ * suyas en vez de hardcodearlas en la lib.
+ */
+export interface AboutAction {
+    /** Texto principal de la action-card. */
+    label: string;
+    /** Texto secundario (opcional). */
+    description?: string;
+    /** Ionicon name (ej. `'share-social-outline'`). */
+    icon?: string;
+    /** Handler del click. */
+    onClick: () => void;
+}
+export interface AboutViewConfig {
+    /** Marca del HERO (logo + nombre). Default Valtech. */
+    brand?: AboutBrand;
+    /**
+     * Versión a mostrar en el pill (el consumer pasa su `APP_VERSION`). La lib NO
+     * importa el `version.ts` de la app. Si no se pasa, el pill de versión se
+     * oculta.
+     */
+    version?: string;
+    /**
+     * Redes sociales. Si está vacío (o no se pasa), la sección social se oculta.
+     * `icon` = ionicon name; `url` = destino; `label` = aria-label.
+     */
+    socialLinks?: {
+        icon: string;
+        url: string;
+        label: string;
+    }[];
+    /** Muestra la action-card de rating built-in. Default `true`. */
+    showRating?: boolean;
+    /**
+     * `entityId` del `entityRef` que recibe `val-content-reaction` al calificar
+     * (el `entityType` es siempre `'app'`). Default `'experience'`.
+     */
+    ratingEntityId?: string;
+    /** Acciones genéricas extra de la sección "Acciones". Default `[]`. */
+    actions?: AboutAction[];
+    /**
+     * Namespace i18n con el que la vista resuelve sus textos.
+     * Default `'Settings.About'`.
+     */
+    i18nNamespace?: string;
+    /** Hook tras enviar la calificación (rating) desde `val-content-reaction`. */
+    onRated?: () => void;
+}

package/lib/components/organisms/api-keys-modal/api-keys-modal.component.d.ts

@@ -0,0 +1,44 @@
+import { OnInit } from '@angular/core';
+import { ClientApiKey, ClientApiKeyWithSecret } from '../../../services/apikeys/types';
+import * as i0 from "@angular/core";
+/**
+ * `val-api-keys-modal` — gestión de Client API Keys org-scopeadas (ADR-023 fase 6).
+ *
+ * Lista las keys de la org, permite crear (mostrando el secreto UNA vez con copia)
+ * y revocar. Pensado para habilitar integraciones M2M del import de miembros, pero
+ * sirve a cualquier permiso del catálogo. Header canónico (Regla #5).
+ */
+export declare class ApiKeysModalComponent implements OnInit {
+    private i18n;
+    private apiKeys;
+    /** Inyectado por `ModalService.open`. */
+    _modalRef?: {
+        dismiss: (data?: unknown, role?: string) => void;
+    };
+    /** Namespace i18n. */
+    i18nNamespace: string;
+    readonly keys: import("@angular/core").WritableSignal<ClientApiKey[]>;
+    readonly availablePermissions: import("@angular/core").WritableSignal<string[]>;
+    readonly loading: import("@angular/core").WritableSignal<boolean>;
+    readonly showCreate: import("@angular/core").WritableSignal<boolean>;
+    readonly submitting: import("@angular/core").WritableSignal<boolean>;
+    readonly errorMsg: import("@angular/core").WritableSignal<string>;
+    readonly secret: import("@angular/core").WritableSignal<ClientApiKeyWithSecret>;
+    readonly copied: import("@angular/core").WritableSignal<boolean>;
+    name: string;
+    expiresInDays: number | null;
+    readonly selectedPerms: import("@angular/core").WritableSignal<Set<string>>;
+    constructor();
+    ngOnInit(): void;
+    private refresh;
+    openCreate(): void;
+    togglePerm(perm: string, ev: Event): void;
+    submit(): void;
+    revoke(key: ClientApiKey): void;
+    copy(secret: string): Promise<void>;
+    finishSecret(): void;
+    dismiss(): void;
+    t(key: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ApiKeysModalComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ApiKeysModalComponent, "val-api-keys-modal", never, { "_modalRef": { "alias": "_modalRef"; "required": false; }; "i18nNamespace": { "alias": "i18nNamespace"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/organisms/api-keys-modal/api-keys-modal.i18n.d.ts

@@ -0,0 +1,6 @@
+import { LanguagesContent } from '../../../services/i18n/types';
+/**
+ * Defaults i18n (es/en) embebidos en `val-api-keys-modal` (ADR-023).
+ * Auto-registrados si el consumer no proveyó el namespace `Settings.ApiKeysModal`.
+ */
+export declare const API_KEYS_MODAL_I18N: LanguagesContent;

package/lib/components/organisms/member-import-modal/member-import-modal.component.d.ts

@@ -0,0 +1,47 @@
+import { OnInit } from '@angular/core';
+import { ImportMembersResponse, ImportOnConflict, ImportRowResult } from '../../../services/org/types';
+import * as i0 from "@angular/core";
+/**
+ * `val-member-import-modal` — panel de carga masiva de miembros (ADR-023 fase 6).
+ *
+ * El admin pega un CSV (`email,nombre,rol`); el modal lo parsea a filas y llama
+ * `OrgService.importMembers`. Muestra el resultado por-fila (partial success):
+ * `created` / `assigned` / `skipped` / `error`. Header canónico (Regla #5).
+ *
+ * Auto-registra defaults i18n (es/en) en `Settings.ImportModal`.
+ */
+export declare class MemberImportModalComponent implements OnInit {
+    private i18n;
+    private orgService;
+    /** Org destino del import. */
+    orgId: string;
+    /** Nombres de roles disponibles (para el hint). Opcional. */
+    availableRoles: string[];
+    /** Callback tras una importación exitosa (≥1 fila procesada) — refresca la lista. */
+    onSuccess?: () => void;
+    /** Inyectado por `ModalService.open`. */
+    _modalRef?: {
+        dismiss: (data?: unknown, role?: string) => void;
+    };
+    /** Namespace i18n. */
+    i18nNamespace: string;
+    csv: string;
+    onConflict: ImportOnConflict;
+    sendActivation: boolean;
+    readonly submitting: import("@angular/core").WritableSignal<boolean>;
+    readonly errorMsg: import("@angular/core").WritableSignal<string>;
+    readonly results: import("@angular/core").WritableSignal<ImportMembersResponse>;
+    readonly rolesHint: import("@angular/core").Signal<string>;
+    readonly summaryLabel: import("@angular/core").Signal<string>;
+    constructor();
+    ngOnInit(): void;
+    /** Parsea el CSV pegado a filas {email,name,roleName}. Tolera header. */
+    private parseCsv;
+    submit(): void;
+    statusLabel(r: ImportRowResult): string;
+    reset(): void;
+    dismiss(): void;
+    t(key: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MemberImportModalComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MemberImportModalComponent, "val-member-import-modal", never, { "orgId": { "alias": "orgId"; "required": false; }; "availableRoles": { "alias": "availableRoles"; "required": false; }; "onSuccess": { "alias": "onSuccess"; "required": false; }; "_modalRef": { "alias": "_modalRef"; "required": false; }; "i18nNamespace": { "alias": "i18nNamespace"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/organisms/member-import-modal/member-import-modal.i18n.d.ts

@@ -0,0 +1,6 @@
+import { LanguagesContent } from '../../../services/i18n/types';
+/**
+ * Defaults i18n (es/en) embebidos en `val-member-import-modal` (ADR-023).
+ * Auto-registrados si el consumer no proveyó el namespace `Settings.ImportModal`.
+ */
+export declare const MEMBER_IMPORT_MODAL_I18N: LanguagesContent;

package/lib/components/organisms/organization-view/organization-view.component.d.ts

@@ -61,6 +61,7 @@ export declare class OrganizationViewComponent {
     readonly members: import("@angular/core").WritableSignal<MemberDetail[]>;
     readonly membersLoading: import("@angular/core").WritableSignal<boolean>;
     private readonly membersLoadError;
+    readonly membersErrorState: import("@angular/core").Signal<EmptyStateMetadata>;
     readonly membersNextToken: import("@angular/core").WritableSignal<string>;
     readonly loadingMoreMembers: import("@angular/core").WritableSignal<boolean>;
     readonly showAllMembers: import("@angular/core").WritableSignal<boolean>;
@@ -81,12 +82,17 @@ export declare class OrganizationViewComponent {
     readonly viewPermissionsButtonProps: import("@angular/core").Signal<Partial<ButtonMetadata>>;
     readonly transferButtonProps: import("@angular/core").Signal<Partial<ButtonMetadata>>;
     readonly openInviteButtonProps: import("@angular/core").Signal<Partial<ButtonMetadata>>;
+    readonly openImportButtonProps: import("@angular/core").Signal<Partial<ButtonMetadata>>;
+    readonly openApiKeysButtonProps: import("@angular/core").Signal<Partial<ButtonMetadata>>;
     /** Guarda para detectar el primer disparo del effect (evita doble carga). */
     private lastLoadedOrgId;
     constructor();
     onEdit(): void;
     onLeave(): Promise<void>;
     onOpenInvite(): void;
+    onOpenImport(): void;
+    onOpenApiKeys(): void;
+    onOrgInfo(): void;
     onViewPermissions(): void;
     onOpenTransfer(): void;
     onTransfer(newOwnerId: string): Promise<void>;

package/lib/services/apikeys/api-keys.service.d.ts

@@ -0,0 +1,25 @@
+import { HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { ValtechAuthConfig } from '../auth/types';
+import { ClientApiKey, CreateApiKeyRequest, CreateApiKeyResponse, RevokeApiKeyResponse } from './types';
+import * as i0 from "@angular/core";
+/**
+ * Cliente HTTP de Client API Keys org-scopeadas (ADR-023). La org activa se
+ * resuelve en backend desde el JWT, así que el path no la incluye.
+ */
+export declare class ApiKeyService {
+    private config;
+    private http;
+    constructor(config: ValtechAuthConfig, http: HttpClient);
+    private get baseUrl();
+    /** Lista las API keys de la org activa. */
+    list(): Observable<ClientApiKey[]>;
+    /** Crea una API key. La respuesta incluye el secreto (se muestra UNA vez). */
+    create(req: CreateApiKeyRequest): Observable<CreateApiKeyResponse>;
+    /** Revoca (elimina) una API key por id. */
+    revoke(keyId: string): Observable<RevokeApiKeyResponse>;
+    /** Catálogo de permisos asignables a una key. */
+    availablePermissions(): Observable<string[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ApiKeyService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ApiKeyService>;
+}

package/lib/services/apikeys/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Tipos de Client API Keys org-scopeadas (ADR-023). Contrato espejo de
+ * `lambdas/org` `/org/api-keys/*`. El orgID se resuelve del JWT (ActiveOrgID),
+ * no va en el path.
+ */
+export interface ClientApiKey {
+    keyId: string;
+    name: string;
+    organizationId: string;
+    status: string;
+    permissions: string[];
+    rateLimit?: number;
+    expiresAt?: string;
+    allowedIps?: string[];
+    createdBy: string;
+    createdAt: string;
+    lastUsedAt?: string;
+}
+/** Solo en la respuesta de creación: el secreto se muestra UNA vez. */
+export interface ClientApiKeyWithSecret extends ClientApiKey {
+    secret: string;
+}
+export interface CreateApiKeyRequest {
+    name: string;
+    permissions: string[];
+    rateLimit?: number;
+    expiresInDays?: number;
+    allowedIps?: string[];
+}
+export interface CreateApiKeyResponse {
+    operationId: string;
+    key: ClientApiKeyWithSecret;
+}
+export interface ListApiKeysResponse {
+    operationId: string;
+    keys: ClientApiKey[];
+    nextToken?: string;
+}
+export interface AvailablePermissionsResponse {
+    operationId: string;
+    permissions: string[];
+}
+export interface RevokeApiKeyResponse {
+    operationId: string;
+    message: string;
+}

package/lib/services/auth/auth.service.d.ts

@@ -6,7 +6,7 @@ import { AuthStateService } from './auth-state.service';
 import { TokenService } from './token.service';
 import { AuthStorageService } from './storage.service';
 import { AuthSyncService } from './sync.service';
-import { SigninRequest, SigninResponse, SignupRequest, SignupResponse, VerifyEmailRequest, VerifyEmailResponse, ResendCodeRequest, ResendCodeResponse, MFAVerifyResponse, RefreshResponse, GetPermissionsResponse, GetProfileResponse, UpdateProfileRequest, UpdateProfileResponse, MFASetupResponse, MFAConfirmResponse, MFADisableRequest, MFADisableResponse, ForgotPasswordRequest, ForgotPasswordResponse, ResetPasswordRequest, ResetPasswordResponse, ChangePasswordResponse, DeleteAccountResponse, SendDeleteAccountCodeResponse, SwitchOrgResponse, MFAMethod, AuthError, ValtechAuthConfig, EnableNotificationsResult, NotificationPermissionState, RegisterDeviceResult, TOTPSetupResponse, TOTPVerifySetupResponse, TOTPDisableResponse, RegenerateBackupCodesResponse, BackupCodesCountResponse, OAuthProvider, LinkedProvider, HasPasswordResponse, UpdateHandleResponse, CheckHandleResponse, UpdateAvatarRequest, UpdateAvatarResponse, InitiateEmailChangeResponse, ConfirmEmailChangeStep1Response, ConfirmEmailChangeStep2Response } from './types';
+import { SigninRequest, SigninResponse, SignupRequest, SignupResponse, VerifyEmailRequest, VerifyEmailResponse, ResendCodeRequest, ResendCodeResponse, MFAVerifyResponse, RefreshResponse, GetPermissionsResponse, GetProfileResponse, UpdateProfileRequest, UpdateProfileResponse, MFASetupResponse, MFAConfirmResponse, MFADisableRequest, MFADisableResponse, ForgotPasswordRequest, ForgotPasswordResponse, ResetPasswordRequest, ResetPasswordResponse, ActivateAccountRequest, ActivateAccountResponse, ChangePasswordResponse, DeleteAccountResponse, SendDeleteAccountCodeResponse, SwitchOrgResponse, MFAMethod, AuthError, ValtechAuthConfig, EnableNotificationsResult, NotificationPermissionState, RegisterDeviceResult, TOTPSetupResponse, TOTPVerifySetupResponse, TOTPDisableResponse, RegenerateBackupCodesResponse, BackupCodesCountResponse, OAuthProvider, LinkedProvider, HasPasswordResponse, UpdateHandleResponse, CheckHandleResponse, UpdateAvatarRequest, UpdateAvatarResponse, InitiateEmailChangeResponse, ConfirmEmailChangeStep1Response, ConfirmEmailChangeStep2Response } from './types';
 import { OAuthService } from './oauth.service';
 import { FirebaseService, MessagingService } from '../firebase';
 import { I18nService } from '../i18n';
@@ -288,6 +288,12 @@ export declare class AuthService implements OnDestroy {
      * Resetea la contraseña usando el código enviado por email.
      */
     resetPassword(request: ResetPasswordRequest): Observable<ResetPasswordResponse>;
+    /**
+     * Activa una cuenta pre-aprovisionada por una organización (ADR-023): define
+     * la contraseña con el token del enlace de email. En éxito el backend devuelve
+     * tokens de auto-signin → el usuario queda logueado (mismo flujo que verify-email).
+     */
+    activateAccount(request: ActivateAccountRequest): Observable<ActivateAccountResponse>;
     /**
      * Cambia la contraseña del usuario autenticado.
      * Requiere la contraseña actual para verificación.

package/lib/services/auth/types.d.ts

@@ -238,6 +238,29 @@ export interface VerifyEmailResponse {
     expiresIn?: number;
     tokenType?: string;
 }
+/**
+ * Request para activar una cuenta pre-aprovisionada por una organización
+ * (ADR-023): el usuario define su contraseña con el token del enlace de email.
+ */
+export interface ActivateAccountRequest {
+    token: string;
+    newPassword: string;
+}
+/**
+ * Response de activación de cuenta. En éxito incluye tokens de auto-signin
+ * (mismo shape que verify-email) — el usuario queda logueado tras activar.
+ */
+export interface ActivateAccountResponse {
+    operationId: string;
+    activated: boolean;
+    accessToken?: string;
+    refreshToken?: string;
+    firebaseToken?: string;
+    expiresIn?: number;
+    tokenType?: string;
+    roles?: string[];
+    permissions?: string[];
+}
 /**
  * Request para reenviar código de verificación.
  */

package/lib/services/org/org.service.d.ts

@@ -1,7 +1,7 @@
 import { HttpClient } from '@angular/common/http';
 import { Observable } from 'rxjs';
 import { ValtechAuthConfig } from '../auth/types';
-import { Organization, ListMyOrgsResponse, CreateOrgRequest, UpdateOrgRequest, InviteUserRequest, InviteUserResponse, LeaveOrgResponse, ListOrgMembersResponse, OrgRole, ChangeMemberRoleResponse, PendingInvitation, AcceptInvitationResponse } from './types';
+import { Organization, ListMyOrgsResponse, CreateOrgRequest, UpdateOrgRequest, InviteUserRequest, InviteUserResponse, LeaveOrgResponse, ListOrgMembersResponse, OrgRole, ChangeMemberRoleResponse, PendingInvitation, AcceptInvitationResponse, ImportMembersRequest, ImportMembersResponse } from './types';
 import * as i0 from "@angular/core";
 export declare class OrgService {
     private config;
@@ -21,6 +21,11 @@ export declare class OrgService {
         message: string;
     }>;
     inviteUser(orgId: string, req: InviteUserRequest): Observable<InviteUserResponse>;
+    /**
+     * Crea/asigna miembros en masa (ADR-023). Resultado por-fila (partial success):
+     * `created` (pre-aprovisionado), `assigned` (ya existía), `skipped`, `error`.
+     */
+    importMembers(orgId: string, req: ImportMembersRequest): Observable<ImportMembersResponse>;
     leaveOrg(orgId: string): Observable<LeaveOrgResponse>;
     getOrgMembers(orgId: string, params?: {
         limit?: number;

package/lib/services/org/types.d.ts

@@ -97,3 +97,33 @@ export interface ChangeMemberRoleResponse {
     orgId: string;
     roleId: string;
 }
+export type ImportOnConflict = 'assignRole' | 'skip' | 'error';
+export interface ImportUserRow {
+    email: string;
+    name?: string;
+    roleName: string;
+}
+export interface ImportMembersRequest {
+    users: ImportUserRow[];
+    onConflict?: ImportOnConflict;
+    sendActivation?: boolean;
+}
+export type ImportRowStatus = 'created' | 'assigned' | 'skipped' | 'error';
+export interface ImportRowResult {
+    email: string;
+    status: ImportRowStatus;
+    userId?: string;
+    activation?: 'sent' | 'pending';
+    reason?: string;
+}
+export interface ImportSummary {
+    created: number;
+    assigned: number;
+    skipped: number;
+    failed: number;
+}
+export interface ImportMembersResponse {
+    operationId: string;
+    summary: ImportSummary;
+    results: ImportRowResult[];
+}

package/lib/services/page-refresh/page-refresh.service.d.ts

@@ -55,8 +55,16 @@ export declare class PageRefreshService {
      */
     unregister(): void;
     /**
-     * Ejecuta el handler registrado y espera a que termine. Lo invoca
-     * `val-page-wrapper` al detectar el gesto de pull. No-op si no hay handler.
+     * Duración mínima (ms) que el spinner permanece visible, aunque el handler
+     * termine antes. Sin esto, un reload rápido (data cacheada) cierra el spinner
+     * al instante → se percibe como "no hubo refresh". Con el mínimo, el gesto se
+     * siente smooth y CONSISTENTE en todas las vistas que usan el page-wrapper.
+     */
+    private static readonly MIN_SPINNER_MS;
+    /**
+     * Ejecuta el handler registrado y espera a que termine, garantizando una
+     * duración mínima de spinner. Lo invoca `val-page-wrapper` al detectar el
+     * gesto de pull. No-op si no hay handler.
      */
     run(): Promise<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<PageRefreshService, never>;

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.1009";
+export declare const VERSION = "2.0.1011";

package/package.json

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

package/public-api.d.ts

@@ -293,6 +293,9 @@ export * from './lib/components/organisms/notification-preferences-view/notifica
 export * from './lib/components/organisms/permissions-view/permissions-view.component';
 export * from './lib/components/organisms/permissions-view/types';
 export * from './lib/components/organisms/permissions-view/permissions.routes';
+export * from './lib/components/organisms/about-view/about-view.component';
+export * from './lib/components/organisms/about-view/types';
+export * from './lib/components/organisms/about-view/about.routes';
 export * from './lib/services/org/permission-catalog.service';
 export * from './lib/components/organisms/delete-account-modal/delete-account-modal.component';
 export * from './lib/components/organisms/switch-org-modal/switch-org-modal.component';
@@ -301,6 +304,8 @@ export * from './lib/components/organisms/org-info-sheet/org-info-sheet.componen
 export * from './lib/components/organisms/invite-member-modal/invite-member-modal.component';
 export * from './lib/components/organisms/member-detail-modal/member-detail-modal.component';
 export * from './lib/components/organisms/member-detail-modal/types';
+export * from './lib/components/organisms/member-import-modal/member-import-modal.component';
+export * from './lib/components/organisms/api-keys-modal/api-keys-modal.component';
 export * from './lib/components/organisms/edit-org-modal/edit-org-modal.component';
 export * from './lib/components/organisms/transfer-ownership-modal/transfer-ownership-modal.component';
 export * from './lib/components/organisms/transfer-ownership-modal/types';
@@ -347,7 +352,9 @@ export * from './lib/services/legal-link/legal-link.service';
 export * from './lib/services/firebase';
 export * from './lib/services/auth';
 export { OrgService } from './lib/services/org/org.service';
-export type { Organization, OrgType, OrgPlan, CreateOrgRequest, UpdateOrgRequest, InviteUserRequest, InviteUserResponse, LeaveOrgResponse, ListMyOrgsResponse, OrgResponse, OrgMember, ListOrgMembersResponse, PendingInvitation, ListPendingInvitationsResponse, AcceptInvitationResponse, OrgRole, ListOrgRolesResponse, ChangeMemberRoleRequest, ChangeMemberRoleResponse, } from './lib/services/org/types';
+export type { Organization, OrgType, OrgPlan, CreateOrgRequest, UpdateOrgRequest, InviteUserRequest, InviteUserResponse, LeaveOrgResponse, ListMyOrgsResponse, OrgResponse, OrgMember, ListOrgMembersResponse, PendingInvitation, ListPendingInvitationsResponse, AcceptInvitationResponse, OrgRole, ListOrgRolesResponse, ChangeMemberRoleRequest, ChangeMemberRoleResponse, ImportUserRow, ImportOnConflict, ImportMembersRequest, ImportRowStatus, ImportRowResult, ImportSummary, ImportMembersResponse, } from './lib/services/org/types';
+export { ApiKeyService } from './lib/services/apikeys/api-keys.service';
+export type { ClientApiKey, ClientApiKeyWithSecret, CreateApiKeyRequest, CreateApiKeyResponse, ListApiKeysResponse, AvailablePermissionsResponse, RevokeApiKeyResponse, } from './lib/services/apikeys/types';
 export * from './lib/services/i18n';
 export * from './lib/services/preferences';
 export * from './lib/services/network-status';