@zernio/node 0.2.523 → 0.2.525

package/dist/index.d.mts

@@ -25990,10 +25990,28 @@ type UpdateAdCampaignStatusError = (unknown | {
 type UpdateAdCampaignData = {
     body: {
         /**
-         * Zernio SocialAccount id owning the ad account. Required only to update an EMPTY campaign (zero ads), which has no local Ad documents to resolve a token from.
+         * Required: platform campaign IDs are not globally unique.
+         */
+        platform: 'facebook' | 'instagram' | 'google';
+        /**
+         * **Meta only.** Zernio SocialAccount id owning the ad account. Needed only for an EMPTY campaign (zero ads); ignored otherwise.
          */
         accountId?: string;
-        platform: 'facebook' | 'instagram';
+        /**
+         * **Meta + Google.** On Meta, the campaign default that ad sets inherit unless they override it. On Google, the campaign's own bidding strategy.
+         */
+        bidStrategy?: (BidStrategy);
+        /**
+         * **Google only.** Whole currency units (USD: 12 = $12.00). Max CPC for LOWEST_COST_WITH_BID_CAP, CPA target for COST_CAP; required for both.
+         */
+        bidAmount?: number;
+        /**
+         * **Google only.** Decimal ROAS multiplier (2.0 = 2.0x), required for LOWEST_COST_WITH_MIN_ROAS.
+         */
+        roasAverageFloor?: number;
+        /**
+         * **Meta only.** The CBO budget.
+         */
         budget?: {
             /**
              * Budget amount in the ad account's currency
@@ -26002,22 +26020,15 @@ type UpdateAdCampaignData = {
             type: 'daily' | 'lifetime';
         };
         /**
-         * Campaign-level default. Ad sets inherit this unless they override.
-         */
-        bidStrategy?: (BidStrategy);
-        /**
-         * Rename the campaign (Meta only; other platforms return 501). At least one of budget/bidStrategy/name/platformSpecificData is required.
+         * **Meta only.** Rename the campaign.
          */
         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.
-         *
+         * **Meta only.** Platform implied by the `platform` body param, same convention as POST /v1/ads/create.
          */
         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).
+             * 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;
         };
@@ -26030,10 +26041,15 @@ type UpdateAdCampaignData = {
     };
 };
 type UpdateAdCampaignResponse = ({
+    /**
+     * Local Ad documents mirrored. 0 on the empty-campaign path.
+     */
     updated?: number;
     budget?: AdBudget;
     budgetLevel?: 'campaign';
     bidStrategy?: BidStrategy;
+    bidAmount?: number;
+    roasAverageFloor?: number;
     platformSpecificData?: {
         [key: string]: unknown;
     };
@@ -29587,10 +29603,11 @@ type CreateLeadFormData = {
             thankYouButtonText?: string;
             thankYouButtonType?: string;
             thankYouWebsiteUrl?: string;
+            /**
+             * Set true for a higher-intent form (adds a review step before submit).
+             */
             isOptimizedForQuality?: boolean;
-            formType?: 'MORE_VOLUME' | 'HIGHER_INTENT' | 'RICH_CREATIVE';
             blockDisplayForNonTargetedViewer?: boolean;
-            allowOrganicLeadGen?: boolean;
             questionPageCustomHeadline?: string;
             contextCard?: {
                 title?: string;

package/dist/index.d.ts

@@ -25990,10 +25990,28 @@ type UpdateAdCampaignStatusError = (unknown | {
 type UpdateAdCampaignData = {
     body: {
         /**
-         * Zernio SocialAccount id owning the ad account. Required only to update an EMPTY campaign (zero ads), which has no local Ad documents to resolve a token from.
+         * Required: platform campaign IDs are not globally unique.
+         */
+        platform: 'facebook' | 'instagram' | 'google';
+        /**
+         * **Meta only.** Zernio SocialAccount id owning the ad account. Needed only for an EMPTY campaign (zero ads); ignored otherwise.
          */
         accountId?: string;
-        platform: 'facebook' | 'instagram';
+        /**
+         * **Meta + Google.** On Meta, the campaign default that ad sets inherit unless they override it. On Google, the campaign's own bidding strategy.
+         */
+        bidStrategy?: (BidStrategy);
+        /**
+         * **Google only.** Whole currency units (USD: 12 = $12.00). Max CPC for LOWEST_COST_WITH_BID_CAP, CPA target for COST_CAP; required for both.
+         */
+        bidAmount?: number;
+        /**
+         * **Google only.** Decimal ROAS multiplier (2.0 = 2.0x), required for LOWEST_COST_WITH_MIN_ROAS.
+         */
+        roasAverageFloor?: number;
+        /**
+         * **Meta only.** The CBO budget.
+         */
         budget?: {
             /**
              * Budget amount in the ad account's currency
@@ -26002,22 +26020,15 @@ type UpdateAdCampaignData = {
             type: 'daily' | 'lifetime';
         };
         /**
-         * Campaign-level default. Ad sets inherit this unless they override.
-         */
-        bidStrategy?: (BidStrategy);
-        /**
-         * Rename the campaign (Meta only; other platforms return 501). At least one of budget/bidStrategy/name/platformSpecificData is required.
+         * **Meta only.** Rename the campaign.
          */
         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.
-         *
+         * **Meta only.** Platform implied by the `platform` body param, same convention as POST /v1/ads/create.
          */
         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).
+             * 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;
         };
@@ -26030,10 +26041,15 @@ type UpdateAdCampaignData = {
     };
 };
 type UpdateAdCampaignResponse = ({
+    /**
+     * Local Ad documents mirrored. 0 on the empty-campaign path.
+     */
     updated?: number;
     budget?: AdBudget;
     budgetLevel?: 'campaign';
     bidStrategy?: BidStrategy;
+    bidAmount?: number;
+    roasAverageFloor?: number;
     platformSpecificData?: {
         [key: string]: unknown;
     };
@@ -29587,10 +29603,11 @@ type CreateLeadFormData = {
             thankYouButtonText?: string;
             thankYouButtonType?: string;
             thankYouWebsiteUrl?: string;
+            /**
+             * Set true for a higher-intent form (adds a review step before submit).
+             */
             isOptimizedForQuality?: boolean;
-            formType?: 'MORE_VOLUME' | 'HIGHER_INTENT' | 'RICH_CREATIVE';
             blockDisplayForNonTargetedViewer?: boolean;
-            allowOrganicLeadGen?: boolean;
             questionPageCustomHeadline?: string;
             contextCard?: {
                 title?: string;

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -6838,23 +6838,28 @@ export const updateAdCampaignStatus = <ThrowOnError extends boolean = false>(opt
 
 /**
  * Update a campaign
- * Campaign-level edits. At least one of `budget`, `bidStrategy`, `name` or `platformSpecificData` is required.
- *
- * **Empty campaigns.** A campaign with zero ads has no local Ad documents to
- * resolve, so this would 404 even though it exists on Meta. Send `accountId`
- * in the body to skip the local lookup and forward the update to Meta. The
- * response then carries `updated: 0`, since there are no local rows to mirror
- * onto. `accountId` is ignored when the campaign does have ads.
- *
- * - `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.
+ * Campaign-level edits. Send at least one of `budget`, `bidStrategy`, `name`
+ * or `platformSpecificData`. An unsupported field is always an error, never a
+ * silent drop.
+ *
+ * | Body field | Meta | Google | Others |
+ * |---|---|---|---|
+ * | `bidStrategy` | Yes | Yes | 501 |
+ * | `bidAmount`, `roasAverageFloor` | 400 — ad-set level | Yes | 400 |
+ * | `budget` (CBO; ABO returns 409) | Yes | 501 | 501 |
+ * | `name` | Yes | 501 | 501 |
+ * | `platformSpecificData.spendCap` | Yes | 400 | 400 |
+ * | `accountId` (empty campaigns) | Yes | - | - |
+ *
+ * Google maps the shared enum onto its own strategies: `LOWEST_COST_WITHOUT_CAP`
+ * to Maximize Clicks, `LOWEST_COST_WITH_BID_CAP` to Maximize Clicks with a max
+ * CPC (`bidAmount`), `COST_CAP` to Target CPA (`bidAmount`),
+ * `LOWEST_COST_WITH_MIN_ROAS` to Target ROAS (`roasAverageFloor`). A campaign on
+ * a PORTFOLIO bidding strategy is rejected: detach it in Google Ads first, since
+ * it is shared across campaigns.
+ *
+ * `accountId` forwards the update straight to Meta for a campaign with zero ads,
+ * which would otherwise 404; the response then carries `updated: 0`.
  *
  */
 export const updateAdCampaign = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateAdCampaignData, ThrowOnError>) => {
@@ -6870,9 +6875,6 @@ export const updateAdCampaign = <ThrowOnError extends boolean = false>(options:
  * and ads. Locally, all Ad documents for this campaign are marked
  * `status: cancelled`.
  *
- * 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

package/src/generated/types.gen.ts

@@ -26368,10 +26368,28 @@ export type UpdateAdCampaignStatusError = (unknown | {
 export type UpdateAdCampaignData = {
     body: {
         /**
-         * Zernio SocialAccount id owning the ad account. Required only to update an EMPTY campaign (zero ads), which has no local Ad documents to resolve a token from.
+         * Required: platform campaign IDs are not globally unique.
+         */
+        platform: 'facebook' | 'instagram' | 'google';
+        /**
+         * **Meta only.** Zernio SocialAccount id owning the ad account. Needed only for an EMPTY campaign (zero ads); ignored otherwise.
          */
         accountId?: string;
-        platform: 'facebook' | 'instagram';
+        /**
+         * **Meta + Google.** On Meta, the campaign default that ad sets inherit unless they override it. On Google, the campaign's own bidding strategy.
+         */
+        bidStrategy?: (BidStrategy);
+        /**
+         * **Google only.** Whole currency units (USD: 12 = $12.00). Max CPC for LOWEST_COST_WITH_BID_CAP, CPA target for COST_CAP; required for both.
+         */
+        bidAmount?: number;
+        /**
+         * **Google only.** Decimal ROAS multiplier (2.0 = 2.0x), required for LOWEST_COST_WITH_MIN_ROAS.
+         */
+        roasAverageFloor?: number;
+        /**
+         * **Meta only.** The CBO budget.
+         */
         budget?: {
             /**
              * Budget amount in the ad account's currency
@@ -26380,22 +26398,15 @@ export type UpdateAdCampaignData = {
             type: 'daily' | 'lifetime';
         };
         /**
-         * Campaign-level default. Ad sets inherit this unless they override.
-         */
-        bidStrategy?: (BidStrategy);
-        /**
-         * Rename the campaign (Meta only; other platforms return 501). At least one of budget/bidStrategy/name/platformSpecificData is required.
+         * **Meta only.** Rename the campaign.
          */
         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.
-         *
+         * **Meta only.** Platform implied by the `platform` body param, same convention as POST /v1/ads/create.
          */
         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).
+             * 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;
         };
@@ -26409,10 +26420,15 @@ export type UpdateAdCampaignData = {
 };
 
 export type UpdateAdCampaignResponse = ({
+    /**
+     * Local Ad documents mirrored. 0 on the empty-campaign path.
+     */
     updated?: number;
     budget?: AdBudget;
     budgetLevel?: 'campaign';
     bidStrategy?: BidStrategy;
+    bidAmount?: number;
+    roasAverageFloor?: number;
     platformSpecificData?: {
         [key: string]: unknown;
     };
@@ -30133,10 +30149,11 @@ export type CreateLeadFormData = {
     thankYouButtonText?: string;
     thankYouButtonType?: string;
     thankYouWebsiteUrl?: string;
+    /**
+     * Set true for a higher-intent form (adds a review step before submit).
+     */
     isOptimizedForQuality?: boolean;
-    formType?: 'MORE_VOLUME' | 'HIGHER_INTENT' | 'RICH_CREATIVE';
     blockDisplayForNonTargetedViewer?: boolean;
-    allowOrganicLeadGen?: boolean;
     questionPageCustomHeadline?: string;
     contextCard?: {
         title?: string;