@iann29/rastro 0.10.8 → 0.11.0

package/dist/component/leadAdsValidators.d.ts

@@ -0,0 +1,1092 @@
+import { type Infer } from "convex/values";
+/** One option of a choice question, as Meta lists it. */
+export declare const metaFormOptionValidator: import("convex/values").VObject<{
+    key: string;
+    value: string;
+}, {
+    key: import("convex/values").VString<string, "required">;
+    value: import("convex/values").VString<string, "required">;
+}, "required", "key" | "value">;
+/** One question of an instant form. `options` only on choice questions. */
+export declare const metaFormQuestionValidator: import("convex/values").VObject<{
+    key: string;
+    label: string;
+    options?: {
+        key: string;
+        value: string;
+    }[] | undefined;
+    type: string;
+}, {
+    key: import("convex/values").VString<string, "required">;
+    label: import("convex/values").VString<string, "required">;
+    /** Meta's type: `FULL_NAME`, `EMAIL`, `PHONE`, `CUSTOM`… */
+    type: import("convex/values").VString<string, "required">;
+    options: import("convex/values").VArray<{
+        key: string;
+        value: string;
+    }[] | undefined, import("convex/values").VObject<{
+        key: string;
+        value: string;
+    }, {
+        key: import("convex/values").VString<string, "required">;
+        value: import("convex/values").VString<string, "required">;
+    }, "required", "key" | "value">, "optional">;
+}, "required", "key" | "label" | "options" | "type">;
+/** Where a rule sends a lead: a board column, or the discard with a reason. */
+export declare const formRuleTargetValidator: import("convex/values").VUnion<{
+    column: string;
+} | {
+    discard: string;
+}, [import("convex/values").VObject<{
+    column: string;
+}, {
+    column: import("convex/values").VString<string, "required">;
+}, "required", "column">, import("convex/values").VObject<{
+    discard: string;
+}, {
+    discard: import("convex/values").VString<string, "required">;
+}, "required", "discard">], "required", "column" | "discard">;
+/** One rule: an answer to a choice question decides where the lead goes. */
+export declare const formRuleValidator: import("convex/values").VObject<{
+    answers: string[];
+    questionKey: string;
+    to: {
+        column: string;
+    } | {
+        discard: string;
+    };
+}, {
+    questionKey: import("convex/values").VString<string, "required">;
+    /** Option keys (or values) of the question; any of them matches. */
+    answers: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+    to: import("convex/values").VUnion<{
+        column: string;
+    } | {
+        discard: string;
+    }, [import("convex/values").VObject<{
+        column: string;
+    }, {
+        column: import("convex/values").VString<string, "required">;
+    }, "required", "column">, import("convex/values").VObject<{
+        discard: string;
+    }, {
+        discard: import("convex/values").VString<string, "required">;
+    }, "required", "discard">], "required", "column" | "discard">;
+}, "required", "answers" | "questionKey" | "to" | "to.column" | "to.discard">;
+/** The brakes on an automatic first message (the host's own sender). */
+export declare const firstContactBrakesValidator: import("convex/values").VObject<{
+    businessHoursOnly: boolean;
+    maxPerHour: number;
+    waitMinutes: number;
+}, {
+    waitMinutes: import("convex/values").VFloat64<number, "required">;
+    maxPerHour: import("convex/values").VFloat64<number, "required">;
+    businessHoursOnly: import("convex/values").VBoolean<boolean, "required">;
+}, "required", "businessHoursOnly" | "maxPerHour" | "waitMinutes">;
+/**
+ * How the host makes the first contact. `lead_starts`: the form's end screen
+ * has the WhatsApp button and the lead writes first (recommended);
+ * `one_click`: a person sends the suggested `text`; `automatic`: a scheduled
+ * send under `brakes`, which the host keeps off unless the business accepted
+ * the risk.
+ */
+export declare const firstContactValidator: import("convex/values").VObject<{
+    brakes?: {
+        businessHoursOnly: boolean;
+        maxPerHour: number;
+        waitMinutes: number;
+    } | undefined;
+    mode: "automatic" | "lead_starts" | "one_click";
+    text?: string | undefined;
+}, {
+    mode: import("convex/values").VUnion<"automatic" | "lead_starts" | "one_click", [import("convex/values").VLiteral<"lead_starts", "required">, import("convex/values").VLiteral<"one_click", "required">, import("convex/values").VLiteral<"automatic", "required">], "required", never>;
+    text: import("convex/values").VString<string | undefined, "optional">;
+    brakes: import("convex/values").VObject<{
+        businessHoursOnly: boolean;
+        maxPerHour: number;
+        waitMinutes: number;
+    } | undefined, {
+        waitMinutes: import("convex/values").VFloat64<number, "required">;
+        maxPerHour: import("convex/values").VFloat64<number, "required">;
+        businessHoursOnly: import("convex/values").VBoolean<boolean, "required">;
+    }, "optional", "businessHoursOnly" | "maxPerHour" | "waitMinutes">;
+}, "required", "brakes" | "brakes.businessHoursOnly" | "brakes.maxPerHour" | "brakes.waitMinutes" | "mode" | "text">;
+/**
+ * What the rules decided for a lead: a column (`null` is the host's own
+ * entry, when no rule matched and the form names no entry column), or the
+ * discard with its reason.
+ */
+export declare const formLeadDecisionValidator: import("convex/values").VUnion<{
+    column: string | null;
+} | {
+    discard: string;
+}, [import("convex/values").VObject<{
+    column: string | null;
+}, {
+    column: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+}, "required", "column">, import("convex/values").VObject<{
+    discard: string;
+}, {
+    discard: import("convex/values").VString<string, "required">;
+}, "required", "discard">], "required", "column" | "discard">;
+/** A choice answer as stored: the question and the option keys picked. */
+export declare const formChoiceAnswerValidator: import("convex/values").VObject<{
+    answers: string[];
+    questionKey: string;
+}, {
+    questionKey: import("convex/values").VString<string, "required">;
+    answers: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+}, "required", "answers" | "questionKey">;
+/** Where a form lead came from: the Page, the form and the ad. */
+export declare const formLeadOriginValidator: import("convex/values").VObject<{
+    adId: string | null;
+    adName: string | null;
+    adsetId: string | null;
+    adsetName: string | null;
+    campaignId: string | null;
+    campaignName: string | null;
+    formId: string;
+    formName: string | null;
+    isOrganic: boolean;
+    pageId: string;
+    pageName: string | null;
+    platform: string | null;
+}, {
+    pageId: import("convex/values").VString<string, "required">;
+    pageName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    formId: import("convex/values").VString<string, "required">;
+    formName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    adId: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    adName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    adsetId: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    adsetName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    campaignId: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    campaignName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    /** `fb` or `ig`, as Meta says where the form was filled. */
+    platform: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    isOrganic: import("convex/values").VBoolean<boolean, "required">;
+}, "required", "adId" | "adName" | "adsetId" | "adsetName" | "campaignId" | "campaignName" | "formId" | "formName" | "isOrganic" | "pageId" | "pageName" | "platform">;
+/** A choice answer with the labels the form shows. */
+export declare const formLabeledAnswerValidator: import("convex/values").VObject<{
+    label: string;
+    questionKey: string;
+    values: string[];
+}, {
+    questionKey: import("convex/values").VString<string, "required">;
+    label: import("convex/values").VString<string, "required">;
+    values: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+}, "required", "label" | "questionKey" | "values">;
+/**
+ * What the component hands the host's form lead handler (an internal
+ * mutation registered with `setFormLeadHandler`). `contact` and
+ * `freeAnswers` come from Meta in memory and are never stored by Rastro; the
+ * host owns the person from here. The handler must be idempotent on
+ * `leadgenId`.
+ */
+export declare const formLeadPayloadValidator: import("convex/values").VObject<{
+    answers: {
+        label: string;
+        questionKey: string;
+        values: string[];
+    }[];
+    contact: {
+        email: string | null;
+        name: string | null;
+        phone: string | null;
+    };
+    decision: {
+        column: string | null;
+    } | {
+        discard: string;
+    };
+    firstContact: {
+        brakes?: {
+            businessHoursOnly: boolean;
+            maxPerHour: number;
+            waitMinutes: number;
+        } | undefined;
+        mode: "automatic" | "lead_starts" | "one_click";
+        text?: string | undefined;
+    };
+    freeAnswers: {
+        label: string;
+        questionKey: string;
+        value: string;
+    }[];
+    leadId: string;
+    leadKey: string;
+    leadgenId: string;
+    origin: {
+        adId: string | null;
+        adName: string | null;
+        adsetId: string | null;
+        adsetName: string | null;
+        campaignId: string | null;
+        campaignName: string | null;
+        formId: string;
+        formName: string | null;
+        isOrganic: boolean;
+        pageId: string;
+        pageName: string | null;
+        platform: string | null;
+    };
+    receivedAt: number;
+    ruleIndex: number | null;
+    rulePath: number[];
+    siteId: string;
+}, {
+    siteId: import("convex/values").VString<string, "required">;
+    /** Rastro's lead; `leadKey` is what `setLeadStage` takes for it. */
+    leadId: import("convex/values").VString<string, "required">;
+    leadKey: import("convex/values").VString<string, "required">;
+    leadgenId: import("convex/values").VString<string, "required">;
+    /** When the lead submitted the form (Meta's `created_time`). */
+    receivedAt: import("convex/values").VFloat64<number, "required">;
+    contact: import("convex/values").VObject<{
+        email: string | null;
+        name: string | null;
+        phone: string | null;
+    }, {
+        name: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        /** As the lead typed it, usually with the country code (`+55…`). */
+        phone: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        email: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    }, "required", "email" | "name" | "phone">;
+    /** Answers typed freely (and any personal field besides the contact). */
+    freeAnswers: import("convex/values").VArray<{
+        label: string;
+        questionKey: string;
+        value: string;
+    }[], import("convex/values").VObject<{
+        label: string;
+        questionKey: string;
+        value: string;
+    }, {
+        questionKey: import("convex/values").VString<string, "required">;
+        label: import("convex/values").VString<string, "required">;
+        value: import("convex/values").VString<string, "required">;
+    }, "required", "label" | "questionKey" | "value">, "required">;
+    /** The choice answers, with the labels the form shows. */
+    answers: import("convex/values").VArray<{
+        label: string;
+        questionKey: string;
+        values: string[];
+    }[], import("convex/values").VObject<{
+        label: string;
+        questionKey: string;
+        values: string[];
+    }, {
+        questionKey: import("convex/values").VString<string, "required">;
+        label: import("convex/values").VString<string, "required">;
+        values: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+    }, "required", "label" | "questionKey" | "values">, "required">;
+    decision: import("convex/values").VUnion<{
+        column: string | null;
+    } | {
+        discard: string;
+    }, [import("convex/values").VObject<{
+        column: string | null;
+    }, {
+        column: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    }, "required", "column">, import("convex/values").VObject<{
+        discard: string;
+    }, {
+        discard: import("convex/values").VString<string, "required">;
+    }, "required", "discard">], "required", "column" | "discard">;
+    /** The rule indexes evaluated, in order; the last one decided if any did. */
+    rulePath: import("convex/values").VArray<number[], import("convex/values").VFloat64<number, "required">, "required">;
+    /** The rule that decided, or null when none matched. */
+    ruleIndex: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    origin: import("convex/values").VObject<{
+        adId: string | null;
+        adName: string | null;
+        adsetId: string | null;
+        adsetName: string | null;
+        campaignId: string | null;
+        campaignName: string | null;
+        formId: string;
+        formName: string | null;
+        isOrganic: boolean;
+        pageId: string;
+        pageName: string | null;
+        platform: string | null;
+    }, {
+        pageId: import("convex/values").VString<string, "required">;
+        pageName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        formId: import("convex/values").VString<string, "required">;
+        formName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        adId: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        adName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        adsetId: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        adsetName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        campaignId: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        campaignName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        /** `fb` or `ig`, as Meta says where the form was filled. */
+        platform: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        isOrganic: import("convex/values").VBoolean<boolean, "required">;
+    }, "required", "adId" | "adName" | "adsetId" | "adsetName" | "campaignId" | "campaignName" | "formId" | "formName" | "isOrganic" | "pageId" | "pageName" | "platform">;
+    firstContact: import("convex/values").VObject<{
+        brakes?: {
+            businessHoursOnly: boolean;
+            maxPerHour: number;
+            waitMinutes: number;
+        } | undefined;
+        mode: "automatic" | "lead_starts" | "one_click";
+        text?: string | undefined;
+    }, {
+        mode: import("convex/values").VUnion<"automatic" | "lead_starts" | "one_click", [import("convex/values").VLiteral<"lead_starts", "required">, import("convex/values").VLiteral<"one_click", "required">, import("convex/values").VLiteral<"automatic", "required">], "required", never>;
+        text: import("convex/values").VString<string | undefined, "optional">;
+        brakes: import("convex/values").VObject<{
+            businessHoursOnly: boolean;
+            maxPerHour: number;
+            waitMinutes: number;
+        } | undefined, {
+            waitMinutes: import("convex/values").VFloat64<number, "required">;
+            maxPerHour: import("convex/values").VFloat64<number, "required">;
+            businessHoursOnly: import("convex/values").VBoolean<boolean, "required">;
+        }, "optional", "businessHoursOnly" | "maxPerHour" | "waitMinutes">;
+    }, "required", "brakes" | "brakes.businessHoursOnly" | "brakes.maxPerHour" | "brakes.waitMinutes" | "mode" | "text">;
+}, "required", "answers" | "contact" | "contact.email" | "contact.name" | "contact.phone" | "decision" | "decision.column" | "decision.discard" | "firstContact" | "firstContact.brakes" | "firstContact.brakes.businessHoursOnly" | "firstContact.brakes.maxPerHour" | "firstContact.brakes.waitMinutes" | "firstContact.mode" | "firstContact.text" | "freeAnswers" | "leadId" | "leadKey" | "leadgenId" | "origin" | "origin.adId" | "origin.adName" | "origin.adsetId" | "origin.adsetName" | "origin.campaignId" | "origin.campaignName" | "origin.formId" | "origin.formName" | "origin.isOrganic" | "origin.pageId" | "origin.pageName" | "origin.platform" | "receivedAt" | "ruleIndex" | "rulePath" | "siteId">;
+/**
+ * What stops or slows a linked Page, as a code a screen maps to its own text
+ * (decision D6). Only `META_TOKEN_INVALID` and `META_PERMISSION_MISSING` are
+ * fixed by reconnecting Meta (the second also covers a Page the login no
+ * longer lists). `HANDLER_MISSING`, `HANDLER_FAILED` and `HANDLER_GAVE_UP`
+ * are the host's (no form lead handler; it throws and the lead is read again;
+ * it threw too often and the lead was skipped for good); `SECRETS_KEY_MISSING`
+ * is the host's env.
+ * `META_TRUNCATED`, `META_RATE_LIMITED`, `META_UNAVAILABLE` and `RUN_TIMEOUT`
+ * pass by themselves: the next run goes on.
+ */
+export declare const META_PAGE_ERROR_CODES: readonly ["META_TOKEN_INVALID", "META_PERMISSION_MISSING", "HANDLER_MISSING", "HANDLER_FAILED", "HANDLER_GAVE_UP", "SECRETS_KEY_MISSING", "META_TRUNCATED", "META_RATE_LIMITED", "META_UNAVAILABLE", "RUN_TIMEOUT"];
+export type MetaPageErrorCode = (typeof META_PAGE_ERROR_CODES)[number];
+export declare const metaPageErrorCodeValidator: import("convex/values").VUnion<"HANDLER_FAILED" | "HANDLER_GAVE_UP" | "HANDLER_MISSING" | "META_PERMISSION_MISSING" | "META_RATE_LIMITED" | "META_TOKEN_INVALID" | "META_TRUNCATED" | "META_UNAVAILABLE" | "RUN_TIMEOUT" | "SECRETS_KEY_MISSING", [import("convex/values").VLiteral<"META_TOKEN_INVALID", "required">, import("convex/values").VLiteral<"META_PERMISSION_MISSING", "required">, import("convex/values").VLiteral<"HANDLER_MISSING", "required">, import("convex/values").VLiteral<"HANDLER_FAILED", "required">, import("convex/values").VLiteral<"HANDLER_GAVE_UP", "required">, import("convex/values").VLiteral<"SECRETS_KEY_MISSING", "required">, import("convex/values").VLiteral<"META_TRUNCATED", "required">, import("convex/values").VLiteral<"META_RATE_LIMITED", "required">, import("convex/values").VLiteral<"META_UNAVAILABLE", "required">, import("convex/values").VLiteral<"RUN_TIMEOUT", "required">], "required", never>;
+/** What `metaLinkedPages` answers the control plane (decision D1). */
+export declare const linkedPagesValidator: import("convex/values").VObject<{
+    audience: string | null;
+    handlerReady: boolean;
+    issuer: string;
+    leadgenReady: boolean;
+    pages: {
+        pageId: string;
+        siteId: string;
+    }[];
+}, {
+    pages: import("convex/values").VArray<{
+        pageId: string;
+        siteId: string;
+    }[], import("convex/values").VObject<{
+        pageId: string;
+        siteId: string;
+    }, {
+        pageId: import("convex/values").VString<string, "required">;
+        siteId: import("convex/values").VString<string, "required">;
+    }, "required", "pageId" | "siteId">, "required">;
+    /**
+     * The component has `RASTRO_FEDERATION_AUDIENCE`: its leadgen route can
+     * verify a forward. False, every forward would answer `503`.
+     */
+    leadgenReady: import("convex/values").VBoolean<boolean, "required">;
+    /** The issuer the leadgen route verifies forwards against. */
+    issuer: import("convex/values").VString<string, "required">;
+    /**
+     * The audience the leadgen route expects (`RASTRO_FEDERATION_AUDIENCE`,
+     * without a trailing slash), or null when it has none.
+     */
+    audience: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    /**
+     * The host registered its form lead handler (the Lead Ads opt-in). False,
+     * the component reads no Pages: the list stays empty until it does, and
+     * reconnecting Meta changes nothing.
+     */
+    handlerReady: import("convex/values").VBoolean<boolean, "required">;
+}, "required", "audience" | "handlerReady" | "issuer" | "leadgenReady" | "pages">;
+/** A Page an owner's Meta connection lists, as a screen shows it. */
+export declare const metaPageValidator: import("convex/values").VObject<{
+    handlerReady: boolean;
+    lastError: "HANDLER_FAILED" | "HANDLER_GAVE_UP" | "HANDLER_MISSING" | "META_PERMISSION_MISSING" | "META_RATE_LIMITED" | "META_TOKEN_INVALID" | "META_TRUNCATED" | "META_UNAVAILABLE" | "RUN_TIMEOUT" | "SECRETS_KEY_MISSING" | null;
+    leadsAllowed: boolean;
+    linkedOutsideScope?: boolean | undefined;
+    linkedSiteId: string | null;
+    name: string;
+    own: boolean | null;
+    pageId: string;
+    subscribedAt: number | null;
+    tasks: string[];
+}, {
+    pageId: import("convex/values").VString<string, "required">;
+    name: import("convex/values").VString<string, "required">;
+    tasks: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+    /** Meta granted `leads_retrieval` for the Page to this login. */
+    leadsAllowed: import("convex/values").VBoolean<boolean, "required">;
+    /** The site the Page feeds, whoever linked it; null when free. */
+    linkedSiteId: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    /** Federated reads only: linked to a site outside the caller's grant. */
+    linkedOutsideScope: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    /** Whether this owner linked it; null while the Page is free. */
+    own: import("convex/values").VUnion<boolean | null, [import("convex/values").VBoolean<boolean, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    subscribedAt: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    /**
+     * What stops or slows the Page, as a code (`META_PAGE_ERROR_CODES`): Meta
+     * refused its token or lead access, or, for a Page this owner linked, the
+     * host's handler or the last reconciliation. Null when nothing does.
+     */
+    lastError: import("convex/values").VUnion<"HANDLER_FAILED" | "HANDLER_GAVE_UP" | "HANDLER_MISSING" | "META_PERMISSION_MISSING" | "META_RATE_LIMITED" | "META_TOKEN_INVALID" | "META_TRUNCATED" | "META_UNAVAILABLE" | "RUN_TIMEOUT" | "SECRETS_KEY_MISSING" | null, [import("convex/values").VUnion<"HANDLER_FAILED" | "HANDLER_GAVE_UP" | "HANDLER_MISSING" | "META_PERMISSION_MISSING" | "META_RATE_LIMITED" | "META_TOKEN_INVALID" | "META_TRUNCATED" | "META_UNAVAILABLE" | "RUN_TIMEOUT" | "SECRETS_KEY_MISSING", [import("convex/values").VLiteral<"META_TOKEN_INVALID", "required">, import("convex/values").VLiteral<"META_PERMISSION_MISSING", "required">, import("convex/values").VLiteral<"HANDLER_MISSING", "required">, import("convex/values").VLiteral<"HANDLER_FAILED", "required">, import("convex/values").VLiteral<"HANDLER_GAVE_UP", "required">, import("convex/values").VLiteral<"SECRETS_KEY_MISSING", "required">, import("convex/values").VLiteral<"META_TRUNCATED", "required">, import("convex/values").VLiteral<"META_RATE_LIMITED", "required">, import("convex/values").VLiteral<"META_UNAVAILABLE", "required">, import("convex/values").VLiteral<"RUN_TIMEOUT", "required">], "required", never>, import("convex/values").VNull<null, "required">], "required", never>;
+    /** Whether the host registered its form lead handler (no lead comes in without it). */
+    handlerReady: import("convex/values").VBoolean<boolean, "required">;
+}, "required", "handlerReady" | "lastError" | "leadsAllowed" | "linkedOutsideScope" | "linkedSiteId" | "name" | "own" | "pageId" | "subscribedAt" | "tasks">;
+/** One instant form of a Page linked to the site, for the forms screen. */
+export declare const metaFormRowValidator: import("convex/values").VObject<{
+    createdTime: number | null;
+    daily: number[] | null;
+    formId: string;
+    lastLeadAt: number | null;
+    leads30d: number | null;
+    name: string;
+    questions: {
+        key: string;
+        label: string;
+        options?: {
+            key: string;
+            value: string;
+        }[] | undefined;
+        type: string;
+    }[];
+    rules: {
+        configured: boolean;
+        count: number;
+        entryColumn: string | null;
+        own?: boolean | undefined;
+    };
+    status: string;
+    syncedAt: number;
+    whatsappButton: boolean | null;
+    whatsappButtonConfirmed: boolean;
+}, {
+    formId: import("convex/values").VString<string, "required">;
+    name: import("convex/values").VString<string, "required">;
+    /** Meta's status: `ACTIVE`, `ARCHIVED`, `DELETED`, `DRAFT`. */
+    status: import("convex/values").VString<string, "required">;
+    questions: import("convex/values").VArray<{
+        key: string;
+        label: string;
+        options?: {
+            key: string;
+            value: string;
+        }[] | undefined;
+        type: string;
+    }[], import("convex/values").VObject<{
+        key: string;
+        label: string;
+        options?: {
+            key: string;
+            value: string;
+        }[] | undefined;
+        type: string;
+    }, {
+        key: import("convex/values").VString<string, "required">;
+        label: import("convex/values").VString<string, "required">;
+        /** Meta's type: `FULL_NAME`, `EMAIL`, `PHONE`, `CUSTOM`… */
+        type: import("convex/values").VString<string, "required">;
+        options: import("convex/values").VArray<{
+            key: string;
+            value: string;
+        }[] | undefined, import("convex/values").VObject<{
+            key: string;
+            value: string;
+        }, {
+            key: import("convex/values").VString<string, "required">;
+            value: import("convex/values").VString<string, "required">;
+        }, "required", "key" | "value">, "optional">;
+    }, "required", "key" | "label" | "options" | "type">, "required">;
+    /** The end screen's WhatsApp button; null when Meta does not say. */
+    whatsappButton: import("convex/values").VUnion<boolean | null, [import("convex/values").VBoolean<boolean, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    /** The host marked the button as set by hand ("Já liguei"). */
+    whatsappButtonConfirmed: import("convex/values").VBoolean<boolean, "required">;
+    createdTime: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    syncedAt: import("convex/values").VFloat64<number, "required">;
+    /** Leads in the 30 UTC days up to `now`; null without `now`. */
+    leads30d: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    /** Those leads per UTC day, oldest first (30 entries); null without `now`. */
+    daily: import("convex/values").VUnion<number[] | null, [import("convex/values").VArray<number[], import("convex/values").VFloat64<number, "required">, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    lastLeadAt: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    rules: import("convex/values").VObject<{
+        configured: boolean;
+        count: number;
+        entryColumn: string | null;
+        own?: boolean | undefined;
+    }, {
+        configured: import("convex/values").VBoolean<boolean, "required">;
+        count: import("convex/values").VFloat64<number, "required">;
+        entryColumn: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        /** With an owner: whether that owner may edit them (not another's). */
+        own: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    }, "required", "configured" | "count" | "entryColumn" | "own">;
+}, "required", "createdTime" | "daily" | "formId" | "lastLeadAt" | "leads30d" | "name" | "questions" | "rules" | "rules.configured" | "rules.count" | "rules.entryColumn" | "rules.own" | "status" | "syncedAt" | "whatsappButton" | "whatsappButtonConfirmed">;
+/** The Pages linked to a site, each with its forms. */
+export declare const metaFormsValidator: import("convex/values").VArray<{
+    forms: {
+        createdTime: number | null;
+        daily: number[] | null;
+        formId: string;
+        lastLeadAt: number | null;
+        leads30d: number | null;
+        name: string;
+        questions: {
+            key: string;
+            label: string;
+            options?: {
+                key: string;
+                value: string;
+            }[] | undefined;
+            type: string;
+        }[];
+        rules: {
+            configured: boolean;
+            count: number;
+            entryColumn: string | null;
+            own?: boolean | undefined;
+        };
+        status: string;
+        syncedAt: number;
+        whatsappButton: boolean | null;
+        whatsappButtonConfirmed: boolean;
+    }[];
+    handlerReady: boolean;
+    lastError: "HANDLER_FAILED" | "HANDLER_GAVE_UP" | "HANDLER_MISSING" | "META_PERMISSION_MISSING" | "META_RATE_LIMITED" | "META_TOKEN_INVALID" | "META_TRUNCATED" | "META_UNAVAILABLE" | "RUN_TIMEOUT" | "SECRETS_KEY_MISSING" | null;
+    lastLeadAt: number | null;
+    lastReconcileAt: number | null;
+    leadsAllowed: boolean;
+    own?: boolean | undefined;
+    pageId: string;
+    pageName: string;
+    subscribedAt: number | null;
+}[], import("convex/values").VObject<{
+    forms: {
+        createdTime: number | null;
+        daily: number[] | null;
+        formId: string;
+        lastLeadAt: number | null;
+        leads30d: number | null;
+        name: string;
+        questions: {
+            key: string;
+            label: string;
+            options?: {
+                key: string;
+                value: string;
+            }[] | undefined;
+            type: string;
+        }[];
+        rules: {
+            configured: boolean;
+            count: number;
+            entryColumn: string | null;
+            own?: boolean | undefined;
+        };
+        status: string;
+        syncedAt: number;
+        whatsappButton: boolean | null;
+        whatsappButtonConfirmed: boolean;
+    }[];
+    handlerReady: boolean;
+    lastError: "HANDLER_FAILED" | "HANDLER_GAVE_UP" | "HANDLER_MISSING" | "META_PERMISSION_MISSING" | "META_RATE_LIMITED" | "META_TOKEN_INVALID" | "META_TRUNCATED" | "META_UNAVAILABLE" | "RUN_TIMEOUT" | "SECRETS_KEY_MISSING" | null;
+    lastLeadAt: number | null;
+    lastReconcileAt: number | null;
+    leadsAllowed: boolean;
+    own?: boolean | undefined;
+    pageId: string;
+    pageName: string;
+    subscribedAt: number | null;
+}, {
+    pageId: import("convex/values").VString<string, "required">;
+    pageName: import("convex/values").VString<string, "required">;
+    leadsAllowed: import("convex/values").VBoolean<boolean, "required">;
+    subscribedAt: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    lastReconcileAt: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    lastLeadAt: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    /** As on `metaPages`: a code of `META_PAGE_ERROR_CODES`, or null. */
+    lastError: import("convex/values").VUnion<"HANDLER_FAILED" | "HANDLER_GAVE_UP" | "HANDLER_MISSING" | "META_PERMISSION_MISSING" | "META_RATE_LIMITED" | "META_TOKEN_INVALID" | "META_TRUNCATED" | "META_UNAVAILABLE" | "RUN_TIMEOUT" | "SECRETS_KEY_MISSING" | null, [import("convex/values").VUnion<"HANDLER_FAILED" | "HANDLER_GAVE_UP" | "HANDLER_MISSING" | "META_PERMISSION_MISSING" | "META_RATE_LIMITED" | "META_TOKEN_INVALID" | "META_TRUNCATED" | "META_UNAVAILABLE" | "RUN_TIMEOUT" | "SECRETS_KEY_MISSING", [import("convex/values").VLiteral<"META_TOKEN_INVALID", "required">, import("convex/values").VLiteral<"META_PERMISSION_MISSING", "required">, import("convex/values").VLiteral<"HANDLER_MISSING", "required">, import("convex/values").VLiteral<"HANDLER_FAILED", "required">, import("convex/values").VLiteral<"HANDLER_GAVE_UP", "required">, import("convex/values").VLiteral<"SECRETS_KEY_MISSING", "required">, import("convex/values").VLiteral<"META_TRUNCATED", "required">, import("convex/values").VLiteral<"META_RATE_LIMITED", "required">, import("convex/values").VLiteral<"META_UNAVAILABLE", "required">, import("convex/values").VLiteral<"RUN_TIMEOUT", "required">], "required", never>, import("convex/values").VNull<null, "required">], "required", never>;
+    /** With an owner: whether that owner linked the Page. */
+    own: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    /** Whether the host registered its form lead handler. */
+    handlerReady: import("convex/values").VBoolean<boolean, "required">;
+    forms: import("convex/values").VArray<{
+        createdTime: number | null;
+        daily: number[] | null;
+        formId: string;
+        lastLeadAt: number | null;
+        leads30d: number | null;
+        name: string;
+        questions: {
+            key: string;
+            label: string;
+            options?: {
+                key: string;
+                value: string;
+            }[] | undefined;
+            type: string;
+        }[];
+        rules: {
+            configured: boolean;
+            count: number;
+            entryColumn: string | null;
+            own?: boolean | undefined;
+        };
+        status: string;
+        syncedAt: number;
+        whatsappButton: boolean | null;
+        whatsappButtonConfirmed: boolean;
+    }[], import("convex/values").VObject<{
+        createdTime: number | null;
+        daily: number[] | null;
+        formId: string;
+        lastLeadAt: number | null;
+        leads30d: number | null;
+        name: string;
+        questions: {
+            key: string;
+            label: string;
+            options?: {
+                key: string;
+                value: string;
+            }[] | undefined;
+            type: string;
+        }[];
+        rules: {
+            configured: boolean;
+            count: number;
+            entryColumn: string | null;
+            own?: boolean | undefined;
+        };
+        status: string;
+        syncedAt: number;
+        whatsappButton: boolean | null;
+        whatsappButtonConfirmed: boolean;
+    }, {
+        formId: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VString<string, "required">;
+        /** Meta's status: `ACTIVE`, `ARCHIVED`, `DELETED`, `DRAFT`. */
+        status: import("convex/values").VString<string, "required">;
+        questions: import("convex/values").VArray<{
+            key: string;
+            label: string;
+            options?: {
+                key: string;
+                value: string;
+            }[] | undefined;
+            type: string;
+        }[], import("convex/values").VObject<{
+            key: string;
+            label: string;
+            options?: {
+                key: string;
+                value: string;
+            }[] | undefined;
+            type: string;
+        }, {
+            key: import("convex/values").VString<string, "required">;
+            label: import("convex/values").VString<string, "required">;
+            /** Meta's type: `FULL_NAME`, `EMAIL`, `PHONE`, `CUSTOM`… */
+            type: import("convex/values").VString<string, "required">;
+            options: import("convex/values").VArray<{
+                key: string;
+                value: string;
+            }[] | undefined, import("convex/values").VObject<{
+                key: string;
+                value: string;
+            }, {
+                key: import("convex/values").VString<string, "required">;
+                value: import("convex/values").VString<string, "required">;
+            }, "required", "key" | "value">, "optional">;
+        }, "required", "key" | "label" | "options" | "type">, "required">;
+        /** The end screen's WhatsApp button; null when Meta does not say. */
+        whatsappButton: import("convex/values").VUnion<boolean | null, [import("convex/values").VBoolean<boolean, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        /** The host marked the button as set by hand ("Já liguei"). */
+        whatsappButtonConfirmed: import("convex/values").VBoolean<boolean, "required">;
+        createdTime: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        syncedAt: import("convex/values").VFloat64<number, "required">;
+        /** Leads in the 30 UTC days up to `now`; null without `now`. */
+        leads30d: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        /** Those leads per UTC day, oldest first (30 entries); null without `now`. */
+        daily: import("convex/values").VUnion<number[] | null, [import("convex/values").VArray<number[], import("convex/values").VFloat64<number, "required">, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        lastLeadAt: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        rules: import("convex/values").VObject<{
+            configured: boolean;
+            count: number;
+            entryColumn: string | null;
+            own?: boolean | undefined;
+        }, {
+            configured: import("convex/values").VBoolean<boolean, "required">;
+            count: import("convex/values").VFloat64<number, "required">;
+            entryColumn: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+            /** With an owner: whether that owner may edit them (not another's). */
+            own: import("convex/values").VBoolean<boolean | undefined, "optional">;
+        }, "required", "configured" | "count" | "entryColumn" | "own">;
+    }, "required", "createdTime" | "daily" | "formId" | "lastLeadAt" | "leads30d" | "name" | "questions" | "rules" | "rules.configured" | "rules.count" | "rules.entryColumn" | "rules.own" | "status" | "syncedAt" | "whatsappButton" | "whatsappButtonConfirmed">, "required">;
+}, "required", "forms" | "handlerReady" | "lastError" | "lastLeadAt" | "lastReconcileAt" | "leadsAllowed" | "own" | "pageId" | "pageName" | "subscribedAt">, "required">;
+/** A form's rules as the drawer edits them, each with its monthly count. */
+export declare const formRulesValidator: import("convex/values").VObject<{
+    configured: boolean;
+    entryColumn: string | null;
+    firstContact: {
+        brakes?: {
+            businessHoursOnly: boolean;
+            maxPerHour: number;
+            waitMinutes: number;
+        } | undefined;
+        mode: "automatic" | "lead_starts" | "one_click";
+        text?: string | undefined;
+    };
+    formId: string;
+    own?: boolean | undefined;
+    rules: {
+        answers: string[];
+        monthCount: number | null;
+        questionKey: string;
+        to: {
+            column: string;
+        } | {
+            discard: string;
+        };
+    }[];
+    siteId: string;
+    updatedAt: number | null;
+    whatsappButtonConfirmed: boolean;
+}, {
+    siteId: import("convex/values").VString<string, "required">;
+    formId: import("convex/values").VString<string, "required">;
+    configured: import("convex/values").VBoolean<boolean, "required">;
+    entryColumn: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    rules: import("convex/values").VArray<{
+        answers: string[];
+        monthCount: number | null;
+        questionKey: string;
+        to: {
+            column: string;
+        } | {
+            discard: string;
+        };
+    }[], import("convex/values").VObject<{
+        answers: string[];
+        monthCount: number | null;
+        questionKey: string;
+        to: {
+            column: string;
+        } | {
+            discard: string;
+        };
+    }, {
+        questionKey: import("convex/values").VString<string, "required">;
+        /** Option keys (or values) of the question; any of them matches. */
+        answers: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+        to: import("convex/values").VUnion<{
+            column: string;
+        } | {
+            discard: string;
+        }, [import("convex/values").VObject<{
+            column: string;
+        }, {
+            column: import("convex/values").VString<string, "required">;
+        }, "required", "column">, import("convex/values").VObject<{
+            discard: string;
+        }, {
+            discard: import("convex/values").VString<string, "required">;
+        }, "required", "discard">], "required", "column" | "discard">;
+        /** Leads this rule decided in the 30 days up to `now`; null without. */
+        monthCount: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    }, "required", "answers" | "monthCount" | "questionKey" | "to" | "to.column" | "to.discard">, "required">;
+    firstContact: import("convex/values").VObject<{
+        brakes?: {
+            businessHoursOnly: boolean;
+            maxPerHour: number;
+            waitMinutes: number;
+        } | undefined;
+        mode: "automatic" | "lead_starts" | "one_click";
+        text?: string | undefined;
+    }, {
+        mode: import("convex/values").VUnion<"automatic" | "lead_starts" | "one_click", [import("convex/values").VLiteral<"lead_starts", "required">, import("convex/values").VLiteral<"one_click", "required">, import("convex/values").VLiteral<"automatic", "required">], "required", never>;
+        text: import("convex/values").VString<string | undefined, "optional">;
+        brakes: import("convex/values").VObject<{
+            businessHoursOnly: boolean;
+            maxPerHour: number;
+            waitMinutes: number;
+        } | undefined, {
+            waitMinutes: import("convex/values").VFloat64<number, "required">;
+            maxPerHour: import("convex/values").VFloat64<number, "required">;
+            businessHoursOnly: import("convex/values").VBoolean<boolean, "required">;
+        }, "optional", "businessHoursOnly" | "maxPerHour" | "waitMinutes">;
+    }, "required", "brakes" | "brakes.businessHoursOnly" | "brakes.maxPerHour" | "brakes.waitMinutes" | "mode" | "text">;
+    whatsappButtonConfirmed: import("convex/values").VBoolean<boolean, "required">;
+    updatedAt: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    /** With an owner: whether that owner may edit them (not another's). */
+    own: import("convex/values").VBoolean<boolean | undefined, "optional">;
+}, "required", "configured" | "entryColumn" | "firstContact" | "firstContact.brakes" | "firstContact.brakes.businessHoursOnly" | "firstContact.brakes.maxPerHour" | "firstContact.brakes.waitMinutes" | "firstContact.mode" | "firstContact.text" | "formId" | "own" | "rules" | "siteId" | "updatedAt" | "whatsappButtonConfirmed">;
+/** The last 30 days' leads of a form under a draft of its rules. */
+export declare const formRulesSimulationValidator: import("convex/values").VObject<{
+    columns: {
+        column: string;
+        leads: number;
+    }[];
+    discarded: {
+        leads: number;
+        reason: string;
+    }[];
+    entry: number;
+    partial: boolean;
+    rules: number[];
+    total: number;
+}, {
+    total: import("convex/values").VFloat64<number, "required">;
+    /**
+     * Leads no rule matched: they go to the entry. Unlike `formsReport`'s
+     * `entry`, this counts them whether or not the draft names an entry column.
+     */
+    entry: import("convex/values").VFloat64<number, "required">;
+    /** Per draft rule, in order: the leads it would decide. */
+    rules: import("convex/values").VArray<number[], import("convex/values").VFloat64<number, "required">, "required">;
+    /**
+     * Leads per column the draft sends them to. With an `entryColumn`, its row
+     * already holds the `entry` leads: add `entry` only when no row names it.
+     */
+    columns: import("convex/values").VArray<{
+        column: string;
+        leads: number;
+    }[], import("convex/values").VObject<{
+        column: string;
+        leads: number;
+    }, {
+        column: import("convex/values").VString<string, "required">;
+        leads: import("convex/values").VFloat64<number, "required">;
+    }, "required", "column" | "leads">, "required">;
+    discarded: import("convex/values").VArray<{
+        leads: number;
+        reason: string;
+    }[], import("convex/values").VObject<{
+        leads: number;
+        reason: string;
+    }, {
+        reason: import("convex/values").VString<string, "required">;
+        leads: import("convex/values").VFloat64<number, "required">;
+    }, "required", "leads" | "reason">, "required">;
+    /** A read cap was hit: the figures cover the newest leads only. */
+    partial: import("convex/values").VBoolean<boolean, "required">;
+}, "required", "columns" | "discarded" | "entry" | "partial" | "rules" | "total">;
+/**
+ * Per form: its leads in the range and where the rules sent them. One row per
+ * (siteId, formId): a Page moved from one site to another inside the range
+ * has a row for each, so key rows by both. The range is whole UTC days:
+ * `from` floors to its day and `to` takes in the UTC day it falls on.
+ */
+export declare const formsReportValidator: import("convex/values").VObject<{
+    forms: {
+        columns: {
+            column: string;
+            leads: number;
+        }[];
+        discarded: {
+            leads: number;
+            reason: string;
+        }[];
+        entry: number;
+        formId: string;
+        leads: number;
+        name: string | null;
+        pageId: string;
+        qualified: number;
+        returned: number;
+        revenueCents: number;
+        siteId: string;
+        won: number;
+    }[];
+    partial: boolean;
+}, {
+    forms: import("convex/values").VArray<{
+        columns: {
+            column: string;
+            leads: number;
+        }[];
+        discarded: {
+            leads: number;
+            reason: string;
+        }[];
+        entry: number;
+        formId: string;
+        leads: number;
+        name: string | null;
+        pageId: string;
+        qualified: number;
+        returned: number;
+        revenueCents: number;
+        siteId: string;
+        won: number;
+    }[], import("convex/values").VObject<{
+        columns: {
+            column: string;
+            leads: number;
+        }[];
+        discarded: {
+            leads: number;
+            reason: string;
+        }[];
+        entry: number;
+        formId: string;
+        leads: number;
+        name: string | null;
+        pageId: string;
+        qualified: number;
+        returned: number;
+        revenueCents: number;
+        siteId: string;
+        won: number;
+    }, {
+        leads: import("convex/values").VFloat64<number, "required">;
+        qualified: import("convex/values").VFloat64<number, "required">;
+        won: import("convex/values").VFloat64<number, "required">;
+        revenueCents: import("convex/values").VFloat64<number, "required">;
+        siteId: import("convex/values").VString<string, "required">;
+        pageId: import("convex/values").VString<string, "required">;
+        formId: import("convex/values").VString<string, "required">;
+        name: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        /** Leads a rule (or the entry column) sent to each column. */
+        columns: import("convex/values").VArray<{
+            column: string;
+            leads: number;
+        }[], import("convex/values").VObject<{
+            column: string;
+            leads: number;
+        }, {
+            column: import("convex/values").VString<string, "required">;
+            leads: import("convex/values").VFloat64<number, "required">;
+        }, "required", "column" | "leads">, "required">;
+        /** Leads that went to the host's own entry (no column named). */
+        entry: import("convex/values").VFloat64<number, "required">;
+        discarded: import("convex/values").VArray<{
+            leads: number;
+            reason: string;
+        }[], import("convex/values").VObject<{
+            leads: number;
+            reason: string;
+        }, {
+            reason: import("convex/values").VString<string, "required">;
+            leads: import("convex/values").VFloat64<number, "required">;
+        }, "required", "leads" | "reason">, "required">;
+        /** Discarded leads someone sent back to the funnel. */
+        returned: import("convex/values").VFloat64<number, "required">;
+    }, "required", "columns" | "discarded" | "entry" | "formId" | "leads" | "name" | "pageId" | "qualified" | "returned" | "revenueCents" | "siteId" | "won">, "required">;
+    /** A read cap was hit: the decision counts are a lower bound. */
+    partial: import("convex/values").VBoolean<boolean, "required">;
+}, "required", "forms" | "partial">;
+/** A form lead as the journey shows it: answers, origin and the path. */
+export declare const formLeadDetailValidator: import("convex/values").VObject<{
+    answers: {
+        label: string;
+        questionKey: string;
+        values: string[];
+    }[];
+    decision: {
+        column: string | null;
+    } | {
+        discard: string;
+    };
+    leadgenId: string;
+    origin: {
+        adId: string | null;
+        adName: string | null;
+        adsetId: string | null;
+        adsetName: string | null;
+        campaignId: string | null;
+        campaignName: string | null;
+        formId: string;
+        formName: string | null;
+        isOrganic: boolean;
+        pageId: string;
+        pageName: string | null;
+        platform: string | null;
+    };
+    receivedAt: number;
+    returned: {
+        at: number;
+        reason: string;
+    } | null;
+    ruleIndex: number | null;
+    rulePath: number[];
+}, {
+    leadgenId: import("convex/values").VString<string, "required">;
+    receivedAt: import("convex/values").VFloat64<number, "required">;
+    origin: import("convex/values").VObject<{
+        adId: string | null;
+        adName: string | null;
+        adsetId: string | null;
+        adsetName: string | null;
+        campaignId: string | null;
+        campaignName: string | null;
+        formId: string;
+        formName: string | null;
+        isOrganic: boolean;
+        pageId: string;
+        pageName: string | null;
+        platform: string | null;
+    }, {
+        pageId: import("convex/values").VString<string, "required">;
+        pageName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        formId: import("convex/values").VString<string, "required">;
+        formName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        adId: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        adName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        adsetId: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        adsetName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        campaignId: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        campaignName: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        /** `fb` or `ig`, as Meta says where the form was filled. */
+        platform: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+        isOrganic: import("convex/values").VBoolean<boolean, "required">;
+    }, "required", "adId" | "adName" | "adsetId" | "adsetName" | "campaignId" | "campaignName" | "formId" | "formName" | "isOrganic" | "pageId" | "pageName" | "platform">;
+    answers: import("convex/values").VArray<{
+        label: string;
+        questionKey: string;
+        values: string[];
+    }[], import("convex/values").VObject<{
+        label: string;
+        questionKey: string;
+        values: string[];
+    }, {
+        questionKey: import("convex/values").VString<string, "required">;
+        label: import("convex/values").VString<string, "required">;
+        values: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+    }, "required", "label" | "questionKey" | "values">, "required">;
+    decision: import("convex/values").VUnion<{
+        column: string | null;
+    } | {
+        discard: string;
+    }, [import("convex/values").VObject<{
+        column: string | null;
+    }, {
+        column: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    }, "required", "column">, import("convex/values").VObject<{
+        discard: string;
+    }, {
+        discard: import("convex/values").VString<string, "required">;
+    }, "required", "discard">], "required", "column" | "discard">;
+    rulePath: import("convex/values").VArray<number[], import("convex/values").VFloat64<number, "required">, "required">;
+    ruleIndex: import("convex/values").VUnion<number | null, [import("convex/values").VFloat64<number, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+    /** When a discarded lead was sent back, and the reason it had. */
+    returned: import("convex/values").VUnion<{
+        at: number;
+        reason: string;
+    } | null, [import("convex/values").VObject<{
+        at: number;
+        reason: string;
+    }, {
+        at: import("convex/values").VFloat64<number, "required">;
+        reason: import("convex/values").VString<string, "required">;
+    }, "required", "at" | "reason">, import("convex/values").VNull<null, "required">], "required", "at" | "reason">;
+}, "required", "answers" | "decision" | "decision.column" | "decision.discard" | "leadgenId" | "origin" | "origin.adId" | "origin.adName" | "origin.adsetId" | "origin.adsetName" | "origin.campaignId" | "origin.campaignName" | "origin.formId" | "origin.formName" | "origin.isOrganic" | "origin.pageId" | "origin.pageName" | "origin.platform" | "receivedAt" | "returned" | "returned.at" | "returned.reason" | "ruleIndex" | "rulePath">;
+export type FormRule = Infer<typeof formRuleValidator>;
+export type FormRuleTarget = Infer<typeof formRuleTargetValidator>;
+export type FirstContact = Infer<typeof firstContactValidator>;
+export type FormLeadDecision = Infer<typeof formLeadDecisionValidator>;
+export type FormLeadPayload = Infer<typeof formLeadPayloadValidator>;
+export type MetaFormQuestion = Infer<typeof metaFormQuestionValidator>;
+export type FormChoiceAnswer = Infer<typeof formChoiceAnswerValidator>;
+//# sourceMappingURL=leadAdsValidators.d.ts.map