@metodokorexmk/tracking 1.1.0 → 1.2.0

package/dist/index.cjs

@@ -259,7 +259,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;
@@ -287,7 +287,7 @@ var VideoTracker = class {
     });
   }
   /**
-   * Tracking de evento play.
+   * Tracks a play event.
    */
   trackPlay(videoId, currentTime = 0) {
     const state = this.getOrCreateState(videoId);
@@ -303,7 +303,7 @@ var VideoTracker = class {
     });
   }
   /**
-   * Tracking de evento pause.
+   * Tracks a pause event.
    */
   trackPause(videoId, currentTime, duration) {
     const state = this.getOrCreateState(videoId);
@@ -325,7 +325,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);
@@ -340,7 +340,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);
@@ -356,7 +356,7 @@ var VideoTracker = class {
     }
   }
   /**
-   * Tracking de completación del video (≥95%).
+   * Tracks video completion (>=95%).
    */
   trackComplete(videoId, totalDuration) {
     const state = this.getOrCreateState(videoId);
@@ -373,7 +373,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);
@@ -386,7 +386,7 @@ var VideoTracker = class {
     });
   }
   /**
-   * Tracking de cambio de velocidad de reproducción.
+   * Tracks playback speed change.
    */
   trackSpeedChange(videoId, speed) {
     const state = this.getOrCreateState(videoId);
@@ -397,7 +397,7 @@ var VideoTracker = class {
     });
   }
   /**
-   * Tracking de pantalla completa.
+   * Tracks fullscreen toggle.
    */
   trackFullscreen(videoId, isFullscreen) {
     trackEvent("Video", isFullscreen ? "fullscreen_enter" : "fullscreen_exit", videoId, void 0, {
@@ -406,7 +406,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, {
@@ -415,20 +415,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()) {
@@ -436,7 +436,7 @@ var VideoTracker = class {
     }
     this.videos.clear();
   }
-  // --- Métodos privados ---
+  // --- Private methods ---
   getOrCreateState(videoId) {
     if (!this.videos.has(videoId)) {
       this.initVideo(videoId);
@@ -884,7 +884,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;
@@ -920,7 +920,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());
@@ -936,43 +936,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),
@@ -981,7 +981,7 @@ var LandingTracker = class {
     };
   }
   // ====================================
-  // MÉTODOS PRIVADOS
+  // PRIVATE METHODS
   // ====================================
   captureInitialData() {
     const utmParams = captureUTMParams();
@@ -1169,7 +1169,7 @@ var initTrackingAPI = (config) => {
 };
 var getAPIConfig = () => {
   if (!apiConfig) {
-    throw new Error("[@metodokorexmk/tracking] initTrackingAPI() debe llamarse antes de usar funciones de persistencia.");
+    throw new Error("[@metodokorexmk/tracking] initTrackingAPI() must be called before using persistence functions.");
   }
   return apiConfig;
 };
@@ -1316,14 +1316,18 @@ var buildTrackingRequestBody = (params, formData, origin, options) => {
   if (origin.hasCampaign) {
     if (collaboratorId) body.userId = collaboratorId;
     if (params.idCampana) body.idCampana = params.idCampana;
-    if (params.adsetId) body.adsetId = params.adsetId;
-    if (params.adId) body.adId = params.adId;
     if (params.utmContent) body.utmContent = params.utmContent;
     if (params.fbclid) body.fbclid = params.fbclid;
   } else if (collaboratorId) {
     body.referringUserId = collaboratorId;
     body.referring_user_id = collaboratorId;
   }
+  if (params.adsetId) body.adsetId = params.adsetId;
+  if (params.adId) body.adId = params.adId;
+  if (params.utmSource) body.utmSource = params.utmSource;
+  if (params.utmMedium) body.utmMedium = params.utmMedium;
+  if (params.utmCampaign) body.utmCampaign = params.utmCampaign;
+  if (params.leadCampaign) body.leadCampaign = params.leadCampaign;
   if (params.pipelineId) {
     const parsed = parseInt(params.pipelineId, 10);
     if (!isNaN(parsed)) body.pipeline_id = parsed;
@@ -1422,7 +1426,7 @@ var DwellTimeTracker = class {
     this.boundVisibilityChange = this.handleVisibilityChange.bind(this);
   }
   /**
-   * Inicia el tracking del tiempo de permanencia.
+   * Starts dwell time tracking.
    */
   start(config) {
     if (typeof window === "undefined") return;
@@ -1459,7 +1463,7 @@ var DwellTimeTracker = class {
     this.retryPendingUpdates();
   }
   /**
-   * Detiene el tracking y envía el tiempo acumulado.
+   * Stops tracking and sends accumulated time.
    */
   stop() {
     if (this.startTime) {
@@ -1474,7 +1478,7 @@ var DwellTimeTracker = class {
     this.cleanup();
   }
   /**
-   * Obtiene el tiempo transcurrido en segundos (restando tiempo pausado).
+   * Returns elapsed time in seconds (excluding paused time).
    */
   getElapsedTime() {
     if (!this.startTime) return 0;
@@ -1486,8 +1490,8 @@ var DwellTimeTracker = class {
     return Math.max(0, totalTime - currentPauseTime);
   }
   /**
-   * Actualiza manualmente el tiempo del video.
-   * Llamar desde el VideoTracker u otros adaptadores.
+   * Manually updates video time.
+   * Called from VideoTracker or other adapters.
    */
   updateVideoTime(videoTimeWatched, videoCompleted = false) {
     const hasNewTime = videoTimeWatched > this.videoTimeWatched;
@@ -1501,7 +1505,7 @@ var DwellTimeTracker = class {
     }
   }
   /**
-   * Actualiza el trackingDataId (útil cuando se obtiene después del registro).
+   * Updates the trackingDataId (useful when obtained after registration).
    */
   updateTrackingId(trackingDataId) {
     if (!trackingDataId || typeof trackingDataId === "string" && trackingDataId.trim() === "") return;
@@ -1524,7 +1528,7 @@ var DwellTimeTracker = class {
     }
   }
   /**
-   * Limpia todos los listeners y timers.
+   * Cleans up all listeners and timers.
    */
   destroy() {
     this.stop();
@@ -1584,7 +1588,7 @@ var DwellTimeTracker = class {
       const isNetworkError = err.name === "AbortError" || err.name === "TimeoutError" || err.name === "TypeError" && err.message?.includes("Failed to fetch");
       if (token) this.savePendingUpdate(elapsedTime);
       if (this.onError && !isNetworkError) {
-        this.onError(error instanceof Error ? error : new Error("Error desconocido"));
+        this.onError(error instanceof Error ? error : new Error("Unknown error"));
       }
     } finally {
       this.isSending = false;