@wireai/activation 0.7.0 → 0.8.0

package/dist/{currentSession-CxnP7gAa.d.ts → currentSession-f7LWcdWG.d.ts}

@@ -39,7 +39,15 @@ type DeviceContext = {
     osVersion?: string;
     /** Android device brand (e.g. "samsung"). Android only. */
     brand?: string;
-    /** Android device model (e.g. "SM-G991B"). Android only. */
+    /**
+     * Device model. On Android it is read directly from `Platform.constants.Model` (e.g. "SM-G991B").
+     * iOS `Platform.constants` exposes NO model, so on iOS it is a BEST-EFFORT read of `expo-device`'s
+     * `modelName` ("iPhone 14 Pro"), falling back to `modelId` ("iPhone15,2") — dependency-free via a
+     * guarded require (see device/deviceModel.ts). ASYMMETRY: without `expo-device` installed, iOS
+     * `model` is omitted (there is no dependency-free iOS model in the already-used RN surface, and the
+     * kit will not add a native dep for it); Android needs no extra module. Not PII (a device class,
+     * not a unique id), so it changes no privacy-label declaration.
+     */
     model?: string;
     /** iOS interface idiom ("phone" | "pad" | …), when reported. iOS only. */
     interfaceIdiom?: string;

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
-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-BJBB7i4-.mjs';
-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-BJBB7i4-.mjs';
+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-d9CrBxwe.mjs';
+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-d9CrBxwe.mjs';
 import { O as OnboardingTheme } from './types-BKfpdZzX.mjs';
 export { a as OnboardingButtonStyle, b as OnboardingColors, c as OnboardingFonts, d as OnboardingRadius, e as OnboardingSpacing } from './types-BKfpdZzX.mjs';
 export { C as CenteredModal, a as CenteredModalHandle, b as CenteredModalProps } from './CenteredModal-C3qQBHsA.mjs';
@@ -849,7 +849,7 @@ declare const attributionMetadata: (a: OnboardingAttribution) => {
  * Analytics must never be able to break onboarding.
  */
 /** A `require`-like resolver. Injectable in tests; production uses the guarded runtime require. */
-type OptionalRequire = (moduleName: string) => unknown;
+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
@@ -858,7 +858,40 @@ type OptionalRequire = (moduleName: string) => unknown;
  * `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) => string | undefined;
+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). */
@@ -906,6 +939,37 @@ type IdentifyOnboardingOptions = {
  */
 declare const identifyOnboarding: (opts: IdentifyOnboardingOptions) => Promise<boolean>;
 
+/**
+ * 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.
+ *
+ * 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).
+ *
+ * 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";
 /** Options for {@link reportSessionStart}. Everything except `target` is optional so a pre-auth
@@ -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, detectAppVersion, 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.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
-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-CxnP7gAa.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-CxnP7gAa.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';
@@ -849,7 +849,7 @@ declare const attributionMetadata: (a: OnboardingAttribution) => {
  * Analytics must never be able to break onboarding.
  */
 /** A `require`-like resolver. Injectable in tests; production uses the guarded runtime require. */
-type OptionalRequire = (moduleName: string) => unknown;
+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
@@ -858,7 +858,40 @@ type OptionalRequire = (moduleName: string) => unknown;
  * `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) => string | undefined;
+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). */
@@ -906,6 +939,37 @@ type IdentifyOnboardingOptions = {
  */
 declare const identifyOnboarding: (opts: IdentifyOnboardingOptions) => Promise<boolean>;
 
+/**
+ * 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.
+ *
+ * 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).
+ *
+ * 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";
 /** Options for {@link reportSessionStart}. Everything except `target` is optional so a pre-auth
@@ -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, detectAppVersion, 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

@@ -2405,6 +2405,47 @@ var detectAppVersion = (requireModule = runtimeRequire) => {
   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";
@@ -2451,6 +2492,8 @@ var collectDeviceContext = () => {
         ctx.interfaceIdiom = idiom;
         iosIdiom = idiom;
       }
+      const iosModel = detectNativeModel();
+      if (iosModel) ctx.model = iosModel;
     }
   } catch {
   }
@@ -3299,6 +3342,15 @@ var resolveUserContext = (ctx = {}, opts = {}) => {
   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();
@@ -3798,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;
@@ -3838,6 +3891,8 @@ 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;
@@ -3851,6 +3906,7 @@ 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;