@wireai/activation 0.3.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/questionnaire/QuestionnaireGate.tsx

@@ -43,7 +43,7 @@ const mergeThemeOver = (
 
 type Phase = "form" | "thanks";
 
-export const QuestionnaireGate: React.FC<QuestionnaireGateProps> = ({
+const _QuestionnaireGate: React.FC<QuestionnaireGateProps> = ({
   questionnaire,
   target,
   sessionId,
@@ -81,6 +81,14 @@ export const QuestionnaireGate: React.FC<QuestionnaireGateProps> = ({
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, []);
 
+  const resolveTimer = React.useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  React.useEffect(() => {
+    return () => {
+      if (resolveTimer.current) clearTimeout(resolveTimer.current);
+    };
+  }, []);
+
   const resolve = useCallback(() => {
     onResolved?.();
   }, [onResolved]);
@@ -100,8 +108,11 @@ export const QuestionnaireGate: React.FC<QuestionnaireGateProps> = ({
     submitQuestionnaireResponse(target, id, submission);
     onEvent?.({ name: "questionnaire_submitted", id });
     setPhase("thanks");
-    resolve();
-  }, [canSend, opinion, improve, suggestions, sessionId, meta, target, id, onEvent, resolve]);
+    if (resolveTimer.current) clearTimeout(resolveTimer.current);
+    resolveTimer.current = setTimeout(() => {
+      modalRef.current?.close();
+    }, 1500);
+  }, [canSend, opinion, improve, suggestions, sessionId, meta, target, id, onEvent]);
 
   // The in-card "Not now"/"Skip" link plays the popup's exit animation (which resolves on
   // completion, the same path a backdrop tap takes). Emit the dismissed moment first.
@@ -225,6 +236,7 @@ export const QuestionnaireGate: React.FC<QuestionnaireGateProps> = ({
   );
 };
 
+export const QuestionnaireGate = React.memo(_QuestionnaireGate);
 QuestionnaireGate.displayName = "QuestionnaireGate";
 
 const styles = StyleSheet.create({

package/src/reviews/ReviewGate.tsx

@@ -52,7 +52,7 @@ const mergeThemeOver = (
 
 type Phase = "rating" | "feedback" | "thanks";
 
-export const ReviewGate: React.FC<ReviewGateProps> = ({
+const _ReviewGate: React.FC<ReviewGateProps> = ({
   appName,
   store,
   target,
@@ -94,10 +94,29 @@ export const ReviewGate: React.FC<ReviewGateProps> = ({
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, []);
 
+  const resolveTimer = React.useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  React.useEffect(() => {
+    return () => {
+      if (resolveTimer.current) clearTimeout(resolveTimer.current);
+    };
+  }, []);
+
   const resolve = useCallback(() => {
     onResolved?.();
   }, [onResolved]);
 
+  const resolveWithDelay = useCallback(() => {
+    if (resolveTimer.current) clearTimeout(resolveTimer.current);
+    resolveTimer.current = setTimeout(() => {
+      if (mode === "modal") {
+        modalRef.current?.close();
+      } else {
+        onResolved?.();
+      }
+    }, 1500);
+  }, [mode, onResolved]);
+
   const pickRating = useCallback(
     async (value: number) => {
       setStars(value);
@@ -106,12 +125,12 @@ export const ReviewGate: React.FC<ReviewGateProps> = ({
         onEvent?.({ name: "store_review_requested", id, stars: value });
         await requestStoreReview(store);
         setPhase("thanks");
-        resolve();
+        resolveWithDelay();
       } else {
         setPhase("feedback");
       }
     },
-    [onEvent, id, store, resolve],
+    [onEvent, id, store, resolveWithDelay],
   );
 
   const sendFeedback = useCallback(() => {
@@ -127,13 +146,13 @@ export const ReviewGate: React.FC<ReviewGateProps> = ({
     submitReview(target, body);
     onEvent?.({ name: "review_feedback_submitted", id, stars });
     setPhase("thanks");
-    resolve();
-  }, [stars, feedback, suggestion, sessionId, meta, target, onEvent, id, resolve]);
+    resolveWithDelay();
+  }, [stars, feedback, suggestion, sessionId, meta, target, onEvent, id, resolveWithDelay]);
 
   const dismiss = useCallback(() => {
     setPhase("thanks");
-    resolve();
-  }, [resolve]);
+    resolveWithDelay();
+  }, [resolveWithDelay]);
 
   // The in-card "Not now"/"Skip" link. In modal mode it plays the popup's exit animation
   // (which resolves on completion, the same path a backdrop tap takes); inline keeps the
@@ -303,6 +322,7 @@ export const ReviewGate: React.FC<ReviewGateProps> = ({
   return <View style={[styles.card, surface]}>{content}</View>;
 };
 
+export const ReviewGate = React.memo(_ReviewGate);
 ReviewGate.displayName = "ReviewGate";
 
 const styles = StyleSheet.create({

package/src/reviews/ReviewModal.tsx

@@ -5,6 +5,10 @@
  * questionnaire module can reuse the same shell without importing reviews/. This file keeps the
  * reviews public API (`ReviewModal`, `ReviewModalHandle`, `ReviewModalProps`) pointing at the
  * exact same runtime object, so the reviews canary and every existing import stay valid.
+ *
+ * The exported shell is already `React.memo`-wrapped at its source (`components/CenteredModal.tsx`
+ * wraps `_CenteredModal` in `React.memo`), so `ReviewModal` satisfies the shell-memoization rule
+ * without a second wrapper here. Re-wrapping would change the runtime identity the canary asserts.
  */
 export { CenteredModal as ReviewModal, default } from "../components/CenteredModal";
 export type {

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/showcase/FeatureShowcase.tsx

@@ -48,7 +48,7 @@ const mergeThemeOver = (
  * When the gate says "seen", it renders nothing and calls `onDone` from an
  * effect (never during render).
  */
-export const FeatureShowcase: React.FC<FeatureShowcaseProps> = ({
+const _FeatureShowcase: React.FC<FeatureShowcaseProps> = ({
   config,
   onDone,
   theme: themeOverride,
@@ -211,6 +211,7 @@ export const FeatureShowcase: React.FC<FeatureShowcaseProps> = ({
   );
 };
 
+export const FeatureShowcase = React.memo(_FeatureShowcase);
 FeatureShowcase.displayName = "FeatureShowcase";
 
 const styles = StyleSheet.create({

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;
 };

package/src/components/loaderChrome.ts

@@ -1,28 +0,0 @@
-/**
- * loaderChrome — the seam that lets a loader center in the FULL flow area instead of
- * the header-offset body it happens to render into.
- *
- * The between-turns loader lives inside the OnboardingScaffold body (so the card↔loader
- * handoff stays one coordinated CardHandoff — see OnboardingFlow). But the body sits
- * BELOW the header (the StepProgress bar), so a loader that only fills the body centers
- * a little low — the "not centralized in the screen" device finding. The scaffold knows
- * its own top chrome, so it publishes a vertical offset here; LoadingBlock reads it and
- * shifts its centered content up by that much, landing it at the true screen center
- * WITHOUT moving the body (the card underneath is untouched, so the handoff never jumps).
- *
- * Default 0: a LoadingBlock rendered OUTSIDE a scaffold (the standalone LoadingScreen used
- * for cold-start / restoring / error) has no header above it, so it already centers in the
- * full area and needs no shift.
- */
-import { createContext, useContext } from "react";
-
-export type LoaderChrome = {
-  /** Vertical shift (px, usually negative = up) that re-centers a loader against the full flow area. */
-  offsetY: number;
-};
-
-const LoaderChromeContext = createContext<LoaderChrome>({ offsetY: 0 });
-
-export const LoaderChromeProvider = LoaderChromeContext.Provider;
-
-export const useLoaderChrome = (): LoaderChrome => useContext(LoaderChromeContext);