@wireai/activation 0.12.0 → 0.12.2

package/dist/index.mjs

@@ -1513,17 +1513,17 @@ var buildEventsRequest = (target, events) => {
   }
 };
 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;
-      if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
-        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.`
-        );
-      }
+      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 {
@@ -3311,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"
@@ -3436,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,
@@ -3458,7 +3633,8 @@ var WireOnboarding = ({
   persistKey,
   retainSessionOnComplete,
   userContext,
-  userId
+  userId,
+  autoJoinKey = true
 }) => {
   var _a2, _b, _c;
   const boundUserId = useMemo(() => sanitizeUserId(userId), [userId]);
@@ -3471,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 }
@@ -3520,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
@@ -3529,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]
@@ -3551,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,
       {
@@ -4017,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 } : {}
   };
 };
@@ -4087,149 +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 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;
-};
-
-// 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 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);
-    const slot = deviceIdStorageKey(appId);
-    const minted = id;
-    try {
-      void 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);
-        else void Promise.resolve(storage.setItem(slot, minted)).catch(() => {
-        });
-      }).catch(() => {
-      });
-    } catch {
-    }
-  }
-  return (_b = registry.keys.get(appId)) != null ? _b : id;
-};
-var resetAutoDeviceKeys = () => {
-  const registry = autoDeviceKeyRegistry();
-  registry.keys.clear();
-  registry.hydrating.clear();
-};
-
 // src/activation/revalidation.ts
 var REVALIDATION_SLOT = /* @__PURE__ */ Symbol.for(
   "@wireai/activation:activationRevalidation"
@@ -4282,18 +4377,19 @@ var createWireActivation = (config) => {
     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(
       // `??` 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: config.appVersion }
+      { 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;
   };
@@ -4556,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;
@@ -4568,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,
@@ -4902,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"}`,
@@ -4920,8 +5021,8 @@ 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;
@@ -4931,7 +5032,7 @@ var useLifecycleEvents = (config, options = {}) => {
     };
     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;
@@ -4944,33 +5045,43 @@ var useLifecycleEvents = (config, options = {}) => {
         userId: opts.userId,
         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: 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
-        });
-      }
+      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) => {
@@ -4986,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, PLAN_TIER_CONTEXT_KEY, RESERVED_USER_CONTEXT_KEYS, SESSION_STARTED_EVENT, SelectionCard, StatusCard, StepProgress, TextInputCard, USER_ID_MAX_LENGTH, 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, 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 };
+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