@wireai/activation 0.11.0 → 0.12.1

package/dist/index.mjs

@@ -1512,6 +1512,23 @@ var buildEventsRequest = (target, events) => {
     return null;
   }
 };
+var warnOnSkippedEvents = (res) => {
+  if (typeof __DEV__ === "undefined" || !__DEV__) return;
+  if (typeof console === "undefined" || !console.warn) return;
+  try {
+    const json = res == null ? void 0 : res.json;
+    if (typeof json !== "function") return;
+    void Promise.resolve(json.call(res)).then((body) => {
+      const skipped = body == null ? void 0 : body.skipped;
+      if (typeof skipped !== "number" || skipped <= 0) return;
+      console.warn(
+        `[wireai] the server ACCEPTED the /v1/events POST but DISCARDED ${skipped} event(s) (skipped in the response body) \u2014 they are gone, not retried. The usual cause is an event with a missing or empty session_id.`
+      );
+    }).catch(() => {
+    });
+  } catch {
+  }
+};
 var reportClientEvents = (target, events) => {
   try {
     const req = buildEventsRequest(target, events);
@@ -3294,6 +3311,82 @@ var collectDeviceContext = () => {
   return ctx;
 };
 
+// src/context/deviceId.ts
+var AUTO_DEVICE_ID_PREFIX = "wdev_";
+var deviceIdStorageKey = (appId) => `wireai:analytics:deviceKey:${appId != null ? appId : "default"}`;
+var randomChunk = () => Math.floor(Math.random() * 4294967296).toString(36).padStart(6, "0");
+var mintDeviceId = () => {
+  const time = Date.now().toString(36);
+  return `${AUTO_DEVICE_ID_PREFIX}${time}_${randomChunk()}${randomChunk()}`;
+};
+var AUTO_DEVICE_KEY_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:autoDeviceKeys");
+var deviceKeyGlobal = globalThis;
+var autoDeviceKeyRegistry = () => {
+  const existing = deviceKeyGlobal[AUTO_DEVICE_KEY_SLOT];
+  if (existing) return existing;
+  const created = { keys: /* @__PURE__ */ new Map(), hydrating: /* @__PURE__ */ new Set() };
+  deviceKeyGlobal[AUTO_DEVICE_KEY_SLOT] = created;
+  return created;
+};
+var startHydration = (registry, appId, storage, minted) => {
+  if (!registry.pending) registry.pending = /* @__PURE__ */ new Map();
+  const existing = registry.pending.get(appId);
+  if (existing) return existing;
+  const slot = deviceIdStorageKey(appId);
+  const settled = () => {
+    var _a2;
+    return (_a2 = registry.keys.get(appId)) != null ? _a2 : minted;
+  };
+  let run;
+  try {
+    run = Promise.resolve(storage.getItem(slot)).then((saved) => {
+      const persisted = typeof saved === "string" && saved.trim() ? saved.trim() : void 0;
+      if (persisted) {
+        registry.keys.set(appId, persisted);
+        return persisted;
+      }
+      return Promise.resolve(storage.setItem(slot, minted)).then(settled, settled);
+    }).catch(settled);
+  } catch {
+    run = Promise.resolve(settled());
+  }
+  registry.pending.set(appId, run);
+  return run;
+};
+var resolveAutoDeviceKey = (opts = {}) => {
+  var _a2, _b;
+  const registry = autoDeviceKeyRegistry();
+  const appId = (_a2 = opts.appId) != null ? _a2 : "default";
+  let id = registry.keys.get(appId);
+  if (!id) {
+    id = mintDeviceId();
+    registry.keys.set(appId, id);
+  }
+  const storage = opts.storage;
+  if (storage && !registry.hydrating.has(appId)) {
+    registry.hydrating.add(appId);
+    void startHydration(registry, appId, storage, id);
+  }
+  return (_b = registry.keys.get(appId)) != null ? _b : id;
+};
+var hydrateAutoDeviceKey = async (opts = {}) => {
+  var _a2, _b, _c;
+  const id = resolveAutoDeviceKey(opts);
+  if (!opts.storage) return id;
+  const registry = autoDeviceKeyRegistry();
+  const appId = (_a2 = opts.appId) != null ? _a2 : "default";
+  const pending = (_b = registry.pending) == null ? void 0 : _b.get(appId);
+  if (pending) await pending;
+  return (_c = registry.keys.get(appId)) != null ? _c : id;
+};
+var resetAutoDeviceKeys = () => {
+  var _a2;
+  const registry = autoDeviceKeyRegistry();
+  registry.keys.clear();
+  registry.hydrating.clear();
+  (_a2 = registry.pending) == null ? void 0 : _a2.clear();
+};
+
 // src/analytics/currentSession.ts
 var CURRENT_SESSION_ID_SLOT = /* @__PURE__ */ Symbol.for(
   "@wireai/activation:currentSessionId"
@@ -3308,6 +3401,28 @@ var getCurrentSessionId = () => globalSlot[CURRENT_SESSION_ID_SLOT];
 var resetCurrentSessionId = () => {
   globalSlot[CURRENT_SESSION_ID_SLOT] = void 0;
 };
+var warnInDev = (message) => {
+  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+    console.warn(message);
+    return true;
+  }
+  return false;
+};
+var MINT_WARNING = "[wireai] No app-open session was registered, so a session id was minted for this event (the server drops an event that has no session_id, and still answers 200). Mount useLifecycleEvents at your app root so events correlate to a real app-open.";
+var MINT_WARNED_SLOT = /* @__PURE__ */ Symbol.for(
+  "@wireai/activation:currentSessionIdMintWarned"
+);
+var warnSlot = globalThis;
+var ensureCurrentSessionId = () => {
+  const existing = globalSlot[CURRENT_SESSION_ID_SLOT];
+  if (typeof existing === "string" && existing.length > 0) return existing;
+  const minted = makeSessionId();
+  globalSlot[CURRENT_SESSION_ID_SLOT] = minted;
+  if (!warnSlot[MINT_WARNED_SLOT] && warnInDev(MINT_WARNING)) {
+    warnSlot[MINT_WARNED_SLOT] = true;
+  }
+  return minted;
+};
 
 // src/session/persistedSession.ts
 var DEFAULT_SESSION_TTL_MS = 36e5;
@@ -3397,6 +3512,105 @@ var identifyOnboarding = async (opts) => {
   );
   return true;
 };
+
+// src/context/userContext.ts
+var RESERVED_USER_CONTEXT_KEYS = [
+  "device_key",
+  "app_version",
+  "app_build",
+  "network_type",
+  "session_count",
+  "returning",
+  "platform",
+  "user_email",
+  "user_email_hashed"
+];
+var EXTRA_KEY_PREFIX = "custom.";
+var isWireScalar = (value) => {
+  const t = typeof value;
+  if (t === "string" || t === "boolean") return true;
+  if (t === "number") return Number.isFinite(value);
+  return false;
+};
+var hashEmailFnv1a = (email) => {
+  const normalized = email.trim().toLowerCase();
+  let hash = 2166136261;
+  for (let i = 0; i < normalized.length; i++) {
+    hash ^= normalized.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+};
+var cleanString = (value) => {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+};
+var namespaceExtra = (extra) => {
+  const out = {};
+  if (!extra || typeof extra !== "object") return out;
+  for (const [key, value] of Object.entries(extra)) {
+    const cleanKey = cleanString(key);
+    if (!cleanKey) continue;
+    if (!isWireScalar(value)) continue;
+    out[`${EXTRA_KEY_PREFIX}${cleanKey}`] = value;
+  }
+  return out;
+};
+var analyticsUserIdStorageKey = (appId) => `wireai:analytics:userId:${appId != null ? appId : "default"}`;
+var clearPiiFromContext = (ctx = {}) => {
+  const rest = {};
+  if (typeof ctx.appVersion === "string") rest.appVersion = ctx.appVersion;
+  if (typeof ctx.deviceKey === "string") rest.deviceKey = ctx.deviceKey;
+  return rest;
+};
+var clearUserContext = async (opts = {}) => {
+  const storage = opts.storage;
+  if (!storage) return;
+  try {
+    await storage.removeItem(analyticsUserIdStorageKey(opts.appId));
+  } catch {
+  }
+};
+var activationJoinContext = (deviceKey) => {
+  var _a2;
+  return (_a2 = resolveUserContext({ deviceKey }).userContext) != null ? _a2 : {};
+};
+var resolveUserContext = (ctx = {}, opts = {}) => {
+  var _a2;
+  const result = {};
+  const bucket = {};
+  const userId = sanitizeUserId(ctx.userId);
+  if (userId) result.userId = userId;
+  const deviceKey = cleanString(ctx.deviceKey);
+  if (deviceKey) {
+    result.deviceKey = deviceKey;
+    bucket.device_key = deviceKey;
+  }
+  const appVersion = (_a2 = cleanString(ctx.appVersion)) != null ? _a2 : cleanString(opts.autoAppVersion);
+  if (appVersion) {
+    result.appVersion = appVersion;
+    bucket.app_version = appVersion;
+  }
+  const email = cleanString(ctx.userEmail);
+  if (email) {
+    if (ctx.hashEmail) {
+      bucket.user_email = hashEmailFnv1a(email);
+      bucket.user_email_hashed = true;
+    } else {
+      bucket.user_email = email;
+    }
+  }
+  Object.assign(bucket, namespaceExtra(ctx.extra));
+  if (Object.keys(bucket).length > 0) result.userContext = bucket;
+  return result;
+};
+var warnInDev2 = (message) => {
+  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+    console.warn(message);
+  }
+};
+var AUTO_JOIN_HYDRATION_TIMEOUT_MS = 1500;
 var WireOnboarding = ({
   config,
   theme,
@@ -3419,7 +3633,8 @@ var WireOnboarding = ({
   persistKey,
   retainSessionOnComplete,
   userContext,
-  userId
+  userId,
+  autoJoinKey = true
 }) => {
   var _a2, _b, _c;
   const boundUserId = useMemo(() => sanitizeUserId(userId), [userId]);
@@ -3432,9 +3647,50 @@ var WireOnboarding = ({
     () => userContextKey ? JSON.parse(userContextKey) : void 0,
     [userContextKey]
   );
+  const missingJoinKey = typeof (userContextStable == null ? void 0 : userContextStable.device_key) !== "string" || !userContextStable.device_key.trim();
+  const autoJoinPossible = Boolean(storage) && autoJoinKey !== false;
+  const wantsAutoJoin = missingJoinKey && autoJoinPossible;
+  const [autoJoinValue, setAutoJoinValue] = useState(void 0);
+  useEffect(() => {
+    if (!wantsAutoJoin || autoJoinValue !== void 0 || !storage) return;
+    let cancelled = false;
+    const timer = setTimeout(() => {
+      if (!cancelled) setAutoJoinValue(null);
+    }, AUTO_JOIN_HYDRATION_TIMEOUT_MS);
+    void hydrateAutoDeviceKey({ appId: config.appId, storage }).then((key) => {
+      if (cancelled) return;
+      clearTimeout(timer);
+      setAutoJoinValue(key || null);
+    });
+    return () => {
+      cancelled = true;
+      clearTimeout(timer);
+    };
+  }, [wantsAutoJoin, autoJoinValue, config.appId, storage]);
+  const injectedJoinKey = wantsAutoJoin && typeof autoJoinValue === "string" ? autoJoinValue : void 0;
+  const autoJoinPending = wantsAutoJoin && autoJoinValue === void 0;
+  const effectiveUserContext = useMemo(
+    () => injectedJoinKey ? { ...userContextStable, ...activationJoinContext(injectedJoinKey) } : userContextStable,
+    [userContextStable, injectedJoinKey]
+  );
+  const warnMissingJoinKey = missingJoinKey && !injectedJoinKey && !autoJoinPending;
+  const autoJoinReason = autoJoinKey === false ? "you passed autoJoinKey={false}." : !storage ? "it got no `storage` prop, and without persistence its key would be different on every launch, which corrupts min_sessions instead of merely leaving the join empty." : "your `storage` adapter did not answer in time.";
+  useEffect(() => {
+    if (!warnMissingJoinKey) return;
+    warnInDev2(
+      "[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
+    );
+  }, [warnMissingJoinKey, autoJoinReason]);
+  const misspelledJoinKey = missingJoinKey && typeof (userContextStable == null ? void 0 : userContextStable.deviceKey) === "string" && Boolean(userContextStable.deviceKey.trim());
+  useEffect(() => {
+    if (!misspelledJoinKey || !injectedJoinKey) return;
+    warnInDev2(
+      "[wireai] <WireOnboarding> got userContext={{ deviceKey }}, which is NOT the wire key \u2014 the server's device lookup reads `device_key`. The kit auto-injected its own device_key so this session is at least self-consistent, but your app's own events carry YOUR id, so the two still will not join and the `activated` funnel stays zero. Pass userContext={activationJoinContext(deviceKey)} instead."
+    );
+  }, [misspelledJoinKey, injectedJoinKey]);
   const clientContext = useMemo(
-    () => ({ device, userContext: userContextStable, userId: boundUserId }),
-    [device, userContextStable, boundUserId]
+    () => ({ device, userContext: effectiveUserContext, userId: boundUserId }),
+    [device, effectiveUserContext, boundUserId]
   );
   const [session, setSession] = useState(
     () => storage ? null : { id: makeSessionId(), resumed: false }
@@ -3481,7 +3737,7 @@ var WireOnboarding = ({
         // Device snapshot + host-injected user context ride the session-start metadata so the
         // backend can segment the funnel. Old servers ignore these unknown keys (backward compat).
         device,
-        ...userContextStable ? { userContext: userContextStable } : {},
+        ...effectiveUserContext ? { userContext: effectiveUserContext } : {},
         // The session-start user id (from the ref) rides the session-start metadata so the
         // server binds the session to a real user at creation. Reading the ref — not
         // `boundUserId` — keeps this memo off the userId dependency, so a mid-session change
@@ -3490,7 +3746,7 @@ var WireOnboarding = ({
       },
       timeoutMs: 6e4
     };
-  }, [config.serverUrl, config.appId, config.apiKey, metadataStable, sessionId, componentsStable, device, userContextStable]);
+  }, [config.serverUrl, config.appId, config.apiKey, metadataStable, sessionId, componentsStable, device, effectiveUserContext]);
   const reportTarget = useMemo(
     () => ({ serverUrl: config.serverUrl, apiKey: config.apiKey }),
     [config.serverUrl, config.apiKey]
@@ -3512,7 +3768,7 @@ var WireOnboarding = ({
     });
   }, [session, sessionId, boundUserId, reportTarget]);
   const cards = components != null ? components : onboardingComponents;
-  if (!session) {
+  if (!session || autoJoinPending) {
     return /* @__PURE__ */ jsx(OnboardingThemeProvider, { theme, children: /* @__PURE__ */ jsx(
       LoadingScreen,
       {
@@ -3978,16 +4234,37 @@ var useResolvedFeatures = (options) => {
 };
 
 // src/config/wireConfigFromEnv.ts
+var WIRE_ENV_VARS = [
+  "EXPO_PUBLIC_WIREAI_API_KEY",
+  "EXPO_PUBLIC_WIREAI_SERVER_URL",
+  "EXPO_PUBLIC_WIREAI_APP_ID"
+];
+var warnInDev3 = (message) => {
+  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+    console.warn(message);
+  }
+};
 var wireConfigFromEnv = (overrides) => {
-  var _a2, _b, _c, _d;
+  var _a2, _b, _c, _d, _e;
   const apiKey = (_a2 = overrides == null ? void 0 : overrides.apiKey) != null ? _a2 : process.env.EXPO_PUBLIC_WIREAI_API_KEY;
   const serverUrl = (_b = overrides == null ? void 0 : overrides.serverUrl) != null ? _b : process.env.EXPO_PUBLIC_WIREAI_SERVER_URL;
   const appId = (_d = (_c = overrides == null ? void 0 : overrides.appId) != null ? _c : process.env.EXPO_PUBLIC_WIREAI_APP_ID) != null ? _d : "default";
-  if (!apiKey || !serverUrl) return null;
+  if (!apiKey || !serverUrl) {
+    const missing = [
+      apiKey ? void 0 : "EXPO_PUBLIC_WIREAI_API_KEY",
+      serverUrl ? void 0 : "EXPO_PUBLIC_WIREAI_SERVER_URL"
+    ].filter(Boolean);
+    warnInDev3(
+      `[wireai] wireConfigFromEnv() returned null: ${missing.join(" and ")} ${missing.length > 1 ? "are" : "is"} missing. The kit is now FULLY DISABLED (no onboarding, no analytics, no gates) and nothing else will report an error. Set the var(s) in your env / EAS secrets.`
+    );
+    return null;
+  }
+  const appVersion = (_e = overrides == null ? void 0 : overrides.appVersion) != null ? _e : detectAppVersion();
   return {
     apiKey,
     serverUrl,
     appId,
+    ...appVersion ? { appVersion } : {},
     ...(overrides == null ? void 0 : overrides.metadata) ? { metadata: overrides.metadata } : {}
   };
 };
@@ -4048,104 +4325,6 @@ var attributionMetadata = (a) => {
   return { attribution };
 };
 
-// src/context/userContext.ts
-var RESERVED_USER_CONTEXT_KEYS = [
-  "device_key",
-  "app_version",
-  "app_build",
-  "network_type",
-  "session_count",
-  "returning",
-  "platform",
-  "user_email",
-  "user_email_hashed"
-];
-var EXTRA_KEY_PREFIX = "custom.";
-var isWireScalar = (value) => {
-  const t = typeof value;
-  if (t === "string" || t === "boolean") return true;
-  if (t === "number") return Number.isFinite(value);
-  return false;
-};
-var hashEmailFnv1a = (email) => {
-  const normalized = email.trim().toLowerCase();
-  let hash = 2166136261;
-  for (let i = 0; i < normalized.length; i++) {
-    hash ^= normalized.charCodeAt(i);
-    hash = Math.imul(hash, 16777619);
-  }
-  return (hash >>> 0).toString(16).padStart(8, "0");
-};
-var cleanString = (value) => {
-  if (typeof value !== "string") return void 0;
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : void 0;
-};
-var namespaceExtra = (extra) => {
-  const out = {};
-  if (!extra || typeof extra !== "object") return out;
-  for (const [key, value] of Object.entries(extra)) {
-    const cleanKey = cleanString(key);
-    if (!cleanKey) continue;
-    if (!isWireScalar(value)) continue;
-    out[`${EXTRA_KEY_PREFIX}${cleanKey}`] = value;
-  }
-  return out;
-};
-var analyticsUserIdStorageKey = (appId) => `wireai:analytics:userId:${appId != null ? appId : "default"}`;
-var clearPiiFromContext = (ctx = {}) => {
-  const rest = {};
-  if (typeof ctx.appVersion === "string") rest.appVersion = ctx.appVersion;
-  if (typeof ctx.deviceKey === "string") rest.deviceKey = ctx.deviceKey;
-  return rest;
-};
-var clearUserContext = async (opts = {}) => {
-  const storage = opts.storage;
-  if (!storage) return;
-  try {
-    await storage.removeItem(analyticsUserIdStorageKey(opts.appId));
-  } catch {
-  }
-};
-var resolveUserContext = (ctx = {}, opts = {}) => {
-  var _a2;
-  const result = {};
-  const bucket = {};
-  const userId = sanitizeUserId(ctx.userId);
-  if (userId) result.userId = userId;
-  const deviceKey = cleanString(ctx.deviceKey);
-  if (deviceKey) {
-    result.deviceKey = deviceKey;
-    bucket.device_key = deviceKey;
-  }
-  const appVersion = (_a2 = cleanString(ctx.appVersion)) != null ? _a2 : cleanString(opts.autoAppVersion);
-  if (appVersion) {
-    result.appVersion = appVersion;
-    bucket.app_version = appVersion;
-  }
-  const email = cleanString(ctx.userEmail);
-  if (email) {
-    if (ctx.hashEmail) {
-      bucket.user_email = hashEmailFnv1a(email);
-      bucket.user_email_hashed = true;
-    } else {
-      bucket.user_email = email;
-    }
-  }
-  Object.assign(bucket, namespaceExtra(ctx.extra));
-  if (Object.keys(bucket).length > 0) result.userContext = bucket;
-  return result;
-};
-
-// src/context/deviceId.ts
-var AUTO_DEVICE_ID_PREFIX = "wdev_";
-var deviceIdStorageKey = (appId) => `wireai:analytics:deviceKey:${appId != null ? appId : "default"}`;
-var randomChunk = () => Math.floor(Math.random() * 4294967296).toString(36).padStart(6, "0");
-var mintDeviceId = () => {
-  const time = Date.now().toString(36);
-  return `${AUTO_DEVICE_ID_PREFIX}${time}_${randomChunk()}${randomChunk()}`;
-};
-
 // src/activation/revalidation.ts
 var REVALIDATION_SLOT = /* @__PURE__ */ Symbol.for(
   "@wireai/activation:activationRevalidation"
@@ -4192,32 +4371,31 @@ var createWireActivation = (config) => {
   var _a2, _b;
   const target = { serverUrl: config.serverUrl, apiKey: config.apiKey };
   const explicitDeviceKey = (_b = clean(config.deviceKey)) != null ? _b : clean((_a2 = config.userContext) == null ? void 0 : _a2.deviceKey);
-  let autoDeviceKey = explicitDeviceKey != null ? explicitDeviceKey : mintDeviceId();
-  if (config.storage && !explicitDeviceKey) {
-    const storage = config.storage;
-    const key = deviceIdStorageKey(config.appId);
-    void storage.getItem(key).then((saved) => {
-      const persisted = clean(saved != null ? saved : void 0);
-      if (persisted) autoDeviceKey = persisted;
-      else void storage.setItem(key, autoDeviceKey).catch(() => {
-      });
-    }).catch(() => {
-    });
-  }
+  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 _a3, _b2;
+    var _a3, _b2, _c;
     const resolved = resolveUserContext(
-      { ...(_a3 = config.userContext) != null ? _a3 : {}, deviceKey: explicitDeviceKey != null ? explicitDeviceKey : autoDeviceKey },
-      { autoAppVersion: config.appVersion }
+      // `??` is lazy on purpose: an explicit key must never even touch the auto registry.
+      {
+        ...(_a3 = config.userContext) != null ? _a3 : {},
+        deviceKey: explicitDeviceKey != null ? explicitDeviceKey : resolveAutoDeviceKey(autoDeviceKeyOptions)
+      },
+      { autoAppVersion: (_b2 = config.appVersion) != null ? _b2 : detectedAppVersion }
     );
     if (resolved.userContext) {
-      event.user_context = { ...resolved.userContext, ...(_b2 = event.user_context) != null ? _b2 : {} };
+      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 (name2, meta) => {
-    const sessionId = getCurrentSessionId();
-    if (!clean(name2) || !sessionId) return false;
+    if (!clean(name2)) return false;
+    const sessionId = ensureCurrentSessionId();
     const event = {
       event_type: "app_event",
       session_id: sessionId,
@@ -4244,9 +4422,16 @@ var useActivationRevalidation = () => useSyncExternalStore(
   getActivationRevalidationVersion
 );
 var useWireActivation = (config) => {
+  var _a2;
   const ref = useRef(void 0);
   const prevKeys = useRef("");
-  const currentKeys = `${config.serverUrl}|${config.apiKey}|${config.appId}|${config.deviceKey}`;
+  const currentKeys = [
+    config.serverUrl,
+    config.apiKey,
+    config.appId,
+    config.deviceKey,
+    (_a2 = config.userContext) == null ? void 0 : _a2.deviceKey
+  ].join("|");
   if (!ref.current || prevKeys.current !== currentKeys) {
     prevKeys.current = currentKeys;
     ref.current = createWireActivation(config);
@@ -4255,6 +4440,154 @@ var useWireActivation = (config) => {
   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 _a2, _b;
+  const active = asRecord((_b = asRecord((_a2 = asRecord(info)) == null ? void 0 : _a2.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;
+  const writeTier = config.writePlanTier !== false;
+  const emit = (event, props) => {
+    try {
+      const result = analytics.track(event, { ...config.commonProps, ...props });
+      if (result && typeof result.catch === "function") {
+        void result.catch(() => {
+        });
+      }
+    } catch {
+    }
+  };
+  const syncPlanTier = (customerInfo) => {
+    var _a2;
+    const tier = resolvePlanTier(customerInfo, entitlementId);
+    if (!writeTier) return tier;
+    try {
+      (_a2 = analytics.setUserContext) == null ? void 0 : _a2.call(analytics, { extra: { [PLAN_TIER_CONTEXT_KEY]: tier } });
+    } catch {
+    }
+    return tier;
+  };
+  const paywallShown = (offering, props) => {
+    var _a2, _b;
+    const shown = {
+      packages_count: (_b = (_a2 = offering == null ? void 0 : offering.availablePackages) == null ? void 0 : _a2.length) != null ? _b : 0
+    };
+    if (typeof (offering == null ? void 0 : offering.identifier) === "string") shown.offering_id = offering.identifier;
+    emit(WIRE_PURCHASE_EVENTS.paywallShown, { ...shown, ...props });
+  };
+  const checkoutStarted = (pkg, props) => {
+    emit(WIRE_PURCHASE_EVENTS.checkoutStarted, { ...describePackage(pkg), ...props });
+  };
+  const purchaseCompleted = (customerInfo, pkg, props) => {
+    const tier = syncPlanTier(customerInfo);
+    const entitled = tier !== "free";
+    if (entitled) {
+      emit(WIRE_PURCHASE_EVENTS.purchased, {
+        ...describePackage(pkg),
+        ...describeEntitlement(customerInfo, entitlementId),
+        ...props
+      });
+      return true;
+    }
+    emit(WIRE_PURCHASE_EVENTS.purchaseFailed, {
+      ...describePackage(pkg),
+      reason: "not_entitled",
+      code: "unknown",
+      entitlement: entitlementId,
+      ...props
+    });
+    return false;
+  };
+  const purchaseFailed = (error, pkg, props) => {
+    emit(WIRE_PURCHASE_EVENTS.purchaseFailed, {
+      ...describePackage(pkg),
+      ...describeFailure(error),
+      ...props
+    });
+  };
+  const purchasesRestored = (customerInfo, props) => {
+    const tier = syncPlanTier(customerInfo);
+    emit(WIRE_PURCHASE_EVENTS.restored, {
+      ...describeEntitlement(customerInfo, entitlementId),
+      ...props
+    });
+    return tier !== "free";
+  };
+  return { paywallShown, checkoutStarted, purchaseCompleted, purchaseFailed, purchasesRestored, syncPlanTier };
+};
+
 // src/session-analytics/reportSessionStart.ts
 var SESSION_STARTED_EVENT = "app.session_started";
 var _emitted = /* @__PURE__ */ new Set();
@@ -4307,6 +4640,8 @@ var reportSessionStart = (opts) => {
       method: "POST",
       headers,
       body: JSON.stringify({ events: [event] })
+    }).then((res) => {
+      warnOnSkippedEvents(res);
     }).catch(() => {
     });
   } catch {
@@ -4317,6 +4652,12 @@ var useSessionStart = (config, options = {}) => {
   const latest = useRef({ config, options });
   latest.current = { config, options };
   useEffect(() => {
+    const resolveDeviceKey = (cfg, opts) => {
+      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 });
+    };
     const fire = () => {
       var _a2, _b;
       const { config: cfg, options: opts } = latest.current;
@@ -4329,7 +4670,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: opts.deviceKey,
+        deviceKey: resolveDeviceKey(cfg, opts),
         sessionCount: opts.sessionCount,
         appVersion: (_b = cfg.appVersion) != null ? _b : device.appVersion,
         platform: Platform.OS,
@@ -4437,11 +4778,13 @@ var reportFirstOpen = (opts) => {
   })();
 };
 var wireLifecycleEvents = (opts) => {
-  reportFirstOpen(opts);
+  var _a2;
+  const sessionId = (_a2 = opts.sessionId) != null ? _a2 : makeSessionId();
+  reportFirstOpen({ ...opts, sessionId });
   reportSessionStart({
     target: opts.target,
     sink: opts.sink,
-    sessionId: opts.sessionId,
+    sessionId,
     userId: opts.userId,
     deviceKey: opts.deviceKey,
     sessionCount: opts.sessionCount,
@@ -4576,6 +4919,7 @@ var createEventQueue = (options) => {
     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;
@@ -4660,15 +5004,14 @@ var useLifecycleEvents = (config, options = {}) => {
   latest.current = { config, options };
   const queueRef = useRef(void 0);
   useEffect(() => {
-    var _a2;
     const resolveSink = () => {
-      var _a3, _b;
+      var _a2, _b;
       const { config: cfg, options: opts } = latest.current;
       if (opts.sink) return opts.sink;
       if (!(cfg == null ? void 0 : cfg.serverUrl)) return void 0;
       if (!queueRef.current) {
         queueRef.current = createEventQueue({
-          target: { serverUrl: cfg.serverUrl, apiKey: (_a3 = cfg.apiKey) != null ? _a3 : "" },
+          target: { serverUrl: cfg.serverUrl, apiKey: (_a2 = cfg.apiKey) != null ? _a2 : "" },
           storage: cfg.storage,
           // Dedicated key so the hook's internal queue never collides with a host's main queue.
           storageKey: `wireai:evtq:lifecycle:${(_b = cfg.appId) != null ? _b : "default"}`,
@@ -4678,12 +5021,18 @@ var useLifecycleEvents = (config, options = {}) => {
       return queueRef.current.enqueue;
     };
     const targetOf = (cfg) => {
-      var _a3;
-      return (cfg == null ? void 0 : cfg.serverUrl) ? { serverUrl: cfg.serverUrl, apiKey: (_a3 = cfg.apiKey) != null ? _a3 : "" } : void 0;
+      var _a2;
+      return (cfg == null ? void 0 : cfg.serverUrl) ? { serverUrl: cfg.serverUrl, apiKey: (_a2 = cfg.apiKey) != null ? _a2 : "" } : void 0;
+    };
+    const resolveDeviceKey = (cfg, opts) => {
+      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 });
     };
     const mountOpenSessionId = makeSessionId();
     const fireSession = (sessionId) => {
-      var _a3;
+      var _a2;
       const { config: cfg, options: opts } = latest.current;
       if (opts.enabled === false) return;
       if (!(cfg == null ? void 0 : cfg.serverUrl) && !opts.sink) return;
@@ -4694,35 +5043,45 @@ var useLifecycleEvents = (config, options = {}) => {
         sink: resolveSink(),
         sessionId,
         userId: opts.userId,
-        deviceKey: opts.deviceKey,
+        deviceKey: resolveDeviceKey(cfg, opts),
         sessionCount: opts.sessionCount,
-        appVersion: (_a3 = cfg == null ? void 0 : cfg.appVersion) != null ? _a3 : device.appVersion,
+        appVersion: (_a2 = cfg == null ? void 0 : cfg.appVersion) != null ? _a2 : device.appVersion,
         platform: Platform.OS,
         device,
         meta: opts.meta
       });
     };
-    fireSession(mountOpenSessionId);
-    {
+    const fireMountOpen = () => {
+      var _a2;
+      fireSession(mountOpenSessionId);
       const { config: cfg, options: opts } = latest.current;
-      if (opts.enabled !== false) {
-        const device = collectDeviceContext();
-        if (cfg == null ? void 0 : cfg.appVersion) device.appVersion = cfg.appVersion;
-        reportFirstOpen({
-          target: targetOf(cfg),
-          sink: resolveSink(),
-          sessionId: mountOpenSessionId,
-          storage: cfg == null ? void 0 : cfg.storage,
-          appId: cfg == null ? void 0 : cfg.appId,
-          userId: opts.userId,
-          deviceKey: opts.deviceKey,
-          sessionCount: opts.sessionCount,
-          appVersion: (_a2 = cfg == null ? void 0 : cfg.appVersion) != null ? _a2 : device.appVersion,
-          platform: Platform.OS,
-          device,
-          meta: opts.meta
-        });
-      }
+      if (opts.enabled === false) return;
+      const device = collectDeviceContext();
+      if (cfg == null ? void 0 : cfg.appVersion) device.appVersion = cfg.appVersion;
+      reportFirstOpen({
+        target: targetOf(cfg),
+        sink: resolveSink(),
+        sessionId: mountOpenSessionId,
+        storage: cfg == null ? void 0 : cfg.storage,
+        appId: cfg == null ? void 0 : cfg.appId,
+        userId: opts.userId,
+        deviceKey: resolveDeviceKey(cfg, opts),
+        sessionCount: opts.sessionCount,
+        appVersion: (_a2 = cfg == null ? void 0 : cfg.appVersion) != null ? _a2 : device.appVersion,
+        platform: Platform.OS,
+        device,
+        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();
     }
     let backgroundedAt = null;
     const onChange = (state) => {
@@ -4738,11 +5097,12 @@ var useLifecycleEvents = (config, options = {}) => {
     };
     const sub = AppState.addEventListener("change", onChange);
     return () => {
+      cancelled = true;
       if (sub && typeof sub.remove === "function") sub.remove();
     };
   }, []);
 };
 
-export { AUTO_DEVICE_ID_PREFIX, AnimatedSparkle, BACKGROUND_SESSION_MS, CardGridSelectCard, CardHandoff, CenteredModal, ChipSelectCard, CompletionView, DEFAULT_FEATURES_TTL_MS, DEFAULT_SESSION_TTL_MS, DemoOnboarding, DoneBlock, EXTRA_KEY_PREFIX, ErrorBlock, FIRST_OPEN_EVENT, IconRegistryProvider, IllustrationProvider, InterstitialCard, LoadingBlock, LoadingScreen, NumberStepperCard, Button as OnboardingButton, OnboardingFlow, OnboardingScaffold, OnboardingThemeProvider, RESERVED_USER_CONTEXT_KEYS, SESSION_STARTED_EVENT, SelectionCard, StatusCard, StepProgress, TextInputCard, USER_ID_MAX_LENGTH, WIRE_ICON_GLYPHS, WIRE_ICON_NAMES, WIRE_ONBOARDING_EVENTS, WireFeaturesProvider, WireIcon, WireOnboarding, analyticsUserIdStorageKey, attributionMetadata, bumpActivationRevalidation, clearPersistedSession, clearPiiFromContext, clearUserContext, collectDeviceContext, createWireActivation, defaultIllustrations, defaultOnboardingTheme, defaultWireFeatures, deriveAnswers, detectAppVersion, detectNativeModel, deviceIdStorageKey, featuresCacheKey, featuresEqual, fetchWireFeatures, firstOpenStorageKey, getActivationRevalidationVersion, getCurrentSessionId, hashEmailFnv1a, identifyOnboarding, isFeaturesFresh, isOnboardingEnabled, isWireScalar, loadPersistedSession, looksLikeEmail, lookupIconGlyph, makeSessionId, mergeTheme, mintDeviceId, motionSpec_exports as motionSpec, namespaceExtra, onboardingComponents, parseWireFeatures, peekPersistedSession, readCachedFeatures, readProgress, reportClientEvent, reportClientEventAwait, reportClientEvents, reportClientEventsAwait, reportFirstOpen, reportSessionStart, resetActivationRevalidation, resetCurrentSessionId, resetFirstOpenLatch, resetSessionStartGuard, resolveUserContext, sanitizeUserId, savePersistedSession, sessionStorageKey, setCurrentSessionId, subscribeActivationRevalidation, themeFromBrand, toAnalyticsEvent, useActivationRevalidation, useHostIcon, useIllustration, useLifecycleEvents, useOnboardingTheme, useReducedMotion, useResolvedFeatures, useSessionStart, useWireActivation, useWireFeatures, useWireFeaturesContext, wireConfigFromEnv, wireLifecycleEvents, writeCachedFeatures };
+export { AUTO_DEVICE_ID_PREFIX, AnimatedSparkle, BACKGROUND_SESSION_MS, CardGridSelectCard, CardHandoff, CenteredModal, ChipSelectCard, CompletionView, DEFAULT_FEATURES_TTL_MS, DEFAULT_SESSION_TTL_MS, DemoOnboarding, DoneBlock, EXTRA_KEY_PREFIX, ErrorBlock, FIRST_OPEN_EVENT, IconRegistryProvider, IllustrationProvider, InterstitialCard, LoadingBlock, LoadingScreen, NumberStepperCard, Button as OnboardingButton, OnboardingFlow, OnboardingScaffold, OnboardingThemeProvider, PLAN_TIER_CONTEXT_KEY, RESERVED_USER_CONTEXT_KEYS, SESSION_STARTED_EVENT, SelectionCard, StatusCard, StepProgress, TextInputCard, USER_ID_MAX_LENGTH, WIRE_ENV_VARS, WIRE_ICON_GLYPHS, WIRE_ICON_NAMES, WIRE_ONBOARDING_EVENTS, WIRE_PURCHASE_EVENTS, WireFeaturesProvider, WireIcon, WireOnboarding, activationJoinContext, activeEntitlement, analyticsUserIdStorageKey, attributionMetadata, bumpActivationRevalidation, clearPersistedSession, clearPiiFromContext, clearUserContext, collectDeviceContext, createRevenueCatBridge, createWireActivation, defaultIllustrations, defaultOnboardingTheme, defaultWireFeatures, deriveAnswers, describeEntitlement, describeFailure, describePackage, detectAppVersion, detectNativeModel, deviceIdStorageKey, ensureCurrentSessionId, featuresCacheKey, featuresEqual, fetchWireFeatures, firstOpenStorageKey, getActivationRevalidationVersion, getCurrentSessionId, hashEmailFnv1a, hydrateAutoDeviceKey, identifyOnboarding, isFeaturesFresh, isOnboardingEnabled, isUserCancelled, isWireScalar, loadPersistedSession, looksLikeEmail, lookupIconGlyph, makeSessionId, mergeTheme, mintDeviceId, motionSpec_exports as motionSpec, namespaceExtra, onboardingComponents, parseWireFeatures, peekPersistedSession, readCachedFeatures, readProgress, reportClientEvent, reportClientEventAwait, reportClientEvents, reportClientEventsAwait, reportFirstOpen, reportSessionStart, resetActivationRevalidation, resetAutoDeviceKeys, resetCurrentSessionId, resetFirstOpenLatch, resetSessionStartGuard, resolveAutoDeviceKey, resolvePlanTier, resolveUserContext, sanitizeUserId, savePersistedSession, sessionStorageKey, setCurrentSessionId, subscribeActivationRevalidation, themeFromBrand, toAnalyticsEvent, useActivationRevalidation, useHostIcon, useIllustration, useLifecycleEvents, useOnboardingTheme, useReducedMotion, useResolvedFeatures, useSessionStart, useWireActivation, useWireFeatures, useWireFeaturesContext, wireConfigFromEnv, wireLifecycleEvents, writeCachedFeatures };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map