valtech-components 2.0.687 → 2.0.689

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

@@ -1,221 +0,0 @@
-/**
- * Analytics Types
- *
- * Tipos e interfaces para el servicio de Firebase Analytics (GA4).
- */
-/**
- * Configuración de Analytics para ValtechFirebaseConfig
- */
-export interface AnalyticsConfig {
-    /** Habilitar tracking automático de page views via Router (default: true) */
-    enablePageViewTracking?: boolean;
-    /** Habilitar tracking automático de errores via ErrorHandler (default: false) */
-    enableErrorTracking?: boolean;
-    /** Habilitar integración con auth para userId y userProperties (default: true) */
-    enableAuthIntegration?: boolean;
-    /** Modo debug: logea a consola además de enviar a Firebase (default: false) */
-    debugMode?: boolean;
-    /** Auto-grant consent para desarrollo/testing (default: false) */
-    defaultConsentGranted?: boolean;
-    /** Rutas a excluir del page view tracking (regex patterns) */
-    excludeRoutes?: string[];
-    /** Consent mode inicial (GDPR) */
-    defaultConsent?: ConsentSettings;
-    /** Clave de localStorage para persistir consent (default: 'analytics_consent') */
-    consentStorageKey?: string;
-    /** Propiedades de usuario por defecto */
-    defaultUserProperties?: Record<string, string>;
-    /** Prefijo para eventos custom (ej: 'myapp_') */
-    eventPrefix?: string;
-    /** Sampling rate (0.0 - 1.0) para reducir volumen (default: 1.0) */
-    samplingRate?: number;
-}
-/**
- * Settings de consentimiento GDPR
- */
-export interface ConsentSettings {
-    /** Permite recolección de analytics */
-    analytics?: boolean;
-    /** Permite personalización de ads */
-    advertising?: boolean;
-    /** Permite funcionalidad */
-    functionality?: boolean;
-    /** Permite seguridad */
-    security?: boolean;
-}
-/**
- * Estado completo de consentimiento
- */
-export interface ConsentState {
-    /** Settings actuales */
-    settings: ConsentSettings;
-    /** Timestamp de la última actualización */
-    updatedAt: Date | null;
-    /** Si el usuario ha tomado una decisión explícita */
-    hasDecided: boolean;
-}
-/**
- * Nombres de eventos GA4 recomendados + customs
- */
-export type AnalyticsEventName = 'add_payment_info' | 'add_shipping_info' | 'add_to_cart' | 'add_to_wishlist' | 'begin_checkout' | 'purchase' | 'refund' | 'remove_from_cart' | 'view_cart' | 'view_item' | 'view_item_list' | 'generate_lead' | 'login' | 'page_view' | 'screen_view' | 'search' | 'select_content' | 'select_item' | 'select_promotion' | 'share' | 'sign_up' | 'view_promotion' | 'feature_used' | 'preference_changed' | 'onboarding_step' | 'error_occurred' | 'performance_metric' | string;
-/**
- * Parámetros tipados por evento
- */
-export interface AnalyticsEventParams {
-    add_to_cart: {
-        item_id: string;
-        item_name?: string;
-        value?: number;
-        currency?: string;
-        quantity?: number;
-    };
-    purchase: {
-        transaction_id: string;
-        value: number;
-        currency?: string;
-        items?: AnalyticsItem[];
-        tax?: number;
-        shipping?: number;
-    };
-    begin_checkout: {
-        value?: number;
-        currency?: string;
-        items?: AnalyticsItem[];
-    };
-    view_item: {
-        item_id: string;
-        item_name?: string;
-        value?: number;
-        currency?: string;
-    };
-    remove_from_cart: {
-        item_id: string;
-        item_name?: string;
-        value?: number;
-    };
-    login: {
-        method?: string;
-    };
-    sign_up: {
-        method?: string;
-    };
-    search: {
-        search_term: string;
-    };
-    share: {
-        content_type?: string;
-        item_id?: string;
-        method?: string;
-    };
-    select_content: {
-        content_type: string;
-        item_id?: string;
-    };
-    page_view: {
-        page_path?: string;
-        page_title?: string;
-        page_location?: string;
-    };
-    screen_view: {
-        screen_name: string;
-        screen_class?: string;
-    };
-    feature_used: {
-        feature_name: string;
-        feature_category?: string;
-    };
-    preference_changed: {
-        preference_name: string;
-        old_value?: string;
-        new_value?: string;
-    };
-    onboarding_step: {
-        step_number: number;
-        step_name?: string;
-    };
-    error_occurred: {
-        error_type: string;
-        error_message?: string;
-        error_stack?: string;
-        context?: string;
-    };
-    performance_metric: {
-        metric_name: string;
-        value: number;
-        unit?: string;
-    };
-    [key: string]: Record<string, unknown> | undefined;
-}
-/**
- * Item para eventos de ecommerce
- */
-export interface AnalyticsItem {
-    /** ID único del item */
-    item_id: string;
-    /** Nombre del item */
-    item_name: string;
-    /** Categoría principal */
-    item_category?: string;
-    /** Subcategorías */
-    item_category2?: string;
-    item_category3?: string;
-    /** Marca */
-    item_brand?: string;
-    /** Variante (ej: color, talla) */
-    item_variant?: string;
-    /** Precio unitario */
-    price?: number;
-    /** Cantidad */
-    quantity?: number;
-    /** Moneda ISO 4217 */
-    currency?: string;
-    /** Posición en lista */
-    index?: number;
-    /** Cupón aplicado */
-    coupon?: string;
-}
-/**
- * Tipo de evento de debug
- */
-export type DebugEventType = 'event' | 'page_view' | 'screen_view' | 'user_property' | 'error' | 'consent' | 'timing';
-/**
- * Evento de debug (solo en debug mode)
- */
-export interface AnalyticsDebugEvent {
-    /** Timestamp del evento */
-    timestamp: Date;
-    /** Tipo de evento */
-    type: DebugEventType;
-    /** Nombre del evento */
-    name: string;
-    /** Parámetros del evento */
-    params?: Record<string, unknown>;
-    /** Si fue enviado a Firebase (false en debug mode) */
-    sent: boolean;
-}
-/**
- * Métrica de timing/performance
- */
-export interface TimingMetric {
-    /** Nombre de la métrica */
-    name: string;
-    /** Valor en milisegundos */
-    valueMs: number;
-    /** Categoría (ej: 'api', 'render', 'load') */
-    category?: string;
-    /** Parámetros adicionales */
-    params?: Record<string, string>;
-}
-/**
- * Propiedades de usuario para segmentación
- */
-export interface UserProperties {
-    /** Idioma preferido */
-    preferred_language?: string;
-    /** Nivel de suscripción */
-    subscription_tier?: string;
-    /** Organización activa (multi-tenant) */
-    active_organization?: string;
-    /** Propiedades custom */
-    [key: string]: string | number | boolean | undefined;
-}

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

@@ -1,256 +0,0 @@
-/**
- * Analytics Service (Firebase GA4)
- *
- * Servicio para tracking de eventos, page views y errores con Firebase Analytics.
- * Integra con el sistema de auth para user properties y respeta consent mode GDPR.
- */
-import { Injector } from '@angular/core';
-import { ValtechFirebaseConfig } from './types';
-import { AnalyticsDebugEvent, AnalyticsEventName, AnalyticsEventParams, AnalyticsItem, ConsentSettings, ConsentState, UserProperties } from './analytics-types';
-import * as i0 from "@angular/core";
-/**
- * Servicio de Firebase Analytics (GA4).
- *
- * Proporciona tracking de eventos, page views, errores y métricas de performance.
- * Soporta GDPR Consent Mode y modo debug para desarrollo.
- *
- * @example
- * ```typescript
- * @Component({...})
- * export class ProductComponent {
- *   private analytics = inject(AnalyticsService);
- *
- *   onPurchase(product: Product) {
- *     this.analytics.logEvent('purchase', {
- *       transaction_id: order.id,
- *       value: order.total,
- *       currency: 'EUR'
- *     });
- *   }
- * }
- * ```
- */
-export declare class AnalyticsService {
-    private injector;
-    private config;
-    private platformId;
-    private readonly _consentState;
-    private readonly _isDebugMode;
-    private readonly _debugHistory;
-    /** Estado de consentimiento actual (readonly) */
-    readonly consentState: import("@angular/core").Signal<ConsentState>;
-    /** Indica si está en modo debug */
-    readonly isDebugMode: import("@angular/core").Signal<boolean>;
-    /** Indica si analytics está habilitado y funcionando */
-    readonly isEnabled: import("@angular/core").Signal<boolean>;
-    private readonly analyticsConfig;
-    private readonly consentStorageKey;
-    private readonly eventPrefix;
-    private readonly samplingRate;
-    constructor(injector: Injector, config: ValtechFirebaseConfig, platformId: Object);
-    /**
-     * Inicializa el servicio de analytics
-     */
-    private initializeAnalytics;
-    /**
-     * Obtiene la instancia de Analytics de forma perezosa.
-     * Esto evita el error de APP_INITIALIZER de AngularFire.
-     */
-    private getAnalyticsInstance;
-    /**
-     * Verifica si Analytics está soportado
-     */
-    private isAnalyticsSupported;
-    /**
-     * Verifica si debe enviar el evento (sampling)
-     */
-    private shouldSample;
-    /**
-     * Registra un page view.
-     * Normalmente se usa automáticamente via AnalyticsRouterTracker.
-     *
-     * @param pagePath - Ruta de la página (ej: '/products/123')
-     * @param pageTitle - Título de la página (opcional)
-     */
-    logPageView(pagePath: string, pageTitle?: string): void;
-    /**
-     * Registra un screen view (para apps tipo SPA).
-     *
-     * @param screenName - Nombre del screen
-     * @param screenClass - Clase del screen (opcional)
-     */
-    logScreenView(screenName: string, screenClass?: string): void;
-    /**
-     * Registra un evento tipado GA4.
-     *
-     * @param eventName - Nombre del evento (tipado)
-     * @param params - Parámetros del evento (tipados según el nombre)
-     *
-     * @example
-     * ```typescript
-     * // Evento tipado con autocompletado
-     * analytics.logEvent('add_to_cart', {
-     *   item_id: '123',
-     *   item_name: 'Producto',
-     *   value: 99.99,
-     *   currency: 'EUR'
-     * });
-     * ```
-     */
-    logEvent<T extends AnalyticsEventName>(eventName: T, params?: AnalyticsEventParams[T]): void;
-    /**
-     * Registra un evento custom con parámetros libres.
-     * Usar cuando el evento no está en el catálogo tipado.
-     *
-     * @param eventName - Nombre del evento custom
-     * @param params - Parámetros libres
-     */
-    logCustomEvent(eventName: string, params?: Record<string, unknown>): void;
-    /**
-     * Lógica común para enviar eventos
-     */
-    private trackEvent;
-    /**
-     * Registra vista de item
-     */
-    logViewItem(item: AnalyticsItem): void;
-    /**
-     * Registra agregar al carrito
-     */
-    logAddToCart(item: AnalyticsItem, quantity?: number): void;
-    /**
-     * Registra inicio de checkout
-     */
-    logBeginCheckout(items: AnalyticsItem[], value: number, currency?: string): void;
-    /**
-     * Registra compra completada
-     */
-    logPurchase(transactionId: string, items: AnalyticsItem[], value: number, currency?: string): void;
-    /**
-     * Setea el userId para asociar eventos con el usuario.
-     * Llamado automáticamente si enableAuthIntegration=true.
-     *
-     * @param userId - ID del usuario o null para limpiar
-     */
-    setUserId(userId: string | null): void;
-    /**
-     * Setea propiedades del usuario para segmentación.
-     *
-     * @param properties - Propiedades key-value
-     *
-     * @example
-     * ```typescript
-     * analytics.setUserProperties({
-     *   subscription_tier: 'premium',
-     *   preferred_language: 'es'
-     * });
-     * ```
-     */
-    setUserProperties(properties: UserProperties | Record<string, string | number | boolean>): void;
-    /**
-     * Setea la organización activa (multi-tenant).
-     * Llamado automáticamente si enableAuthIntegration=true.
-     *
-     * @param orgId - ID de la organización o null
-     */
-    setActiveOrganization(orgId: string | null): void;
-    /**
-     * Registra un error para tracking.
-     * Integra automáticamente con Angular ErrorHandler si enableErrorTracking=true.
-     *
-     * @param error - Error o mensaje de error
-     * @param context - Contexto adicional
-     *
-     * @example
-     * ```typescript
-     * try {
-     *   await riskyOperation();
-     * } catch (error) {
-     *   analytics.logError(error, { context: 'checkout_flow' });
-     * }
-     * ```
-     */
-    logError(error: Error | string, context?: Record<string, string>): void;
-    /**
-     * Registra un error fatal (crash-level).
-     */
-    logFatalError(error: Error, context?: Record<string, string>): void;
-    /**
-     * Actualiza el estado de consentimiento del usuario.
-     * Afecta qué datos se recolectan y envían.
-     *
-     * @param consent - Settings de consentimiento
-     *
-     * @example
-     * ```typescript
-     * // Usuario acepta todo
-     * analytics.updateConsent({ analytics: true, advertising: true });
-     *
-     * // Usuario rechaza publicidad
-     * analytics.updateConsent({ analytics: true, advertising: false });
-     * ```
-     */
-    updateConsent(consent: ConsentSettings): void;
-    /**
-     * Deniega todo consentimiento.
-     */
-    denyAllConsent(): void;
-    /**
-     * Acepta todo consentimiento.
-     */
-    grantAllConsent(): void;
-    /**
-     * Obtiene el estado actual de consentimiento.
-     */
-    getConsentState(): ConsentState;
-    /**
-     * Aplica consent settings a gtag (GA4 Consent Mode v2)
-     */
-    private applyConsentToGtag;
-    /**
-     * Carga consent desde localStorage
-     */
-    private loadConsentFromStorage;
-    /**
-     * Guarda consent en localStorage
-     */
-    private saveConsentToStorage;
-    /**
-     * Registra una métrica de timing/performance.
-     *
-     * @param name - Nombre de la métrica
-     * @param valueMs - Valor en milisegundos
-     * @param params - Parámetros adicionales
-     *
-     * @example
-     * ```typescript
-     * const start = performance.now();
-     * await loadData();
-     * analytics.logTiming('data_load', performance.now() - start, {
-     *   category: 'api',
-     *   endpoint: '/products'
-     * });
-     * ```
-     */
-    logTiming(name: string, valueMs: number, params?: Record<string, string>): void;
-    /**
-     * Habilita/deshabilita modo debug.
-     * En debug: logea eventos a consola además de enviarlos a Firebase.
-     */
-    setDebugMode(enabled: boolean): void;
-    /**
-     * Obtiene historial de eventos (solo en debug mode).
-     * Útil para testing y desarrollo.
-     */
-    getDebugHistory(): AnalyticsDebugEvent[];
-    /**
-     * Limpia historial de debug.
-     */
-    clearDebugHistory(): void;
-    /**
-     * Agrega evento al historial de debug
-     */
-    private addToDebugHistory;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AnalyticsService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AnalyticsService>;
-}

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

@@ -1,49 +0,0 @@
-/**
- * Firebase Configuration
- *
- * Configuración e inicialización de Firebase para aplicaciones Angular.
- * Usa provideValtechFirebase() en el bootstrap de tu aplicación.
- */
-import { EnvironmentProviders, InjectionToken } from '@angular/core';
-import { ValtechFirebaseConfig } from './types';
-/**
- * Token de inyección para la configuración de Firebase.
- * Usado internamente por los servicios de Firebase.
- */
-export declare const VALTECH_FIREBASE_CONFIG: InjectionToken<ValtechFirebaseConfig>;
-/**
- * Provee Firebase a la aplicación Angular.
- *
- * @param config - Configuración de Firebase
- * @returns EnvironmentProviders para usar en bootstrapApplication
- *
- * @example
- * ```typescript
- * // main.ts
- * import { bootstrapApplication } from '@angular/platform-browser';
- * import { provideValtechFirebase } from 'valtech-components';
- * import { environment } from './environments/environment';
- *
- * bootstrapApplication(AppComponent, {
- *   providers: [
- *     provideValtechFirebase({
- *       firebase: environment.firebase,
- *       persistence: true,
- *       emulator: environment.useEmulators ? {
- *         firestore: { host: 'localhost', port: 8080 },
- *         auth: { host: 'localhost', port: 9099 },
- *         storage: { host: 'localhost', port: 9199 },
- *       } : undefined,
- *     }),
- *   ],
- * });
- * ```
- */
-export declare function provideValtechFirebase(config: ValtechFirebaseConfig): EnvironmentProviders;
-/**
- * Verifica si los emuladores están configurados.
- *
- * @param config - Configuración de Firebase
- * @returns true si hay al menos un emulador configurado
- */
-export declare function hasEmulators(config: ValtechFirebaseConfig): boolean;