valtech-components 2.0.687 → 2.0.689

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

@@ -0,0 +1,253 @@
+/**
+ * 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 { effect, Injectable, Injector, Optional, runInInjectionContext } from '@angular/core';
+import { Observable, of } from 'rxjs';
+import { map } from 'rxjs/operators';
+
+import { AuthService } from '../auth/auth.service';
+import { FirestoreCollectionFactory, TypedCollection } from './firestore-collection';
+import { FirestoreDocument } from './types';
+
+/**
+ * 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);
+ * ```
+ */
+@Injectable({ providedIn: 'root' })
+export class NotificationsService {
+  private collection: TypedCollection<NotificationDocument> | null = null;
+  private currentUserId: string | null = null;
+
+  // Inyección opcional - AuthService puede no estar configurado
+  private authService: AuthService | null = null;
+
+  constructor(
+    private injector: Injector,
+    @Optional() private collectionFactory: FirestoreCollectionFactory
+  ) {
+    // Intentar obtener AuthService de forma lazy (puede no estar configurado)
+    this.setupAutoInitialization();
+  }
+
+  /**
+   * Configura auto-inicialización observando el estado de AuthService.
+   * Se ejecuta en el contexto del injector para poder usar effect().
+   */
+  private setupAutoInitialization(): void {
+    // Obtener AuthService de forma lazy
+    try {
+      this.authService = this.injector.get(AuthService, null);
+    } catch {
+      // AuthService no está configurado, no hay auto-inicialización
+      return;
+    }
+
+    if (!this.authService) {
+      return;
+    }
+
+    // Usar runInInjectionContext para poder crear el effect
+    runInInjectionContext(this.injector, () => {
+      effect(() => {
+        const user = this.authService!.user();
+
+        if (user?.userId && this.currentUserId !== user.userId) {
+          // Usuario autenticado: inicializar con su ID
+          this.initialize(user.userId);
+        } else if (!user && this.currentUserId) {
+          // Logout: limpiar estado
+          this.reset();
+        }
+      });
+    });
+  }
+
+  /**
+   * 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 {
+    if (!this.collectionFactory) {
+      console.warn('[Notifications] FirestoreCollectionFactory not available. Ensure provideValtechFirebase() is configured.');
+      return;
+    }
+
+    this.currentUserId = userId;
+
+    // Path relativo - FirestoreService agrega automáticamente apps/{appId}/
+    // NO agregar apps/ aquí para evitar doble prefijo
+    const basePath = `users/${userId}/notifications`;
+
+    this.collection = this.collectionFactory.create<NotificationDocument>(
+      basePath,
+      { timestamps: true }
+    );
+
+    console.log('[Notifications] Initialized with path:', basePath);
+  }
+
+  /**
+   * Verifica si el servicio está inicializado.
+   */
+  get isReady(): boolean {
+    return this.collection !== null;
+  }
+
+  /**
+   * Obtiene el ID del usuario actual.
+   */
+  get userId(): string | null {
+    return this.currentUserId;
+  }
+
+  // ===========================================================================
+  // LECTURA
+  // ===========================================================================
+
+  /**
+   * Obtiene todas las notificaciones ordenadas por fecha descendente.
+   * Real-time: se actualiza automáticamente cuando cambian los datos.
+   */
+  getAll(): Observable<NotificationDocument[]> {
+    if (!this.collection) return of([]);
+
+    return this.collection.watchAll({
+      orderBy: [{ field: 'createdAt', direction: 'desc' }],
+    });
+  }
+
+  /**
+   * Obtiene todas las notificaciones (one-time fetch sin listener).
+   * Útil para cargas iniciales sin necesidad de updates en tiempo real.
+   */
+  async getAllOnce(): Promise<NotificationDocument[]> {
+    if (!this.collection) return [];
+
+    return this.collection.getAllOnce({
+      orderBy: [{ field: 'createdAt', direction: 'desc' }],
+    });
+  }
+
+  /**
+   * Obtiene solo notificaciones no leídas.
+   */
+  getUnread(): Observable<NotificationDocument[]> {
+    return this.getAll().pipe(
+      map(notifications => notifications.filter(n => !n.isRead))
+    );
+  }
+
+  /**
+   * Cuenta notificaciones no leídas.
+   * Útil para badges en UI.
+   */
+  getUnreadCount(): Observable<number> {
+    return this.getUnread().pipe(map(n => n.length));
+  }
+
+  /**
+   * Obtiene una notificación por ID.
+   */
+  async getById(notificationId: string): Promise<NotificationDocument | null> {
+    if (!this.collection) return null;
+    return this.collection.getById(notificationId);
+  }
+
+  // ===========================================================================
+  // ACCIONES
+  // ===========================================================================
+
+  /**
+   * Marca una notificación como leída.
+   */
+  async markAsRead(notificationId: string): Promise<void> {
+    if (!this.collection) return;
+    await this.collection.update(notificationId, { isRead: true });
+  }
+
+  /**
+   * Marca todas las notificaciones como leídas.
+   */
+  async markAllAsRead(): Promise<void> {
+    if (!this.collection) return;
+
+    const unread = await this.collection.query({
+      where: [{ field: 'isRead', operator: '==', value: false }],
+    });
+
+    await Promise.all(
+      unread.map(n => this.collection!.update(n.id!, { isRead: true }))
+    );
+  }
+
+  /**
+   * Elimina una notificación.
+   */
+  async delete(notificationId: string): Promise<void> {
+    if (!this.collection) return;
+    await this.collection.delete(notificationId);
+  }
+
+  /**
+   * Elimina todas las notificaciones del usuario.
+   */
+  async deleteAll(): Promise<void> {
+    if (!this.collection) return;
+
+    const all = await this.collection.getAll();
+    await Promise.all(all.map(n => this.collection!.delete(n.id!)));
+  }
+
+  /**
+   * Limpia el estado del servicio.
+   * Útil para logout.
+   */
+  reset(): void {
+    this.collection = null;
+    this.currentUserId = null;
+  }
+}

package/src/lib/services/firebase/shared-config.ts

@@ -0,0 +1,167 @@
+/**
+ * Firebase Shared Configuration
+ *
+ * Utilidades genéricas para configuración de Firebase.
+ * Las constantes específicas del proyecto (APP_IDS, FIREBASE_PROJECTS, EMULATOR_CONFIG)
+ * deben definirse en cada app consumidora.
+ */
+
+import { AppId, EmulatorConfig, FirebaseConfig, ValtechFirebaseConfig } from './types';
+import type { AnalyticsConfig } from './analytics-types';
+
+// Re-export types for convenience
+export type { AppId } from './types';
+
+// ============================================================================
+// STORAGE PATH BUILDERS
+// ============================================================================
+
+/**
+ * Genera paths de Storage con namespace por app.
+ *
+ * @example
+ * // Path específico de la app
+ * storagePaths.forApp('showcase', 'uploads', 'image.jpg')
+ * // => 'showcase/uploads/image.jpg'
+ *
+ * // Path compartido
+ * storagePaths.shared.profilePhoto('user123', 'avatar.jpg')
+ * // => 'profile-photos/user123/avatar.jpg'
+ */
+export const storagePaths = {
+  /** Carpeta específica de la app: {appId}/{...paths} */
+  forApp: (appId: AppId, ...paths: string[]): string => [appId, ...paths].join('/'),
+
+  /** Carpetas compartidas (sin namespace) */
+  shared: {
+    /** Foto de perfil de usuario */
+    profilePhoto: (userId: string, fileName: string): string =>
+      `profile-photos/${userId}/${fileName}`,
+
+    /** Archivos públicos accesibles sin autenticación */
+    public: (...paths: string[]): string => `public/${paths.join('/')}`,
+  },
+};
+
+// ============================================================================
+// FIRESTORE COLLECTION BUILDERS
+// ============================================================================
+
+/**
+ * Genera paths de colecciones con namespace por app.
+ *
+ * IMPORTANTE: La estructura es /apps/{appId}/{collection}/{docId}
+ * Firestore requiere número impar de segmentos para paths de colección.
+ *
+ * @example
+ * // Colección específica de la app
+ * collections.forApp('showcase', 'items')
+ * // => 'apps/showcase/items'
+ *
+ * // Colección compartida
+ * collections.shared.users
+ * // => 'users'
+ */
+export const collections = {
+  /** Colección específica de la app: apps/{appId}/{collection} */
+  forApp: (appId: AppId, collectionName: string): string => `apps/${appId}/${collectionName}`,
+
+  /** Colecciones compartidas (sin namespace, nivel raíz) */
+  shared: {
+    /** Usuarios del sistema */
+    users: 'users',
+    /** Perfiles públicos */
+    profiles: 'profiles',
+    /** Notificaciones de usuarios */
+    notifications: 'notifications',
+  },
+};
+
+// ============================================================================
+// HELPER: Create Firebase Config from Environment
+// ============================================================================
+
+/**
+ * Opciones para crear la configuración de Firebase
+ */
+export interface CreateFirebaseConfigOptions {
+  /**
+   * Configuración de emuladores (para desarrollo local).
+   * Pasa tu propia configuración con hosts y puertos.
+   */
+  emulator?: EmulatorConfig;
+  /** Habilitar persistencia offline de Firestore */
+  persistence?: boolean;
+  /**
+   * ID de la aplicación para namespacing automático.
+   * Cuando se configura, FirestoreService y StorageService prefijan automáticamente los paths.
+   */
+  appId?: string;
+  /**
+   * Habilitar Firebase Analytics / GA4.
+   * Requiere measurementId en firebase config.
+   */
+  enableAnalytics?: boolean;
+  /**
+   * Configuración detallada de Analytics.
+   * Solo aplica si enableAnalytics es true.
+   */
+  analyticsConfig?: AnalyticsConfig;
+}
+
+/**
+ * Crea la configuración completa de Firebase desde variables de entorno.
+ * Usa esto en el environment.ts de cada app.
+ *
+ * @example
+ * // environment.ts
+ * import { createFirebaseConfig } from 'valtech-components';
+ * import { APP_IDS, EMULATOR_CONFIG, USE_EMULATORS } from '../config/app-config';
+ * import firebaseConfig from '../config/firebase.config.json';
+ *
+ * export const environment = {
+ *   valtechFirebase: createFirebaseConfig(
+ *     {
+ *       ...firebaseConfig,
+ *       enableMessaging: true,
+ *       messagingVapidKey: 'BHLx...',
+ *     },
+ *     {
+ *       emulator: USE_EMULATORS ? EMULATOR_CONFIG : undefined,
+ *       persistence: true,
+ *       appId: APP_IDS.MY_APP,
+ *     }
+ *   ),
+ * };
+ */
+export function createFirebaseConfig(
+  config: FirebaseConfig,
+  options: CreateFirebaseConfigOptions = {}
+): ValtechFirebaseConfig {
+  const { emulator, persistence = true, appId, enableAnalytics, analyticsConfig } = options;
+
+  // Extraer campos de messaging del config (nuevos campos opcionales)
+  const { enableMessaging = false, messagingVapidKey, ...firebaseCore } = config;
+
+  return {
+    firebase: firebaseCore as FirebaseConfig,
+    persistence,
+    enableMessaging,
+    messagingVapidKey,
+    emulator,
+    appId,
+    enableAnalytics,
+    analyticsConfig,
+  };
+}
+
+// ============================================================================
+// UTILITY: Check if running in emulator mode
+// ============================================================================
+
+/**
+ * Verifica si la configuración tiene emuladores habilitados
+ */
+export function isEmulatorMode(config: ValtechFirebaseConfig): boolean {
+  return config.emulator !== undefined;
+}