@magicfeedback/popup-sdk 1.16.1 → 1.17.0

package/dist/index.d.mts

@@ -124,9 +124,9 @@ type AnalyticsSink = (payload: AnalyticsEnvelope, meta?: AnalyticsFlushMeta) =>
  *
  * La analítica se envía como un Feedback del modelo del Surveys SDK, agrupado por una
  * INTEGRACIÓN creada en la plataforma. Se manda en streaming con `completed:false`; el
- * backend cose por `sessionId` + `user_id`. El ÚLTIMO lote de una sesión (cierre de página,
- * app a background, cambio de usuario) va con `completed:true`: cierra el registro y el
- * siguiente lote omite el `sessionId` viejo para que el backend abra uno nuevo.
+ * backend agrupa los lotes por `sessionId`, que genera el SDK al abrir cada sesión. El
+ * ÚLTIMO lote de una sesión (cierre de página, app a background, cambio de usuario) va con
+ * `completed:true`: cierra el registro y el lote siguiente abre otro con un sessionId nuevo.
  * `feedback.finished` se queda siempre en `false` (no es la señal de cierre acordada).
  *
  * Encoding:
@@ -160,14 +160,14 @@ interface AnalyticsFeedbackBody {
     integration: string;
     completed: boolean;
     finished?: boolean;
-    /** sessionId devuelto por el primer POST; permite que el backend agrupe todos los eventos en un solo registro. */
+    /** sessionId de la sesión (lo genera el SDK): el backend agrupa todos sus lotes en un solo registro. */
     sessionId?: string;
 }
 interface BuildBodyOptions {
     /**
      * `true` en el último lote de la sesión → `completed:true` (cierra el registro en backend).
-     * El body SÍ lleva el `sessionId` actual (es el registro que se cierra); es el lote
-     * SIGUIENTE el que lo omite.
+     * El body lleva el `sessionId` de la sesión que se cierra; el lote siguiente abre otro
+     * registro con un sessionId nuevo.
      */
     sessionEnd?: boolean;
 }
@@ -193,32 +193,49 @@ interface FeedbackSinkOptions {
      * `pagehide` y reanudada tras recargar la página (ver `suspended-session.ts`).
      */
     initialSessionId?: string;
-    /** Callback invocado cuando el backend devuelve un nuevo sessionId (primer POST). */
+    /**
+     * Genera el sessionId de cada sesión (default: UUID v4). Inyectable para tests.
+     */
+    newSessionId?: () => string;
+    /**
+     * Persistencia de los lotes pendientes (React Native: MMKV). Con él, el lote de cierre se
+     * guarda antes de enviarse y cualquier lote que falle sobrevive a que la app muera: el sink
+     * del arranque siguiente lo reenvía a su registro. Sin él, los pendientes viven en memoria.
+     */
+    storage?: KeyValueStorage;
+    /** Reloj inyectable (tests). */
+    now?: () => number;
+    /** Callback invocado cuando la API acepta el primer lote de una sesión (registro abierto). */
     onSessionId?: (id: string) => void;
     /** Callback invocado al cerrar la sesión (`completed:true`): el sessionId cacheado se olvida. */
     onSessionReset?: () => void;
     /**
      * Callback invocado cuando el backend acepta el lote de cierre, con el sessionId del
-     * registro cerrado: el que llevaba el lote o, en una sesión de un solo lote, el que
-     * devuelve la respuesta. Ese registro se convierte en Feedback en segundos.
+     * registro cerrado. Ese registro se convierte en Feedback en segundos.
      */
     onSessionClosed?: (id: string) => void;
 }
 /**
  * Sink real: transforma el envelope y hace `POST {baseUrl}/sdk/feedback`.
  *
- * Stateful: cachea el `sessionId` que devuelve el backend en la primera respuesta y lo
- * envía en los siguientes POSTs para que el backend agrupe todos los eventos en un único
- * registro de feedback.
+ * El `sessionId` de cada sesión lo genera el SDK (UUID) y va en TODOS sus lotes, desde el
+ * primero. La API guarda cada lote bajo el sessionId que recibe, así que una sesión es un
+ * registro aunque no llegue ninguna respuesta. Antes lo asignaba la API en la respuesta del
+ * primer POST: si esa respuesta se perdía (la app pasaba a background con el POST en vuelo),
+ * el resto de la sesión acababa en otro registro.
  *
  * Garantías de entrega:
- *  - mientras no se conozca el `sessionId`, los lotes se **serializan** (esperan la primera
- *    respuesta): dos POSTs a la vez sin `sessionId` crearían dos registros y partirían los datos;
+ *  - un lote que falla de forma transitoria (red, 5xx, 408, 429, sin respuesta en
+ *    POST_TIMEOUT_MS) se guarda TAL CUAL —con su sessionId y su `completed`— y se reenvía
+ *    antes del lote siguiente. Nunca vuelve al buffer del manager: allí se mezclaba con la
+ *    sesión siguiente y viajaba con su registro. La promesa del sink no rechaza;
+ *  - con `storage` (React Native) los pendientes sobreviven a que la app muera: el lote de
+ *    cierre se guarda ANTES de enviarse y el sink del arranque siguiente lo reenvía. La API
+ *    descarta los eventos repetidos de una misma sesión al ensamblarla;
  *  - `keepalive` para que el navegador no cancele el POST al navegar fuera ni al cerrar la
- *    página, también en el flush final (sin `sendBeacon`: ver `sendBeaconImpl`);
+ *    página (sin `sendBeacon`: ver `sendBeaconImpl`);
  *  - sin credenciales, que es lo único que pasa el CORS de la API (`Allow-Origin: *`);
- *  - la promesa **rechaza** en fallo transitorio (red, 5xx, 408, 429) para que el
- *    `AnalyticsManager` re-encole el lote; un 4xx se loguea y se descarta.
+ *  - un 4xx se loguea y se descarta.
  */
 declare function createFeedbackSink(options: FeedbackSinkOptions): AnalyticsSink;
 
@@ -657,6 +674,10 @@ declare function crashRecordToParams(r: CrashRecord): Record<string, unknown>;
 declare class CrashReporter {
     private options;
     private now;
+    /** Los handlers de `window` ya están puestos: `install()` es idempotente. */
+    private windowInstalled;
+    /** ErrorUtils ya enganchados: engancharlos dos veces capturaría cada error dos veces. */
+    private hookedErrorUtils;
     constructor(options: CrashReporterOptions);
     private isEnabled;
     /** Construye un CrashRecord capturando contexto en el momento del crash. */
@@ -669,9 +690,9 @@ declare class CrashReporter {
     private persist;
     /** Lee y vacía la cola de crashes pendientes (llamado en init para el replay). */
     drainPendingCrashes(): CrashRecord[];
-    /** Instala los handlers globales de errores no capturados (no-op sin `window`). */
+    /** Instala los handlers globales de errores no capturados (no-op sin `window`). Idempotente. */
     install(): void;
-    /** Engancha `global.ErrorUtils` de RN (no hay `window`): persiste y encadena al handler previo. */
+    /** Engancha `global.ErrorUtils` de RN (no hay `window`): persiste y encadena al handler previo. Idempotente por instancia de ErrorUtils. */
     installReactNative(errorUtils: ReactNativeErrorUtils): void;
     /** @internal Test seam: ejercita el camino de persistencia (window handlers no son testeables en vitest). */
     _persistForTest(error: unknown): void;
@@ -784,6 +805,8 @@ declare class DeepdotsPopups {
     private analyticsFlushTimer;
     /** Crash & error reporting (#14–17). Null hasta init(). */
     private crashReporter;
+    /** ErrorUtils de RN recibido del host (o del Provider); se engancha en cuanto haya consentimiento. */
+    private rnErrorUtils;
     /** Protecciones del funnel de Messaging (#18–22). Vigencia de sesión: se reinicia en init(). */
     private messageGuard;
     /** Observador de navegación (Fase 2): emite page_view por el canal de analytics. */
@@ -852,8 +875,18 @@ declare class DeepdotsPopups {
     setMetric(key: string, value: string | number | boolean): void;
     /** Reporta un error del host (manejado o no) → evento `deepdots_app_crash`. No-op si tracking off. */
     reportError(error: unknown, options?: ReportErrorOptions): void;
-    /** Engancha `global.ErrorUtils` de RN para capturar errores JS no manejados. No-op si tracking off. */
+    /**
+     * Engancha `global.ErrorUtils` de RN para capturar errores JS no manejados. Con tracking off
+     * se recuerda y se engancha cuando se conceda el consentimiento (`setTrackingEnabled(true)`).
+     */
     installReactNativeCrashHandler(errorUtils: ReactNativeErrorUtils): void;
+    /**
+     * Pone los handlers de errores no capturados: `window` en web y `ErrorUtils` en RN (el que
+     * pasó el host o, si no pasó ninguno, `globalThis.ErrorUtils`, para que un `init()` sin
+     * `setupReactNative` también capture). Solo con consentimiento; idempotente, así que se
+     * llama en `init()` y cada vez que se activa el tracking.
+     */
+    private installCrashHandlers;
     /**
      * Info interna del usuario que solo conoce el host (idioma, edad, plan…), persistida en el
      * Contact del backend para segmentación/targeting de popups. Identificada por el `userId` del

package/dist/index.d.ts

@@ -124,9 +124,9 @@ type AnalyticsSink = (payload: AnalyticsEnvelope, meta?: AnalyticsFlushMeta) =>
  *
  * La analítica se envía como un Feedback del modelo del Surveys SDK, agrupado por una
  * INTEGRACIÓN creada en la plataforma. Se manda en streaming con `completed:false`; el
- * backend cose por `sessionId` + `user_id`. El ÚLTIMO lote de una sesión (cierre de página,
- * app a background, cambio de usuario) va con `completed:true`: cierra el registro y el
- * siguiente lote omite el `sessionId` viejo para que el backend abra uno nuevo.
+ * backend agrupa los lotes por `sessionId`, que genera el SDK al abrir cada sesión. El
+ * ÚLTIMO lote de una sesión (cierre de página, app a background, cambio de usuario) va con
+ * `completed:true`: cierra el registro y el lote siguiente abre otro con un sessionId nuevo.
  * `feedback.finished` se queda siempre en `false` (no es la señal de cierre acordada).
  *
  * Encoding:
@@ -160,14 +160,14 @@ interface AnalyticsFeedbackBody {
     integration: string;
     completed: boolean;
     finished?: boolean;
-    /** sessionId devuelto por el primer POST; permite que el backend agrupe todos los eventos en un solo registro. */
+    /** sessionId de la sesión (lo genera el SDK): el backend agrupa todos sus lotes en un solo registro. */
     sessionId?: string;
 }
 interface BuildBodyOptions {
     /**
      * `true` en el último lote de la sesión → `completed:true` (cierra el registro en backend).
-     * El body SÍ lleva el `sessionId` actual (es el registro que se cierra); es el lote
-     * SIGUIENTE el que lo omite.
+     * El body lleva el `sessionId` de la sesión que se cierra; el lote siguiente abre otro
+     * registro con un sessionId nuevo.
      */
     sessionEnd?: boolean;
 }
@@ -193,32 +193,49 @@ interface FeedbackSinkOptions {
      * `pagehide` y reanudada tras recargar la página (ver `suspended-session.ts`).
      */
     initialSessionId?: string;
-    /** Callback invocado cuando el backend devuelve un nuevo sessionId (primer POST). */
+    /**
+     * Genera el sessionId de cada sesión (default: UUID v4). Inyectable para tests.
+     */
+    newSessionId?: () => string;
+    /**
+     * Persistencia de los lotes pendientes (React Native: MMKV). Con él, el lote de cierre se
+     * guarda antes de enviarse y cualquier lote que falle sobrevive a que la app muera: el sink
+     * del arranque siguiente lo reenvía a su registro. Sin él, los pendientes viven en memoria.
+     */
+    storage?: KeyValueStorage;
+    /** Reloj inyectable (tests). */
+    now?: () => number;
+    /** Callback invocado cuando la API acepta el primer lote de una sesión (registro abierto). */
     onSessionId?: (id: string) => void;
     /** Callback invocado al cerrar la sesión (`completed:true`): el sessionId cacheado se olvida. */
     onSessionReset?: () => void;
     /**
      * Callback invocado cuando el backend acepta el lote de cierre, con el sessionId del
-     * registro cerrado: el que llevaba el lote o, en una sesión de un solo lote, el que
-     * devuelve la respuesta. Ese registro se convierte en Feedback en segundos.
+     * registro cerrado. Ese registro se convierte en Feedback en segundos.
      */
     onSessionClosed?: (id: string) => void;
 }
 /**
  * Sink real: transforma el envelope y hace `POST {baseUrl}/sdk/feedback`.
  *
- * Stateful: cachea el `sessionId` que devuelve el backend en la primera respuesta y lo
- * envía en los siguientes POSTs para que el backend agrupe todos los eventos en un único
- * registro de feedback.
+ * El `sessionId` de cada sesión lo genera el SDK (UUID) y va en TODOS sus lotes, desde el
+ * primero. La API guarda cada lote bajo el sessionId que recibe, así que una sesión es un
+ * registro aunque no llegue ninguna respuesta. Antes lo asignaba la API en la respuesta del
+ * primer POST: si esa respuesta se perdía (la app pasaba a background con el POST en vuelo),
+ * el resto de la sesión acababa en otro registro.
  *
  * Garantías de entrega:
- *  - mientras no se conozca el `sessionId`, los lotes se **serializan** (esperan la primera
- *    respuesta): dos POSTs a la vez sin `sessionId` crearían dos registros y partirían los datos;
+ *  - un lote que falla de forma transitoria (red, 5xx, 408, 429, sin respuesta en
+ *    POST_TIMEOUT_MS) se guarda TAL CUAL —con su sessionId y su `completed`— y se reenvía
+ *    antes del lote siguiente. Nunca vuelve al buffer del manager: allí se mezclaba con la
+ *    sesión siguiente y viajaba con su registro. La promesa del sink no rechaza;
+ *  - con `storage` (React Native) los pendientes sobreviven a que la app muera: el lote de
+ *    cierre se guarda ANTES de enviarse y el sink del arranque siguiente lo reenvía. La API
+ *    descarta los eventos repetidos de una misma sesión al ensamblarla;
  *  - `keepalive` para que el navegador no cancele el POST al navegar fuera ni al cerrar la
- *    página, también en el flush final (sin `sendBeacon`: ver `sendBeaconImpl`);
+ *    página (sin `sendBeacon`: ver `sendBeaconImpl`);
  *  - sin credenciales, que es lo único que pasa el CORS de la API (`Allow-Origin: *`);
- *  - la promesa **rechaza** en fallo transitorio (red, 5xx, 408, 429) para que el
- *    `AnalyticsManager` re-encole el lote; un 4xx se loguea y se descarta.
+ *  - un 4xx se loguea y se descarta.
  */
 declare function createFeedbackSink(options: FeedbackSinkOptions): AnalyticsSink;
 
@@ -657,6 +674,10 @@ declare function crashRecordToParams(r: CrashRecord): Record<string, unknown>;
 declare class CrashReporter {
     private options;
     private now;
+    /** Los handlers de `window` ya están puestos: `install()` es idempotente. */
+    private windowInstalled;
+    /** ErrorUtils ya enganchados: engancharlos dos veces capturaría cada error dos veces. */
+    private hookedErrorUtils;
     constructor(options: CrashReporterOptions);
     private isEnabled;
     /** Construye un CrashRecord capturando contexto en el momento del crash. */
@@ -669,9 +690,9 @@ declare class CrashReporter {
     private persist;
     /** Lee y vacía la cola de crashes pendientes (llamado en init para el replay). */
     drainPendingCrashes(): CrashRecord[];
-    /** Instala los handlers globales de errores no capturados (no-op sin `window`). */
+    /** Instala los handlers globales de errores no capturados (no-op sin `window`). Idempotente. */
     install(): void;
-    /** Engancha `global.ErrorUtils` de RN (no hay `window`): persiste y encadena al handler previo. */
+    /** Engancha `global.ErrorUtils` de RN (no hay `window`): persiste y encadena al handler previo. Idempotente por instancia de ErrorUtils. */
     installReactNative(errorUtils: ReactNativeErrorUtils): void;
     /** @internal Test seam: ejercita el camino de persistencia (window handlers no son testeables en vitest). */
     _persistForTest(error: unknown): void;
@@ -784,6 +805,8 @@ declare class DeepdotsPopups {
     private analyticsFlushTimer;
     /** Crash & error reporting (#14–17). Null hasta init(). */
     private crashReporter;
+    /** ErrorUtils de RN recibido del host (o del Provider); se engancha en cuanto haya consentimiento. */
+    private rnErrorUtils;
     /** Protecciones del funnel de Messaging (#18–22). Vigencia de sesión: se reinicia en init(). */
     private messageGuard;
     /** Observador de navegación (Fase 2): emite page_view por el canal de analytics. */
@@ -852,8 +875,18 @@ declare class DeepdotsPopups {
     setMetric(key: string, value: string | number | boolean): void;
     /** Reporta un error del host (manejado o no) → evento `deepdots_app_crash`. No-op si tracking off. */
     reportError(error: unknown, options?: ReportErrorOptions): void;
-    /** Engancha `global.ErrorUtils` de RN para capturar errores JS no manejados. No-op si tracking off. */
+    /**
+     * Engancha `global.ErrorUtils` de RN para capturar errores JS no manejados. Con tracking off
+     * se recuerda y se engancha cuando se conceda el consentimiento (`setTrackingEnabled(true)`).
+     */
     installReactNativeCrashHandler(errorUtils: ReactNativeErrorUtils): void;
+    /**
+     * Pone los handlers de errores no capturados: `window` en web y `ErrorUtils` en RN (el que
+     * pasó el host o, si no pasó ninguno, `globalThis.ErrorUtils`, para que un `init()` sin
+     * `setupReactNative` también capture). Solo con consentimiento; idempotente, así que se
+     * llama en `init()` y cada vez que se activa el tracking.
+     */
+    private installCrashHandlers;
     /**
      * Info interna del usuario que solo conoce el host (idioma, edad, plan…), persistida en el
      * Contact del backend para segmentación/targeting de popups. Identificada por el `userId` del

package/dist/index.js

@@ -7706,97 +7706,166 @@ async function safeBodyText(res) {
     return "";
   }
 }
+var PENDING_MAX = 50;
+var PENDING_MAX_AGE_MS = 24 * 60 * 60 * 1e3;
+var POST_TIMEOUT_MS = 2e4;
+function pendingKey(integration) {
+  return `__deepdots_analytics_pending__:${integration}`;
+}
+function generateSessionId() {
+  const c = globalThis.crypto;
+  if (typeof c?.randomUUID === "function") return c.randomUUID();
+  const b = new Uint8Array(16);
+  if (typeof c?.getRandomValues === "function") c.getRandomValues(b);
+  else for (let i = 0; i < 16; i++) b[i] = Math.floor(Math.random() * 256);
+  b[6] = b[6] & 15 | 64;
+  b[8] = b[8] & 63 | 128;
+  const h = Array.from(b, (x) => x.toString(16).padStart(2, "0")).join("");
+  return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;
+}
 function createFeedbackSink(options) {
-  let feedbackSessionId = options.initialSessionId || void 0;
-  let firstPostInFlight = null;
-  let generation = 0;
   const url = `${options.baseUrl}/sdk/feedback`;
-  const post = async (body, final, sessionEnd = false) => {
-    const postGeneration = generation;
+  const newSessionId = options.newSessionId ?? generateSessionId;
+  const now = options.now ?? (() => Date.now());
+  const storageKey = pendingKey(options.keys.integration);
+  let feedbackSessionId = options.initialSessionId || void 0;
+  let announcedId = feedbackSessionId;
+  const pending2 = loadPending();
+  let draining = null;
+  function loadPending() {
+    if (!options.storage) return [];
+    try {
+      const raw = options.storage.getItem(storageKey);
+      const list = raw ? JSON.parse(raw) : [];
+      return Array.isArray(list) ? list.filter((p) => p?.body && now() - p.at <= PENDING_MAX_AGE_MS) : [];
+    } catch {
+      return [];
+    }
+  }
+  function savePending() {
+    if (!options.storage) return;
+    try {
+      if (pending2.length) options.storage.setItem(storageKey, JSON.stringify(pending2));
+      else options.storage.removeItem(storageKey);
+    } catch {
+    }
+  }
+  function addPending(batch) {
+    pending2.push(batch);
+    if (pending2.length > PENDING_MAX) pending2.splice(0, pending2.length - PENDING_MAX);
+    savePending();
+  }
+  function removePending(batch) {
+    const i = pending2.indexOf(batch);
+    if (i >= 0) pending2.splice(i, 1);
+    savePending();
+  }
+  async function post(body, final) {
     const json = JSON.stringify(body);
     const small = json.length <= KEEPALIVE_MAX_BYTES;
     if (final) options.log?.("[DeepdotsAnalytics] final flush via fetch keepalive");
     const f = options.fetchImpl ?? (typeof fetch !== "undefined" ? fetch : void 0);
     if (!f) {
       options.log?.("[DeepdotsAnalytics] no fetch available; payload not sent", body);
-      return;
+      return "drop";
     }
-    const res = await f(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: json,
-      // La API autentica por `publicKey` en el body y responde `Allow-Origin: *`: una
-      // petición con credenciales fallaría el CORS. Explícito para no depender del default.
-      credentials: "omit",
-      // keepalive: el POST sobrevive a la navegación mientras el body sea pequeño.
-      ...small ? { keepalive: true } : {}
-    });
-    if (!res.ok) {
+    let timer;
+    try {
+      const request = f(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: json,
+        // La API autentica por `publicKey` en el body y responde `Allow-Origin: *`: una
+        // petición con credenciales fallaría el CORS. Explícito para no depender del default.
+        credentials: "omit",
+        // keepalive: el POST sobrevive a la navegación mientras el body sea pequeño.
+        ...small ? { keepalive: true } : {}
+      });
+      const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error("timeout")), POST_TIMEOUT_MS);
+      });
+      const res = await Promise.race([request, timeout]);
+      if (res.ok) return "ok";
       const detail = await safeBodyText(res);
       if (isRetryableStatus(res.status)) {
-        throw new Error(`POST /sdk/feedback ${res.status} (retryable): ${detail}`);
+        options.log?.(`[DeepdotsAnalytics] POST /sdk/feedback ${res.status} (retryable): ${detail}`);
+        return "retry";
       }
       options.log?.(
         `[DeepdotsAnalytics] POST /sdk/feedback rejected with ${res.status}; batch DISCARDED:`,
         detail
       );
-      return;
-    }
-    if (sessionEnd) {
-      let closedId = body.sessionId;
-      try {
-        const data = await res.json();
-        closedId = data?.sessionId ?? closedId;
-      } catch {
-      }
-      try {
-        if (closedId) options.onSessionClosed?.(closedId);
-      } catch {
-      }
-      return;
+      return "drop";
+    } catch (error) {
+      options.log?.("[DeepdotsAnalytics] POST /sdk/feedback failed (will retry):", error);
+      return "retry";
+    } finally {
+      clearTimeout(timer);
     }
+  }
+  function delivered(body) {
+    const id = body.sessionId;
+    if (!id) return;
     try {
-      const data = await res.json();
-      if (postGeneration !== generation) {
-        options.log?.("[DeepdotsAnalytics] sessionId of a closed session ignored:", data?.sessionId);
-        return;
-      }
-      if (data?.sessionId && data.sessionId !== feedbackSessionId) {
-        feedbackSessionId = data.sessionId;
-        options.log?.("[DeepdotsAnalytics] feedbackSessionId cached:", feedbackSessionId);
-        options.onSessionId?.(feedbackSessionId);
+      if (body.completed) {
+        options.onSessionClosed?.(id);
+      } else if (id === feedbackSessionId && id !== announcedId) {
+        announcedId = id;
+        options.log?.("[DeepdotsAnalytics] feedback session open:", id);
+        options.onSessionId?.(id);
       }
     } catch {
     }
-  };
+  }
+  async function send(batch, final, alreadyPending) {
+    const result = await post(batch.body, final);
+    if (result === "retry") {
+      if (!alreadyPending) addPending(batch);
+      return;
+    }
+    if (alreadyPending) removePending(batch);
+    if (result === "ok") delivered(batch.body);
+  }
+  function drain() {
+    const run = async () => {
+      for (let i = 0; i < pending2.length; ) {
+        const batch = pending2[i];
+        await send(batch, false, true);
+        if (pending2[i] === batch) return;
+      }
+    };
+    const next = draining ? draining.then(run) : run();
+    draining = next;
+    void next.finally(() => {
+      if (draining === next) draining = null;
+    });
+    return next;
+  }
+  if (pending2.length) {
+    savePending();
+    setTimeout(() => void drain(), 0);
+  }
   return async (envelope, meta) => {
     if (meta?.resetSession) {
       feedbackSessionId = void 0;
-      firstPostInFlight = null;
-      generation++;
       options.onSessionReset?.();
       return;
     }
     const final = meta?.final === true;
     const sessionEnd = meta?.sessionEnd === true;
-    if (!feedbackSessionId && firstPostInFlight && !final) {
-      await firstPostInFlight;
-    }
+    if (!feedbackSessionId) feedbackSessionId = newSessionId();
     const body = buildAnalyticsFeedbackBody(envelope, options.keys, feedbackSessionId, { sessionEnd });
     options.log?.("[DeepdotsAnalytics] POST /sdk/feedback \u2192", body);
-    const sent = post(body, final, sessionEnd);
+    const batch = { body, at: now() };
     if (sessionEnd) {
       feedbackSessionId = void 0;
-      firstPostInFlight = null;
-      generation++;
       options.onSessionReset?.();
-    } else if (!feedbackSessionId) {
-      firstPostInFlight = sent.then(
-        () => void 0,
-        () => void 0
-      );
+      addPending(batch);
+      await drain();
+      return;
     }
-    await sent;
+    const retries = pending2.length ? drain() : null;
+    await Promise.all([retries, send(batch, final, false)]);
   };
 }
 
@@ -8216,6 +8285,10 @@ function crashRecordToParams(r) {
 }
 var CrashReporter = class {
   constructor(options) {
+    /** Los handlers de `window` ya están puestos: `install()` es idempotente. */
+    this.windowInstalled = false;
+    /** ErrorUtils ya enganchados: engancharlos dos veces capturaría cada error dos veces. */
+    this.hookedErrorUtils = /* @__PURE__ */ new Set();
     this.options = options;
     this.now = options.now ?? (() => Date.now());
   }
@@ -8291,9 +8364,11 @@ var CrashReporter = class {
     }
     return queue;
   }
-  /** Instala los handlers globales de errores no capturados (no-op sin `window`). */
+  /** Instala los handlers globales de errores no capturados (no-op sin `window`). Idempotente. */
   install() {
+    if (this.windowInstalled) return;
     if (typeof window === "undefined" || typeof window.addEventListener !== "function") return;
+    this.windowInstalled = true;
     window.addEventListener("error", (e) => {
       if (!this.isEnabled()) return;
       this.captureUnhandled(e.error ?? e.message ?? "error");
@@ -8303,8 +8378,10 @@ var CrashReporter = class {
       this.captureUnhandled(e.reason ?? "unhandledrejection");
     });
   }
-  /** Engancha `global.ErrorUtils` de RN (no hay `window`): persiste y encadena al handler previo. */
+  /** Engancha `global.ErrorUtils` de RN (no hay `window`): persiste y encadena al handler previo. Idempotente por instancia de ErrorUtils. */
   installReactNative(errorUtils) {
+    if (this.hookedErrorUtils.has(errorUtils)) return;
+    this.hookedErrorUtils.add(errorUtils);
     const previous = errorUtils.getGlobalHandler?.();
     errorUtils.setGlobalHandler((error, isFatal) => {
       if (this.isEnabled()) this.captureUnhandled(error);
@@ -8520,6 +8597,8 @@ var DeepdotsPopups = class {
     this.analyticsFlushTimer = void 0;
     /** Crash & error reporting (#14–17). Null hasta init(). */
     this.crashReporter = null;
+    /** ErrorUtils de RN recibido del host (o del Provider); se engancha en cuanto haya consentimiento. */
+    this.rnErrorUtils = null;
     /** Protecciones del funnel de Messaging (#18–22). Vigencia de sesión: se reinicia en init(). */
     this.messageGuard = new MessageGuard();
     /** Observador de navegación (Fase 2): emite page_view por el canal de analytics. */
@@ -8620,6 +8699,10 @@ var DeepdotsPopups = class {
       keys: config.analytics,
       log: (...a) => this.log(...a),
       initialSessionId: resumable?.sessionId,
+      // En móvil (RN) la app puede morir con el lote de cierre sin entregar: se
+      // persiste y se reenvía en el arranque siguiente. En web el cierre sale con
+      // `keepalive` y varias pestañas compartirían el mismo storage.
+      storage: (config.platform ?? "web") !== "web" ? storage : void 0,
       onSessionId: (id) => {
         this.analyticsFeedbackSessionId = id;
         this.notifyFeedbackSession(id, "open");
@@ -8655,9 +8738,7 @@ var DeepdotsPopups = class {
       now: () => Date.now(),
       enabled: () => this.tracking?.isTrackingEnabled() ?? false
     });
-    if (this.tracking?.isTrackingEnabled()) {
-      this.crashReporter.install();
-    }
+    this.installCrashHandlers();
     this.geoEnabled = config.geolocation ?? true;
     this.geoWanted = this.geoEnabled && !!config.analytics;
     this.resolveGeo();
@@ -8726,6 +8807,7 @@ var DeepdotsPopups = class {
     if (!enabled) this.closeSession("tracking_disabled");
     this.tracking?.setTrackingEnabled(enabled);
     if (enabled) this.openSession("tracking_enabled");
+    if (enabled) this.installCrashHandlers();
     if (enabled) this.resolveGeo();
     this.log("tracking \xB7 setTrackingEnabled:", enabled, "\xB7 session_id:", this.tracking?.getSessionId() ?? null);
   }
@@ -8756,10 +8838,27 @@ var DeepdotsPopups = class {
     if (!this.tracking?.isTrackingEnabled()) return;
     this.crashReporter?.reportError(error, options);
   }
-  /** Engancha `global.ErrorUtils` de RN para capturar errores JS no manejados. No-op si tracking off. */
+  /**
+   * Engancha `global.ErrorUtils` de RN para capturar errores JS no manejados. Con tracking off
+   * se recuerda y se engancha cuando se conceda el consentimiento (`setTrackingEnabled(true)`).
+   */
   installReactNativeCrashHandler(errorUtils) {
-    if (!this.tracking?.isTrackingEnabled()) return;
-    this.crashReporter?.installReactNative(errorUtils);
+    this.rnErrorUtils = errorUtils;
+    this.installCrashHandlers();
+  }
+  /**
+   * Pone los handlers de errores no capturados: `window` en web y `ErrorUtils` en RN (el que
+   * pasó el host o, si no pasó ninguno, `globalThis.ErrorUtils`, para que un `init()` sin
+   * `setupReactNative` también capture). Solo con consentimiento; idempotente, así que se
+   * llama en `init()` y cada vez que se activa el tracking.
+   */
+  installCrashHandlers() {
+    if (!this.crashReporter || !this.tracking?.isTrackingEnabled()) return;
+    this.crashReporter.install();
+    const errorUtils = this.rnErrorUtils ?? globalThis.ErrorUtils;
+    if (errorUtils && typeof errorUtils.setGlobalHandler === "function") {
+      this.crashReporter.installReactNative(errorUtils);
+    }
   }
   /**
    * Info interna del usuario que solo conoce el host (idioma, edad, plan…), persistida en el