valtech-components 2.0.481 → 2.0.483

package/lib/components/organisms/article/article.component.d.ts

@@ -90,7 +90,7 @@ export declare class ArticleComponent implements OnInit {
         contentInterpolation?: Record<string, string | number>;
         icon?: import("valtech-components").IconMetada;
         shape?: "round";
-        size?: "default" | "small" | "large";
+        size?: "small" | "large" | "default";
         fill?: "default" | "clear" | "outline" | "solid";
         type: "button" | "submit" | "reset";
         token?: string;

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

@@ -48,6 +48,10 @@ export declare class AuthStateService {
      * Actualiza solo el access token (después de refresh).
      */
     updateAccessToken(accessToken: string, expiresIn: number): void;
+    /**
+     * Actualiza el refresh token (token rotation).
+     */
+    updateRefreshToken(refreshToken: string): void;
     /**
      * Actualiza los permisos.
      */

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

@@ -94,6 +94,8 @@ export declare class AuthService implements OnDestroy {
     verifyMFA(code: string): Observable<MFAVerifyResponse>;
     /**
      * Refresca el token de acceso.
+     * Implementa token rotation: cada refresh genera un nuevo refresh token
+     * que el cliente debe guardar para el próximo refresh.
      */
     refreshAccessToken(): Observable<RefreshResponse>;
     /**

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

@@ -19,6 +19,10 @@ export declare class AuthStorageService {
      * Guarda solo el access token.
      */
     saveAccessToken(token: string, expiresAt?: number): void;
+    /**
+     * Guarda el refresh token (token rotation).
+     */
+    saveRefreshToken(token: string): void;
     /**
      * Guarda los permisos actualizados.
      */

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

@@ -209,11 +209,16 @@ export interface RefreshRequest {
 }
 /**
  * Response de refrescar token.
+ * Implementa token rotation: cada refresh genera un nuevo refresh token.
  */
 export interface RefreshResponse {
     operationId: string;
     accessToken: string;
+    refreshToken: string;
     expiresIn: number;
+    firebaseToken?: string;
+    roles?: string[];
+    permissions?: string[];
 }
 /**
  * Request para logout.
@@ -361,6 +366,7 @@ export interface AuthSyncEvent {
     timestamp: number;
     payload?: {
         accessToken?: string;
+        refreshToken?: string;
         expiresAt?: number;
         activeOrg?: string;
     };

package/lib/services/firebase/index.d.ts

@@ -37,3 +37,4 @@ export { QueryBuilder, query } from './utils/query-builder';
 export { buildPath, extractPathParams, getCollectionPath, getDocumentId, isCollectionPath, isDocumentPath, isValidPath, joinPath, } from './utils/path-builder';
 export { StorageService } from './storage.service';
 export { MessagingService } from './messaging.service';
+export { NotificationDocument, NotificationsService } from './notifications.service';

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

@@ -56,6 +56,10 @@ export declare class MessagingService {
     private notificationClickSubject;
     private stateSubject;
     private unsubscribeOnMessage?;
+    /** Flag para persistir mensajes FCM en localStorage (debugging) */
+    private readonly debugPersistence;
+    /** Key para localStorage de mensajes FCM (debugging) */
+    private readonly DEBUG_STORAGE_KEY;
     constructor(injector: Injector, config: ValtechFirebaseConfig, platformId: Object, ngZone: NgZone);
     /**
      * Obtiene la instancia de Messaging de forma perezosa.
@@ -133,6 +137,12 @@ export declare class MessagingService {
      * Configura el listener de mensajes en foreground
      */
     private setupMessageListener;
+    /**
+     * Persiste un mensaje FCM en localStorage para debugging.
+     * Solo se usa cuando debugMessagePersistence está habilitado.
+     * Mantiene los últimos 50 mensajes.
+     */
+    private persistMessageForDebug;
     /**
      * Obtiene el estado actual del permiso de notificaciones.
      *

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

@@ -0,0 +1,122 @@
+/**
+ * Notifications Service
+ *
+ * Servicio para leer notificaciones desde Firestore.
+ * El backend escribe las notificaciones, el frontend solo las lee y actualiza estado.
+ *
+ * Se auto-inicializa cuando AuthService tiene un usuario autenticado.
+ * También puede inicializarse manualmente con `initialize(userId)`.
+ */
+import { Injector } from '@angular/core';
+import { Observable } from 'rxjs';
+import { FirestoreCollectionFactory } from './firestore-collection';
+import { FirestoreDocument, ValtechFirebaseConfig } from './types';
+import * as i0 from "@angular/core";
+/**
+ * Documento de notificación en Firestore.
+ * Estructura escrita por el backend.
+ */
+export interface NotificationDocument extends FirestoreDocument {
+    /** Título de la notificación */
+    title?: string;
+    /** Cuerpo del mensaje */
+    body?: string;
+    /** URL de imagen */
+    image?: string;
+    /** Datos personalizados (ej: route, actionType) */
+    data?: Record<string, string>;
+    /** Tipo de notificación */
+    type?: 'fcm' | 'system' | 'reminder' | string;
+    /** Si la notificación fue leída */
+    isRead: boolean;
+}
+/**
+ * Servicio para leer notificaciones desde Firestore.
+ *
+ * Se auto-inicializa cuando AuthService tiene un usuario autenticado.
+ * No requiere llamar a `initialize()` manualmente si AuthService está configurado.
+ *
+ * @example
+ * ```typescript
+ * // Con AuthService configurado: auto-inicialización
+ * // Solo inyectar y usar directamente
+ * private notifications = inject(NotificationsService);
+ *
+ * notifications$ = this.notifications.getAll();
+ * unreadCount$ = this.notifications.getUnreadCount();
+ *
+ * // Sin AuthService: inicialización manual
+ * this.notifications.initialize(userId);
+ * ```
+ */
+export declare class NotificationsService {
+    private injector;
+    private collectionFactory;
+    private config;
+    private collection;
+    private currentUserId;
+    private authService;
+    constructor(injector: Injector, collectionFactory: FirestoreCollectionFactory, config: ValtechFirebaseConfig | null);
+    /**
+     * Configura auto-inicialización observando el estado de AuthService.
+     * Se ejecuta en el contexto del injector para poder usar effect().
+     */
+    private setupAutoInitialization;
+    /**
+     * Inicializa el servicio para un usuario específico.
+     *
+     * NOTA: Se llama automáticamente si AuthService está configurado.
+     * Solo usar manualmente si AuthService no está disponible o se necesita
+     * un userId diferente al del usuario autenticado.
+     */
+    initialize(userId: string): void;
+    /**
+     * Verifica si el servicio está inicializado.
+     */
+    get isReady(): boolean;
+    /**
+     * Obtiene el ID del usuario actual.
+     */
+    get userId(): string | null;
+    /**
+     * Obtiene todas las notificaciones ordenadas por fecha descendente.
+     * Real-time: se actualiza automáticamente cuando cambian los datos.
+     */
+    getAll(): Observable<NotificationDocument[]>;
+    /**
+     * Obtiene solo notificaciones no leídas.
+     */
+    getUnread(): Observable<NotificationDocument[]>;
+    /**
+     * Cuenta notificaciones no leídas.
+     * Útil para badges en UI.
+     */
+    getUnreadCount(): Observable<number>;
+    /**
+     * Obtiene una notificación por ID.
+     */
+    getById(notificationId: string): Promise<NotificationDocument | null>;
+    /**
+     * Marca una notificación como leída.
+     */
+    markAsRead(notificationId: string): Promise<void>;
+    /**
+     * Marca todas las notificaciones como leídas.
+     */
+    markAllAsRead(): Promise<void>;
+    /**
+     * Elimina una notificación.
+     */
+    delete(notificationId: string): Promise<void>;
+    /**
+     * Elimina todas las notificaciones del usuario.
+     */
+    deleteAll(): Promise<void>;
+    /**
+     * Limpia el estado del servicio.
+     * Útil para logout.
+     */
+    reset(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NotificationsService, [null, { optional: true; }, { optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NotificationsService>;
+}

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

@@ -66,6 +66,12 @@ export interface ValtechFirebaseConfig {
      * Si no se proporciona, los paths quedan sin modificar (backward compatible).
      */
     appId?: AppId;
+    /**
+     * Persiste mensajes FCM en localStorage para debugging.
+     * Solo para desarrollo, permite ver mensajes en DevTools.
+     * Default: false
+     */
+    debugMessagePersistence?: boolean;
 }
 /**
  * Interface base para todos los documentos de Firestore.

package/package.json

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