valtech-components 2.0.475 → 2.0.477

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

@@ -6,8 +6,8 @@ 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, MFADisableResponse, ForgotPasswordRequest, ForgotPasswordResponse, ResetPasswordRequest, ResetPasswordResponse, SwitchOrgResponse, MFAMethod, AuthError, ValtechAuthConfig } from './types';
-import { FirebaseService } from '../firebase';
+import { SigninRequest, SigninResponse, SignupRequest, SignupResponse, VerifyEmailRequest, VerifyEmailResponse, ResendCodeRequest, ResendCodeResponse, MFAVerifyResponse, RefreshResponse, GetPermissionsResponse, GetProfileResponse, UpdateProfileRequest, UpdateProfileResponse, MFASetupResponse, MFAConfirmResponse, MFADisableResponse, ForgotPasswordRequest, ForgotPasswordResponse, ResetPasswordRequest, ResetPasswordResponse, SwitchOrgResponse, MFAMethod, AuthError, ValtechAuthConfig, EnableNotificationsResult, NotificationPermissionState } from './types';
+import { FirebaseService, MessagingService } from '../firebase';
 import * as i0 from "@angular/core";
 /**
  * Servicio principal de autenticación.
@@ -40,9 +40,10 @@ export declare class AuthService implements OnDestroy {
     private storageService;
     private syncService;
     private firebaseService;
+    private messagingService;
     private refreshTimerId;
     private syncSubscription;
-    constructor(config: ValtechAuthConfig, http: HttpClient, router: Router, stateService: AuthStateService, tokenService: TokenService, storageService: AuthStorageService, syncService: AuthSyncService, firebaseService: FirebaseService);
+    constructor(config: ValtechAuthConfig, http: HttpClient, router: Router, stateService: AuthStateService, tokenService: TokenService, storageService: AuthStorageService, syncService: AuthSyncService, firebaseService: FirebaseService, messagingService: MessagingService | null);
     /** Estado completo de autenticación */
     readonly state: import("@angular/core").Signal<import("./types").AuthState>;
     /** Usuario está autenticado */
@@ -98,7 +99,7 @@ export declare class AuthService implements OnDestroy {
     /**
      * Cierra sesión.
      */
-    logout(): void;
+    logout(): Promise<void>;
     /**
      * Configura MFA para el usuario.
      */
@@ -174,6 +175,62 @@ export declare class AuthService implements OnDestroy {
     private handleAuthError;
     private signInWithFirebase;
     private signOutFirebase;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AuthService, never>;
+    /**
+     * Solicita permisos de notificación y registra el dispositivo.
+     * Usar cuando el usuario acepta recibir notificaciones.
+     *
+     * @example
+     * ```typescript
+     * async onEnableNotifications() {
+     *   const result = await this.auth.enableNotifications();
+     *   if (result.granted) {
+     *     console.log('Notificaciones habilitadas');
+     *   }
+     * }
+     * ```
+     */
+    enableNotifications(): Promise<EnableNotificationsResult>;
+    /**
+     * Desactiva las notificaciones para este dispositivo.
+     * Elimina el token del backend y de FCM.
+     * Usar desde un toggle de preferencias cuando el usuario desactiva notificaciones.
+     *
+     * NOTA: Esto NO revoca el permiso del navegador (el usuario debe hacerlo manualmente
+     * desde la configuración del navegador). Solo elimina el registro del dispositivo.
+     *
+     * @example
+     * ```typescript
+     * async onToggleNotifications(enabled: boolean) {
+     *   if (enabled) {
+     *     await this.auth.enableNotifications();
+     *   } else {
+     *     await this.auth.disableNotifications();
+     *   }
+     * }
+     * ```
+     */
+    disableNotifications(): Promise<{
+        disabled: boolean;
+    }>;
+    /**
+     * Retorna el estado actual de permisos de notificación.
+     *
+     * @returns 'granted' | 'denied' | 'default' | 'unsupported'
+     */
+    getNotificationPermissionState(): NotificationPermissionState;
+    /**
+     * Registra el dispositivo en el backend si tiene permisos de notificación.
+     * Se llama automáticamente después de un login exitoso si enableDeviceRegistration=true.
+     */
+    private registerDeviceIfNeeded;
+    /**
+     * Elimina el dispositivo del backend y borra el token FCM.
+     */
+    private unregisterDevice;
+    /**
+     * Detecta información de la plataforma del dispositivo.
+     */
+    private detectPlatformInfo;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AuthService, [null, null, null, null, null, null, null, null, { optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AuthService>;
 }

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

@@ -3,20 +3,23 @@
  *
  * Servicio de autenticación reutilizable para aplicaciones Angular.
  * Proporciona autenticación con AuthV2, MFA, sincronización entre pestañas,
- * y refresh proactivo de tokens.
+ * refresh proactivo de tokens, y registro automático de dispositivos para
+ * push notifications.
  *
  * @example
  * ```typescript
  * // En main.ts
  * import { bootstrapApplication } from '@angular/platform-browser';
- * import { provideValtechAuth } from 'valtech-components';
+ * import { provideValtechAuth, provideValtechFirebase } from 'valtech-components';
  * import { environment } from './environments/environment';
  *
  * bootstrapApplication(AppComponent, {
  *   providers: [
+ *     provideValtechFirebase(environment.firebase),
  *     provideValtechAuth({
  *       apiUrl: environment.apiUrl,
  *       enableFirebaseIntegration: true,
+ *       enableDeviceRegistration: true, // Auto-registra dispositivos para push
  *     }),
  *   ],
  * });
@@ -46,6 +49,19 @@
  *     }
  *   }
  *
+ *   // Habilitar notificaciones push (solicita permisos + registra dispositivo)
+ *   async enableNotifications() {
+ *     const result = await this.auth.enableNotifications();
+ *     if (result.granted) {
+ *       console.log('Notificaciones habilitadas');
+ *     }
+ *   }
+ *
+ *   // Verificar estado de permisos
+ *   get canReceiveNotifications(): boolean {
+ *     return this.auth.getNotificationPermissionState() === 'granted';
+ *   }
+ *
  *   // En template: usar signals directamente
  *   // {{ auth.user()?.email }}
  *   // @if (auth.hasPermission('templates:edit')) { ... }

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

@@ -24,6 +24,8 @@ export interface ValtechAuthConfig {
     unauthorizedRoute?: string;
     /** Habilitar integración con FirebaseService (default: false) */
     enableFirebaseIntegration?: boolean;
+    /** Habilitar registro automático de device tokens para push notifications (default: false) */
+    enableDeviceRegistration?: boolean;
 }
 /**
  * Estado completo de autenticación.
@@ -389,3 +391,58 @@ export interface StoredAuthState {
     isSuperAdmin: boolean;
     expiresAt?: number;
 }
+/**
+ * Plataformas soportadas para push notifications.
+ */
+export type DevicePlatform = 'web' | 'ios' | 'android';
+/**
+ * Request para registrar un dispositivo.
+ */
+export interface RegisterDeviceRequest {
+    /** FCM token del dispositivo */
+    token: string;
+    /** Plataforma del dispositivo */
+    platform: DevicePlatform;
+    /** Navegador (solo web) */
+    browser?: string;
+    /** Sistema operativo */
+    os?: string;
+    /** Versión de la aplicación */
+    appVersion?: string;
+    /** Nombre amigable del dispositivo */
+    name?: string;
+    /** Metadata adicional */
+    metadata?: Record<string, string>;
+}
+/**
+ * Response de registro de dispositivo.
+ */
+export interface RegisterDeviceResponse {
+    operationId: string;
+    device: {
+        deviceId: string;
+        token: string;
+        platform: DevicePlatform;
+        browser?: string;
+        os?: string;
+        lastActive: string;
+        createdAt: string;
+    };
+    /** true si es un nuevo dispositivo, false si se actualizó uno existente */
+    isNew: boolean;
+}
+/**
+ * Resultado de habilitar notificaciones.
+ */
+export interface EnableNotificationsResult {
+    /** Si se otorgaron los permisos */
+    granted: boolean;
+    /** FCM token (solo si granted=true) */
+    token?: string;
+    /** Si el dispositivo fue registrado en el backend */
+    registered?: boolean;
+}
+/**
+ * Estado de permisos de notificación.
+ */
+export type NotificationPermissionState = 'granted' | 'denied' | 'default' | 'unsupported';

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

@@ -5,8 +5,7 @@
  * Permite solicitar permisos, obtener tokens, escuchar mensajes y manejar
  * navegación (deep linking) cuando el usuario toca una notificación.
  */
-import { NgZone } from '@angular/core';
-import { Messaging } from '@angular/fire/messaging';
+import { Injector, NgZone } from '@angular/core';
 import { Observable } from 'rxjs';
 import { NotificationAction, NotificationClickEvent, NotificationPayload, NotificationPermission, ValtechFirebaseConfig } from './types';
 import * as i0 from "@angular/core";
@@ -49,7 +48,7 @@ interface MessagingState {
  * ```
  */
 export declare class MessagingService {
-    private messaging;
+    private injector;
     private config;
     private platformId;
     private ngZone;
@@ -57,7 +56,12 @@ export declare class MessagingService {
     private notificationClickSubject;
     private stateSubject;
     private unsubscribeOnMessage?;
-    constructor(messaging: Messaging | null, config: ValtechFirebaseConfig, platformId: Object, ngZone: NgZone);
+    constructor(injector: Injector, config: ValtechFirebaseConfig, platformId: Object, ngZone: NgZone);
+    /**
+     * Obtiene la instancia de Messaging de forma perezosa.
+     * Esto evita el error de APP_INITIALIZER de AngularFire.
+     */
+    private getMessagingInstance;
     /**
      * Inicializa el servicio de messaging
      */
@@ -257,7 +261,7 @@ export declare class MessagingService {
      * Parsea un query string en un objeto.
      */
     private parseQueryString;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MessagingService, [{ optional: true; }, null, null, null]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MessagingService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MessagingService>;
 }
 export {};

package/package.json

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