@wireai/activation 0.4.0 → 0.7.0

package/src/index.ts

@@ -117,11 +117,34 @@ export type { OnboardingAttribution } from "./attribution/attribution";
 // ─── Device context (privacy-label-neutral, dependency-free) ──────────────────
 export { collectDeviceContext } from "./device/deviceContext";
 export type { DeviceContext, DeviceFormFactor } from "./device/deviceContext";
+export { detectAppVersion } from "./device/appVersion";
 
 // ─── User identity (opaque pseudonymous id; late binding, dependency-free) ────
 export { identifyOnboarding, sanitizeUserId, USER_ID_MAX_LENGTH } from "./identity/userIdentity";
 export type { IdentifyOnboardingOptions } from "./identity/userIdentity";
 
+// ─── Rich user context (one object → every event's user_context; opt-in email PII) ────
+export {
+  resolveUserContext,
+  namespaceExtra,
+  hashEmailFnv1a,
+  isWireScalar,
+  RESERVED_USER_CONTEXT_KEYS,
+  EXTRA_KEY_PREFIX,
+} from "./context/userContext";
+export type {
+  WireUserContext,
+  ResolvedUserContext,
+  ResolveUserContextOptions,
+} from "./context/userContext";
+
+// ─── Current per-open session registry (identify/app-events reuse the live session) ───
+export {
+  getCurrentSessionId,
+  setCurrentSessionId,
+  resetCurrentSessionId,
+} from "./analytics/currentSession";
+
 // ─── Session mapping (one `app.session_started` per app-open → /v1/events) ─────
 export {
   reportSessionStart,

package/src/session-analytics/reportSessionStart.ts

@@ -31,6 +31,7 @@
  * awaits, and swallows a missing target / bad URL / missing fetch / network error. Analytics must
  * never be able to break the app.
  */
+import { setCurrentSessionId } from "../analytics/currentSession";
 import { makeSessionId, type ClientEvent, type ClientEventTarget } from "../analytics/reportClientEvent";
 import type { DeviceContext } from "../device/deviceContext";
 import { sanitizeUserId } from "../identity/userIdentity";
@@ -104,6 +105,12 @@ export const reportSessionStart = (opts: ReportSessionStartOptions): void => {
 
   const sessionId = opts.sessionId ?? makeSessionId();
 
+  // Register this open as the CURRENT per-open session so the analytics façade's `identify` /
+  // app-events reuse the id the server sees here (via `app.session_started`) instead of minting a
+  // fresh one it would back-fill into a phantom session. Idempotent; set before the once-guard so
+  // even a guard-deduped repeat keeps the current id pointing at this open.
+  setCurrentSessionId(sessionId);
+
   // Once-per-open guard: skip a repeat emit for a session id we already sent.
   if (opts.once !== false) {
     if (_emitted.has(sessionId)) return;

package/src/session-analytics/useLifecycleEvents.ts

@@ -119,7 +119,8 @@ export const useLifecycleEvents = (
       const { config: cfg, options: opts } = latest.current;
       if (opts.enabled !== false) {
         const device = collectDeviceContext();
-        if (cfg?.appVersion && !device.appVersion) device.appVersion = cfg.appVersion;
+        // `device.appVersion` is auto-detected best-effort; an explicit host version always wins.
+        if (cfg?.appVersion) device.appVersion = cfg.appVersion;
         reportFirstOpen({
           target: targetOf(cfg),
           sink: resolveSink(),
@@ -142,7 +143,8 @@ export const useLifecycleEvents = (
       if (opts.enabled === false) return;
       if (!cfg?.serverUrl && !opts.sink) return;
       const device = collectDeviceContext();
-      if (cfg?.appVersion && !device.appVersion) device.appVersion = cfg.appVersion;
+      // `device.appVersion` is auto-detected best-effort; an explicit host version always wins.
+      if (cfg?.appVersion) device.appVersion = cfg.appVersion;
       reportSessionStart({
         target: targetOf(cfg),
         sink: resolveSink(),

package/src/session-analytics/useSessionStart.ts

@@ -72,7 +72,8 @@ export const useSessionStart = (
       if (opts.enabled === false) return;
       const target: ClientEventTarget = { serverUrl: cfg.serverUrl, apiKey: cfg.apiKey ?? "" };
       const device = collectDeviceContext();
-      if (cfg.appVersion && !device.appVersion) device.appVersion = cfg.appVersion;
+      // `device.appVersion` is auto-detected best-effort; an explicit host version always wins.
+      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.

package/src/types.ts

@@ -24,11 +24,12 @@ export type WireOnboardingConfig = {
    */
   metadata?: Record<string, unknown>;
   /**
-   * Host app version string (e.g. "1.4.2"). HOST-INJECTED — the kit adds no dependency to
-   * read it; hosts typically pass it from `expo-constants`
-   * (`Constants.expoConfig?.version`). Forwarded to the backend on the session metadata and
-   * on client events (merged into the `device` snapshot as `device.appVersion`) so analytics
-   * can segment the funnel by app version. Optional; omit if unknown.
+   * Host app version string (e.g. "1.4.2"). OPTIONAL — when omitted, the kit makes a best-effort
+   * auto-detection from `expo-constants` (`Constants.expoConfig?.version` / `nativeAppVersion`) or
+   * `expo-application` (`nativeApplicationVersion`) WITHOUT adding a dependency (a host that lacks
+   * those modules just gets no version — see device/appVersion.ts). Pass this to override the
+   * auto-detected value (it always wins). Forwarded to the backend on the session metadata and on
+   * client events (as `device.appVersion`) so analytics can segment the funnel by app version.
    */
   appVersion?: string;
 };