ad2app-lib 1.17.0 → 1.20.0

package/dist/analytics/index.d.ts

@@ -27,12 +27,42 @@ export declare const EVENTS: {
     readonly COMPOSE_STARTED: "compose_started";
     readonly POST_SCHEDULED: "post_scheduled";
     readonly POST_PUBLISHED: "post_published";
+    readonly PUBLISH_FAILED: "publish_failed";
     readonly ANALYTICS_VIEWED: "analytics_viewed";
     readonly LIMIT_REACHED: "limit_reached";
     readonly UPGRADE_CLICKED: "upgrade_clicked";
     readonly CHECKOUT_STARTED: "checkout_started";
     readonly SUBSCRIPTION_STARTED: "subscription_started";
     readonly SUBSCRIPTION_CANCELED: "subscription_canceled";
+    readonly PAYWALL_SHOWN: "paywall_shown";
+    readonly PAYWALL_DISMISSED: "paywall_dismissed";
+    readonly ONBOARDING_STEP_COMPLETED: "onboarding_step_completed";
+    readonly EXIT_INTENT_SHOWN: "exit_intent_shown";
+    readonly EXIT_INTENT_DISMISSED: "exit_intent_dismissed";
+    readonly EXIT_INTENT_CAPTURED: "exit_intent_captured";
+    readonly BETA_SIGNUP_CONFIRMED: "beta_signup_confirmed";
+    readonly PAYMENT_FAILED: "payment_failed";
+    readonly DUNNING_RECOVERED: "dunning_recovered";
+    readonly REFUND_ISSUED: "refund_issued";
+    readonly DISPUTE_OPENED: "dispute_opened";
+    readonly CANCEL_INITIATED: "cancel_initiated";
+    readonly RETENTION_OFFER_SHOWN: "retention_offer_shown";
+    readonly CANCEL_COMPLETED: "cancel_completed";
+    readonly ONBOARDING_STARTED: "onboarding_started";
+    readonly ONBOARDING_COMPLETED: "onboarding_completed";
+    readonly ONBOARDING_SKIPPED: "onboarding_skipped";
+    readonly COMMENT_REPLIED: "comment_replied";
+    readonly COMMENT_LIKED: "comment_liked";
+    readonly COMMENT_HIDDEN: "comment_hidden";
+    readonly COMMENT_DELETED: "comment_deleted";
+    readonly COMMENT_PRIVATE_REPLIED: "comment_private_replied";
+    readonly DM_REPLIED: "dm_replied";
+    readonly INBOX_MARKED_READ: "inbox_marked_read";
+    readonly POST_EDITED: "post_edited";
+    readonly POST_DELETED: "post_deleted";
+    readonly POST_RESCHEDULED: "post_rescheduled";
+    readonly ACCOUNT_DISCONNECTED: "account_disconnected";
+    readonly NOTIFICATION_PREFERENCES_UPDATED: "notification_preferences_updated";
 };
 export type EventName = (typeof EVENTS)[keyof typeof EVENTS];
 /** Shared shape for the Resend email lifecycle events (AD2-894). */
@@ -41,6 +71,30 @@ export interface EmailEventProperties {
     subject?: string;
     link?: string;
 }
+/**
+ * Where a paywall / upgrade / checkout moment was triggered from (080). A named,
+ * stable, closed set so the revenue funnel can attribute conversions to their
+ * origin surface. `checkout_abandon_email` is the recovery-email re-entry point
+ * (Superwall transaction-abandonment pattern). Wire values — do not rename.
+ */
+export type TriggerSource = 'connect_wall' | 'limit_reached' | 'exit_intent' | 'pricing_page' | 'checkout_abandon_email' | 'other';
+/**
+ * The USER-CHOSEN i18n locale (080) — NOT `$browser_language`. Localization is
+ * the top structural conversion lever in the corpus (Adapty), so every wall /
+ * paywall insight slices by it. Stamped on the surfaces the emitter controls.
+ */
+export type AppLocale = 'en' | 'pl';
+/**
+ * Coarse failure-reason buckets for the `publish_failed` event (AD2-999).
+ *
+ * Deliberately a small, stable, closed set: it lets publish outcomes be sliced
+ * per failure class in PostHog WITHOUT putting raw provider (Zernio/platform)
+ * error text — which can carry user content or PII — on the event. The emitter
+ * (backend) maps a raw provider error string to exactly one of these; an
+ * absent/unclassifiable error is `'unknown'`. Do NOT rename these values after
+ * they ship — they are wire values, historical data does not migrate.
+ */
+export type PublishFailureReason = 'auth' | 'rate_limit' | 'media' | 'content' | 'network' | 'platform' | 'unknown';
 /** Property shape per event. Keeps emitters honest across repos. */
 export interface EventProperties {
     [EVENTS.LANDING_CTA_CLICKED]: {
@@ -76,6 +130,7 @@ export interface EventProperties {
     [EVENTS.SOCIAL_ACCOUNT_CONNECTED]: {
         platform: string;
         account_count?: number;
+        connection_ordinal?: number;
     };
     [EVENTS.COMPOSE_STARTED]: {
         source?: 'wizard' | 'quick';
@@ -84,11 +139,23 @@ export interface EventProperties {
         platforms: string[];
         platform_count: number;
         scheduled_for?: string;
+        post_ordinal?: number;
     };
     [EVENTS.POST_PUBLISHED]: {
         platforms: string[];
         platform_count: number;
         status: 'success' | 'partial' | 'failed';
+        post_ordinal?: number;
+        platform?: string;
+        source?: 'scheduled_reconcile';
+        outcome?: 'success' | 'failed' | 'unknown';
+        reason_class?: PublishFailureReason;
+    };
+    [EVENTS.PUBLISH_FAILED]: {
+        platform: string;
+        reason_class: PublishFailureReason;
+        post_id: string;
+        platform_count: number;
     };
     [EVENTS.ANALYTICS_VIEWED]: {
         scope?: 'overview' | 'account' | 'post';
@@ -102,19 +169,157 @@ export interface EventProperties {
         from_plan?: string;
         to_plan?: string;
         surface: string;
+        trigger_source?: TriggerSource;
     };
     [EVENTS.CHECKOUT_STARTED]: {
         plan: string;
+        trigger_source?: TriggerSource;
     };
     [EVENTS.SUBSCRIPTION_STARTED]: {
         plan: string;
         mrr?: number;
         accounts_included?: number;
+        trigger_source?: TriggerSource;
     };
     [EVENTS.SUBSCRIPTION_CANCELED]: {
         plan: string;
         reason?: string;
     };
+    [EVENTS.PAYWALL_SHOWN]: {
+        surface: 'upgrade_modal' | 'pricing_page';
+        trigger: 'user_click' | 'limit_reached' | 'connect_wall';
+        plan?: string;
+        hit_number: number;
+        dwell_ms?: number;
+        page_views?: number;
+        app_locale: AppLocale;
+    };
+    [EVENTS.PAYWALL_DISMISSED]: {
+        surface: 'upgrade_modal' | 'pricing_page';
+        trigger: 'user_click' | 'limit_reached' | 'connect_wall';
+        hit_number: number;
+        app_locale: AppLocale;
+    };
+    [EVENTS.ONBOARDING_STEP_COMPLETED]: {
+        flow: 'complete_profile';
+        step: string;
+        step_index: number;
+        app_locale: AppLocale;
+    };
+    [EVENTS.EXIT_INTENT_SHOWN]: {
+        surface: 'connect_wall';
+        dwell_ms?: number;
+        page_views?: number;
+        app_locale?: AppLocale;
+    };
+    [EVENTS.EXIT_INTENT_DISMISSED]: {
+        surface: 'connect_wall';
+        dwell_ms?: number;
+        page_views?: number;
+        app_locale?: AppLocale;
+    };
+    [EVENTS.EXIT_INTENT_CAPTURED]: {
+        surface: 'connect_wall';
+        dwell_ms?: number;
+        page_views?: number;
+        app_locale?: AppLocale;
+    };
+    [EVENTS.BETA_SIGNUP_CONFIRMED]: {
+        source: 'exit_intent' | 'free_skills';
+    };
+    [EVENTS.PAYMENT_FAILED]: {
+        plan: string;
+        attempt: number;
+    };
+    [EVENTS.DUNNING_RECOVERED]: {
+        plan: string;
+        attempts: number;
+        days_late: number;
+    };
+    [EVENTS.REFUND_ISSUED]: {
+        plan: string;
+        days_since_start: number;
+    };
+    [EVENTS.DISPUTE_OPENED]: {
+        plan: string;
+        days_since_start: number;
+    };
+    [EVENTS.CANCEL_INITIATED]: {
+        plan: string;
+        days_since_start: number;
+    };
+    [EVENTS.RETENTION_OFFER_SHOWN]: {
+        plan: string;
+        offer: string;
+    };
+    [EVENTS.CANCEL_COMPLETED]: {
+        plan: string;
+        days_since_start: number;
+        reason?: string;
+    };
+    [EVENTS.ONBOARDING_STARTED]: {
+        flow?: string;
+    };
+    [EVENTS.ONBOARDING_COMPLETED]: {
+        flow?: string;
+        steps_completed?: number;
+    };
+    [EVENTS.ONBOARDING_SKIPPED]: {
+        flow?: string;
+        step?: string;
+    };
+    [EVENTS.COMMENT_REPLIED]: {
+        platform?: string;
+        success: boolean;
+    };
+    [EVENTS.COMMENT_LIKED]: {
+        platform?: string;
+        liked: boolean;
+        success: boolean;
+    };
+    [EVENTS.COMMENT_HIDDEN]: {
+        platform?: string;
+        hidden: boolean;
+        success: boolean;
+    };
+    [EVENTS.COMMENT_DELETED]: {
+        platform?: string;
+        success: boolean;
+    };
+    [EVENTS.COMMENT_PRIVATE_REPLIED]: {
+        platform?: string;
+        success: boolean;
+    };
+    [EVENTS.DM_REPLIED]: {
+        platform?: string;
+        success: boolean;
+    };
+    [EVENTS.INBOX_MARKED_READ]: {
+        platform?: string;
+        success: boolean;
+    };
+    [EVENTS.POST_EDITED]: {
+        platforms?: string[];
+        platform_count?: number;
+        success: boolean;
+    };
+    [EVENTS.POST_DELETED]: {
+        platform_count?: number;
+        success: boolean;
+    };
+    [EVENTS.POST_RESCHEDULED]: {
+        platform_count?: number;
+        success: boolean;
+    };
+    [EVENTS.ACCOUNT_DISCONNECTED]: {
+        platform: string;
+        success: boolean;
+    };
+    [EVENTS.NOTIFICATION_PREFERENCES_UPDATED]: {
+        preference?: string;
+        enabled?: boolean;
+        success: boolean;
+    };
 }
 /** Canonical person property keys (set via identify / $set). */
 export declare const PERSON_PROPS: {
@@ -122,5 +327,6 @@ export declare const PERSON_PROPS: {
     readonly ROLE: "role";
     readonly PLAN: "plan";
     readonly ACCOUNT_COUNT: "account_count";
+    readonly PAYWALL_HITS: "paywall_hits";
 };
 export type PersonPropKey = (typeof PERSON_PROPS)[keyof typeof PERSON_PROPS];

package/dist/analytics/index.js

@@ -34,6 +34,7 @@ exports.EVENTS = {
     COMPOSE_STARTED: 'compose_started',
     POST_SCHEDULED: 'post_scheduled',
     POST_PUBLISHED: 'post_published', // server-confirmed (backend)
+    PUBLISH_FAILED: 'publish_failed', // per-platform publish failure, server-owned (backend, AD2-999)
     ANALYTICS_VIEWED: 'analytics_viewed',
     // 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
@@ -41,6 +42,42 @@ exports.EVENTS = {
     CHECKOUT_STARTED: 'checkout_started',
     SUBSCRIPTION_STARTED: 'subscription_started',
     SUBSCRIPTION_CANCELED: 'subscription_canceled',
+    // 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
+    ONBOARDING_STEP_COMPLETED: 'onboarding_step_completed', // one step of a multi-step flow (complete-profile)
+    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
+    // Measurement baseline (080) — subscription lifecycle (backend = source of truth)
+    BETA_SIGNUP_CONFIRMED: 'beta_signup_confirmed', // double-opt-in confirm click
+    PAYMENT_FAILED: 'payment_failed', // invoice.payment_failed (excl. unexecuted hard-decline retries)
+    DUNNING_RECOVERED: 'dunning_recovered', // open→paid after ≥1 failure on the same invoice
+    REFUND_ISSUED: 'refund_issued',
+    DISPUTE_OPENED: 'dispute_opened',
+    CANCEL_INITIATED: 'cancel_initiated', // start of the cancel funnel
+    RETENTION_OFFER_SHOWN: 'retention_offer_shown', // emitted ONLY when an offer is actually shown — no fabrication
+    CANCEL_COMPLETED: 'cancel_completed',
+    // Onboarding flow (promoted from the frontend-local onboardingEvents.ts into the
+    // governed taxonomy, 2026-07-19 — ONBOARDING_STEP_COMPLETED is defined above).
+    ONBOARDING_STARTED: 'onboarding_started',
+    ONBOARDING_COMPLETED: 'onboarding_completed',
+    ONBOARDING_SKIPPED: 'onboarding_skipped',
+    // Inbox engagement (tracking-coverage gap: the inbox surface had ZERO events).
+    COMMENT_REPLIED: 'comment_replied',
+    COMMENT_LIKED: 'comment_liked',
+    COMMENT_HIDDEN: 'comment_hidden',
+    COMMENT_DELETED: 'comment_deleted',
+    COMMENT_PRIVATE_REPLIED: 'comment_private_replied',
+    DM_REPLIED: 'dm_replied',
+    INBOX_MARKED_READ: 'inbox_marked_read', // sanctioned; wired when 082 mark-read lands
+    // Post lifecycle + account (tracking-coverage gap).
+    POST_EDITED: 'post_edited',
+    POST_DELETED: 'post_deleted',
+    POST_RESCHEDULED: 'post_rescheduled',
+    ACCOUNT_DISCONNECTED: 'account_disconnected',
+    // Settings.
+    NOTIFICATION_PREFERENCES_UPDATED: 'notification_preferences_updated',
 };
 /** Canonical person property keys (set via identify / $set). */
 exports.PERSON_PROPS = {
@@ -48,4 +85,8 @@ exports.PERSON_PROPS = {
     ROLE: 'role',
     PLAN: 'plan', // 'free' | 'starter' | 'pro' (SchedulingSubscriptionTier)
     ACCOUNT_COUNT: 'account_count',
+    // 080: convenience $set mirror of paywall exposure. The event-level `hit_number`
+    // is the analytical truth — person props are query-time-latest here, so a counter
+    // stored here would rewrite the value on every historical paywall_shown event.
+    PAYWALL_HITS: 'paywall_hits',
 };

package/dist/types/scheduling/I_SchedulingInbox.d.ts

@@ -53,6 +53,12 @@ export declare class SchedulingInboxCommentDTO {
     /** Parent comment id on nested replies (AD2-1088). Absent on top-level comments. */
     parentId?: string;
     replies?: SchedulingInboxCommentDTO[];
+    /**
+     * True when this comment can be moderated (approve/reject/hold) — YouTube only
+     * per Zernio (OpenAPI v1.0.4:22489, `platform` enum = [youtube]). Absent for
+     * every other platform; never fabricated to false-as-if-known (082 US7).
+     */
+    canModerate?: boolean;
     constructor(data: SchedulingInboxCommentDTO);
 }
 /** Input DTO for sending a DM reply. */
@@ -70,3 +76,162 @@ export declare class SchedulingReplyToCommentDTO {
     commentId?: string;
     constructor(data: SchedulingReplyToCommentDTO);
 }
+/**
+ * One message inside a DM thread.
+ * Returned (paginated) by GET /social/inbox/messages/:id/thread — backed by
+ * Zernio GET /v1/inbox/conversations/{id}/messages (OpenAPI v1.0.4:20845).
+ */
+export declare class SchedulingInboxMessageDTO {
+    id: string;
+    conversationId: string;
+    authorId: string;
+    authorName: string;
+    text: string;
+    createdAt: string;
+    /** True when OUR connected account authored this message. */
+    isOwn: boolean;
+    mediaUrl?: string;
+    constructor(data: SchedulingInboxMessageDTO);
+}
+/**
+ * A cursor page of thread messages — kills the prior 100-message truncation.
+ * `nextCursor` absent = last page.
+ */
+export declare class SchedulingInboxMessagePageDTO {
+    items: SchedulingInboxMessageDTO[];
+    nextCursor?: string;
+    constructor(data: SchedulingInboxMessagePageDTO);
+}
+/**
+ * Mark-read acknowledgement — POST /social/inbox/messages/:id/read → Zernio
+ * POST /v1/inbox/conversations/{id}/read (OpenAPI v1.0.4:21692). `unreadCount`
+ * absent unless Zernio reports the post-read count.
+ */
+export declare class SchedulingConversationReadDTO {
+    conversationId: string;
+    unreadCount?: number;
+    constructor(data: SchedulingConversationReadDTO);
+}
+/**
+ * An inbound mention.
+ * Returned by GET /social/inbox/mentions → Zernio GET /v1/inbox/mentions
+ * (OpenAPI v1.0.4:23108). Source post fields absent when the platform omits them.
+ */
+export declare class SchedulingInboxMentionDTO {
+    id: string;
+    platform: string;
+    accountId: string;
+    authorName: string;
+    authorAvatarUrl?: string;
+    text: string;
+    createdAt: string;
+    sourcePostId?: string;
+    sourcePostUrl?: string;
+    constructor(data: SchedulingInboxMentionDTO);
+}
+/**
+ * Input for replying to a mention. Zernio requires [accountId, mediaId, message]
+ * (OpenAPI v1.0.4:23207) — `mediaId` (the mention's target media) is mandatory,
+ * unlike a DM reply.
+ */
+export declare class SchedulingReplyToMentionDTO {
+    accountId: string;
+    mediaId: string;
+    message: string;
+    constructor(data: SchedulingReplyToMentionDTO);
+}
+/**
+ * A platform review (e.g. Google Business).
+ * Returned by GET /social/inbox/reviews → Zernio GET /v1/inbox/reviews
+ * (OpenAPI v1.0.4:23269). `replied` absent unless Zernio reports reply state.
+ */
+export declare class SchedulingInboxReviewDTO {
+    id: string;
+    platform: string;
+    accountId: string;
+    authorName: string;
+    rating: number;
+    text: string;
+    createdAt: string;
+    replied?: boolean;
+    constructor(data: SchedulingInboxReviewDTO);
+}
+/**
+ * Input for replying to a review — POST /social/inbox/reviews/:reviewId/reply →
+ * Zernio POST /v1/inbox/reviews/{reviewId}/reply (OpenAPI v1.0.4:23377).
+ */
+export declare class SchedulingReplyToReviewDTO {
+    reviewId: string;
+    accountId: string;
+    text: string;
+    constructor(data: SchedulingReplyToReviewDTO);
+}
+/**
+ * The moderation decision on a comment. Closed set per Zernio
+ * (OpenAPI v1.0.4:22489): `published` approves, `rejected` removes,
+ * `heldForReview` returns it to the queue. YouTube only. `banAuthor` is valid
+ * ONLY with `rejected` (any other pairing is a 400 — enforced server-side).
+ */
+export type SchedulingCommentModerationStatus = 'published' | 'rejected' | 'heldForReview';
+export declare class SchedulingCommentModerationDTO {
+    moderationStatus: SchedulingCommentModerationStatus;
+    banAuthor?: boolean;
+    constructor(data: SchedulingCommentModerationDTO);
+}
+/**
+ * Input for starting a new DM — POST /social/inbox/conversations → Zernio
+ * POST /v1/inbox/conversations (OpenAPI v1.0.4:20355). WhatsApp is excluded
+ * (it requires an approved template to open a thread; 082 non-goal).
+ */
+export declare class SchedulingCreateConversationDTO {
+    accountId: string;
+    recipientId: string;
+    text: string;
+    constructor(data: SchedulingCreateConversationDTO);
+}
+/**
+ * Per-connected-account inbox capability truth — which surfaces a platform
+ * actually supports. Drives honest showing/hiding (082 FR-4): a false/absent
+ * surface is HIDDEN, never rendered as a fabricated empty. Reconciled from
+ * platform-capabilities + Zernio /accounts/health.
+ */
+export declare class SchedulingInboxCapabilityDTO {
+    platform: string;
+    dm: boolean;
+    comments: boolean;
+    mentions: boolean;
+    reviews: boolean;
+    /** Can INITIATE a DM (not just reply). */
+    dmInit: boolean;
+    /** Comment moderation queue (YouTube). */
+    moderation: boolean;
+    constructor(data: SchedulingInboxCapabilityDTO);
+}
+/**
+ * A comment re-sourced from Zernio's cross-post inbox (GET /v1/inbox/comments),
+ * carrying its OWN post attribution so it surfaces even when the post is absent
+ * from our local SocialPostCache. The cache is enrichment ONLY (post snippet /
+ * thumbnail), never the source of truth (082 US3 / AD2-1110): a comment on an
+ * uncached post must still reach the moderator. Comment/engagement fields mirror
+ * SchedulingInboxCommentDTO; enrichment fields are honest-or-absent — filled from
+ * the cache when present, never zero/empty-backfilled.
+ */
+export declare class SchedulingCrossPostCommentDTO {
+    id: string;
+    authorName: string;
+    authorAvatarUrl?: string;
+    text: string;
+    createdAt: string;
+    likeCount?: number;
+    replyCount?: number;
+    isOwner?: boolean;
+    parentId?: string;
+    canModerate?: boolean;
+    replies?: SchedulingCrossPostCommentDTO[];
+    postId: string;
+    platform: string;
+    accountId: string;
+    postContentSnippet?: string;
+    postThumbnailUrl?: string;
+    constructor(data: SchedulingCrossPostCommentDTO);
+}