@wireai/activation 0.12.2 → 0.13.0

package/dist/index.js

@@ -1012,26 +1012,26 @@ var _OnboardingScaffold = ({
   children
 }) => {
   const t = useOnboardingTheme();
-  const styles18 = React18.useMemo(() => makeStyles(t), [t]);
+  const styles17 = React18.useMemo(() => makeStyles(t), [t]);
   const hit = { top: 12, bottom: 12, left: 12, right: 12 };
   return /* @__PURE__ */ jsxRuntime.jsxs(
     reactNativeSafeAreaContext.SafeAreaView,
     {
       edges: ["top", "bottom"],
-      style: [styles18.flex, { backgroundColor: t.colors.background }],
+      style: [styles17.flex, { backgroundColor: t.colors.background }],
       children: [
-        /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles18.header, { paddingHorizontal: t.spacing.md, paddingTop: t.spacing.md }], children: [
-          /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: styles18.progressWrap, children: /* @__PURE__ */ jsxRuntime.jsx(StepProgress, { step, complete, approxScreens }) }),
-          onSkip ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.TouchableOpacity, { onPress: onSkip, hitSlop: hit, style: styles18.skip, children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted }], children: skipLabel }) }) : null
+        /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles17.header, { paddingHorizontal: t.spacing.md, paddingTop: t.spacing.md }], children: [
+          /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: styles17.progressWrap, children: /* @__PURE__ */ jsxRuntime.jsx(StepProgress, { step, complete, approxScreens }) }),
+          onSkip ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.TouchableOpacity, { onPress: onSkip, hitSlop: hit, style: styles17.skip, children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted }], children: skipLabel }) }) : null
         ] }),
         /* @__PURE__ */ jsxRuntime.jsx(
           reactNative.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__ */ jsxRuntime.jsx(reactNative.View, { style: [styles18.footer, { paddingHorizontal: t.spacing.md, paddingBottom: t.spacing.sm }], children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.TouchableOpacity, { onPress: onBack, hitSlop: hit, children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted }], children: backLabel }) }) }) : null
+        onBack ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: [styles17.footer, { paddingHorizontal: t.spacing.md, paddingBottom: t.spacing.sm }], children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.TouchableOpacity, { onPress: onBack, hitSlop: hit, children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted }], children: backLabel }) }) }) : null
       ]
     }
   );
@@ -1168,10 +1168,10 @@ var _CardLayout = ({
   titleNode
 }) => {
   const t = useOnboardingTheme();
-  const styles18 = React18.useMemo(() => makeStyles2(t), [t]);
+  const styles17 = React18.useMemo(() => makeStyles2(t), [t]);
   const hasHeader = !!title || !!subtitle || !!titleNode;
-  return /* @__PURE__ */ jsxRuntime.jsxs(reactNative.KeyboardAvoidingView, { style: styles18.fill, behavior: "padding", children: [
-    hasHeader ? /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles18.header, children: [
+  return /* @__PURE__ */ jsxRuntime.jsxs(reactNative.KeyboardAvoidingView, { style: styles17.fill, behavior: "padding", children: [
+    hasHeader ? /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles17.header, children: [
       titleNode != null ? titleNode : title ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [labelStyle(t.fonts), { color: t.colors.text }], children: title }) : null,
       subtitle ? /* @__PURE__ */ jsxRuntime.jsx(
         reactNative.Text,
@@ -1187,10 +1187,10 @@ var _CardLayout = ({
     /* @__PURE__ */ jsxRuntime.jsx(
       reactNative.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",
@@ -1198,7 +1198,7 @@ var _CardLayout = ({
         children
       }
     ),
-    footer ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: styles18.footer, children: footer }) : null
+    footer ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: styles17.footer, children: footer }) : null
   ] });
 };
 var CardLayout = React18__default.default.memo(_CardLayout);
@@ -1480,7 +1480,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));
@@ -1501,6 +1501,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
   };
 };
@@ -1518,28 +1520,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 {
   }
@@ -1550,7 +1559,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;
   }
@@ -1770,8 +1785,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) {
@@ -1796,7 +1811,7 @@ var OnboardingFlow = ({
       }
       return out;
     },
-    [makeActions, progress.key]
+    [makeActions, progress.key, progress.slot_id]
   );
   if (degraded) {
     if (fallbackFlow !== void 0) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: fallbackFlow });
@@ -2107,7 +2122,7 @@ var _TextInputCard = ({
   lines = 6
 }) => {
   const t = useOnboardingTheme();
-  const styles18 = React18.useMemo(() => makeStyles3(t), [t]);
+  const styles17 = React18.useMemo(() => makeStyles3(t), [t]);
   const { height: screenHeight } = reactNative.useWindowDimensions();
   const [value, setValue] = React18.useState("");
   const [submitted, setSubmitted] = React18.useState(false);
@@ -2134,7 +2149,7 @@ var _TextInputCard = ({
           disabled: !value.trim() || locked
         }
       ),
-      children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles18.row, children: [
+      children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles17.row, children: [
         /* @__PURE__ */ jsxRuntime.jsx(
           reactNative.TextInput,
           {
@@ -2148,7 +2163,7 @@ var _TextInputCard = ({
             textAlignVertical: multiline ? "top" : "center",
             style: [
               bodyStyle(t.fonts),
-              styles18.input,
+              styles17.input,
               {
                 color: t.colors.text,
                 backgroundColor: t.colors.surface,
@@ -2874,7 +2889,7 @@ var _NumberStepperCard = ({
   onSubmit
 }) => {
   const t = useOnboardingTheme();
-  const styles18 = React18.useMemo(() => makeStyles4(t), [t]);
+  const styles17 = React18.useMemo(() => makeStyles4(t), [t]);
   const safeMin = safeNum(min, 1);
   const safeMaxRaw = safeNum(max, 30);
   const safeMax = safeMaxRaw < safeMin ? safeMin : safeMaxRaw;
@@ -2898,7 +2913,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__ */ jsxRuntime.jsx(
@@ -2907,10 +2922,10 @@ var _NumberStepperCard = ({
       title: label,
       align: "center",
       footer: /* @__PURE__ */ jsxRuntime.jsx(Button, { title: submitLabel, onPress: handleSubmit, variant: "primary", disabled: submitted }),
-      children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles18.wrap, children: [
-        /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles18.stepper, { gap: t.spacing.lg }], children: [
+      children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles17.wrap, children: [
+        /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles17.stepper, { gap: t.spacing.lg }], children: [
           /* @__PURE__ */ jsxRuntime.jsx(reactNative.Pressable, { onPress: atMin || submitted ? void 0 : handleDecrement, disabled: atMin || submitted, style: stepBtnStyle(atMin), children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [headingStyle(t.fonts), { color: atMin ? t.colors.textMuted : t.colors.primary }], children: "\u2212" }) }),
-          /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles18.valueBox, children: [
+          /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles17.valueBox, children: [
             /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [headingStyle(t.fonts), { color: t.colors.primary }], children: String(value) }),
             unit ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [captionStyle(t.fonts), { color: t.colors.textMuted }], children: unit }) : null
           ] }),
@@ -3317,6 +3332,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"}`;
@@ -3339,24 +3381,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 = {}) => {
@@ -3376,14 +3431,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;
@@ -3393,6 +3454,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"
@@ -3407,13 +3477,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"
@@ -3510,27 +3573,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;
@@ -3611,11 +3667,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,
@@ -3642,7 +3693,7 @@ var WireOnboarding = ({
   userId,
   autoJoinKey = true
 }) => {
-  var _a2, _b, _c;
+  var _a2, _b, _c, _d, _e;
   const boundUserId = React18.useMemo(() => sanitizeUserId(userId), [userId]);
   const device = React18.useMemo(() => {
     const collected = collectDeviceContext();
@@ -3653,44 +3704,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 = React18.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] = React18.useState(void 0);
+  const [autoJoinOutcome, setAutoJoinOutcome] = React18.useState(void 0);
   React18.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 = React18.useMemo(
     () => injectedJoinKey ? { ...userContextStable, ...activationJoinContext(injectedJoinKey) } : userContextStable,
     [userContextStable, injectedJoinKey]
   );
+  const frozenWireContextRef = React18.useRef(null);
+  if (!autoJoinPending && frozenWireContextRef.current === null) {
+    frozenWireContextRef.current = effectiveUserContext ? JSON.stringify(effectiveUserContext) : "";
+  }
+  const startupUserContextKey = (_b = frozenWireContextRef.current) != null ? _b : "";
+  const startupUserContext = React18.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.";
   React18.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);
+  React18.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());
   React18.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]);
@@ -3719,7 +3798,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 = React18.useRef(boundUserId);
   const metadataKey = config.metadata ? JSON.stringify(config.metadata) : "";
   const metadataStable = React18.useMemo(() => metadataKey ? JSON.parse(metadataKey) : void 0, [metadataKey]);
@@ -3743,7 +3822,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
@@ -3752,7 +3833,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 = React18.useMemo(
     () => ({ serverUrl: config.serverUrl, apiKey: config.apiKey }),
     [config.serverUrl, config.apiKey]
@@ -3778,8 +3859,8 @@ var WireOnboarding = ({
     return /* @__PURE__ */ jsxRuntime.jsx(OnboardingThemeProvider, { theme, children: /* @__PURE__ */ jsxRuntime.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
       }
     ) });
   }
@@ -3817,7 +3898,7 @@ function DemoOnboarding({
   const [open, setOpen] = React18.useState(false);
   const [runId, setRunId] = React18.useState(0);
   const t = React18.useMemo(() => mergeTheme(theme != null ? theme : {}), [theme]);
-  const styles18 = React18.useMemo(() => makeStyles5(t), [t]);
+  const styles17 = React18.useMemo(() => makeStyles5(t), [t]);
   const openDemo = React18.useCallback(() => {
     setRunId((n) => n + 1);
     setOpen(true);
@@ -3831,7 +3912,7 @@ function DemoOnboarding({
     [onComplete]
   );
   return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-    renderTrigger ? renderTrigger(openDemo) : /* @__PURE__ */ jsxRuntime.jsx(reactNative.Pressable, { onPress: openDemo, style: styles18.trigger, accessibilityRole: "button", children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles18.triggerText, children: label }) }),
+    renderTrigger ? renderTrigger(openDemo) : /* @__PURE__ */ jsxRuntime.jsx(reactNative.Pressable, { onPress: openDemo, style: styles17.trigger, accessibilityRole: "button", children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles17.triggerText, children: label }) }),
     /* @__PURE__ */ jsxRuntime.jsx(
       reactNative.Modal,
       {
@@ -3839,7 +3920,7 @@ function DemoOnboarding({
         animationType: "slide",
         presentationStyle: "fullScreen",
         onRequestClose: close,
-        children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: styles18.modal, children: config ? /* @__PURE__ */ jsxRuntime.jsx(
+        children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: styles17.modal, children: config ? /* @__PURE__ */ jsxRuntime.jsx(
           WireOnboarding,
           {
             config,
@@ -3852,10 +3933,10 @@ function DemoOnboarding({
             onError: close
           },
           runId
-        ) : /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles18.notice, children: [
-          /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles18.noticeTitle, children: "Wire AI not configured" }),
-          /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles18.noticeBody, children: "Set the Wire AI key + server URL (e.g. via wireConfigFromEnv) to demo the AI onboarding here." }),
-          /* @__PURE__ */ jsxRuntime.jsx(reactNative.Pressable, { onPress: close, style: styles18.trigger, accessibilityRole: "button", children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles18.triggerText, children: "Close" }) })
+        ) : /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: styles17.notice, children: [
+          /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles17.noticeTitle, children: "Wire AI not configured" }),
+          /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles17.noticeBody, children: "Set the Wire AI key + server URL (e.g. via wireConfigFromEnv) to demo the AI onboarding here." }),
+          /* @__PURE__ */ jsxRuntime.jsx(reactNative.Pressable, { onPress: close, style: styles17.trigger, accessibilityRole: "button", children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: styles17.triggerText, children: "Close" }) })
         ] }) })
       }
     )
@@ -3929,20 +4010,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__ */ jsxRuntime.jsxs(reactNative.View, { style: [styles16.center, { gap: t.spacing.sm, padding: t.spacing.lg }], children: [
-    /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [headingStyle(t.fonts), { color: t.colors.success, textAlign: "center" }], children: title }),
-    /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [bodyStyle(t.fonts), { color: t.colors.textMuted, textAlign: "center" }], children: message })
-  ] });
-};
-var DoneBlock = React18__default.default.memo(_DoneBlock);
-var styles16 = reactNative.StyleSheet.create({
-  center: { flex: 1, alignItems: "center", justifyContent: "center" }
-});
 
 // src/motion/centeredModalMotion.ts
 var CENTERED_MODAL_ANIM = {
@@ -4019,25 +4086,25 @@ var _CenteredModal = React18.forwardRef(
           /* @__PURE__ */ jsxRuntime.jsx(
             reactNative.Animated.View,
             {
-              style: [styles17.backdrop, { opacity: backdropOpacity }],
+              style: [styles16.backdrop, { opacity: backdropOpacity }],
               pointerEvents: "none"
             }
           ),
           /* @__PURE__ */ jsxRuntime.jsx(
             reactNative.Pressable,
             {
-              style: styles17.fill,
+              style: styles16.fill,
               onPress: onBackdrop,
               accessibilityRole: "button",
               accessibilityLabel: "Dismiss",
-              children: /* @__PURE__ */ jsxRuntime.jsx(reactNativeSafeAreaContext.SafeAreaView, { style: styles17.center, pointerEvents: "box-none", children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Pressable, { onPress: () => {
-              }, style: styles17.cardWrap, children: /* @__PURE__ */ jsxRuntime.jsx(
+              children: /* @__PURE__ */ jsxRuntime.jsx(reactNativeSafeAreaContext.SafeAreaView, { style: styles16.center, pointerEvents: "box-none", children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.Pressable, { onPress: () => {
+              }, style: styles16.cardWrap, children: /* @__PURE__ */ jsxRuntime.jsx(
                 reactNative.Animated.View,
                 {
                   accessibilityViewIsModal: true,
                   accessibilityRole: "alert",
                   style: [
-                    styles17.card,
+                    styles16.card,
                     {
                       backgroundColor: theme.colors.surface,
                       borderRadius: theme.radius.lg,
@@ -4059,7 +4126,7 @@ var _CenteredModal = React18.forwardRef(
 );
 _CenteredModal.displayName = "CenteredModal";
 var CenteredModal = React18__default.default.memo(_CenteredModal);
-var styles17 = reactNative.StyleSheet.create({
+var styles16 = reactNative.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 },
@@ -4245,11 +4312,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;
@@ -4260,7 +4322,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;
@@ -4368,15 +4430,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).
@@ -4810,6 +4874,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) => {
@@ -4841,7 +4929,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;
@@ -5031,7 +5120,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 });
@@ -5120,7 +5215,6 @@ exports.CompletionView = CompletionView;
 exports.DEFAULT_FEATURES_TTL_MS = DEFAULT_FEATURES_TTL_MS;
 exports.DEFAULT_SESSION_TTL_MS = DEFAULT_SESSION_TTL_MS;
 exports.DemoOnboarding = DemoOnboarding;
-exports.DoneBlock = DoneBlock;
 exports.EXTRA_KEY_PREFIX = EXTRA_KEY_PREFIX;
 exports.ErrorBlock = ErrorBlock;
 exports.FIRST_OPEN_EVENT = FIRST_OPEN_EVENT;
@@ -5135,7 +5229,6 @@ exports.OnboardingFlow = OnboardingFlow;
 exports.OnboardingScaffold = OnboardingScaffold;
 exports.OnboardingThemeProvider = OnboardingThemeProvider;
 exports.PLAN_TIER_CONTEXT_KEY = PLAN_TIER_CONTEXT_KEY;
-exports.RESERVED_USER_CONTEXT_KEYS = RESERVED_USER_CONTEXT_KEYS;
 exports.SESSION_STARTED_EVENT = SESSION_STARTED_EVENT;
 exports.SelectionCard = SelectionCard;
 exports.StatusCard = StatusCard;
@@ -5179,7 +5272,9 @@ exports.firstOpenStorageKey = firstOpenStorageKey;
 exports.getActivationRevalidationVersion = getActivationRevalidationVersion;
 exports.getCurrentSessionId = getCurrentSessionId;
 exports.hashEmailFnv1a = hashEmailFnv1a;
+exports.hostIdentity = hostIdentity;
 exports.hydrateAutoDeviceKey = hydrateAutoDeviceKey;
+exports.hydrateDeviceIdentity = hydrateDeviceIdentity;
 exports.identifyOnboarding = identifyOnboarding;
 exports.isFeaturesFresh = isFeaturesFresh;
 exports.isOnboardingEnabled = isOnboardingEnabled;
@@ -5208,8 +5303,10 @@ exports.resetActivationRevalidation = resetActivationRevalidation;
 exports.resetAutoDeviceKeys = resetAutoDeviceKeys;
 exports.resetCurrentSessionId = resetCurrentSessionId;
 exports.resetFirstOpenLatch = resetFirstOpenLatch;
+exports.resetIdentityProvenance = resetIdentityProvenance;
 exports.resetSessionStartGuard = resetSessionStartGuard;
 exports.resolveAutoDeviceKey = resolveAutoDeviceKey;
+exports.resolveIdentity = resolveIdentity;
 exports.resolvePlanTier = resolvePlanTier;
 exports.resolveUserContext = resolveUserContext;
 exports.sanitizeUserId = sanitizeUserId;