ad2app-lib 1.34.0 → 1.35.0

package/dist/analytics/index.d.ts

@@ -48,6 +48,7 @@ export declare const EVENTS: {
     readonly PAYWALL_DISMISSED: "paywall_dismissed";
     readonly ACCESS_DENIED: "access_denied";
     readonly ONBOARDING_STEP_COMPLETED: "onboarding_step_completed";
+    readonly ONBOARDING_STEP_VIEWED: "onboarding_step_viewed";
     readonly EXIT_INTENT_SHOWN: "exit_intent_shown";
     readonly EXIT_INTENT_DISMISSED: "exit_intent_dismissed";
     readonly EXIT_INTENT_CAPTURED: "exit_intent_captured";
@@ -346,11 +347,16 @@ export interface EventProperties {
         app_locale: AppLocale;
     };
     [EVENTS.ONBOARDING_STEP_COMPLETED]: {
-        flow: 'complete_profile';
+        flow: 'complete_profile' | 'beta_consent';
         step: string;
         step_index: number;
         app_locale: AppLocale;
     };
+    [EVENTS.ONBOARDING_STEP_VIEWED]: {
+        flow: 'complete_profile' | 'beta_consent';
+        step: string;
+        app_locale?: AppLocale;
+    };
     [EVENTS.EXIT_INTENT_SHOWN]: {
         surface: 'connect_wall';
         dwell_ms?: number;

package/dist/analytics/index.js

@@ -72,6 +72,12 @@ exports.EVENTS = {
     // trust — it is part of why a REAL retry defect sat unnoticed in the same list.
     ACCESS_DENIED: 'access_denied', // entitlement 403 at the API choke point (beta wall / subscription)
     ONBOARDING_STEP_COMPLETED: 'onboarding_step_completed', // one step of a multi-step flow (complete-profile)
+    // Promoted from a raw string literal at ad2app-frontend's
+    // OnboardingFlow.tsx:887 (spec 158, 2026-09-03) — it was already firing in
+    // production (15 events, 3 people) ungoverned since spec 095. `flow` is
+    // widened alongside ONBOARDING_STEP_COMPLETED below to cover the beta
+    // consent step, which is not part of the complete-profile flow.
+    ONBOARDING_STEP_VIEWED: 'onboarding_step_viewed', // a step was actually shown (drop-off, not just completion)
     EXIT_INTENT_SHOWN: 'exit_intent_shown', // exit-intent capture modal armed (065, verbatim wire values)
     EXIT_INTENT_DISMISSED: 'exit_intent_dismissed',
     EXIT_INTENT_CAPTURED: 'exit_intent_captured', // email captured into the beta list

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ad2app-lib",
-  "version": "1.34.0",
+  "version": "1.35.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "commonjs",

package/src/analytics/index.test.ts

@@ -105,6 +105,7 @@ const EVENT_PROPERTY_WITNESS: { [E in keyof EventProperties]: EventProperties[E]
   [EVENTS.PAYWALL_DISMISSED]: { surface: "upgrade_modal", trigger: "user_click", hit_number: 1, app_locale: "en" },
   [EVENTS.ACCESS_DENIED]: { reason: "subscription-required", app_locale: "en" },
   [EVENTS.ONBOARDING_STEP_COMPLETED]: { flow: "complete_profile", step: "role", step_index: 1, app_locale: "en" },
+  [EVENTS.ONBOARDING_STEP_VIEWED]: { flow: "beta_consent", step: "consent" },
   [EVENTS.EXIT_INTENT_SHOWN]: { surface: "connect_wall" },
   [EVENTS.EXIT_INTENT_DISMISSED]: { surface: "connect_wall" },
   [EVENTS.EXIT_INTENT_CAPTURED]: { surface: "connect_wall" },
@@ -186,6 +187,10 @@ test("080 paywall / onboarding wire names are locked (rename breaks the baseline
   assert.equal(EVENTS.ONBOARDING_STEP_COMPLETED, "onboarding_step_completed");
 });
 
+test("158: onboarding_step_viewed wire name is locked — it was already live in production as a raw string before this promotion (rename breaks the existing 15 events)", () => {
+  assert.equal(EVENTS.ONBOARDING_STEP_VIEWED, "onboarding_step_viewed");
+});
+
 test("080 subscription-lifecycle wire names are locked (backend = source of truth)", () => {
   assert.deepEqual(
     [

package/src/analytics/index.ts

@@ -78,6 +78,12 @@ export const EVENTS = {
   // trust — it is part of why a REAL retry defect sat unnoticed in the same list.
   ACCESS_DENIED: 'access_denied', // entitlement 403 at the API choke point (beta wall / subscription)
   ONBOARDING_STEP_COMPLETED: 'onboarding_step_completed', // one step of a multi-step flow (complete-profile)
+  // Promoted from a raw string literal at ad2app-frontend's
+  // OnboardingFlow.tsx:887 (spec 158, 2026-09-03) — it was already firing in
+  // production (15 events, 3 people) ungoverned since spec 095. `flow` is
+  // widened alongside ONBOARDING_STEP_COMPLETED below to cover the beta
+  // consent step, which is not part of the complete-profile flow.
+  ONBOARDING_STEP_VIEWED: 'onboarding_step_viewed', // a step was actually shown (drop-off, not just completion)
   EXIT_INTENT_SHOWN: 'exit_intent_shown', // exit-intent capture modal armed (065, verbatim wire values)
   EXIT_INTENT_DISMISSED: 'exit_intent_dismissed',
   EXIT_INTENT_CAPTURED: 'exit_intent_captured', // email captured into the beta list
@@ -436,11 +442,19 @@ export interface EventProperties {
     app_locale: AppLocale;
   };
   [EVENTS.ONBOARDING_STEP_COMPLETED]: {
-    flow: 'complete_profile'; // closed set, extensible when a new flow ships
+    flow: 'complete_profile' | 'beta_consent'; // widened 2026-09-03 (spec 158) for the beta consent step
     step: string; // stable slug derived from the real wizard, not guessed
     step_index: number; // 1-based
     app_locale: AppLocale;
   };
+  // Promoted from a raw string (spec 158) — same `flow`/`step` shape as
+  // ONBOARDING_STEP_COMPLETED, fired once per step actually SHOWN rather than
+  // finished, so drop-off is visible per step, not only per completion.
+  [EVENTS.ONBOARDING_STEP_VIEWED]: {
+    flow: 'complete_profile' | 'beta_consent';
+    step: string;
+    app_locale?: AppLocale; // optional: the pre-existing raw call site does not have it yet (T001a repairs the call site, not the type's honesty about what ships today)
+  };
   // Exit-intent (065). surface value is VERBATIM from the ExitIntentModal
   // component ('connect_wall'); dwell_ms / page_views / app_locale are optional
   // additions T003 wires (the component does not emit them yet — fidelity gate).