@zernio/node 0.2.473 → 0.2.475

package/dist/index.d.mts

@@ -22963,8 +22963,14 @@ type GetContactChannelsError = (unknown | {
 type BulkCreateContactsData = {
     body: {
         profileId: string;
-        accountId: string;
-        platform: string;
+        /**
+         * Required when contacts carry channel data (platformIdentifier or a row-level accountId). Omit for a plain CRM import with no channels.
+         */
+        accountId?: string;
+        /**
+         * Ignored when accountId is set: the platform is derived from the resolved account. Only relevant to disambiguate accountId lookup; a mismatch 404s.
+         */
+        platform?: string;
         contacts: Array<{
             name: string;
             platformIdentifier: string;
@@ -24692,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';
         /**
@@ -24815,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: {
         /**
@@ -27055,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;
         /**
@@ -27493,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;
         /**
@@ -27502,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.
@@ -27516,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

@@ -22963,8 +22963,14 @@ type GetContactChannelsError = (unknown | {
 type BulkCreateContactsData = {
     body: {
         profileId: string;
-        accountId: string;
-        platform: string;
+        /**
+         * Required when contacts carry channel data (platformIdentifier or a row-level accountId). Omit for a plain CRM import with no channels.
+         */
+        accountId?: string;
+        /**
+         * Ignored when accountId is set: the platform is derived from the resolved account. Only relevant to disambiguate accountId lookup; a mismatch 404s.
+         */
+        platform?: string;
         contacts: Array<{
             name: string;
             platformIdentifier: string;
@@ -24692,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';
         /**
@@ -24815,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: {
         /**
@@ -27055,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;
         /**
@@ -27493,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;
         /**
@@ -27502,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.
@@ -27516,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: "@zernio/node",
-  version: "0.2.473",
+  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: "@zernio/node",
-  version: "0.2.473",
+  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": "@zernio/node",
-  "version": "0.2.473",
+  "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

@@ -6062,7 +6062,7 @@ export const getContactChannels = <ThrowOnError extends boolean = false>(options
 
 /**
  * Bulk create contacts
- * Import up to 1000 contacts at a time. Skips duplicates. On phone platforms (whatsapp, sms) the platformIdentifier is normalized to digits and a value that is not phone-shaped is rejected per contact and reported in errors[], not imported.
+ * Import up to 1000 contacts at a time. Skips duplicates, merging any new tags onto the existing contact. accountId is required whenever contacts carry a platformIdentifier (or a row-level accountId); platform is always derived from the resolved account, never used to decide whether channels are created, and a mismatched platform 404s as account not found. On phone platforms (whatsapp, sms) the platformIdentifier is normalized to digits and a value that is not phone-shaped is rejected per contact and reported in errors[], not imported.
  */
 export const bulkCreateContacts = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<BulkCreateContactsData, ThrowOnError>) => {
     return (options?.client ?? client).post<BulkCreateContactsResponse, BulkCreateContactsError, ThrowOnError>({
@@ -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

@@ -23192,8 +23192,14 @@ export type GetContactChannelsError = (unknown | {
 export type BulkCreateContactsData = {
     body: {
         profileId: string;
-        accountId: string;
-        platform: string;
+        /**
+         * Required when contacts carry channel data (platformIdentifier or a row-level accountId). Omit for a plain CRM import with no channels.
+         */
+        accountId?: string;
+        /**
+         * Ignored when accountId is set: the platform is derived from the resolved account. Only relevant to disambiguate accountId lookup; a mismatch 404s.
+         */
+        platform?: string;
         contacts: Array<{
             name: string;
             platformIdentifier: string;
@@ -25071,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';
         /**
@@ -25203,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: {
         /**
@@ -27584,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;
         /**
@@ -28022,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;
         /**
@@ -28031,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.
@@ -28045,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.
              */