ad2app-lib 1.37.0 → 1.38.0

package/dist/analytics/index.d.ts

@@ -32,6 +32,7 @@ export declare const EVENTS: {
     readonly PROFILE_COMPLETED: "profile_completed";
     readonly LOGGED_IN: "logged_in";
     readonly SOCIAL_ACCOUNT_CONNECTED: "social_account_connected";
+    readonly SOCIAL_SIGN_IN_FAILED: "social_sign_in_failed";
     readonly COMPOSE_STARTED: "compose_started";
     readonly COMPOSE_STEP_VIEWED: "compose_step_viewed";
     readonly COMPOSE_BLOCKED: "compose_blocked";
@@ -44,6 +45,9 @@ export declare const EVENTS: {
     readonly CHECKOUT_STARTED: "checkout_started";
     readonly SUBSCRIPTION_STARTED: "subscription_started";
     readonly SUBSCRIPTION_CANCELED: "subscription_canceled";
+    readonly BILLING_PORTAL_OPENED: "billing_portal_opened";
+    readonly SUBSCRIPTION_REACTIVATED: "subscription_reactivated";
+    readonly CHECKOUT_CONFIRMATION_TIMED_OUT: "checkout_confirmation_timed_out";
     readonly PAYWALL_SHOWN: "paywall_shown";
     readonly PAYWALL_DISMISSED: "paywall_dismissed";
     readonly ACCESS_DENIED: "access_denied";
@@ -75,6 +79,12 @@ export declare const EVENTS: {
     readonly POST_RESCHEDULED: "post_rescheduled";
     readonly ACCOUNT_DISCONNECTED: "account_disconnected";
     readonly NOTIFICATION_PREFERENCES_UPDATED: "notification_preferences_updated";
+    readonly THEME_CHANGED: "theme_changed";
+    readonly FEEDBACK_SUBMITTED: "feedback_submitted";
+    readonly ACCOUNT_DELETED: "account_deleted";
+    readonly LANGUAGE_CHANGED: "language_changed";
+    readonly COMMENT_GUARD_MODE_CHANGED: "comment_guard_mode_changed";
+    readonly AI_TOOLS_REVOKE_REQUESTED: "ai_tools_revoke_requested";
     readonly NATIVE_SESSION_LAUNCHED: "native_session_launched";
     readonly NATIVE_SESSION_RENEWED: "native_session_renewed";
     readonly NATIVE_SESSION_ENDED: "native_session_ended";
@@ -165,7 +175,7 @@ export type ComposeStep = 'platforms' | 'content' | 'details' | 'review';
  * content, so neither may ride the event: only the class does. Same contract as
  * PublishFailureReason. Do NOT rename after shipping — wire values.
  */
-export type ComposeBlockReason = 'empty' | 'missing_fields' | 'over_limit' | 'media' | 'channel_blocked' | 'poll';
+export type ComposeBlockReason = 'empty' | 'missing_fields' | 'over_limit' | 'media' | 'channel_blocked' | 'poll' | 'unconnected_platform';
 /**
  * Why a connect attempt ended without a connected account (spec 155 US3).
  *
@@ -196,9 +206,11 @@ export type ComposeBlockReason = 'empty' | 'missing_fields' | 'over_limit' | 'me
 export type OnboardingCompletedAt = 'connect' | 'install' | 'schedule';
 /** The finish lines, in the order the flow can reach them. */
 export declare const ONBOARDING_COMPLETED_AT: readonly ["connect", "install", "schedule"];
-export type ConnectBlockReason = 'paywall' | 'canceled' | 'failed' | 'returned_without_account' | 'personal_profile';
+export type ConnectBlockReason = 'paywall' | 'canceled' | 'failed' | 'returned_without_account' | 'personal_profile' | 'api_failed' | 'timeout' | 'exception';
 /** The reason set, in the order the spec lists it. Iterable for contract tests and dashboards. */
-export declare const CONNECT_BLOCK_REASONS: readonly ["paywall", "canceled", "failed", "returned_without_account", "personal_profile"];
+export declare const CONNECT_BLOCK_REASONS: readonly ["paywall", "canceled", "failed", "returned_without_account", "personal_profile", "api_failed", "timeout", "exception"];
+export type SignInFailureReason = 'canceled' | 'missing_code' | 'invalid_provider' | 'no_email' | 'api_failed' | 'exception';
+export declare const SIGN_IN_FAILURE_REASONS: readonly ["canceled", "missing_code", "invalid_provider", "no_email", "api_failed", "exception"];
 export type PublishFailureReason = 'auth' | 'rate_limit' | 'media' | 'content' | 'network' | 'platform' | 'unknown';
 /** Property shape per event. Keeps emitters honest across repos. */
 export interface EventProperties {
@@ -261,6 +273,10 @@ export interface EventProperties {
         account_count?: number;
         connection_ordinal?: number;
     };
+    [EVENTS.SOCIAL_SIGN_IN_FAILED]: {
+        platform?: string;
+        reason: SignInFailureReason;
+    };
     [EVENTS.COMPOSE_STARTED]: {
         source?: 'wizard' | 'quick';
     };
@@ -324,6 +340,15 @@ export interface EventProperties {
         plan: string;
         reason?: string;
     };
+    [EVENTS.BILLING_PORTAL_OPENED]: {
+        plan: string;
+    };
+    [EVENTS.SUBSCRIPTION_REACTIVATED]: {
+        plan: string;
+    };
+    [EVENTS.CHECKOUT_CONFIRMATION_TIMED_OUT]: {
+        had_session_id: boolean;
+    };
     [EVENTS.PAYWALL_SHOWN]: {
         surface: 'upgrade_modal' | 'pricing_page';
         trigger: 'user_click' | 'limit_reached' | 'connect_wall';
@@ -475,6 +500,22 @@ export interface EventProperties {
         enabled?: boolean;
         success: boolean;
     };
+    [EVENTS.THEME_CHANGED]: {
+        mode: 'light' | 'dark';
+    };
+    [EVENTS.FEEDBACK_SUBMITTED]: {
+        has_screenshot: boolean;
+    };
+    [EVENTS.ACCOUNT_DELETED]: {
+        tier: string;
+    };
+    [EVENTS.LANGUAGE_CHANGED]: {
+        language: 'en' | 'pl';
+    };
+    [EVENTS.COMMENT_GUARD_MODE_CHANGED]: {
+        mode: 'off' | 'flag-only' | 'auto-ignore';
+    };
+    [EVENTS.AI_TOOLS_REVOKE_REQUESTED]: Record<string, never>;
     [EVENTS.NATIVE_SESSION_LAUNCHED]: {
         outcome: 'restored' | 'none' | 'degraded';
     };

package/dist/analytics/index.js

@@ -10,7 +10,7 @@
  * Do NOT rename events after they ship — historical data does not migrate.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LAUNCH_CONTEXT_PROPS = exports.PERSON_PROPS = exports.CONNECT_BLOCK_REASONS = exports.ONBOARDING_COMPLETED_AT = exports.EMAIL_PROPS = exports.EVENTS = void 0;
+exports.LAUNCH_CONTEXT_PROPS = exports.PERSON_PROPS = exports.SIGN_IN_FAILURE_REASONS = exports.CONNECT_BLOCK_REASONS = exports.ONBOARDING_COMPLETED_AT = exports.EMAIL_PROPS = exports.EVENTS = void 0;
 /** Canonical PostHog event names. */
 exports.EVENTS = {
     // Acquisition (landing)
@@ -42,6 +42,12 @@ exports.EVENTS = {
     PROFILE_COMPLETED: 'profile_completed', // the /complete-profile step (influencers)
     LOGGED_IN: 'logged_in',
     SOCIAL_ACCOUNT_CONNECTED: 'social_account_connected',
+    // 164 G007: OAuthCallbackPage's sign-in branch (state !== 'web-connect')
+    // had zero tracking on any of its 5 failure outcomes -- LOGGED_IN only
+    // ever fires on success (PostHogIdentify.tsx, centrally, off the redux
+    // authed state), so failures need their own event rather than an
+    // overloaded success/failure LOGGED_IN.
+    SOCIAL_SIGN_IN_FAILED: 'social_sign_in_failed',
     COMPOSE_STARTED: 'compose_started',
     // AD2-1371: the composer was a black box between COMPOSE_STARTED and
     // POST_SCHEDULED. Measured 2026-08-28: of seven users who connected an
@@ -61,6 +67,17 @@ exports.EVENTS = {
     CHECKOUT_STARTED: 'checkout_started',
     SUBSCRIPTION_STARTED: 'subscription_started',
     SUBSCRIPTION_CANCELED: 'subscription_canceled',
+    // 164 G009 (SubscriptionSection had zero tracking on either action): client
+    // intent only — CANCEL_INITIATED above is already backend/webhook-owned
+    // (fires off the real `cancel_at_period_end` transition), so cancel itself
+    // is deliberately NOT duplicated here.
+    BILLING_PORTAL_OPENED: 'billing_portal_opened',
+    SUBSCRIPTION_REACTIVATED: 'subscription_reactivated',
+    // 164 (ComposePage -> PaymentProcessingPage): the client gave up polling for
+    // Stripe/webhook confirmation. Distinct from the backend-owned PAYMENT_FAILED
+    // (a real decline) -- this only means "we could not confirm in time", which
+    // may still resolve moments later.
+    CHECKOUT_CONFIRMATION_TIMED_OUT: 'checkout_confirmation_timed_out',
     // Measurement baseline (080) — paywall / onboarding / exit-intent (frontend-owned)
     PAYWALL_SHOWN: 'paywall_shown', // any monetization surface is shown (upgrade modal / pricing page)
     PAYWALL_DISMISSED: 'paywall_dismissed', // closed without converting
@@ -110,6 +127,19 @@ exports.EVENTS = {
     ACCOUNT_DISCONNECTED: 'account_disconnected',
     // Settings.
     NOTIFICATION_PREFERENCES_UPDATED: 'notification_preferences_updated',
+    // 164 G009: SettingsPage had `track`/`EVENTS` imported but never called --
+    // theme, feedback, and account-deletion all fired nothing. NOTIFICATION_PREFERENCES_UPDATED
+    // above already covers the marketing-emails toggle (its declared `{preference, enabled,
+    // success}` shape fits exactly; reused rather than adding a parallel event).
+    THEME_CHANGED: 'theme_changed',
+    FEEDBACK_SUBMITTED: 'feedback_submitted',
+    ACCOUNT_DELETED: 'account_deleted',
+    // Shared LanguageSwitcher (SignIn/SignUp/Settings) had the same zero-tracking gap.
+    LANGUAGE_CHANGED: 'language_changed',
+    // Behind SHOW_COMMENT_GUARD_SECTION / SHOW_AI_TOOLS_SECTION (both default OFF) —
+    // no real user can reach either today, but fixed for completeness/G009.
+    COMMENT_GUARD_MODE_CHANGED: 'comment_guard_mode_changed',
+    AI_TOOLS_REVOKE_REQUESTED: 'ai_tools_revoke_requested',
     // Native session lifecycle (159) — the iOS wrapper's Keychain-backed session,
     // reported so "does it survive" is a query instead of an inference from login
     // counts. Native only; the web session's posture is unchanged (contract Rule 5).
@@ -151,6 +181,17 @@ exports.CONNECT_BLOCK_REASONS = [
     'failed',
     'returned_without_account',
     'personal_profile',
+    'api_failed',
+    'timeout',
+    'exception',
+];
+exports.SIGN_IN_FAILURE_REASONS = [
+    'canceled',
+    'missing_code',
+    'invalid_provider',
+    'no_email',
+    'api_failed',
+    'exception',
 ];
 /** Canonical person property keys (set via identify / $set). */
 exports.PERSON_PROPS = {

package/package.json

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

package/src/analytics/account-connect-blocked.test.ts

@@ -13,13 +13,19 @@ import { test } from 'node:test';
 import { CONNECT_BLOCK_REASONS, EVENTS } from './index';
 import type { ConnectBlockReason, EventProperties } from './index';
 
-test('the reason set is the five causes, as wire values', () => {
+test('the reason set is the eight causes, as wire values', () => {
+	// 164 G001: widened from five to eight — 'api_failed'/'timeout'/'exception'
+	// cover connectAccount() itself failing before any redirect ever happens
+	// (confirmed live 2026-09-07 as the one previously-untracked branch).
 	assert.deepEqual([...CONNECT_BLOCK_REASONS], [
 		'paywall',
 		'canceled',
 		'failed',
 		'returned_without_account',
 		'personal_profile',
+		'api_failed',
+		'timeout',
+		'exception',
 	]);
 });
 

package/src/analytics/index.test.ts

@@ -90,6 +90,8 @@ const EVENT_PROPERTY_WITNESS: { [E in keyof EventProperties]: EventProperties[E]
   // 'email' | 'google' union (compile-time, enforced by `tsc --noEmit`).
   [EVENTS.LOGGED_IN]: { method: "apple" },
   [EVENTS.SOCIAL_ACCOUNT_CONNECTED]: { platform: "instagram" },
+  // 164 G007
+  [EVENTS.SOCIAL_SIGN_IN_FAILED]: { platform: "facebook", reason: "canceled" },
   [EVENTS.COMPOSE_STARTED]: {},
   [EVENTS.COMPOSE_STEP_VIEWED]: { step: "content" },
   [EVENTS.COMPOSE_BLOCKED]: { step: "content", reasons: ["missing_fields"], reason_count: 1 },
@@ -102,6 +104,11 @@ const EVENT_PROPERTY_WITNESS: { [E in keyof EventProperties]: EventProperties[E]
   [EVENTS.CHECKOUT_STARTED]: { plan: "starter" },
   [EVENTS.SUBSCRIPTION_STARTED]: { plan: "starter" },
   [EVENTS.SUBSCRIPTION_CANCELED]: { plan: "starter" },
+  // 164 G011
+  [EVENTS.BILLING_PORTAL_OPENED]: { plan: "pro" },
+  [EVENTS.SUBSCRIPTION_REACTIVATED]: { plan: "pro" },
+  // 164 (PaymentProcessingPage)
+  [EVENTS.CHECKOUT_CONFIRMATION_TIMED_OUT]: { had_session_id: true },
   // 080 measurement baseline
   [EVENTS.PAYWALL_SHOWN]: { surface: "upgrade_modal", trigger: "user_click", hit_number: 1, app_locale: "en" },
   [EVENTS.PAYWALL_DISMISSED]: { surface: "upgrade_modal", trigger: "user_click", hit_number: 1, app_locale: "en" },
@@ -139,6 +146,14 @@ const EVENT_PROPERTY_WITNESS: { [E in keyof EventProperties]: EventProperties[E]
   [EVENTS.NATIVE_SESSION_LAUNCHED]: { outcome: "restored" },
   [EVENTS.NATIVE_SESSION_RENEWED]: {},
   [EVENTS.NATIVE_SESSION_ENDED]: { cause: "rejected" },
+  // 164 G009 — SettingsPage had track/EVENTS imported but never called
+  [EVENTS.THEME_CHANGED]: { mode: "dark" },
+  [EVENTS.FEEDBACK_SUBMITTED]: { has_screenshot: false },
+  [EVENTS.ACCOUNT_DELETED]: { tier: "pro" },
+  [EVENTS.LANGUAGE_CHANGED]: { language: "pl" },
+  // 164 G012 — both behind default-OFF flags, fixed for completeness
+  [EVENTS.COMMENT_GUARD_MODE_CHANGED]: { mode: "flag-only" },
+  [EVENTS.AI_TOOLS_REVOKE_REQUESTED]: {},
 };
 
 test("EVENTS values are 1:1 with EventProperties keys (no missing or typo'd event)", () => {

package/src/analytics/index.ts

@@ -46,6 +46,12 @@ export const EVENTS = {
   PROFILE_COMPLETED: 'profile_completed', // the /complete-profile step (influencers)
   LOGGED_IN: 'logged_in',
   SOCIAL_ACCOUNT_CONNECTED: 'social_account_connected',
+  // 164 G007: OAuthCallbackPage's sign-in branch (state !== 'web-connect')
+  // had zero tracking on any of its 5 failure outcomes -- LOGGED_IN only
+  // ever fires on success (PostHogIdentify.tsx, centrally, off the redux
+  // authed state), so failures need their own event rather than an
+  // overloaded success/failure LOGGED_IN.
+  SOCIAL_SIGN_IN_FAILED: 'social_sign_in_failed',
   COMPOSE_STARTED: 'compose_started',
   // AD2-1371: the composer was a black box between COMPOSE_STARTED and
   // POST_SCHEDULED. Measured 2026-08-28: of seven users who connected an
@@ -66,6 +72,17 @@ export const EVENTS = {
   CHECKOUT_STARTED: 'checkout_started',
   SUBSCRIPTION_STARTED: 'subscription_started',
   SUBSCRIPTION_CANCELED: 'subscription_canceled',
+  // 164 G009 (SubscriptionSection had zero tracking on either action): client
+  // intent only — CANCEL_INITIATED above is already backend/webhook-owned
+  // (fires off the real `cancel_at_period_end` transition), so cancel itself
+  // is deliberately NOT duplicated here.
+  BILLING_PORTAL_OPENED: 'billing_portal_opened',
+  SUBSCRIPTION_REACTIVATED: 'subscription_reactivated',
+  // 164 (ComposePage -> PaymentProcessingPage): the client gave up polling for
+  // Stripe/webhook confirmation. Distinct from the backend-owned PAYMENT_FAILED
+  // (a real decline) -- this only means "we could not confirm in time", which
+  // may still resolve moments later.
+  CHECKOUT_CONFIRMATION_TIMED_OUT: 'checkout_confirmation_timed_out',
 
   // Measurement baseline (080) — paywall / onboarding / exit-intent (frontend-owned)
   PAYWALL_SHOWN: 'paywall_shown', // any monetization surface is shown (upgrade modal / pricing page)
@@ -121,6 +138,19 @@ export const EVENTS = {
 
   // Settings.
   NOTIFICATION_PREFERENCES_UPDATED: 'notification_preferences_updated',
+  // 164 G009: SettingsPage had `track`/`EVENTS` imported but never called --
+  // theme, feedback, and account-deletion all fired nothing. NOTIFICATION_PREFERENCES_UPDATED
+  // above already covers the marketing-emails toggle (its declared `{preference, enabled,
+  // success}` shape fits exactly; reused rather than adding a parallel event).
+  THEME_CHANGED: 'theme_changed',
+  FEEDBACK_SUBMITTED: 'feedback_submitted',
+  ACCOUNT_DELETED: 'account_deleted',
+  // Shared LanguageSwitcher (SignIn/SignUp/Settings) had the same zero-tracking gap.
+  LANGUAGE_CHANGED: 'language_changed',
+  // Behind SHOW_COMMENT_GUARD_SECTION / SHOW_AI_TOOLS_SECTION (both default OFF) —
+  // no real user can reach either today, but fixed for completeness/G009.
+  COMMENT_GUARD_MODE_CHANGED: 'comment_guard_mode_changed',
+  AI_TOOLS_REVOKE_REQUESTED: 'ai_tools_revoke_requested',
 
   // Native session lifecycle (159) — the iOS wrapper's Keychain-backed session,
   // reported so "does it survive" is a query instead of an inference from login
@@ -242,7 +272,12 @@ export type ComposeBlockReason =
   | 'over_limit' // caption longer than a selected platform allows
   | 'media' // media rejected (format, size, duration, count)
   | 'channel_blocked' // the channel itself refused (e.g. a failed prerequisite read)
-  | 'poll'; // an incomplete or unpostable poll
+  | 'poll' // an incomplete or unpostable poll
+  // 164 G002: picking an unconnected platform at step 1 (Platforms) redirects
+  // straight to /accounts with zero analytics -- same "composer refused to
+  // let you proceed" shape as the publish-readiness reasons above, just one
+  // step earlier, so it reuses this event/reason set rather than a new event.
+  | 'unconnected_platform';
 
 /**
  * Why a connect attempt ended without a connected account (spec 155 US3).
@@ -285,7 +320,14 @@ export type ConnectBlockReason =
   | 'canceled'
   | 'failed'
   | 'returned_without_account'
-  | 'personal_profile';
+  | 'personal_profile'
+  // 164 G001: 'failed' above is the POST-redirect case (backend appends
+  // ?connect=failed once the provider has already handed control back).
+  // These three cover the connectAccount() API call itself never getting a
+  // redirect at all — confirmed live 2026-09-07 as the one untracked branch.
+  | 'api_failed'
+  | 'timeout'
+  | 'exception';
 
 /** The reason set, in the order the spec lists it. Iterable for contract tests and dashboards. */
 export const CONNECT_BLOCK_REASONS = [
@@ -294,8 +336,31 @@ export const CONNECT_BLOCK_REASONS = [
   'failed',
   'returned_without_account',
   'personal_profile',
+  'api_failed',
+  'timeout',
+  'exception',
 ] as const satisfies readonly ConnectBlockReason[];
 
+// 164 G007: covers OAuthCallbackPage's social sign-in branch (as opposed to
+// ConnectBlockReason, which covers its account-connect branch) -- distinct
+// enums because the two flows fail for different reasons.
+export type SignInFailureReason =
+  | 'canceled' // provider returned ?error= (user denied / backed out)
+  | 'missing_code' // callback landed with no ?code= at all
+  | 'invalid_provider' // :provider route param missing/unrecognized
+  | 'no_email' // provider granted no email (Facebook/TikTok phone-only) -- AD2-1252
+  | 'api_failed' // socialSignIn() resolved without an accessToken
+  | 'exception'; // socialSignIn() itself threw
+
+export const SIGN_IN_FAILURE_REASONS = [
+  'canceled',
+  'missing_code',
+  'invalid_provider',
+  'no_email',
+  'api_failed',
+  'exception',
+] as const satisfies readonly SignInFailureReason[];
+
 export type PublishFailureReason =
   | 'auth' // token expired / revoked / missing scope / permission denied
   | 'rate_limit' // provider throttled us (429 / quota)
@@ -352,6 +417,7 @@ export interface EventProperties {
     // 080: 1 = first-ever account, 2 = second… — the "second action" activation hook.
     connection_ordinal?: number;
   };
+  [EVENTS.SOCIAL_SIGN_IN_FAILED]: { platform?: string; reason: SignInFailureReason };
   [EVENTS.COMPOSE_STARTED]: { source?: 'wizard' | 'quick' };
   [EVENTS.COMPOSE_STEP_VIEWED]: { step: ComposeStep };
   [EVENTS.COMPOSE_BLOCKED]: {
@@ -419,6 +485,9 @@ export interface EventProperties {
     trigger_source?: TriggerSource; // 080
   };
   [EVENTS.SUBSCRIPTION_CANCELED]: { plan: string; reason?: string };
+  [EVENTS.BILLING_PORTAL_OPENED]: { plan: string };
+  [EVENTS.SUBSCRIPTION_REACTIVATED]: { plan: string };
+  [EVENTS.CHECKOUT_CONFIRMATION_TIMED_OUT]: { had_session_id: boolean };
 
   // ── Measurement baseline (080) — new event property shapes ──────────────────
   // Paywall surfaces (frontend). hit_number is the analytical truth (an event
@@ -511,6 +580,12 @@ export interface EventProperties {
 
   // Settings — which preference toggled and its new state.
   [EVENTS.NOTIFICATION_PREFERENCES_UPDATED]: { preference?: string; enabled?: boolean; success: boolean };
+  [EVENTS.THEME_CHANGED]: { mode: 'light' | 'dark' };
+  [EVENTS.FEEDBACK_SUBMITTED]: { has_screenshot: boolean };
+  [EVENTS.ACCOUNT_DELETED]: { tier: string };
+  [EVENTS.LANGUAGE_CHANGED]: { language: 'en' | 'pl' };
+  [EVENTS.COMMENT_GUARD_MODE_CHANGED]: { mode: 'off' | 'flag-only' | 'auto-ignore' };
+  [EVENTS.AI_TOOLS_REVOKE_REQUESTED]: Record<string, never>;
 
   // Native session lifecycle (159, contract session-reports.md). `outcome`
   // covers all three launch reports in one event (restored / none / degraded)