@getlatedev/node 0.2.394 → 0.2.395

package/src/generated/types.gen.ts

@@ -23758,6 +23758,48 @@ export type ListAdCampaignsError = ({
     error?: string;
 } | unknown);
 
+export type CreateAdCampaignData = {
+    body: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        name: string;
+        /**
+         * Mapped to the ODAX objective (same mapping as POST /v1/ads/create).
+         */
+        goal: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'job_applicants' | 'conversions' | 'app_promotion' | 'catalog_sales';
+        specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'ISSUES_ELECTIONS_POLITICS' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ONLINE_GAMBLING_AND_GAMING')>;
+        /**
+         * Campaign-level (CBO) budget in whole currency units. Requires budgetType.
+         */
+        budgetAmount?: number;
+        budgetType?: 'daily' | 'lifetime';
+        status?: 'ACTIVE' | 'PAUSED';
+    };
+};
+
+export type CreateAdCampaignResponse = ({
+    adAccountId?: string;
+    /**
+     * Platform id of the new campaign
+     */
+    campaignId?: string;
+    /**
+     * Resolved ODAX objective (e.g. OUTCOME_SALES).
+     */
+    objective?: string;
+    status?: 'ACTIVE' | 'PAUSED';
+});
+
+export type CreateAdCampaignError = (unknown | {
+    error?: string;
+});
+
 export type UpdateAdCampaignStatusData = {
     body: {
         status: 'active' | 'paused';
@@ -23949,6 +23991,89 @@ export type DuplicateAdCampaignError = (unknown | {
     error?: string;
 });
 
+export type DuplicateAdSetData = {
+    body: {
+        platform: 'facebook' | 'instagram';
+        /**
+         * Destination platform campaign id (defaults to the source's campaign)
+         */
+        campaignId?: string;
+        /**
+         * Copy child ads + creatives
+         */
+        deepCopy?: boolean;
+        statusOption?: 'ACTIVE' | 'PAUSED' | 'INHERITED_FROM_SOURCE';
+        /**
+         * Reschedule the copy's start time
+         */
+        startTime?: string;
+        endTime?: string;
+        renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
+        renamePrefix?: string;
+        renameSuffix?: string;
+        syncAfter?: boolean;
+    };
+    path: {
+        /**
+         * Source platform ad set ID
+         */
+        adSetId: string;
+    };
+};
+
+export type DuplicateAdSetResponse = ({
+    /**
+     * Platform ID of the new ad set
+     */
+    copiedAdSetId?: string;
+    discovery?: 'triggered' | 'skipped' | 'failed';
+    /**
+     * Meta's native copy response (includes ad_object_ids for child copies)
+     */
+    raw?: {
+        [key: string]: unknown;
+    };
+});
+
+export type DuplicateAdSetError = (unknown | {
+    error?: string;
+});
+
+export type DuplicateAdData = {
+    body?: {
+        /**
+         * Destination platform ad set id (defaults to the source's ad set)
+         */
+        adSetId?: string;
+        statusOption?: 'ACTIVE' | 'PAUSED' | 'INHERITED_FROM_SOURCE';
+        renameStrategy?: 'DEEP_RENAME' | 'ONLY_TOP_LEVEL_RENAME' | 'NO_RENAME';
+        renamePrefix?: string;
+        renameSuffix?: string;
+        syncAfter?: boolean;
+    };
+    path: {
+        /**
+         * Zernio ad ID or platform ad ID
+         */
+        adId: string;
+    };
+};
+
+export type DuplicateAdResponse = ({
+    /**
+     * Platform ID of the new ad
+     */
+    copiedAdId?: string;
+    discovery?: 'triggered' | 'skipped' | 'failed';
+    raw?: {
+        [key: string]: unknown;
+    };
+});
+
+export type DuplicateAdError = (unknown | {
+    error?: string;
+});
+
 export type GetAdSetDetailsData = {
     path: {
         /**
@@ -25180,6 +25305,271 @@ export type ListAdStudiesError = (unknown | {
     error?: string;
 });
 
+export type ListAdLabelsData = {
+    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;
+    };
+};
+
+export type ListAdLabelsResponse = ({
+    adAccountId?: string;
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type ListAdLabelsError = (unknown | {
+    error?: string;
+});
+
+export type ListHighDemandPeriodsData = {
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        /**
+         * Platform ad set id. Exactly one of campaignId / adSetId.
+         */
+        adSetId?: string;
+        /**
+         * Cursor from paging.after of the previous page.
+         */
+        after?: string;
+        /**
+         * Platform campaign id. Exactly one of campaignId / adSetId.
+         */
+        campaignId?: string;
+        /**
+         * Rows per page
+         */
+        limit?: number;
+    };
+};
+
+export type ListHighDemandPeriodsResponse = ({
+    /**
+     * The campaign / ad set id the schedules belong to.
+     */
+    objectId?: string;
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type ListHighDemandPeriodsError = (unknown | {
+    error?: string;
+});
+
+export type ListAdCreativesData = {
+    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 ListAdCreativesResponse = ({
+    adAccountId?: string;
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type ListAdCreativesError = (unknown | {
+    error?: string;
+});
+
+export type CreateAdCreativeData = {
+    body: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token and Page.
+         */
+        accountId: string;
+        /**
+         * Meta ad account id (act_<n>).
+         */
+        adAccountId: string;
+        headline: string;
+        /**
+         * Primary text
+         */
+        body: string;
+        /**
+         * Link description below the headline; omitted = Meta scrapes the destination's OG description.
+         */
+        description?: string;
+        /**
+         * CTA type (same whitelist as POST /v1/ads/create).
+         */
+        callToAction?: string;
+        linkUrl: string;
+        /**
+         * Publicly reachable image; uploaded to the account's library server-side.
+         */
+        imageUrl?: string;
+        /**
+         * Existing library image hash (POST /v1/ads/images or GET /v1/ads/images).
+         */
+        imageHash?: string;
+        carouselCards?: Array<{
+            imageUrl: string;
+            linkUrl: string;
+            headline?: string;
+            description?: string;
+            callToAction?: string;
+        }>;
+        /**
+         * Appended to every outbound URL (e.g. utm_source=fb).
+         */
+        urlTags?: string;
+    };
+};
+
+export type CreateAdCreativeResponse = ({
+    adAccountId?: string;
+    /**
+     * Platform creative id, reusable via existingCreativeId.
+     */
+    creativeId?: string;
+});
+
+export type CreateAdCreativeError = (unknown | {
+    error?: string;
+});
+
+export type GetAdCreativeData = {
+    path: {
+        /**
+         * Platform creative id
+         */
+        creativeId: 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 GetAdCreativeResponse = ({
+    /**
+     * Raw Meta creative node
+     */
+    creative?: {
+        [key: string]: unknown;
+    };
+});
+
+export type GetAdCreativeError = (unknown | {
+    error?: string;
+});
+
+export type UpdateAdCreativeData = {
+    body: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+        name: string;
+    };
+    path: {
+        /**
+         * Platform creative id
+         */
+        creativeId: string;
+    };
+};
+
+export type UpdateAdCreativeResponse = ({
+    creativeId?: string;
+    name?: string;
+    message?: string;
+});
+
+export type UpdateAdCreativeError = (unknown | {
+    error?: string;
+});
+
+export type DeleteAdCreativeData = {
+    path: {
+        /**
+         * Platform creative id
+         */
+        creativeId: string;
+    };
+    query: {
+        /**
+         * Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
+         */
+        accountId: string;
+    };
+};
+
+export type DeleteAdCreativeResponse = ({
+    creativeId?: string;
+    message?: string;
+});
+
+export type DeleteAdCreativeError = (unknown | {
+    error?: string;
+});
+
 export type GetAdAccountFinanceData = {
     query: {
         /**
@@ -26660,6 +27050,48 @@ export type UploadAdImageError = (unknown | {
     error?: string;
 });
 
+export type ListAdImagesData = {
+    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 ListAdImagesResponse = ({
+    adAccountId?: string;
+    data?: Array<{
+        [key: string]: unknown;
+    }>;
+    paging?: {
+        /**
+         * Cursor for the next page; null when exhausted.
+         */
+        after?: (string) | null;
+    };
+});
+
+export type ListAdImagesError = (unknown | {
+    error?: string;
+});
+
 export type SearchAdInterestsData = {
     query: {
         /**