@iann29/rastro 0.9.0 → 0.10.0

package/dist/client/index.d.ts

@@ -15,7 +15,7 @@ export { localDayStart, nextLocalDayStart, previousLocalDayStart, } from "../com
 export { HEAT_HOT_SCORE, HEAT_WARM_SCORE, visitorHeat } from "./heat.js";
 export type { HeatInput, HeatLevel, HeatSignal, VisitorHeat } from "./heat.js";
 export type { VitalMetric } from "../component/vitals.js";
-export { effectiveFederatedPermissions, federatedPermissionSatisfies, isPublicFederatedAccess, FEDERATED_ANALYTICS_CLAIMS, FEDERATED_ANALYTICS_CONFIGURE_FUNCTIONS, FEDERATED_ANALYTICS_CONFIGURE_PERMISSION, FEDERATED_ANALYTICS_CONNECTOR_MANIFEST, FEDERATED_ANALYTICS_ERROR_CODES, FEDERATED_ANALYTICS_LEAD_FUNCTIONS, FEDERATED_ANALYTICS_PERMISSIONS, FEDERATED_ANALYTICS_PUBLIC_FUNCTIONS, FEDERATED_ANALYTICS_PUBLIC_PERMISSION, FEDERATED_ANALYTICS_READ_PERMISSION, FEDERATED_ANALYTICS_REQUIRED_CAPABILITIES, FEDERATED_ANALYTICS_REQUIRED_FUNCTIONS, federatedAnalyticsPermissionValidator, } from "./federation.js";
+export { effectiveFederatedPermissions, federatedPermissionSatisfies, isPublicFederatedAccess, FEDERATED_ANALYTICS_CLAIMS, FEDERATED_ANALYTICS_CONFIGURE_FUNCTIONS, FEDERATED_ANALYTICS_CONFIGURE_PERMISSION, FEDERATED_ANALYTICS_CONNECTOR_MANIFEST, FEDERATED_ANALYTICS_ERROR_CODES, FEDERATED_ANALYTICS_LEAD_FUNCTIONS, FEDERATED_ANALYTICS_META_AUTHORIZER, FEDERATED_ANALYTICS_META_FUNCTIONS, FEDERATED_ANALYTICS_PERMISSIONS, federatedMetaOwnerKey, FEDERATED_ANALYTICS_PUBLIC_FUNCTIONS, FEDERATED_ANALYTICS_PUBLIC_PERMISSION, FEDERATED_ANALYTICS_READ_PERMISSION, FEDERATED_ANALYTICS_REQUIRED_CAPABILITIES, FEDERATED_ANALYTICS_REQUIRED_FUNCTIONS, federatedAnalyticsPermissionValidator, } from "./federation.js";
 export type { FederatedAnalyticsCapability, FederatedAnalyticsAuthorizerOptions, FederatedAnalyticsConnection, FederatedAnalyticsConnectionStatus, FederatedAnalyticsErrorCode, FederatedAnalyticsIdentity, FederatedAnalyticsManifest, FederatedAnalyticsPermission, FederatedSiteSummary, ResolveFederatedAnalyticsConnection, } from "./federation.js";
 export type CreateSiteInput = FunctionArgs<ComponentApi["sites"]["create"]>;
 export type ListPeopleInput = FunctionArgs<ComponentApi["people"]["list"]>;
@@ -69,14 +69,68 @@ export type CreateTrackedLinkInput = FunctionArgs<ComponentApi["trackedLinks"]["
 export type UpdateTrackedLinkInput = FunctionArgs<ComponentApi["trackedLinks"]["update"]>;
 export type ListTrackedLinksInput = FunctionArgs<ComponentApi["trackedLinks"]["list"]>;
 export type TrackedLink = FunctionReturnType<ComponentApi["trackedLinks"]["list"]>[number];
-export type RecordLeadInput = FunctionArgs<ComponentApi["leads"]["record"]>;
-export type SetLeadStageInput = FunctionArgs<ComponentApi["leads"]["setStage"]>;
+/**
+ * What the host knows of a lead's contact for the Meta pixel, every value
+ * already a SHA-256 hex digest: the phone numbers (digits with the country
+ * code) and the host's own contact id.
+ */
+export type MetaHashes = {
+    ph: string[];
+    externalId?: string;
+};
+export type RecordLeadInput = Omit<FunctionArgs<ComponentApi["leads"]["record"]>, "meta"> & {
+    meta?: MetaHashes;
+};
+export type SetLeadStageInput = Omit<FunctionArgs<ComponentApi["leads"]["setStage"]>, "meta"> & {
+    meta?: MetaHashes;
+};
 export type UpsertAdCatalogInput = FunctionArgs<ComponentApi["leads"]["upsertAdCatalog"]>;
 export type LeadsReportInput = FunctionArgs<ComponentApi["leads"]["report"]>;
 export type LeadsReport = FunctionReturnType<ComponentApi["leads"]["report"]>;
 export type ListLeadsInput = FunctionArgs<ComponentApi["leads"]["list"]>;
 export type LeadSummary = FunctionReturnType<ComponentApi["leads"]["list"]>[number];
 export type LeadJourney = FunctionReturnType<ComponentApi["leads"]["journey"]>;
+export type LeadsDailyInput = FunctionArgs<ComponentApi["leads"]["daily"]>;
+export type LeadsDaily = FunctionReturnType<ComponentApi["leads"]["daily"]>;
+export type MetaStatus = FunctionReturnType<ComponentApi["meta"]["status"]>;
+export type MetaConversionsInput = FunctionArgs<ComponentApi["meta"]["conversions"]>;
+export type MetaConversion = FunctionReturnType<ComponentApi["meta"]["conversions"]>[number];
+export type MetaAdAccount = FunctionReturnType<ComponentApi["meta"]["listAdAccounts"]>[number];
+export type SetMetaConnectionInput = FunctionArgs<ComponentApi["meta"]["connect"]>;
+export type SetMetaConnectionOutput = FunctionReturnType<ComponentApi["meta"]["connect"]>;
+export type LinkSiteAdAccountInput = FunctionArgs<ComponentApi["meta"]["linkAdAccount"]>;
+/**
+ * The site's pixel, picked from an owner's connection (`ownerKey`: it sends
+ * with that connection's token) or set with its own Conversions API token
+ * (`accessToken`, plan B). Exactly one of the two.
+ */
+export type SetSitePixelInput = Omit<FunctionArgs<ComponentApi["meta"]["setPixel"]>, "accessToken" | "ownerKey"> & ({
+    ownerKey: string;
+    accessToken?: never;
+} | {
+    accessToken: string;
+    ownerKey?: never;
+});
+export type ConnectMetaWithCodeInput = FunctionArgs<ComponentApi["meta"]["connectWithCode"]>;
+export type ConnectMetaWithCodeOutput = FunctionReturnType<ComponentApi["meta"]["connectWithCode"]>;
+/** An owner's Meta connection as a screen shows it (never a token). */
+export type MetaConnection = NonNullable<FunctionReturnType<ComponentApi["meta"]["connection"]>>;
+export type MetaConnectionAdAccount = MetaConnection["adAccounts"][number];
+export type MetaPixel = MetaConnection["pixels"][number];
+/** Where a site's pixel sends from: a connection's token, or its own. */
+export type MetaPixelSource = "connection" | "token";
+export type SetPipelineInput = FunctionArgs<ComponentApi["pipeline"]["setPipeline"]>;
+export type PipelineColumn = SetPipelineInput["columns"][number];
+export type SetEventMapInput = FunctionArgs<ComponentApi["pipeline"]["setEventMap"]>;
+export type EventMapInput = FunctionArgs<ComponentApi["pipeline"]["eventMap"]>;
+/** A site's columns, the Meta event each sends and its monthly entries. */
+export type EventMap = FunctionReturnType<ComponentApi["pipeline"]["eventMap"]>;
+export type EventMapColumn = EventMap["columns"][number];
+/** The events a column may send; `Purchase` comes from the sale alone. */
+export type MetaColumnEvent = NonNullable<EventMapColumn["event"]>;
+export type UnlinkPreviewInput = FunctionArgs<ComponentApi["meta"]["unlinkPreview"]>;
+/** What unlinking an ad account takes out of the site's reports. */
+export type UnlinkPreview = FunctionReturnType<ComponentApi["meta"]["unlinkPreview"]>;
 export type CleanupInput = {
     siteId: string;
     kind: RetentionKind;
@@ -918,7 +972,9 @@ export declare class Rastro {
      * Records a lead the host's server saw (a WhatsApp conversation), once per
      * `leadKey`: pass the host's own opaque id for the conversation, never a
      * phone number. The first touch wins; a repeat call only fills `label` or
-     * `visitorId`. Call it from the host's inbound handler.
+     * `visitorId`. Call it from the host's inbound handler. `meta` (SHA-256
+     * hashes of the phone and the contact id) lets the site's Meta pixel
+     * receive `Lead` when the pixel sends new leads.
      */
     recordLead(ctx: MutationCtx, args: RecordLeadInput): Promise<{
         created: boolean;
@@ -926,8 +982,11 @@ export declare class Rastro {
     }>;
     /**
      * Moves a recorded lead to `qualified`, `won` (with the sale value in the
-     * site's currency), `lost`, or back `open`. Idempotent by `eventId`; a lead
-     * never recorded returns `applied: false` instead of being invented.
+     * site's currency), `lost`, or back `open`, and/or to the host's board
+     * `column` (see `setPipeline`). Idempotent by `eventId`; a lead never
+     * recorded returns `applied: false` instead of being invented. With `meta`
+     * (SHA-256 hashes) and an active pixel, a sale with a value is sent to Meta
+     * as `Purchase` and a mapped column's event goes out, once per lead each.
      */
     setLeadStage(ctx: MutationCtx, args: SetLeadStageInput): Promise<{
         applied: boolean;
@@ -941,48 +1000,85 @@ export declare class Rastro {
         upserted: number;
     }>;
     leadsReport(ctx: QueryCtx | MutationCtx | ActionCtx, args: LeadsReportInput): Promise<{
+        bySite?: Array<{
+            currencyMismatch?: boolean;
+            leads: number;
+            paid: {
+                leads: number;
+                qualified: number;
+                revenueCents: number;
+                won: number;
+            };
+            qualified: number;
+            revenueCents: number;
+            siteId: string;
+            spendCents?: number | null;
+            spendCurrency?: string | null;
+            won: number;
+        }>;
         campaigns: Array<{
             adsets: Array<{
                 ads: Array<{
                     adId: string;
                     adName: string | null;
+                    adStatus?: string | null;
+                    clicks?: number | null;
+                    creativeType?: string | null;
+                    impressions?: number | null;
                     leads: number;
                     qualified: number;
                     revenueCents: number;
+                    siteId?: string;
                     sourceApp: string | null;
                     sourceUrl: string | null;
+                    spendCents?: number | null;
                     thumbnailUrl: string | null;
                     title: string | null;
                     won: number;
                 }>;
                 adsetId: string | null;
                 adsetName: string | null;
+                clicks?: number | null;
+                impressions?: number | null;
                 leads: number;
                 qualified: number;
                 revenueCents: number;
+                spendCents?: number | null;
                 won: number;
             }>;
             campaignId: string | null;
             campaignName: string | null;
+            clicks?: number | null;
+            impressions?: number | null;
             leads: number;
             qualified: number;
             revenueCents: number;
+            spendCents?: number | null;
             won: number;
         }>;
         currency: string | null;
+        currencyMismatch?: boolean;
         from: number;
         origins: Array<{
+            clicks?: number | null;
+            impressions?: number | null;
             key: string;
             leads: number;
             qualified: number;
             revenueCents: number;
+            spendCents?: number | null;
             won: number;
         }>;
+        spendCurrency?: string | null;
+        spendIncomplete?: boolean;
         to: number;
         totals: {
+            clicks?: number | null;
+            impressions?: number | null;
             leads: number;
             qualified: number;
             revenueCents: number;
+            spendCents?: number | null;
             won: number;
         };
     }>;
@@ -1036,6 +1132,184 @@ export declare class Rastro {
         };
         visitorId: string | null;
     } | null>;
+    /**
+     * The lead funnel per cohort day (every UTC day in the range, empty days
+     * included), optionally for one ad, with that day's Meta spend.
+     */
+    leadsDaily(ctx: QueryCtx | MutationCtx | ActionCtx, args: LeadsDailyInput): Promise<{
+        dayStart: number;
+        leads: number;
+        qualified: number;
+        revenueCents: number;
+        spendCents: number | null;
+        won: number;
+    }[]>;
+    /**
+     * Where each site stands with Meta: linked ad accounts, pixel, sends. With
+     * `ownerKey`, each link and the pixel say whether that owner made them
+     * (`own`).
+     */
+    metaStatus(ctx: QueryCtx | MutationCtx | ActionCtx, args: {
+        siteIds: string[];
+        ownerKey?: string;
+        now?: number;
+    }): Promise<{
+        adAccounts: Array<{
+            adAccountId: string;
+            backfill?: {
+                done: number;
+                total: number;
+            } | null;
+            currency: string;
+            lastError: string | null;
+            lastSyncAt: number | null;
+            name: string;
+            own?: boolean;
+            syncState: "backfill" | "live" | "error";
+            timezone: string;
+        }>;
+        conversions: {
+            failed: number;
+            last30d?: {
+                Lead: number;
+                Purchase: number;
+                QualifiedLead: number;
+                Schedule: number;
+            } | null;
+            pending: number;
+            sent: number;
+            sentToday?: number | null;
+        };
+        linked: boolean;
+        pixel: {
+            enabled: boolean;
+            lastError?: string | null;
+            name?: string | null;
+            own?: boolean;
+            pixelId: string | null;
+            source?: "connection" | "token" | null;
+            testMode?: boolean;
+        };
+        siteId: string;
+    }[]>;
+    /** The site's latest conversions for its Meta pixel, without user data. */
+    metaConversions(ctx: QueryCtx | MutationCtx | ActionCtx, args: MetaConversionsInput): Promise<{
+        adId: string | null;
+        adName: string | null;
+        createdAt: number;
+        eventId: string;
+        eventName: "Lead" | "QualifiedLead" | "Schedule" | "Purchase";
+        leadId: string | null;
+        leadLabel: string | null;
+        sentAt: number | null;
+        status: "pending" | "sent" | "failed";
+        valueCents: number | null;
+    }[]>;
+    /**
+     * Validates a Meta token (a system user token with `ads_read`) for the
+     * host's opaque `ownerKey`, lists its ad accounts and stores the token
+     * encrypted with RASTRO_SECRETS_KEY. Pasting a new token for the same owner
+     * replaces the old one. Fails with `SECRETS_KEY_MISSING` without the key and
+     * `META_TOKEN_INVALID` when Meta refuses the token.
+     */
+    setMetaConnection(ctx: ActionCtx, args: SetMetaConnectionInput): Promise<SetMetaConnectionOutput>;
+    /**
+     * Facebook Login for Business: trades the `code` Meta sent to `redirectUri`
+     * for the owner's token (with the component's RASTRO_META_APP_ID/SECRET),
+     * then connects it like `setMetaConnection` and records who authorized it.
+     * Fails with `META_LOGIN_UNAVAILABLE` without the app env and
+     * `META_TOKEN_INVALID` when Meta refuses the code.
+     */
+    connectMetaWithCode(ctx: ActionCtx, args: ConnectMetaWithCodeInput): Promise<ConnectMetaWithCodeOutput>;
+    /**
+     * The owner's connection for a screen: status, who authorized it, the
+     * listed ad accounts with the site each feeds, the listed pixels. Null when
+     * the owner never connected. Never a token.
+     */
+    metaConnection(ctx: QueryCtx | MutationCtx | ActionCtx, args: {
+        ownerKey: string;
+    }): Promise<MetaConnection | null>;
+    /** What unlinking the ad account takes out of the site's reports. */
+    metaUnlinkPreview(ctx: QueryCtx | MutationCtx | ActionCtx, args: UnlinkPreviewInput): Promise<UnlinkPreview>;
+    /**
+     * Declares the host's board columns for the site, in order (at most 40).
+     * Declaring again replaces names and order; a column that is gone leaves
+     * the event map. Then pass `column` to `recordLead` / `setLeadStage`.
+     */
+    setPipeline(ctx: MutationCtx, args: SetPipelineInput): Promise<null>;
+    /**
+     * Which Meta event each declared column sends (`Lead`, `QualifiedLead`,
+     * `Schedule` or null), replacing the whole map, and whether a new lead is
+     * sent as `Lead`. `Purchase` is never a column's: it goes with the sale.
+     */
+    setEventMap(ctx: MutationCtx, args: SetEventMapInput): Promise<null>;
+    /**
+     * The site's columns with their events and the leads that entered each in
+     * the 30 days up to `now` (pass the caller's clock; without it the counts
+     * are null).
+     */
+    eventMap(ctx: QueryCtx | MutationCtx | ActionCtx, args: EventMapInput): Promise<EventMap>;
+    /**
+     * Forgets the Meta owner a federated dashboard connection acted as on this
+     * host (`rastro:connection:<connectionId>`): its token, links and pixels.
+     * Call it when the host revokes or deletes that connection's grant.
+     */
+    removeFederatedMetaConnection(ctx: MutationCtx | ActionCtx, args: {
+        connectionId: string;
+    }): Promise<{
+        removed: boolean;
+    }>;
+    /** Forgets the owner's token and unlinks every ad account it fed. */
+    removeMetaConnection(ctx: MutationCtx | ActionCtx, args: {
+        ownerKey: string;
+    }): Promise<{
+        removed: boolean;
+    }>;
+    /** The owner's ad accounts (and their pixels), read again from Meta. */
+    listMetaAdAccounts(ctx: ActionCtx, args: {
+        ownerKey: string;
+    }): Promise<MetaAdAccount[]>;
+    /**
+     * Makes one of the owner's ad accounts a spend source for the site: a
+     * 90-day backfill with the catalog, then the live sync. The account must be
+     * in the connection's last listing.
+     */
+    linkSiteAdAccount(ctx: MutationCtx, args: LinkSiteAdAccountInput): Promise<{
+        linked: boolean;
+    }>;
+    /**
+     * Stops an ad account feeding the site; its spend leaves the reports. With
+     * `ownerKey`, only that owner's link (another's is a `CONFLICT`).
+     */
+    unlinkSiteAdAccount(ctx: MutationCtx, args: {
+        siteId: string;
+        adAccountId: string;
+        ownerKey?: string;
+    }): Promise<{
+        unlinked: boolean;
+    }>;
+    /**
+     * Sets the site's Meta pixel (dataset): with `ownerKey`, one from that
+     * owner's connection listing, sending with the connection's token; with
+     * `accessToken`, a Conversions API token from Events Manager, checked
+     * against the pixel and encrypted like the connection's.
+     */
+    setSitePixel(ctx: ActionCtx, args: SetSitePixelInput): Promise<{
+        ok: true;
+    }>;
+    /** Forgets the site's pixel; with `ownerKey`, only if that owner set it. */
+    removeSitePixel(ctx: MutationCtx, args: {
+        siteId: string;
+        ownerKey?: string;
+    }): Promise<{
+        removed: boolean;
+    }>;
+    /** Asks the Meta sync to read the site's ad accounts now. */
+    syncMetaNow(ctx: MutationCtx | ActionCtx, args: {
+        siteId: string;
+    }): Promise<{
+        scheduled: boolean;
+    }>;
     cleanup(ctx: MutationCtx, args: CleanupInput): Promise<{
         before: number;
         deleted: number;
@@ -1083,7 +1357,7 @@ export declare class Rastro {
         hasMore: boolean;
     }>;
 }
-export type AnalyticsOperation = "site.create" | "site.update" | "site.get" | "site.list" | "ingest" | "conversion.track" | "visitor.link" | "visitor.identify" | "visitor.profile" | "visitor.list" | "visitor.index" | "report.overview" | "report.live" | "report.sessions" | "report.sessionJourney" | "report.conversions" | "report.visitorJourney" | "report.goals" | "report.funnels" | "report.affiliates" | "report.vitals" | "report.siteMap" | "goal.upsert" | "goal.list" | "goal.remove" | "funnel.upsert" | "funnel.list" | "funnel.remove" | "affiliate.upsert" | "affiliate.list" | "affiliate.remove" | "trackedLink.create" | "trackedLink.update" | "trackedLink.delete" | "trackedLink.list" | "lead.report" | "lead.list" | "lead.journey" | "retention.cleanup" | "retention.policy" | "retention.status" | "coverage.read";
+export type AnalyticsOperation = "site.create" | "site.update" | "site.get" | "site.list" | "ingest" | "conversion.track" | "visitor.link" | "visitor.identify" | "visitor.profile" | "visitor.list" | "visitor.index" | "report.overview" | "report.live" | "report.sessions" | "report.sessionJourney" | "report.conversions" | "report.visitorJourney" | "report.goals" | "report.funnels" | "report.affiliates" | "report.vitals" | "report.siteMap" | "goal.upsert" | "goal.list" | "goal.remove" | "funnel.upsert" | "funnel.list" | "funnel.remove" | "affiliate.upsert" | "affiliate.list" | "affiliate.remove" | "trackedLink.create" | "trackedLink.update" | "trackedLink.delete" | "trackedLink.list" | "lead.report" | "lead.list" | "lead.journey" | "lead.daily" | "meta.status" | "meta.conversions" | "retention.cleanup" | "retention.policy" | "retention.status" | "coverage.read";
 export type AnalyticsAuthorizationRequest = {
     operation: AnalyticsOperation;
     siteIds: string[];
@@ -2896,48 +3170,85 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         siteIds: string[];
         to: number;
     }, Promise<{
+        bySite?: Array<{
+            currencyMismatch?: boolean;
+            leads: number;
+            paid: {
+                leads: number;
+                qualified: number;
+                revenueCents: number;
+                won: number;
+            };
+            qualified: number;
+            revenueCents: number;
+            siteId: string;
+            spendCents?: number | null;
+            spendCurrency?: string | null;
+            won: number;
+        }>;
         campaigns: Array<{
             adsets: Array<{
                 ads: Array<{
                     adId: string;
                     adName: string | null;
+                    adStatus?: string | null;
+                    clicks?: number | null;
+                    creativeType?: string | null;
+                    impressions?: number | null;
                     leads: number;
                     qualified: number;
                     revenueCents: number;
+                    siteId?: string;
                     sourceApp: string | null;
                     sourceUrl: string | null;
+                    spendCents?: number | null;
                     thumbnailUrl: string | null;
                     title: string | null;
                     won: number;
                 }>;
                 adsetId: string | null;
                 adsetName: string | null;
+                clicks?: number | null;
+                impressions?: number | null;
                 leads: number;
                 qualified: number;
                 revenueCents: number;
+                spendCents?: number | null;
                 won: number;
             }>;
             campaignId: string | null;
             campaignName: string | null;
+            clicks?: number | null;
+            impressions?: number | null;
             leads: number;
             qualified: number;
             revenueCents: number;
+            spendCents?: number | null;
             won: number;
         }>;
         currency: string | null;
+        currencyMismatch?: boolean;
         from: number;
         origins: Array<{
+            clicks?: number | null;
+            impressions?: number | null;
             key: string;
             leads: number;
             qualified: number;
             revenueCents: number;
+            spendCents?: number | null;
             won: number;
         }>;
+        spendCurrency?: string | null;
+        spendIncomplete?: boolean;
         to: number;
         totals: {
+            clicks?: number | null;
+            impressions?: number | null;
             leads: number;
             qualified: number;
             revenueCents: number;
+            spendCents?: number | null;
             won: number;
         };
     }>>;
@@ -2998,6 +3309,79 @@ export declare function exposeAnalyticsApi(component: ComponentApi, options: {
         };
         visitorId: string | null;
     } | null>>;
+    leadsDaily: import("convex/server").RegisteredQuery<"public", {
+        adId?: string | undefined;
+        from: number;
+        origin?: string | undefined;
+        siteIds: string[];
+        to: number;
+    }, Promise<{
+        dayStart: number;
+        leads: number;
+        qualified: number;
+        revenueCents: number;
+        spendCents: number | null;
+        won: number;
+    }[]>>;
+    metaStatus: import("convex/server").RegisteredQuery<"public", {
+        now?: number | undefined;
+        siteIds: string[];
+    }, Promise<{
+        adAccounts: Array<{
+            adAccountId: string;
+            backfill?: {
+                done: number;
+                total: number;
+            } | null;
+            currency: string;
+            lastError: string | null;
+            lastSyncAt: number | null;
+            name: string;
+            own?: boolean;
+            syncState: "backfill" | "live" | "error";
+            timezone: string;
+        }>;
+        conversions: {
+            failed: number;
+            last30d?: {
+                Lead: number;
+                Purchase: number;
+                QualifiedLead: number;
+                Schedule: number;
+            } | null;
+            pending: number;
+            sent: number;
+            sentToday?: number | null;
+        };
+        linked: boolean;
+        pixel: {
+            enabled: boolean;
+            lastError?: string | null;
+            name?: string | null;
+            own?: boolean;
+            pixelId: string | null;
+            source?: "connection" | "token" | null;
+            testMode?: boolean;
+        };
+        siteId: string;
+    }[]>>;
+    metaConversions: import("convex/server").RegisteredQuery<"public", {
+        before?: number | undefined;
+        beforeEventId?: string | undefined;
+        limit?: number | undefined;
+        siteId: string;
+    }, Promise<{
+        adId: string | null;
+        adName: string | null;
+        createdAt: number;
+        eventId: string;
+        eventName: "Lead" | "QualifiedLead" | "Schedule" | "Purchase";
+        leadId: string | null;
+        leadLabel: string | null;
+        sentAt: number | null;
+        status: "pending" | "sent" | "failed";
+        valueCents: number | null;
+    }[]>>;
     revenueSummary: import("convex/server").RegisteredQuery<"public", {
         from: number;
         siteIds: string[];
@@ -3696,9 +4080,24 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
             leadsReport?: "leadsReport" | undefined;
             listLeads?: "listLeads" | undefined;
             leadJourney?: "leadJourney" | undefined;
+            leadsDaily?: "leadsDaily" | undefined;
+            metaStatus?: "metaStatus" | undefined;
+            metaConversions?: "metaConversions" | undefined;
+            metaConnection?: "metaConnection" | undefined;
+            metaEventMap?: "metaEventMap" | undefined;
+            metaUnlinkPreview?: "metaUnlinkPreview" | undefined;
+            connectMeta?: "connectMeta" | undefined;
+            disconnectMeta?: "disconnectMeta" | undefined;
+            refreshMetaAccounts?: "refreshMetaAccounts" | undefined;
+            linkMetaAdAccount?: "linkMetaAdAccount" | undefined;
+            unlinkMetaAdAccount?: "unlinkMetaAdAccount" | undefined;
+            setMetaPixel?: "setMetaPixel" | undefined;
+            removeMetaPixel?: "removeMetaPixel" | undefined;
+            setMetaEventMap?: "setMetaEventMap" | undefined;
+            syncMetaNow?: "syncMetaNow" | undefined;
             transferConnection?: "transferConnection" | undefined;
         };
-        capabilities: ("affiliates" | "configure" | "conversions" | "dataCoverage" | "funnels" | "goals" | "leads" | "liveVisitors" | "localDays" | "overview" | "people" | "revenueSummary" | "sessionDetails" | "sessionJourney" | "sessions" | "siteMap" | "siteSummaries" | "trackedLinks" | "transfer" | "visitorJourney" | "visitorProfiles" | "vitals")[];
+        capabilities: ("affiliates" | "configure" | "conversions" | "dataCoverage" | "funnels" | "goals" | "leads" | "liveVisitors" | "localDays" | "metaAds" | "overview" | "people" | "revenueSummary" | "sessionDetails" | "sessionJourney" | "sessions" | "siteMap" | "siteSummaries" | "trackedLinks" | "transfer" | "visitorJourney" | "visitorProfiles" | "vitals")[];
         limits: {
             maxSitesPerRequest: 10;
             maxSitesPerConnection: 10;
@@ -4598,48 +4997,85 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         siteIds: string[];
         to: number;
     }, Promise<{
+        bySite?: Array<{
+            currencyMismatch?: boolean;
+            leads: number;
+            paid: {
+                leads: number;
+                qualified: number;
+                revenueCents: number;
+                won: number;
+            };
+            qualified: number;
+            revenueCents: number;
+            siteId: string;
+            spendCents?: number | null;
+            spendCurrency?: string | null;
+            won: number;
+        }>;
         campaigns: Array<{
             adsets: Array<{
                 ads: Array<{
                     adId: string;
                     adName: string | null;
+                    adStatus?: string | null;
+                    clicks?: number | null;
+                    creativeType?: string | null;
+                    impressions?: number | null;
                     leads: number;
                     qualified: number;
                     revenueCents: number;
+                    siteId?: string;
                     sourceApp: string | null;
                     sourceUrl: string | null;
+                    spendCents?: number | null;
                     thumbnailUrl: string | null;
                     title: string | null;
                     won: number;
                 }>;
                 adsetId: string | null;
                 adsetName: string | null;
+                clicks?: number | null;
+                impressions?: number | null;
                 leads: number;
                 qualified: number;
                 revenueCents: number;
+                spendCents?: number | null;
                 won: number;
             }>;
             campaignId: string | null;
             campaignName: string | null;
+            clicks?: number | null;
+            impressions?: number | null;
             leads: number;
             qualified: number;
             revenueCents: number;
+            spendCents?: number | null;
             won: number;
         }>;
         currency: string | null;
+        currencyMismatch?: boolean;
         from: number;
         origins: Array<{
+            clicks?: number | null;
+            impressions?: number | null;
             key: string;
             leads: number;
             qualified: number;
             revenueCents: number;
+            spendCents?: number | null;
             won: number;
         }>;
+        spendCurrency?: string | null;
+        spendIncomplete?: boolean;
         to: number;
         totals: {
+            clicks?: number | null;
+            impressions?: number | null;
             leads: number;
             qualified: number;
             revenueCents: number;
+            spendCents?: number | null;
             won: number;
         };
     }>>;
@@ -4700,6 +5136,199 @@ export declare function exposeFederatedAnalyticsApi(component: ComponentApi, opt
         };
         visitorId: string | null;
     } | null>>;
+    leadsDaily: import("convex/server").RegisteredQuery<"public", {
+        adId?: string | undefined;
+        from: number;
+        origin?: string | undefined;
+        siteIds: string[];
+        to: number;
+    }, Promise<{
+        dayStart: number;
+        leads: number;
+        qualified: number;
+        revenueCents: number;
+        spendCents: number | null;
+        won: number;
+    }[]>>;
+    metaStatus: import("convex/server").RegisteredQuery<"public", {
+        now?: number | undefined;
+        siteIds: string[];
+    }, Promise<{
+        adAccounts: Array<{
+            adAccountId: string;
+            backfill?: {
+                done: number;
+                total: number;
+            } | null;
+            currency: string;
+            lastError: string | null;
+            lastSyncAt: number | null;
+            name: string;
+            own?: boolean;
+            syncState: "backfill" | "live" | "error";
+            timezone: string;
+        }>;
+        conversions: {
+            failed: number;
+            last30d?: {
+                Lead: number;
+                Purchase: number;
+                QualifiedLead: number;
+                Schedule: number;
+            } | null;
+            pending: number;
+            sent: number;
+            sentToday?: number | null;
+        };
+        linked: boolean;
+        pixel: {
+            enabled: boolean;
+            lastError?: string | null;
+            name?: string | null;
+            own?: boolean;
+            pixelId: string | null;
+            source?: "connection" | "token" | null;
+            testMode?: boolean;
+        };
+        siteId: string;
+    }[]>>;
+    metaConversions: import("convex/server").RegisteredQuery<"public", {
+        before?: number | undefined;
+        beforeEventId?: string | undefined;
+        limit?: number | undefined;
+        siteId: string;
+    }, Promise<{
+        adId: string | null;
+        adName: string | null;
+        createdAt: number;
+        eventId: string;
+        eventName: "Lead" | "QualifiedLead" | "Schedule" | "Purchase";
+        leadId: string | null;
+        leadLabel: string | null;
+        sentAt: number | null;
+        status: "pending" | "sent" | "failed";
+        valueCents: number | null;
+    }[]>>;
+    metaConnection: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+        authorizedAt: number | null;
+        authorizedBy: {
+            name: string | null;
+        } | null;
+        businessName: string | null;
+        expiresAt: number | null;
+        expiringSoon: boolean;
+        invalidSince: number | null;
+        lastError: string | null;
+        pixels: Array<{
+            name: string;
+            pixelId: string;
+        }>;
+        status: "active" | "invalid";
+        adAccounts: {
+            adAccountId: string;
+            currency: string;
+            linkedOutsideScope?: boolean;
+            linkedSiteId: string | null;
+            name: string;
+            timezone: string;
+        }[];
+    } | null>>;
+    metaEventMap: import("convex/server").RegisteredQuery<"public", {
+        now?: number | undefined;
+        siteId: string;
+    }, Promise<{
+        columns: Array<{
+            color: string | null;
+            event: "Lead" | "QualifiedLead" | "Schedule" | null;
+            group: string | null;
+            key: string;
+            monthCount: number | null;
+            name: string;
+        }>;
+        purchase: {
+            enabled: boolean;
+        };
+        sendLeadEvent: boolean;
+    }>>;
+    metaUnlinkPreview: import("convex/server").RegisteredQuery<"public", {
+        adAccountId: string;
+        siteId: string;
+    }, Promise<{
+        campaigns: number;
+        currency: string;
+        days: number;
+        partial: boolean;
+        spendCents: number;
+    }>>;
+    authorizeMetaAction: import("convex/server").RegisteredQuery<"internal", {
+        siteId?: string | undefined;
+        wholeOwner?: boolean | undefined;
+    }, Promise<{
+        ownerKey: string;
+    }>>;
+    connectMeta: import("convex/server").RegisteredAction<"public", {
+        code: string;
+        redirectUri: string;
+    }, Promise<{
+        adAccounts: Array<{
+            adAccountId: string;
+            currency: string;
+            name: string;
+            timezone: string;
+        }>;
+        businessName: string | null;
+        connectionId: string;
+        pixels: Array<{
+            name: string;
+            pixelId: string;
+        }>;
+    }>>;
+    refreshMetaAccounts: import("convex/server").RegisteredAction<"public", {}, Promise<{
+        adAccountId: string;
+        currency: string;
+        name: string;
+        timezone: string;
+    }[]>>;
+    setMetaPixel: import("convex/server").RegisteredAction<"public", {
+        accessToken?: string | undefined;
+        enabled?: boolean | undefined;
+        pixelId: string;
+        sendLeadEvent?: boolean | undefined;
+        siteId: string;
+        testEventCode?: string | undefined;
+    }, Promise<{
+        ok: true;
+    }>>;
+    disconnectMeta: import("convex/server").RegisteredMutation<"public", {}, Promise<{
+        removed: boolean;
+    }>>;
+    linkMetaAdAccount: import("convex/server").RegisteredMutation<"public", {
+        adAccountId: string;
+        siteId: string;
+    }, Promise<{
+        linked: boolean;
+    }>>;
+    unlinkMetaAdAccount: import("convex/server").RegisteredMutation<"public", {
+        adAccountId: string;
+        siteId: string;
+    }, Promise<{
+        unlinked: boolean;
+    }>>;
+    removeMetaPixel: import("convex/server").RegisteredMutation<"public", {
+        siteId: string;
+    }, Promise<{
+        removed: boolean;
+    }>>;
+    setMetaEventMap: import("convex/server").RegisteredMutation<"public", {
+        columns: Record<string, "Lead" | "QualifiedLead" | "Schedule" | null>;
+        sendLeadEvent: boolean;
+        siteId: string;
+    }, Promise<null>>;
+    syncMetaNow: import("convex/server").RegisteredMutation<"public", {
+        siteId: string;
+    }, Promise<{
+        scheduled: boolean;
+    }>>;
     retentionStatus: import("convex/server").RegisteredQuery<"public", {
         siteId: string;
     }, Promise<{