@zernio/node 0.2.921 → 0.2.923

package/dist/index.d.mts

@@ -3264,10 +3264,13 @@ type AnalyticsListResponse = {
          */
         isAd?: boolean;
         profileId?: (string) | null;
+        /**
+         * Cover image URL. Facebook and Instagram covers whose Meta CDN link expired are re-read from Meta and served from Zernio storage, so that URL does not expire and can be cached.
+         */
         thumbnailUrl?: string;
         mediaType?: 'image' | 'video' | 'gif' | 'document' | 'carousel' | 'text';
         /**
-         * All media items for this post. Carousel posts contain one entry per slide.
+         * All media items for this post. Carousel posts contain one entry per slide. Facebook and Instagram images and video covers whose Meta CDN links expired are re-read and served from Zernio storage (non-expiring). Facebook and Instagram video file URLs, and LinkedIn media URLs, stay the platform's signed links and are refreshed on read once they lapse.
          */
         mediaItems?: Array<{
             type?: 'image' | 'video';
@@ -3353,10 +3356,13 @@ type AnalyticsSinglePostResponse = {
      * Human-readable status message for pending, partial, or failed states
      */
     message?: (string) | null;
+    /**
+     * Cover image URL. Facebook and Instagram covers whose Meta CDN link expired are re-read from Meta and served from Zernio storage, so that URL does not expire and can be cached.
+     */
     thumbnailUrl?: (string) | null;
     mediaType?: ('image' | 'video' | 'carousel' | 'text') | null;
     /**
-     * All media items for this post. Carousel posts contain one entry per slide.
+     * All media items for this post. Carousel posts contain one entry per slide. Facebook and Instagram images and video covers whose Meta CDN links expired are re-read and served from Zernio storage (non-expiring). Facebook and Instagram video file URLs, and LinkedIn media URLs, stay the platform's signed links and are refreshed on read once they lapse.
      */
     mediaItems?: Array<{
         type?: 'image' | 'video';
@@ -35453,7 +35459,7 @@ type UpdateAdCampaignData = {
          */
         allowSharedBudgetUpdate?: boolean;
         /**
-         * Meta CBO or Google daily campaign budget, in whole currency units.
+         * Meta CBO, Google daily, or OpenAI Ads daily or lifetime campaign budget, in whole currency units.
          */
         budget?: {
             /**
@@ -36492,7 +36498,7 @@ type UpdateAdData = {
              */
             amount?: number;
             /**
-             * OpenAI Ads accepts lifetime only; sending daily returns 422.
+             * OpenAI Ads accepts both and sets the campaign's single spend cap, replacing the previous daily or lifetime cap.
              */
             type?: 'daily' | 'lifetime';
         };
@@ -40371,7 +40377,7 @@ type CreateStandaloneAdData = {
          */
         budgetAmount?: number;
         /**
-         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads accepts lifetime only (no daily-budget concept on the platform); sending daily returns 422. OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window.
+         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads creation accepts lifetime only; sending daily returns 422 (daily caps can be set afterwards with PUT /v1/ads/campaigns/{campaignId}). OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window.
          */
         budgetType?: 'daily' | 'lifetime';
         /**

package/dist/index.d.ts

@@ -3264,10 +3264,13 @@ type AnalyticsListResponse = {
          */
         isAd?: boolean;
         profileId?: (string) | null;
+        /**
+         * Cover image URL. Facebook and Instagram covers whose Meta CDN link expired are re-read from Meta and served from Zernio storage, so that URL does not expire and can be cached.
+         */
         thumbnailUrl?: string;
         mediaType?: 'image' | 'video' | 'gif' | 'document' | 'carousel' | 'text';
         /**
-         * All media items for this post. Carousel posts contain one entry per slide.
+         * All media items for this post. Carousel posts contain one entry per slide. Facebook and Instagram images and video covers whose Meta CDN links expired are re-read and served from Zernio storage (non-expiring). Facebook and Instagram video file URLs, and LinkedIn media URLs, stay the platform's signed links and are refreshed on read once they lapse.
          */
         mediaItems?: Array<{
             type?: 'image' | 'video';
@@ -3353,10 +3356,13 @@ type AnalyticsSinglePostResponse = {
      * Human-readable status message for pending, partial, or failed states
      */
     message?: (string) | null;
+    /**
+     * Cover image URL. Facebook and Instagram covers whose Meta CDN link expired are re-read from Meta and served from Zernio storage, so that URL does not expire and can be cached.
+     */
     thumbnailUrl?: (string) | null;
     mediaType?: ('image' | 'video' | 'carousel' | 'text') | null;
     /**
-     * All media items for this post. Carousel posts contain one entry per slide.
+     * All media items for this post. Carousel posts contain one entry per slide. Facebook and Instagram images and video covers whose Meta CDN links expired are re-read and served from Zernio storage (non-expiring). Facebook and Instagram video file URLs, and LinkedIn media URLs, stay the platform's signed links and are refreshed on read once they lapse.
      */
     mediaItems?: Array<{
         type?: 'image' | 'video';
@@ -35453,7 +35459,7 @@ type UpdateAdCampaignData = {
          */
         allowSharedBudgetUpdate?: boolean;
         /**
-         * Meta CBO or Google daily campaign budget, in whole currency units.
+         * Meta CBO, Google daily, or OpenAI Ads daily or lifetime campaign budget, in whole currency units.
          */
         budget?: {
             /**
@@ -36492,7 +36498,7 @@ type UpdateAdData = {
              */
             amount?: number;
             /**
-             * OpenAI Ads accepts lifetime only; sending daily returns 422.
+             * OpenAI Ads accepts both and sets the campaign's single spend cap, replacing the previous daily or lifetime cap.
              */
             type?: 'daily' | 'lifetime';
         };
@@ -40371,7 +40377,7 @@ type CreateStandaloneAdData = {
          */
         budgetAmount?: number;
         /**
-         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads accepts lifetime only (no daily-budget concept on the platform); sending daily returns 422. OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window.
+         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads creation accepts lifetime only; sending daily returns 422 (daily caps can be set afterwards with PUT /v1/ads/campaigns/{campaignId}). OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window.
          */
         budgetType?: 'daily' | 'lifetime';
         /**

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -8866,7 +8866,7 @@ export const getAdCampaignDetails = <ThrowOnError extends boolean = false>(optio
  * | `bidStrategy` | Yes | Yes | 501 |
  * | `bidAmount`, `roasAverageFloor` | 400 (ad-set level) | Yes | 400 |
  * | `portfolioBidStrategyId` | 400 | Yes | 400 |
- * | `budget` (CBO; ABO returns 409) | Yes | Daily only | 501 |
+ * | `budget` (CBO; ABO returns 409) | Yes | Daily only | OpenAI: daily or lifetime; others 501 |
  * | `name` | Yes | 501 | 501 |
  * | `platformSpecificData.spendCap` | Yes | 400 | 400 |
  * | `accountId` (empty campaigns) | Yes | - | - |
@@ -8887,6 +8887,10 @@ export const getAdCampaignDetails = <ThrowOnError extends boolean = false>(optio
  * 409 unless allowSharedBudgetUpdate=true is explicitly supplied, because the change
  * affects every campaign using that budget. Unknown sharing state also returns 409.
  *
+ * OpenAI Ads campaigns carry exactly one spend cap: `budget.type` daily or lifetime
+ * replaces whichever cap the campaign had, with a minimum of 1 in the ad account's
+ * currency (422 below it).
+ *
  * `accountId` forwards the update straight to Meta for a campaign with zero ads,
  * which would otherwise 404; the response then carries `updated: 0`.
  *
@@ -9392,7 +9396,7 @@ export const getAd = <ThrowOnError extends boolean = false>(options: OptionsLega
  * campaign, pauses the old one).
  * - **Pinterest / X / OpenAI Ads**: status + budget only. Sending
  * `targeting` or `creative` returns 501 with code `unsupported_platform_operation`.
- * OpenAI Ads budget is lifetime-only (see `budget.type` below).
+ * OpenAI Ads budget is the campaign's spend cap, daily or lifetime (see `budget.type` below).
  *
  * **Google location and language replacement:** locations, languages and devices are
  * campaign-level criteria on Google, so these edits apply to every ad group and ad in

package/src/generated/types.gen.ts

@@ -1620,10 +1620,13 @@ export type AnalyticsListResponse = {
          */
         isAd?: boolean;
         profileId?: (string) | null;
+        /**
+         * Cover image URL. Facebook and Instagram covers whose Meta CDN link expired are re-read from Meta and served from Zernio storage, so that URL does not expire and can be cached.
+         */
         thumbnailUrl?: string;
         mediaType?: 'image' | 'video' | 'gif' | 'document' | 'carousel' | 'text';
         /**
-         * All media items for this post. Carousel posts contain one entry per slide.
+         * All media items for this post. Carousel posts contain one entry per slide. Facebook and Instagram images and video covers whose Meta CDN links expired are re-read and served from Zernio storage (non-expiring). Facebook and Instagram video file URLs, and LinkedIn media URLs, stay the platform's signed links and are refreshed on read once they lapse.
          */
         mediaItems?: Array<{
             type?: 'image' | 'video';
@@ -1711,10 +1714,13 @@ export type AnalyticsSinglePostResponse = {
      * Human-readable status message for pending, partial, or failed states
      */
     message?: (string) | null;
+    /**
+     * Cover image URL. Facebook and Instagram covers whose Meta CDN link expired are re-read from Meta and served from Zernio storage, so that URL does not expire and can be cached.
+     */
     thumbnailUrl?: (string) | null;
     mediaType?: ('image' | 'video' | 'carousel' | 'text') | null;
     /**
-     * All media items for this post. Carousel posts contain one entry per slide.
+     * All media items for this post. Carousel posts contain one entry per slide. Facebook and Instagram images and video covers whose Meta CDN links expired are re-read and served from Zernio storage (non-expiring). Facebook and Instagram video file URLs, and LinkedIn media URLs, stay the platform's signed links and are refreshed on read once they lapse.
      */
     mediaItems?: Array<{
         type?: 'image' | 'video';
@@ -35808,7 +35814,7 @@ export type UpdateAdCampaignData = {
          */
         allowSharedBudgetUpdate?: boolean;
         /**
-         * Meta CBO or Google daily campaign budget, in whole currency units.
+         * Meta CBO, Google daily, or OpenAI Ads daily or lifetime campaign budget, in whole currency units.
          */
         budget?: {
             /**
@@ -36904,7 +36910,7 @@ export type UpdateAdData = {
              */
             amount?: number;
             /**
-             * OpenAI Ads accepts lifetime only; sending daily returns 422.
+             * OpenAI Ads accepts both and sets the campaign's single spend cap, replacing the previous daily or lifetime cap.
              */
             type?: 'daily' | 'lifetime';
         };
@@ -41029,7 +41035,7 @@ export type CreateStandaloneAdData = {
          */
         budgetAmount?: number;
         /**
-         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads accepts lifetime only (no daily-budget concept on the platform); sending daily returns 422. OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window.
+         * Required on legacy, multi-creative and Performance Max shapes. Inherited on attach. OpenAI Ads creation accepts lifetime only; sending daily returns 422 (daily caps can be set afterwards with PUT /v1/ads/campaigns/{campaignId}). OpenAI Ads lifetime budgets require `endDate` to give the lifetime cap a spend window.
          */
         budgetType?: 'daily' | 'lifetime';
         /**