@zernio/node 0.2.202 → 0.2.204

package/dist/index.d.mts

@@ -3113,13 +3113,13 @@ type RecyclingConfig = {
      */
     startDate?: string;
     /**
-     * Stop recycling after this many copies have been created
+     * Stop recycling after this many copies have been created. Send null on update to clear this limit.
      */
-    expireCount?: number;
+    expireCount?: (number) | null;
     /**
-     * Stop recycling after this date, regardless of count
+     * Stop recycling after this date, regardless of count. Send null on update to clear this limit.
      */
-    expireDate?: string;
+    expireDate?: (string) | null;
     /**
      * Array of content variations for recycled copies. On each recycle, the next
      * variation is used in round-robin order. Recommended for Twitter and Pinterest
@@ -6997,8 +6997,8 @@ type CreatePostData = {
          * Target platforms and accounts for this post. Required for non-draft posts (returns 400 if empty). Drafts can omit platforms.
          */
         platforms?: Array<{
-            platform?: string;
-            accountId?: string;
+            platform: string;
+            accountId: string;
             /**
              * Platform-specific text override. When set, this content is used instead of the top-level post content for this platform. Useful for tailoring captions per platform (e.g. keeping tweets under 280 characters).
              */
@@ -7089,8 +7089,48 @@ type GetPostError = ({
 } | unknown);
 type UpdatePostData = {
     body: {
+        title?: string;
         content?: string;
+        mediaItems?: Array<MediaItem>;
+        /**
+         * Target platforms and accounts for this post. Each item must include platform and accountId.
+         */
+        platforms?: Array<{
+            platform: string;
+            accountId: string;
+            /**
+             * Platform-specific text override.
+             */
+            customContent?: string;
+            customMedia?: Array<MediaItem>;
+            /**
+             * Optional per-platform scheduled time override.
+             */
+            scheduledFor?: string;
+            platformSpecificData?: {
+                [key: string]: unknown;
+            };
+        }>;
         scheduledFor?: string;
+        publishNow?: boolean;
+        isDraft?: boolean;
+        timezone?: string;
+        visibility?: 'public' | 'private' | 'unlisted';
+        tags?: Array<(string)>;
+        hashtags?: Array<(string)>;
+        mentions?: Array<(string)>;
+        crosspostingEnabled?: boolean;
+        metadata?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Profile ID to schedule via queue.
+         */
+        queuedFromProfile?: string;
+        /**
+         * Specific queue ID to use when scheduling via queue.
+         */
+        queueId?: string;
         /**
          * Root-level TikTok settings applied to all TikTok platforms. Merged into each platform's platformSpecificData, with platform-specific settings taking precedence.
          */
@@ -7100,7 +7140,7 @@ type UpdatePostData = {
          */
         facebookSettings?: FacebookPlatformData;
         recycling?: RecyclingConfig;
-        [key: string]: unknown | string | TikTokPlatformData | FacebookPlatformData | RecyclingConfig;
+        [key: string]: unknown | string | MediaItem | boolean | TikTokPlatformData | FacebookPlatformData | RecyclingConfig;
     };
     path: {
         postId: string;
@@ -17886,6 +17926,50 @@ type CreateStandaloneAdData = {
              */
             adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
         };
+        /**
+         * Meta only. Placement asset customization: pin a SPECIFIC image to each placement
+         * group on a SINGLE ad (e.g. a 9:16 image on Stories/Reels and a 4:5 on Feed). This
+         * is the same thing Meta Ads Manager produces with "different creative per placement",
+         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. It is
+         * deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (the two are
+         * mutually exclusive, and it cannot be combined with `creatives[]` or `adSetId`). The
+         * shared copy (headline, body, link, CTA) comes from the top-level single-creative
+         * fields (`headline`, `body`, `linkUrl`, `callToAction`) since only the image varies by
+         * placement. Each rule's `placements` accepts the same fields as the top-level
+         * `placements` object; Meta enforces co-selection rules and returns an actionable error.
+         *
+         */
+        placementAssets?: {
+            /**
+             * Catch-all image for any placement not matched by a rule. REQUIRED — Meta mandates
+             * a default asset customization rule (empty placement spec, lowest priority) on every
+             * placement-customized creative.
+             *
+             */
+            defaultImageUrl: string;
+            /**
+             * One entry per placement group you want to pin a specific image to.
+             */
+            rules: Array<{
+                /**
+                 * The image to deliver for this rule's placements.
+                 */
+                imageUrl: string;
+                /**
+                 * Placements this image is pinned to. At least one field must be set (an empty rule is invalid — that role is served by defaultImageUrl). Same enums as the top-level `placements` object.
+                 */
+                placements: {
+                    publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;
+                    facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+                    instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+                    messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+                    audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+                    threadsPositions?: Array<('threads_stream')>;
+                    whatsappPositions?: Array<('status')>;
+                    devicePlatforms?: Array<('mobile' | 'desktop')>;
+                };
+            }>;
+        };
         /**
          * Custom audience ID for targeting
          */

package/dist/index.d.ts

@@ -3113,13 +3113,13 @@ type RecyclingConfig = {
      */
     startDate?: string;
     /**
-     * Stop recycling after this many copies have been created
+     * Stop recycling after this many copies have been created. Send null on update to clear this limit.
      */
-    expireCount?: number;
+    expireCount?: (number) | null;
     /**
-     * Stop recycling after this date, regardless of count
+     * Stop recycling after this date, regardless of count. Send null on update to clear this limit.
      */
-    expireDate?: string;
+    expireDate?: (string) | null;
     /**
      * Array of content variations for recycled copies. On each recycle, the next
      * variation is used in round-robin order. Recommended for Twitter and Pinterest
@@ -6997,8 +6997,8 @@ type CreatePostData = {
          * Target platforms and accounts for this post. Required for non-draft posts (returns 400 if empty). Drafts can omit platforms.
          */
         platforms?: Array<{
-            platform?: string;
-            accountId?: string;
+            platform: string;
+            accountId: string;
             /**
              * Platform-specific text override. When set, this content is used instead of the top-level post content for this platform. Useful for tailoring captions per platform (e.g. keeping tweets under 280 characters).
              */
@@ -7089,8 +7089,48 @@ type GetPostError = ({
 } | unknown);
 type UpdatePostData = {
     body: {
+        title?: string;
         content?: string;
+        mediaItems?: Array<MediaItem>;
+        /**
+         * Target platforms and accounts for this post. Each item must include platform and accountId.
+         */
+        platforms?: Array<{
+            platform: string;
+            accountId: string;
+            /**
+             * Platform-specific text override.
+             */
+            customContent?: string;
+            customMedia?: Array<MediaItem>;
+            /**
+             * Optional per-platform scheduled time override.
+             */
+            scheduledFor?: string;
+            platformSpecificData?: {
+                [key: string]: unknown;
+            };
+        }>;
         scheduledFor?: string;
+        publishNow?: boolean;
+        isDraft?: boolean;
+        timezone?: string;
+        visibility?: 'public' | 'private' | 'unlisted';
+        tags?: Array<(string)>;
+        hashtags?: Array<(string)>;
+        mentions?: Array<(string)>;
+        crosspostingEnabled?: boolean;
+        metadata?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Profile ID to schedule via queue.
+         */
+        queuedFromProfile?: string;
+        /**
+         * Specific queue ID to use when scheduling via queue.
+         */
+        queueId?: string;
         /**
          * Root-level TikTok settings applied to all TikTok platforms. Merged into each platform's platformSpecificData, with platform-specific settings taking precedence.
          */
@@ -7100,7 +7140,7 @@ type UpdatePostData = {
          */
         facebookSettings?: FacebookPlatformData;
         recycling?: RecyclingConfig;
-        [key: string]: unknown | string | TikTokPlatformData | FacebookPlatformData | RecyclingConfig;
+        [key: string]: unknown | string | MediaItem | boolean | TikTokPlatformData | FacebookPlatformData | RecyclingConfig;
     };
     path: {
         postId: string;
@@ -17886,6 +17926,50 @@ type CreateStandaloneAdData = {
              */
             adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
         };
+        /**
+         * Meta only. Placement asset customization: pin a SPECIFIC image to each placement
+         * group on a SINGLE ad (e.g. a 9:16 image on Stories/Reels and a 4:5 on Feed). This
+         * is the same thing Meta Ads Manager produces with "different creative per placement",
+         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. It is
+         * deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (the two are
+         * mutually exclusive, and it cannot be combined with `creatives[]` or `adSetId`). The
+         * shared copy (headline, body, link, CTA) comes from the top-level single-creative
+         * fields (`headline`, `body`, `linkUrl`, `callToAction`) since only the image varies by
+         * placement. Each rule's `placements` accepts the same fields as the top-level
+         * `placements` object; Meta enforces co-selection rules and returns an actionable error.
+         *
+         */
+        placementAssets?: {
+            /**
+             * Catch-all image for any placement not matched by a rule. REQUIRED — Meta mandates
+             * a default asset customization rule (empty placement spec, lowest priority) on every
+             * placement-customized creative.
+             *
+             */
+            defaultImageUrl: string;
+            /**
+             * One entry per placement group you want to pin a specific image to.
+             */
+            rules: Array<{
+                /**
+                 * The image to deliver for this rule's placements.
+                 */
+                imageUrl: string;
+                /**
+                 * Placements this image is pinned to. At least one field must be set (an empty rule is invalid — that role is served by defaultImageUrl). Same enums as the top-level `placements` object.
+                 */
+                placements: {
+                    publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;
+                    facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+                    instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+                    messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+                    audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+                    threadsPositions?: Array<('threads_stream')>;
+                    whatsappPositions?: Array<('status')>;
+                    devicePlatforms?: Array<('mobile' | 'desktop')>;
+                };
+            }>;
+        };
         /**
          * Custom audience ID for targeting
          */

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -551,8 +551,8 @@ export const getPost = <ThrowOnError extends boolean = false>(options: OptionsLe
 
 /**
  * Update post
- * Update an existing post. Only draft, scheduled, failed, and partial posts can be edited.
- * Published, publishing, and cancelled posts cannot be modified.
+ * Update an existing post. Draft, scheduled, failed, partial, and cancelled posts can be edited.
+ * Published posts can only have their recycling config updated.
  *
  */
 export const updatePost = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdatePostData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -2498,13 +2498,13 @@ export type RecyclingConfig = {
      */
     startDate?: string;
     /**
-     * Stop recycling after this many copies have been created
+     * Stop recycling after this many copies have been created. Send null on update to clear this limit.
      */
-    expireCount?: number;
+    expireCount?: (number) | null;
     /**
-     * Stop recycling after this date, regardless of count
+     * Stop recycling after this date, regardless of count. Send null on update to clear this limit.
      */
-    expireDate?: string;
+    expireDate?: (string) | null;
     /**
      * Array of content variations for recycled copies. On each recycle, the next
      * variation is used in round-robin order. Recommended for Twitter and Pinterest
@@ -6594,8 +6594,8 @@ export type CreatePostData = {
          * Target platforms and accounts for this post. Required for non-draft posts (returns 400 if empty). Drafts can omit platforms.
          */
         platforms?: Array<{
-            platform?: string;
-            accountId?: string;
+            platform: string;
+            accountId: string;
             /**
              * Platform-specific text override. When set, this content is used instead of the top-level post content for this platform. Useful for tailoring captions per platform (e.g. keeping tweets under 280 characters).
              */
@@ -6692,8 +6692,48 @@ export type GetPostError = ({
 
 export type UpdatePostData = {
     body: {
+        title?: string;
         content?: string;
+        mediaItems?: Array<MediaItem>;
+        /**
+         * Target platforms and accounts for this post. Each item must include platform and accountId.
+         */
+        platforms?: Array<{
+            platform: string;
+            accountId: string;
+            /**
+             * Platform-specific text override.
+             */
+            customContent?: string;
+            customMedia?: Array<MediaItem>;
+            /**
+             * Optional per-platform scheduled time override.
+             */
+            scheduledFor?: string;
+            platformSpecificData?: {
+                [key: string]: unknown;
+            };
+        }>;
         scheduledFor?: string;
+        publishNow?: boolean;
+        isDraft?: boolean;
+        timezone?: string;
+        visibility?: 'public' | 'private' | 'unlisted';
+        tags?: Array<(string)>;
+        hashtags?: Array<(string)>;
+        mentions?: Array<(string)>;
+        crosspostingEnabled?: boolean;
+        metadata?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Profile ID to schedule via queue.
+         */
+        queuedFromProfile?: string;
+        /**
+         * Specific queue ID to use when scheduling via queue.
+         */
+        queueId?: string;
         /**
          * Root-level TikTok settings applied to all TikTok platforms. Merged into each platform's platformSpecificData, with platform-specific settings taking precedence.
          */
@@ -6703,7 +6743,7 @@ export type UpdatePostData = {
          */
         facebookSettings?: FacebookPlatformData;
         recycling?: RecyclingConfig;
-        [key: string]: unknown | string | TikTokPlatformData | FacebookPlatformData | RecyclingConfig;
+        [key: string]: unknown | string | MediaItem | boolean | TikTokPlatformData | FacebookPlatformData | RecyclingConfig;
     };
     path: {
         postId: string;
@@ -18348,6 +18388,50 @@ export type CreateStandaloneAdData = {
              */
             adFormat?: 'SINGLE_IMAGE' | 'CAROUSEL_IMAGE';
         };
+        /**
+         * Meta only. Placement asset customization: pin a SPECIFIC image to each placement
+         * group on a SINGLE ad (e.g. a 9:16 image on Stories/Reels and a 4:5 on Feed). This
+         * is the same thing Meta Ads Manager produces with "different creative per placement",
+         * mapped to the creative's `asset_feed_spec` + `asset_customization_rules`. It is
+         * deterministic pinning, NOT the auto-optimizing pool of `dynamicCreative` (the two are
+         * mutually exclusive, and it cannot be combined with `creatives[]` or `adSetId`). The
+         * shared copy (headline, body, link, CTA) comes from the top-level single-creative
+         * fields (`headline`, `body`, `linkUrl`, `callToAction`) since only the image varies by
+         * placement. Each rule's `placements` accepts the same fields as the top-level
+         * `placements` object; Meta enforces co-selection rules and returns an actionable error.
+         *
+         */
+        placementAssets?: {
+            /**
+             * Catch-all image for any placement not matched by a rule. REQUIRED — Meta mandates
+             * a default asset customization rule (empty placement spec, lowest priority) on every
+             * placement-customized creative.
+             *
+             */
+            defaultImageUrl: string;
+            /**
+             * One entry per placement group you want to pin a specific image to.
+             */
+            rules: Array<{
+                /**
+                 * The image to deliver for this rule's placements.
+                 */
+                imageUrl: string;
+                /**
+                 * Placements this image is pinned to. At least one field must be set (an empty rule is invalid — that role is served by defaultImageUrl). Same enums as the top-level `placements` object.
+                 */
+                placements: {
+                    publisherPlatforms?: Array<('facebook' | 'instagram' | 'threads' | 'messenger' | 'audience_network')>;
+                    facebookPositions?: Array<('feed' | 'right_hand_column' | 'marketplace' | 'video_feeds' | 'story' | 'search' | 'instream_video' | 'facebook_reels' | 'facebook_reels_overlay' | 'profile_feed' | 'notification')>;
+                    instagramPositions?: Array<('stream' | 'story' | 'explore' | 'explore_home' | 'reels' | 'profile_feed' | 'ig_search' | 'profile_reels')>;
+                    messengerPositions?: Array<('messenger_home' | 'sponsored_messages' | 'story')>;
+                    audienceNetworkPositions?: Array<('classic' | 'rewarded_video')>;
+                    threadsPositions?: Array<('threads_stream')>;
+                    whatsappPositions?: Array<('status')>;
+                    devicePlatforms?: Array<('mobile' | 'desktop')>;
+                };
+            }>;
+        };
         /**
          * Custom audience ID for targeting
          */