@getlatedev/node 0.2.474 → 0.2.475

package/dist/index.d.mts

@@ -24698,13 +24698,13 @@ type CreateAdCampaignData = {
         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.
+         * Campaign-level (CBO) budget in WHOLE currency units (USD: 50 = $50.00), NOT cents — Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Requires budgetType.
          */
         budgetAmount?: number;
         budgetType?: 'daily' | 'lifetime';
         status?: 'ACTIVE' | 'PAUSED';
         /**
-         * Campaign bid strategy. Meta puts `bid_strategy` where the budget lives, so this applies only alongside a campaign budget (CBO). Previously settable only via `PUT /v1/ads/campaigns/{campaignId}`.
+         * Campaign bid strategy. Meta stores `bid_strategy` alongside the budget, so this REQUIRES `budgetAmount` + `budgetType` on the same request; sending it without a campaign budget is a 400. A campaign carrying a strategy without its `bid_amount` makes every ad set created under it fail with an error that names the ad set (code 100, subcode 1815857), so the bad state is rejected up front rather than accepted. To bid at ad-set level, set the strategy there instead.
          */
         bidStrategy?: 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
         /**
@@ -24821,6 +24821,10 @@ type UpdateAdCampaignError = (unknown | {
 type DeleteAdCampaignData = {
     body: {
         platform: 'facebook' | 'instagram';
+        /**
+         * Zernio SocialAccount id owning the ad account. Required only to delete an EMPTY campaign (zero ads), which has no local Ad documents to resolve a token from.
+         */
+        accountId?: string;
     };
     path: {
         /**
@@ -27061,7 +27065,7 @@ type CreateStandaloneAdData = {
          */
         validateOnly?: boolean;
         /**
-         * Required on legacy + multi-creative shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType).
+         * Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents — Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy + multi-creative shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType).
          */
         budgetAmount?: number;
         /**
@@ -27499,7 +27503,7 @@ type CreateStandaloneAdData = {
             callToAction?: string;
         }>;
         /**
-         * Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own.
+         * Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own. Must NOT also appear as an entry in `translations`.
          */
         defaultLocale?: string;
         /**
@@ -27508,9 +27512,28 @@ type CreateStandaloneAdData = {
          * Manager. Keeps social proof (likes/comments/shares) on a SINGLE post instead of
          * splitting it across one ad per language.
          *
-         * The ad's top-level copy and media are the DEFAULT every unlisted locale falls back
-         * to, and a variant inherits any field it omits, so send only what differs per
-         * language. Media shared across languages is uploaded once.
+         * The ad's top-level copy is the DEFAULT shown to every locale you do NOT list,
+         * and it counts as one of the language variants.
+         *
+         * IMPORTANT, and the opposite of what you might expect: text does NOT inherit.
+         * Every entry must carry its own `headline`, `body` AND `description`, and all of
+         * them must be DISTINCT from each other and from the ad's top-level copy. Meta
+         * deduplicates identical strings inside the asset feed, so two locales sharing a
+         * string collapse into one asset and the create fails with a misleading "Too few
+         * ... texts provided in asset creation" (subcode 1885817) that names a field which
+         * is actually present. We validate this before calling Meta and return a 400
+         * naming the offending locale and field. `description` is therefore effectively
+         * required on the ad whenever `translations` is present, even though it is
+         * optional otherwise.
+         *
+         * Do NOT list `defaultLocale` inside `translations`: Meta rejects the duplicate
+         * with "The language asset feed includes an unsupported targeting field"
+         * (subcode 1885985).
+         *
+         * Media DOES inherit and is uploaded once when shared. Note that Meta enforces
+         * Dynamic Creative image dimensions on language feeds, so an `imageUrl` that
+         * works on a normal ad may be rejected with "The following images have invalid
+         * dimensions for Dynamic Creative" (subcode 1885558). Video is not affected.
          *
          * Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards` and
          * `existingCreativeId` — Meta allows one `asset_feed_spec` shape per creative.
@@ -27522,17 +27545,17 @@ type CreateStandaloneAdData = {
              */
             locale: string;
             /**
-             * Headline for this language. Inherits the top-level `headline` when omitted.
+             * Headline for this language. REQUIRED, and must differ from every other locale and from the ad's top-level headline.
              */
-            headline?: string;
+            headline: string;
             /**
-             * Primary text for this language. Inherits the top-level `body` when omitted.
+             * Primary text for this language. REQUIRED, and must differ from every other locale and from the ad's top-level body.
              */
-            body?: string;
+            body: string;
             /**
-             * Link description for this language. Inherits the top-level `description` when omitted.
+             * Link description for this language. REQUIRED, and must differ from every other locale and from the ad's top-level description.
              */
-            description?: string;
+            description: string;
             /**
              * Image for this language. Inherits the ad's `imageUrl` when omitted. The feed is all-image OR all-video.
              */

package/dist/index.d.ts

@@ -24698,13 +24698,13 @@ type CreateAdCampaignData = {
         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.
+         * Campaign-level (CBO) budget in WHOLE currency units (USD: 50 = $50.00), NOT cents — Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Requires budgetType.
          */
         budgetAmount?: number;
         budgetType?: 'daily' | 'lifetime';
         status?: 'ACTIVE' | 'PAUSED';
         /**
-         * Campaign bid strategy. Meta puts `bid_strategy` where the budget lives, so this applies only alongside a campaign budget (CBO). Previously settable only via `PUT /v1/ads/campaigns/{campaignId}`.
+         * Campaign bid strategy. Meta stores `bid_strategy` alongside the budget, so this REQUIRES `budgetAmount` + `budgetType` on the same request; sending it without a campaign budget is a 400. A campaign carrying a strategy without its `bid_amount` makes every ad set created under it fail with an error that names the ad set (code 100, subcode 1815857), so the bad state is rejected up front rather than accepted. To bid at ad-set level, set the strategy there instead.
          */
         bidStrategy?: 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
         /**
@@ -24821,6 +24821,10 @@ type UpdateAdCampaignError = (unknown | {
 type DeleteAdCampaignData = {
     body: {
         platform: 'facebook' | 'instagram';
+        /**
+         * Zernio SocialAccount id owning the ad account. Required only to delete an EMPTY campaign (zero ads), which has no local Ad documents to resolve a token from.
+         */
+        accountId?: string;
     };
     path: {
         /**
@@ -27061,7 +27065,7 @@ type CreateStandaloneAdData = {
          */
         validateOnly?: boolean;
         /**
-         * Required on legacy + multi-creative shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType).
+         * Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents — Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy + multi-creative shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType).
          */
         budgetAmount?: number;
         /**
@@ -27499,7 +27503,7 @@ type CreateStandaloneAdData = {
             callToAction?: string;
         }>;
         /**
-         * Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own.
+         * Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own. Must NOT also appear as an entry in `translations`.
          */
         defaultLocale?: string;
         /**
@@ -27508,9 +27512,28 @@ type CreateStandaloneAdData = {
          * Manager. Keeps social proof (likes/comments/shares) on a SINGLE post instead of
          * splitting it across one ad per language.
          *
-         * The ad's top-level copy and media are the DEFAULT every unlisted locale falls back
-         * to, and a variant inherits any field it omits, so send only what differs per
-         * language. Media shared across languages is uploaded once.
+         * The ad's top-level copy is the DEFAULT shown to every locale you do NOT list,
+         * and it counts as one of the language variants.
+         *
+         * IMPORTANT, and the opposite of what you might expect: text does NOT inherit.
+         * Every entry must carry its own `headline`, `body` AND `description`, and all of
+         * them must be DISTINCT from each other and from the ad's top-level copy. Meta
+         * deduplicates identical strings inside the asset feed, so two locales sharing a
+         * string collapse into one asset and the create fails with a misleading "Too few
+         * ... texts provided in asset creation" (subcode 1885817) that names a field which
+         * is actually present. We validate this before calling Meta and return a 400
+         * naming the offending locale and field. `description` is therefore effectively
+         * required on the ad whenever `translations` is present, even though it is
+         * optional otherwise.
+         *
+         * Do NOT list `defaultLocale` inside `translations`: Meta rejects the duplicate
+         * with "The language asset feed includes an unsupported targeting field"
+         * (subcode 1885985).
+         *
+         * Media DOES inherit and is uploaded once when shared. Note that Meta enforces
+         * Dynamic Creative image dimensions on language feeds, so an `imageUrl` that
+         * works on a normal ad may be rejected with "The following images have invalid
+         * dimensions for Dynamic Creative" (subcode 1885558). Video is not affected.
          *
          * Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards` and
          * `existingCreativeId` — Meta allows one `asset_feed_spec` shape per creative.
@@ -27522,17 +27545,17 @@ type CreateStandaloneAdData = {
              */
             locale: string;
             /**
-             * Headline for this language. Inherits the top-level `headline` when omitted.
+             * Headline for this language. REQUIRED, and must differ from every other locale and from the ad's top-level headline.
              */
-            headline?: string;
+            headline: string;
             /**
-             * Primary text for this language. Inherits the top-level `body` when omitted.
+             * Primary text for this language. REQUIRED, and must differ from every other locale and from the ad's top-level body.
              */
-            body?: string;
+            body: string;
             /**
-             * Link description for this language. Inherits the top-level `description` when omitted.
+             * Link description for this language. REQUIRED, and must differ from every other locale and from the ad's top-level description.
              */
-            description?: string;
+            description: string;
             /**
              * Image for this language. Inherits the ad's `imageUrl` when omitted. The feed is all-image OR all-video.
              */

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.474",
+  version: "0.2.475",
   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.474",
+  version: "0.2.475",
   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.474",
+  "version": "0.2.475",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -6724,6 +6724,14 @@ export const updateAdCampaign = <ThrowOnError extends boolean = false>(options:
  * Meta-only for now. Other platforms return 501 Not Implemented — fall
  * back to DELETE /v1/ads/{adId} per ad in the meantime.
  *
+ * **Empty campaigns.** A campaign with zero ads has no local Ad documents
+ * to resolve, so it is invisible to `/v1/ads/tree` and this endpoint would
+ * 404. That state is produced by the two-step create flow (campaign, then
+ * ads via `existingCampaignId`) whenever Meta rejects the ad step. To
+ * delete such a shell, send `accountId` in the body: we skip the local
+ * lookup entirely and forward the delete to Meta. `accountId` is ignored
+ * when the campaign does have ads.
+ *
  */
 export const deleteAdCampaign = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<DeleteAdCampaignData, ThrowOnError>) => {
     return (options?.client ?? client).delete<DeleteAdCampaignResponse, DeleteAdCampaignError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -25077,13 +25077,13 @@ export type CreateAdCampaignData = {
         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.
+         * Campaign-level (CBO) budget in WHOLE currency units (USD: 50 = $50.00), NOT cents — Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Requires budgetType.
          */
         budgetAmount?: number;
         budgetType?: 'daily' | 'lifetime';
         status?: 'ACTIVE' | 'PAUSED';
         /**
-         * Campaign bid strategy. Meta puts `bid_strategy` where the budget lives, so this applies only alongside a campaign budget (CBO). Previously settable only via `PUT /v1/ads/campaigns/{campaignId}`.
+         * Campaign bid strategy. Meta stores `bid_strategy` alongside the budget, so this REQUIRES `budgetAmount` + `budgetType` on the same request; sending it without a campaign budget is a 400. A campaign carrying a strategy without its `bid_amount` makes every ad set created under it fail with an error that names the ad set (code 100, subcode 1815857), so the bad state is rejected up front rather than accepted. To bid at ad-set level, set the strategy there instead.
          */
         bidStrategy?: 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
         /**
@@ -25209,6 +25209,10 @@ export type UpdateAdCampaignError = (unknown | {
 export type DeleteAdCampaignData = {
     body: {
         platform: 'facebook' | 'instagram';
+        /**
+         * Zernio SocialAccount id owning the ad account. Required only to delete an EMPTY campaign (zero ads), which has no local Ad documents to resolve a token from.
+         */
+        accountId?: string;
     };
     path: {
         /**
@@ -27590,7 +27594,7 @@ export type CreateStandaloneAdData = {
          */
         validateOnly?: boolean;
         /**
-         * Required on legacy + multi-creative shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType).
+         * Budget in WHOLE currency units (USD: 50 = $50.00), NOT cents — Meta's own Marketing API takes this same number in minor units, so it is an easy and expensive mix-up. Required on legacy + multi-creative shapes. Inherited on attach. OpenAI Ads requires a $1 minimum (its budget is lifetime-only, see budgetType).
          */
         budgetAmount?: number;
         /**
@@ -28028,7 +28032,7 @@ export type CreateStandaloneAdData = {
             callToAction?: string;
         }>;
         /**
-         * Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own.
+         * Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own. Must NOT also appear as an entry in `translations`.
          */
         defaultLocale?: string;
         /**
@@ -28037,9 +28041,28 @@ export type CreateStandaloneAdData = {
          * Manager. Keeps social proof (likes/comments/shares) on a SINGLE post instead of
          * splitting it across one ad per language.
          *
-         * The ad's top-level copy and media are the DEFAULT every unlisted locale falls back
-         * to, and a variant inherits any field it omits, so send only what differs per
-         * language. Media shared across languages is uploaded once.
+         * The ad's top-level copy is the DEFAULT shown to every locale you do NOT list,
+         * and it counts as one of the language variants.
+         *
+         * IMPORTANT, and the opposite of what you might expect: text does NOT inherit.
+         * Every entry must carry its own `headline`, `body` AND `description`, and all of
+         * them must be DISTINCT from each other and from the ad's top-level copy. Meta
+         * deduplicates identical strings inside the asset feed, so two locales sharing a
+         * string collapse into one asset and the create fails with a misleading "Too few
+         * ... texts provided in asset creation" (subcode 1885817) that names a field which
+         * is actually present. We validate this before calling Meta and return a 400
+         * naming the offending locale and field. `description` is therefore effectively
+         * required on the ad whenever `translations` is present, even though it is
+         * optional otherwise.
+         *
+         * Do NOT list `defaultLocale` inside `translations`: Meta rejects the duplicate
+         * with "The language asset feed includes an unsupported targeting field"
+         * (subcode 1885985).
+         *
+         * Media DOES inherit and is uploaded once when shared. Note that Meta enforces
+         * Dynamic Creative image dimensions on language feeds, so an `imageUrl` that
+         * works on a normal ad may be rejected with "The following images have invalid
+         * dimensions for Dynamic Creative" (subcode 1885558). Video is not affected.
          *
          * Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards` and
          * `existingCreativeId` — Meta allows one `asset_feed_spec` shape per creative.
@@ -28051,17 +28074,17 @@ export type CreateStandaloneAdData = {
              */
             locale: string;
             /**
-             * Headline for this language. Inherits the top-level `headline` when omitted.
+             * Headline for this language. REQUIRED, and must differ from every other locale and from the ad's top-level headline.
              */
-            headline?: string;
+            headline: string;
             /**
-             * Primary text for this language. Inherits the top-level `body` when omitted.
+             * Primary text for this language. REQUIRED, and must differ from every other locale and from the ad's top-level body.
              */
-            body?: string;
+            body: string;
             /**
-             * Link description for this language. Inherits the top-level `description` when omitted.
+             * Link description for this language. REQUIRED, and must differ from every other locale and from the ad's top-level description.
              */
-            description?: string;
+            description: string;
             /**
              * Image for this language. Inherits the ad's `imageUrl` when omitted. The feed is all-image OR all-video.
              */