@getlatedev/node 0.2.389 → 0.2.391

package/src/generated/types.gen.ts

@@ -3910,6 +3910,43 @@ export type ReviewWebhookReview = {
  */
 export type platform4 = 'googlebusiness';
 
+/**
+ * A Meta Reach & Frequency prediction. Money values in whole units of the ad account currency.
+ */
+export type RfPrediction = {
+    predictionId?: string;
+    /**
+     * ready | pending | failed:<meta code>
+     */
+    status?: string;
+    /**
+     * Quoted (or provided) lifetime budget for the window.
+     */
+    budget?: (number) | null;
+    /**
+     * Predicted (or requested) unique reach.
+     */
+    reach?: (number) | null;
+    impressions?: (number) | null;
+    /**
+     * Meta's allowed lower bound for this spec.
+     */
+    minBudget?: (number) | null;
+    maxBudget?: (number) | null;
+    minReach?: (number) | null;
+    maxReach?: (number) | null;
+    frequencyCap?: (number) | null;
+    /**
+     * Unix seconds; the reserved window the R&F ad set will run on.
+     */
+    startTime?: (number) | null;
+    stopTime?: (number) | null;
+    /**
+     * When the reservation's locked price expires (set after reserving).
+     */
+    expiresAt?: (string) | null;
+};
+
 /**
  * An ad account a tracking tag is shared with (Meta `shared_accounts` edge).
  */
@@ -23708,6 +23745,38 @@ export type DuplicateAdCampaignError = (unknown | {
     error?: string;
 });
 
+export type GetAdSetDetailsData = {
+    path: {
+        /**
+         * Meta ad set id (platformAdSetId).
+         */
+        adSetId: string;
+    };
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Comma-separated Graph field override (supports nested {} projections).
+         */
+        fields?: string;
+    };
+};
+
+export type GetAdSetDetailsResponse = ({
+    /**
+     * Raw Meta ad set; keys are the requested Graph fields.
+     */
+    adSet?: {
+        [key: string]: unknown;
+    };
+});
+
+export type GetAdSetDetailsError = (unknown | {
+    error?: string;
+});
+
 export type UpdateAdSetData = {
     body: {
         platform: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter';
@@ -24708,6 +24777,252 @@ export type ListAdsBusinessCentersError = ({
     error?: string;
 } | unknown);
 
+export type GetAdsActivityLogData = {
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        /**
+         * Cursor from paging.after of the previous page.
+         */
+        after?: string;
+        /**
+         * Rows per page
+         */
+        limit?: number;
+        /**
+         * Client-side filter to one Meta object id (campaign, ad set or ad).
+         */
+        objectId?: string;
+        /**
+         * Start of range (YYYY-MM-DD).
+         */
+        since?: string;
+        /**
+         * End of range (YYYY-MM-DD).
+         */
+        until?: string;
+    };
+};
+
+export type GetAdsActivityLogResponse = ({
+    adAccountId?: string;
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type GetAdsActivityLogError = (unknown | {
+    error?: string;
+});
+
+export type CreateRfPredictionData = {
+    body: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant).
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        /**
+         * Whole currency units. Exactly one of budgetAmount / reach.
+         */
+        budgetAmount?: number;
+        /**
+         * Target unique reach. Exactly one of budgetAmount / reach.
+         */
+        reach?: number;
+        /**
+         * Campaign window start (must be in the future).
+         */
+        startDate: string;
+        endDate: string;
+        /**
+         * Max impressions per person over the window.
+         */
+        frequencyCap?: number;
+        /**
+         * Canonical camelCase TargetingSpec (same shape as /v1/ads/create's `targeting`). Defaults to countries: [US].
+         */
+        targeting?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Meta placements object (same shape as /v1/ads/create's `placements`).
+         */
+        placements?: {
+            [key: string]: unknown;
+        };
+    };
+};
+
+export type CreateRfPredictionResponse = ({
+    adAccountId?: string;
+    currency?: string;
+    prediction?: RfPrediction;
+});
+
+export type CreateRfPredictionError = (unknown | {
+    error?: string;
+});
+
+export type GetRfPredictionData = {
+    path: {
+        predictionId: string;
+    };
+    query: {
+        accountId: string;
+        adAccountId: string;
+    };
+};
+
+export type GetRfPredictionResponse = ({
+    adAccountId?: string;
+    currency?: string;
+    prediction?: RfPrediction;
+});
+
+export type GetRfPredictionError = (unknown | {
+    error?: string;
+});
+
+export type CancelRfReservationData = {
+    path: {
+        predictionId: string;
+    };
+    query: {
+        accountId: string;
+        adAccountId: string;
+    };
+};
+
+export type CancelRfReservationResponse = (unknown);
+
+export type CancelRfReservationError = (unknown | {
+    error?: string;
+});
+
+export type ReserveRfPredictionData = {
+    body: {
+        accountId: string;
+        adAccountId: string;
+    };
+    path: {
+        predictionId: string;
+    };
+};
+
+export type ReserveRfPredictionResponse = ({
+    adAccountId?: string;
+    prediction?: RfPrediction;
+});
+
+export type ReserveRfPredictionError = (unknown | {
+    error?: string;
+});
+
+export type ListAdStudiesData = {
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        /**
+         * Cursor from paging.after of the previous page.
+         */
+        after?: string;
+        /**
+         * Comma-separated Graph field override (supports nested {} projections).
+         */
+        fields?: string;
+        /**
+         * Rows per page
+         */
+        limit?: number;
+    };
+};
+
+export type ListAdStudiesResponse = ({
+    adAccountId?: string;
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type ListAdStudiesError = (unknown | {
+    error?: string;
+});
+
+export type GetAdAccountFinanceData = {
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+    };
+};
+
+export type GetAdAccountFinanceResponse = ({
+    adAccountId?: string;
+    /**
+     * ISO 4217 code all money values are expressed in.
+     */
+    currency?: string;
+    /**
+     * Outstanding/prepaid balance in whole currency units.
+     */
+    balance?: number;
+    /**
+     * Lifetime amount spent in whole currency units.
+     */
+    amountSpent?: number;
+    /**
+     * Account spend cap; null when none is set.
+     */
+    spendCap?: (number) | null;
+    fundingSource?: {
+        /**
+         * Human-readable payment method, e.g. 'Mastercard *4985'.
+         */
+        displayString?: string;
+        /**
+         * Meta funding source type code.
+         */
+        type?: number;
+    } | null;
+});
+
+export type GetAdAccountFinanceError = (unknown | {
+    error?: string;
+});
+
 export type ListAdAccountsData = {
     query: {
         /**
@@ -25010,7 +25325,7 @@ export type BoostPostData = {
         /**
          * Meta only. Required for housing, employment, credit, or political ads.
          */
-        specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS')>;
+        specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ISSUES_ELECTIONS_POLITICS' | 'ONLINE_GAMBLING_AND_GAMING')>;
         /**
          * TikTok-only. Custom destination URL for the Spark Ad. Without this, TikTok
          * Spark Ads have no clickable destination — required for traffic / conversion
@@ -25128,6 +25443,14 @@ export type CreateStandaloneAdData = {
          * Meta only. Explicit ad-set `billing_event`. Defaults to `IMPRESSIONS`. Forwarded verbatim to Meta, which validates compatibility with the optimization goal.
          */
         billingEvent?: string;
+        /**
+         * Meta only. RESERVED = Reach & Frequency: requires `rfPredictionId` (a RESERVED prediction from /v1/ads/rf-predictions + /reserve). Budget, schedule and pricing come from the reservation, so budgetAmount/budgetType are not required and bid fields are ignored. Only the plain single-ad shape (no creatives[], adSetId, existingCampaignId or dynamicCreative).
+         */
+        buyingType?: 'AUCTION' | 'RESERVED';
+        /**
+         * Meta only. The RESERVED prediction id the R&F ad set runs on (reserving mints a new id — pass that one). Requires buyingType RESERVED.
+         */
+        rfPredictionId?: string;
         /**
          * Required on legacy + multi-creative shapes. Inherited on attach.
          */
@@ -25172,7 +25495,7 @@ export type CreateStandaloneAdData = {
         /**
          * Required on legacy + attach shapes for Meta. Honoured on TikTok (passes through to the Spark Ad creative's `call_to_action`) and on LinkedIn (the CTA button on the ad; defaults to LEARN_MORE when `linkUrl` is set). LinkedIn accepts: LEARN_MORE, SIGN_UP, DOWNLOAD, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, VIEW_QUOTE, APPLY, SEE_MORE, SHOP_NOW, BUY_NOW. Ignored by Google, Pinterest, and X/Twitter.
          */
-        callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW';
+        callToAction?: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'ADD_TO_CART' | 'APPLY_NOW' | 'BOOK_NOW' | 'BUY_TICKETS' | 'DONATE' | 'DONATE_NOW' | 'GET_DIRECTIONS' | 'GET_SHOWTIMES' | 'LISTEN_NOW' | 'ORDER_NOW' | 'PLAY_GAME' | 'REQUEST_TIME' | 'SEE_MENU' | 'START_ORDER' | 'INSTALL_MOBILE_APP' | 'USE_APP' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW';
         /**
          * Required on legacy + attach shapes (skip for multi-creative). On LinkedIn it's the ad's destination URL; required for `traffic` ads, optional for `engagement` / `awareness`. NOT required when `goal` is `lead_generation` (the ad opens a Lead Gen form instead of a destination). On LinkedIn, `imageUrl` + `linkUrl` publishes an ARTICLE-content creative; this is LinkedIn's article ad format, with the image as thumbnail and `longHeadline` as description.
          */
@@ -25241,7 +25564,7 @@ export type CreateStandaloneAdData = {
                 thumbnailUrl?: string;
             };
             linkUrl: string;
-            callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE';
+            callToAction: 'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'ADD_TO_CART' | 'APPLY_NOW' | 'BOOK_NOW' | 'BUY_TICKETS' | 'DONATE' | 'DONATE_NOW' | 'GET_DIRECTIONS' | 'GET_SHOWTIMES' | 'LISTEN_NOW' | 'ORDER_NOW' | 'PLAY_GAME' | 'REQUEST_TIME' | 'SEE_MENU' | 'START_ORDER' | 'INSTALL_MOBILE_APP' | 'USE_APP';
         }>;
         /**
          * Meta-only. When present, switches to the attach shape: adds
@@ -25463,7 +25786,7 @@ export type CreateStandaloneAdData = {
          * category disables income/zip targeting on Meta.
          *
          */
-        specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS')>;
+        specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ISSUES_ELECTIONS_POLITICS' | 'ONLINE_GAMBLING_AND_GAMING')>;
         /**
          * Required for lifetime budgets
          */
@@ -25517,7 +25840,7 @@ export type CreateStandaloneAdData = {
             /**
              * CTA-button variations. Required.
              */
-            callToActionTypes?: Array<('LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW')>;
+            callToActionTypes?: Array<('LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'BOOK_TRAVEL' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'SUBSCRIBE' | 'WATCH_MORE' | 'ADD_TO_CART' | 'APPLY_NOW' | 'BOOK_NOW' | 'BUY_TICKETS' | 'DONATE' | 'DONATE_NOW' | 'GET_DIRECTIONS' | 'GET_SHOWTIMES' | 'LISTEN_NOW' | 'ORDER_NOW' | 'PLAY_GAME' | 'REQUEST_TIME' | 'SEE_MENU' | 'START_ORDER' | 'INSTALL_MOBILE_APP' | 'USE_APP' | 'REGISTER' | 'JOIN' | 'ATTEND' | 'REQUEST_DEMO' | 'VIEW_QUOTE' | 'APPLY' | 'SEE_MORE' | 'BUY_NOW')>;
             /**
              * Asset-feed ad format. Defaults to SINGLE_IMAGE.
              */
@@ -26094,6 +26417,45 @@ export type CreateTestLeadError = ({
     error?: string;
 });
 
+export type UploadAdImageData = {
+    body: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        /**
+         * Raw base64 image bytes, or a full data URL (the data:image/...;base64, prefix is stripped).
+         */
+        imageBase64: string;
+        /**
+         * Optional filename shown in Meta's image library. Defaults to ad_image.jpg.
+         */
+        filename?: string;
+    };
+};
+
+export type UploadAdImageResponse = ({
+    adAccountId?: string;
+    image?: {
+        /**
+         * Meta image hash, reusable wherever image_hash is accepted.
+         */
+        hash?: string;
+        /**
+         * Meta-hosted image URL; usable as imageUrl on the create endpoints.
+         */
+        url?: string;
+    };
+});
+
+export type UploadAdImageError = (unknown | {
+    error?: string;
+});
+
 export type SearchAdInterestsData = {
     query: {
         /**
@@ -26741,8 +27103,12 @@ export type SendConversionsData = {
         testCode?: string;
         /**
          * Batch-level user consent. Required by Google for EEA/UK
-         * events under the Feb 2026 restrictions. Ignored by Meta
-         * and LinkedIn.
+         * events under the Feb 2026 restrictions. On Meta, any
+         * DENIED flag enables Limited Data Use on every event in
+         * the batch (data_processing_options ["LDU"] with
+         * geolocation, country 0 / state 0); GRANTED or absent
+         * consent sends events with Meta's default processing.
+         * Ignored by LinkedIn.
          *
          */
         consent?: {