@getlatedev/node 0.2.1434 → 0.2.1436

package/dist/index.d.mts

@@ -10046,14 +10046,25 @@ type ErrorResponse = {
     /**
      * Additional structured context for the error (for example field-level validation errors). What it carries depends on the endpoint and platform.
      *
-     * **Meta ads refusals.** The ones customers hit most come back with their own `code` instead of `platform_api_error`, the field to fix in `param`, and `details.fix` ({ label, url }) pointing at the Meta page that resolves it:
-     *
-     * - `ad_account_payment_required`
-     * - `ad_account_policy_not_accepted`
-     * - `meta_security_check_required`
-     * - `meta_action_blocked`
-     * - `whatsapp_number_not_linked`
-     * - `invalid_targeting`
+     * **Meta ads refusals.** The ones customers hit most come back with their own `code` instead of `platform_api_error`, the field to fix in `param`, and an English `details.hint` saying how to fix it. `details.fix` ({ label, url }) links the Meta page that resolves it, when there is one.
+     *
+     * The code is picked from Meta's numeric `code` and `error_subcode`, never from the message, so it is the same whatever language Meta wrote `error_user_msg` in. Branch on `code` and show `details.hint`.
+     *
+     * - `ad_account_payment_required`: the ad account has no usable payment method (subcode 1815010, 1359188).
+     * - `ad_account_policy_not_accepted`: a business admin has to accept Meta's non-discrimination policy (subcode 2859002, 2859024).
+     * - `lead_ads_terms_not_accepted`: the Facebook Page has not accepted the Lead Ads terms (subcode 1815089).
+     * - `verified_advertiser_required`: the market requires a verified beneficiary and payer; send `regionalRegulationIdentities` (subcode 3858634, 3858636, 3858442, 3858548, 3858495).
+     * - `ad_account_unusable`: the ad account is not active, or the business is restricted from advertising (subcode 1885316, 2446325, and 2490592, 4841021 below).
+     * - `meta_security_check_required`: the Facebook user behind the connection is held at a security check (code 31).
+     * - `meta_action_blocked`: Meta temporarily blocked the Facebook user from this action (subcode 2859015).
+     * - `meta_ad_consent_required`: the Page or Instagram owner chose Meta without ads or less personalized ads (subcode 3858231, 3858412).
+     * - `instagram_account_restricted`: Meta restricted the Instagram account the ad runs as (subcode 2207070).
+     * - `insufficient_permissions`: the ad account cannot use the Instagram account, or the Facebook user has no advertiser permission on the Page (subcode 1815199, 1815202, 1885499, 1341012, and the Advertise permission case below).
+     * - `whatsapp_number_not_linked`: the WhatsApp number is no longer linked to the Page (subcode 2446880).
+     * - `invalid_targeting`: Meta refused the audience or a placement (subcode 1487079, 1870247, 2909035, 1870189, 1870188, 1487756, 1487843, 2490562).
+     * - `post_not_boostable`: Meta does not allow the post to be promoted (subcode 2446187, 2875030, 1487472).
+     * - `budget_too_low`: the budget is below Meta's minimum, which `platformError.error_user_msg` states (subcode 1885272).
+     * - `meta_object_not_accessible`: Meta cannot load an object the request names (wrong ID, deleted, or no access); `platformError.message` names the ID (subcode 33, on ads routes only).
      *
      * Meta's own error stays in the message and in `platformError`.
      *
@@ -57075,7 +57086,7 @@ type BoostPostData = {
     body: {
         creativeFeatures?: MetaCreativeFeatures;
         /**
-         * Zernio post ID (provide this or platformPostId)
+         * The Zernio post id (24 hex characters) returned when the post was created through Zernio. Send this or platformPostId. A value that is not a Zernio id is boosted as the platform post id, the same as platformPostId; a Zernio id that matches no post is a 404 on postId.
          */
         postId?: string;
         /**
@@ -57089,7 +57100,7 @@ type BoostPostData = {
         /**
          * Zernio account id. Normally the connected posting account (facebook, instagram, tiktok, linkedin, pinterest, twitter), a googleads account or a redditads account.
          *
-         * TikTok: the TikTok Ads connection (platform tiktokads) is also accepted when the post brings its own authorization (sparkAuthCode or sparkPosts), so Spark ads need no organic TikTok account connected. Such a call must use platformPostId, not postId.
+         * TikTok: the TikTok Ads connection (platform tiktokads) is also accepted when the post brings its own authorization (sparkAuthCode or sparkPosts), so Spark ads need no organic TikTok account connected. Such a call cannot use a Zernio postId: send the TikTok item id (as platformPostId, or in postId).
          */
         accountId: string;
         /**

package/dist/index.d.ts

@@ -10046,14 +10046,25 @@ type ErrorResponse = {
     /**
      * Additional structured context for the error (for example field-level validation errors). What it carries depends on the endpoint and platform.
      *
-     * **Meta ads refusals.** The ones customers hit most come back with their own `code` instead of `platform_api_error`, the field to fix in `param`, and `details.fix` ({ label, url }) pointing at the Meta page that resolves it:
-     *
-     * - `ad_account_payment_required`
-     * - `ad_account_policy_not_accepted`
-     * - `meta_security_check_required`
-     * - `meta_action_blocked`
-     * - `whatsapp_number_not_linked`
-     * - `invalid_targeting`
+     * **Meta ads refusals.** The ones customers hit most come back with their own `code` instead of `platform_api_error`, the field to fix in `param`, and an English `details.hint` saying how to fix it. `details.fix` ({ label, url }) links the Meta page that resolves it, when there is one.
+     *
+     * The code is picked from Meta's numeric `code` and `error_subcode`, never from the message, so it is the same whatever language Meta wrote `error_user_msg` in. Branch on `code` and show `details.hint`.
+     *
+     * - `ad_account_payment_required`: the ad account has no usable payment method (subcode 1815010, 1359188).
+     * - `ad_account_policy_not_accepted`: a business admin has to accept Meta's non-discrimination policy (subcode 2859002, 2859024).
+     * - `lead_ads_terms_not_accepted`: the Facebook Page has not accepted the Lead Ads terms (subcode 1815089).
+     * - `verified_advertiser_required`: the market requires a verified beneficiary and payer; send `regionalRegulationIdentities` (subcode 3858634, 3858636, 3858442, 3858548, 3858495).
+     * - `ad_account_unusable`: the ad account is not active, or the business is restricted from advertising (subcode 1885316, 2446325, and 2490592, 4841021 below).
+     * - `meta_security_check_required`: the Facebook user behind the connection is held at a security check (code 31).
+     * - `meta_action_blocked`: Meta temporarily blocked the Facebook user from this action (subcode 2859015).
+     * - `meta_ad_consent_required`: the Page or Instagram owner chose Meta without ads or less personalized ads (subcode 3858231, 3858412).
+     * - `instagram_account_restricted`: Meta restricted the Instagram account the ad runs as (subcode 2207070).
+     * - `insufficient_permissions`: the ad account cannot use the Instagram account, or the Facebook user has no advertiser permission on the Page (subcode 1815199, 1815202, 1885499, 1341012, and the Advertise permission case below).
+     * - `whatsapp_number_not_linked`: the WhatsApp number is no longer linked to the Page (subcode 2446880).
+     * - `invalid_targeting`: Meta refused the audience or a placement (subcode 1487079, 1870247, 2909035, 1870189, 1870188, 1487756, 1487843, 2490562).
+     * - `post_not_boostable`: Meta does not allow the post to be promoted (subcode 2446187, 2875030, 1487472).
+     * - `budget_too_low`: the budget is below Meta's minimum, which `platformError.error_user_msg` states (subcode 1885272).
+     * - `meta_object_not_accessible`: Meta cannot load an object the request names (wrong ID, deleted, or no access); `platformError.message` names the ID (subcode 33, on ads routes only).
      *
      * Meta's own error stays in the message and in `platformError`.
      *
@@ -57075,7 +57086,7 @@ type BoostPostData = {
     body: {
         creativeFeatures?: MetaCreativeFeatures;
         /**
-         * Zernio post ID (provide this or platformPostId)
+         * The Zernio post id (24 hex characters) returned when the post was created through Zernio. Send this or platformPostId. A value that is not a Zernio id is boosted as the platform post id, the same as platformPostId; a Zernio id that matches no post is a 404 on postId.
          */
         postId?: string;
         /**
@@ -57089,7 +57100,7 @@ type BoostPostData = {
         /**
          * Zernio account id. Normally the connected posting account (facebook, instagram, tiktok, linkedin, pinterest, twitter), a googleads account or a redditads account.
          *
-         * TikTok: the TikTok Ads connection (platform tiktokads) is also accepted when the post brings its own authorization (sparkAuthCode or sparkPosts), so Spark ads need no organic TikTok account connected. Such a call must use platformPostId, not postId.
+         * TikTok: the TikTok Ads connection (platform tiktokads) is also accepted when the post brings its own authorization (sparkAuthCode or sparkPosts), so Spark ads need no organic TikTok account connected. Such a call cannot use a Zernio postId: send the TikTok item id (as platformPostId, or in postId).
          */
         accountId: string;
         /**

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -8111,14 +8111,25 @@ export type ErrorResponse = {
     /**
      * Additional structured context for the error (for example field-level validation errors). What it carries depends on the endpoint and platform.
      *
-     * **Meta ads refusals.** The ones customers hit most come back with their own `code` instead of `platform_api_error`, the field to fix in `param`, and `details.fix` ({ label, url }) pointing at the Meta page that resolves it:
-     *
-     * - `ad_account_payment_required`
-     * - `ad_account_policy_not_accepted`
-     * - `meta_security_check_required`
-     * - `meta_action_blocked`
-     * - `whatsapp_number_not_linked`
-     * - `invalid_targeting`
+     * **Meta ads refusals.** The ones customers hit most come back with their own `code` instead of `platform_api_error`, the field to fix in `param`, and an English `details.hint` saying how to fix it. `details.fix` ({ label, url }) links the Meta page that resolves it, when there is one.
+     *
+     * The code is picked from Meta's numeric `code` and `error_subcode`, never from the message, so it is the same whatever language Meta wrote `error_user_msg` in. Branch on `code` and show `details.hint`.
+     *
+     * - `ad_account_payment_required`: the ad account has no usable payment method (subcode 1815010, 1359188).
+     * - `ad_account_policy_not_accepted`: a business admin has to accept Meta's non-discrimination policy (subcode 2859002, 2859024).
+     * - `lead_ads_terms_not_accepted`: the Facebook Page has not accepted the Lead Ads terms (subcode 1815089).
+     * - `verified_advertiser_required`: the market requires a verified beneficiary and payer; send `regionalRegulationIdentities` (subcode 3858634, 3858636, 3858442, 3858548, 3858495).
+     * - `ad_account_unusable`: the ad account is not active, or the business is restricted from advertising (subcode 1885316, 2446325, and 2490592, 4841021 below).
+     * - `meta_security_check_required`: the Facebook user behind the connection is held at a security check (code 31).
+     * - `meta_action_blocked`: Meta temporarily blocked the Facebook user from this action (subcode 2859015).
+     * - `meta_ad_consent_required`: the Page or Instagram owner chose Meta without ads or less personalized ads (subcode 3858231, 3858412).
+     * - `instagram_account_restricted`: Meta restricted the Instagram account the ad runs as (subcode 2207070).
+     * - `insufficient_permissions`: the ad account cannot use the Instagram account, or the Facebook user has no advertiser permission on the Page (subcode 1815199, 1815202, 1885499, 1341012, and the Advertise permission case below).
+     * - `whatsapp_number_not_linked`: the WhatsApp number is no longer linked to the Page (subcode 2446880).
+     * - `invalid_targeting`: Meta refused the audience or a placement (subcode 1487079, 1870247, 2909035, 1870189, 1870188, 1487756, 1487843, 2490562).
+     * - `post_not_boostable`: Meta does not allow the post to be promoted (subcode 2446187, 2875030, 1487472).
+     * - `budget_too_low`: the budget is below Meta's minimum, which `platformError.error_user_msg` states (subcode 1885272).
+     * - `meta_object_not_accessible`: Meta cannot load an object the request names (wrong ID, deleted, or no access); `platformError.message` names the ID (subcode 33, on ads routes only).
      *
      * Meta's own error stays in the message and in `platformError`.
      *
@@ -58244,7 +58255,7 @@ export type BoostPostData = {
     body: {
         creativeFeatures?: MetaCreativeFeatures;
         /**
-         * Zernio post ID (provide this or platformPostId)
+         * The Zernio post id (24 hex characters) returned when the post was created through Zernio. Send this or platformPostId. A value that is not a Zernio id is boosted as the platform post id, the same as platformPostId; a Zernio id that matches no post is a 404 on postId.
          */
         postId?: string;
         /**
@@ -58258,7 +58269,7 @@ export type BoostPostData = {
         /**
          * Zernio account id. Normally the connected posting account (facebook, instagram, tiktok, linkedin, pinterest, twitter), a googleads account or a redditads account.
          *
-         * TikTok: the TikTok Ads connection (platform tiktokads) is also accepted when the post brings its own authorization (sparkAuthCode or sparkPosts), so Spark ads need no organic TikTok account connected. Such a call must use platformPostId, not postId.
+         * TikTok: the TikTok Ads connection (platform tiktokads) is also accepted when the post brings its own authorization (sparkAuthCode or sparkPosts), so Spark ads need no organic TikTok account connected. Such a call cannot use a Zernio postId: send the TikTok item id (as platformPostId, or in postId).
          */
         accountId: string;
         /**