@metodokorexmk/tracking 1.1.0 → 1.2.0

package/dist/react/index.d.cts

@@ -1,51 +1,51 @@
 /**
- * Configuración del LandingTracker (orquestador de sesión).
+ * LandingTracker configuration (session orchestrator).
  */
 interface LandingTrackerConfig {
-    /** Ruta de la landing page (ej: '/kin', '/racha') */
+    /** Landing page path (e.g., '/kin', '/racha') */
     pagePath: string;
-    /** Nombre legible de la landing (ej: 'Kin Landing Page') */
+    /** Human-readable landing page name (e.g., 'Kin Landing Page') */
     pageName: string;
-    /** ID de Google Tag Manager (opcional) */
+    /** Google Tag Manager container ID (optional) */
     gtmId?: string;
-    /** Habilitar tracking de scroll (milestones 25/50/75/100%). Default: true */
+    /** Enable scroll tracking (milestones 25/50/75/100%). Default: true */
     enableScrollTracking?: boolean;
-    /** Habilitar tracking automático de clicks en CTAs. Default: true */
+    /** Enable automatic CTA click tracking. Default: true */
     enableCTATracking?: boolean;
-    /** Habilitar tracking de tiempo en página. Default: true */
+    /** Enable page dwell time tracking. Default: true */
     enableTimeTracking?: boolean;
-    /** Habilitar tracking de tiempo por sección (IntersectionObserver). Default: true */
+    /** Enable per-section dwell time via IntersectionObserver. Default: true */
     enableSectionTracking?: boolean;
-    /** Habilitar auto-tracking de formularios. Default: true */
+    /** Enable automatic form interaction tracking. Default: true */
     enableFormTracking?: boolean;
-    /** Habilitar heatmap de clicks (coordenadas X/Y). Default: false */
+    /** Enable click heatmap (X/Y coordinates). Default: false */
     enableHeatmap?: boolean;
-    /** Sufijo personalizado para eventos (ej: '_kin' para 'cta_click_kin'). Default: '' */
+    /** Custom event suffix (e.g., '_kin' produces 'cta_click_kin'). Default: '' */
     eventSuffix?: string;
 }
 /**
- * Estadísticas de reproducción de un video.
- * Compartido entre todos los adaptadores (Wistia, Voomly, HTML5).
+ * Video playback statistics.
+ * Shared across all adapters (Wistia, Voomly, HTML5).
  */
 interface VideoStats {
-    /** Tiempo total reproducido en segundos */
+    /** Total time watched in seconds */
     timeWatched: number;
-    /** Si el video fue completado (≥90-95%) */
+    /** Whether the video was completed (>=90-95%) */
     completed: boolean;
-    /** Timestamp de la última actualización */
+    /** Timestamp of the last stats update */
     lastUpdate: number;
 }
 /**
- * Opciones para los hooks de video en React.
+ * Options for React video tracking hooks.
  */
 interface UseVideoTrackingOptions {
-    /** ID único del video */
+    /** Unique video identifier */
     videoId: string;
-    /** Referencia al elemento <video> HTML (solo para HTML5) */
+    /** Reference to the HTML <video> element (HTML5 only) */
     videoElement?: HTMLVideoElement | null;
-    /** Callback cuando el video se completa */
+    /** Callback when the video completes */
     onComplete?: () => void;
-    /** Callback en milestones de progreso (25, 50, 75) */
+    /** Callback on progress milestones (25, 50, 75) */
     onProgress?: (percentage: number) => void;
 }
 declare global {
@@ -60,9 +60,9 @@ declare global {
 }
 
 /**
- * LandingTracker — Orquestador de sesión completa
- * Inicializa y gestiona scroll tracking, click heatmap, section dwell time,
- * form auto-tracking y sesión start/end.
+ * LandingTracker — Full session orchestrator.
+ * Initializes and manages scroll tracking, click heatmap, section dwell time,
+ * form auto-tracking, and session start/end.
  * Framework-agnostic.
  */
 
@@ -76,30 +76,30 @@ declare class LandingTracker {
     private observers;
     private listeners;
     /**
-     * Inicializa el tracking de la landing con la configuración dada.
+     * Initializes landing page tracking with the given configuration.
      */
     init(config: LandingTrackerConfig): void;
     /**
-     * Destruye el tracker y limpia todos los observers y listeners.
+     * Destroys the tracker and cleans up all observers and listeners.
      */
     destroy(): void;
-    /** Trackear click en un CTA */
+    /** Track a CTA click */
     trackCTAClick(buttonName: string, section: string, additionalData?: Record<string, unknown>): void;
-    /** Trackear conversión */
+    /** Track a conversion */
     trackConversion(type: string, value?: number, additionalData?: Record<string, unknown>): void;
-    /** Trackear click en FAQs */
+    /** Track FAQ expansion */
     trackFAQExpand(question: string, index: number): void;
-    /** Trackear click social */
+    /** Track social link click */
     trackSocialClick(platform: string, action: string): void;
-    /** Trackear click en imagen */
+    /** Track image click */
     trackImageClick(imageName: string, section: string): void;
-    /** Trackear scroll a sección */
+    /** Track scroll to a section */
     trackScrollTo(section: string): void;
-    /** Trackear share */
+    /** Track content share */
     trackShare(platform: string, content: string): void;
-    /** Trackear descarga */
+    /** Track file download */
     trackDownload(fileName: string, fileType: string): void;
-    /** Obtener datos de la sesión actual */
+    /** Get current session data */
     getSessionData(): {
         duration: number;
         clicks: number;
@@ -120,13 +120,13 @@ declare class LandingTracker {
 
 /**
  * React Hook: useLandingPageTracking
- * Inicializa el tracking completo de una landing page.
- * Wrapper React del LandingTracker framework-agnostic.
+ * Initializes full landing page tracking.
+ * React wrapper for the framework-agnostic LandingTracker.
  */
 
 /**
- * Hook para inicializar tracking completo de una landing page.
- * Crea un LandingTracker, lo inicializa y lo destruye al desmontar.
+ * Hook to initialize full landing page tracking.
+ * Creates a LandingTracker, initializes it, and destroys it on unmount.
  *
  * @example
  * ```tsx
@@ -137,8 +137,8 @@ declare class LandingTracker {
  *     gtmId: 'GTM-5GMQNFMN',
  *   })
  *
- *   // Usar tracker para eventos manuales
- *   const handleClick = () => tracker?.trackCTAClick('Unirse', 'hero')
+ *   // Use tracker for manual events
+ *   const handleClick = () => tracker?.trackCTAClick('Join', 'hero')
  * }
  * ```
  */
@@ -146,21 +146,21 @@ declare function useLandingPageTracking(config: LandingTrackerConfig): LandingTr
 
 /**
  * React Hooks: useVideoTracking, useWistiaVideoTracking
- * Hooks para integrar tracking de video en componentes React.
+ * Hooks for integrating video tracking in React components.
  */
 
 interface VideoTrackingReturn {
-    /** Porcentaje de progreso (0-100) */
+    /** Progress percentage (0-100) */
     progress: number;
-    /** Si el video se está reproduciendo */
+    /** Whether the video is currently playing */
     isPlaying: boolean;
-    /** Tiempo actual en segundos */
+    /** Current playback time in seconds */
     currentTime: number;
-    /** Duración total en segundos */
+    /** Total duration in seconds */
     duration: number;
 }
 /**
- * Hook para tracking de un elemento <video> HTML5 nativo.
+ * Hook for tracking a native HTML5 <video> element.
  *
  * @example
  * ```tsx
@@ -169,8 +169,8 @@ interface VideoTrackingReturn {
  *   const { progress, isPlaying } = useVideoTracking({
  *     videoId: 'hero-video',
  *     videoElement: videoRef.current,
- *     onComplete: () => console.log('Video completado'),
- *     onProgress: (pct) => console.log(`Progreso: ${pct}%`),
+ *     onComplete: () => console.log('Video completed'),
+ *     onProgress: (pct) => console.log(`Progress: ${pct}%`),
  *   })
  *
  *   return <video ref={videoRef} src="/video.mp4" />
@@ -179,20 +179,20 @@ interface VideoTrackingReturn {
  */
 declare function useVideoTracking({ videoId, videoElement, onComplete, onProgress }: UseVideoTrackingOptions): VideoTrackingReturn;
 interface WistiaTrackingReturn {
-    /** Estadísticas actuales del video */
+    /** Current video stats */
     stats: VideoStats;
-    /** Si el video fue completado */
+    /** Whether the video was completed */
     isCompleted: boolean;
 }
 /**
- * Hook para tracking de un video Wistia.
- * Sondea window._wq hasta que el SDK de Wistia esté listo.
+ * Hook for tracking a Wistia video.
+ * Polls window._wq until the Wistia SDK is ready.
  *
  * @example
  * ```tsx
  * function WistiaPlayer({ mediaId }: { mediaId: string }) {
  *   const { stats, isCompleted } = useWistiaVideoTracking(mediaId)
- *   return <div>Visto: {stats.timeWatched}s {isCompleted && '✅'}</div>
+ *   return <div>Watched: {stats.timeWatched}s {isCompleted && '✅'}</div>
  * }
  * ```
  */

package/dist/react/index.d.ts

@@ -1,51 +1,51 @@
 /**
- * Configuración del LandingTracker (orquestador de sesión).
+ * LandingTracker configuration (session orchestrator).
  */
 interface LandingTrackerConfig {
-    /** Ruta de la landing page (ej: '/kin', '/racha') */
+    /** Landing page path (e.g., '/kin', '/racha') */
     pagePath: string;
-    /** Nombre legible de la landing (ej: 'Kin Landing Page') */
+    /** Human-readable landing page name (e.g., 'Kin Landing Page') */
     pageName: string;
-    /** ID de Google Tag Manager (opcional) */
+    /** Google Tag Manager container ID (optional) */
     gtmId?: string;
-    /** Habilitar tracking de scroll (milestones 25/50/75/100%). Default: true */
+    /** Enable scroll tracking (milestones 25/50/75/100%). Default: true */
     enableScrollTracking?: boolean;
-    /** Habilitar tracking automático de clicks en CTAs. Default: true */
+    /** Enable automatic CTA click tracking. Default: true */
     enableCTATracking?: boolean;
-    /** Habilitar tracking de tiempo en página. Default: true */
+    /** Enable page dwell time tracking. Default: true */
     enableTimeTracking?: boolean;
-    /** Habilitar tracking de tiempo por sección (IntersectionObserver). Default: true */
+    /** Enable per-section dwell time via IntersectionObserver. Default: true */
     enableSectionTracking?: boolean;
-    /** Habilitar auto-tracking de formularios. Default: true */
+    /** Enable automatic form interaction tracking. Default: true */
     enableFormTracking?: boolean;
-    /** Habilitar heatmap de clicks (coordenadas X/Y). Default: false */
+    /** Enable click heatmap (X/Y coordinates). Default: false */
     enableHeatmap?: boolean;
-    /** Sufijo personalizado para eventos (ej: '_kin' para 'cta_click_kin'). Default: '' */
+    /** Custom event suffix (e.g., '_kin' produces 'cta_click_kin'). Default: '' */
     eventSuffix?: string;
 }
 /**
- * Estadísticas de reproducción de un video.
- * Compartido entre todos los adaptadores (Wistia, Voomly, HTML5).
+ * Video playback statistics.
+ * Shared across all adapters (Wistia, Voomly, HTML5).
  */
 interface VideoStats {
-    /** Tiempo total reproducido en segundos */
+    /** Total time watched in seconds */
     timeWatched: number;
-    /** Si el video fue completado (≥90-95%) */
+    /** Whether the video was completed (>=90-95%) */
     completed: boolean;
-    /** Timestamp de la última actualización */
+    /** Timestamp of the last stats update */
     lastUpdate: number;
 }
 /**
- * Opciones para los hooks de video en React.
+ * Options for React video tracking hooks.
  */
 interface UseVideoTrackingOptions {
-    /** ID único del video */
+    /** Unique video identifier */
     videoId: string;
-    /** Referencia al elemento <video> HTML (solo para HTML5) */
+    /** Reference to the HTML <video> element (HTML5 only) */
     videoElement?: HTMLVideoElement | null;
-    /** Callback cuando el video se completa */
+    /** Callback when the video completes */
     onComplete?: () => void;
-    /** Callback en milestones de progreso (25, 50, 75) */
+    /** Callback on progress milestones (25, 50, 75) */
     onProgress?: (percentage: number) => void;
 }
 declare global {
@@ -60,9 +60,9 @@ declare global {
 }
 
 /**
- * LandingTracker — Orquestador de sesión completa
- * Inicializa y gestiona scroll tracking, click heatmap, section dwell time,
- * form auto-tracking y sesión start/end.
+ * LandingTracker — Full session orchestrator.
+ * Initializes and manages scroll tracking, click heatmap, section dwell time,
+ * form auto-tracking, and session start/end.
  * Framework-agnostic.
  */
 
@@ -76,30 +76,30 @@ declare class LandingTracker {
     private observers;
     private listeners;
     /**
-     * Inicializa el tracking de la landing con la configuración dada.
+     * Initializes landing page tracking with the given configuration.
      */
     init(config: LandingTrackerConfig): void;
     /**
-     * Destruye el tracker y limpia todos los observers y listeners.
+     * Destroys the tracker and cleans up all observers and listeners.
      */
     destroy(): void;
-    /** Trackear click en un CTA */
+    /** Track a CTA click */
     trackCTAClick(buttonName: string, section: string, additionalData?: Record<string, unknown>): void;
-    /** Trackear conversión */
+    /** Track a conversion */
     trackConversion(type: string, value?: number, additionalData?: Record<string, unknown>): void;
-    /** Trackear click en FAQs */
+    /** Track FAQ expansion */
     trackFAQExpand(question: string, index: number): void;
-    /** Trackear click social */
+    /** Track social link click */
     trackSocialClick(platform: string, action: string): void;
-    /** Trackear click en imagen */
+    /** Track image click */
     trackImageClick(imageName: string, section: string): void;
-    /** Trackear scroll a sección */
+    /** Track scroll to a section */
     trackScrollTo(section: string): void;
-    /** Trackear share */
+    /** Track content share */
     trackShare(platform: string, content: string): void;
-    /** Trackear descarga */
+    /** Track file download */
     trackDownload(fileName: string, fileType: string): void;
-    /** Obtener datos de la sesión actual */
+    /** Get current session data */
     getSessionData(): {
         duration: number;
         clicks: number;
@@ -120,13 +120,13 @@ declare class LandingTracker {
 
 /**
  * React Hook: useLandingPageTracking
- * Inicializa el tracking completo de una landing page.
- * Wrapper React del LandingTracker framework-agnostic.
+ * Initializes full landing page tracking.
+ * React wrapper for the framework-agnostic LandingTracker.
  */
 
 /**
- * Hook para inicializar tracking completo de una landing page.
- * Crea un LandingTracker, lo inicializa y lo destruye al desmontar.
+ * Hook to initialize full landing page tracking.
+ * Creates a LandingTracker, initializes it, and destroys it on unmount.
  *
  * @example
  * ```tsx
@@ -137,8 +137,8 @@ declare class LandingTracker {
  *     gtmId: 'GTM-5GMQNFMN',
  *   })
  *
- *   // Usar tracker para eventos manuales
- *   const handleClick = () => tracker?.trackCTAClick('Unirse', 'hero')
+ *   // Use tracker for manual events
+ *   const handleClick = () => tracker?.trackCTAClick('Join', 'hero')
  * }
  * ```
  */
@@ -146,21 +146,21 @@ declare function useLandingPageTracking(config: LandingTrackerConfig): LandingTr
 
 /**
  * React Hooks: useVideoTracking, useWistiaVideoTracking
- * Hooks para integrar tracking de video en componentes React.
+ * Hooks for integrating video tracking in React components.
  */
 
 interface VideoTrackingReturn {
-    /** Porcentaje de progreso (0-100) */
+    /** Progress percentage (0-100) */
     progress: number;
-    /** Si el video se está reproduciendo */
+    /** Whether the video is currently playing */
     isPlaying: boolean;
-    /** Tiempo actual en segundos */
+    /** Current playback time in seconds */
     currentTime: number;
-    /** Duración total en segundos */
+    /** Total duration in seconds */
     duration: number;
 }
 /**
- * Hook para tracking de un elemento <video> HTML5 nativo.
+ * Hook for tracking a native HTML5 <video> element.
  *
  * @example
  * ```tsx
@@ -169,8 +169,8 @@ interface VideoTrackingReturn {
  *   const { progress, isPlaying } = useVideoTracking({
  *     videoId: 'hero-video',
  *     videoElement: videoRef.current,
- *     onComplete: () => console.log('Video completado'),
- *     onProgress: (pct) => console.log(`Progreso: ${pct}%`),
+ *     onComplete: () => console.log('Video completed'),
+ *     onProgress: (pct) => console.log(`Progress: ${pct}%`),
  *   })
  *
  *   return <video ref={videoRef} src="/video.mp4" />
@@ -179,20 +179,20 @@ interface VideoTrackingReturn {
  */
 declare function useVideoTracking({ videoId, videoElement, onComplete, onProgress }: UseVideoTrackingOptions): VideoTrackingReturn;
 interface WistiaTrackingReturn {
-    /** Estadísticas actuales del video */
+    /** Current video stats */
     stats: VideoStats;
-    /** Si el video fue completado */
+    /** Whether the video was completed */
     isCompleted: boolean;
 }
 /**
- * Hook para tracking de un video Wistia.
- * Sondea window._wq hasta que el SDK de Wistia esté listo.
+ * Hook for tracking a Wistia video.
+ * Polls window._wq until the Wistia SDK is ready.
  *
  * @example
  * ```tsx
  * function WistiaPlayer({ mediaId }: { mediaId: string }) {
  *   const { stats, isCompleted } = useWistiaVideoTracking(mediaId)
- *   return <div>Visto: {stats.timeWatched}s {isCompleted && '✅'}</div>
+ *   return <div>Watched: {stats.timeWatched}s {isCompleted && '✅'}</div>
  * }
  * ```
  */

package/dist/react/index.js

@@ -221,7 +221,7 @@ var LandingTracker = class {
     this.listeners = [];
   }
   /**
-   * Inicializa el tracking de la landing con la configuración dada.
+   * Initializes landing page tracking with the given configuration.
    */
   init(config) {
     if (typeof window === "undefined") return;
@@ -257,7 +257,7 @@ var LandingTracker = class {
     this.trackSessionStart();
   }
   /**
-   * Destruye el tracker y limpia todos los observers y listeners.
+   * Destroys the tracker and cleans up all observers and listeners.
    */
   destroy() {
     this.observers.forEach((obs) => obs.disconnect());
@@ -273,43 +273,43 @@ var LandingTracker = class {
     this.sectionTimers.clear();
   }
   // ====================================
-  // MÉTODOS PÚBLICOS DE TRACKING
+  // PUBLIC TRACKING METHODS
   // ====================================
-  /** Trackear click en un CTA */
+  /** Track a CTA click */
   trackCTAClick(buttonName, section, additionalData) {
     trackCTAClick(buttonName, section, additionalData);
     this.pushGTMEvent("cta_click", { button_text: buttonName, section });
   }
-  /** Trackear conversión */
+  /** Track a conversion */
   trackConversion(type, value, additionalData) {
     trackEvent("Conversion", type, void 0, value, additionalData);
     this.pushGTMEvent("conversion", { conversion_type: type, value });
   }
-  /** Trackear click en FAQs */
+  /** Track FAQ expansion */
   trackFAQExpand(question, index) {
     trackEvent("FAQ", "expand", question, index);
   }
-  /** Trackear click social */
+  /** Track social link click */
   trackSocialClick(platform, action) {
     trackEvent("Social", "click", platform, void 0, { social_action: action });
   }
-  /** Trackear click en imagen */
+  /** Track image click */
   trackImageClick(imageName, section) {
     trackEvent("Engagement", "image_click", imageName, void 0, { section });
   }
-  /** Trackear scroll a sección */
+  /** Track scroll to a section */
   trackScrollTo(section) {
     trackEvent("Navigation", "scroll_to", section);
   }
-  /** Trackear share */
+  /** Track content share */
   trackShare(platform, content) {
     trackEvent("Share", "click", platform, void 0, { share_content: content });
   }
-  /** Trackear descarga */
+  /** Track file download */
   trackDownload(fileName, fileType) {
     trackEvent("Download", "click", fileName, void 0, { file_type: fileType });
   }
-  /** Obtener datos de la sesión actual */
+  /** Get current session data */
   getSessionData() {
     return {
       duration: Math.round((Date.now() - this.sessionStartTime) / 1e3),
@@ -318,7 +318,7 @@ var LandingTracker = class {
     };
   }
   // ====================================
-  // MÉTODOS PRIVADOS
+  // PRIVATE METHODS
   // ====================================
   captureInitialData() {
     const utmParams = captureUTMParams();
@@ -516,7 +516,7 @@ var VideoTracker = class {
     this.watchTimeIntervals = /* @__PURE__ */ new Map();
   }
   /**
-   * Inicializa el tracking para un video.
+   * Initializes tracking for a video.
    */
   initVideo(videoId) {
     if (this.videos.has(videoId)) return;
@@ -544,7 +544,7 @@ var VideoTracker = class {
     });
   }
   /**
-   * Tracking de evento play.
+   * Tracks a play event.
    */
   trackPlay(videoId, currentTime = 0) {
     const state = this.getOrCreateState(videoId);
@@ -560,7 +560,7 @@ var VideoTracker = class {
     });
   }
   /**
-   * Tracking de evento pause.
+   * Tracks a pause event.
    */
   trackPause(videoId, currentTime, duration) {
     const state = this.getOrCreateState(videoId);
@@ -582,7 +582,7 @@ var VideoTracker = class {
     });
   }
   /**
-   * Tracking de evento seek (saltar en el timeline).
+   * Tracks a seek event (timeline jump).
    */
   trackSeek(videoId, fromTime, toTime) {
     const state = this.getOrCreateState(videoId);
@@ -597,7 +597,7 @@ var VideoTracker = class {
     });
   }
   /**
-   * Tracking de progreso (milestones: 25%, 50%, 75%).
+   * Tracks progress milestones (25%, 50%, 75%).
    */
   trackProgress(videoId, percentage, currentTime) {
     const state = this.getOrCreateState(videoId);
@@ -613,7 +613,7 @@ var VideoTracker = class {
     }
   }
   /**
-   * Tracking de completación del video (≥95%).
+   * Tracks video completion (>=95%).
    */
   trackComplete(videoId, totalDuration) {
     const state = this.getOrCreateState(videoId);
@@ -630,7 +630,7 @@ var VideoTracker = class {
     });
   }
   /**
-   * Tracking de fin del video (evento ended nativo).
+   * Tracks video end (native ended event).
    */
   trackEnd(videoId) {
     const state = this.getOrCreateState(videoId);
@@ -643,7 +643,7 @@ var VideoTracker = class {
     });
   }
   /**
-   * Tracking de cambio de velocidad de reproducción.
+   * Tracks playback speed change.
    */
   trackSpeedChange(videoId, speed) {
     const state = this.getOrCreateState(videoId);
@@ -654,7 +654,7 @@ var VideoTracker = class {
     });
   }
   /**
-   * Tracking de pantalla completa.
+   * Tracks fullscreen toggle.
    */
   trackFullscreen(videoId, isFullscreen) {
     trackEvent("Video", isFullscreen ? "fullscreen_enter" : "fullscreen_exit", videoId, void 0, {
@@ -663,7 +663,7 @@ var VideoTracker = class {
     });
   }
   /**
-   * Tracking de no interacción (el usuario está en la página pero no interactúa con el video).
+   * Tracks no interaction (user is on the page but not interacting with the video).
    */
   trackNoInteraction(videoId, timeOnPage) {
     trackEvent("Video", "no_interaction", videoId, void 0, {
@@ -672,20 +672,20 @@ var VideoTracker = class {
     });
   }
   /**
-   * Obtiene el estado actual de un video.
+   * Returns the current state of a video.
    */
   getState(videoId) {
     return this.videos.get(videoId);
   }
   /**
-   * Limpia el tracking de un video específico.
+   * Cleans up tracking for a specific video.
    */
   cleanup(videoId) {
     this.stopWatchTimeTracking(videoId);
     this.videos.delete(videoId);
   }
   /**
-   * Limpia todo el tracking.
+   * Cleans up all video tracking.
    */
   cleanupAll() {
     for (const videoId of this.videos.keys()) {
@@ -693,7 +693,7 @@ var VideoTracker = class {
     }
     this.videos.clear();
   }
-  // --- Métodos privados ---
+  // --- Private methods ---
   getOrCreateState(videoId) {
     if (!this.videos.has(videoId)) {
       this.initVideo(videoId);