@getlatedev/node 0.2.934 → 0.2.936

package/dist/index.d.mts

@@ -2676,7 +2676,7 @@ type matchType2 = 'broad' | 'phrase' | 'exact';
  * For `goal: app_promotion`, it is also sent on the campaign only when
  * `isSkadnetworkAttribution: true`. Plain Android app installs keep the
  * existing campaign payload, with the promoted object only on the ad set.
- * POST /v1/ads/campaigns forwards this object only for that explicit SKAN flag.
+ * POST /v1/ads/campaigns forwards this object on Meta only for that explicit SKAN flag.
  * Required for goals whose ad-set optimization_goal points at a specific
  * event/page/app (without it Meta rejects the ad-set create with
  * `error_subcode: 1815430` "Please select a promoted object for your ad set"):
@@ -2696,8 +2696,13 @@ type matchType2 = 'broad' | 'phrase' | 'exact';
  * the App ID of an app registered on the TikTok Ads account (Assets → Events →
  * App Events). Install optimization needs the app's MMP tracking configured.
  *
+ * **OpenAI (ChatGPT) Ads**: `goal: conversions` only, on POST /v1/ads/create and
+ * POST /v1/ads/campaigns. `customEventType` picks the conversion event the campaign
+ * optimizes for (sent as the campaign's `conversion_event_setting_ids`); every other
+ * `promotedObject` field is rejected with a 400. See `customEventType` below.
+ *
  * The remaining `promotedObject.*` fields are Meta-only. Platforms other than
- * Meta and TikTok ignore `promotedObject` entirely.
+ * Meta, TikTok and OpenAI ignore `promotedObject` entirely.
  *
  */
 type AdPromotedObject = {
@@ -2733,6 +2738,17 @@ type AdPromotedObject = {
      * deprecated. On rejection the error lists the event types your pixel
      * actually tracks. Optional for `goal: conversions`.
      *
+     * **OpenAI (ChatGPT) Ads:** a conversion event from
+     * `GET /v1/accounts/{accountId}/conversion-destinations` (`conversionEvents[]`),
+     * given as its `id` (exact), its `eventType` (e.g. `order_created`) or its `name`
+     * (e.g. `Purchase`), both case-insensitive. It must be `optimizable` (active and
+     * not custom). An unknown, archived or custom event returns a 400 listing the
+     * account's optimizable events; a type or name shared by several optimizable
+     * events returns a 400 asking for the id. `validateOnly: true` runs the same
+     * check and names the resolved event in its `message`. Optional: when omitted,
+     * the campaign optimizes for the first optimizable event in OpenAI's own list
+     * order, which is the most recently created one.
+     *
      */
     customEventType?: string;
     /**
@@ -12359,6 +12375,14 @@ type WebhookPayloadPost = {
             platformPostId?: string;
             publishedUrl?: string;
             error?: string;
+            /**
+             * Present when this target failed. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
+             */
+            errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
+            /**
+             * Present when this target failed. Who must act: user, platform or system (Zernio).
+             */
+            errorSource?: 'user' | 'platform' | 'system';
             platformError?: PostPlatformError;
         }>;
         /**
@@ -12422,6 +12446,14 @@ type WebhookPayloadPostPlatform = {
             platformPostId?: string;
             publishedUrl?: string;
             error?: string;
+            /**
+             * Present when this target failed. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
+             */
+            errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
+            /**
+             * Present when this target failed. Who must act: user, platform or system (Zernio).
+             */
+            errorSource?: 'user' | 'platform' | 'system';
             platformError?: PostPlatformError;
         }>;
         /**
@@ -12455,6 +12487,14 @@ type WebhookPayloadPostPlatform = {
          * Error message from the platform. Present on `failed` only.
          */
         error?: string;
+        /**
+         * Error category for programmatic handling. Present on `failed` only. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
+         */
+        errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
+        /**
+         * Who must act on the failure: user (fix content or reconnect), platform (outage or policy), system (Zernio). Present on `failed` only.
+         */
+        errorSource?: 'user' | 'platform' | 'system';
         /**
          * When the platform-side deletion was detected by Zernio sync (ISO 8601). Present only on `post.platform.deleted`.
          */
@@ -40366,7 +40406,7 @@ type CreateStandaloneAdData = {
          * - For `conversions` on LinkedIn, or to promote an existing post, use POST /v1/ads/boost.
          *
          * **OpenAI Ads**
-         * - Only `traffic`, `awareness`, and `conversions` are supported (other goals return 400). Maps to OpenAI's `bidding_type` (clicks, impressions, conversions respectively). `conversions` requires an active conversion event setting on the account; create a tracking tag with `defaultEventType` via the tracking-tags API (`POST /v1/accounts/{accountId}/tracking-tags`), or configure a conversion event in OpenAI Ads Manager, or the request returns 422.
+         * - Only `traffic`, `awareness`, and `conversions` are supported (other goals return 400). Maps to OpenAI's `bidding_type` (clicks, impressions, conversions respectively). `conversions` requires an active conversion event setting on the account; create a tracking tag with `defaultEventType` via the tracking-tags API (`POST /v1/accounts/{accountId}/tracking-tags`), or configure a conversion event in OpenAI Ads Manager, or the request returns 400. Pick the event with `promotedObject.customEventType` (see AdPromotedObject); without it the most recently created optimizable event is used.
          *
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'job_applicants';
@@ -43542,9 +43582,12 @@ type ListConversionDestinationsResponse = ({
         adAccountId?: string;
         /**
          * OpenAI Ads only: the conversion event settings wired
-         * to this pixel. A `goal: conversions` create on
-         * POST /v1/ads/create optimizes for the first
-         * `optimizable` one; when none is, it returns 400.
+         * to this pixel. Pass one's `id`, `eventType` or `name`
+         * as `promotedObject.customEventType` on a
+         * `goal: conversions` create (POST /v1/ads/create or
+         * POST /v1/ads/campaigns) to optimize for it. Without
+         * it, the account's most recently created `optimizable`
+         * event is used; when none is, the create returns 400.
          *
          */
         conversionEvents?: Array<{

package/dist/index.d.ts

@@ -2676,7 +2676,7 @@ type matchType2 = 'broad' | 'phrase' | 'exact';
  * For `goal: app_promotion`, it is also sent on the campaign only when
  * `isSkadnetworkAttribution: true`. Plain Android app installs keep the
  * existing campaign payload, with the promoted object only on the ad set.
- * POST /v1/ads/campaigns forwards this object only for that explicit SKAN flag.
+ * POST /v1/ads/campaigns forwards this object on Meta only for that explicit SKAN flag.
  * Required for goals whose ad-set optimization_goal points at a specific
  * event/page/app (without it Meta rejects the ad-set create with
  * `error_subcode: 1815430` "Please select a promoted object for your ad set"):
@@ -2696,8 +2696,13 @@ type matchType2 = 'broad' | 'phrase' | 'exact';
  * the App ID of an app registered on the TikTok Ads account (Assets → Events →
  * App Events). Install optimization needs the app's MMP tracking configured.
  *
+ * **OpenAI (ChatGPT) Ads**: `goal: conversions` only, on POST /v1/ads/create and
+ * POST /v1/ads/campaigns. `customEventType` picks the conversion event the campaign
+ * optimizes for (sent as the campaign's `conversion_event_setting_ids`); every other
+ * `promotedObject` field is rejected with a 400. See `customEventType` below.
+ *
  * The remaining `promotedObject.*` fields are Meta-only. Platforms other than
- * Meta and TikTok ignore `promotedObject` entirely.
+ * Meta, TikTok and OpenAI ignore `promotedObject` entirely.
  *
  */
 type AdPromotedObject = {
@@ -2733,6 +2738,17 @@ type AdPromotedObject = {
      * deprecated. On rejection the error lists the event types your pixel
      * actually tracks. Optional for `goal: conversions`.
      *
+     * **OpenAI (ChatGPT) Ads:** a conversion event from
+     * `GET /v1/accounts/{accountId}/conversion-destinations` (`conversionEvents[]`),
+     * given as its `id` (exact), its `eventType` (e.g. `order_created`) or its `name`
+     * (e.g. `Purchase`), both case-insensitive. It must be `optimizable` (active and
+     * not custom). An unknown, archived or custom event returns a 400 listing the
+     * account's optimizable events; a type or name shared by several optimizable
+     * events returns a 400 asking for the id. `validateOnly: true` runs the same
+     * check and names the resolved event in its `message`. Optional: when omitted,
+     * the campaign optimizes for the first optimizable event in OpenAI's own list
+     * order, which is the most recently created one.
+     *
      */
     customEventType?: string;
     /**
@@ -12359,6 +12375,14 @@ type WebhookPayloadPost = {
             platformPostId?: string;
             publishedUrl?: string;
             error?: string;
+            /**
+             * Present when this target failed. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
+             */
+            errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
+            /**
+             * Present when this target failed. Who must act: user, platform or system (Zernio).
+             */
+            errorSource?: 'user' | 'platform' | 'system';
             platformError?: PostPlatformError;
         }>;
         /**
@@ -12422,6 +12446,14 @@ type WebhookPayloadPostPlatform = {
             platformPostId?: string;
             publishedUrl?: string;
             error?: string;
+            /**
+             * Present when this target failed. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
+             */
+            errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
+            /**
+             * Present when this target failed. Who must act: user, platform or system (Zernio).
+             */
+            errorSource?: 'user' | 'platform' | 'system';
             platformError?: PostPlatformError;
         }>;
         /**
@@ -12455,6 +12487,14 @@ type WebhookPayloadPostPlatform = {
          * Error message from the platform. Present on `failed` only.
          */
         error?: string;
+        /**
+         * Error category for programmatic handling. Present on `failed` only. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
+         */
+        errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
+        /**
+         * Who must act on the failure: user (fix content or reconnect), platform (outage or policy), system (Zernio). Present on `failed` only.
+         */
+        errorSource?: 'user' | 'platform' | 'system';
         /**
          * When the platform-side deletion was detected by Zernio sync (ISO 8601). Present only on `post.platform.deleted`.
          */
@@ -40366,7 +40406,7 @@ type CreateStandaloneAdData = {
          * - For `conversions` on LinkedIn, or to promote an existing post, use POST /v1/ads/boost.
          *
          * **OpenAI Ads**
-         * - Only `traffic`, `awareness`, and `conversions` are supported (other goals return 400). Maps to OpenAI's `bidding_type` (clicks, impressions, conversions respectively). `conversions` requires an active conversion event setting on the account; create a tracking tag with `defaultEventType` via the tracking-tags API (`POST /v1/accounts/{accountId}/tracking-tags`), or configure a conversion event in OpenAI Ads Manager, or the request returns 422.
+         * - Only `traffic`, `awareness`, and `conversions` are supported (other goals return 400). Maps to OpenAI's `bidding_type` (clicks, impressions, conversions respectively). `conversions` requires an active conversion event setting on the account; create a tracking tag with `defaultEventType` via the tracking-tags API (`POST /v1/accounts/{accountId}/tracking-tags`), or configure a conversion event in OpenAI Ads Manager, or the request returns 400. Pick the event with `promotedObject.customEventType` (see AdPromotedObject); without it the most recently created optimizable event is used.
          *
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'job_applicants';
@@ -43542,9 +43582,12 @@ type ListConversionDestinationsResponse = ({
         adAccountId?: string;
         /**
          * OpenAI Ads only: the conversion event settings wired
-         * to this pixel. A `goal: conversions` create on
-         * POST /v1/ads/create optimizes for the first
-         * `optimizable` one; when none is, it returns 400.
+         * to this pixel. Pass one's `id`, `eventType` or `name`
+         * as `promotedObject.customEventType` on a
+         * `goal: conversions` create (POST /v1/ads/create or
+         * POST /v1/ads/campaigns) to optimize for it. Without
+         * it, the account's most recently created `optimizable`
+         * event is used; when none is, the create returns 400.
          *
          */
         conversionEvents?: Array<{

package/dist/index.js

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

package/src/generated/types.gen.ts

@@ -1017,7 +1017,7 @@ export type matchType2 = 'broad' | 'phrase' | 'exact';
  * For `goal: app_promotion`, it is also sent on the campaign only when
  * `isSkadnetworkAttribution: true`. Plain Android app installs keep the
  * existing campaign payload, with the promoted object only on the ad set.
- * POST /v1/ads/campaigns forwards this object only for that explicit SKAN flag.
+ * POST /v1/ads/campaigns forwards this object on Meta only for that explicit SKAN flag.
  * Required for goals whose ad-set optimization_goal points at a specific
  * event/page/app (without it Meta rejects the ad-set create with
  * `error_subcode: 1815430` "Please select a promoted object for your ad set"):
@@ -1037,8 +1037,13 @@ export type matchType2 = 'broad' | 'phrase' | 'exact';
  * the App ID of an app registered on the TikTok Ads account (Assets → Events →
  * App Events). Install optimization needs the app's MMP tracking configured.
  *
+ * **OpenAI (ChatGPT) Ads**: `goal: conversions` only, on POST /v1/ads/create and
+ * POST /v1/ads/campaigns. `customEventType` picks the conversion event the campaign
+ * optimizes for (sent as the campaign's `conversion_event_setting_ids`); every other
+ * `promotedObject` field is rejected with a 400. See `customEventType` below.
+ *
  * The remaining `promotedObject.*` fields are Meta-only. Platforms other than
- * Meta and TikTok ignore `promotedObject` entirely.
+ * Meta, TikTok and OpenAI ignore `promotedObject` entirely.
  *
  */
 export type AdPromotedObject = {
@@ -1074,6 +1079,17 @@ export type AdPromotedObject = {
      * deprecated. On rejection the error lists the event types your pixel
      * actually tracks. Optional for `goal: conversions`.
      *
+     * **OpenAI (ChatGPT) Ads:** a conversion event from
+     * `GET /v1/accounts/{accountId}/conversion-destinations` (`conversionEvents[]`),
+     * given as its `id` (exact), its `eventType` (e.g. `order_created`) or its `name`
+     * (e.g. `Purchase`), both case-insensitive. It must be `optimizable` (active and
+     * not custom). An unknown, archived or custom event returns a 400 listing the
+     * account's optimizable events; a type or name shared by several optimizable
+     * events returns a 400 asking for the id. `validateOnly: true` runs the same
+     * check and names the resolved event in its `message`. Optional: when omitted,
+     * the campaign optimizes for the first optimizable event in OpenAI's own list
+     * order, which is the most recently created one.
+     *
      */
     customEventType?: string;
     /**
@@ -11084,6 +11100,14 @@ export type WebhookPayloadPost = {
             platformPostId?: string;
             publishedUrl?: string;
             error?: string;
+            /**
+             * Present when this target failed. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
+             */
+            errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
+            /**
+             * Present when this target failed. Who must act: user, platform or system (Zernio).
+             */
+            errorSource?: 'user' | 'platform' | 'system';
             platformError?: PostPlatformError;
         }>;
         /**
@@ -11149,6 +11173,14 @@ export type WebhookPayloadPostPlatform = {
             platformPostId?: string;
             publishedUrl?: string;
             error?: string;
+            /**
+             * Present when this target failed. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
+             */
+            errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
+            /**
+             * Present when this target failed. Who must act: user, platform or system (Zernio).
+             */
+            errorSource?: 'user' | 'platform' | 'system';
             platformError?: PostPlatformError;
         }>;
         /**
@@ -11182,6 +11214,14 @@ export type WebhookPayloadPostPlatform = {
          * Error message from the platform. Present on `failed` only.
          */
         error?: string;
+        /**
+         * Error category for programmatic handling. Present on `failed` only. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
+         */
+        errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
+        /**
+         * Who must act on the failure: user (fix content or reconnect), platform (outage or policy), system (Zernio). Present on `failed` only.
+         */
+        errorSource?: 'user' | 'platform' | 'system';
         /**
          * When the platform-side deletion was detected by Zernio sync (ISO 8601). Present only on `post.platform.deleted`.
          */
@@ -41024,7 +41064,7 @@ export type CreateStandaloneAdData = {
          * - For `conversions` on LinkedIn, or to promote an existing post, use POST /v1/ads/boost.
          *
          * **OpenAI Ads**
-         * - Only `traffic`, `awareness`, and `conversions` are supported (other goals return 400). Maps to OpenAI's `bidding_type` (clicks, impressions, conversions respectively). `conversions` requires an active conversion event setting on the account; create a tracking tag with `defaultEventType` via the tracking-tags API (`POST /v1/accounts/{accountId}/tracking-tags`), or configure a conversion event in OpenAI Ads Manager, or the request returns 422.
+         * - Only `traffic`, `awareness`, and `conversions` are supported (other goals return 400). Maps to OpenAI's `bidding_type` (clicks, impressions, conversions respectively). `conversions` requires an active conversion event setting on the account; create a tracking tag with `defaultEventType` via the tracking-tags API (`POST /v1/accounts/{accountId}/tracking-tags`), or configure a conversion event in OpenAI Ads Manager, or the request returns 400. Pick the event with `promotedObject.customEventType` (see AdPromotedObject); without it the most recently created optimizable event is used.
          *
          */
         goal?: 'engagement' | 'traffic' | 'awareness' | 'video_views' | 'lead_generation' | 'lead_conversion' | 'conversions' | 'app_promotion' | 'catalog_sales' | 'page_likes' | 'job_applicants';
@@ -44354,9 +44394,12 @@ export type ListConversionDestinationsResponse = ({
         adAccountId?: string;
         /**
          * OpenAI Ads only: the conversion event settings wired
-         * to this pixel. A `goal: conversions` create on
-         * POST /v1/ads/create optimizes for the first
-         * `optimizable` one; when none is, it returns 400.
+         * to this pixel. Pass one's `id`, `eventType` or `name`
+         * as `promotedObject.customEventType` on a
+         * `goal: conversions` create (POST /v1/ads/create or
+         * POST /v1/ads/campaigns) to optimize for it. Without
+         * it, the account's most recently created `optimizable`
+         * event is used; when none is, the create returns 400.
          *
          */
         conversionEvents?: Array<{