valtech-components 2.0.797 → 2.0.799

package/lib/components/organisms/skeleton-layout/skeleton-layout.component.d.ts

@@ -0,0 +1,37 @@
+import { SkeletonLayoutMetadata } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-skeleton-layout`
+ *
+ * Skeleton de página **preset-driven**. En vez de que cada vista componga
+ * átomos `val-skeleton` a mano, declara una shape y este organism arma el
+ * placeholder completo. Estándar único para loading states en todo el factory.
+ *
+ * Presets: `form` · `list` · `article` · `cards` · `detail` · `hero`.
+ *
+ * Extender = agregar un valor a `SkeletonLayoutPreset` + un `@case` acá.
+ * Los consumers no cambian.
+ *
+ * @example
+ * ```html
+ * @if (loading()) {
+ *   <val-skeleton-layout [props]="{ preset: 'form', rows: 3, showAvatar: true }" />
+ * } @else {
+ *   ...contenido real...
+ * }
+ * ```
+ */
+export declare class SkeletonLayoutComponent {
+    private readonly props_;
+    set props(value: SkeletonLayoutMetadata | undefined);
+    /** Props con defaults aplicados. */
+    readonly resolved: import("@angular/core").Signal<SkeletonLayoutMetadata>;
+    /** Shimmer on/off — default on. */
+    readonly anim: import("@angular/core").Signal<boolean>;
+    /** Array `[0..rows)` para los `@for`. rows del prop o default del preset. */
+    readonly rowsArray: import("@angular/core").Signal<number[]>;
+    /** `grid-template-columns` para el preset cards. */
+    readonly gridColumns: import("@angular/core").Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SkeletonLayoutComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkeletonLayoutComponent, "val-skeleton-layout", never, { "props": { "alias": "props"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/organisms/skeleton-layout/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Presets de layout para `val-skeleton-layout`.
+ *
+ * Cada preset compone átomos `val-skeleton` en la forma de una shape de página
+ * común. Para agregar uno nuevo: añadir el valor acá + un `@case` en el
+ * template del componente. Cero cambios en los consumers.
+ */
+export type SkeletonLayoutPreset = 'form' | 'list' | 'article' | 'cards' | 'detail' | 'hero';
+/**
+ * Configuración del componente `val-skeleton-layout`.
+ *
+ * @example Form con avatar (perfil):
+ * ```html
+ * <val-skeleton-layout [props]="{ preset: 'form', rows: 3, showAvatar: true }" />
+ * ```
+ *
+ * @example Lista (notificaciones, sesiones):
+ * ```html
+ * <val-skeleton-layout [props]="{ preset: 'list', rows: 5 }" />
+ * ```
+ *
+ * @example Artículo legal:
+ * ```html
+ * <val-skeleton-layout [props]="{ preset: 'article' }" />
+ * ```
+ */
+export interface SkeletonLayoutMetadata {
+    /** Shape de la página a esqueletizar. */
+    preset: SkeletonLayoutPreset;
+    /**
+     * Cantidad de items repetibles (fields en `form`, filas en `list`/`detail`,
+     * párrafos en `article`, cards en `cards`). Si se omite usa el default del
+     * preset.
+     */
+    rows?: number;
+    /** `form` — antepone un bloque avatar + meta lines. Default `false`. */
+    showAvatar?: boolean;
+    /** `form` — renderiza un bloque de botón al final. Default `true`. */
+    showButton?: boolean;
+    /** `cards` — columnas por fila. Default `2`. */
+    columns?: number;
+    /** `article` / `hero` — incluye bloque de título grande. Default `true`. */
+    showTitle?: boolean;
+    /** Desactiva el shimmer. Default animado. */
+    animated?: boolean;
+    /** Clase CSS extra para el contenedor. */
+    cssClass?: string;
+}
+/** Defaults de `rows` por preset cuando el consumer no lo especifica. */
+export declare const SKELETON_LAYOUT_DEFAULT_ROWS: Record<SkeletonLayoutPreset, number>;

package/lib/services/firebase/messaging.service.d.ts

@@ -60,6 +60,15 @@ export declare class MessagingService {
     private readonly debugPersistence;
     /** Key para localStorage de mensajes FCM (debugging) */
     private readonly DEBUG_STORAGE_KEY;
+    /**
+     * Key de localStorage donde se persiste el token FCM.
+     *
+     * El token vive en un `BehaviorSubject` en memoria y se pierde en cada
+     * recarga / suspensión de la PWA (iOS reinicia PWAs con frecuencia). Persistir
+     * el token permite hidratar el estado en cold start y que la UI no parpadee.
+     * Es un *optimistic hint* — la verdad la confirma el siguiente `getToken()`.
+     */
+    private readonly TOKEN_STORAGE_KEY;
     constructor(injector: Injector, config: ValtechFirebaseConfig, platformId: Object, ngZone: NgZone);
     /**
      * Obtiene la instancia de Messaging via Firebase SDK directo (NO AngularFire DI).
@@ -124,6 +133,23 @@ export declare class MessagingService {
      * ```
      */
     getToken(): Promise<string | null>;
+    /**
+     * Resuelve el `ServiceWorkerRegistration` del SW de FCM.
+     *
+     * El SW `/firebase-messaging-sw.js` ya se registra una vez en el bootstrap de
+     * la app (`config.ts`). Reutilizamos ese registro en lugar de re-registrarlo
+     * en cada `getToken()` — re-registrar repetidamente dispara revalidaciones del
+     * SW en iOS PWA. Solo registramos como fallback si todavía no existe.
+     */
+    private resolveServiceWorkerRegistration;
+    /**
+     * Persiste el token FCM en localStorage (o lo limpia si es null/empty).
+     */
+    private persistToken;
+    /**
+     * Hidrata el estado del token desde localStorage en el arranque del servicio.
+     */
+    private hydrateTokenFromStorage;
     /**
      * Elimina el token FCM actual (unsubscribe de notificaciones).
      *

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

@@ -38,6 +38,16 @@ export declare class PreferencesService {
     readonly synced: import("@angular/core").Signal<boolean>;
     private subscription?;
     private currentUserId?;
+    /**
+     * `true` mientras un `update()` está en vuelo (PUT al backend).
+     *
+     * El listener Firestore (`bindToUser`) es real-time y puede emitir un snapshot
+     * *stale* — anterior al sync del backend — que pisaría el valor optimista de
+     * `_notificationsMaster` y revertiría el toggle. Mientras este flag esté `true`
+     * el listener ignora las emisiones; el `update()` ya alinea las señales con la
+     * respuesta del backend al terminar.
+     */
+    private _updateInFlight;
     constructor(config: ValtechAuthConfig, firestore: FirestoreService, auth: AuthService, http: HttpClient, themeService: ThemeService | null, i18n: I18nService | null);
     /** Actualiza preferencias via backend. Optimistic UI: aplica local, revierte si falla. */
     update(partial: PreferencesUpdate): Promise<PreferencesUpdateResponse>;

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

package/package.json

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

package/public-api.d.ts

@@ -223,6 +223,8 @@ 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/skeleton-layout/skeleton-layout.component';
+export * from './lib/components/organisms/skeleton-layout/types';
 export * from './lib/components/templates/simple/simple.component';
 export * from './lib/components/templates/simple/types';
 export * from './lib/components/templates/page-template/page-template.component';