@wireai/activation 0.13.6-next.0 → 0.14.0

package/dist/index.js

@@ -1161,7 +1161,10 @@ var readProgress = (response) => {
     key: typeof p.key === "string" ? p.key : void 0,
     // Whitelisted the same way as every other field: an old backend simply omits it.
     slot_id: typeof p.slot_id === "string" ? p.slot_id : void 0,
-    skippable: typeof p.skippable === "boolean" ? p.skippable : void 0
+    skippable: typeof p.skippable === "boolean" ? p.skippable : void 0,
+    // Whitelisted like the rest: a non-string (or absent) arm key reads as "no experiment", never
+    // as an error. The kit does not interpret the value — see `OnboardingProgress.variant`.
+    variant: typeof p.variant === "string" ? p.variant : void 0
   };
 };
 
@@ -1231,20 +1234,21 @@ var reportClientEvents = (target, events) => {
   }
 };
 var reportClientEvent = (target, event) => reportClientEvents(target, [event]);
-var reportClientEventsAwait = async (target, events) => {
+var reportClientEventsAwait = async (target, events) => await reportClientEventsOutcome(target, events) === "delivered";
+var reportClientEventsOutcome = async (target, events) => {
   try {
     const req = buildEventsRequest(target, events);
-    if (!req) return false;
+    if (!req) return "refused";
     const res = await fetch(req.url, req.init);
-    if (!res || !res.ok) return false;
+    if (!res || !res.ok) return "unreachable";
     const ack = await readEventsAck(res);
-    if (!ack || ack.skipped <= 0) return true;
+    if (!ack || ack.skipped <= 0) return "delivered";
     if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
       console.warn(describeDiscarded(ack));
     }
-    return false;
+    return "refused";
   } catch {
-    return false;
+    return "unreachable";
   }
 };
 var reportClientEventAwait = (target, event) => reportClientEventsAwait(target, [event]);
@@ -1703,6 +1707,7 @@ var OnboardingFlow = ({
   const clientContextRef = React19.useRef(clientContext);
   clientContextRef.current = clientContext;
   const lastScreenIndexRef = React19.useRef(-1);
+  const variantRef = React19.useRef(void 0);
   const previewTimer = React19.useRef(null);
   const [runId, setRunId] = React19.useState(0);
   const startedRunRef = React19.useRef(-1);
@@ -1752,14 +1757,17 @@ var OnboardingFlow = ({
   React19.useEffect(() => {
     var _a2, _b2, _c2, _d2;
     setValidationError(void 0);
+    if (variantRef.current === void 0 && progress.variant) variantRef.current = progress.variant;
     if (!(lastCard == null ? void 0 : lastCard.id)) return;
     const step2 = (_a2 = progress.step) != null ? _a2 : renderedCount;
     lastScreenIndexRef.current = Math.max(0, step2 - 1);
-    (_c2 = onEventRef.current) == null ? void 0 : _c2.call(onEventRef, {
+    const turn = {
       type: "turn",
       step: step2,
       component: (_b2 = lastCard.response) == null ? void 0 : _b2.component
-    });
+    };
+    if (variantRef.current !== void 0) turn.variant = variantRef.current;
+    (_c2 = onEventRef.current) == null ? void 0 : _c2.call(onEventRef, turn);
     if (((_d2 = lastCard.response) == null ? void 0 : _d2.component) === "InterstitialCard") {
       sendPreview(reportTargetRef.current, {
         sessionId: sessionIdRef.current,
@@ -1820,6 +1828,7 @@ var OnboardingFlow = ({
     const result = { answers: deriveAnswers(messages), raw: messages };
     const plan = readPlan(messages);
     if (plan !== void 0) result.plan = plan;
+    if (variantRef.current !== void 0) result.variant = variantRef.current;
     onCompleteRef.current(result);
   }, [messages]);
   const handleRetry = React19.useCallback(() => {
@@ -3614,10 +3623,11 @@ var ensureCurrentSessionId = () => {
 var DEFAULT_SESSION_TTL_MS = 36e5;
 var READ_TIMEOUT_MS = 1500;
 var sessionStorageKey = (appId) => `wireai:session:${appId}`;
+var READ_TIMED_OUT = /* @__PURE__ */ Symbol("wireai:storage-read-timeout");
 var withTimeout = (p, ms) => {
   let timer;
   const timeout = new Promise((resolve) => {
-    timer = setTimeout(() => resolve(void 0), ms);
+    timer = setTimeout(() => resolve(READ_TIMED_OUT), ms);
   });
   return Promise.race([p, timeout]).finally(() => clearTimeout(timer));
 };
@@ -3633,12 +3643,14 @@ var parsePersisted = (raw) => {
   return void 0;
 };
 var loadPersistedSession = async (storage, key, ttlMs = DEFAULT_SESSION_TTL_MS) => {
-  let stored;
+  let raw;
   try {
-    stored = parsePersisted(await withTimeout(storage.getItem(key), READ_TIMEOUT_MS));
+    raw = await withTimeout(storage.getItem(key), READ_TIMEOUT_MS);
   } catch {
-    stored = void 0;
+    raw = null;
   }
+  if (raw === READ_TIMED_OUT) return { id: makeSessionId(), resumed: false };
+  const stored = parsePersisted(raw);
   if (stored && Date.now() - stored.ts < ttlMs) {
     return { id: stored.id, resumed: true };
   }
@@ -3648,7 +3660,9 @@ var loadPersistedSession = async (storage, key, ttlMs = DEFAULT_SESSION_TTL_MS)
 };
 var peekPersistedSession = async (storage, key) => {
   try {
-    return parsePersisted(await withTimeout(storage.getItem(key), READ_TIMEOUT_MS));
+    const raw = await withTimeout(storage.getItem(key), READ_TIMEOUT_MS);
+    if (raw === READ_TIMED_OUT) return void 0;
+    return parsePersisted(raw);
   } catch {
     return void 0;
   }
@@ -3801,7 +3815,9 @@ var readSettledPermissions = (raw, sessionId) => {
 };
 var loadSettledPermissions = async (storage, key, sessionId) => {
   try {
-    return readSettledPermissions(await withTimeout(storage.getItem(key), READ_TIMEOUT_MS), sessionId);
+    const raw = await withTimeout(storage.getItem(key), READ_TIMEOUT_MS);
+    if (raw === READ_TIMED_OUT) return [];
+    return readSettledPermissions(raw, sessionId);
   } catch {
     return [];
   }
@@ -3910,7 +3926,7 @@ var WireOnboarding = ({
   React19.useEffect(() => {
     if (!warnMissingJoinKey) return;
     warnInDev(
-      "[wireai] <WireOnboarding> got no user_context.device_key, so this onboarding session can never be joined to the app's later events and the `activated` funnel will read zero. Pass userContext={activationJoinContext(deviceKey)} \u2014 and if your app owns no device id, userContext={activationJoinContext(resolveAutoDeviceKey({ appId, storage }))} returns the SAME id the analytics side stamps. Never hand-write userContext={{ deviceKey }}. The kit did NOT auto-inject its own key here because " + autoJoinReason
+      "[wireai] <WireOnboarding> got no user_context.device_key, so this onboarding session can never be joined to the app's later events and the `activated` funnel will read zero. Pass userContext={activationJoinContext(deviceKey)} if your app owns a device id. If it does NOT, do not build one here \u2014 leave userContext alone and pass a working `storage` instead: the kit injects the same id the analytics side stamps, and only when it has confirmed the id actually persists. Never hand-write userContext={{ deviceKey }}. The kit did NOT auto-inject its own key here because " + autoJoinReason
     );
   }, [warnMissingJoinKey, autoJoinReason]);
   const hostKeyElsewhere = missingJoinKey ? hostIdentity("device", config.appId) : void 0;
@@ -4589,198 +4605,511 @@ var attributionMetadata = (a) => {
   return { attribution };
 };
 
-// src/activation/revalidation.ts
-var REVALIDATION_SLOT = /* @__PURE__ */ Symbol.for(
-  "@wireai/activation:activationRevalidation"
-);
-var globalSlot2 = globalThis;
-var store = () => {
-  const existing = globalSlot2[REVALIDATION_SLOT];
+// src/analytics/eventQueue.ts
+var DEFAULTS = {
+  maxSize: 200,
+  batchSize: 20,
+  baseBackoffMs: 1e3,
+  maxBackoffMs: 3e4,
+  maxRetries: 6
+};
+var READ_TIMEOUT_MS3 = 1500;
+var QUEUE_KEY_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:eventQueueKeys");
+var queueKeyGlobal = globalThis;
+var claimedQueueKeys = () => {
+  const existing = queueKeyGlobal[QUEUE_KEY_SLOT];
   if (existing) return existing;
-  const created = { version: 0, listeners: /* @__PURE__ */ new Set() };
-  globalSlot2[REVALIDATION_SLOT] = created;
+  const created = /* @__PURE__ */ new Set();
+  queueKeyGlobal[QUEUE_KEY_SLOT] = created;
   return created;
 };
-var bumpActivationRevalidation = () => {
-  const s = store();
-  s.version += 1;
-  for (const listener of Array.from(s.listeners)) {
-    try {
-      listener();
-    } catch {
-    }
+var claimQueueKey = (preferred, explicit) => {
+  const claimed = claimedQueueKeys();
+  if (explicit || !claimed.has(preferred)) {
+    claimed.add(preferred);
+    return preferred;
   }
+  let ordinal = 2;
+  while (claimed.has(`${preferred}#${ordinal}`)) ordinal++;
+  const key = `${preferred}#${ordinal}`;
+  claimed.add(key);
+  warnInDev(
+    `[wireai] a second event queue was created for the same appId, and "${preferred}" is already claimed by a live one. Two queues sharing one storage slot overwrite each other's backlog, delete each other's pending events when one drains to empty, and double-send on relaunch, so this queue was given "${key}" instead. Prefer ONE analytics instance per app; if you really need two, pass an explicit \`storageKey\` to each so the slots are yours to reason about.`
+  );
+  return key;
 };
-var subscribeActivationRevalidation = (listener) => {
-  const s = store();
-  s.listeners.add(listener);
-  return () => {
-    s.listeners.delete(listener);
-  };
-};
-var getActivationRevalidationVersion = () => store().version;
-var resetActivationRevalidation = () => {
-  const s = store();
-  s.version = 0;
-  s.listeners.clear();
+var releaseQueueKey = (key) => {
+  claimedQueueKeys().delete(key);
 };
-
-// src/activation/wireActivation.ts
-var clean = cleanString;
-var createWireActivation = (config) => {
-  var _a, _b;
-  const target = { serverUrl: config.serverUrl, apiKey: config.apiKey };
-  const explicitDeviceKey = (_b = clean(config.deviceKey)) != null ? _b : clean((_a = config.userContext) == null ? void 0 : _a.deviceKey);
-  resolveIdentity({
-    value: explicitDeviceKey,
-    space: "device",
-    source: "host",
-    scope: config.appId
+var READ_TIMED_OUT2 = /* @__PURE__ */ Symbol("wireai:storage-read-timeout");
+var withTimeout3 = (p, ms) => {
+  let timer;
+  const timeout = new Promise((resolve) => {
+    timer = setTimeout(() => resolve(READ_TIMED_OUT2), ms);
   });
-  const autoDeviceKeyOptions = {
-    appId: config.appId,
-    // An explicit key opts out of minting AND persisting (unchanged contract).
-    storage: explicitDeviceKey ? void 0 : config.storage
-  };
-  if (!explicitDeviceKey) resolveAutoDeviceKey(autoDeviceKeyOptions);
-  const detectedAppVersion = detectAppVersion();
-  const applyContext = (event) => {
-    var _a2, _b2, _c;
-    const resolved = resolveUserContext(
-      // `??` is lazy on purpose: an explicit key must never even touch the auto registry.
-      {
-        ...(_a2 = config.userContext) != null ? _a2 : {},
-        deviceKey: explicitDeviceKey != null ? explicitDeviceKey : resolveAutoDeviceKey(autoDeviceKeyOptions)
-      },
-      { autoAppVersion: (_b2 = config.appVersion) != null ? _b2 : detectedAppVersion }
-    );
-    if (resolved.userContext) {
-      event.user_context = { ...resolved.userContext, ...(_c = event.user_context) != null ? _c : {} };
-    }
-    if (resolved.userId && !event.user_id) event.user_id = resolved.userId;
-  };
-  const track = async (name, meta) => {
-    if (!clean(name)) return false;
-    const sessionId = ensureCurrentSessionId();
-    const event = {
-      event_type: "app_event",
-      session_id: sessionId,
-      question_key: name
-    };
-    if (meta && Object.keys(meta).length > 0) event.meta = JSON.stringify(meta);
-    applyContext(event);
-    const ok = await reportClientEventAwait(target, event);
-    if (ok) bumpActivationRevalidation();
-    return ok;
-  };
-  return {
-    track,
-    get sessionId() {
-      return getCurrentSessionId();
-    },
-    subscribeRevalidation: subscribeActivationRevalidation,
-    getRevalidationVersion: getActivationRevalidationVersion
-  };
-};
-var useActivationRevalidation = () => React19.useSyncExternalStore(
-  subscribeActivationRevalidation,
-  getActivationRevalidationVersion,
-  getActivationRevalidationVersion
-);
-var useWireActivation = (config) => {
-  var _a;
-  const ref = React19.useRef(void 0);
-  const prevKeys = React19.useRef("");
-  const currentKeys = [
-    config.serverUrl,
-    config.apiKey,
-    config.appId,
-    config.deviceKey,
-    (_a = config.userContext) == null ? void 0 : _a.deviceKey
-  ].join("|");
-  if (!ref.current || prevKeys.current !== currentKeys) {
-    prevKeys.current = currentKeys;
-    ref.current = createWireActivation(config);
-  }
-  const revalidation = useActivationRevalidation();
-  return { track: ref.current.track, sessionId: ref.current.sessionId, revalidation };
-};
-
-// src/revenuecat/purchaseEvents.ts
-var WIRE_PURCHASE_EVENTS = {
-  /** The paywall became visible (offerings loaded). */
-  paywallShown: "wire_paywall_shown",
-  /** The user tapped buy; the store sheet is about to open. */
-  checkoutStarted: "wire_checkout_started",
-  /** The store confirmed the purchase AND the entitlement is now active. */
-  purchased: "wire_purchase_completed",
-  /** The purchase did not land: a user cancel or a real store/network error (see `reason`). */
-  purchaseFailed: "wire_purchase_failed",
-  /** A restore ran (whether or not it produced an entitlement; see `plan_tier`). */
-  restored: "wire_purchase_restored"
-};
-var PLAN_TIER_CONTEXT_KEY = "plan_tier";
-var asRecord = (value) => typeof value === "object" && value !== null ? value : void 0;
-var activeEntitlement = (info, entitlementId) => {
-  var _a, _b;
-  const active = asRecord((_b = asRecord((_a = asRecord(info)) == null ? void 0 : _a.entitlements)) == null ? void 0 : _b.active);
-  const found = active == null ? void 0 : active[entitlementId];
-  const entitlement = asRecord(found);
-  if (!entitlement) return void 0;
-  return entitlement.isActive === false ? void 0 : entitlement;
+  return Promise.race([p, timeout]).finally(() => clearTimeout(timer));
 };
-var isTrial = (entitlement) => typeof entitlement.periodType === "string" && entitlement.periodType.toUpperCase() === "TRIAL";
-var resolvePlanTier = (info, entitlementId) => {
-  const entitlement = activeEntitlement(info, entitlementId);
-  if (!entitlement) return "free";
-  return isTrial(entitlement) ? "trial" : "paid";
+var unrefTimer = (timer) => {
+  const t = timer;
+  if (typeof t.unref === "function") t.unref();
 };
-var describePackage = (pkg) => {
-  const props = {};
-  if (!pkg) return props;
-  if (typeof pkg.identifier === "string") props.package_id = pkg.identifier;
-  if (typeof pkg.packageType === "string") props.package_type = pkg.packageType;
-  if (typeof pkg.offeringIdentifier === "string") props.offering_id = pkg.offeringIdentifier;
-  const product = asRecord(pkg.product);
-  if (product) {
-    if (typeof product.identifier === "string") props.product_id = product.identifier;
-    if (typeof product.price === "number" && Number.isFinite(product.price)) {
-      props.price = product.price;
+var parsePersisted2 = (raw) => {
+  if (!raw) return [];
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) return [];
+    const items = [];
+    for (const entry of parsed) {
+      if (entry && typeof entry === "object" && typeof entry.id === "number" && entry.event && typeof entry.event === "object") {
+        items.push(entry);
+      }
     }
-    if (typeof product.currencyCode === "string") props.currency = product.currencyCode;
+    return items;
+  } catch {
+    return [];
   }
-  return props;
 };
-var describeEntitlement = (info, entitlementId) => {
-  const entitlement = activeEntitlement(info, entitlementId);
-  const props = {
-    entitlement: entitlementId,
-    plan_tier: entitlement ? isTrial(entitlement) ? "trial" : "paid" : "free"
+var createEventQueue = (options) => {
+  var _a, _b, _c, _d, _e, _f, _g;
+  const target = options.target;
+  const storage = options.storage;
+  const defaultKey = (_b = options.storageKey) != null ? _b : `wireai:evtq:${(_a = options.appId) != null ? _a : "default"}`;
+  const key = storage ? claimQueueKey(defaultKey, options.storageKey !== void 0) : defaultKey;
+  const maxSize = (_c = options.maxSize) != null ? _c : DEFAULTS.maxSize;
+  const batchSize = (_d = options.batchSize) != null ? _d : DEFAULTS.batchSize;
+  const baseBackoffMs = (_e = options.baseBackoffMs) != null ? _e : DEFAULTS.baseBackoffMs;
+  const maxBackoffMs = (_f = options.maxBackoffMs) != null ? _f : DEFAULTS.maxBackoffMs;
+  const maxRetries = (_g = options.maxRetries) != null ? _g : DEFAULTS.maxRetries;
+  let pending = [];
+  let nextId = 0;
+  let flushing = false;
+  let attempt = 0;
+  let retryTimer;
+  let disposed = false;
+  let backlogUnread = storage !== void 0;
+  const resolveEnvelope = () => {
+    try {
+      return typeof options.envelope === "function" ? options.envelope() : options.envelope;
+    } catch {
+      return void 0;
+    }
   };
-  if (!entitlement) return props;
-  if (typeof entitlement.periodType === "string") props.period_type = entitlement.periodType;
-  props.is_trial = isTrial(entitlement);
-  if (typeof entitlement.willRenew === "boolean") props.will_renew = entitlement.willRenew;
-  if (typeof entitlement.store === "string") props.store = entitlement.store;
-  if (typeof entitlement.productIdentifier === "string") {
-    props.product_id = entitlement.productIdentifier;
-  }
-  if (typeof entitlement.isSandbox === "boolean") props.is_sandbox = entitlement.isSandbox;
-  return props;
-};
-var PURCHASE_CANCELLED_CODE = "1";
-var isUserCancelled = (error) => {
-  const record = asRecord(error);
-  if (!record) return false;
-  if (record.userCancelled === true) return true;
-  return record.code === PURCHASE_CANCELLED_CODE;
-};
-var describeFailure = (error) => {
-  const record = asRecord(error);
-  const code = typeof (record == null ? void 0 : record.code) === "string" ? record.code : "unknown";
-  return { reason: isUserCancelled(error) ? "cancelled" : "error", code };
-};
-
+  const stamp = (event) => {
+    var _a2;
+    const env = resolveEnvelope();
+    const stamped = { ...event };
+    if (stamped.ts === void 0) stamped.ts = Date.now();
+    if (!env) return stamped;
+    if (!stamped.device && env.device) stamped.device = env.device;
+    if (!stamped.session_id && env.sessionId) stamped.session_id = env.sessionId;
+    const uc = { ...(_a2 = stamped.user_context) != null ? _a2 : {} };
+    if (env.appVersion && uc.app_version === void 0) uc.app_version = env.appVersion;
+    if (env.appBuild && uc.app_build === void 0) uc.app_build = env.appBuild;
+    if (env.networkType && uc.network_type === void 0) uc.network_type = env.networkType;
+    if (Object.keys(uc).length > 0) stamped.user_context = uc;
+    return stamped;
+  };
+  const persist = () => {
+    if (!storage) return;
+    if (disposed) return;
+    if (backlogUnread) return;
+    try {
+      if (pending.length === 0) {
+        void storage.removeItem(key).catch(() => {
+        });
+        return;
+      }
+      const payload = pending.map((item) => ({ id: item.id, event: item.event }));
+      void storage.setItem(key, JSON.stringify(payload)).catch(() => {
+      });
+    } catch {
+    }
+  };
+  const isCountedOpenEvent = (event) => typeof event.question_key === "string" && event.question_key.startsWith("app.");
+  const enforceSizeCap = () => {
+    let overflow = pending.length - maxSize;
+    if (overflow <= 0) return;
+    const kept = [];
+    for (const item of pending) {
+      if (overflow > 0 && !isCountedOpenEvent(item.event)) {
+        overflow--;
+        continue;
+      }
+      kept.push(item);
+    }
+    if (overflow > 0) kept.splice(0, overflow);
+    pending = kept;
+  };
+  const safeSig = (event) => {
+    try {
+      return JSON.stringify(event);
+    } catch {
+      return `__nosig_${nextId}_${Math.random()}`;
+    }
+  };
+  const mergePersisted = (persistedItems) => {
+    if (persistedItems.length === 0) return;
+    const seen = new Set(pending.map((item) => item.sig));
+    const restored = [];
+    for (const persisted of persistedItems) {
+      const sig = safeSig(persisted.event);
+      if (seen.has(sig)) continue;
+      seen.add(sig);
+      restored.push({ id: nextId++, event: persisted.event, sig });
+    }
+    if (restored.length === 0) return;
+    pending = [...restored, ...pending];
+    enforceSizeCap();
+    persist();
+  };
+  const loadPromise = (async () => {
+    if (!storage) return;
+    try {
+      const read = Promise.resolve(storage.getItem(key));
+      read.catch(() => {
+      });
+      const raced = await withTimeout3(read, READ_TIMEOUT_MS3);
+      if (raced === READ_TIMED_OUT2) {
+        backlogUnread = true;
+        warnInDev(
+          `[wireai] the persisted analytics backlog at "${key}" took longer than ${READ_TIMEOUT_MS3}ms to read, so the queue started without it. The stored events are NOT discarded: writes are held back until the read lands, and the backlog is merged in then. If you see this on every cold start, your storage adapter is too slow to be on the launch path.`
+        );
+        void read.then((late) => {
+          backlogUnread = false;
+          mergePersisted(parsePersisted2(late));
+          flush();
+        }).catch(() => {
+          backlogUnread = false;
+          persist();
+        });
+        return;
+      }
+      backlogUnread = false;
+      mergePersisted(parsePersisted2(raced));
+      persist();
+    } catch {
+      backlogUnread = false;
+      persist();
+    }
+  })();
+  const postBatch = async (events) => {
+    const req = buildEventsRequest(target, events);
+    if (!req) return false;
+    const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
+    const timer = setTimeout(() => controller == null ? void 0 : controller.abort(), 15e3);
+    try {
+      const res = await fetch(req.url, { ...req.init, signal: controller == null ? void 0 : controller.signal });
+      warnOnSkippedEvents(res);
+      return !!(res && res.ok);
+    } catch {
+      return false;
+    } finally {
+      clearTimeout(timer);
+    }
+  };
+  const clearRetry = () => {
+    if (retryTimer !== void 0) {
+      clearTimeout(retryTimer);
+      retryTimer = void 0;
+    }
+  };
+  const scheduleRetry = () => {
+    if (attempt >= maxRetries) return;
+    const delay = Math.min(baseBackoffMs * 2 ** attempt, maxBackoffMs);
+    attempt++;
+    clearRetry();
+    retryTimer = setTimeout(() => {
+      retryTimer = void 0;
+      void drain();
+    }, delay);
+    unrefTimer(retryTimer);
+  };
+  const drain = async () => {
+    if (disposed) return;
+    try {
+      await loadPromise;
+    } catch {
+    }
+    if (disposed) return;
+    if (flushing) return;
+    flushing = true;
+    try {
+      while (pending.length > 0) {
+        const batch = pending.slice(0, batchSize);
+        const ok = await postBatch(batch.map((item) => item.event));
+        if (!ok) {
+          scheduleRetry();
+          return;
+        }
+        const acked = new Set(batch.map((item) => item.id));
+        pending = pending.filter((item) => !acked.has(item.id));
+        persist();
+        attempt = 0;
+        clearRetry();
+      }
+    } finally {
+      flushing = false;
+    }
+  };
+  const flush = () => {
+    try {
+      void drain();
+    } catch {
+    }
+  };
+  const enqueue = (event) => {
+    if (disposed) return;
+    try {
+      const stamped = stamp(event);
+      const sig = safeSig(stamped);
+      for (const item of pending) {
+        if (item.sig === sig) return;
+      }
+      pending.push({ id: nextId++, event: stamped, sig });
+      enforceSizeCap();
+      persist();
+      if (retryTimer === void 0) flush();
+    } catch {
+    }
+  };
+  const notifyOnline = () => {
+    attempt = 0;
+    clearRetry();
+    flush();
+  };
+  const size = () => pending.length;
+  const dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    clearRetry();
+    if (storage) releaseQueueKey(key);
+  };
+  return { enqueue, flush, notifyOnline, size, dispose };
+};
+
+// src/activation/revalidation.ts
+var REVALIDATION_SLOT = /* @__PURE__ */ Symbol.for(
+  "@wireai/activation:activationRevalidation"
+);
+var globalSlot2 = globalThis;
+var store = () => {
+  const existing = globalSlot2[REVALIDATION_SLOT];
+  if (existing) return existing;
+  const created = { version: 0, listeners: /* @__PURE__ */ new Set() };
+  globalSlot2[REVALIDATION_SLOT] = created;
+  return created;
+};
+var bumpActivationRevalidation = () => {
+  const s = store();
+  s.version += 1;
+  for (const listener of Array.from(s.listeners)) {
+    try {
+      listener();
+    } catch {
+    }
+  }
+};
+var subscribeActivationRevalidation = (listener) => {
+  const s = store();
+  s.listeners.add(listener);
+  return () => {
+    s.listeners.delete(listener);
+  };
+};
+var getActivationRevalidationVersion = () => store().version;
+var resetActivationRevalidation = () => {
+  const s = store();
+  s.version = 0;
+  s.listeners.clear();
+};
+
+// src/activation/wireActivation.ts
+var clean = cleanString;
+var createWireActivation = (config) => {
+  var _a, _b;
+  const target = { serverUrl: config.serverUrl, apiKey: config.apiKey };
+  const explicitDeviceKey = (_b = clean(config.deviceKey)) != null ? _b : clean((_a = config.userContext) == null ? void 0 : _a.deviceKey);
+  resolveIdentity({
+    value: explicitDeviceKey,
+    space: "device",
+    source: "host",
+    scope: config.appId
+  });
+  const autoDeviceKeyOptions = {
+    appId: config.appId,
+    // An explicit key opts out of minting AND persisting (unchanged contract).
+    storage: explicitDeviceKey ? void 0 : config.storage
+  };
+  if (!explicitDeviceKey) resolveAutoDeviceKey(autoDeviceKeyOptions);
+  const detectedAppVersion = detectAppVersion();
+  const applyContext = (event) => {
+    var _a2, _b2, _c;
+    const resolved = resolveUserContext(
+      // `??` is lazy on purpose: an explicit key must never even touch the auto registry.
+      {
+        ...(_a2 = config.userContext) != null ? _a2 : {},
+        deviceKey: explicitDeviceKey != null ? explicitDeviceKey : resolveAutoDeviceKey(autoDeviceKeyOptions)
+      },
+      { autoAppVersion: (_b2 = config.appVersion) != null ? _b2 : detectedAppVersion }
+    );
+    if (resolved.userContext) {
+      event.user_context = { ...resolved.userContext, ...(_c = event.user_context) != null ? _c : {} };
+    }
+    if (resolved.userId && !event.user_id) event.user_id = resolved.userId;
+  };
+  let durability;
+  const bufferFailedEvent = (event) => {
+    var _a2;
+    if (config.sink) {
+      config.sink(event);
+      return;
+    }
+    if (!durability) {
+      durability = createEventQueue({
+        target,
+        storage: config.storage,
+        storageKey: `wireai:evtq:activation:${(_a2 = config.appId) != null ? _a2 : "default"}`
+      });
+    }
+    durability.enqueue(event);
+  };
+  const track = async (name, meta) => {
+    if (!clean(name)) return false;
+    const sessionId = ensureCurrentSessionId();
+    const event = {
+      event_type: "app_event",
+      session_id: sessionId,
+      question_key: name
+    };
+    if (meta && Object.keys(meta).length > 0) event.meta = JSON.stringify(meta);
+    applyContext(event);
+    const outcome = await reportClientEventsOutcome(target, [event]);
+    const ok = outcome === "delivered";
+    if (ok) bumpActivationRevalidation();
+    if (outcome === "unreachable") bufferFailedEvent(event);
+    return ok;
+  };
+  return {
+    track,
+    get sessionId() {
+      return getCurrentSessionId();
+    },
+    subscribeRevalidation: subscribeActivationRevalidation,
+    getRevalidationVersion: getActivationRevalidationVersion,
+    dispose: () => {
+      durability == null ? void 0 : durability.dispose();
+      durability = void 0;
+    }
+  };
+};
+var useActivationRevalidation = () => React19.useSyncExternalStore(
+  subscribeActivationRevalidation,
+  getActivationRevalidationVersion,
+  getActivationRevalidationVersion
+);
+var useWireActivation = (config) => {
+  var _a, _b;
+  const ref = React19.useRef(void 0);
+  const prevKeys = React19.useRef("");
+  const currentKeys = [
+    config.serverUrl,
+    config.apiKey,
+    config.appId,
+    config.deviceKey,
+    (_a = config.userContext) == null ? void 0 : _a.deviceKey
+  ].join("|");
+  if (!ref.current || prevKeys.current !== currentKeys) {
+    prevKeys.current = currentKeys;
+    (_b = ref.current) == null ? void 0 : _b.dispose();
+    ref.current = createWireActivation(config);
+  }
+  React19.useEffect(
+    () => () => {
+      var _a2;
+      (_a2 = ref.current) == null ? void 0 : _a2.dispose();
+      ref.current = void 0;
+    },
+    []
+  );
+  const revalidation = useActivationRevalidation();
+  return { track: ref.current.track, sessionId: ref.current.sessionId, revalidation };
+};
+
+// src/revenuecat/purchaseEvents.ts
+var WIRE_PURCHASE_EVENTS = {
+  /** The paywall became visible (offerings loaded). */
+  paywallShown: "wire_paywall_shown",
+  /** The user tapped buy; the store sheet is about to open. */
+  checkoutStarted: "wire_checkout_started",
+  /** The store confirmed the purchase AND the entitlement is now active. */
+  purchased: "wire_purchase_completed",
+  /** The purchase did not land: a user cancel or a real store/network error (see `reason`). */
+  purchaseFailed: "wire_purchase_failed",
+  /** A restore ran (whether or not it produced an entitlement; see `plan_tier`). */
+  restored: "wire_purchase_restored"
+};
+var PLAN_TIER_CONTEXT_KEY = "plan_tier";
+var asRecord = (value) => typeof value === "object" && value !== null ? value : void 0;
+var activeEntitlement = (info, entitlementId) => {
+  var _a, _b;
+  const active = asRecord((_b = asRecord((_a = asRecord(info)) == null ? void 0 : _a.entitlements)) == null ? void 0 : _b.active);
+  const found = active == null ? void 0 : active[entitlementId];
+  const entitlement = asRecord(found);
+  if (!entitlement) return void 0;
+  return entitlement.isActive === false ? void 0 : entitlement;
+};
+var isTrial = (entitlement) => typeof entitlement.periodType === "string" && entitlement.periodType.toUpperCase() === "TRIAL";
+var resolvePlanTier = (info, entitlementId) => {
+  const entitlement = activeEntitlement(info, entitlementId);
+  if (!entitlement) return "free";
+  return isTrial(entitlement) ? "trial" : "paid";
+};
+var describePackage = (pkg) => {
+  const props = {};
+  if (!pkg) return props;
+  if (typeof pkg.identifier === "string") props.package_id = pkg.identifier;
+  if (typeof pkg.packageType === "string") props.package_type = pkg.packageType;
+  if (typeof pkg.offeringIdentifier === "string") props.offering_id = pkg.offeringIdentifier;
+  const product = asRecord(pkg.product);
+  if (product) {
+    if (typeof product.identifier === "string") props.product_id = product.identifier;
+    if (typeof product.price === "number" && Number.isFinite(product.price)) {
+      props.price = product.price;
+    }
+    if (typeof product.currencyCode === "string") props.currency = product.currencyCode;
+  }
+  return props;
+};
+var describeEntitlement = (info, entitlementId) => {
+  const entitlement = activeEntitlement(info, entitlementId);
+  const props = {
+    entitlement: entitlementId,
+    plan_tier: entitlement ? isTrial(entitlement) ? "trial" : "paid" : "free"
+  };
+  if (!entitlement) return props;
+  if (typeof entitlement.periodType === "string") props.period_type = entitlement.periodType;
+  props.is_trial = isTrial(entitlement);
+  if (typeof entitlement.willRenew === "boolean") props.will_renew = entitlement.willRenew;
+  if (typeof entitlement.store === "string") props.store = entitlement.store;
+  if (typeof entitlement.productIdentifier === "string") {
+    props.product_id = entitlement.productIdentifier;
+  }
+  if (typeof entitlement.isSandbox === "boolean") props.is_sandbox = entitlement.isSandbox;
+  return props;
+};
+var PURCHASE_CANCELLED_CODE = "1";
+var isUserCancelled = (error) => {
+  const record = asRecord(error);
+  if (!record) return false;
+  if (record.userCancelled === true) return true;
+  return record.code === PURCHASE_CANCELLED_CODE;
+};
+var describeFailure = (error) => {
+  const record = asRecord(error);
+  const code = typeof (record == null ? void 0 : record.code) === "string" ? record.code : "unknown";
+  return { reason: isUserCancelled(error) ? "cancelled" : "error", code };
+};
+
 // src/revenuecat/revenueCatBridge.ts
 var createRevenueCatBridge = (config) => {
   const { analytics, entitlementId } = config;
@@ -4898,15 +5227,9 @@ var reportSessionStart = (opts) => {
       opts.sink(event);
       return;
     }
-    if (!(target == null ? void 0 : target.serverUrl)) return;
-    const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
-    const headers = { "Content-Type": "application/json" };
-    if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
-    void fetch(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({ events: [event] })
-    }).then((res) => {
+    const req = buildEventsRequest(target, [event]);
+    if (!req) return;
+    void fetch(req.url, req.init).then((res) => {
       warnOnSkippedEvents(res);
     }).catch(() => {
     });
@@ -4918,13 +5241,25 @@ var useSessionStart = (config, options = {}) => {
   const latest = React19.useRef({ config, options });
   latest.current = { config, options };
   React19.useEffect(() => {
-    const resolveDeviceKey = (cfg, opts) => {
+    let cancelled = false;
+    const resolveDeviceKey = (opts, autoDeviceKey) => {
       const host = typeof opts.deviceKey === "string" && opts.deviceKey.trim() ? opts.deviceKey : void 0;
       if (host) return host;
-      if (!(cfg == null ? void 0 : cfg.storage)) return void 0;
-      return resolveAutoDeviceKey({ appId: cfg.appId, storage: cfg.storage });
+      return autoDeviceKey;
+    };
+    const openAutoDeviceKey = (fireOpen) => {
+      const { config: cfg, options: opts } = latest.current;
+      const hostKey = typeof opts.deviceKey === "string" && opts.deviceKey.trim() ? opts.deviceKey : void 0;
+      if (hostKey || !(cfg == null ? void 0 : cfg.storage)) {
+        fireOpen(void 0);
+        return;
+      }
+      void hydrateDeviceIdentity({ appId: cfg.appId, storage: cfg.storage }).then((identity) => {
+        if (cancelled) return;
+        fireOpen((identity == null ? void 0 : identity.durable) ? identity.value : void 0);
+      });
     };
-    const fire = () => {
+    const fire = (autoDeviceKey) => {
       var _a, _b;
       const { config: cfg, options: opts } = latest.current;
       if (!(cfg == null ? void 0 : cfg.serverUrl)) return;
@@ -4936,7 +5271,7 @@ var useSessionStart = (config, options = {}) => {
         target,
         // A fresh per-open id each fire; the emitter's once-guard dedupes within the open.
         userId: opts.userId,
-        deviceKey: resolveDeviceKey(cfg, opts),
+        deviceKey: resolveDeviceKey(opts, autoDeviceKey),
         sessionCount: opts.sessionCount,
         appVersion: (_b = cfg.appVersion) != null ? _b : device.appVersion,
         platform: reactNative.Platform.OS,
@@ -4944,7 +5279,7 @@ var useSessionStart = (config, options = {}) => {
         meta: opts.meta
       });
     };
-    fire();
+    openAutoDeviceKey(fire);
     let backgroundedAt = null;
     const onChange = (state) => {
       if (state === "background" || state === "inactive") {
@@ -4954,11 +5289,12 @@ var useSessionStart = (config, options = {}) => {
       if (state === "active") {
         const since = backgroundedAt;
         backgroundedAt = null;
-        if (since != null && Date.now() - since >= BACKGROUND_SESSION_MS) fire();
+        if (since != null && Date.now() - since >= BACKGROUND_SESSION_MS) openAutoDeviceKey(fire);
       }
     };
     const sub = reactNative.AppState.addEventListener("change", onChange);
     return () => {
+      cancelled = true;
       if (sub && typeof sub.remove === "function") sub.remove();
     };
   }, []);
@@ -4967,11 +5303,12 @@ var useSessionStart = (config, options = {}) => {
 // src/session-analytics/lifecycle.ts
 var FIRST_OPEN_EVENT = "app.first_open";
 var firstOpenStorageKey = (appId) => `wireai:first_open:${appId}`;
-var READ_TIMEOUT_MS3 = 1500;
-var withTimeout3 = (p, ms) => {
+var READ_TIMEOUT_MS4 = 1500;
+var READ_TIMED_OUT3 = /* @__PURE__ */ Symbol("wireai:first-open-read-timeout");
+var withTimeout4 = (p, ms) => {
   let timer;
   const timeout = new Promise((resolve) => {
-    timer = setTimeout(() => resolve(void 0), ms);
+    timer = setTimeout(() => resolve(READ_TIMED_OUT3), ms);
   });
   return Promise.race([p, timeout]).finally(() => clearTimeout(timer));
 };
@@ -4990,335 +5327,82 @@ var buildLifecycleEvent = (questionKey, opts) => {
   if (opts.appVersion) userContext.app_version = opts.appVersion;
   if (opts.platform) userContext.platform = opts.platform;
   const event = {
-    event_type: "app_event",
-    question_key: questionKey,
-    session_id: (_a = opts.sessionId) != null ? _a : makeSessionId()
-  };
-  const userId = sanitizeUserId(opts.userId);
-  if (userId) event.user_id = userId;
-  if (Object.keys(userContext).length > 0) event.user_context = userContext;
-  if (opts.device) event.device = opts.device;
-  if (opts.meta && Object.keys(opts.meta).length > 0) event.meta = JSON.stringify(opts.meta);
-  return event;
-};
-var routeLifecycleEvent = (event, opts) => {
-  try {
-    if (opts.sink) {
-      opts.sink(event);
-      return;
-    }
-    const req = buildEventsRequest(opts.target, [event]);
-    if (!req) return;
-    void fetch(req.url, req.init).catch(() => {
-    });
-  } catch {
-  }
-};
-var emitFirstOpen = (opts) => {
-  routeLifecycleEvent(buildLifecycleEvent(FIRST_OPEN_EVENT, opts), opts);
-};
-var reportFirstOpen = (opts) => {
-  var _a;
-  const appId = (_a = opts.appId) != null ? _a : "default";
-  if (_firstOpenLatched.has(appId)) return;
-  _firstOpenLatched.add(appId);
-  const storage = opts.storage;
-  if (!storage) {
-    emitFirstOpen(opts);
-    return;
-  }
-  const key = firstOpenStorageKey(appId);
-  void (async () => {
-    try {
-      const seen = await withTimeout3(storage.getItem(key), READ_TIMEOUT_MS3);
-      if (seen) return;
-      emitFirstOpen(opts);
-      try {
-        void storage.setItem(key, JSON.stringify({ ts: Date.now() })).catch(() => {
-        });
-      } catch {
-      }
-    } catch {
-      emitFirstOpen(opts);
-    }
-  })();
-};
-var wireLifecycleEvents = (opts) => {
-  var _a;
-  const sessionId = (_a = opts.sessionId) != null ? _a : makeSessionId();
-  reportFirstOpen({ ...opts, sessionId });
-  reportSessionStart({
-    target: opts.target,
-    sink: opts.sink,
-    sessionId,
-    userId: opts.userId,
-    deviceKey: opts.deviceKey,
-    sessionCount: opts.sessionCount,
-    appVersion: opts.appVersion,
-    platform: opts.platform,
-    device: opts.device,
-    meta: opts.meta
-  });
-};
-
-// src/analytics/eventQueue.ts
-var DEFAULTS = {
-  maxSize: 200,
-  batchSize: 20,
-  baseBackoffMs: 1e3,
-  maxBackoffMs: 3e4,
-  maxRetries: 6
-};
-var READ_TIMEOUT_MS4 = 1500;
-var QUEUE_KEY_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:eventQueueKeys");
-var queueKeyGlobal = globalThis;
-var claimedQueueKeys = () => {
-  const existing = queueKeyGlobal[QUEUE_KEY_SLOT];
-  if (existing) return existing;
-  const created = /* @__PURE__ */ new Set();
-  queueKeyGlobal[QUEUE_KEY_SLOT] = created;
-  return created;
-};
-var claimQueueKey = (preferred, explicit) => {
-  const claimed = claimedQueueKeys();
-  if (explicit || !claimed.has(preferred)) {
-    claimed.add(preferred);
-    return preferred;
-  }
-  let ordinal = 2;
-  while (claimed.has(`${preferred}#${ordinal}`)) ordinal++;
-  const key = `${preferred}#${ordinal}`;
-  claimed.add(key);
-  warnInDev(
-    `[wireai] a second event queue was created for the same appId, and "${preferred}" is already claimed by a live one. Two queues sharing one storage slot overwrite each other's backlog, delete each other's pending events when one drains to empty, and double-send on relaunch, so this queue was given "${key}" instead. Prefer ONE analytics instance per app; if you really need two, pass an explicit \`storageKey\` to each so the slots are yours to reason about.`
-  );
-  return key;
-};
-var READ_TIMED_OUT = /* @__PURE__ */ Symbol("wireai:storage-read-timeout");
-var withTimeout4 = (p, ms) => {
-  let timer;
-  const timeout = new Promise((resolve) => {
-    timer = setTimeout(() => resolve(READ_TIMED_OUT), ms);
-  });
-  return Promise.race([p, timeout]).finally(() => clearTimeout(timer));
-};
-var unrefTimer = (timer) => {
-  const t = timer;
-  if (typeof t.unref === "function") t.unref();
+    event_type: "app_event",
+    question_key: questionKey,
+    session_id: (_a = opts.sessionId) != null ? _a : makeSessionId()
+  };
+  const userId = sanitizeUserId(opts.userId);
+  if (userId) event.user_id = userId;
+  if (Object.keys(userContext).length > 0) event.user_context = userContext;
+  if (opts.device) event.device = opts.device;
+  if (opts.meta && Object.keys(opts.meta).length > 0) event.meta = JSON.stringify(opts.meta);
+  return event;
 };
-var parsePersisted2 = (raw) => {
-  if (!raw) return [];
+var routeLifecycleEvent = (event, opts) => {
   try {
-    const parsed = JSON.parse(raw);
-    if (!Array.isArray(parsed)) return [];
-    const items = [];
-    for (const entry of parsed) {
-      if (entry && typeof entry === "object" && typeof entry.id === "number" && entry.event && typeof entry.event === "object") {
-        items.push(entry);
-      }
+    if (opts.sink) {
+      opts.sink(event);
+      return;
     }
-    return items;
+    const req = buildEventsRequest(opts.target, [event]);
+    if (!req) return;
+    void fetch(req.url, req.init).catch(() => {
+    });
   } catch {
-    return [];
   }
 };
-var createEventQueue = (options) => {
-  var _a, _b, _c, _d, _e, _f, _g;
-  const target = options.target;
-  const storage = options.storage;
-  const defaultKey = (_b = options.storageKey) != null ? _b : `wireai:evtq:${(_a = options.appId) != null ? _a : "default"}`;
-  const key = storage ? claimQueueKey(defaultKey, options.storageKey !== void 0) : defaultKey;
-  const maxSize = (_c = options.maxSize) != null ? _c : DEFAULTS.maxSize;
-  const batchSize = (_d = options.batchSize) != null ? _d : DEFAULTS.batchSize;
-  const baseBackoffMs = (_e = options.baseBackoffMs) != null ? _e : DEFAULTS.baseBackoffMs;
-  const maxBackoffMs = (_f = options.maxBackoffMs) != null ? _f : DEFAULTS.maxBackoffMs;
-  const maxRetries = (_g = options.maxRetries) != null ? _g : DEFAULTS.maxRetries;
-  let pending = [];
-  let nextId = 0;
-  let flushing = false;
-  let attempt = 0;
-  let retryTimer;
-  let backlogUnread = false;
-  const resolveEnvelope = () => {
-    try {
-      return typeof options.envelope === "function" ? options.envelope() : options.envelope;
-    } catch {
-      return void 0;
-    }
-  };
-  const stamp = (event) => {
-    var _a2;
-    const env = resolveEnvelope();
-    const stamped = { ...event };
-    if (stamped.ts === void 0) stamped.ts = Date.now();
-    if (!env) return stamped;
-    if (!stamped.device && env.device) stamped.device = env.device;
-    if (!stamped.session_id && env.sessionId) stamped.session_id = env.sessionId;
-    const uc = { ...(_a2 = stamped.user_context) != null ? _a2 : {} };
-    if (env.appVersion && uc.app_version === void 0) uc.app_version = env.appVersion;
-    if (env.appBuild && uc.app_build === void 0) uc.app_build = env.appBuild;
-    if (env.networkType && uc.network_type === void 0) uc.network_type = env.networkType;
-    if (Object.keys(uc).length > 0) stamped.user_context = uc;
-    return stamped;
-  };
-  const persist = () => {
-    if (!storage) return;
-    if (backlogUnread) return;
-    try {
-      if (pending.length === 0) {
-        void storage.removeItem(key).catch(() => {
-        });
-        return;
-      }
-      const payload = pending.map((item) => ({ id: item.id, event: item.event }));
-      void storage.setItem(key, JSON.stringify(payload)).catch(() => {
-      });
-    } catch {
-    }
-  };
-  const enforceSizeCap = () => {
-    if (pending.length > maxSize) pending.splice(0, pending.length - maxSize);
-  };
-  const safeSig = (event) => {
-    try {
-      return JSON.stringify(event);
-    } catch {
-      return `__nosig_${nextId}_${Math.random()}`;
-    }
-  };
-  const mergePersisted = (persistedItems) => {
-    if (persistedItems.length === 0) return;
-    const seen = new Set(pending.map((item) => item.sig));
-    const restored = [];
-    for (const persisted of persistedItems) {
-      const sig = safeSig(persisted.event);
-      if (seen.has(sig)) continue;
-      seen.add(sig);
-      restored.push({ id: nextId++, event: persisted.event, sig });
-    }
-    if (restored.length === 0) return;
-    pending = [...restored, ...pending];
-    enforceSizeCap();
-    persist();
-  };
-  const loadPromise = (async () => {
-    if (!storage) return;
+var emitFirstOpen = (opts) => {
+  routeLifecycleEvent(buildLifecycleEvent(FIRST_OPEN_EVENT, opts), opts);
+};
+var reportFirstOpen = (opts) => {
+  var _a;
+  const appId = (_a = opts.appId) != null ? _a : "default";
+  if (_firstOpenLatched.has(appId)) return;
+  _firstOpenLatched.add(appId);
+  const storage = opts.storage;
+  if (!storage) {
+    emitFirstOpen(opts);
+    return;
+  }
+  const key = firstOpenStorageKey(appId);
+  void (async () => {
     try {
-      const read = Promise.resolve(storage.getItem(key));
-      read.catch(() => {
-      });
-      const raced = await withTimeout4(read, READ_TIMEOUT_MS4);
-      if (raced === READ_TIMED_OUT) {
-        backlogUnread = true;
-        warnInDev(
-          `[wireai] the persisted analytics backlog at "${key}" took longer than ${READ_TIMEOUT_MS4}ms to read, so the queue started without it. The stored events are NOT discarded: writes are held back until the read lands, and the backlog is merged in then. If you see this on every cold start, your storage adapter is too slow to be on the launch path.`
-        );
-        void read.then((late) => {
-          backlogUnread = false;
-          mergePersisted(parsePersisted2(late));
-          flush();
-        }).catch(() => {
-          backlogUnread = false;
-          persist();
+      const seen = await withTimeout4(storage.getItem(key), READ_TIMEOUT_MS4);
+      if (seen === READ_TIMED_OUT3) return;
+      if (seen) return;
+      emitFirstOpen(opts);
+      try {
+        void storage.setItem(key, JSON.stringify({ ts: Date.now() })).catch(() => {
         });
-        return;
+      } catch {
       }
-      mergePersisted(parsePersisted2(raced));
     } catch {
     }
   })();
-  const postBatch = async (events) => {
-    const req = buildEventsRequest(target, events);
-    if (!req) return false;
-    const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
-    const timer = setTimeout(() => controller == null ? void 0 : controller.abort(), 15e3);
-    try {
-      const res = await fetch(req.url, { ...req.init, signal: controller == null ? void 0 : controller.signal });
-      warnOnSkippedEvents(res);
-      return !!(res && res.ok);
-    } catch {
-      return false;
-    } finally {
-      clearTimeout(timer);
-    }
-  };
-  const clearRetry = () => {
-    if (retryTimer !== void 0) {
-      clearTimeout(retryTimer);
-      retryTimer = void 0;
-    }
-  };
-  const scheduleRetry = () => {
-    if (attempt >= maxRetries) return;
-    const delay = Math.min(baseBackoffMs * 2 ** attempt, maxBackoffMs);
-    attempt++;
-    clearRetry();
-    retryTimer = setTimeout(() => {
-      retryTimer = void 0;
-      void drain();
-    }, delay);
-    unrefTimer(retryTimer);
-  };
-  const drain = async () => {
-    try {
-      await loadPromise;
-    } catch {
-    }
-    if (flushing) return;
-    flushing = true;
-    try {
-      while (pending.length > 0) {
-        const batch = pending.slice(0, batchSize);
-        const ok = await postBatch(batch.map((item) => item.event));
-        if (!ok) {
-          scheduleRetry();
-          return;
-        }
-        const acked = new Set(batch.map((item) => item.id));
-        pending = pending.filter((item) => !acked.has(item.id));
-        persist();
-        attempt = 0;
-        clearRetry();
-      }
-    } finally {
-      flushing = false;
-    }
-  };
-  const flush = () => {
-    try {
-      void drain();
-    } catch {
-    }
-  };
-  const enqueue = (event) => {
-    try {
-      const stamped = stamp(event);
-      const sig = safeSig(stamped);
-      for (const item of pending) {
-        if (item.sig === sig) return;
-      }
-      pending.push({ id: nextId++, event: stamped, sig });
-      enforceSizeCap();
-      persist();
-      if (retryTimer === void 0) flush();
-    } catch {
-    }
-  };
-  const notifyOnline = () => {
-    attempt = 0;
-    clearRetry();
-    flush();
-  };
-  const size = () => pending.length;
-  return { enqueue, flush, notifyOnline, size };
 };
-
-// src/session-analytics/useLifecycleEvents.ts
+var wireLifecycleEvents = (opts) => {
+  var _a;
+  const sessionId = (_a = opts.sessionId) != null ? _a : makeSessionId();
+  reportFirstOpen({ ...opts, sessionId });
+  reportSessionStart({
+    target: opts.target,
+    sink: opts.sink,
+    sessionId,
+    userId: opts.userId,
+    deviceKey: opts.deviceKey,
+    sessionCount: opts.sessionCount,
+    appVersion: opts.appVersion,
+    platform: opts.platform,
+    device: opts.device,
+    meta: opts.meta
+  });
+};
 var useLifecycleEvents = (config, options = {}) => {
   const latest = React19.useRef({ config, options });
   latest.current = { config, options };
   const queueRef = React19.useRef(void 0);
   React19.useEffect(() => {
+    let cancelled = false;
     const resolveSink = () => {
       var _a, _b;
       const { config: cfg, options: opts } = latest.current;
@@ -5339,7 +5423,7 @@ var useLifecycleEvents = (config, options = {}) => {
       var _a;
       return (cfg == null ? void 0 : cfg.serverUrl) ? { serverUrl: cfg.serverUrl, apiKey: (_a = cfg.apiKey) != null ? _a : "" } : void 0;
     };
-    const resolveDeviceKey = (cfg, opts) => {
+    const resolveDeviceKey = (cfg, opts, autoDeviceKey) => {
       var _a;
       const host = (_a = resolveIdentity({
         value: opts.deviceKey,
@@ -5348,11 +5432,22 @@ var useLifecycleEvents = (config, options = {}) => {
         scope: cfg == null ? void 0 : cfg.appId
       })) == null ? void 0 : _a.value;
       if (host) return host;
-      if (!(cfg == null ? void 0 : cfg.storage)) return void 0;
-      return resolveAutoDeviceKey({ appId: cfg.appId, storage: cfg.storage });
+      return autoDeviceKey;
+    };
+    const openAutoDeviceKey = (fire) => {
+      const { config: cfg, options: opts } = latest.current;
+      const hostKey = typeof opts.deviceKey === "string" && opts.deviceKey.trim() ? opts.deviceKey : void 0;
+      if (hostKey || !(cfg == null ? void 0 : cfg.storage)) {
+        fire(void 0);
+        return;
+      }
+      void hydrateDeviceIdentity({ appId: cfg.appId, storage: cfg.storage }).then((identity) => {
+        if (cancelled) return;
+        fire((identity == null ? void 0 : identity.durable) ? identity.value : void 0);
+      });
     };
     const mountOpenSessionId = makeSessionId();
-    const fireSession = (sessionId) => {
+    const fireSession = (sessionId, autoDeviceKey) => {
       var _a;
       const { config: cfg, options: opts } = latest.current;
       if (opts.enabled === false) return;
@@ -5364,7 +5459,7 @@ var useLifecycleEvents = (config, options = {}) => {
         sink: resolveSink(),
         sessionId,
         userId: opts.userId,
-        deviceKey: resolveDeviceKey(cfg, opts),
+        deviceKey: resolveDeviceKey(cfg, opts, autoDeviceKey),
         sessionCount: opts.sessionCount,
         appVersion: (_a = cfg == null ? void 0 : cfg.appVersion) != null ? _a : device.appVersion,
         platform: reactNative.Platform.OS,
@@ -5372,9 +5467,9 @@ var useLifecycleEvents = (config, options = {}) => {
         meta: opts.meta
       });
     };
-    const fireMountOpen = () => {
+    const fireMountOpen = (autoDeviceKey) => {
       var _a;
-      fireSession(mountOpenSessionId);
+      fireSession(mountOpenSessionId, autoDeviceKey);
       const { config: cfg, options: opts } = latest.current;
       if (opts.enabled === false) return;
       const device = collectDeviceContext();
@@ -5386,7 +5481,7 @@ var useLifecycleEvents = (config, options = {}) => {
         storage: cfg == null ? void 0 : cfg.storage,
         appId: cfg == null ? void 0 : cfg.appId,
         userId: opts.userId,
-        deviceKey: resolveDeviceKey(cfg, opts),
+        deviceKey: resolveDeviceKey(cfg, opts, autoDeviceKey),
         sessionCount: opts.sessionCount,
         appVersion: (_a = cfg == null ? void 0 : cfg.appVersion) != null ? _a : device.appVersion,
         platform: reactNative.Platform.OS,
@@ -5394,16 +5489,7 @@ var useLifecycleEvents = (config, options = {}) => {
         meta: opts.meta
       });
     };
-    let cancelled = false;
-    const { config: mountCfg, options: mountOpts } = latest.current;
-    const hostKey = typeof mountOpts.deviceKey === "string" && mountOpts.deviceKey.trim() ? mountOpts.deviceKey : void 0;
-    if (!hostKey && (mountCfg == null ? void 0 : mountCfg.storage)) {
-      void hydrateAutoDeviceKey({ appId: mountCfg.appId, storage: mountCfg.storage }).then(() => {
-        if (!cancelled) fireMountOpen();
-      });
-    } else {
-      fireMountOpen();
-    }
+    openAutoDeviceKey(fireMountOpen);
     let backgroundedAt = null;
     const onChange = (state) => {
       if (state === "background" || state === "inactive") {
@@ -5413,13 +5499,18 @@ var useLifecycleEvents = (config, options = {}) => {
       if (state === "active") {
         const since = backgroundedAt;
         backgroundedAt = null;
-        if (since != null && Date.now() - since >= BACKGROUND_SESSION_MS) fireSession();
+        if (since != null && Date.now() - since >= BACKGROUND_SESSION_MS) {
+          openAutoDeviceKey((autoDeviceKey) => fireSession(void 0, autoDeviceKey));
+        }
       }
     };
     const sub = reactNative.AppState.addEventListener("change", onChange);
     return () => {
+      var _a;
       cancelled = true;
       if (sub && typeof sub.remove === "function") sub.remove();
+      (_a = queueRef.current) == null ? void 0 : _a.dispose();
+      queueRef.current = void 0;
     };
   }, []);
 };