@getlatedev/node 0.2.400 → 0.2.402

package/dist/index.d.mts

@@ -23248,7 +23248,7 @@ type ListAdsResponse = ({
     backfillPending?: boolean;
     pagination?: Pagination;
 } | unknown);
-type ListAdsError = ({
+type ListAdsError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type ListAdCampaignsData = {
@@ -23680,7 +23680,7 @@ type UpdateAdSetData = {
              */
             endDate?: string;
             /**
-             * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create).
+             * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create). Unknown keys are rejected with 400.
              */
             promotedObject?: {
                 pixelId?: string;
@@ -23691,6 +23691,8 @@ type UpdateAdSetData = {
                 customConversionId?: string;
                 productCatalogId?: string;
                 productSetId?: string;
+                offlineConversionDataSetId?: string;
+                whatsappPhoneNumber?: string;
             };
         };
     };
@@ -25356,6 +25358,10 @@ type BoostPostData = {
          * Meta only. Required for housing, employment, credit, or political ads.
          */
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ISSUES_ELECTIONS_POLITICS' | 'ONLINE_GAMBLING_AND_GAMING')>;
+        /**
+         * Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires specialAdCategories to be set (400 otherwise).
+         */
+        specialAdCategoryCountry?: Array<(string)>;
         /**
          * TikTok-only. Custom destination URL for the Spark Ad. Without this, TikTok
          * Spark Ads have no clickable destination — required for traffic / conversion
@@ -25824,6 +25830,13 @@ type CreateStandaloneAdData = {
          *
          */
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ISSUES_ELECTIONS_POLITICS' | 'ONLINE_GAMBLING_AND_GAMING')>;
+        /**
+         * Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires
+         * specialAdCategories to be set (400 otherwise). Ignored when joining an existing campaign via
+         * existingCampaignId (the existing campaign's category/country already governs it).
+         *
+         */
+        specialAdCategoryCountry?: Array<(string)>;
         /**
          * Required for lifetime budgets
          */
@@ -26187,6 +26200,14 @@ type CreateStandaloneAdData = {
              * Product Set ID inside the catalog.
              */
             productSetId?: string;
+            /**
+             * Meta only. Offline event set (dataset) to optimise toward. Post-merger these are datasets: the id is the dataset id (for pixel-backed datasets, the pixel id).
+             */
+            offlineConversionDataSetId?: string;
+            /**
+             * Meta only. WhatsApp number on messaging-destination ad sets.
+             */
+            whatsappPhoneNumber?: string;
         };
     };
     headers?: {
@@ -26807,7 +26828,7 @@ type ListAdCatalogsResponse = ({
         productCount?: number;
     }>;
 });
-type ListAdCatalogsError = ({
+type ListAdCatalogsError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type ListAdCatalogProductSetsData = {
@@ -26831,7 +26852,7 @@ type ListAdCatalogProductSetsResponse = ({
         productCount?: number;
     }>;
 });
-type ListAdCatalogProductSetsError = ({
+type ListAdCatalogProductSetsError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type ListAdAudiencesData = {
@@ -26848,7 +26869,7 @@ type ListAdAudiencesData = {
         /**
          * Filter to one audience type. `saved_targeting` returns stored TargetingSpec audiences; the other types return uploaded/derived audiences.
          */
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
     };
 };
 type ListAdAudiencesResponse = ({
@@ -26861,7 +26882,7 @@ type ListAdAudiencesResponse = ({
         platformAudienceId?: string;
         name?: string;
         description?: string;
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
         /**
          * Present (and the only meaningful payload) when `type` is `saved_targeting`. Null for uploaded/derived audience types.
          */
@@ -26883,7 +26904,7 @@ type CreateAdAudienceData = {
         adAccountId: string;
         name: string;
         description?: string;
-        type: 'customer_list' | 'company_list' | 'engagement' | 'website' | 'website_retargeting' | 'lookalike';
+        type: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike';
         /**
          * Required for website_retargeting audiences (LinkedIn only).
          * Each rule is a URL pattern; a member who visits any
@@ -26948,9 +26969,29 @@ type CreateAdAudienceData = {
          */
         pixelId?: string;
         /**
-         * Required for website audiences
+         * Required for website (max 180) and meta_engagement (max 365) audiences.
          */
         retentionDays?: number;
+        /**
+         * Required for meta_engagement audiences (Meta only): what people
+         * engaged with. `page` = a Facebook Page, `instagram` = an IG
+         * professional account, `video` = a video. The source object must be
+         * eligible for engagement audiences or Meta rejects with subcode
+         * 1713151 ("Invalid Event Name"), surfaced verbatim.
+         *
+         */
+        engagementSource?: 'page' | 'instagram' | 'video';
+        /**
+         * Required for meta_engagement: the Page / IG account / video id.
+         */
+        sourceId?: string;
+        /**
+         * meta_engagement only. The engagement event; defaults per source
+         * (page → page_engaged, instagram → ig_business_profile_all,
+         * video → video_watched). Ignored when `rule` is provided.
+         *
+         */
+        event?: string;
         /**
          * Required for lookalike audiences
          */
@@ -26964,7 +27005,7 @@ type CreateAdAudienceData = {
          */
         ratio?: number;
         /**
-         * Pixel event rule for website audiences (optional)
+         * Optional raw Meta rule, forwarded verbatim: pixel event rule for website audiences, or the engagement rule for meta_engagement (overrides the built rule, e.g. for event/canvas/lead-form sources).
          */
         rule?: {
             [key: string]: unknown;
@@ -27097,7 +27138,7 @@ type GetConversionsQualityResponse = ({
         eventCoveragePercentage?: number;
     }>;
 });
-type GetConversionsQualityError = ({
+type GetConversionsQualityError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type SendConversionsData = {

package/dist/index.d.ts

@@ -23248,7 +23248,7 @@ type ListAdsResponse = ({
     backfillPending?: boolean;
     pagination?: Pagination;
 } | unknown);
-type ListAdsError = ({
+type ListAdsError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type ListAdCampaignsData = {
@@ -23680,7 +23680,7 @@ type UpdateAdSetData = {
              */
             endDate?: string;
             /**
-             * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create).
+             * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create). Unknown keys are rejected with 400.
              */
             promotedObject?: {
                 pixelId?: string;
@@ -23691,6 +23691,8 @@ type UpdateAdSetData = {
                 customConversionId?: string;
                 productCatalogId?: string;
                 productSetId?: string;
+                offlineConversionDataSetId?: string;
+                whatsappPhoneNumber?: string;
             };
         };
     };
@@ -25356,6 +25358,10 @@ type BoostPostData = {
          * Meta only. Required for housing, employment, credit, or political ads.
          */
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ISSUES_ELECTIONS_POLITICS' | 'ONLINE_GAMBLING_AND_GAMING')>;
+        /**
+         * Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires specialAdCategories to be set (400 otherwise).
+         */
+        specialAdCategoryCountry?: Array<(string)>;
         /**
          * TikTok-only. Custom destination URL for the Spark Ad. Without this, TikTok
          * Spark Ads have no clickable destination — required for traffic / conversion
@@ -25824,6 +25830,13 @@ type CreateStandaloneAdData = {
          *
          */
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ISSUES_ELECTIONS_POLITICS' | 'ONLINE_GAMBLING_AND_GAMING')>;
+        /**
+         * Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires
+         * specialAdCategories to be set (400 otherwise). Ignored when joining an existing campaign via
+         * existingCampaignId (the existing campaign's category/country already governs it).
+         *
+         */
+        specialAdCategoryCountry?: Array<(string)>;
         /**
          * Required for lifetime budgets
          */
@@ -26187,6 +26200,14 @@ type CreateStandaloneAdData = {
              * Product Set ID inside the catalog.
              */
             productSetId?: string;
+            /**
+             * Meta only. Offline event set (dataset) to optimise toward. Post-merger these are datasets: the id is the dataset id (for pixel-backed datasets, the pixel id).
+             */
+            offlineConversionDataSetId?: string;
+            /**
+             * Meta only. WhatsApp number on messaging-destination ad sets.
+             */
+            whatsappPhoneNumber?: string;
         };
     };
     headers?: {
@@ -26807,7 +26828,7 @@ type ListAdCatalogsResponse = ({
         productCount?: number;
     }>;
 });
-type ListAdCatalogsError = ({
+type ListAdCatalogsError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type ListAdCatalogProductSetsData = {
@@ -26831,7 +26852,7 @@ type ListAdCatalogProductSetsResponse = ({
         productCount?: number;
     }>;
 });
-type ListAdCatalogProductSetsError = ({
+type ListAdCatalogProductSetsError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type ListAdAudiencesData = {
@@ -26848,7 +26869,7 @@ type ListAdAudiencesData = {
         /**
          * Filter to one audience type. `saved_targeting` returns stored TargetingSpec audiences; the other types return uploaded/derived audiences.
          */
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
     };
 };
 type ListAdAudiencesResponse = ({
@@ -26861,7 +26882,7 @@ type ListAdAudiencesResponse = ({
         platformAudienceId?: string;
         name?: string;
         description?: string;
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
         /**
          * Present (and the only meaningful payload) when `type` is `saved_targeting`. Null for uploaded/derived audience types.
          */
@@ -26883,7 +26904,7 @@ type CreateAdAudienceData = {
         adAccountId: string;
         name: string;
         description?: string;
-        type: 'customer_list' | 'company_list' | 'engagement' | 'website' | 'website_retargeting' | 'lookalike';
+        type: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike';
         /**
          * Required for website_retargeting audiences (LinkedIn only).
          * Each rule is a URL pattern; a member who visits any
@@ -26948,9 +26969,29 @@ type CreateAdAudienceData = {
          */
         pixelId?: string;
         /**
-         * Required for website audiences
+         * Required for website (max 180) and meta_engagement (max 365) audiences.
          */
         retentionDays?: number;
+        /**
+         * Required for meta_engagement audiences (Meta only): what people
+         * engaged with. `page` = a Facebook Page, `instagram` = an IG
+         * professional account, `video` = a video. The source object must be
+         * eligible for engagement audiences or Meta rejects with subcode
+         * 1713151 ("Invalid Event Name"), surfaced verbatim.
+         *
+         */
+        engagementSource?: 'page' | 'instagram' | 'video';
+        /**
+         * Required for meta_engagement: the Page / IG account / video id.
+         */
+        sourceId?: string;
+        /**
+         * meta_engagement only. The engagement event; defaults per source
+         * (page → page_engaged, instagram → ig_business_profile_all,
+         * video → video_watched). Ignored when `rule` is provided.
+         *
+         */
+        event?: string;
         /**
          * Required for lookalike audiences
          */
@@ -26964,7 +27005,7 @@ type CreateAdAudienceData = {
          */
         ratio?: number;
         /**
-         * Pixel event rule for website audiences (optional)
+         * Optional raw Meta rule, forwarded verbatim: pixel event rule for website audiences, or the engagement rule for meta_engagement (overrides the built rule, e.g. for event/canvas/lead-form sources).
          */
         rule?: {
             [key: string]: unknown;
@@ -27097,7 +27138,7 @@ type GetConversionsQualityResponse = ({
         eventCoveragePercentage?: number;
     }>;
 });
-type GetConversionsQualityError = ({
+type GetConversionsQualityError = (ErrorResponse | {
     error?: string;
 } | unknown);
 type SendConversionsData = {

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.400",
+  version: "0.2.402",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.400",
+  version: "0.2.402",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getlatedev/node",
-  "version": "0.2.400",
+  "version": "0.2.402",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/types.gen.ts

@@ -23830,7 +23830,7 @@ export type ListAdsResponse = ({
     pagination?: Pagination;
 } | unknown);
 
-export type ListAdsError = ({
+export type ListAdsError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
@@ -24293,7 +24293,7 @@ export type UpdateAdSetData = {
              */
             endDate?: string;
             /**
-             * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create).
+             * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create). Unknown keys are rejected with 400.
              */
             promotedObject?: {
                 pixelId?: string;
@@ -24304,6 +24304,8 @@ export type UpdateAdSetData = {
                 customConversionId?: string;
                 productCatalogId?: string;
                 productSetId?: string;
+                offlineConversionDataSetId?: string;
+                whatsappPhoneNumber?: string;
             };
         };
     };
@@ -26083,6 +26085,10 @@ export type BoostPostData = {
          * Meta only. Required for housing, employment, credit, or political ads.
          */
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ISSUES_ELECTIONS_POLITICS' | 'ONLINE_GAMBLING_AND_GAMING')>;
+        /**
+         * Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires specialAdCategories to be set (400 otherwise).
+         */
+        specialAdCategoryCountry?: Array<(string)>;
         /**
          * TikTok-only. Custom destination URL for the Spark Ad. Without this, TikTok
          * Spark Ads have no clickable destination — required for traffic / conversion
@@ -26554,6 +26560,13 @@ export type CreateStandaloneAdData = {
          *
          */
         specialAdCategories?: Array<('HOUSING' | 'EMPLOYMENT' | 'CREDIT' | 'FINANCIAL_PRODUCTS_SERVICES' | 'ISSUES_ELECTIONS_POLITICS' | 'ONLINE_GAMBLING_AND_GAMING')>;
+        /**
+         * Meta (metaads) only. 2-letter ISO country codes the special ad category applies to. Requires
+         * specialAdCategories to be set (400 otherwise). Ignored when joining an existing campaign via
+         * existingCampaignId (the existing campaign's category/country already governs it).
+         *
+         */
+        specialAdCategoryCountry?: Array<(string)>;
         /**
          * Required for lifetime budgets
          */
@@ -26917,6 +26930,14 @@ export type CreateStandaloneAdData = {
              * Product Set ID inside the catalog.
              */
             productSetId?: string;
+            /**
+             * Meta only. Offline event set (dataset) to optimise toward. Post-merger these are datasets: the id is the dataset id (for pixel-backed datasets, the pixel id).
+             */
+            offlineConversionDataSetId?: string;
+            /**
+             * Meta only. WhatsApp number on messaging-destination ad sets.
+             */
+            whatsappPhoneNumber?: string;
         };
     };
     headers?: {
@@ -27584,7 +27605,7 @@ export type ListAdCatalogsResponse = ({
     }>;
 });
 
-export type ListAdCatalogsError = ({
+export type ListAdCatalogsError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
@@ -27611,7 +27632,7 @@ export type ListAdCatalogProductSetsResponse = ({
     }>;
 });
 
-export type ListAdCatalogProductSetsError = ({
+export type ListAdCatalogProductSetsError = (ErrorResponse | {
     error?: string;
 } | unknown);
 
@@ -27629,7 +27650,7 @@ export type ListAdAudiencesData = {
         /**
          * Filter to one audience type. `saved_targeting` returns stored TargetingSpec audiences; the other types return uploaded/derived audiences.
          */
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
     };
 };
 
@@ -27643,7 +27664,7 @@ export type ListAdAudiencesResponse = ({
         platformAudienceId?: string;
         name?: string;
         description?: string;
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
         /**
          * Present (and the only meaningful payload) when `type` is `saved_targeting`. Null for uploaded/derived audience types.
          */
@@ -27667,7 +27688,7 @@ export type CreateAdAudienceData = {
     adAccountId: string;
     name: string;
     description?: string;
-    type: 'customer_list' | 'company_list' | 'engagement' | 'website' | 'website_retargeting' | 'lookalike';
+    type: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike';
     /**
      * Required for website_retargeting audiences (LinkedIn only).
      * Each rule is a URL pattern; a member who visits any
@@ -27732,9 +27753,29 @@ export type CreateAdAudienceData = {
      */
     pixelId?: string;
     /**
-     * Required for website audiences
+     * Required for website (max 180) and meta_engagement (max 365) audiences.
      */
     retentionDays?: number;
+    /**
+     * Required for meta_engagement audiences (Meta only): what people
+     * engaged with. `page` = a Facebook Page, `instagram` = an IG
+     * professional account, `video` = a video. The source object must be
+     * eligible for engagement audiences or Meta rejects with subcode
+     * 1713151 ("Invalid Event Name"), surfaced verbatim.
+     *
+     */
+    engagementSource?: 'page' | 'instagram' | 'video';
+    /**
+     * Required for meta_engagement: the Page / IG account / video id.
+     */
+    sourceId?: string;
+    /**
+     * meta_engagement only. The engagement event; defaults per source
+     * (page → page_engaged, instagram → ig_business_profile_all,
+     * video → video_watched). Ignored when `rule` is provided.
+     *
+     */
+    event?: string;
     /**
      * Required for lookalike audiences
      */
@@ -27748,7 +27789,7 @@ export type CreateAdAudienceData = {
      */
     ratio?: number;
     /**
-     * Pixel event rule for website audiences (optional)
+     * Optional raw Meta rule, forwarded verbatim: pixel event rule for website audiences, or the engagement rule for meta_engagement (overrides the built rule, e.g. for event/canvas/lead-form sources).
      */
     rule?: {
         [key: string]: unknown;
@@ -27898,7 +27939,7 @@ export type GetConversionsQualityResponse = ({
     }>;
 });
 
-export type GetConversionsQualityError = ({
+export type GetConversionsQualityError = (ErrorResponse | {
     error?: string;
 } | unknown);