@wireai/activation 0.4.0 → 0.8.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
-import { k as WireOnboardingProps, l as WireOnboardingConfig, O as OnboardingResult, S as StepValidator, n as OnboardingEvent, o as OnboardingCopy, a as ClientEventTarget, D as DeviceContext, C as ClientEvent, e as EnvelopeSource } from './eventQueue-CrNB9gzH.js';
-export { A as AnalyticsEvent, b as ClientEventType, p as DeviceFormFactor, q as OnboardingProgress, W as WIRE_ONBOARDING_EVENTS, g as WireOnboardingEventName, s as collectDeviceContext, m as makeSessionId, r as reportClientEvent, j as reportClientEvents, t as toAnalyticsEvent } from './eventQueue-CrNB9gzH.js';
+import { o as WireOnboardingProps, p as WireOnboardingConfig, O as OnboardingResult, S as StepValidator, q as OnboardingEvent, u as OnboardingCopy, a as ClientEventTarget, D as DeviceContext, C as ClientEvent, e as EnvelopeSource } from './currentSession-f7LWcdWG.js';
+export { A as AnalyticsEvent, b as ClientEventType, v as DeviceFormFactor, w as EXTRA_KEY_PREFIX, x as OnboardingProgress, R as RESERVED_USER_CONTEXT_KEYS, y as ResolveUserContextOptions, z as ResolvedUserContext, g as WIRE_ONBOARDING_EVENTS, h as WireOnboardingEventName, W as WireUserContext, B as collectDeviceContext, k as getCurrentSessionId, F as hashEmailFnv1a, G as isWireScalar, m as makeSessionId, H as namespaceExtra, r as reportClientEvent, l as reportClientEvents, n as resetCurrentSessionId, I as resolveUserContext, s as setCurrentSessionId, t as toAnalyticsEvent } from './currentSession-f7LWcdWG.js';
 import { O as OnboardingTheme } from './types-BKfpdZzX.js';
 export { a as OnboardingButtonStyle, b as OnboardingColors, c as OnboardingFonts, d as OnboardingRadius, e as OnboardingSpacing } from './types-BKfpdZzX.js';
 export { C as CenteredModal, a as CenteredModalHandle, b as CenteredModalProps } from './CenteredModal-Cdgns6--.js';
@@ -826,6 +826,73 @@ declare const attributionMetadata: (a: OnboardingAttribution) => {
     attribution: Record<string, unknown>;
 };
 
+/**
+ * appVersion — best-effort, DEPENDENCY-FREE auto-detection of the host app's version string.
+ *
+ * WHY this exists: analytics segments the funnel `by_app_version`, but that breakdown is only
+ * populated when a `device.appVersion` rides the event. `config.appVersion` (see types.ts) has
+ * always been the way to supply it — but it is easy for a host to forget, and then the release
+ * breakdown is silently empty. This module fills that gap: when the host does NOT pass a version,
+ * the kit makes a best-effort read of the app version the host already ships in its Expo config,
+ * so the breakdown works out of the box. An explicit `config.appVersion` always WINS over this.
+ *
+ * WHY it adds NO dependency (the kit's hard rule): `expo-constants` / `expo-application` are read
+ * through a GUARDED, VARIABLE-specifier `require`. Passing a variable (not a string literal) keeps
+ * Metro/esbuild from statically resolving the module, so a host that does NOT have it installed
+ * (e.g. bare React Native) never fails to bundle — the require simply throws at runtime and is
+ * swallowed. Nothing is added to `package.json`; nothing is forced on the host.
+ *
+ * PRIVACY: an app version string is not PII and identifies no user or device, so surfacing it
+ * changes no App Privacy / Data Safety declaration (same guarantee as the rest of deviceContext).
+ *
+ * NEVER THROWS: every read is guarded; a missing/odd value yields `undefined`, never an exception.
+ * Analytics must never be able to break onboarding.
+ */
+/** A `require`-like resolver. Injectable in tests; production uses the guarded runtime require. */
+type OptionalRequire$1 = (moduleName: string) => unknown;
+/**
+ * Detect the host app version, preferring `expo-constants` (`expoConfig.version`, then
+ * `nativeAppVersion`) and finally `expo-application` (`nativeApplicationVersion`). Returns the
+ * first real string, or `undefined` when none of those are available. Pure and never throws.
+ *
+ * `requireModule` is injectable so tests can exercise the "found" path without the native modules;
+ * production defaults to the guarded runtime require above.
+ */
+declare const detectAppVersion: (requireModule?: OptionalRequire$1) => string | undefined;
+
+/**
+ * deviceModel — best-effort, DEPENDENCY-FREE detection of the device MODEL on iOS.
+ *
+ * WHY this exists (the asymmetry it closes): `collectDeviceContext` already reports `device.model`
+ * on Android straight from `Platform.constants.Model` (e.g. "SM-G991B"), but iOS `Platform.constants`
+ * exposes NO model — only `osVersion` / `interfaceIdiom`. So the analytics `by_model` breakdown was
+ * Android-only. This module fills the iOS gap with the SAME zero-dependency technique the kit already
+ * uses for `appVersion` (see device/appVersion.ts): a GUARDED, VARIABLE-specifier `require` of the
+ * common Expo `expo-device` module. If the host has it, iOS gets a model out of the box; if not, the
+ * require simply throws and is swallowed and iOS `model` stays omitted — nothing is forced, nothing
+ * is added to `package.json`, and a host without `expo-device` never fails to bundle.
+ *
+ * WHY it is NOT PII: `expo-device`'s `modelName` ("iPhone 14 Pro") and `modelId` ("iPhone15,2") are a
+ * device CLASS shared by millions of units — the same privacy category as the Android `Model` the kit
+ * already sends. It is NOT a unique device id / IDFA / fingerprint, so surfacing it changes no App
+ * Privacy / Data Safety declaration (identical guarantee to the rest of deviceContext). It deliberately
+ * does NOT read `expo-device`'s `deviceName` (that is the user-set name, e.g. "Malik's iPhone", and IS
+ * personal data).
+ *
+ * NEVER THROWS: every read is guarded; a missing/odd value yields `undefined`, never an exception.
+ */
+/** A `require`-like resolver. Injectable in tests; production uses the guarded runtime require. */
+type OptionalRequire = (moduleName: string) => unknown;
+/**
+ * Detect the device model via `expo-device`, preferring the human-readable `modelName`
+ * ("iPhone 14 Pro") and falling back to the identifier `modelId` ("iPhone15,2"). Returns the first
+ * real string, or `undefined` when `expo-device` is absent. Pure and never throws.
+ *
+ * `requireModule` is injectable so tests can exercise the "found" path without the native module;
+ * production defaults to the guarded runtime require above.
+ */
+declare const detectNativeModel: (requireModule?: OptionalRequire) => string | undefined;
+
 /** Max accepted user-id length. Longer strings are truncated (never rejected). Keep in sync
  *  with the server's `USER_ID_MAX_LENGTH` (analytics/events.py). */
 declare const USER_ID_MAX_LENGTH = 128;
@@ -873,38 +940,35 @@ type IdentifyOnboardingOptions = {
 declare const identifyOnboarding: (opts: IdentifyOnboardingOptions) => Promise<boolean>;
 
 /**
- * reportSessionStart — the ONE standard emitter for "the user opened the app again".
- *
- * Every app-open posts a single `app.session_started` event to the Wire analytics backend
- * (`POST {serverUrl}/v1/events`). That event does two jobs at once, with ZERO server changes:
- *
- *   1. SESSION MAPPING. It carries the host's opaque `userId` + a stable `deviceKey`, so the
- *      backend can group a user's (or a pre-auth device's) opens over time — "when did this
- *      user last use the app, and how many times". The device_key links the pre-auth opens to
- *      the user once `userId` arrives (here or via `identifyOnboarding`).
- *   2. QUESTIONNAIRE / RETENTION FIRING. It flows into the SAME event stream the server's
- *      decision engines read, so a questionnaire trigger `{event:"app.session_started", min_count:N}`
- *      (matched within a session) or a questionnaire `min_sessions:N` (distinct device sessions)
- *      fires on the user's Nth open with no new server endpoint.
+ * deviceId — mint a stable, NON-PII, per-install device id the kit owns when the host supplies
+ * none. This is the headline of "device fully automatic": the analytics façade auto-mints ONE id,
+ * persists it via the host's `storage` abstraction, and reuses it on every subsequent open — so
+ * `user_context.device_key` is ALWAYS present and the server's review/questionnaire gating +
+ * A/B stickiness (both key on `device_key`) work out of the box, with zero host wiring.
  *
- * WIRE CONTRACT (server: analytics/events.py + routers/onboarding.py `POST /v1/events`):
- *   The event is stored as `event_type='app_event'`, `question_key='app.session_started'` — the
- *   generic app.* namespace the reviews wave shipped. The server's `_event_name(ev)` returns the
- *   `question_key` for an `app_event`, which is what a trigger's `event` string matches. We do NOT
- *   send `event_type:'app.session_started'` — that name is not in the server's EVENT_TYPES and
- *   would be rejected. `device_key` rides in the non-PII `user_context` bucket, where the server's
- *   `_event_device_key(ev)` reads it to group a device's sessions. `app_id` + `environment` are
- *   filled server-side from the resolving key (never sent here).
+ * WHY it is NOT PII and adds NO dependency (the kit's hard rules):
+ *   The id is a random token generated from `Date.now()` + `Math.random()` — it carries NO hardware
+ *   identifier, NO IDFA/GAID, NO fingerprint. It is a first-party per-install correlation key, the
+ *   same privacy category as a first-party cookie: it groups a single install's sessions and cannot
+ *   identify a person or be joined across apps. There is NO `uuid` (or any) dependency — a
+ *   time+random scheme is sufficient because the id is minted ONCE and then persisted, so global
+ *   uniqueness across the fleet is not required (a per-install collision is astronomically unlikely
+ *   and inconsequential — worst case two installs share a bucket).
  *
- * SESSION ID DISTINCTION (important): the `session_id` on this event is a PER-OPEN id (a fresh
- * `makeSessionId()` each app-open) — it is NOT the onboarding A2A `contextId`. Onboarding runs
- * ONCE (first launch) and owns its own context id; session-start fires on EVERY open, so it needs
- * its own per-open id. Grouping over time is done by `device_key`/`user_id`, not by session_id.
- *
- * Fire-and-forget: like every analytics path in the kit, this never throws into the UI, never
- * awaits, and swallows a missing target / bad URL / missing fetch / network error. Analytics must
- * never be able to break the app.
+ * A host that wants its OWN device id still wins: pass `WireUserContext.deviceKey` and the kit uses
+ * that verbatim and never mints/persists an auto id.
+ */
+/** Prefix so an auto-minted id is visibly the kit's (distinguishable from a host-supplied `deviceKey`). */
+declare const AUTO_DEVICE_ID_PREFIX = "wdev_";
+/** The storage key the façade persists the auto-minted id under (namespaced per `appId`). */
+declare const deviceIdStorageKey: (appId?: string) => string;
+/**
+ * Mint a fresh per-install device id. Dependency-free (`Date.now()` + `Math.random()`), never
+ * throws, and returns a NEW value on every call — the façade mints ONCE and persists, so this is
+ * called at most once per install (then the persisted value is reused). Two random chunks plus the
+ * timestamp keep the token wide enough that a per-install collision is not a practical concern.
  */
+declare const mintDeviceId: () => string;
 
 /** The canonical event name for an app-open. A trigger keys off this exact string. */
 declare const SESSION_STARTED_EVENT: "app.session_started";
@@ -1132,4 +1196,4 @@ interface UseLifecycleEventsOptions {
  */
 declare const useLifecycleEvents: (config: LifecycleConfig | undefined, options?: UseLifecycleEventsOptions) => void;
 
-export { AnimatedSparkle, BACKGROUND_SESSION_MS, type CachedFeatures, CardHandoff, type CardHandoffProps, type CardHandoffVariant, ChipSelectCard, ClientEvent, ClientEventTarget, CompletionView, DEFAULT_FEATURES_TTL_MS, DemoOnboarding, type DemoOnboardingProps, DeviceContext, DoneBlock, ErrorBlock, FIRST_OPEN_EVENT, type IdentifyOnboardingOptions, IllustrationProvider, type IllustrationRegistry, InterstitialCard, type LifecycleConfig, type LifecycleEventInput, LoadingBlock, LoadingScreen, NumberStepperCard, type OnboardingAttribution, Button as OnboardingButton, OnboardingCopy, OnboardingEvent, type OnboardingFlagOptions, OnboardingFlow, OnboardingResult, OnboardingScaffold, OnboardingTheme, OnboardingThemeProvider, type ReportFirstOpenOptions, type ReportSessionStartOptions, type ResolveFeaturesOptions, SESSION_STARTED_EVENT, SelectionCard, type SessionStartConfig, StatusCard, StepProgress, StepValidator, TextInputCard, type ThemeFromBrandInput, USER_ID_MAX_LENGTH, type UseLifecycleEventsOptions, type UseSessionStartOptions, type WireConfigOverrides, WireFeatures, WireFeaturesConfig, WireFeaturesProvider, type WireFeaturesProviderProps, type WireLifecycleOptions, WireOnboarding, WireOnboardingConfig, WireOnboardingProps, WireOnboardingStorage, attributionMetadata, defaultIllustrations, defaultOnboardingTheme, defaultWireFeatures, deriveAnswers, featuresCacheKey, featuresEqual, fetchWireFeatures, firstOpenStorageKey, identifyOnboarding, isFeaturesFresh, isOnboardingEnabled, mergeTheme, motionSpec, onboardingComponents, parseWireFeatures, readCachedFeatures, readProgress, reportFirstOpen, reportSessionStart, resetFirstOpenLatch, resetSessionStartGuard, sanitizeUserId, themeFromBrand, useIllustration, useLifecycleEvents, useOnboardingTheme, useReducedMotion, useResolvedFeatures, useSessionStart, useWireFeatures, useWireFeaturesContext, wireConfigFromEnv, wireLifecycleEvents, writeCachedFeatures };
+export { AUTO_DEVICE_ID_PREFIX, AnimatedSparkle, BACKGROUND_SESSION_MS, type CachedFeatures, CardHandoff, type CardHandoffProps, type CardHandoffVariant, ChipSelectCard, ClientEvent, ClientEventTarget, CompletionView, DEFAULT_FEATURES_TTL_MS, DemoOnboarding, type DemoOnboardingProps, DeviceContext, DoneBlock, ErrorBlock, FIRST_OPEN_EVENT, type IdentifyOnboardingOptions, IllustrationProvider, type IllustrationRegistry, InterstitialCard, type LifecycleConfig, type LifecycleEventInput, LoadingBlock, LoadingScreen, NumberStepperCard, type OnboardingAttribution, Button as OnboardingButton, OnboardingCopy, OnboardingEvent, type OnboardingFlagOptions, OnboardingFlow, OnboardingResult, OnboardingScaffold, OnboardingTheme, OnboardingThemeProvider, type ReportFirstOpenOptions, type ReportSessionStartOptions, type ResolveFeaturesOptions, SESSION_STARTED_EVENT, SelectionCard, type SessionStartConfig, StatusCard, StepProgress, StepValidator, TextInputCard, type ThemeFromBrandInput, USER_ID_MAX_LENGTH, type UseLifecycleEventsOptions, type UseSessionStartOptions, type WireConfigOverrides, WireFeatures, WireFeaturesConfig, WireFeaturesProvider, type WireFeaturesProviderProps, type WireLifecycleOptions, WireOnboarding, WireOnboardingConfig, WireOnboardingProps, WireOnboardingStorage, attributionMetadata, defaultIllustrations, defaultOnboardingTheme, defaultWireFeatures, deriveAnswers, detectAppVersion, detectNativeModel, deviceIdStorageKey, featuresCacheKey, featuresEqual, fetchWireFeatures, firstOpenStorageKey, identifyOnboarding, isFeaturesFresh, isOnboardingEnabled, mergeTheme, mintDeviceId, motionSpec, onboardingComponents, parseWireFeatures, readCachedFeatures, readProgress, reportFirstOpen, reportSessionStart, resetFirstOpenLatch, resetSessionStartGuard, sanitizeUserId, themeFromBrand, useIllustration, useLifecycleEvents, useOnboardingTheme, useReducedMotion, useResolvedFeatures, useSessionStart, useWireFeatures, useWireFeaturesContext, wireConfigFromEnv, wireLifecycleEvents, writeCachedFeatures };

package/dist/index.js

@@ -12,6 +12,12 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var React14__default = /*#__PURE__*/_interopDefault(React14);
 
 var __defProp = Object.defineProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -2349,6 +2355,98 @@ var onboardingComponents = [
   NumberStepperCard,
   InterstitialCard
 ];
+
+// src/device/appVersion.ts
+var coerceVersion = (value) => {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+};
+var runtimeRequire = (moduleName) => {
+  try {
+    if (typeof __require !== "function") return void 0;
+    return __require(moduleName);
+  } catch {
+    return void 0;
+  }
+};
+var interop = (mod) => {
+  if (!mod || typeof mod !== "object") return void 0;
+  const def = mod.default;
+  if (def && typeof def === "object") return def;
+  return mod;
+};
+var safeInterop = (requireModule, moduleName) => {
+  try {
+    return interop(requireModule(moduleName));
+  } catch {
+    return void 0;
+  }
+};
+var detectAppVersion = (requireModule = runtimeRequire) => {
+  try {
+    const constants = safeInterop(requireModule, "expo-constants");
+    if (constants) {
+      const expoConfig = constants.expoConfig;
+      if (expoConfig && typeof expoConfig === "object") {
+        const fromExpoConfig = coerceVersion(expoConfig.version);
+        if (fromExpoConfig) return fromExpoConfig;
+      }
+      const fromNative = coerceVersion(constants.nativeAppVersion);
+      if (fromNative) return fromNative;
+    }
+    const application = safeInterop(requireModule, "expo-application");
+    if (application) {
+      const fromApplication = coerceVersion(application.nativeApplicationVersion);
+      if (fromApplication) return fromApplication;
+    }
+  } catch {
+  }
+  return void 0;
+};
+
+// src/device/deviceModel.ts
+var coerceModel = (value) => {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+};
+var runtimeRequire2 = (moduleName) => {
+  try {
+    if (typeof __require !== "function") return void 0;
+    return __require(moduleName);
+  } catch {
+    return void 0;
+  }
+};
+var interop2 = (mod) => {
+  if (!mod || typeof mod !== "object") return void 0;
+  const def = mod.default;
+  if (def && typeof def === "object") return def;
+  return mod;
+};
+var safeInterop2 = (requireModule, moduleName) => {
+  try {
+    return interop2(requireModule(moduleName));
+  } catch {
+    return void 0;
+  }
+};
+var detectNativeModel = (requireModule = runtimeRequire2) => {
+  try {
+    const device = safeInterop2(requireModule, "expo-device");
+    if (device) {
+      const modelName = coerceModel(device.modelName);
+      if (modelName) return modelName;
+      const modelId = coerceModel(device.modelId);
+      if (modelId) return modelId;
+    }
+  } catch {
+  }
+  return void 0;
+};
+
+// src/device/deviceContext.ts
 var deriveFormFactor = (iosIdiom, width, height) => {
   if (iosIdiom === "pad") return "tablet";
   if (iosIdiom === "phone") return "phone";
@@ -2394,6 +2492,8 @@ var collectDeviceContext = () => {
         ctx.interfaceIdiom = idiom;
         iosIdiom = idiom;
       }
+      const iosModel = detectNativeModel();
+      if (iosModel) ctx.model = iosModel;
     }
   } catch {
   }
@@ -2418,9 +2518,21 @@ var collectDeviceContext = () => {
     if (resolved.timeZone) ctx.timeZone = resolved.timeZone;
   } catch {
   }
+  const appVersion = detectAppVersion();
+  if (appVersion) ctx.appVersion = appVersion;
   return ctx;
 };
 
+// src/analytics/currentSession.ts
+var _currentSessionId;
+var setCurrentSessionId = (id) => {
+  if (typeof id === "string" && id.length > 0) _currentSessionId = id;
+};
+var getCurrentSessionId = () => _currentSessionId;
+var resetCurrentSessionId = () => {
+  _currentSessionId = void 0;
+};
+
 // src/session/persistedSession.ts
 var DEFAULT_SESSION_TTL_MS = 36e5;
 var READ_TIMEOUT_MS = 1500;
@@ -2499,6 +2611,7 @@ var identifyOnboarding = async (opts) => {
       contextId = stored == null ? void 0 : stored.id;
     }
   }
+  if (!contextId) contextId = getCurrentSessionId();
   if (!contextId) return false;
   reportClientEvent(
     { serverUrl: opts.config.serverUrl, apiKey: opts.config.apiKey },
@@ -3155,6 +3268,89 @@ 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 resolveUserContext = (ctx = {}, opts = {}) => {
+  var _a;
+  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 = (_a = cleanString(ctx.appVersion)) != null ? _a : cleanString(opts.autoAppVersion);
+  if (appVersion) {
+    result.appVersion = appVersion;
+    bucket.app_version = appVersion;
+  }
+  const email = cleanString(ctx.userEmail);
+  if (email) {
+    if (ctx.hashEmail) {
+      bucket.user_email = hashEmailFnv1a(email);
+      bucket.user_email_hashed = true;
+    } else {
+      bucket.user_email = email;
+    }
+  }
+  Object.assign(bucket, namespaceExtra(ctx.extra));
+  if (Object.keys(bucket).length > 0) result.userContext = bucket;
+  return result;
+};
+
+// src/context/deviceId.ts
+var AUTO_DEVICE_ID_PREFIX = "wdev_";
+var deviceIdStorageKey = (appId) => `wireai:analytics:deviceKey:${appId != null ? appId : "default"}`;
+var randomChunk = () => Math.floor(Math.random() * 4294967296).toString(36).padStart(6, "0");
+var mintDeviceId = () => {
+  const time = Date.now().toString(36);
+  return `${AUTO_DEVICE_ID_PREFIX}${time}_${randomChunk()}${randomChunk()}`;
+};
+
 // src/session-analytics/reportSessionStart.ts
 var SESSION_STARTED_EVENT = "app.session_started";
 var _emitted = /* @__PURE__ */ new Set();
@@ -3167,6 +3363,7 @@ var reportSessionStart = (opts) => {
   const target = opts.target;
   if (!opts.sink && !(target == null ? void 0 : target.serverUrl)) return;
   const sessionId = (_a = opts.sessionId) != null ? _a : makeSessionId();
+  setCurrentSessionId(sessionId);
   if (opts.once !== false) {
     if (_emitted.has(sessionId)) return;
     if (_emitted.size >= _GUARD_MAX) {
@@ -3223,7 +3420,7 @@ var useSessionStart = (config, options = {}) => {
       if (opts.enabled === false) return;
       const target = { serverUrl: cfg.serverUrl, apiKey: (_a = cfg.apiKey) != null ? _a : "" };
       const device = collectDeviceContext();
-      if (cfg.appVersion && !device.appVersion) device.appVersion = cfg.appVersion;
+      if (cfg.appVersion) device.appVersion = cfg.appVersion;
       reportSessionStart({
         target,
         // A fresh per-open id each fire; the emitter's once-guard dedupes within the open.
@@ -3597,7 +3794,7 @@ var useLifecycleEvents = (config, options = {}) => {
       const { config: cfg, options: opts } = latest.current;
       if (opts.enabled !== false) {
         const device = collectDeviceContext();
-        if ((cfg == null ? void 0 : cfg.appVersion) && !device.appVersion) device.appVersion = cfg.appVersion;
+        if (cfg == null ? void 0 : cfg.appVersion) device.appVersion = cfg.appVersion;
         reportFirstOpen({
           target: targetOf(cfg),
           sink: resolveSink(),
@@ -3619,7 +3816,7 @@ var useLifecycleEvents = (config, options = {}) => {
       if (opts.enabled === false) return;
       if (!(cfg == null ? void 0 : cfg.serverUrl) && !opts.sink) return;
       const device = collectDeviceContext();
-      if ((cfg == null ? void 0 : cfg.appVersion) && !device.appVersion) device.appVersion = cfg.appVersion;
+      if (cfg == null ? void 0 : cfg.appVersion) device.appVersion = cfg.appVersion;
       reportSessionStart({
         target: targetOf(cfg),
         sink: resolveSink(),
@@ -3653,6 +3850,7 @@ var useLifecycleEvents = (config, options = {}) => {
   }, []);
 };
 
+exports.AUTO_DEVICE_ID_PREFIX = AUTO_DEVICE_ID_PREFIX;
 exports.AnimatedSparkle = AnimatedSparkle;
 exports.BACKGROUND_SESSION_MS = BACKGROUND_SESSION_MS;
 exports.CardHandoff = CardHandoff;
@@ -3663,6 +3861,7 @@ 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;
 exports.IllustrationProvider = IllustrationProvider;
@@ -3674,6 +3873,7 @@ exports.OnboardingButton = Button;
 exports.OnboardingFlow = OnboardingFlow;
 exports.OnboardingScaffold = OnboardingScaffold;
 exports.OnboardingThemeProvider = OnboardingThemeProvider;
+exports.RESERVED_USER_CONTEXT_KEYS = RESERVED_USER_CONTEXT_KEYS;
 exports.SESSION_STARTED_EVENT = SESSION_STARTED_EVENT;
 exports.SelectionCard = SelectionCard;
 exports.StatusCard = StatusCard;
@@ -3690,17 +3890,25 @@ exports.defaultIllustrations = defaultIllustrations;
 exports.defaultOnboardingTheme = defaultOnboardingTheme;
 exports.defaultWireFeatures = defaultWireFeatures;
 exports.deriveAnswers = deriveAnswers;
+exports.detectAppVersion = detectAppVersion;
+exports.detectNativeModel = detectNativeModel;
+exports.deviceIdStorageKey = deviceIdStorageKey;
 exports.featuresCacheKey = featuresCacheKey;
 exports.featuresEqual = featuresEqual;
 exports.fetchWireFeatures = fetchWireFeatures;
 exports.firstOpenStorageKey = firstOpenStorageKey;
+exports.getCurrentSessionId = getCurrentSessionId;
+exports.hashEmailFnv1a = hashEmailFnv1a;
 exports.identifyOnboarding = identifyOnboarding;
 exports.isFeaturesFresh = isFeaturesFresh;
 exports.isOnboardingEnabled = isOnboardingEnabled;
+exports.isWireScalar = isWireScalar;
 exports.loadPersistedSession = loadPersistedSession;
 exports.makeSessionId = makeSessionId;
 exports.mergeTheme = mergeTheme;
+exports.mintDeviceId = mintDeviceId;
 exports.motionSpec = motionSpec_exports;
+exports.namespaceExtra = namespaceExtra;
 exports.onboardingComponents = onboardingComponents;
 exports.parseWireFeatures = parseWireFeatures;
 exports.peekPersistedSession = peekPersistedSession;
@@ -3710,11 +3918,14 @@ exports.reportClientEvent = reportClientEvent;
 exports.reportClientEvents = reportClientEvents;
 exports.reportFirstOpen = reportFirstOpen;
 exports.reportSessionStart = reportSessionStart;
+exports.resetCurrentSessionId = resetCurrentSessionId;
 exports.resetFirstOpenLatch = resetFirstOpenLatch;
 exports.resetSessionStartGuard = resetSessionStartGuard;
+exports.resolveUserContext = resolveUserContext;
 exports.sanitizeUserId = sanitizeUserId;
 exports.savePersistedSession = savePersistedSession;
 exports.sessionStorageKey = sessionStorageKey;
+exports.setCurrentSessionId = setCurrentSessionId;
 exports.themeFromBrand = themeFromBrand;
 exports.toAnalyticsEvent = toAnalyticsEvent;
 exports.useIllustration = useIllustration;