@wireai/activation 0.10.0 → 0.11.0

package/dist/{currentSession-DdDkprpM.d.mts → currentSession-C0_odnIW.d.mts}

@@ -152,6 +152,16 @@ type ClientEvent = {
      * Lets the backend reconcile onboarding sessions to real users. Old servers ignore it.
      */
     user_id?: string;
+    /**
+     * Client-stamped epoch-ms timestamp of when the event was ENQUEUED on the device. Optional and
+     * ADDITIVE: the offline queue stamps it at enqueue time (see `createEventQueue`) so two otherwise
+     * byte-identical events fired seconds apart (a genuine repeat, e.g. the user taps "share" twice)
+     * are NOT collapsed by the queue's identical-JSON de-dup — while two truly simultaneous
+     * re-enqueues of the same instant (a redundant re-render) still share a `ts` and collapse. A raw
+     * `Date.now()`, never a wall-clock the server trusts (the server derives its own receive time);
+     * an old/strict server that does not model it simply ignores the unknown field.
+     */
+    ts?: number;
 };
 /** Where to POST. Derived from `WireOnboardingConfig` (`serverUrl` + `apiKey`). */
 type ClientEventTarget = {
@@ -676,6 +686,42 @@ declare const hashEmailFnv1a: (email: string) => string;
  * are DROPPED. Returns an object (possibly empty).
  */
 declare const namespaceExtra: (extra: Record<string, unknown> | undefined) => Record<string, string | number | boolean>;
+/**
+ * The storage key the analytics façade persists the bound opaque `user_id` under (namespaced per
+ * `appId`, mirroring {@link deviceIdStorageKey}). Exported so a logout path can target it directly.
+ */
+declare const analyticsUserIdStorageKey: (appId?: string) => string;
+/**
+ * Return a COPY of a {@link WireUserContext} with every USER-scoped (PII / pseudonymous) field
+ * removed — `userId`, `userEmail`, `hashEmail`, and `extra` — while KEEPING the non-PII device-scope
+ * fields (`appVersion`, `deviceKey`). This is the in-memory half of logout: after it, the same
+ * analytics instance keeps its stable `device_key` (which groups a DEVICE, not a user) but no longer
+ * stamps the previous user's id/email onto events. Pure; never mutates the input.
+ */
+declare const clearPiiFromContext: (ctx?: WireUserContext) => WireUserContext;
+/** Options for {@link clearUserContext}. */
+interface ClearUserContextOptions {
+    /** Host persistence (AsyncStorage subset) — the persisted bound `user_id` is removed from here. */
+    storage?: WireOnboardingStorage;
+    /** Tenant/app id — namespaces the persisted key (`wireai:analytics:userId:<appId>`). */
+    appId?: string;
+}
+/**
+ * LOGOUT primitive: purge the persisted, bound opaque `user_id` for an app so the NEXT user on a
+ * shared device is not silently attributed to the previous one. Removes the
+ * `wireai:analytics:userId:<appId>` key that the analytics façade persists and reuses across
+ * launches. Fire-and-forget: a missing storage or a failing adapter resolves quietly.
+ *
+ * COVERAGE. The stateful `createAnalytics(...)` instance also exposes {@link Analytics.reset}, which
+ * does this AND clears the in-memory binding + PII in one call — prefer it when you hold the
+ * instance. This standalone helper covers the `createWireActivation` / `wire` path (whose config is
+ * captured immutably, so it has no `reset`): call `clearUserContext({ storage, appId })` on logout,
+ * and RECREATE the `wire` / analytics instance without the user's `userContext` (userId/userEmail)
+ * so no further events carry the previous user's identity. The non-PII per-install `device_key`
+ * (`wireai:analytics:deviceKey:<appId>`) is intentionally left in place — it groups a device, not a
+ * person, and stays stable across users of the same install.
+ */
+declare const clearUserContext: (opts?: ClearUserContextOptions) => Promise<void>;
 /** Options for {@link resolveUserContext}. */
 interface ResolveUserContextOptions {
     /**
@@ -691,6 +737,60 @@ interface ResolveUserContextOptions {
  */
 declare const resolveUserContext: (ctx?: WireUserContext, opts?: ResolveUserContextOptions) => ResolvedUserContext;
 
+/** 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;
+/**
+ * Normalize a host-supplied user id: trim, drop empty, and cap at {@link USER_ID_MAX_LENGTH}.
+ * Returns `undefined` for a missing/blank/non-string value so callers can `if (id)`-gate.
+ * PII is a host concern — this only bounds length, it does not (and cannot) detect an email.
+ */
+declare const sanitizeUserId: (raw: unknown) => string | undefined;
+/**
+ * A permissive email-SHAPE test (`local@domain.tld`) — NOT an RFC validator. Its ONE job is to
+ * catch the common integration mistake of binding a RAW EMAIL as the opaque `user_id`: that leaks
+ * PII into the top-level id (which the server treats as an opaque key and may surface), when the
+ * email belongs in the opt-in `user_context.user_email` field instead. `identify()` uses this to
+ * refuse an email-shaped id (with a dev warning) unless the host opts in explicitly. Trims first.
+ */
+declare const looksLikeEmail: (value: unknown) => boolean;
+/** Options for {@link identifyOnboarding}. */
+type IdentifyOnboardingOptions = {
+    /** Tenant transport, same shape as `WireOnboardingConfig` (only these two fields are used). */
+    config: {
+        serverUrl: string;
+        apiKey: string;
+    };
+    /** The host's opaque user id to bind. Trimmed + capped; NO PII. */
+    userId: string;
+    /**
+     * The onboarding session id to bind to (the A2A contextId) — the `contextId` field carried on
+     * the `started`/`resumed` `onEvent`. Pass this when you captured it there. Required after the
+     * flow COMPLETED, since completion clears the persisted session. Wins over the storage lookup.
+     */
+    contextId?: string;
+    /**
+     * The SAME host storage you passed to `<WireOnboarding storage={…} />`. When `contextId` is
+     * omitted, the helper reads the persisted contextId from it (works while the session is still
+     * persisted — i.e. dropped or mid-flow, before completion clears it).
+     */
+    storage?: WireOnboardingStorage;
+    /** App id, to derive the default storage key `wireai:session:<appId>` when reading from storage. */
+    appId?: string;
+    /** Storage key override — pass the same `persistKey` you gave `<WireOnboarding>`, if any. */
+    persistKey?: string;
+};
+/**
+ * Attach a host user id to an onboarding session AFTER the fact (post-registration), by sending
+ * an `identify` client event to `/v1/events`. Resolves the contextId from an explicit
+ * `contextId` or, failing that, from the persisted session in the host `storage`.
+ *
+ * Fire-and-forget under the hood (never throws, never blocks onboarding). Resolves to `true`
+ * when an identify event was dispatched, `false` when it couldn't (no user id, no server url,
+ * or no resolvable contextId).
+ */
+declare const identifyOnboarding: (opts: IdentifyOnboardingOptions) => Promise<boolean>;
+
 /**
  * currentSession — a tiny registry of the CURRENT per-open `session_id`.
  *
@@ -736,4 +836,4 @@ declare const getCurrentSessionId: () => string | undefined;
 /** Test-only: forget the current session id so a unit test starts from a clean registry. */
 declare const resetCurrentSessionId: () => void;
 
-export { type AnalyticsEvent as A, type ResolveUserContextOptions as B, type ClientEvent as C, type DeviceContext as D, type EventQueueOptions as E, type ResolvedUserContext as F, collectDeviceContext as G, hashEmailFnv1a as H, isWireScalar as I, namespaceExtra as J, resolveUserContext as K, type OnboardingResult as O, RESERVED_USER_CONTEXT_KEYS as R, type StepValidator as S, type WireUserContext as W, type ClientEventTarget as a, type ClientEventType as b, type ContextEnvelope as c, type ContextEnvelopeInput as d, type EnvelopeSource as e, type EventQueue as f, WIRE_ONBOARDING_EVENTS as g, type WireOnboardingEventName as h, buildContextEnvelope as i, createEventQueue as j, getCurrentSessionId as k, reportClientEventAwait as l, makeSessionId as m, reportClientEvents as n, reportClientEventsAwait as o, resetCurrentSessionId as p, type WireOnboardingProps as q, reportClientEvent as r, setCurrentSessionId as s, toAnalyticsEvent as t, type WireOnboardingConfig as u, type OnboardingEvent as v, type OnboardingCopy as w, type DeviceFormFactor as x, EXTRA_KEY_PREFIX as y, type OnboardingProgress as z };
+export { type AnalyticsEvent as A, type OnboardingEvent as B, type ClearUserContextOptions as C, type OnboardingCopy as D, type EventQueueOptions as E, type DeviceContext as F, type DeviceFormFactor as G, EXTRA_KEY_PREFIX as H, type IdentifyOnboardingOptions as I, type OnboardingProgress as J, type ResolveUserContextOptions as K, type ResolvedUserContext as L, collectDeviceContext as M, hashEmailFnv1a as N, type OnboardingResult as O, identifyOnboarding as P, isWireScalar as Q, RESERVED_USER_CONTEXT_KEYS as R, type StepValidator as S, namespaceExtra as T, USER_ID_MAX_LENGTH as U, resolveUserContext as V, type WireUserContext as W, sanitizeUserId as X, type ClientEvent as a, type ClientEventTarget as b, type ClientEventType as c, type ContextEnvelope as d, type ContextEnvelopeInput as e, type EnvelopeSource as f, type EventQueue as g, WIRE_ONBOARDING_EVENTS as h, type WireOnboardingEventName as i, analyticsUserIdStorageKey as j, buildContextEnvelope as k, clearPiiFromContext as l, clearUserContext as m, createEventQueue as n, getCurrentSessionId as o, looksLikeEmail as p, makeSessionId as q, reportClientEvent as r, reportClientEventAwait as s, reportClientEvents as t, reportClientEventsAwait as u, resetCurrentSessionId as v, setCurrentSessionId as w, toAnalyticsEvent as x, type WireOnboardingProps as y, type WireOnboardingConfig as z };

package/dist/{currentSession-D0Vq7_VE.d.ts → currentSession-DdnUq2HQ.d.ts}

@@ -152,6 +152,16 @@ type ClientEvent = {
      * Lets the backend reconcile onboarding sessions to real users. Old servers ignore it.
      */
     user_id?: string;
+    /**
+     * Client-stamped epoch-ms timestamp of when the event was ENQUEUED on the device. Optional and
+     * ADDITIVE: the offline queue stamps it at enqueue time (see `createEventQueue`) so two otherwise
+     * byte-identical events fired seconds apart (a genuine repeat, e.g. the user taps "share" twice)
+     * are NOT collapsed by the queue's identical-JSON de-dup — while two truly simultaneous
+     * re-enqueues of the same instant (a redundant re-render) still share a `ts` and collapse. A raw
+     * `Date.now()`, never a wall-clock the server trusts (the server derives its own receive time);
+     * an old/strict server that does not model it simply ignores the unknown field.
+     */
+    ts?: number;
 };
 /** Where to POST. Derived from `WireOnboardingConfig` (`serverUrl` + `apiKey`). */
 type ClientEventTarget = {
@@ -676,6 +686,42 @@ declare const hashEmailFnv1a: (email: string) => string;
  * are DROPPED. Returns an object (possibly empty).
  */
 declare const namespaceExtra: (extra: Record<string, unknown> | undefined) => Record<string, string | number | boolean>;
+/**
+ * The storage key the analytics façade persists the bound opaque `user_id` under (namespaced per
+ * `appId`, mirroring {@link deviceIdStorageKey}). Exported so a logout path can target it directly.
+ */
+declare const analyticsUserIdStorageKey: (appId?: string) => string;
+/**
+ * Return a COPY of a {@link WireUserContext} with every USER-scoped (PII / pseudonymous) field
+ * removed — `userId`, `userEmail`, `hashEmail`, and `extra` — while KEEPING the non-PII device-scope
+ * fields (`appVersion`, `deviceKey`). This is the in-memory half of logout: after it, the same
+ * analytics instance keeps its stable `device_key` (which groups a DEVICE, not a user) but no longer
+ * stamps the previous user's id/email onto events. Pure; never mutates the input.
+ */
+declare const clearPiiFromContext: (ctx?: WireUserContext) => WireUserContext;
+/** Options for {@link clearUserContext}. */
+interface ClearUserContextOptions {
+    /** Host persistence (AsyncStorage subset) — the persisted bound `user_id` is removed from here. */
+    storage?: WireOnboardingStorage;
+    /** Tenant/app id — namespaces the persisted key (`wireai:analytics:userId:<appId>`). */
+    appId?: string;
+}
+/**
+ * LOGOUT primitive: purge the persisted, bound opaque `user_id` for an app so the NEXT user on a
+ * shared device is not silently attributed to the previous one. Removes the
+ * `wireai:analytics:userId:<appId>` key that the analytics façade persists and reuses across
+ * launches. Fire-and-forget: a missing storage or a failing adapter resolves quietly.
+ *
+ * COVERAGE. The stateful `createAnalytics(...)` instance also exposes {@link Analytics.reset}, which
+ * does this AND clears the in-memory binding + PII in one call — prefer it when you hold the
+ * instance. This standalone helper covers the `createWireActivation` / `wire` path (whose config is
+ * captured immutably, so it has no `reset`): call `clearUserContext({ storage, appId })` on logout,
+ * and RECREATE the `wire` / analytics instance without the user's `userContext` (userId/userEmail)
+ * so no further events carry the previous user's identity. The non-PII per-install `device_key`
+ * (`wireai:analytics:deviceKey:<appId>`) is intentionally left in place — it groups a device, not a
+ * person, and stays stable across users of the same install.
+ */
+declare const clearUserContext: (opts?: ClearUserContextOptions) => Promise<void>;
 /** Options for {@link resolveUserContext}. */
 interface ResolveUserContextOptions {
     /**
@@ -691,6 +737,60 @@ interface ResolveUserContextOptions {
  */
 declare const resolveUserContext: (ctx?: WireUserContext, opts?: ResolveUserContextOptions) => ResolvedUserContext;
 
+/** 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;
+/**
+ * Normalize a host-supplied user id: trim, drop empty, and cap at {@link USER_ID_MAX_LENGTH}.
+ * Returns `undefined` for a missing/blank/non-string value so callers can `if (id)`-gate.
+ * PII is a host concern — this only bounds length, it does not (and cannot) detect an email.
+ */
+declare const sanitizeUserId: (raw: unknown) => string | undefined;
+/**
+ * A permissive email-SHAPE test (`local@domain.tld`) — NOT an RFC validator. Its ONE job is to
+ * catch the common integration mistake of binding a RAW EMAIL as the opaque `user_id`: that leaks
+ * PII into the top-level id (which the server treats as an opaque key and may surface), when the
+ * email belongs in the opt-in `user_context.user_email` field instead. `identify()` uses this to
+ * refuse an email-shaped id (with a dev warning) unless the host opts in explicitly. Trims first.
+ */
+declare const looksLikeEmail: (value: unknown) => boolean;
+/** Options for {@link identifyOnboarding}. */
+type IdentifyOnboardingOptions = {
+    /** Tenant transport, same shape as `WireOnboardingConfig` (only these two fields are used). */
+    config: {
+        serverUrl: string;
+        apiKey: string;
+    };
+    /** The host's opaque user id to bind. Trimmed + capped; NO PII. */
+    userId: string;
+    /**
+     * The onboarding session id to bind to (the A2A contextId) — the `contextId` field carried on
+     * the `started`/`resumed` `onEvent`. Pass this when you captured it there. Required after the
+     * flow COMPLETED, since completion clears the persisted session. Wins over the storage lookup.
+     */
+    contextId?: string;
+    /**
+     * The SAME host storage you passed to `<WireOnboarding storage={…} />`. When `contextId` is
+     * omitted, the helper reads the persisted contextId from it (works while the session is still
+     * persisted — i.e. dropped or mid-flow, before completion clears it).
+     */
+    storage?: WireOnboardingStorage;
+    /** App id, to derive the default storage key `wireai:session:<appId>` when reading from storage. */
+    appId?: string;
+    /** Storage key override — pass the same `persistKey` you gave `<WireOnboarding>`, if any. */
+    persistKey?: string;
+};
+/**
+ * Attach a host user id to an onboarding session AFTER the fact (post-registration), by sending
+ * an `identify` client event to `/v1/events`. Resolves the contextId from an explicit
+ * `contextId` or, failing that, from the persisted session in the host `storage`.
+ *
+ * Fire-and-forget under the hood (never throws, never blocks onboarding). Resolves to `true`
+ * when an identify event was dispatched, `false` when it couldn't (no user id, no server url,
+ * or no resolvable contextId).
+ */
+declare const identifyOnboarding: (opts: IdentifyOnboardingOptions) => Promise<boolean>;
+
 /**
  * currentSession — a tiny registry of the CURRENT per-open `session_id`.
  *
@@ -736,4 +836,4 @@ declare const getCurrentSessionId: () => string | undefined;
 /** Test-only: forget the current session id so a unit test starts from a clean registry. */
 declare const resetCurrentSessionId: () => void;
 
-export { type AnalyticsEvent as A, type ResolveUserContextOptions as B, type ClientEvent as C, type DeviceContext as D, type EventQueueOptions as E, type ResolvedUserContext as F, collectDeviceContext as G, hashEmailFnv1a as H, isWireScalar as I, namespaceExtra as J, resolveUserContext as K, type OnboardingResult as O, RESERVED_USER_CONTEXT_KEYS as R, type StepValidator as S, type WireUserContext as W, type ClientEventTarget as a, type ClientEventType as b, type ContextEnvelope as c, type ContextEnvelopeInput as d, type EnvelopeSource as e, type EventQueue as f, WIRE_ONBOARDING_EVENTS as g, type WireOnboardingEventName as h, buildContextEnvelope as i, createEventQueue as j, getCurrentSessionId as k, reportClientEventAwait as l, makeSessionId as m, reportClientEvents as n, reportClientEventsAwait as o, resetCurrentSessionId as p, type WireOnboardingProps as q, reportClientEvent as r, setCurrentSessionId as s, toAnalyticsEvent as t, type WireOnboardingConfig as u, type OnboardingEvent as v, type OnboardingCopy as w, type DeviceFormFactor as x, EXTRA_KEY_PREFIX as y, type OnboardingProgress as z };
+export { type AnalyticsEvent as A, type OnboardingEvent as B, type ClearUserContextOptions as C, type OnboardingCopy as D, type EventQueueOptions as E, type DeviceContext as F, type DeviceFormFactor as G, EXTRA_KEY_PREFIX as H, type IdentifyOnboardingOptions as I, type OnboardingProgress as J, type ResolveUserContextOptions as K, type ResolvedUserContext as L, collectDeviceContext as M, hashEmailFnv1a as N, type OnboardingResult as O, identifyOnboarding as P, isWireScalar as Q, RESERVED_USER_CONTEXT_KEYS as R, type StepValidator as S, namespaceExtra as T, USER_ID_MAX_LENGTH as U, resolveUserContext as V, type WireUserContext as W, sanitizeUserId as X, type ClientEvent as a, type ClientEventTarget as b, type ClientEventType as c, type ContextEnvelope as d, type ContextEnvelopeInput as e, type EnvelopeSource as f, type EventQueue as g, WIRE_ONBOARDING_EVENTS as h, type WireOnboardingEventName as i, analyticsUserIdStorageKey as j, buildContextEnvelope as k, clearPiiFromContext as l, clearUserContext as m, createEventQueue as n, getCurrentSessionId as o, looksLikeEmail as p, makeSessionId as q, reportClientEvent as r, reportClientEventAwait as s, reportClientEvents as t, reportClientEventsAwait as u, resetCurrentSessionId as v, setCurrentSessionId as w, toAnalyticsEvent as x, type WireOnboardingProps as y, type WireOnboardingConfig as z };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
-import { q as WireOnboardingProps, u as WireOnboardingConfig, O as OnboardingResult, S as StepValidator, v as OnboardingEvent, w as OnboardingCopy, a as ClientEventTarget, D as DeviceContext, W as WireUserContext, C as ClientEvent, e as EnvelopeSource } from './currentSession-DdDkprpM.mjs';
-export { A as AnalyticsEvent, b as ClientEventType, x as DeviceFormFactor, y as EXTRA_KEY_PREFIX, z as OnboardingProgress, R as RESERVED_USER_CONTEXT_KEYS, B as ResolveUserContextOptions, F as ResolvedUserContext, g as WIRE_ONBOARDING_EVENTS, h as WireOnboardingEventName, G as collectDeviceContext, k as getCurrentSessionId, H as hashEmailFnv1a, I as isWireScalar, m as makeSessionId, J as namespaceExtra, r as reportClientEvent, l as reportClientEventAwait, n as reportClientEvents, o as reportClientEventsAwait, p as resetCurrentSessionId, K as resolveUserContext, s as setCurrentSessionId, t as toAnalyticsEvent } from './currentSession-DdDkprpM.mjs';
+import { y as WireOnboardingProps, z as WireOnboardingConfig, O as OnboardingResult, S as StepValidator, B as OnboardingEvent, D as OnboardingCopy, b as ClientEventTarget, F as DeviceContext, W as WireUserContext, a as ClientEvent, f as EnvelopeSource } from './currentSession-C0_odnIW.mjs';
+export { A as AnalyticsEvent, C as ClearUserContextOptions, c as ClientEventType, G as DeviceFormFactor, H as EXTRA_KEY_PREFIX, I as IdentifyOnboardingOptions, J as OnboardingProgress, R as RESERVED_USER_CONTEXT_KEYS, K as ResolveUserContextOptions, L as ResolvedUserContext, U as USER_ID_MAX_LENGTH, h as WIRE_ONBOARDING_EVENTS, i as WireOnboardingEventName, j as analyticsUserIdStorageKey, l as clearPiiFromContext, m as clearUserContext, M as collectDeviceContext, o as getCurrentSessionId, N as hashEmailFnv1a, P as identifyOnboarding, Q as isWireScalar, p as looksLikeEmail, q as makeSessionId, T as namespaceExtra, r as reportClientEvent, s as reportClientEventAwait, t as reportClientEvents, u as reportClientEventsAwait, v as resetCurrentSessionId, V as resolveUserContext, X as sanitizeUserId, w as setCurrentSessionId, x as toAnalyticsEvent } from './currentSession-C0_odnIW.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';
@@ -1436,52 +1436,6 @@ type OptionalRequire = (moduleName: string) => unknown;
  */
 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;
-/**
- * Normalize a host-supplied user id: trim, drop empty, and cap at {@link USER_ID_MAX_LENGTH}.
- * Returns `undefined` for a missing/blank/non-string value so callers can `if (id)`-gate.
- * PII is a host concern — this only bounds length, it does not (and cannot) detect an email.
- */
-declare const sanitizeUserId: (raw: unknown) => string | undefined;
-/** Options for {@link identifyOnboarding}. */
-type IdentifyOnboardingOptions = {
-    /** Tenant transport, same shape as `WireOnboardingConfig` (only these two fields are used). */
-    config: {
-        serverUrl: string;
-        apiKey: string;
-    };
-    /** The host's opaque user id to bind. Trimmed + capped; NO PII. */
-    userId: string;
-    /**
-     * The onboarding session id to bind to (the A2A contextId) — the `contextId` field carried on
-     * the `started`/`resumed` `onEvent`. Pass this when you captured it there. Required after the
-     * flow COMPLETED, since completion clears the persisted session. Wins over the storage lookup.
-     */
-    contextId?: string;
-    /**
-     * The SAME host storage you passed to `<WireOnboarding storage={…} />`. When `contextId` is
-     * omitted, the helper reads the persisted contextId from it (works while the session is still
-     * persisted — i.e. dropped or mid-flow, before completion clears it).
-     */
-    storage?: WireOnboardingStorage;
-    /** App id, to derive the default storage key `wireai:session:<appId>` when reading from storage. */
-    appId?: string;
-    /** Storage key override — pass the same `persistKey` you gave `<WireOnboarding>`, if any. */
-    persistKey?: string;
-};
-/**
- * Attach a host user id to an onboarding session AFTER the fact (post-registration), by sending
- * an `identify` client event to `/v1/events`. Resolves the contextId from an explicit
- * `contextId` or, failing that, from the persisted session in the host `storage`.
- *
- * Fire-and-forget under the hood (never throws, never blocks onboarding). Resolves to `true`
- * when an identify event was dispatched, `false` when it couldn't (no user id, no server url,
- * or no resolvable contextId).
- */
-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,
@@ -1852,4 +1806,4 @@ interface UseLifecycleEventsOptions {
  */
 declare const useLifecycleEvents: (config: LifecycleConfig | undefined, options?: UseLifecycleEventsOptions) => void;
 
-export { AUTO_DEVICE_ID_PREFIX, AnimatedSparkle, BACKGROUND_SESSION_MS, type CachedFeatures, CardGridSelectCard, CardHandoff, type CardHandoffProps, type CardHandoffVariant, type CardOption, ChipSelectCard, ClientEvent, ClientEventTarget, CompletionView, DEFAULT_FEATURES_TTL_MS, DemoOnboarding, type DemoOnboardingProps, DeviceContext, DoneBlock, ErrorBlock, FIRST_OPEN_EVENT, IconRegistryProvider, 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 UseWireActivation, WIRE_ICON_GLYPHS, WIRE_ICON_NAMES, type WireActivation, type WireActivationConfig, type WireConfigOverrides, WireFeatures, WireFeaturesConfig, WireFeaturesProvider, type WireFeaturesProviderProps, WireIcon, type WireIconFamily, type WireIconGlyph, type WireIconName, type WireIconProps, type WireIconRegistry, type WireLifecycleOptions, WireOnboarding, WireOnboardingConfig, WireOnboardingProps, WireOnboardingStorage, WireUserContext, attributionMetadata, bumpActivationRevalidation, createWireActivation, defaultIllustrations, defaultOnboardingTheme, defaultWireFeatures, deriveAnswers, detectAppVersion, detectNativeModel, deviceIdStorageKey, featuresCacheKey, featuresEqual, fetchWireFeatures, firstOpenStorageKey, getActivationRevalidationVersion, identifyOnboarding, isFeaturesFresh, isOnboardingEnabled, lookupIconGlyph, mergeTheme, mintDeviceId, motionSpec, onboardingComponents, parseWireFeatures, readCachedFeatures, readProgress, reportFirstOpen, reportSessionStart, resetActivationRevalidation, resetFirstOpenLatch, resetSessionStartGuard, sanitizeUserId, subscribeActivationRevalidation, themeFromBrand, useActivationRevalidation, useHostIcon, useIllustration, useLifecycleEvents, useOnboardingTheme, useReducedMotion, useResolvedFeatures, useSessionStart, useWireActivation, useWireFeatures, useWireFeaturesContext, wireConfigFromEnv, wireLifecycleEvents, writeCachedFeatures };
+export { AUTO_DEVICE_ID_PREFIX, AnimatedSparkle, BACKGROUND_SESSION_MS, type CachedFeatures, CardGridSelectCard, CardHandoff, type CardHandoffProps, type CardHandoffVariant, type CardOption, ChipSelectCard, ClientEvent, ClientEventTarget, CompletionView, DEFAULT_FEATURES_TTL_MS, DemoOnboarding, type DemoOnboardingProps, DeviceContext, DoneBlock, ErrorBlock, FIRST_OPEN_EVENT, IconRegistryProvider, 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, type UseLifecycleEventsOptions, type UseSessionStartOptions, type UseWireActivation, WIRE_ICON_GLYPHS, WIRE_ICON_NAMES, type WireActivation, type WireActivationConfig, type WireConfigOverrides, WireFeatures, WireFeaturesConfig, WireFeaturesProvider, type WireFeaturesProviderProps, WireIcon, type WireIconFamily, type WireIconGlyph, type WireIconName, type WireIconProps, type WireIconRegistry, type WireLifecycleOptions, WireOnboarding, WireOnboardingConfig, WireOnboardingProps, WireOnboardingStorage, WireUserContext, attributionMetadata, bumpActivationRevalidation, createWireActivation, defaultIllustrations, defaultOnboardingTheme, defaultWireFeatures, deriveAnswers, detectAppVersion, detectNativeModel, deviceIdStorageKey, featuresCacheKey, featuresEqual, fetchWireFeatures, firstOpenStorageKey, getActivationRevalidationVersion, isFeaturesFresh, isOnboardingEnabled, lookupIconGlyph, mergeTheme, mintDeviceId, motionSpec, onboardingComponents, parseWireFeatures, readCachedFeatures, readProgress, reportFirstOpen, reportSessionStart, resetActivationRevalidation, resetFirstOpenLatch, resetSessionStartGuard, subscribeActivationRevalidation, themeFromBrand, useActivationRevalidation, useHostIcon, useIllustration, useLifecycleEvents, useOnboardingTheme, useReducedMotion, useResolvedFeatures, useSessionStart, useWireActivation, 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 { q as WireOnboardingProps, u as WireOnboardingConfig, O as OnboardingResult, S as StepValidator, v as OnboardingEvent, w as OnboardingCopy, a as ClientEventTarget, D as DeviceContext, W as WireUserContext, C as ClientEvent, e as EnvelopeSource } from './currentSession-D0Vq7_VE.js';
-export { A as AnalyticsEvent, b as ClientEventType, x as DeviceFormFactor, y as EXTRA_KEY_PREFIX, z as OnboardingProgress, R as RESERVED_USER_CONTEXT_KEYS, B as ResolveUserContextOptions, F as ResolvedUserContext, g as WIRE_ONBOARDING_EVENTS, h as WireOnboardingEventName, G as collectDeviceContext, k as getCurrentSessionId, H as hashEmailFnv1a, I as isWireScalar, m as makeSessionId, J as namespaceExtra, r as reportClientEvent, l as reportClientEventAwait, n as reportClientEvents, o as reportClientEventsAwait, p as resetCurrentSessionId, K as resolveUserContext, s as setCurrentSessionId, t as toAnalyticsEvent } from './currentSession-D0Vq7_VE.js';
+import { y as WireOnboardingProps, z as WireOnboardingConfig, O as OnboardingResult, S as StepValidator, B as OnboardingEvent, D as OnboardingCopy, b as ClientEventTarget, F as DeviceContext, W as WireUserContext, a as ClientEvent, f as EnvelopeSource } from './currentSession-DdnUq2HQ.js';
+export { A as AnalyticsEvent, C as ClearUserContextOptions, c as ClientEventType, G as DeviceFormFactor, H as EXTRA_KEY_PREFIX, I as IdentifyOnboardingOptions, J as OnboardingProgress, R as RESERVED_USER_CONTEXT_KEYS, K as ResolveUserContextOptions, L as ResolvedUserContext, U as USER_ID_MAX_LENGTH, h as WIRE_ONBOARDING_EVENTS, i as WireOnboardingEventName, j as analyticsUserIdStorageKey, l as clearPiiFromContext, m as clearUserContext, M as collectDeviceContext, o as getCurrentSessionId, N as hashEmailFnv1a, P as identifyOnboarding, Q as isWireScalar, p as looksLikeEmail, q as makeSessionId, T as namespaceExtra, r as reportClientEvent, s as reportClientEventAwait, t as reportClientEvents, u as reportClientEventsAwait, v as resetCurrentSessionId, V as resolveUserContext, X as sanitizeUserId, w as setCurrentSessionId, x as toAnalyticsEvent } from './currentSession-DdnUq2HQ.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';
@@ -1436,52 +1436,6 @@ type OptionalRequire = (moduleName: string) => unknown;
  */
 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;
-/**
- * Normalize a host-supplied user id: trim, drop empty, and cap at {@link USER_ID_MAX_LENGTH}.
- * Returns `undefined` for a missing/blank/non-string value so callers can `if (id)`-gate.
- * PII is a host concern — this only bounds length, it does not (and cannot) detect an email.
- */
-declare const sanitizeUserId: (raw: unknown) => string | undefined;
-/** Options for {@link identifyOnboarding}. */
-type IdentifyOnboardingOptions = {
-    /** Tenant transport, same shape as `WireOnboardingConfig` (only these two fields are used). */
-    config: {
-        serverUrl: string;
-        apiKey: string;
-    };
-    /** The host's opaque user id to bind. Trimmed + capped; NO PII. */
-    userId: string;
-    /**
-     * The onboarding session id to bind to (the A2A contextId) — the `contextId` field carried on
-     * the `started`/`resumed` `onEvent`. Pass this when you captured it there. Required after the
-     * flow COMPLETED, since completion clears the persisted session. Wins over the storage lookup.
-     */
-    contextId?: string;
-    /**
-     * The SAME host storage you passed to `<WireOnboarding storage={…} />`. When `contextId` is
-     * omitted, the helper reads the persisted contextId from it (works while the session is still
-     * persisted — i.e. dropped or mid-flow, before completion clears it).
-     */
-    storage?: WireOnboardingStorage;
-    /** App id, to derive the default storage key `wireai:session:<appId>` when reading from storage. */
-    appId?: string;
-    /** Storage key override — pass the same `persistKey` you gave `<WireOnboarding>`, if any. */
-    persistKey?: string;
-};
-/**
- * Attach a host user id to an onboarding session AFTER the fact (post-registration), by sending
- * an `identify` client event to `/v1/events`. Resolves the contextId from an explicit
- * `contextId` or, failing that, from the persisted session in the host `storage`.
- *
- * Fire-and-forget under the hood (never throws, never blocks onboarding). Resolves to `true`
- * when an identify event was dispatched, `false` when it couldn't (no user id, no server url,
- * or no resolvable contextId).
- */
-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,
@@ -1852,4 +1806,4 @@ interface UseLifecycleEventsOptions {
  */
 declare const useLifecycleEvents: (config: LifecycleConfig | undefined, options?: UseLifecycleEventsOptions) => void;
 
-export { AUTO_DEVICE_ID_PREFIX, AnimatedSparkle, BACKGROUND_SESSION_MS, type CachedFeatures, CardGridSelectCard, CardHandoff, type CardHandoffProps, type CardHandoffVariant, type CardOption, ChipSelectCard, ClientEvent, ClientEventTarget, CompletionView, DEFAULT_FEATURES_TTL_MS, DemoOnboarding, type DemoOnboardingProps, DeviceContext, DoneBlock, ErrorBlock, FIRST_OPEN_EVENT, IconRegistryProvider, 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 UseWireActivation, WIRE_ICON_GLYPHS, WIRE_ICON_NAMES, type WireActivation, type WireActivationConfig, type WireConfigOverrides, WireFeatures, WireFeaturesConfig, WireFeaturesProvider, type WireFeaturesProviderProps, WireIcon, type WireIconFamily, type WireIconGlyph, type WireIconName, type WireIconProps, type WireIconRegistry, type WireLifecycleOptions, WireOnboarding, WireOnboardingConfig, WireOnboardingProps, WireOnboardingStorage, WireUserContext, attributionMetadata, bumpActivationRevalidation, createWireActivation, defaultIllustrations, defaultOnboardingTheme, defaultWireFeatures, deriveAnswers, detectAppVersion, detectNativeModel, deviceIdStorageKey, featuresCacheKey, featuresEqual, fetchWireFeatures, firstOpenStorageKey, getActivationRevalidationVersion, identifyOnboarding, isFeaturesFresh, isOnboardingEnabled, lookupIconGlyph, mergeTheme, mintDeviceId, motionSpec, onboardingComponents, parseWireFeatures, readCachedFeatures, readProgress, reportFirstOpen, reportSessionStart, resetActivationRevalidation, resetFirstOpenLatch, resetSessionStartGuard, sanitizeUserId, subscribeActivationRevalidation, themeFromBrand, useActivationRevalidation, useHostIcon, useIllustration, useLifecycleEvents, useOnboardingTheme, useReducedMotion, useResolvedFeatures, useSessionStart, useWireActivation, useWireFeatures, useWireFeaturesContext, wireConfigFromEnv, wireLifecycleEvents, writeCachedFeatures };
+export { AUTO_DEVICE_ID_PREFIX, AnimatedSparkle, BACKGROUND_SESSION_MS, type CachedFeatures, CardGridSelectCard, CardHandoff, type CardHandoffProps, type CardHandoffVariant, type CardOption, ChipSelectCard, ClientEvent, ClientEventTarget, CompletionView, DEFAULT_FEATURES_TTL_MS, DemoOnboarding, type DemoOnboardingProps, DeviceContext, DoneBlock, ErrorBlock, FIRST_OPEN_EVENT, IconRegistryProvider, 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, type UseLifecycleEventsOptions, type UseSessionStartOptions, type UseWireActivation, WIRE_ICON_GLYPHS, WIRE_ICON_NAMES, type WireActivation, type WireActivationConfig, type WireConfigOverrides, WireFeatures, WireFeaturesConfig, WireFeaturesProvider, type WireFeaturesProviderProps, WireIcon, type WireIconFamily, type WireIconGlyph, type WireIconName, type WireIconProps, type WireIconRegistry, type WireLifecycleOptions, WireOnboarding, WireOnboardingConfig, WireOnboardingProps, WireOnboardingStorage, WireUserContext, attributionMetadata, bumpActivationRevalidation, createWireActivation, defaultIllustrations, defaultOnboardingTheme, defaultWireFeatures, deriveAnswers, detectAppVersion, detectNativeModel, deviceIdStorageKey, featuresCacheKey, featuresEqual, fetchWireFeatures, firstOpenStorageKey, getActivationRevalidationVersion, isFeaturesFresh, isOnboardingEnabled, lookupIconGlyph, mergeTheme, mintDeviceId, motionSpec, onboardingComponents, parseWireFeatures, readCachedFeatures, readProgress, reportFirstOpen, reportSessionStart, resetActivationRevalidation, resetFirstOpenLatch, resetSessionStartGuard, subscribeActivationRevalidation, themeFromBrand, useActivationRevalidation, useHostIcon, useIllustration, useLifecycleEvents, useOnboardingTheme, useReducedMotion, useResolvedFeatures, useSessionStart, useWireActivation, useWireFeatures, useWireFeaturesContext, wireConfigFromEnv, wireLifecycleEvents, writeCachedFeatures };

package/dist/index.js

@@ -3382,6 +3382,7 @@ var sanitizeUserId = (raw) => {
   if (!trimmed) return void 0;
   return trimmed.length > USER_ID_MAX_LENGTH ? trimmed.slice(0, USER_ID_MAX_LENGTH) : trimmed;
 };
+var looksLikeEmail = (value) => typeof value === "string" && /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value.trim());
 var identifyOnboarding = async (opts) => {
   var _a2, _b, _c;
   const userId = sanitizeUserId(opts.userId);
@@ -4097,6 +4098,21 @@ var namespaceExtra = (extra) => {
   }
   return out;
 };
+var analyticsUserIdStorageKey = (appId) => `wireai:analytics:userId:${appId != null ? appId : "default"}`;
+var clearPiiFromContext = (ctx = {}) => {
+  const rest = {};
+  if (typeof ctx.appVersion === "string") rest.appVersion = ctx.appVersion;
+  if (typeof ctx.deviceKey === "string") rest.deviceKey = ctx.deviceKey;
+  return rest;
+};
+var clearUserContext = async (opts = {}) => {
+  const storage = opts.storage;
+  if (!storage) return;
+  try {
+    await storage.removeItem(analyticsUserIdStorageKey(opts.appId));
+  } catch {
+  }
+};
 var resolveUserContext = (ctx = {}, opts = {}) => {
   var _a2;
   const result = {};
@@ -4390,16 +4406,9 @@ var routeLifecycleEvent = (event, opts) => {
       opts.sink(event);
       return;
     }
-    const target = opts.target;
-    if (!(target == null ? void 0 : target.serverUrl)) return;
-    const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
-    const headers = { "Content-Type": "application/json" };
-    if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
-    void fetch(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({ events: [event] })
-    }).catch(() => {
+    const req = buildEventsRequest(opts.target, [event]);
+    if (!req) return;
+    void fetch(req.url, req.init).catch(() => {
     });
   } catch {
   }
@@ -4511,6 +4520,7 @@ var createEventQueue = (options) => {
     var _a3;
     const env = resolveEnvelope();
     const stamped = { ...event };
+    if (stamped.ts === void 0) stamped.ts = Date.now();
     if (!env) return stamped;
     if (!stamped.device && env.device) stamped.device = env.device;
     if (!stamped.session_id && env.sessionId) stamped.session_id = env.sessionId;
@@ -4566,19 +4576,12 @@ var createEventQueue = (options) => {
     }
   })();
   const postBatch = async (events) => {
-    if (!(target == null ? void 0 : target.serverUrl) || events.length === 0) return false;
+    const req = buildEventsRequest(target, events);
+    if (!req) return false;
     const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
     const timer = setTimeout(() => controller == null ? void 0 : controller.abort(), 15e3);
     try {
-      const url = `${target.serverUrl.replace(/\/$/, "")}/v1/events`;
-      const headers = { "Content-Type": "application/json" };
-      if (target.apiKey) headers.Authorization = `Bearer ${target.apiKey}`;
-      const res = await fetch(url, {
-        method: "POST",
-        headers,
-        body: JSON.stringify({ events }),
-        signal: controller == null ? void 0 : controller.signal
-      });
+      const res = await fetch(req.url, { ...req.init, signal: controller == null ? void 0 : controller.signal });
       return !!(res && res.ok);
     } catch {
       return false;
@@ -4684,6 +4687,28 @@ var useLifecycleEvents = (config, options = {}) => {
       var _a3;
       return (cfg == null ? void 0 : cfg.serverUrl) ? { serverUrl: cfg.serverUrl, apiKey: (_a3 = cfg.apiKey) != null ? _a3 : "" } : void 0;
     };
+    const mountOpenSessionId = makeSessionId();
+    const fireSession = (sessionId) => {
+      var _a3;
+      const { config: cfg, options: opts } = latest.current;
+      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 = cfg.appVersion;
+      reportSessionStart({
+        target: targetOf(cfg),
+        sink: resolveSink(),
+        sessionId,
+        userId: opts.userId,
+        deviceKey: opts.deviceKey,
+        sessionCount: opts.sessionCount,
+        appVersion: (_a3 = cfg == null ? void 0 : cfg.appVersion) != null ? _a3 : device.appVersion,
+        platform: reactNative.Platform.OS,
+        device,
+        meta: opts.meta
+      });
+    };
+    fireSession(mountOpenSessionId);
     {
       const { config: cfg, options: opts } = latest.current;
       if (opts.enabled !== false) {
@@ -4692,6 +4717,7 @@ var useLifecycleEvents = (config, options = {}) => {
         reportFirstOpen({
           target: targetOf(cfg),
           sink: resolveSink(),
+          sessionId: mountOpenSessionId,
           storage: cfg == null ? void 0 : cfg.storage,
           appId: cfg == null ? void 0 : cfg.appId,
           userId: opts.userId,
@@ -4704,27 +4730,6 @@ var useLifecycleEvents = (config, options = {}) => {
         });
       }
     }
-    const fireSession = () => {
-      var _a3;
-      const { config: cfg, options: opts } = latest.current;
-      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 = cfg.appVersion;
-      reportSessionStart({
-        target: targetOf(cfg),
-        sink: resolveSink(),
-        // A fresh per-open id each fire; the emitter's once-guard dedupes within the open.
-        userId: opts.userId,
-        deviceKey: opts.deviceKey,
-        sessionCount: opts.sessionCount,
-        appVersion: (_a3 = cfg == null ? void 0 : cfg.appVersion) != null ? _a3 : device.appVersion,
-        platform: reactNative.Platform.OS,
-        device,
-        meta: opts.meta
-      });
-    };
-    fireSession();
     let backgroundedAt = null;
     const onChange = (state) => {
       if (state === "background" || state === "inactive") {
@@ -4782,9 +4787,12 @@ exports.WIRE_ONBOARDING_EVENTS = WIRE_ONBOARDING_EVENTS;
 exports.WireFeaturesProvider = WireFeaturesProvider;
 exports.WireIcon = WireIcon;
 exports.WireOnboarding = WireOnboarding;
+exports.analyticsUserIdStorageKey = analyticsUserIdStorageKey;
 exports.attributionMetadata = attributionMetadata;
 exports.bumpActivationRevalidation = bumpActivationRevalidation;
 exports.clearPersistedSession = clearPersistedSession;
+exports.clearPiiFromContext = clearPiiFromContext;
+exports.clearUserContext = clearUserContext;
 exports.collectDeviceContext = collectDeviceContext;
 exports.createWireActivation = createWireActivation;
 exports.defaultIllustrations = defaultIllustrations;
@@ -4806,6 +4814,7 @@ exports.isFeaturesFresh = isFeaturesFresh;
 exports.isOnboardingEnabled = isOnboardingEnabled;
 exports.isWireScalar = isWireScalar;
 exports.loadPersistedSession = loadPersistedSession;
+exports.looksLikeEmail = looksLikeEmail;
 exports.lookupIconGlyph = lookupIconGlyph;
 exports.makeSessionId = makeSessionId;
 exports.mergeTheme = mergeTheme;