ad2app-lib 1.9.2 → 1.9.3

package/dist/analytics/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Single source of truth for event names, event property shapes, and person
  * property keys across ALL surfaces (frontend, backend, landing, future MCP).
- * Spec: ad2appus/docs/posthog-implementation.md §3.
+ * Spec: ad2app-specs/analytics-posthog/posthog-implementation.md §3.
  *
  * Naming convention: snake_case, object_verb_past_tense.
  * Do NOT rename events after they ship — historical data does not migrate.
@@ -11,6 +11,15 @@
 /** Canonical PostHog event names. */
 export declare const EVENTS: {
     readonly LANDING_CTA_CLICKED: "landing_cta_clicked";
+    readonly CONNECT_ARTIFACT_COPIED: "connect_artifact_copied";
+    readonly FREE_SKILLS_REQUESTED: "free_skills_requested";
+    readonly ACCOUNT_CONNECT_BLOCKED: "account_connect_blocked";
+    readonly MCP_POST_BLOCKED_FREE_TIER: "mcp_post_blocked_free_tier";
+    readonly EMAIL_DELIVERED: "email_delivered";
+    readonly EMAIL_OPENED: "email_opened";
+    readonly EMAIL_CLICKED: "email_clicked";
+    readonly EMAIL_BOUNCED: "email_bounced";
+    readonly EMAIL_COMPLAINED: "email_complained";
     readonly SIGNED_UP: "signed_up";
     readonly PROFILE_COMPLETED: "profile_completed";
     readonly LOGGED_IN: "logged_in";
@@ -19,7 +28,6 @@ export declare const EVENTS: {
     readonly POST_SCHEDULED: "post_scheduled";
     readonly POST_PUBLISHED: "post_published";
     readonly ANALYTICS_VIEWED: "analytics_viewed";
-    readonly TRIAL_STARTED: "trial_started";
     readonly LIMIT_REACHED: "limit_reached";
     readonly UPGRADE_CLICKED: "upgrade_clicked";
     readonly CHECKOUT_STARTED: "checkout_started";
@@ -27,11 +35,34 @@ export declare const EVENTS: {
     readonly SUBSCRIPTION_CANCELED: "subscription_canceled";
 };
 export type EventName = (typeof EVENTS)[keyof typeof EVENTS];
+/** Shared shape for the Resend email lifecycle events (AD2-894). */
+export interface EmailEventProperties {
+    email_id?: string;
+    subject?: string;
+    link?: string;
+}
 /** Property shape per event. Keeps emitters honest across repos. */
 export interface EventProperties {
     [EVENTS.LANDING_CTA_CLICKED]: {
-        location: 'hero' | 'pricing' | 'final_cta' | 'nav';
+        location: 'hero' | 'pricing' | 'final_cta' | 'nav' | 'ai_connector' | 'free_skills';
+    };
+    [EVENTS.CONNECT_ARTIFACT_COPIED]: {
+        target: 'app' | 'ask' | 'terminal' | 'editor';
+    };
+    [EVENTS.FREE_SKILLS_REQUESTED]: {
+        source: string;
+    };
+    [EVENTS.ACCOUNT_CONNECT_BLOCKED]: {
+        platform?: string;
     };
+    [EVENTS.MCP_POST_BLOCKED_FREE_TIER]: {
+        target_count?: number;
+    };
+    [EVENTS.EMAIL_DELIVERED]: EmailEventProperties;
+    [EVENTS.EMAIL_OPENED]: EmailEventProperties;
+    [EVENTS.EMAIL_CLICKED]: EmailEventProperties;
+    [EVENTS.EMAIL_BOUNCED]: EmailEventProperties;
+    [EVENTS.EMAIL_COMPLAINED]: EmailEventProperties;
     [EVENTS.SIGNED_UP]: {
         method: 'email' | 'google';
         role: string;
@@ -62,9 +93,6 @@ export interface EventProperties {
     [EVENTS.ANALYTICS_VIEWED]: {
         scope?: 'overview' | 'account' | 'post';
     };
-    [EVENTS.TRIAL_STARTED]: {
-        plan: string;
-    };
     [EVENTS.LIMIT_REACHED]: {
         limit: 'x_link_posts' | 'accounts';
         plan: string;
@@ -94,6 +122,5 @@ export declare const PERSON_PROPS: {
     readonly ROLE: "role";
     readonly PLAN: "plan";
     readonly ACCOUNT_COUNT: "account_count";
-    readonly TRIAL_ENDS_AT: "trial_ends_at";
 };
 export type PersonPropKey = (typeof PERSON_PROPS)[keyof typeof PERSON_PROPS];

package/dist/analytics/index.js

@@ -4,7 +4,7 @@
  *
  * Single source of truth for event names, event property shapes, and person
  * property keys across ALL surfaces (frontend, backend, landing, future MCP).
- * Spec: ad2appus/docs/posthog-implementation.md §3.
+ * Spec: ad2app-specs/analytics-posthog/posthog-implementation.md §3.
  *
  * Naming convention: snake_case, object_verb_past_tense.
  * Do NOT rename events after they ship — historical data does not migrate.
@@ -15,6 +15,17 @@ exports.PERSON_PROPS = exports.EVENTS = void 0;
 exports.EVENTS = {
     // Acquisition (landing)
     LANDING_CTA_CLICKED: 'landing_cta_clicked',
+    CONNECT_ARTIFACT_COPIED: 'connect_artifact_copied', // /connect install-snippet copy
+    // Free Tier (skills lead magnet + connect wall)
+    FREE_SKILLS_REQUESTED: 'free_skills_requested', // email submitted for the free skills (AD2-889)
+    ACCOUNT_CONNECT_BLOCKED: 'account_connect_blocked', // free user hits the connect wall (AD2-892)
+    MCP_POST_BLOCKED_FREE_TIER: 'mcp_post_blocked_free_tier', // free user tries to post in the MCP (AD2-898)
+    // Email lifecycle (Resend webhook -> PostHog, AD2-894)
+    EMAIL_DELIVERED: 'email_delivered',
+    EMAIL_OPENED: 'email_opened',
+    EMAIL_CLICKED: 'email_clicked',
+    EMAIL_BOUNCED: 'email_bounced',
+    EMAIL_COMPLAINED: 'email_complained',
     // Activation (web app)
     SIGNED_UP: 'signed_up', // server-owned (backend, on user creation)
     PROFILE_COMPLETED: 'profile_completed', // the /complete-profile step (influencers)
@@ -24,8 +35,7 @@ exports.EVENTS = {
     POST_SCHEDULED: 'post_scheduled',
     POST_PUBLISHED: 'post_published', // server-confirmed (backend)
     ANALYTICS_VIEWED: 'analytics_viewed',
-    // Revenue (backend = source of truth)
-    TRIAL_STARTED: 'trial_started',
+    // Revenue (backend = source of truth). Paid-only product: no trial.
     LIMIT_REACHED: 'limit_reached', // cap hit (e.g. X link-post cap) — the upsell trigger
     UPGRADE_CLICKED: 'upgrade_clicked', // client intent
     CHECKOUT_STARTED: 'checkout_started',
@@ -36,7 +46,6 @@ exports.EVENTS = {
 exports.PERSON_PROPS = {
     EMAIL: 'email',
     ROLE: 'role',
-    PLAN: 'plan', // 'trial' | 'starter' | 'all_platforms' | 'free'
+    PLAN: 'plan', // 'free' | 'starter' | 'pro' (SchedulingSubscriptionTier)
     ACCOUNT_COUNT: 'account_count',
-    TRIAL_ENDS_AT: 'trial_ends_at',
 };

package/dist/api/apiDriver.js

@@ -37,13 +37,27 @@ async function fetchCall(args) {
         }
     }
     const res = await fetch(fullPath, init);
-    if (!res.ok)
-        throw new Error(JSON.stringify(await res.json()));
+    // Read the body ONCE as text. res.json() returns a promise, so the old
+    // synchronous try/catch around it never caught a parse failure (the text()
+    // fallback was dead code), and a plain-text error body threw inside res.json().
+    const rawBody = await res.text();
+    if (!res.ok) {
+        let message = rawBody;
+        try {
+            message = JSON.stringify(JSON.parse(rawBody));
+        }
+        catch {
+            // non-JSON error body: keep the raw text
+        }
+        throw new Error(message || `Request failed with status ${res.status}`);
+    }
+    if (!rawBody)
+        return undefined;
     try {
-        return res.json();
+        return JSON.parse(rawBody);
     }
     catch {
-        return res.text();
+        return rawBody;
     }
 }
 function apiDriver(baseUrl) {
@@ -64,6 +78,7 @@ function apiDriver(baseUrl) {
             ...args[1],
             path: args[0],
             method: "put",
+            baseUrl,
         }),
         patch: (...args) => fetchCall({
             ...args[1],

package/package.json

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