@wireai/activation 0.12.0 → 0.12.1

package/dist/index.js

@@ -1519,17 +1519,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 {
@@ -3317,6 +3317,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"
@@ -3442,6 +3518,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,
@@ -3464,7 +3639,8 @@ var WireOnboarding = ({
   persistKey,
   retainSessionOnComplete,
   userContext,
-  userId
+  userId,
+  autoJoinKey = true
 }) => {
   var _a2, _b, _c;
   const boundUserId = React18.useMemo(() => sanitizeUserId(userId), [userId]);
@@ -3477,9 +3653,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] = React18.useState(void 0);
+  React18.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 = React18.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.";
+  React18.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());
+  React18.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 = React18.useMemo(
-    () => ({ device, userContext: userContextStable, userId: boundUserId }),
-    [device, userContextStable, boundUserId]
+    () => ({ device, userContext: effectiveUserContext, userId: boundUserId }),
+    [device, effectiveUserContext, boundUserId]
   );
   const [session, setSession] = React18.useState(
     () => storage ? null : { id: makeSessionId(), resumed: false }
@@ -3526,7 +3743,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
@@ -3535,7 +3752,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 = React18.useMemo(
     () => ({ serverUrl: config.serverUrl, apiKey: config.apiKey }),
     [config.serverUrl, config.apiKey]
@@ -3557,7 +3774,7 @@ var WireOnboarding = ({
     });
   }, [session, sessionId, boundUserId, reportTarget]);
   const cards = components != null ? components : onboardingComponents;
-  if (!session) {
+  if (!session || autoJoinPending) {
     return /* @__PURE__ */ jsxRuntime.jsx(OnboardingThemeProvider, { theme, children: /* @__PURE__ */ jsxRuntime.jsx(
       LoadingScreen,
       {
@@ -4023,16 +4240,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 } : {}
   };
 };
@@ -4093,149 +4331,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"
@@ -4288,18 +4383,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;
   };
@@ -4562,6 +4658,12 @@ var useSessionStart = (config, options = {}) => {
   const latest = React18.useRef({ config, options });
   latest.current = { config, options };
   React18.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;
@@ -4574,7 +4676,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: reactNative.Platform.OS,
@@ -4908,15 +5010,14 @@ var useLifecycleEvents = (config, options = {}) => {
   latest.current = { config, options };
   const queueRef = React18.useRef(void 0);
   React18.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"}`,
@@ -4926,8 +5027,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;
@@ -4937,7 +5038,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;
@@ -4950,33 +5051,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: reactNative.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: reactNative.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: reactNative.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) => {
@@ -4992,6 +5103,7 @@ var useLifecycleEvents = (config, options = {}) => {
     };
     const sub = reactNative.AppState.addEventListener("change", onChange);
     return () => {
+      cancelled = true;
       if (sub && typeof sub.remove === "function") sub.remove();
     };
   }, []);
@@ -5030,6 +5142,7 @@ exports.StatusCard = StatusCard;
 exports.StepProgress = StepProgress;
 exports.TextInputCard = TextInputCard;
 exports.USER_ID_MAX_LENGTH = USER_ID_MAX_LENGTH;
+exports.WIRE_ENV_VARS = WIRE_ENV_VARS;
 exports.WIRE_ICON_GLYPHS = WIRE_ICON_GLYPHS;
 exports.WIRE_ICON_NAMES = WIRE_ICON_NAMES;
 exports.WIRE_ONBOARDING_EVENTS = WIRE_ONBOARDING_EVENTS;
@@ -5066,6 +5179,7 @@ exports.firstOpenStorageKey = firstOpenStorageKey;
 exports.getActivationRevalidationVersion = getActivationRevalidationVersion;
 exports.getCurrentSessionId = getCurrentSessionId;
 exports.hashEmailFnv1a = hashEmailFnv1a;
+exports.hydrateAutoDeviceKey = hydrateAutoDeviceKey;
 exports.identifyOnboarding = identifyOnboarding;
 exports.isFeaturesFresh = isFeaturesFresh;
 exports.isOnboardingEnabled = isOnboardingEnabled;