@getlatedev/node 0.2.376 → 0.2.377

package/dist/index.d.mts

@@ -22489,9 +22489,21 @@ type UpdateAdCampaignData = {
          */
         bidStrategy?: (BidStrategy);
         /**
-         * Rename the campaign (Meta only; other platforms return 501). At least one of budget/bidStrategy/name is required.
+         * Rename the campaign (Meta only; other platforms return 501). At least one of budget/bidStrategy/name/platformSpecificData is required.
          */
         name?: string;
+        /**
+         * Platform-specific campaign settings. The platform is implied by the `platform`
+         * body param (same convention as platformSpecificData on POST /v1/ads/create).
+         * Meta (facebook/instagram) only; other platforms return 400.
+         *
+         */
+        platformSpecificData?: {
+            /**
+             * Campaign lifetime spend cap, in the ad account's currency (Meta `spend_cap`). Pass null to remove the cap (0 is rejected by Meta).
+             */
+            spendCap?: (number) | null;
+        };
     };
     path: {
         /**
@@ -22505,6 +22517,9 @@ type UpdateAdCampaignResponse = ({
     budget?: AdBudget;
     budgetLevel?: 'campaign';
     bidStrategy?: BidStrategy;
+    platformSpecificData?: {
+        [key: string]: unknown;
+    };
 });
 type UpdateAdCampaignError = (unknown | {
     error?: string;
@@ -22645,6 +22660,42 @@ type UpdateAdSetData = {
          *
          */
         roasAverageFloor?: number;
+        /**
+         * Platform-specific post-launch delivery settings. The platform is implied by the
+         * `platform` body param. Meta only; other platforms return 400. Unknown keys are rejected.
+         *
+         */
+        platformSpecificData?: {
+            /**
+             * Meta ad-set optimization_goal (e.g. OFFSITE_CONVERSIONS, LANDING_PAGE_VIEWS).
+             */
+            optimizationGoal?: string;
+            /**
+             * Meta ad-set billing_event (e.g. IMPRESSIONS, LINK_CLICKS, THRUPLAY).
+             */
+            billingEvent?: string;
+            /**
+             * Ad set start_time (ISO 8601).
+             */
+            startDate?: string;
+            /**
+             * Ad set end_time (ISO 8601).
+             */
+            endDate?: string;
+            /**
+             * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create).
+             */
+            promotedObject?: {
+                pixelId?: string;
+                customEventType?: string;
+                pageId?: string;
+                applicationId?: string;
+                objectStoreUrl?: string;
+                customConversionId?: string;
+                productCatalogId?: string;
+                productSetId?: string;
+            };
+        };
     };
     path: {
         /**
@@ -22662,6 +22713,9 @@ type UpdateAdSetResponse = ({
     bidStrategy?: BidStrategy;
     bidAmount?: (number) | null;
     roasAverageFloor?: (number) | null;
+    platformSpecificData?: {
+        [key: string]: unknown;
+    };
 });
 type UpdateAdSetError = (unknown | {
     error?: string;
@@ -23668,6 +23722,10 @@ type CreateStandaloneAdData = {
          * Meta only. Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations.
          */
         optimizationGoal?: string;
+        /**
+         * Meta only. Explicit ad-set `billing_event`. Defaults to `IMPRESSIONS`. Forwarded verbatim to Meta, which validates compatibility with the optimization goal.
+         */
+        billingEvent?: string;
         /**
          * Required on legacy + multi-creative shapes. Inherited on attach.
          */

package/dist/index.d.ts

@@ -22489,9 +22489,21 @@ type UpdateAdCampaignData = {
          */
         bidStrategy?: (BidStrategy);
         /**
-         * Rename the campaign (Meta only; other platforms return 501). At least one of budget/bidStrategy/name is required.
+         * Rename the campaign (Meta only; other platforms return 501). At least one of budget/bidStrategy/name/platformSpecificData is required.
          */
         name?: string;
+        /**
+         * Platform-specific campaign settings. The platform is implied by the `platform`
+         * body param (same convention as platformSpecificData on POST /v1/ads/create).
+         * Meta (facebook/instagram) only; other platforms return 400.
+         *
+         */
+        platformSpecificData?: {
+            /**
+             * Campaign lifetime spend cap, in the ad account's currency (Meta `spend_cap`). Pass null to remove the cap (0 is rejected by Meta).
+             */
+            spendCap?: (number) | null;
+        };
     };
     path: {
         /**
@@ -22505,6 +22517,9 @@ type UpdateAdCampaignResponse = ({
     budget?: AdBudget;
     budgetLevel?: 'campaign';
     bidStrategy?: BidStrategy;
+    platformSpecificData?: {
+        [key: string]: unknown;
+    };
 });
 type UpdateAdCampaignError = (unknown | {
     error?: string;
@@ -22645,6 +22660,42 @@ type UpdateAdSetData = {
          *
          */
         roasAverageFloor?: number;
+        /**
+         * Platform-specific post-launch delivery settings. The platform is implied by the
+         * `platform` body param. Meta only; other platforms return 400. Unknown keys are rejected.
+         *
+         */
+        platformSpecificData?: {
+            /**
+             * Meta ad-set optimization_goal (e.g. OFFSITE_CONVERSIONS, LANDING_PAGE_VIEWS).
+             */
+            optimizationGoal?: string;
+            /**
+             * Meta ad-set billing_event (e.g. IMPRESSIONS, LINK_CLICKS, THRUPLAY).
+             */
+            billingEvent?: string;
+            /**
+             * Ad set start_time (ISO 8601).
+             */
+            startDate?: string;
+            /**
+             * Ad set end_time (ISO 8601).
+             */
+            endDate?: string;
+            /**
+             * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create).
+             */
+            promotedObject?: {
+                pixelId?: string;
+                customEventType?: string;
+                pageId?: string;
+                applicationId?: string;
+                objectStoreUrl?: string;
+                customConversionId?: string;
+                productCatalogId?: string;
+                productSetId?: string;
+            };
+        };
     };
     path: {
         /**
@@ -22662,6 +22713,9 @@ type UpdateAdSetResponse = ({
     bidStrategy?: BidStrategy;
     bidAmount?: (number) | null;
     roasAverageFloor?: (number) | null;
+    platformSpecificData?: {
+        [key: string]: unknown;
+    };
 });
 type UpdateAdSetError = (unknown | {
     error?: string;
@@ -23668,6 +23722,10 @@ type CreateStandaloneAdData = {
          * Meta only. Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations.
          */
         optimizationGoal?: string;
+        /**
+         * Meta only. Explicit ad-set `billing_event`. Defaults to `IMPRESSIONS`. Forwarded verbatim to Meta, which validates compatibility with the optimization goal.
+         */
+        billingEvent?: string;
         /**
          * Required on legacy + multi-creative shapes. Inherited on attach.
          */

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -6198,13 +6198,15 @@ export const updateAdCampaignStatus = <ThrowOnError extends boolean = false>(opt
 
 /**
  * Update a campaign
- * Campaign-level edits. At least one of `budget` or `bidStrategy` is required.
+ * Campaign-level edits. At least one of `budget`, `bidStrategy`, `name` or `platformSpecificData` is required.
  *
  * - `budget` updates the CBO (Campaign Budget Optimization) budget. For ABO campaigns
  * (where the budget lives on the ad set), use PUT /v1/ads/ad-sets/{adSetId} instead — this endpoint
  * will return 409 with code BUDGET_LEVEL_MISMATCH.
  * - `bidStrategy` sets the campaign-level default bid strategy. Per Meta's spec, `bid_amount` and
  * `bid_constraints` do NOT exist at the campaign level — pass them via PUT /v1/ads/ad-sets/{adSetId}.
+ * - `platformSpecificData.spendCap` (Meta only) sets the campaign's lifetime spend cap, in the ad
+ * account's currency.
  *
  * Meta-only for now. Other platforms return 501 Not Implemented.
  *
@@ -6290,14 +6292,19 @@ export const duplicateAdCampaign = <ThrowOnError extends boolean = false>(option
 /**
  * Update an ad set
  * Ad-set-level writes. Use this for ABO budget updates, ad-set-scoped
- * pause/resume, and bid-strategy edits. At least one of `budget`,
- * `status`, or `bidStrategy` is required.
+ * pause/resume, bid-strategy edits, and Meta-only post-launch delivery
+ * settings via `platformSpecificData`. At least one updatable field
+ * is required.
  *
  * Bid strategy compatibility (per Meta's spec):
  * - `LOWEST_COST_WITHOUT_CAP`: no `bidAmount`, no `roasAverageFloor`.
  * - `LOWEST_COST_WITH_BID_CAP` / `COST_CAP`: `bidAmount` REQUIRED (whole currency units).
  * - `LOWEST_COST_WITH_MIN_ROAS`: `roasAverageFloor` REQUIRED (decimal multiplier, e.g. 2.0 = 2.0x ROAS).
  *
+ * Delivery settings are validated by Meta against the campaign objective;
+ * incompatible combinations (e.g. a billingEvent the optimization goal
+ * doesn't allow) surface as 400s from Meta.
+ *
  * When updating `budget` on an ABO campaign: if the parent campaign is
  * CBO, the response is 409 with code BUDGET_LEVEL_MISMATCH — route to
  * PUT /v1/ads/campaigns/{campaignId} instead.

package/src/generated/types.gen.ts

@@ -23082,9 +23082,21 @@ export type UpdateAdCampaignData = {
          */
         bidStrategy?: (BidStrategy);
         /**
-         * Rename the campaign (Meta only; other platforms return 501). At least one of budget/bidStrategy/name is required.
+         * Rename the campaign (Meta only; other platforms return 501). At least one of budget/bidStrategy/name/platformSpecificData is required.
          */
         name?: string;
+        /**
+         * Platform-specific campaign settings. The platform is implied by the `platform`
+         * body param (same convention as platformSpecificData on POST /v1/ads/create).
+         * Meta (facebook/instagram) only; other platforms return 400.
+         *
+         */
+        platformSpecificData?: {
+            /**
+             * Campaign lifetime spend cap, in the ad account's currency (Meta `spend_cap`). Pass null to remove the cap (0 is rejected by Meta).
+             */
+            spendCap?: (number) | null;
+        };
     };
     path: {
         /**
@@ -23099,6 +23111,9 @@ export type UpdateAdCampaignResponse = ({
     budget?: AdBudget;
     budgetLevel?: 'campaign';
     bidStrategy?: BidStrategy;
+    platformSpecificData?: {
+        [key: string]: unknown;
+    };
 });
 
 export type UpdateAdCampaignError = (unknown | {
@@ -23250,6 +23265,42 @@ export type UpdateAdSetData = {
          *
          */
         roasAverageFloor?: number;
+        /**
+         * Platform-specific post-launch delivery settings. The platform is implied by the
+         * `platform` body param. Meta only; other platforms return 400. Unknown keys are rejected.
+         *
+         */
+        platformSpecificData?: {
+            /**
+             * Meta ad-set optimization_goal (e.g. OFFSITE_CONVERSIONS, LANDING_PAGE_VIEWS).
+             */
+            optimizationGoal?: string;
+            /**
+             * Meta ad-set billing_event (e.g. IMPRESSIONS, LINK_CLICKS, THRUPLAY).
+             */
+            billingEvent?: string;
+            /**
+             * Ad set start_time (ISO 8601).
+             */
+            startDate?: string;
+            /**
+             * Ad set end_time (ISO 8601).
+             */
+            endDate?: string;
+            /**
+             * Meta ad-set promoted_object, forwarded verbatim (same shape as /v1/ads/create).
+             */
+            promotedObject?: {
+                pixelId?: string;
+                customEventType?: string;
+                pageId?: string;
+                applicationId?: string;
+                objectStoreUrl?: string;
+                customConversionId?: string;
+                productCatalogId?: string;
+                productSetId?: string;
+            };
+        };
     };
     path: {
         /**
@@ -23268,6 +23319,9 @@ export type UpdateAdSetResponse = ({
     bidStrategy?: BidStrategy;
     bidAmount?: (number) | null;
     roasAverageFloor?: (number) | null;
+    platformSpecificData?: {
+        [key: string]: unknown;
+    };
 });
 
 export type UpdateAdSetError = (unknown | {
@@ -24330,6 +24384,10 @@ export type CreateStandaloneAdData = {
          * Meta only. Explicit ad-set `optimization_goal` (e.g. `LANDING_PAGE_VIEWS`, `LINK_CLICKS`, `REACH`, `IMPRESSIONS`, `OFFSITE_CONVERSIONS`, `THRUPLAY`, `LEAD_GENERATION`). Overrides the default derived from `goal` (e.g. `traffic` defaults to `LINK_CLICKS`). Forwarded verbatim to Meta, which validates compatibility with the campaign objective and rejects incompatible combinations.
          */
         optimizationGoal?: string;
+        /**
+         * Meta only. Explicit ad-set `billing_event`. Defaults to `IMPRESSIONS`. Forwarded verbatim to Meta, which validates compatibility with the optimization goal.
+         */
+        billingEvent?: string;
         /**
          * Required on legacy + multi-creative shapes. Inherited on attach.
          */