@sendoracloud/sdk-react-native 1.38.0 → 1.39.1

package/dist/index.cjs

@@ -228,7 +228,7 @@ var Storage = class {
 // package.json
 var package_default = {
   name: "@sendoracloud/sdk-react-native",
-  version: "1.38.0",
+  version: "1.39.1",
   description: "Sendora Cloud React Native + Expo SDK \u2014 analytics, identity, push-token registration, auth (incl. Game Center / Play Games), deep links (Branch / Firebase Dynamic Links parity). Auth + analytics + deep links work in Expo Go; push-token registration and the no-arg Game Center / Play Games sign-in require a Dev Client (EAS Build or `npx expo prebuild`).",
   type: "module",
   main: "./dist/index.cjs",
@@ -284,7 +284,7 @@ var package_default = {
   scripts: {
     build: "tsup src/index.ts src/contact-widget.tsx --format esm,cjs --dts --clean --external react --external react-native --external react-native-webview",
     typecheck: "tsc --noEmit",
-    test: "tsx test/secure-storage.test.ts && tsx test/integration-storage.test.ts && tsx test/plugin.test.ts && tsx test/game-auth.test.ts && tsx test/link.test.ts && tsx test/session-preservation.test.ts && tsx test/credential-collision.test.ts && tsx test/token-expiry.test.ts && tsx test/unlink.test.ts && tsx test/deferred-match.test.ts && tsx test/anon-id-stability.test.ts"
+    test: "tsx test/secure-storage.test.ts && tsx test/integration-storage.test.ts && tsx test/plugin.test.ts && tsx test/game-auth.test.ts && tsx test/link.test.ts && tsx test/session-preservation.test.ts && tsx test/credential-collision.test.ts && tsx test/token-expiry.test.ts && tsx test/unlink.test.ts && tsx test/deferred-match.test.ts && tsx test/anon-id-stability.test.ts && tsx test/event-queue.test.ts"
   },
   devDependencies: {
     "@types/react": "^19.2.16",
@@ -2855,10 +2855,140 @@ function installAutoTrack(args) {
   };
 }
 
+// src/event-queue.ts
+var MAX_QUEUE = 500;
+var MAX_ATTEMPTS = 50;
+var BASE_BACKOFF_MS = 1e3;
+var MAX_BACKOFF_MS = 6e4;
+var EventQueue = class {
+  constructor(deps) {
+    this.deps = deps;
+    this.q = [];
+    this.flushing = false;
+    this.failures = 0;
+    this.timer = null;
+    this.now = deps.now ?? Date.now;
+    this.setTimer = deps.setTimer ?? ((fn, ms) => setTimeout(fn, ms));
+    this.clearTimer = deps.clearTimer ?? ((t) => clearTimeout(t));
+  }
+  /** Load any events left unsent by a previous launch. Call once, after storage
+   *  hydrate. Then `flush()` to attempt delivery. */
+  hydrate() {
+    try {
+      const raw = this.deps.load();
+      if (!raw) return;
+      const parsed = JSON.parse(raw);
+      if (Array.isArray(parsed)) {
+        this.q = parsed.filter((e) => !!e && typeof e === "object" && "body" in e).slice(-MAX_QUEUE);
+      }
+    } catch {
+      this.q = [];
+    }
+  }
+  /** Enqueue an event and trigger a (caught) flush. NEVER throws. */
+  enqueue(body) {
+    this.q.push({ body, attempts: 0 });
+    if (this.q.length > MAX_QUEUE) this.q.splice(0, this.q.length - MAX_QUEUE);
+    this.persist();
+    this.scheduleFlush(0);
+  }
+  /** Flush immediately, resetting backoff — for app foreground. NEVER throws. */
+  flushNow() {
+    this.failures = 0;
+    if (this.timer) {
+      this.clearTimer(this.timer);
+      this.timer = null;
+    }
+    void this.flush();
+  }
+  /** Drop everything (e.g. on a hard reset). */
+  clear() {
+    this.q = [];
+    if (this.timer) {
+      this.clearTimer(this.timer);
+      this.timer = null;
+    }
+    this.persist();
+  }
+  persist() {
+    try {
+      this.deps.save(JSON.stringify(this.q));
+    } catch {
+    }
+  }
+  scheduleFlush(ms) {
+    if (this.timer || this.flushing) return;
+    this.timer = this.setTimer(() => {
+      this.timer = null;
+      void this.flush();
+    }, ms);
+  }
+  /**
+   * Drain the queue FIFO. Removes an event only when the server ACCEPTED it (2xx)
+   * or PERMANENTLY refused it (a 4xx that a retry can't fix). Keeps it — and stops
+   * draining — on a transient failure (timeout throw, network null, 408/429/5xx),
+   * then arms a capped-exponential-backoff retry. The entire post lives inside the
+   * try/catch, so `NetworkTimeoutError` can never surface as an unhandled rejection.
+   */
+  async flush() {
+    if (this.flushing || this.q.length === 0) return;
+    this.flushing = true;
+    try {
+      while (this.q.length > 0) {
+        const ev = this.q[0];
+        let outcome;
+        try {
+          const res = await this.deps.post(ev.body);
+          outcome = classify(res);
+        } catch {
+          outcome = "retry";
+        }
+        if (outcome === "ok" || outcome === "drop") {
+          this.q.shift();
+          this.failures = 0;
+          this.persist();
+          continue;
+        }
+        ev.attempts += 1;
+        if (ev.attempts >= MAX_ATTEMPTS) {
+          if (this.deps.debug) {
+            console.warn(`[sendoracloud] event dropped after ${MAX_ATTEMPTS} attempts`);
+          }
+          this.q.shift();
+          this.persist();
+          continue;
+        }
+        if (this.q.length > 1) this.q.push(this.q.shift());
+        this.persist();
+        this.failures += 1;
+        break;
+      }
+    } finally {
+      this.flushing = false;
+    }
+    if (this.q.length > 0) {
+      const backoff = Math.min(MAX_BACKOFF_MS, BASE_BACKOFF_MS * 2 ** Math.max(0, this.failures - 1));
+      this.scheduleFlush(backoff);
+    }
+  }
+  /** Test/introspection only. */
+  get size() {
+    return this.q.length;
+  }
+};
+function classify(res) {
+  if (res === null) return "retry";
+  if (res.ok) return "ok";
+  const s = res.status;
+  if (s === 408 || s === 429 || s >= 500) return "retry";
+  return "drop";
+}
+
 // src/index.ts
 var DEFAULT_API_URL = "https://api.sendoracloud.com";
 var ANON_KEY = "anon_id";
 var USER_ID_KEY = "user_id";
+var EVENT_QUEUE_KEY = "event_queue";
 var SCHEMA_VERSION_KEY = "schema_version";
 var SCHEMA_VERSION = "1";
 var AUTH_HYDRATE_KEYS = [
@@ -3005,6 +3135,7 @@ var SendoraSDK = class {
     this.debug = false;
     this.sessionId = "";
     this.autoTrackCleanup = null;
+    this.eventQueue = null;
     // --- Engagement time (foreground-only, Wave 75) ---
     this.engEnabled = false;
     this.engScreen = null;
@@ -3064,6 +3195,7 @@ var SendoraSDK = class {
       ANON_KEY,
       USER_ID_KEY,
       SCHEMA_VERSION_KEY,
+      EVENT_QUEUE_KEY,
       ...AUTH_HYDRATE_KEYS
     ]);
     if (!this.storage.get(SCHEMA_VERSION_KEY)) {
@@ -3104,6 +3236,7 @@ var SendoraSDK = class {
           this.anonId = uuid();
           this.storage.set(ANON_KEY, this.anonId);
         }
+        if (reason === "account_deleted") this.eventQueue?.clear();
         this.userId = null;
         this.storage.remove(USER_ID_KEY);
       }
@@ -3117,6 +3250,18 @@ var SendoraSDK = class {
       androidPackageName: this.config.androidPackageName,
       linkDomain: this.config.linkDomain
     });
+    this.eventQueue = new EventQueue({
+      post: (body) => post(
+        { apiUrl: this.config.apiUrl, publicKey: this.config.publicKey, debug: this.debug },
+        "/api/v1/events",
+        body
+      ).then((res) => res === null ? null : { ok: res.ok, status: res.status }),
+      load: () => this.storage.get(EVENT_QUEUE_KEY) ?? null,
+      save: (json) => this.storage.set(EVENT_QUEUE_KEY, json),
+      debug: this.debug
+    });
+    this.eventQueue.hydrate();
+    this.eventQueue.flushNow();
     this.ready = true;
     if (config.autoTrack !== false) {
       this.engEnabled = config.autoTrack === true || config.autoTrack === void 0 || config.autoTrack.engagement !== false;
@@ -3128,8 +3273,10 @@ var SendoraSDK = class {
           this.sessionId = id;
         },
         onForeground: (active) => {
-          if (active) this.engResume();
-          else this.engFlush();
+          if (active) {
+            this.engResume();
+            this.eventQueue?.flushNow();
+          } else this.engFlush();
         }
       });
     }
@@ -3209,7 +3356,7 @@ var SendoraSDK = class {
     }
     this.userId = userId;
     this.storage.set(USER_ID_KEY, userId);
-    void this.sendEvent("identify", {
+    this.sendEvent("identify", {
       userId,
       traits: traits ?? {}
     });
@@ -3226,7 +3373,7 @@ var SendoraSDK = class {
         throw new Error(`[sendoracloud] properties exceed ${MAX_PROPERTIES_BYTES} bytes.`);
       }
     }
-    void this.sendEvent("track", {
+    this.sendEvent("track", {
       eventType,
       properties: properties ?? {}
     });
@@ -3238,7 +3385,7 @@ var SendoraSDK = class {
       throw new Error("[sendoracloud] screen name must be a 1-256 char string.");
     }
     this.engFlush();
-    void this.sendEvent("screen", {
+    this.sendEvent("screen", {
       eventType: "screen.viewed",
       properties: { screenName: name, ...properties ?? {} }
     });
@@ -3266,7 +3413,7 @@ var SendoraSDK = class {
     if (ms < MIN_ENGAGEMENT_MS) return;
     if (ms > MAX_ENGAGEMENT_MS) ms = MAX_ENGAGEMENT_MS;
     try {
-      void this.sendEvent("track", {
+      this.sendEvent("track", {
         eventType: "app.engagement",
         properties: { durationMs: Math.round(ms), screen: this.engScreen, sessionId: this.sessionId }
       });
@@ -3850,6 +3997,7 @@ var SendoraSDK = class {
     await this.auth.signOut().catch(() => void 0);
     this.userId = null;
     this.sessionId = "";
+    this.eventQueue?.clear();
     await this.storage.clearAll();
     this.storage.set(ANON_KEY, this.anonId);
   }
@@ -3861,34 +4009,42 @@ var SendoraSDK = class {
       this.autoTrackCleanup = null;
     }
   }
-  async sendEvent(kind, payload) {
+  /**
+   * Build an event body and hand it to the persisted queue for delivery.
+   *
+   * ⚠ SYNCHRONOUS + NEVER THROWS (1.39.0). Before this, it was `async` and did
+   * `await post(...)` with no try/catch; `http.ts` THROWS `NetworkTimeoutError` on
+   * its 30 s abort, and every caller discarded the promise with `void` — so a slow
+   * `/api/v1/events` request became an unhandled rejection in the host's crash
+   * reporter AND the event was lost. Now the queue owns delivery: it retries with
+   * backoff, persists across launches, and swallows every transport failure. A
+   * rejection can no longer escape (so `engFlush`'s "never throws" try/catch is
+   * finally true), and a slow network delays events instead of dropping them.
+   */
+  sendEvent(kind, payload) {
     if (!this.config) return;
     if (!this.consentGranted) return;
     const device = buildDeviceContext(this.config.appVersion, this.config.appBuild);
-    await post(
-      { apiUrl: this.config.apiUrl, publicKey: this.config.publicKey, debug: this.debug },
-      "/api/v1/events",
-      {
-        ...this.config.projectId ? { projectId: this.config.projectId } : {},
-        module: kind === "identify" ? "profiles" : "analytics",
-        eventType: payload.eventType ?? (kind === "identify" ? "identify" : "track"),
-        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        ...this.userId ? { userId: this.userId } : {},
-        anonymousId: this.anonId,
-        // Top-level sessionId so backend `events.session_id` populates (powers
-        // the Audience "Sessions & engagement" metrics). Set by auto-track;
-        // blank until the first auto event of the launch → omitted when empty.
-        ...this.sessionId ? { sessionId: this.sessionId } : {},
-        properties: payload.properties ?? {},
-        context: {
-          platform: "react-native",
-          sdk: { name: "@sendoracloud/sdk-react-native", version: SDK_VERSION },
-          ...device ? { device } : {},
-          ...this.config.environment ? { environment: this.config.environment } : {},
-          ...kind === "identify" ? { traits: payload.traits } : {}
-        }
+    this.eventQueue?.enqueue({
+      ...this.config.projectId ? { projectId: this.config.projectId } : {},
+      module: kind === "identify" ? "profiles" : "analytics",
+      eventType: payload.eventType ?? (kind === "identify" ? "identify" : "track"),
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      ...this.userId ? { userId: this.userId } : {},
+      anonymousId: this.anonId,
+      // Top-level sessionId so backend `events.session_id` populates (powers
+      // the Audience "Sessions & engagement" metrics). Set by auto-track;
+      // blank until the first auto event of the launch → omitted when empty.
+      ...this.sessionId ? { sessionId: this.sessionId } : {},
+      properties: payload.properties ?? {},
+      context: {
+        platform: "react-native",
+        sdk: { name: "@sendoracloud/sdk-react-native", version: SDK_VERSION },
+        ...device ? { device } : {},
+        ...this.config.environment ? { environment: this.config.environment } : {},
+        ...kind === "identify" ? { traits: payload.traits } : {}
       }
-    );
+    });
   }
   assertReady() {
     if (!this.ready || !this.config) {

package/dist/index.d.cts

@@ -1624,6 +1624,7 @@ declare class SendoraSDK {
     private debug;
     private sessionId;
     private autoTrackCleanup;
+    private eventQueue;
     private engEnabled;
     private engScreen;
     private engAccumMs;
@@ -2128,6 +2129,18 @@ declare class SendoraSDK {
     reset(): Promise<void>;
     /** Tear down auto-track listeners. Call in test harnesses. */
     destroy(): void;
+    /**
+     * Build an event body and hand it to the persisted queue for delivery.
+     *
+     * ⚠ SYNCHRONOUS + NEVER THROWS (1.39.0). Before this, it was `async` and did
+     * `await post(...)` with no try/catch; `http.ts` THROWS `NetworkTimeoutError` on
+     * its 30 s abort, and every caller discarded the promise with `void` — so a slow
+     * `/api/v1/events` request became an unhandled rejection in the host's crash
+     * reporter AND the event was lost. Now the queue owns delivery: it retries with
+     * backoff, persists across launches, and swallows every transport failure. A
+     * rejection can no longer escape (so `engFlush`'s "never throws" try/catch is
+     * finally true), and a slow network delays events instead of dropping them.
+     */
     private sendEvent;
     private assertReady;
 }

package/dist/index.d.ts

@@ -1624,6 +1624,7 @@ declare class SendoraSDK {
     private debug;
     private sessionId;
     private autoTrackCleanup;
+    private eventQueue;
     private engEnabled;
     private engScreen;
     private engAccumMs;
@@ -2128,6 +2129,18 @@ declare class SendoraSDK {
     reset(): Promise<void>;
     /** Tear down auto-track listeners. Call in test harnesses. */
     destroy(): void;
+    /**
+     * Build an event body and hand it to the persisted queue for delivery.
+     *
+     * ⚠ SYNCHRONOUS + NEVER THROWS (1.39.0). Before this, it was `async` and did
+     * `await post(...)` with no try/catch; `http.ts` THROWS `NetworkTimeoutError` on
+     * its 30 s abort, and every caller discarded the promise with `void` — so a slow
+     * `/api/v1/events` request became an unhandled rejection in the host's crash
+     * reporter AND the event was lost. Now the queue owns delivery: it retries with
+     * backoff, persists across launches, and swallows every transport failure. A
+     * rejection can no longer escape (so `engFlush`'s "never throws" try/catch is
+     * finally true), and a slow network delays events instead of dropping them.
+     */
     private sendEvent;
     private assertReady;
 }

package/dist/index.js

@@ -183,7 +183,7 @@ var Storage = class {
 // package.json
 var package_default = {
   name: "@sendoracloud/sdk-react-native",
-  version: "1.38.0",
+  version: "1.39.1",
   description: "Sendora Cloud React Native + Expo SDK \u2014 analytics, identity, push-token registration, auth (incl. Game Center / Play Games), deep links (Branch / Firebase Dynamic Links parity). Auth + analytics + deep links work in Expo Go; push-token registration and the no-arg Game Center / Play Games sign-in require a Dev Client (EAS Build or `npx expo prebuild`).",
   type: "module",
   main: "./dist/index.cjs",
@@ -239,7 +239,7 @@ var package_default = {
   scripts: {
     build: "tsup src/index.ts src/contact-widget.tsx --format esm,cjs --dts --clean --external react --external react-native --external react-native-webview",
     typecheck: "tsc --noEmit",
-    test: "tsx test/secure-storage.test.ts && tsx test/integration-storage.test.ts && tsx test/plugin.test.ts && tsx test/game-auth.test.ts && tsx test/link.test.ts && tsx test/session-preservation.test.ts && tsx test/credential-collision.test.ts && tsx test/token-expiry.test.ts && tsx test/unlink.test.ts && tsx test/deferred-match.test.ts && tsx test/anon-id-stability.test.ts"
+    test: "tsx test/secure-storage.test.ts && tsx test/integration-storage.test.ts && tsx test/plugin.test.ts && tsx test/game-auth.test.ts && tsx test/link.test.ts && tsx test/session-preservation.test.ts && tsx test/credential-collision.test.ts && tsx test/token-expiry.test.ts && tsx test/unlink.test.ts && tsx test/deferred-match.test.ts && tsx test/anon-id-stability.test.ts && tsx test/event-queue.test.ts"
   },
   devDependencies: {
     "@types/react": "^19.2.16",
@@ -2815,10 +2815,140 @@ function installAutoTrack(args) {
   };
 }
 
+// src/event-queue.ts
+var MAX_QUEUE = 500;
+var MAX_ATTEMPTS = 50;
+var BASE_BACKOFF_MS = 1e3;
+var MAX_BACKOFF_MS = 6e4;
+var EventQueue = class {
+  constructor(deps) {
+    this.deps = deps;
+    this.q = [];
+    this.flushing = false;
+    this.failures = 0;
+    this.timer = null;
+    this.now = deps.now ?? Date.now;
+    this.setTimer = deps.setTimer ?? ((fn, ms) => setTimeout(fn, ms));
+    this.clearTimer = deps.clearTimer ?? ((t) => clearTimeout(t));
+  }
+  /** Load any events left unsent by a previous launch. Call once, after storage
+   *  hydrate. Then `flush()` to attempt delivery. */
+  hydrate() {
+    try {
+      const raw = this.deps.load();
+      if (!raw) return;
+      const parsed = JSON.parse(raw);
+      if (Array.isArray(parsed)) {
+        this.q = parsed.filter((e) => !!e && typeof e === "object" && "body" in e).slice(-MAX_QUEUE);
+      }
+    } catch {
+      this.q = [];
+    }
+  }
+  /** Enqueue an event and trigger a (caught) flush. NEVER throws. */
+  enqueue(body) {
+    this.q.push({ body, attempts: 0 });
+    if (this.q.length > MAX_QUEUE) this.q.splice(0, this.q.length - MAX_QUEUE);
+    this.persist();
+    this.scheduleFlush(0);
+  }
+  /** Flush immediately, resetting backoff — for app foreground. NEVER throws. */
+  flushNow() {
+    this.failures = 0;
+    if (this.timer) {
+      this.clearTimer(this.timer);
+      this.timer = null;
+    }
+    void this.flush();
+  }
+  /** Drop everything (e.g. on a hard reset). */
+  clear() {
+    this.q = [];
+    if (this.timer) {
+      this.clearTimer(this.timer);
+      this.timer = null;
+    }
+    this.persist();
+  }
+  persist() {
+    try {
+      this.deps.save(JSON.stringify(this.q));
+    } catch {
+    }
+  }
+  scheduleFlush(ms) {
+    if (this.timer || this.flushing) return;
+    this.timer = this.setTimer(() => {
+      this.timer = null;
+      void this.flush();
+    }, ms);
+  }
+  /**
+   * Drain the queue FIFO. Removes an event only when the server ACCEPTED it (2xx)
+   * or PERMANENTLY refused it (a 4xx that a retry can't fix). Keeps it — and stops
+   * draining — on a transient failure (timeout throw, network null, 408/429/5xx),
+   * then arms a capped-exponential-backoff retry. The entire post lives inside the
+   * try/catch, so `NetworkTimeoutError` can never surface as an unhandled rejection.
+   */
+  async flush() {
+    if (this.flushing || this.q.length === 0) return;
+    this.flushing = true;
+    try {
+      while (this.q.length > 0) {
+        const ev = this.q[0];
+        let outcome;
+        try {
+          const res = await this.deps.post(ev.body);
+          outcome = classify(res);
+        } catch {
+          outcome = "retry";
+        }
+        if (outcome === "ok" || outcome === "drop") {
+          this.q.shift();
+          this.failures = 0;
+          this.persist();
+          continue;
+        }
+        ev.attempts += 1;
+        if (ev.attempts >= MAX_ATTEMPTS) {
+          if (this.deps.debug) {
+            console.warn(`[sendoracloud] event dropped after ${MAX_ATTEMPTS} attempts`);
+          }
+          this.q.shift();
+          this.persist();
+          continue;
+        }
+        if (this.q.length > 1) this.q.push(this.q.shift());
+        this.persist();
+        this.failures += 1;
+        break;
+      }
+    } finally {
+      this.flushing = false;
+    }
+    if (this.q.length > 0) {
+      const backoff = Math.min(MAX_BACKOFF_MS, BASE_BACKOFF_MS * 2 ** Math.max(0, this.failures - 1));
+      this.scheduleFlush(backoff);
+    }
+  }
+  /** Test/introspection only. */
+  get size() {
+    return this.q.length;
+  }
+};
+function classify(res) {
+  if (res === null) return "retry";
+  if (res.ok) return "ok";
+  const s = res.status;
+  if (s === 408 || s === 429 || s >= 500) return "retry";
+  return "drop";
+}
+
 // src/index.ts
 var DEFAULT_API_URL = "https://api.sendoracloud.com";
 var ANON_KEY = "anon_id";
 var USER_ID_KEY = "user_id";
+var EVENT_QUEUE_KEY = "event_queue";
 var SCHEMA_VERSION_KEY = "schema_version";
 var SCHEMA_VERSION = "1";
 var AUTH_HYDRATE_KEYS = [
@@ -2965,6 +3095,7 @@ var SendoraSDK = class {
     this.debug = false;
     this.sessionId = "";
     this.autoTrackCleanup = null;
+    this.eventQueue = null;
     // --- Engagement time (foreground-only, Wave 75) ---
     this.engEnabled = false;
     this.engScreen = null;
@@ -3024,6 +3155,7 @@ var SendoraSDK = class {
       ANON_KEY,
       USER_ID_KEY,
       SCHEMA_VERSION_KEY,
+      EVENT_QUEUE_KEY,
       ...AUTH_HYDRATE_KEYS
     ]);
     if (!this.storage.get(SCHEMA_VERSION_KEY)) {
@@ -3064,6 +3196,7 @@ var SendoraSDK = class {
           this.anonId = uuid();
           this.storage.set(ANON_KEY, this.anonId);
         }
+        if (reason === "account_deleted") this.eventQueue?.clear();
         this.userId = null;
         this.storage.remove(USER_ID_KEY);
       }
@@ -3077,6 +3210,18 @@ var SendoraSDK = class {
       androidPackageName: this.config.androidPackageName,
       linkDomain: this.config.linkDomain
     });
+    this.eventQueue = new EventQueue({
+      post: (body) => post(
+        { apiUrl: this.config.apiUrl, publicKey: this.config.publicKey, debug: this.debug },
+        "/api/v1/events",
+        body
+      ).then((res) => res === null ? null : { ok: res.ok, status: res.status }),
+      load: () => this.storage.get(EVENT_QUEUE_KEY) ?? null,
+      save: (json) => this.storage.set(EVENT_QUEUE_KEY, json),
+      debug: this.debug
+    });
+    this.eventQueue.hydrate();
+    this.eventQueue.flushNow();
     this.ready = true;
     if (config.autoTrack !== false) {
       this.engEnabled = config.autoTrack === true || config.autoTrack === void 0 || config.autoTrack.engagement !== false;
@@ -3088,8 +3233,10 @@ var SendoraSDK = class {
           this.sessionId = id;
         },
         onForeground: (active) => {
-          if (active) this.engResume();
-          else this.engFlush();
+          if (active) {
+            this.engResume();
+            this.eventQueue?.flushNow();
+          } else this.engFlush();
         }
       });
     }
@@ -3169,7 +3316,7 @@ var SendoraSDK = class {
     }
     this.userId = userId;
     this.storage.set(USER_ID_KEY, userId);
-    void this.sendEvent("identify", {
+    this.sendEvent("identify", {
       userId,
       traits: traits ?? {}
     });
@@ -3186,7 +3333,7 @@ var SendoraSDK = class {
         throw new Error(`[sendoracloud] properties exceed ${MAX_PROPERTIES_BYTES} bytes.`);
       }
     }
-    void this.sendEvent("track", {
+    this.sendEvent("track", {
       eventType,
       properties: properties ?? {}
     });
@@ -3198,7 +3345,7 @@ var SendoraSDK = class {
       throw new Error("[sendoracloud] screen name must be a 1-256 char string.");
     }
     this.engFlush();
-    void this.sendEvent("screen", {
+    this.sendEvent("screen", {
       eventType: "screen.viewed",
       properties: { screenName: name, ...properties ?? {} }
     });
@@ -3226,7 +3373,7 @@ var SendoraSDK = class {
     if (ms < MIN_ENGAGEMENT_MS) return;
     if (ms > MAX_ENGAGEMENT_MS) ms = MAX_ENGAGEMENT_MS;
     try {
-      void this.sendEvent("track", {
+      this.sendEvent("track", {
         eventType: "app.engagement",
         properties: { durationMs: Math.round(ms), screen: this.engScreen, sessionId: this.sessionId }
       });
@@ -3810,6 +3957,7 @@ var SendoraSDK = class {
     await this.auth.signOut().catch(() => void 0);
     this.userId = null;
     this.sessionId = "";
+    this.eventQueue?.clear();
     await this.storage.clearAll();
     this.storage.set(ANON_KEY, this.anonId);
   }
@@ -3821,34 +3969,42 @@ var SendoraSDK = class {
       this.autoTrackCleanup = null;
     }
   }
-  async sendEvent(kind, payload) {
+  /**
+   * Build an event body and hand it to the persisted queue for delivery.
+   *
+   * ⚠ SYNCHRONOUS + NEVER THROWS (1.39.0). Before this, it was `async` and did
+   * `await post(...)` with no try/catch; `http.ts` THROWS `NetworkTimeoutError` on
+   * its 30 s abort, and every caller discarded the promise with `void` — so a slow
+   * `/api/v1/events` request became an unhandled rejection in the host's crash
+   * reporter AND the event was lost. Now the queue owns delivery: it retries with
+   * backoff, persists across launches, and swallows every transport failure. A
+   * rejection can no longer escape (so `engFlush`'s "never throws" try/catch is
+   * finally true), and a slow network delays events instead of dropping them.
+   */
+  sendEvent(kind, payload) {
     if (!this.config) return;
     if (!this.consentGranted) return;
     const device = buildDeviceContext(this.config.appVersion, this.config.appBuild);
-    await post(
-      { apiUrl: this.config.apiUrl, publicKey: this.config.publicKey, debug: this.debug },
-      "/api/v1/events",
-      {
-        ...this.config.projectId ? { projectId: this.config.projectId } : {},
-        module: kind === "identify" ? "profiles" : "analytics",
-        eventType: payload.eventType ?? (kind === "identify" ? "identify" : "track"),
-        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        ...this.userId ? { userId: this.userId } : {},
-        anonymousId: this.anonId,
-        // Top-level sessionId so backend `events.session_id` populates (powers
-        // the Audience "Sessions & engagement" metrics). Set by auto-track;
-        // blank until the first auto event of the launch → omitted when empty.
-        ...this.sessionId ? { sessionId: this.sessionId } : {},
-        properties: payload.properties ?? {},
-        context: {
-          platform: "react-native",
-          sdk: { name: "@sendoracloud/sdk-react-native", version: SDK_VERSION },
-          ...device ? { device } : {},
-          ...this.config.environment ? { environment: this.config.environment } : {},
-          ...kind === "identify" ? { traits: payload.traits } : {}
-        }
+    this.eventQueue?.enqueue({
+      ...this.config.projectId ? { projectId: this.config.projectId } : {},
+      module: kind === "identify" ? "profiles" : "analytics",
+      eventType: payload.eventType ?? (kind === "identify" ? "identify" : "track"),
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      ...this.userId ? { userId: this.userId } : {},
+      anonymousId: this.anonId,
+      // Top-level sessionId so backend `events.session_id` populates (powers
+      // the Audience "Sessions & engagement" metrics). Set by auto-track;
+      // blank until the first auto event of the launch → omitted when empty.
+      ...this.sessionId ? { sessionId: this.sessionId } : {},
+      properties: payload.properties ?? {},
+      context: {
+        platform: "react-native",
+        sdk: { name: "@sendoracloud/sdk-react-native", version: SDK_VERSION },
+        ...device ? { device } : {},
+        ...this.config.environment ? { environment: this.config.environment } : {},
+        ...kind === "identify" ? { traits: payload.traits } : {}
       }
-    );
+    });
   }
   assertReady() {
     if (!this.ready || !this.config) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendoracloud/sdk-react-native",
-  "version": "1.38.0",
+  "version": "1.39.1",
   "description": "Sendora Cloud React Native + Expo SDK — analytics, identity, push-token registration, auth (incl. Game Center / Play Games), deep links (Branch / Firebase Dynamic Links parity). Auth + analytics + deep links work in Expo Go; push-token registration and the no-arg Game Center / Play Games sign-in require a Dev Client (EAS Build or `npx expo prebuild`).",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -56,7 +56,7 @@
   "scripts": {
     "build": "tsup src/index.ts src/contact-widget.tsx --format esm,cjs --dts --clean --external react --external react-native --external react-native-webview",
     "typecheck": "tsc --noEmit",
-    "test": "tsx test/secure-storage.test.ts && tsx test/integration-storage.test.ts && tsx test/plugin.test.ts && tsx test/game-auth.test.ts && tsx test/link.test.ts && tsx test/session-preservation.test.ts && tsx test/credential-collision.test.ts && tsx test/token-expiry.test.ts && tsx test/unlink.test.ts && tsx test/deferred-match.test.ts && tsx test/anon-id-stability.test.ts"
+    "test": "tsx test/secure-storage.test.ts && tsx test/integration-storage.test.ts && tsx test/plugin.test.ts && tsx test/game-auth.test.ts && tsx test/link.test.ts && tsx test/session-preservation.test.ts && tsx test/credential-collision.test.ts && tsx test/token-expiry.test.ts && tsx test/unlink.test.ts && tsx test/deferred-match.test.ts && tsx test/anon-id-stability.test.ts && tsx test/event-queue.test.ts"
   },
   "devDependencies": {
     "@types/react": "^19.2.16",