@magicfeedback/popup-sdk 1.12.0 → 1.13.0

package/dist/index.d.mts

@@ -929,7 +929,20 @@ declare class DeepdotsPopups {
         final?: boolean;
         sessionEnd?: boolean;
     }): void;
-    /** Emite un evento `user_engagement` con el tiempo activo acumulado (#8). */
+    /**
+     * Emite un evento `user_engagement` con el tiempo activo acumulado (#8) y la pantalla en
+     * curso: `screen` y `path` (los mismos que llevará su `page_view`) y `screen_seconds` (lo
+     * que lleva en ella, medido como el `duration_seconds` del `page_view`).
+     *
+     * El `page_view` sale al SALIR de la pantalla; si el cierre no llega nunca (pestaña dormida
+     * y descartada al volver, pestaña o app matada en segundo plano), la última pantalla de la
+     * sesión se perdía y una visita de una sola pantalla se quedaba sin ninguna. Con la pantalla
+     * en el latido y en el engagement de ocultar la pestaña, el backend la reconstruye.
+     *
+     * En los cierres (`closeSession`, `suspendSession`) el observador ya emitió el `page_view`
+     * y no tiene pantalla, así que ese engagement va sin `screen`: nunca se cuenta dos veces.
+     * Tampoco se emite un `page_view` aquí, por lo mismo.
+     */
     private flushEngagement;
     /** Tick del flush periódico: latido de engagement si toca, y envío de lo acumulado. */
     private onAnalyticsFlushTick;

package/dist/index.d.ts

@@ -929,7 +929,20 @@ declare class DeepdotsPopups {
         final?: boolean;
         sessionEnd?: boolean;
     }): void;
-    /** Emite un evento `user_engagement` con el tiempo activo acumulado (#8). */
+    /**
+     * Emite un evento `user_engagement` con el tiempo activo acumulado (#8) y la pantalla en
+     * curso: `screen` y `path` (los mismos que llevará su `page_view`) y `screen_seconds` (lo
+     * que lleva en ella, medido como el `duration_seconds` del `page_view`).
+     *
+     * El `page_view` sale al SALIR de la pantalla; si el cierre no llega nunca (pestaña dormida
+     * y descartada al volver, pestaña o app matada en segundo plano), la última pantalla de la
+     * sesión se perdía y una visita de una sola pantalla se quedaba sin ninguna. Con la pantalla
+     * en el latido y en el engagement de ocultar la pestaña, el backend la reconstruye.
+     *
+     * En los cierres (`closeSession`, `suspendSession`) el observador ya emitió el `page_view`
+     * y no tiene pantalla, así que ese engagement va sin `screen`: nunca se cuenta dos veces.
+     * Tampoco se emite un `page_view` aquí, por lo mismo.
+     */
     private flushEngagement;
     /** Tick del flush periódico: latido de engagement si toca, y envío de lo acumulado. */
     private onAnalyticsFlushTick;

package/dist/index.js

@@ -7739,6 +7739,23 @@ var NavigationObserver = class {
     if (!this.installed || this.currentScreen != null || typeof window === "undefined") return;
     this.begin(window.location.href);
   }
+  /**
+   * La pantalla en curso, sin cerrarla ni emitir nada; null si no hay (antes de `begin`, tras
+   * `stop`/`discard`). Para que el `user_engagement` lleve la pantalla: si el cierre de la
+   * sesión no llega nunca (pestaña dormida y descartada, app matada), la última pantalla no
+   * tiene `page_view` y solo queda esto.
+   */
+  current() {
+    if (this.currentScreen == null) return null;
+    return {
+      screen: this.currentScreen,
+      path: this.currentPath ?? this.currentScreen,
+      seconds: this.secondsSinceEntry(this.now())
+    };
+  }
+  secondsSinceEntry(at) {
+    return Math.max(0, Math.round((at - this.entryAt) / 1e3));
+  }
   closeCurrent() {
     if (this.currentScreen == null) return;
     const exit = this.now();
@@ -7747,7 +7764,7 @@ var NavigationObserver = class {
       path: this.currentPath ?? this.currentScreen,
       entry: this.entryAt,
       exit,
-      durationSeconds: Math.max(0, Math.round((exit - this.entryAt) / 1e3))
+      durationSeconds: this.secondsSinceEntry(exit)
     };
     this.listeners.forEach((l) => {
       try {
@@ -8768,12 +8785,29 @@ var DeepdotsPopups = class {
     if (!this.tracking?.isTrackingEnabled()) return;
     this.analytics?.flush(this.analyticsIdentity(), options);
   }
-  /** Emite un evento `user_engagement` con el tiempo activo acumulado (#8). */
+  /**
+   * Emite un evento `user_engagement` con el tiempo activo acumulado (#8) y la pantalla en
+   * curso: `screen` y `path` (los mismos que llevará su `page_view`) y `screen_seconds` (lo
+   * que lleva en ella, medido como el `duration_seconds` del `page_view`).
+   *
+   * El `page_view` sale al SALIR de la pantalla; si el cierre no llega nunca (pestaña dormida
+   * y descartada al volver, pestaña o app matada en segundo plano), la última pantalla de la
+   * sesión se perdía y una visita de una sola pantalla se quedaba sin ninguna. Con la pantalla
+   * en el latido y en el engagement de ocultar la pestaña, el backend la reconstruye.
+   *
+   * En los cierres (`closeSession`, `suspendSession`) el observador ya emitió el `page_view`
+   * y no tiene pantalla, así que ese engagement va sin `screen`: nunca se cuenta dos veces.
+   * Tampoco se emite un `page_view` aquí, por lo mismo.
+   */
   flushEngagement() {
     if (!this.tracking?.isTrackingEnabled()) return;
     const ms = this.engagement?.consume() ?? 0;
     if (ms > 0) {
-      this.track("deepdots_user_engagement", { engagement_time_msec: ms });
+      const current = this.navObserver?.current();
+      this.track("deepdots_user_engagement", {
+        engagement_time_msec: ms,
+        ...current ? { screen: current.screen, path: current.path, screen_seconds: current.seconds } : {}
+      });
       this.lastEngagementAt = Date.now();
     }
   }