valtech-components 2.0.969 → 2.0.971

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

@@ -0,0 +1,84 @@
+import { AvatarUploadError, AvatarUploadMetadata, AvatarUploadResult } from '../avatar-upload/types';
+import { EmptyStateMetadata } from '../../molecules/empty-state/types';
+import { FormMetadata, FormSubmit } from '../../types';
+import { GetProfileResponse } from '../../../services/auth/types';
+import { ProfileViewConfig } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-profile-view` — vista Perfil full-feature autocontenida (organism).
+ *
+ * Edita los campos públicos del usuario en UN solo formulario con UN solo botón
+ * "Guardar". Wireup:
+ *  - Avatar — val-avatar-upload (Firebase Storage + backend sync). Separado del
+ *    form porque es upload sync independiente.
+ *  - Handle (@usuario) — InputType.HANDLE (val-username-input con check de
+ *    disponibilidad async resuelto vía AuthService inyectado).
+ *  - Nombre — InputType.TEXT.
+ *  - Teléfono — InputType.PHONE.
+ *
+ * Submit handler dispatcha:
+ *  1. Si handle cambió → updateHandle PRIMERO (uniqueness).
+ *  2. Si name o phone cambió → updateProfile con ambos.
+ *
+ * Lectura del perfil: suscribe al doc Firestore /users/{uid} (mirror que mantiene
+ * el backend). Reactivo cross-tab + auto-refresca tras save. Fallback REST
+ * (auth.getProfile) si el doc no existe o el listener falla.
+ *
+ * NO renderiza ion-content — vive dentro de val-page-wrapper.
+ *
+ * Auto-registra sus defaults i18n (es/en) en el constructor si el consumer no
+ * proveyó el namespace configurado (default `Settings.Profile`).
+ */
+export declare class ProfileViewComponent {
+    private nav;
+    private auth;
+    private i18n;
+    private toast;
+    private errors;
+    private firebase;
+    private collections;
+    private route;
+    /**
+     * Config vía @Input (object-first). Si no se pasa, se cae al route data
+     * `profileConfig` (poblado por `provideValtechProfileRoutes`). `resolvedConfig`
+     * mergea con los defaults.
+     */
+    config?: ProfileViewConfig;
+    /** Config mergeada con defaults. @Input gana sobre route data. */
+    readonly resolvedConfig: import("@angular/core").Signal<Required<Omit<ProfileViewConfig, "onSaved" | "onAvatarUploaded">> & Pick<ProfileViewConfig, "onSaved" | "onAvatarUploaded">>;
+    /** Namespace i18n resuelto (capturado una vez para llamadas no-reactivas). */
+    private get ns();
+    /**
+     * Colección global /users/{uid} (skipAppPrefix: true — el doc vive fuera de
+     * apps/{appId}/... porque es cross-app, ver firestore.rules).
+     */
+    private usersCol;
+    private formCmp;
+    readonly profile: import("@angular/core").WritableSignal<GetProfileResponse>;
+    readonly loading: import("@angular/core").WritableSignal<boolean>;
+    readonly saving: import("@angular/core").WritableSignal<boolean>;
+    readonly loadError: import("@angular/core").WritableSignal<unknown>;
+    private readonly _userId;
+    readonly errorState: import("@angular/core").Signal<EmptyStateMetadata>;
+    readonly avatarProps: import("@angular/core").Signal<AvatarUploadMetadata>;
+    formMeta: FormMetadata;
+    constructor();
+    /** Construcción inicial — UNA vez. Gatea handle/phone según config. */
+    private buildFormMeta;
+    /** Re-aplica labels/hints/placeholders en cambio de idioma. */
+    private applyI18nLabels;
+    /**
+     * Fallback REST. Capa 4 (UI declarativa): NO toasteamos acá — el
+     * val-empty-state ES la UI del error.
+     */
+    private loadFromApi;
+    private mapMirrorToProfile;
+    onSubmit(event: FormSubmit): Promise<void>;
+    onAvatarUploaded(result: AvatarUploadResult): void;
+    onAvatarError(_err: AvatarUploadError): void;
+    /** Lee del namespace configurado. */
+    protected t(key: string): string;
+    private initialsFromName;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ProfileViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ProfileViewComponent, "val-profile-view", never, { "config": { "alias": "config"; "required": false; }; }, {}, never, never, true, never>;
+}

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

@@ -0,0 +1,12 @@
+import { LanguagesContent } from '../../../services/i18n/types';
+/**
+ * Defaults i18n (es/en) embebidos en `val-profile-view`. Auto-registrados en el
+ * constructor del componente si el consumer no proveyó el namespace
+ * (`Settings.Profile` por default). Garantiza que nunca haya una key faltante
+ * evaluada por cada change-detection (ver nota en valtech-components/CLAUDE.md
+ * sobre el storm de CD con `val-debug-console`). El consumer puede override
+ * registrando el mismo namespace antes de que el componente monte.
+ *
+ * SOLO incluye las keys que la vista realmente usa.
+ */
+export declare const PROFILE_VIEW_I18N: LanguagesContent;

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

@@ -0,0 +1,23 @@
+import { Routes } from '@angular/router';
+import { ProfileViewConfig } from './types';
+/**
+ * Helper para montar la vista Perfil (`val-profile-view`) como ruta en una app
+ * del factory. El `config` se pasa por route `data` (`profileConfig`) y el
+ * componente lo lee como fallback de su `@Input() config`.
+ *
+ * @example
+ * ```ts
+ * // settings.routes.ts
+ * export const settingsRoutes: Routes = [
+ *   ...provideValtechProfileRoutes(),
+ *   { path: 'preferences', loadComponent: () => ... },
+ * ];
+ *
+ * // con config acotada:
+ * ...provideValtechProfileRoutes({ config: { showPhone: false } }),
+ * ```
+ */
+export declare function provideValtechProfileRoutes(opts?: {
+    path?: string;
+    config?: ProfileViewConfig;
+}): Routes;

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

@@ -0,0 +1,32 @@
+import { GetProfileResponse } from '../../../services/auth/types';
+import { AvatarUploadResult } from '../avatar-upload/types';
+/**
+ * Configuración acotada de `val-profile-view` (object-first). Ejes permitidos:
+ *  - **secciones visibles** — gatean el render del avatar y de los campos
+ *    handle/phone del formulario.
+ *  - **branding** — `i18nNamespace` para resolver los textos (default
+ *    `'Settings.Profile'`). El consumer puede registrar ese namespace para
+ *    override de los defaults embebidos.
+ *  - **callbacks** — hooks tras un save / avatar exitoso (además de los toasts
+ *    internos).
+ *
+ * NO admite slots arbitrarios ni override del layout: la vista es full-feature
+ * y autocontenida.
+ */
+export interface ProfileViewConfig {
+    /** Muestra la sección de avatar (upload + meta). Default `true`. */
+    showAvatar?: boolean;
+    /** Incluye el campo `handle` (@usuario) en el formulario. Default `true`. */
+    showHandle?: boolean;
+    /** Incluye el campo `phone` en el formulario. Default `true`. */
+    showPhone?: boolean;
+    /**
+     * Namespace i18n con el que la vista resuelve sus textos.
+     * Default `'Settings.Profile'`.
+     */
+    i18nNamespace?: string;
+    /** Callback tras un guardado de perfil exitoso. */
+    onSaved?: (profile: GetProfileResponse) => void;
+    /** Callback tras subir/actualizar el avatar exitosamente. */
+    onAvatarUploaded?: (result: AvatarUploadResult) => void;
+}

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

package/package.json

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

package/public-api.d.ts

@@ -263,6 +263,9 @@ export * from './lib/components/organisms/bottom-nav/bottom-nav.component';
 export * from './lib/components/organisms/bottom-nav/types';
 export * from './lib/components/organisms/avatar-upload/avatar-upload.component';
 export * from './lib/components/organisms/avatar-upload/types';
+export * from './lib/components/organisms/profile-view/profile-view.component';
+export * from './lib/components/organisms/profile-view/types';
+export * from './lib/components/organisms/profile-view/profile.routes';
 export * from './lib/components/organisms/skeleton-layout/skeleton-layout.component';
 export * from './lib/components/organisms/skeleton-layout/types';
 export * from './lib/components/organisms/faq/faq.component';