@wireai/activation 0.12.1 → 0.13.0

package/dist/index.mjs

@@ -1006,26 +1006,26 @@ var _OnboardingScaffold = ({
   children
 }) => {
   const t = useOnboardingTheme();
-  const styles18 = useMemo(() => makeStyles(t), [t]);
+  const styles17 = useMemo(() => makeStyles(t), [t]);
   const hit = { top: 12, bottom: 12, left: 12, right: 12 };
   return /* @__PURE__ */ jsxs(
     SafeAreaView,
     {
       edges: ["top", "bottom"],
-      style: [styles18.flex, { backgroundColor: t.colors.background }],
+      style: [styles17.flex, { backgroundColor: t.colors.background }],
       children: [
-        /* @__PURE__ */ jsxs(View, { style: [styles18.header, { paddingHorizontal: t.spacing.md, paddingTop: t.spacing.md }], children: [
-          /* @__PURE__ */ jsx(View, { style: styles18.progressWrap, children: /* @__PURE__ */ jsx(StepProgress, { step, complete, approxScreens }) }),
-          onSkip ? /* @__PURE__ */ jsx(TouchableOpacity, { onPress: onSkip, hitSlop: hit, style: styles18.skip, children: /* @__PURE__ */ jsx(Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted }], children: skipLabel }) }) : null
+        /* @__PURE__ */ jsxs(View, { style: [styles17.header, { paddingHorizontal: t.spacing.md, paddingTop: t.spacing.md }], children: [
+          /* @__PURE__ */ jsx(View, { style: styles17.progressWrap, children: /* @__PURE__ */ jsx(StepProgress, { step, complete, approxScreens }) }),
+          onSkip ? /* @__PURE__ */ jsx(TouchableOpacity, { onPress: onSkip, hitSlop: hit, style: styles17.skip, children: /* @__PURE__ */ jsx(Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted }], children: skipLabel }) }) : null
         ] }),
         /* @__PURE__ */ jsx(
           View,
           {
-            style: [styles18.body, { paddingHorizontal: t.spacing.md, paddingTop: t.spacing.md }],
+            style: [styles17.body, { paddingHorizontal: t.spacing.md, paddingTop: t.spacing.md }],
             children
           }
         ),
-        onBack ? /* @__PURE__ */ jsx(View, { style: [styles18.footer, { paddingHorizontal: t.spacing.md, paddingBottom: t.spacing.sm }], children: /* @__PURE__ */ jsx(TouchableOpacity, { onPress: onBack, hitSlop: hit, children: /* @__PURE__ */ jsx(Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted }], children: backLabel }) }) }) : null
+        onBack ? /* @__PURE__ */ jsx(View, { style: [styles17.footer, { paddingHorizontal: t.spacing.md, paddingBottom: t.spacing.sm }], children: /* @__PURE__ */ jsx(TouchableOpacity, { onPress: onBack, hitSlop: hit, children: /* @__PURE__ */ jsx(Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted }], children: backLabel }) }) }) : null
       ]
     }
   );
@@ -1162,10 +1162,10 @@ var _CardLayout = ({
   titleNode
 }) => {
   const t = useOnboardingTheme();
-  const styles18 = useMemo(() => makeStyles2(t), [t]);
+  const styles17 = useMemo(() => makeStyles2(t), [t]);
   const hasHeader = !!title || !!subtitle || !!titleNode;
-  return /* @__PURE__ */ jsxs(KeyboardAvoidingView, { style: styles18.fill, behavior: "padding", children: [
-    hasHeader ? /* @__PURE__ */ jsxs(View, { style: styles18.header, children: [
+  return /* @__PURE__ */ jsxs(KeyboardAvoidingView, { style: styles17.fill, behavior: "padding", children: [
+    hasHeader ? /* @__PURE__ */ jsxs(View, { style: styles17.header, children: [
       titleNode != null ? titleNode : title ? /* @__PURE__ */ jsx(Text, { style: [labelStyle(t.fonts), { color: t.colors.text }], children: title }) : null,
       subtitle ? /* @__PURE__ */ jsx(
         Text,
@@ -1181,10 +1181,10 @@ var _CardLayout = ({
     /* @__PURE__ */ jsx(
       ScrollView,
       {
-        style: styles18.fill,
+        style: styles17.fill,
         contentContainerStyle: [
-          styles18.scrollContent,
-          align === "center" && styles18.center
+          styles17.scrollContent,
+          align === "center" && styles17.center
         ],
         keyboardShouldPersistTaps: "handled",
         keyboardDismissMode: "on-drag",
@@ -1192,7 +1192,7 @@ var _CardLayout = ({
         children
       }
     ),
-    footer ? /* @__PURE__ */ jsx(View, { style: styles18.footer, children: footer }) : null
+    footer ? /* @__PURE__ */ jsx(View, { style: styles17.footer, children: footer }) : null
   ] });
 };
 var CardLayout = React18.memo(_CardLayout);
@@ -1474,7 +1474,7 @@ var deriveAnswers = (messages) => {
     const props = (_a2 = r.props) != null ? _a2 : {};
     const progress = props.progress;
     const questionText = (_c = (_b = props.title) != null ? _b : props.label) != null ? _c : props.question;
-    const key = (progress == null ? void 0 : progress.key) || questionText;
+    const key = (progress == null ? void 0 : progress.slot_id) || (progress == null ? void 0 : progress.key) || questionText;
     const reply = messages[i + 1];
     if (key && (reply == null ? void 0 : reply.role) === "user") {
       out[key] = tryParse(stripPrefix(reply.content));
@@ -1495,6 +1495,8 @@ var readProgress = (response) => {
     step: typeof p.step === "number" ? p.step : void 0,
     total: typeof p.total === "number" ? p.total : void 0,
     key: typeof p.key === "string" ? p.key : void 0,
+    // Whitelisted the same way as every other field: an old backend simply omits it.
+    slot_id: typeof p.slot_id === "string" ? p.slot_id : void 0,
     skippable: typeof p.skippable === "boolean" ? p.skippable : void 0
   };
 };
@@ -1512,28 +1514,35 @@ var buildEventsRequest = (target, events) => {
     return null;
   }
 };
-var warnOnSkippedEvents = (res) => {
-  if (typeof __DEV__ === "undefined" || !__DEV__) return;
-  if (typeof console === "undefined" || !console.warn) return;
+var readEventsAck = async (res) => {
   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(() => {
-    });
+    if (typeof json !== "function") return void 0;
+    const body = await Promise.resolve(json.call(res));
+    const skipped = body == null ? void 0 : body.skipped;
+    if (typeof skipped !== "number" || !Number.isFinite(skipped)) return void 0;
+    const reasons = Array.isArray(body == null ? void 0 : body.errors) ? body.errors.map((e) => e == null ? void 0 : e.reason).filter((r) => typeof r === "string") : [];
+    return { written: typeof (body == null ? void 0 : body.written) === "number" ? body.written : void 0, skipped, reasons };
   } catch {
+    return void 0;
   }
 };
+var describeDiscarded = (ack) => `[wireai] the server ACCEPTED the /v1/events POST but DISCARDED ${ack.skipped} event(s) (skipped in the response body) \u2014 they are gone, not retried. The server reported: skipped=${ack.skipped}${ack.written !== void 0 ? `, written=${ack.written}` : ""}` + (ack.reasons.length > 0 ? `, reasons: ${ack.reasons.join(", ")}.` : ". It gave no reason (the endpoint folds every rejection into one count), so check the server's ingest log for this request rather than guessing.");
+var warnOnSkippedEvents = (res) => {
+  if (typeof __DEV__ === "undefined" || !__DEV__) return;
+  if (typeof console === "undefined" || !console.warn) return;
+  void readEventsAck(res).then((ack) => {
+    if (!ack || ack.skipped <= 0) return;
+    console.warn(describeDiscarded(ack));
+  });
+};
 var reportClientEvents = (target, events) => {
   try {
     const req = buildEventsRequest(target, events);
     if (!req) return;
-    void fetch(req.url, req.init).catch(() => {
+    void fetch(req.url, req.init).then((res) => {
+      warnOnSkippedEvents(res);
+    }).catch(() => {
     });
   } catch {
   }
@@ -1544,7 +1553,13 @@ var reportClientEventsAwait = async (target, events) => {
     const req = buildEventsRequest(target, events);
     if (!req) return false;
     const res = await fetch(req.url, req.init);
-    return Boolean(res && res.ok);
+    if (!res || !res.ok) return false;
+    const ack = await readEventsAck(res);
+    if (!ack || ack.skipped <= 0) return true;
+    if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+      console.warn(describeDiscarded(ack));
+    }
+    return false;
   } catch {
     return false;
   }
@@ -1764,8 +1779,8 @@ var OnboardingFlow = ({
     (messageId) => {
       var _a3;
       const base = makeActions(messageId);
-      const key = progress.key;
-      const validator = key ? (_a3 = validatorsRef.current) == null ? void 0 : _a3[key] : void 0;
+      const validators2 = validatorsRef.current;
+      const validator = (_a3 = progress.slot_id ? validators2 == null ? void 0 : validators2[progress.slot_id] : void 0) != null ? _a3 : progress.key ? validators2 == null ? void 0 : validators2[progress.key] : void 0;
       if (!validator) return base;
       const out = { ...base };
       for (const name2 of ANSWER_CALLBACKS) {
@@ -1790,7 +1805,7 @@ var OnboardingFlow = ({
       }
       return out;
     },
-    [makeActions, progress.key]
+    [makeActions, progress.key, progress.slot_id]
   );
   if (degraded) {
     if (fallbackFlow !== void 0) return /* @__PURE__ */ jsx(Fragment, { children: fallbackFlow });
@@ -2101,7 +2116,7 @@ var _TextInputCard = ({
   lines = 6
 }) => {
   const t = useOnboardingTheme();
-  const styles18 = useMemo(() => makeStyles3(t), [t]);
+  const styles17 = useMemo(() => makeStyles3(t), [t]);
   const { height: screenHeight } = useWindowDimensions();
   const [value, setValue] = useState("");
   const [submitted, setSubmitted] = useState(false);
@@ -2128,7 +2143,7 @@ var _TextInputCard = ({
           disabled: !value.trim() || locked
         }
       ),
-      children: /* @__PURE__ */ jsxs(View, { style: styles18.row, children: [
+      children: /* @__PURE__ */ jsxs(View, { style: styles17.row, children: [
         /* @__PURE__ */ jsx(
           TextInput,
           {
@@ -2142,7 +2157,7 @@ var _TextInputCard = ({
             textAlignVertical: multiline ? "top" : "center",
             style: [
               bodyStyle(t.fonts),
-              styles18.input,
+              styles17.input,
               {
                 color: t.colors.text,
                 backgroundColor: t.colors.surface,
@@ -2868,7 +2883,7 @@ var _NumberStepperCard = ({
   onSubmit
 }) => {
   const t = useOnboardingTheme();
-  const styles18 = useMemo(() => makeStyles4(t), [t]);
+  const styles17 = useMemo(() => makeStyles4(t), [t]);
   const safeMin = safeNum(min, 1);
   const safeMaxRaw = safeNum(max, 30);
   const safeMax = safeMaxRaw < safeMin ? safeMin : safeMaxRaw;
@@ -2892,7 +2907,7 @@ var _NumberStepperCard = ({
   const atMin = value <= safeMin;
   const atMax = value >= safeMax;
   const stepBtnStyle = (disabled) => [
-    styles18.stepBtn,
+    styles17.stepBtn,
     { borderRadius: t.radius.full, backgroundColor: t.colors.background, borderColor: disabled ? t.colors.border : t.colors.primary }
   ];
   return /* @__PURE__ */ jsx(
@@ -2901,10 +2916,10 @@ var _NumberStepperCard = ({
       title: label,
       align: "center",
       footer: /* @__PURE__ */ jsx(Button, { title: submitLabel, onPress: handleSubmit, variant: "primary", disabled: submitted }),
-      children: /* @__PURE__ */ jsxs(View, { style: styles18.wrap, children: [
-        /* @__PURE__ */ jsxs(View, { style: [styles18.stepper, { gap: t.spacing.lg }], children: [
+      children: /* @__PURE__ */ jsxs(View, { style: styles17.wrap, children: [
+        /* @__PURE__ */ jsxs(View, { style: [styles17.stepper, { gap: t.spacing.lg }], children: [
           /* @__PURE__ */ jsx(Pressable, { onPress: atMin || submitted ? void 0 : handleDecrement, disabled: atMin || submitted, style: stepBtnStyle(atMin), children: /* @__PURE__ */ jsx(Text, { style: [headingStyle(t.fonts), { color: atMin ? t.colors.textMuted : t.colors.primary }], children: "\u2212" }) }),
-          /* @__PURE__ */ jsxs(View, { style: styles18.valueBox, children: [
+          /* @__PURE__ */ jsxs(View, { style: styles17.valueBox, children: [
             /* @__PURE__ */ jsx(Text, { style: [headingStyle(t.fonts), { color: t.colors.primary }], children: String(value) }),
             unit ? /* @__PURE__ */ jsx(Text, { style: [captionStyle(t.fonts), { color: t.colors.textMuted }], children: unit }) : null
           ] }),
@@ -3311,6 +3326,33 @@ var collectDeviceContext = () => {
   return ctx;
 };
 
+// src/identity/identityRecord.ts
+var IDENTITY_PROVENANCE_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:identityProvenance");
+var provenanceGlobal = globalThis;
+var provenanceRegistry = () => {
+  const existing = provenanceGlobal[IDENTITY_PROVENANCE_SLOT];
+  if (existing) return existing;
+  const created = { host: /* @__PURE__ */ new Map() };
+  provenanceGlobal[IDENTITY_PROVENANCE_SLOT] = created;
+  return created;
+};
+var provenanceKey = (space, scope) => `${space}:${scope != null ? scope : "default"}`;
+var resolveIdentity = (input) => {
+  var _a2;
+  if (typeof input.value !== "string") return void 0;
+  const value = input.value.trim();
+  if (!value) return void 0;
+  const durable = (_a2 = input.durable) != null ? _a2 : input.source === "host";
+  if (input.source === "host") {
+    provenanceRegistry().host.set(provenanceKey(input.space, input.scope), value);
+  }
+  return { value, space: input.space, source: input.source, durable };
+};
+var hostIdentity = (space, scope) => provenanceRegistry().host.get(provenanceKey(space, scope));
+var resetIdentityProvenance = () => {
+  provenanceRegistry().host.clear();
+};
+
 // src/context/deviceId.ts
 var AUTO_DEVICE_ID_PREFIX = "wdev_";
 var deviceIdStorageKey = (appId) => `wireai:analytics:deviceKey:${appId != null ? appId : "default"}`;
@@ -3333,24 +3375,37 @@ var startHydration = (registry, appId, storage, minted) => {
   const existing = registry.pending.get(appId);
   if (existing) return existing;
   const slot = deviceIdStorageKey(appId);
-  const settled = () => {
+  const degraded = () => {
     var _a2;
-    return (_a2 = registry.keys.get(appId)) != null ? _a2 : minted;
+    return { value: (_a2 = registry.keys.get(appId)) != null ? _a2 : minted, durable: false };
   };
+  const adopted = (value) => ({ value, durable: true });
   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 adopted(persisted);
       }
-      return Promise.resolve(storage.setItem(slot, minted)).then(settled, settled);
-    }).catch(settled);
+      return Promise.resolve(storage.setItem(slot, minted)).then(
+        () => {
+          var _a2;
+          return adopted((_a2 = registry.keys.get(appId)) != null ? _a2 : minted);
+        },
+        degraded
+      );
+    }).catch(degraded);
   } catch {
-    run = Promise.resolve(settled());
+    run = Promise.resolve(degraded());
   }
   registry.pending.set(appId, run);
+  void run.then((outcome) => {
+    var _a2;
+    if (outcome.durable) return;
+    (_a2 = registry.pending) == null ? void 0 : _a2.delete(appId);
+    registry.hydrating.delete(appId);
+  });
   return run;
 };
 var resolveAutoDeviceKey = (opts = {}) => {
@@ -3370,14 +3425,20 @@ var resolveAutoDeviceKey = (opts = {}) => {
   return (_b = registry.keys.get(appId)) != null ? _b : id;
 };
 var hydrateAutoDeviceKey = async (opts = {}) => {
+  var _a2, _b;
+  return (_b = (_a2 = await hydrateDeviceIdentity(opts)) == null ? void 0 : _a2.value) != null ? _b : resolveAutoDeviceKey(opts);
+};
+var hydrateDeviceIdentity = 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 record = (value, durable) => resolveIdentity({ value, space: "device", source: "auto", durable, scope: appId });
+  if (!opts.storage) return record(id, false);
+  const registry = autoDeviceKeyRegistry();
   const pending = (_b = registry.pending) == null ? void 0 : _b.get(appId);
-  if (pending) await pending;
-  return (_c = registry.keys.get(appId)) != null ? _c : id;
+  if (!pending) return record((_c = registry.keys.get(appId)) != null ? _c : id, false);
+  const outcome = await pending;
+  return record(outcome.value, outcome.durable);
 };
 var resetAutoDeviceKeys = () => {
   var _a2;
@@ -3387,6 +3448,15 @@ var resetAutoDeviceKeys = () => {
   (_a2 = registry.pending) == null ? void 0 : _a2.clear();
 };
 
+// src/utils/warnInDev.ts
+var warnInDev = (message) => {
+  if (typeof __DEV__ !== "undefined" && __DEV__ && typeof console !== "undefined" && console.warn) {
+    console.warn(message);
+    return true;
+  }
+  return false;
+};
+
 // src/analytics/currentSession.ts
 var CURRENT_SESSION_ID_SLOT = /* @__PURE__ */ Symbol.for(
   "@wireai/activation:currentSessionId"
@@ -3401,13 +3471,6 @@ 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"
@@ -3504,27 +3567,20 @@ var identifyOnboarding = async (opts) => {
       contextId = stored == null ? void 0 : stored.id;
     }
   }
-  if (!contextId) contextId = getCurrentSessionId();
+  let space = "onboarding";
+  if (!contextId && opts.allowAppSessionFallback) {
+    contextId = getCurrentSessionId();
+    space = "app_session";
+  }
   if (!contextId) return false;
   reportClientEvent(
     { serverUrl: opts.config.serverUrl, apiKey: opts.config.apiKey },
     { event_type: "identify", session_id: contextId, user_id: userId }
   );
-  return true;
+  return space;
 };
 
 // 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;
@@ -3605,11 +3661,6 @@ var resolveUserContext = (ctx = {}, opts = {}) => {
   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,
@@ -3636,7 +3687,7 @@ var WireOnboarding = ({
   userId,
   autoJoinKey = true
 }) => {
-  var _a2, _b, _c;
+  var _a2, _b, _c, _d, _e;
   const boundUserId = useMemo(() => sanitizeUserId(userId), [userId]);
   const device = useMemo(() => {
     const collected = collectDeviceContext();
@@ -3647,44 +3698,72 @@ 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 hostJoinIdentity = useMemo(
+    () => resolveIdentity({
+      value: userContextStable == null ? void 0 : userContextStable.device_key,
+      space: "device",
+      source: "host",
+      scope: config.appId
+    }),
+    [userContextStable, config.appId]
+  );
+  const missingJoinKey = !hostJoinIdentity;
   const autoJoinPossible = Boolean(storage) && autoJoinKey !== false;
   const wantsAutoJoin = missingJoinKey && autoJoinPossible;
-  const [autoJoinValue, setAutoJoinValue] = useState(void 0);
+  const [autoJoinOutcome, setAutoJoinOutcome] = useState(void 0);
   useEffect(() => {
-    if (!wantsAutoJoin || autoJoinValue !== void 0 || !storage) return;
+    if (!wantsAutoJoin || autoJoinOutcome !== void 0 || !storage) return;
     let cancelled = false;
     const timer = setTimeout(() => {
-      if (!cancelled) setAutoJoinValue(null);
+      if (!cancelled) setAutoJoinOutcome({ key: null, reason: "timeout" });
     }, AUTO_JOIN_HYDRATION_TIMEOUT_MS);
-    void hydrateAutoDeviceKey({ appId: config.appId, storage }).then((key) => {
+    void hydrateDeviceIdentity({ appId: config.appId, storage }).then((identity) => {
       if (cancelled) return;
       clearTimeout(timer);
-      setAutoJoinValue(key || null);
+      setAutoJoinOutcome(
+        (identity == null ? void 0 : identity.durable) ? { key: identity.value } : { key: null, reason: "not-durable" }
+      );
     });
     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;
+  }, [wantsAutoJoin, autoJoinOutcome, config.appId, storage]);
+  const injectedJoinKey = wantsAutoJoin ? (_a2 = autoJoinOutcome == null ? void 0 : autoJoinOutcome.key) != null ? _a2 : void 0 : void 0;
+  const autoJoinPending = wantsAutoJoin && autoJoinOutcome === void 0;
   const effectiveUserContext = useMemo(
     () => injectedJoinKey ? { ...userContextStable, ...activationJoinContext(injectedJoinKey) } : userContextStable,
     [userContextStable, injectedJoinKey]
   );
+  const frozenWireContextRef = useRef(null);
+  if (!autoJoinPending && frozenWireContextRef.current === null) {
+    frozenWireContextRef.current = effectiveUserContext ? JSON.stringify(effectiveUserContext) : "";
+  }
+  const startupUserContextKey = (_b = frozenWireContextRef.current) != null ? _b : "";
+  const startupUserContext = useMemo(
+    () => startupUserContextKey ? JSON.parse(startupUserContextKey) : void 0,
+    [startupUserContextKey]
+  );
   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.";
+  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." : (autoJoinOutcome == null ? void 0 : autoJoinOutcome.key) === null && autoJoinOutcome.reason === "not-durable" ? "your `storage` adapter answered but could not persist the key (the read or the write failed), so the key would be different on every launch, which corrupts min_sessions instead of merely leaving the join empty. Check the adapter you passed as `storage`." : "your `storage` adapter did not answer in time.";
   useEffect(() => {
     if (!warnMissingJoinKey) return;
-    warnInDev2(
+    warnInDev(
       "[wireai] <WireOnboarding> got no user_context.device_key, so this onboarding session can never be joined to the app's later events and the `activated` funnel will read zero. Pass userContext={activationJoinContext(deviceKey)} \u2014 and if your app owns no device id, userContext={activationJoinContext(resolveAutoDeviceKey({ appId, storage }))} returns the SAME id the analytics side stamps. Never hand-write userContext={{ deviceKey }}. The kit did NOT auto-inject its own key here because " + autoJoinReason
     );
   }, [warnMissingJoinKey, autoJoinReason]);
+  const hostKeyElsewhere = missingJoinKey ? hostIdentity("device", config.appId) : void 0;
+  const warnHostKeyElsewhere = Boolean(hostKeyElsewhere) && Boolean(injectedJoinKey);
+  useEffect(() => {
+    if (!warnHostKeyElsewhere) return;
+    warnInDev(
+      `[wireai] <WireOnboarding> got no user_context.device_key, so the kit injected its own \u2014 but another surface in this app was constructed WITH a host-supplied device key ("${hostKeyElsewhere}"). Your app events carry that id and this onboarding session carries the kit's, so the two land in disjoint id spaces and the \`activated\` funnel still reads zero. Pass the SAME id here: userContext={activationJoinContext(deviceKey)}.`
+    );
+  }, [warnHostKeyElsewhere, hostKeyElsewhere]);
   const misspelledJoinKey = missingJoinKey && typeof (userContextStable == null ? void 0 : userContextStable.deviceKey) === "string" && Boolean(userContextStable.deviceKey.trim());
   useEffect(() => {
     if (!misspelledJoinKey || !injectedJoinKey) return;
-    warnInDev2(
+    warnInDev(
       "[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]);
@@ -3713,7 +3792,7 @@ var WireOnboarding = ({
     },
     [storage, storageKey, retainSessionOnComplete, onComplete]
   );
-  const sessionId = (_a2 = session == null ? void 0 : session.id) != null ? _a2 : "";
+  const sessionId = (_c = session == null ? void 0 : session.id) != null ? _c : "";
   const startupUserIdRef = useRef(boundUserId);
   const metadataKey = config.metadata ? JSON.stringify(config.metadata) : "";
   const metadataStable = useMemo(() => metadataKey ? JSON.parse(metadataKey) : void 0, [metadataKey]);
@@ -3737,7 +3816,9 @@ 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,
-        ...effectiveUserContext ? { userContext: effectiveUserContext } : {},
+        // The FROZEN wire context, never the live one — see the freeze note above. A change here
+        // recreates the A2A adapter and drops `contextId`.
+        ...startupUserContext ? { userContext: startupUserContext } : {},
         // 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
@@ -3746,7 +3827,7 @@ var WireOnboarding = ({
       },
       timeoutMs: 6e4
     };
-  }, [config.serverUrl, config.appId, config.apiKey, metadataStable, sessionId, componentsStable, device, effectiveUserContext]);
+  }, [config.serverUrl, config.appId, config.apiKey, metadataStable, sessionId, componentsStable, device, startupUserContext]);
   const reportTarget = useMemo(
     () => ({ serverUrl: config.serverUrl, apiKey: config.apiKey }),
     [config.serverUrl, config.apiKey]
@@ -3772,8 +3853,8 @@ var WireOnboarding = ({
     return /* @__PURE__ */ jsx(OnboardingThemeProvider, { theme, children: /* @__PURE__ */ jsx(
       LoadingScreen,
       {
-        title: (_b = copy == null ? void 0 : copy.restoringTitle) != null ? _b : DEFAULT_COPY.restoringTitle,
-        hint: (_c = copy == null ? void 0 : copy.restoringHint) != null ? _c : DEFAULT_COPY.restoringHint
+        title: (_d = copy == null ? void 0 : copy.restoringTitle) != null ? _d : DEFAULT_COPY.restoringTitle,
+        hint: (_e = copy == null ? void 0 : copy.restoringHint) != null ? _e : DEFAULT_COPY.restoringHint
       }
     ) });
   }
@@ -3811,7 +3892,7 @@ function DemoOnboarding({
   const [open, setOpen] = useState(false);
   const [runId, setRunId] = useState(0);
   const t = useMemo(() => mergeTheme(theme != null ? theme : {}), [theme]);
-  const styles18 = useMemo(() => makeStyles5(t), [t]);
+  const styles17 = useMemo(() => makeStyles5(t), [t]);
   const openDemo = useCallback(() => {
     setRunId((n) => n + 1);
     setOpen(true);
@@ -3825,7 +3906,7 @@ function DemoOnboarding({
     [onComplete]
   );
   return /* @__PURE__ */ jsxs(Fragment, { children: [
-    renderTrigger ? renderTrigger(openDemo) : /* @__PURE__ */ jsx(Pressable, { onPress: openDemo, style: styles18.trigger, accessibilityRole: "button", children: /* @__PURE__ */ jsx(Text, { style: styles18.triggerText, children: label }) }),
+    renderTrigger ? renderTrigger(openDemo) : /* @__PURE__ */ jsx(Pressable, { onPress: openDemo, style: styles17.trigger, accessibilityRole: "button", children: /* @__PURE__ */ jsx(Text, { style: styles17.triggerText, children: label }) }),
     /* @__PURE__ */ jsx(
       Modal,
       {
@@ -3833,7 +3914,7 @@ function DemoOnboarding({
         animationType: "slide",
         presentationStyle: "fullScreen",
         onRequestClose: close,
-        children: /* @__PURE__ */ jsx(View, { style: styles18.modal, children: config ? /* @__PURE__ */ jsx(
+        children: /* @__PURE__ */ jsx(View, { style: styles17.modal, children: config ? /* @__PURE__ */ jsx(
           WireOnboarding,
           {
             config,
@@ -3846,10 +3927,10 @@ function DemoOnboarding({
             onError: close
           },
           runId
-        ) : /* @__PURE__ */ jsxs(View, { style: styles18.notice, children: [
-          /* @__PURE__ */ jsx(Text, { style: styles18.noticeTitle, children: "Wire AI not configured" }),
-          /* @__PURE__ */ jsx(Text, { style: styles18.noticeBody, children: "Set the Wire AI key + server URL (e.g. via wireConfigFromEnv) to demo the AI onboarding here." }),
-          /* @__PURE__ */ jsx(Pressable, { onPress: close, style: styles18.trigger, accessibilityRole: "button", children: /* @__PURE__ */ jsx(Text, { style: styles18.triggerText, children: "Close" }) })
+        ) : /* @__PURE__ */ jsxs(View, { style: styles17.notice, children: [
+          /* @__PURE__ */ jsx(Text, { style: styles17.noticeTitle, children: "Wire AI not configured" }),
+          /* @__PURE__ */ jsx(Text, { style: styles17.noticeBody, children: "Set the Wire AI key + server URL (e.g. via wireConfigFromEnv) to demo the AI onboarding here." }),
+          /* @__PURE__ */ jsx(Pressable, { onPress: close, style: styles17.trigger, accessibilityRole: "button", children: /* @__PURE__ */ jsx(Text, { style: styles17.triggerText, children: "Close" }) })
         ] }) })
       }
     )
@@ -3923,20 +4004,6 @@ var themeFromBrand = (input) => {
     button: { ...base.button, ...extra.button }
   };
 };
-var _DoneBlock = ({
-  title = "You're all set",
-  message = "Personalizing your experience\u2026"
-}) => {
-  const t = useOnboardingTheme();
-  return /* @__PURE__ */ jsxs(View, { style: [styles16.center, { gap: t.spacing.sm, padding: t.spacing.lg }], children: [
-    /* @__PURE__ */ jsx(Text, { style: [headingStyle(t.fonts), { color: t.colors.success, textAlign: "center" }], children: title }),
-    /* @__PURE__ */ jsx(Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted, textAlign: "center" }], children: message })
-  ] });
-};
-var DoneBlock = React18.memo(_DoneBlock);
-var styles16 = StyleSheet.create({
-  center: { flex: 1, alignItems: "center", justifyContent: "center" }
-});
 
 // src/motion/centeredModalMotion.ts
 var CENTERED_MODAL_ANIM = {
@@ -4013,25 +4080,25 @@ var _CenteredModal = forwardRef(
           /* @__PURE__ */ jsx(
             Animated.View,
             {
-              style: [styles17.backdrop, { opacity: backdropOpacity }],
+              style: [styles16.backdrop, { opacity: backdropOpacity }],
               pointerEvents: "none"
             }
           ),
           /* @__PURE__ */ jsx(
             Pressable,
             {
-              style: styles17.fill,
+              style: styles16.fill,
               onPress: onBackdrop,
               accessibilityRole: "button",
               accessibilityLabel: "Dismiss",
-              children: /* @__PURE__ */ jsx(SafeAreaView, { style: styles17.center, pointerEvents: "box-none", children: /* @__PURE__ */ jsx(Pressable, { onPress: () => {
-              }, style: styles17.cardWrap, children: /* @__PURE__ */ jsx(
+              children: /* @__PURE__ */ jsx(SafeAreaView, { style: styles16.center, pointerEvents: "box-none", children: /* @__PURE__ */ jsx(Pressable, { onPress: () => {
+              }, style: styles16.cardWrap, children: /* @__PURE__ */ jsx(
                 Animated.View,
                 {
                   accessibilityViewIsModal: true,
                   accessibilityRole: "alert",
                   style: [
-                    styles17.card,
+                    styles16.card,
                     {
                       backgroundColor: theme.colors.surface,
                       borderRadius: theme.radius.lg,
@@ -4053,7 +4120,7 @@ var _CenteredModal = forwardRef(
 );
 _CenteredModal.displayName = "CenteredModal";
 var CenteredModal = React18.memo(_CenteredModal);
-var styles17 = StyleSheet.create({
+var styles16 = StyleSheet.create({
   fill: { flex: 1 },
   backdrop: { position: "absolute", top: 0, left: 0, right: 0, bottom: 0, backgroundColor: "#000" },
   center: { flex: 1, alignItems: "center", justifyContent: "center", padding: 24 },
@@ -4239,11 +4306,6 @@ var WIRE_ENV_VARS = [
   "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, _e;
   const apiKey = (_a2 = overrides == null ? void 0 : overrides.apiKey) != null ? _a2 : process.env.EXPO_PUBLIC_WIREAI_API_KEY;
@@ -4254,7 +4316,7 @@ var wireConfigFromEnv = (overrides) => {
       apiKey ? void 0 : "EXPO_PUBLIC_WIREAI_API_KEY",
       serverUrl ? void 0 : "EXPO_PUBLIC_WIREAI_SERVER_URL"
     ].filter(Boolean);
-    warnInDev3(
+    warnInDev(
       `[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;
@@ -4362,15 +4424,17 @@ var resetActivationRevalidation = () => {
 };
 
 // src/activation/wireActivation.ts
-var clean = (value) => {
-  if (typeof value !== "string") return void 0;
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : void 0;
-};
+var clean = cleanString;
 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);
+  resolveIdentity({
+    value: explicitDeviceKey,
+    space: "device",
+    source: "host",
+    scope: config.appId
+  });
   const autoDeviceKeyOptions = {
     appId: config.appId,
     // An explicit key opts out of minting AND persisting (unchanged contract).
@@ -4804,6 +4868,30 @@ var DEFAULTS = {
   maxRetries: 6
 };
 var READ_TIMEOUT_MS4 = 1500;
+var QUEUE_KEY_SLOT = /* @__PURE__ */ Symbol.for("@wireai/activation:eventQueueKeys");
+var queueKeyGlobal = globalThis;
+var claimedQueueKeys = () => {
+  const existing = queueKeyGlobal[QUEUE_KEY_SLOT];
+  if (existing) return existing;
+  const created = /* @__PURE__ */ new Set();
+  queueKeyGlobal[QUEUE_KEY_SLOT] = created;
+  return created;
+};
+var claimQueueKey = (preferred, explicit) => {
+  const claimed = claimedQueueKeys();
+  if (explicit || !claimed.has(preferred)) {
+    claimed.add(preferred);
+    return preferred;
+  }
+  let ordinal = 2;
+  while (claimed.has(`${preferred}#${ordinal}`)) ordinal++;
+  const key = `${preferred}#${ordinal}`;
+  claimed.add(key);
+  warnInDev(
+    `[wireai] a second event queue was created for the same appId, and "${preferred}" is already claimed by a live one. Two queues sharing one storage slot overwrite each other's backlog, delete each other's pending events when one drains to empty, and double-send on relaunch, so this queue was given "${key}" instead. Prefer ONE analytics instance per app; if you really need two, pass an explicit \`storageKey\` to each so the slots are yours to reason about.`
+  );
+  return key;
+};
 var withTimeout4 = (p, ms) => {
   let timer;
   const timeout = new Promise((resolve) => {
@@ -4835,7 +4923,8 @@ var createEventQueue = (options) => {
   var _a2, _b, _c, _d, _e, _f, _g;
   const target = options.target;
   const storage = options.storage;
-  const key = (_b = options.storageKey) != null ? _b : `wireai:evtq:${(_a2 = options.appId) != null ? _a2 : "default"}`;
+  const defaultKey = (_b = options.storageKey) != null ? _b : `wireai:evtq:${(_a2 = options.appId) != null ? _a2 : "default"}`;
+  const key = storage ? claimQueueKey(defaultKey, options.storageKey !== void 0) : defaultKey;
   const maxSize = (_c = options.maxSize) != null ? _c : DEFAULTS.maxSize;
   const batchSize = (_d = options.batchSize) != null ? _d : DEFAULTS.batchSize;
   const baseBackoffMs = (_e = options.baseBackoffMs) != null ? _e : DEFAULTS.baseBackoffMs;
@@ -5025,7 +5114,13 @@ var useLifecycleEvents = (config, options = {}) => {
       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;
+      var _a2;
+      const host = (_a2 = resolveIdentity({
+        value: opts.deviceKey,
+        space: "device",
+        source: "host",
+        scope: cfg == null ? void 0 : cfg.appId
+      })) == null ? void 0 : _a2.value;
       if (host) return host;
       if (!(cfg == null ? void 0 : cfg.storage)) return void 0;
       return resolveAutoDeviceKey({ appId: cfg.appId, storage: cfg.storage });
@@ -5103,6 +5198,6 @@ var useLifecycleEvents = (config, options = {}) => {
   }, []);
 };
 
-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 };
+export { AUTO_DEVICE_ID_PREFIX, AnimatedSparkle, BACKGROUND_SESSION_MS, CardGridSelectCard, CardHandoff, CenteredModal, ChipSelectCard, CompletionView, DEFAULT_FEATURES_TTL_MS, DEFAULT_SESSION_TTL_MS, DemoOnboarding, EXTRA_KEY_PREFIX, ErrorBlock, FIRST_OPEN_EVENT, IconRegistryProvider, IllustrationProvider, InterstitialCard, LoadingBlock, LoadingScreen, NumberStepperCard, Button as OnboardingButton, OnboardingFlow, OnboardingScaffold, OnboardingThemeProvider, PLAN_TIER_CONTEXT_KEY, 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, hostIdentity, hydrateAutoDeviceKey, hydrateDeviceIdentity, 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, resetIdentityProvenance, resetSessionStartGuard, resolveAutoDeviceKey, resolveIdentity, 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