@magicfeedback/popup-sdk 1.11.0 → 1.12.0

package/dist/react-native.d.mts

@@ -571,8 +571,15 @@ declare class DeepdotsPopups {
      */
     private closeSession;
     /**
-     * Abre sesión (`session_start`) si no hay una abierta y el tracking está activo. Idempotente:
-     * se llama en init(), al volver a foreground y al conceder el consentimiento.
+     * Abre sesión (`session_start`) si no hay una abierta y el tracking está activo. Idempotente.
+     * El `reason` dice por qué empieza (ver `SessionStartReason`):
+     *  - `cold_start`: init() (carga de la página / arranque de la app RN).
+     *  - `foreground`: onForeground() tras un cierre (RN).
+     *  - `tracking_enabled`: setTrackingEnabled(true).
+     *  - `user_change`: setUserId() o init() con otro userId.
+     *  - `idle_timeout`: la pestaña vuelve a verse tras más de 30 min oculta.
+     *  - `bfcache_restore`: vuelta desde la bfcache fuera de la ventana de reanudación.
+     * Si hay una sesión suspendida a tiempo emite `deepdots_session_resume` en su lugar, sin reason.
      */
     private openSession;
     /** Web: si la pestaña se ve. Sin `document` (RN) manda AppState vía onForeground/onBackground. */

package/dist/react-native.d.ts

@@ -571,8 +571,15 @@ declare class DeepdotsPopups {
      */
     private closeSession;
     /**
-     * Abre sesión (`session_start`) si no hay una abierta y el tracking está activo. Idempotente:
-     * se llama en init(), al volver a foreground y al conceder el consentimiento.
+     * Abre sesión (`session_start`) si no hay una abierta y el tracking está activo. Idempotente.
+     * El `reason` dice por qué empieza (ver `SessionStartReason`):
+     *  - `cold_start`: init() (carga de la página / arranque de la app RN).
+     *  - `foreground`: onForeground() tras un cierre (RN).
+     *  - `tracking_enabled`: setTrackingEnabled(true).
+     *  - `user_change`: setUserId() o init() con otro userId.
+     *  - `idle_timeout`: la pestaña vuelve a verse tras más de 30 min oculta.
+     *  - `bfcache_restore`: vuelta desde la bfcache fuera de la ventana de reanudación.
+     * Si hay una sesión suspendida a tiempo emite `deepdots_session_resume` en su lugar, sin reason.
      */
     private openSession;
     /** Web: si la pestaña se ve. Sin `document` (RN) manda AppState vía onForeground/onBackground. */

package/dist/react-native.js

@@ -5712,7 +5712,7 @@ var DeepdotsPopups = class {
     this.navObserver.install();
     this.engagement = new EngagementTracker();
     this.setupAnalyticsFlush();
-    this.openSession();
+    this.openSession("cold_start");
     if (resumable && this.analyticsFeedbackSessionId === resumable.sessionId) {
       this.notifyFeedbackSession(resumable.sessionId, "open");
     }
@@ -5770,7 +5770,7 @@ var DeepdotsPopups = class {
   setTrackingEnabled(enabled) {
     if (!enabled) this.closeSession("tracking_disabled");
     this.tracking?.setTrackingEnabled(enabled);
-    if (enabled) this.openSession();
+    if (enabled) this.openSession("tracking_enabled");
     if (enabled) this.resolveGeo();
     this.log("tracking \xB7 setTrackingEnabled:", enabled, "\xB7 session_id:", this.tracking?.getSessionId() ?? null);
   }
@@ -5887,7 +5887,7 @@ var DeepdotsPopups = class {
   /** App a foreground (RN: AppState 'active'): reanuda el engagement time y abre sesión nueva. */
   onForeground() {
     this.engagement?.resume();
-    this.openSession();
+    this.openSession("foreground");
   }
   /**
    * App a background (RN: AppState 'background'): FIN DE SESIÓN. Cierra pantalla actual
@@ -5935,7 +5935,7 @@ var DeepdotsPopups = class {
     this.answeredSurveys.clear();
     clearPopupState(storage);
     this.log("tracking \xB7 user_change \xB7 user_id:", this.tracking.getUserId());
-    this.openSession();
+    this.openSession("user_change");
   }
   /**
    * Cierra la sesión actual: vuelca todo lo que quedaba abierto y envía el último lote
@@ -5961,17 +5961,24 @@ var DeepdotsPopups = class {
     this.log("tracking \xB7 session_end:", reason);
   }
   /**
-   * Abre sesión (`session_start`) si no hay una abierta y el tracking está activo. Idempotente:
-   * se llama en init(), al volver a foreground y al conceder el consentimiento.
+   * Abre sesión (`session_start`) si no hay una abierta y el tracking está activo. Idempotente.
+   * El `reason` dice por qué empieza (ver `SessionStartReason`):
+   *  - `cold_start`: init() (carga de la página / arranque de la app RN).
+   *  - `foreground`: onForeground() tras un cierre (RN).
+   *  - `tracking_enabled`: setTrackingEnabled(true).
+   *  - `user_change`: setUserId() o init() con otro userId.
+   *  - `idle_timeout`: la pestaña vuelve a verse tras más de 30 min oculta.
+   *  - `bfcache_restore`: vuelta desde la bfcache fuera de la ventana de reanudación.
+   * Si hay una sesión suspendida a tiempo emite `deepdots_session_resume` en su lugar, sin reason.
    */
-  openSession() {
+  openSession(reason) {
     if (this.sessionOpen) return;
     if (!this.tracking?.isTrackingEnabled()) return;
     const suspendedMs = this.takeSuspendedSession();
     this.sessionOpen = true;
     this.lastEngagementAt = Date.now();
     if (suspendedMs === null) {
-      this.track("deepdots_session_start", {});
+      this.track("deepdots_session_start", { reason });
     } else {
       this.track("deepdots_session_resume", { suspended_ms: suspendedMs });
       this.log("tracking \xB7 session resumed after", suspendedMs, "ms:", this.analyticsFeedbackSessionId);
@@ -6038,7 +6045,7 @@ var DeepdotsPopups = class {
     } else {
       this.discardSession();
     }
-    this.openSession();
+    this.openSession("idle_timeout");
   }
   /**
    * `pagehide` en web: SUSPENDE la sesión en vez de cerrarla, porque el navegador lo lanza
@@ -6162,7 +6169,7 @@ var DeepdotsPopups = class {
     window.addEventListener("pageshow", (event) => {
       if (!event.persisted) return;
       this.startAnalyticsFlushTimer();
-      this.openSession();
+      this.openSession("bfcache_restore");
     });
     document.addEventListener("visibilitychange", () => {
       if (document.visibilityState === "hidden") {