naystack 1.8.15 → 1.8.17

package/dist/socials/instagram/setters.cjs.js

@@ -99,25 +99,47 @@ function createPublisher(platform) {
     }
     return true;
   };
+  const createReady = async (token, params, label, wait, retry) => {
+    const attempts = Math.max(1, retry?.attempts ?? 3);
+    const backoffMS = retry?.backoffMS ?? 2e3;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+      const id = await platform.createContainer(token, params);
+      if (id && await isReady(token, id, label, wait)) return id;
+      if (attempt < attempts) {
+        const delay = backoffMS * 2 ** (attempt - 1);
+        console.warn(
+          `[naystack] ${platform.name} ${label} attempt ${attempt}/${attempts} failed \u2014 retrying in ${delay}ms`
+        );
+        await sleep(delay);
+      }
+    }
+    return null;
+  };
   return {
     /** Creates a container, waits for it to finish processing, then publishes it. */
-    publish: async (token, params, wait) => {
-      const containerID = await platform.createContainer(token, params);
+    publish: async (token, params, wait, retry) => {
+      const containerID = await createReady(
+        token,
+        params,
+        "container",
+        wait,
+        retry
+      );
       if (!containerID) return null;
-      if (!await isReady(token, containerID, "container", wait)) return null;
       return platform.publish(token, containerID);
     },
     /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
-    createChildren: async (token, items, wait) => {
+    createChildren: async (token, items, wait, retry) => {
       const children = [];
       for (const item of items) {
-        const childID = await platform.createContainer(token, {
-          ...item,
-          is_carousel_item: true
-        });
+        const childID = await createReady(
+          token,
+          { ...item, is_carousel_item: true },
+          "carousel item",
+          wait,
+          retry
+        );
         if (!childID) return null;
-        if (!await isReady(token, childID, "carousel item", wait))
-          return null;
         children.push(childID);
       }
       return children;
@@ -168,14 +190,16 @@ var createInstagramPost = async (token, input) => {
         media_type: "STORIES",
         alt_text: void 0
       },
-      input.wait
+      input.wait,
+      input.retry
     );
   }
   if (media.length > 1) {
     const children = await publisher.createChildren(
       token,
       media.map(mediaParams),
-      input.wait
+      input.wait,
+      input.retry
     );
     if (!children) return null;
     return publisher.publish(
@@ -185,7 +209,8 @@ var createInstagramPost = async (token, input) => {
         children: children.join(","),
         caption: input.caption
       },
-      input.wait
+      input.wait,
+      input.retry
     );
   }
   if (first.type === "video" /* Video */) {
@@ -201,7 +226,8 @@ var createInstagramPost = async (token, input) => {
         audio_name: input.audioName,
         collaborators: input.collaborators && JSON.stringify(input.collaborators)
       },
-      input.wait
+      input.wait,
+      input.retry
     );
   }
   return publisher.publish(
@@ -212,7 +238,8 @@ var createInstagramPost = async (token, input) => {
       alt_text: first.altText,
       location_id: input.locationID
     },
-    input.wait
+    input.wait,
+    input.retry
   );
 };
 var sendInstagramMessage = (token, to, text) => {

package/dist/socials/instagram/setters.esm.js

@@ -72,25 +72,47 @@ function createPublisher(platform) {
     }
     return true;
   };
+  const createReady = async (token, params, label, wait, retry) => {
+    const attempts = Math.max(1, retry?.attempts ?? 3);
+    const backoffMS = retry?.backoffMS ?? 2e3;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+      const id = await platform.createContainer(token, params);
+      if (id && await isReady(token, id, label, wait)) return id;
+      if (attempt < attempts) {
+        const delay = backoffMS * 2 ** (attempt - 1);
+        console.warn(
+          `[naystack] ${platform.name} ${label} attempt ${attempt}/${attempts} failed \u2014 retrying in ${delay}ms`
+        );
+        await sleep(delay);
+      }
+    }
+    return null;
+  };
   return {
     /** Creates a container, waits for it to finish processing, then publishes it. */
-    publish: async (token, params, wait) => {
-      const containerID = await platform.createContainer(token, params);
+    publish: async (token, params, wait, retry) => {
+      const containerID = await createReady(
+        token,
+        params,
+        "container",
+        wait,
+        retry
+      );
       if (!containerID) return null;
-      if (!await isReady(token, containerID, "container", wait)) return null;
       return platform.publish(token, containerID);
     },
     /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
-    createChildren: async (token, items, wait) => {
+    createChildren: async (token, items, wait, retry) => {
       const children = [];
       for (const item of items) {
-        const childID = await platform.createContainer(token, {
-          ...item,
-          is_carousel_item: true
-        });
+        const childID = await createReady(
+          token,
+          { ...item, is_carousel_item: true },
+          "carousel item",
+          wait,
+          retry
+        );
         if (!childID) return null;
-        if (!await isReady(token, childID, "carousel item", wait))
-          return null;
         children.push(childID);
       }
       return children;
@@ -141,14 +163,16 @@ var createInstagramPost = async (token, input) => {
         media_type: "STORIES",
         alt_text: void 0
       },
-      input.wait
+      input.wait,
+      input.retry
     );
   }
   if (media.length > 1) {
     const children = await publisher.createChildren(
       token,
       media.map(mediaParams),
-      input.wait
+      input.wait,
+      input.retry
     );
     if (!children) return null;
     return publisher.publish(
@@ -158,7 +182,8 @@ var createInstagramPost = async (token, input) => {
         children: children.join(","),
         caption: input.caption
       },
-      input.wait
+      input.wait,
+      input.retry
     );
   }
   if (first.type === "video" /* Video */) {
@@ -174,7 +199,8 @@ var createInstagramPost = async (token, input) => {
         audio_name: input.audioName,
         collaborators: input.collaborators && JSON.stringify(input.collaborators)
       },
-      input.wait
+      input.wait,
+      input.retry
     );
   }
   return publisher.publish(
@@ -185,7 +211,8 @@ var createInstagramPost = async (token, input) => {
       alt_text: first.altText,
       location_id: input.locationID
     },
-    input.wait
+    input.wait,
+    input.retry
   );
 };
 var sendInstagramMessage = (token, to, text) => {

package/dist/socials/instagram/types.d.mts

@@ -1,4 +1,4 @@
-import { WaitForContainerOptions } from '../meta/container.mjs';
+import { WaitForContainerOptions, RetryOptions } from '../meta/container.mjs';
 import { MetaMediaType } from '../meta/types.mjs';
 
 /**
@@ -121,6 +121,7 @@ type InstagramPostMedia = {
  * @property audioName - Reels: name for the audio track. Can only be set once.
  * @property collaborators - Reels: up to 3 public usernames to invite as collaborators.
  * @property wait - Container polling settings.
+ * @property retry - Container-creation retry settings. See {@link RetryOptions}.
  *
  * @category Socials
  */
@@ -135,6 +136,7 @@ type InstagramPostInput = {
     audioName?: string;
     collaborators?: string[];
     wait?: WaitForContainerOptions;
+    retry?: RetryOptions;
 };
 
 export type { InstagramConversation, InstagramMedia, InstagramMessage, InstagramPostInput, InstagramPostMedia, InstagramUser };

package/dist/socials/instagram/types.d.ts

@@ -1,4 +1,4 @@
-import { WaitForContainerOptions } from '../meta/container.js';
+import { WaitForContainerOptions, RetryOptions } from '../meta/container.js';
 import { MetaMediaType } from '../meta/types.js';
 
 /**
@@ -121,6 +121,7 @@ type InstagramPostMedia = {
  * @property audioName - Reels: name for the audio track. Can only be set once.
  * @property collaborators - Reels: up to 3 public usernames to invite as collaborators.
  * @property wait - Container polling settings.
+ * @property retry - Container-creation retry settings. See {@link RetryOptions}.
  *
  * @category Socials
  */
@@ -135,6 +136,7 @@ type InstagramPostInput = {
     audioName?: string;
     collaborators?: string[];
     wait?: WaitForContainerOptions;
+    retry?: RetryOptions;
 };
 
 export type { InstagramConversation, InstagramMedia, InstagramMessage, InstagramPostInput, InstagramPostMedia, InstagramUser };

package/dist/socials/meta/container.cjs.js

@@ -51,25 +51,47 @@ function createPublisher(platform) {
     }
     return true;
   };
+  const createReady = async (token, params, label, wait, retry) => {
+    const attempts = Math.max(1, retry?.attempts ?? 3);
+    const backoffMS = retry?.backoffMS ?? 2e3;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+      const id = await platform.createContainer(token, params);
+      if (id && await isReady(token, id, label, wait)) return id;
+      if (attempt < attempts) {
+        const delay = backoffMS * 2 ** (attempt - 1);
+        console.warn(
+          `[naystack] ${platform.name} ${label} attempt ${attempt}/${attempts} failed \u2014 retrying in ${delay}ms`
+        );
+        await sleep(delay);
+      }
+    }
+    return null;
+  };
   return {
     /** Creates a container, waits for it to finish processing, then publishes it. */
-    publish: async (token, params, wait) => {
-      const containerID = await platform.createContainer(token, params);
+    publish: async (token, params, wait, retry) => {
+      const containerID = await createReady(
+        token,
+        params,
+        "container",
+        wait,
+        retry
+      );
       if (!containerID) return null;
-      if (!await isReady(token, containerID, "container", wait)) return null;
       return platform.publish(token, containerID);
     },
     /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
-    createChildren: async (token, items, wait) => {
+    createChildren: async (token, items, wait, retry) => {
       const children = [];
       for (const item of items) {
-        const childID = await platform.createContainer(token, {
-          ...item,
-          is_carousel_item: true
-        });
+        const childID = await createReady(
+          token,
+          { ...item, is_carousel_item: true },
+          "carousel item",
+          wait,
+          retry
+        );
         if (!childID) return null;
-        if (!await isReady(token, childID, "carousel item", wait))
-          return null;
         children.push(childID);
       }
       return children;

package/dist/socials/meta/container.d.mts

@@ -12,6 +12,24 @@ type WaitForContainerOptions = {
     intervalMS?: number;
     timeoutMS?: number;
 };
+/**
+ * Retry settings for creating a media container.
+ *
+ * Meta intermittently rejects a perfectly valid container — most visibly on
+ * carousels, where one arbitrary child fails with "Only photo or video can be
+ * accepted as media type." and the identical call succeeds moments later. The
+ * failure is transient and carries no distinguishing error code, so container
+ * creation is simply retried rather than pattern-matched against Meta's copy.
+ *
+ * @property attempts - Total tries, including the first. Default: `3`.
+ * @property backoffMS - Delay before the second try, doubled each time after. Default: `2000`.
+ *
+ * @category Socials
+ */
+type RetryOptions = {
+    attempts?: number;
+    backoffMS?: number;
+};
 /**
  * Wires up the create → wait → publish flow Meta platforms share. Instagram and
  * Threads differ only in their endpoints, so each builds one publisher and every
@@ -30,9 +48,9 @@ declare function createPublisher(platform: {
     publish: (token: string, creationID: string) => Promise<string | null>;
 }): {
     /** Creates a container, waits for it to finish processing, then publishes it. */
-    publish: (token: string, params: GraphParams, wait?: WaitForContainerOptions) => Promise<string | null>;
+    publish: (token: string, params: GraphParams, wait?: WaitForContainerOptions, retry?: RetryOptions) => Promise<string | null>;
     /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
-    createChildren: (token: string, items: GraphParams[], wait?: WaitForContainerOptions) => Promise<string[] | null>;
+    createChildren: (token: string, items: GraphParams[], wait?: WaitForContainerOptions, retry?: RetryOptions) => Promise<string[] | null>;
 };
 
-export { type WaitForContainerOptions, createPublisher };
+export { type RetryOptions, type WaitForContainerOptions, createPublisher };

package/dist/socials/meta/container.d.ts

@@ -12,6 +12,24 @@ type WaitForContainerOptions = {
     intervalMS?: number;
     timeoutMS?: number;
 };
+/**
+ * Retry settings for creating a media container.
+ *
+ * Meta intermittently rejects a perfectly valid container — most visibly on
+ * carousels, where one arbitrary child fails with "Only photo or video can be
+ * accepted as media type." and the identical call succeeds moments later. The
+ * failure is transient and carries no distinguishing error code, so container
+ * creation is simply retried rather than pattern-matched against Meta's copy.
+ *
+ * @property attempts - Total tries, including the first. Default: `3`.
+ * @property backoffMS - Delay before the second try, doubled each time after. Default: `2000`.
+ *
+ * @category Socials
+ */
+type RetryOptions = {
+    attempts?: number;
+    backoffMS?: number;
+};
 /**
  * Wires up the create → wait → publish flow Meta platforms share. Instagram and
  * Threads differ only in their endpoints, so each builds one publisher and every
@@ -30,9 +48,9 @@ declare function createPublisher(platform: {
     publish: (token: string, creationID: string) => Promise<string | null>;
 }): {
     /** Creates a container, waits for it to finish processing, then publishes it. */
-    publish: (token: string, params: GraphParams, wait?: WaitForContainerOptions) => Promise<string | null>;
+    publish: (token: string, params: GraphParams, wait?: WaitForContainerOptions, retry?: RetryOptions) => Promise<string | null>;
     /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
-    createChildren: (token: string, items: GraphParams[], wait?: WaitForContainerOptions) => Promise<string[] | null>;
+    createChildren: (token: string, items: GraphParams[], wait?: WaitForContainerOptions, retry?: RetryOptions) => Promise<string[] | null>;
 };
 
-export { type WaitForContainerOptions, createPublisher };
+export { type RetryOptions, type WaitForContainerOptions, createPublisher };

package/dist/socials/meta/container.esm.js

@@ -27,25 +27,47 @@ function createPublisher(platform) {
     }
     return true;
   };
+  const createReady = async (token, params, label, wait, retry) => {
+    const attempts = Math.max(1, retry?.attempts ?? 3);
+    const backoffMS = retry?.backoffMS ?? 2e3;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+      const id = await platform.createContainer(token, params);
+      if (id && await isReady(token, id, label, wait)) return id;
+      if (attempt < attempts) {
+        const delay = backoffMS * 2 ** (attempt - 1);
+        console.warn(
+          `[naystack] ${platform.name} ${label} attempt ${attempt}/${attempts} failed \u2014 retrying in ${delay}ms`
+        );
+        await sleep(delay);
+      }
+    }
+    return null;
+  };
   return {
     /** Creates a container, waits for it to finish processing, then publishes it. */
-    publish: async (token, params, wait) => {
-      const containerID = await platform.createContainer(token, params);
+    publish: async (token, params, wait, retry) => {
+      const containerID = await createReady(
+        token,
+        params,
+        "container",
+        wait,
+        retry
+      );
       if (!containerID) return null;
-      if (!await isReady(token, containerID, "container", wait)) return null;
       return platform.publish(token, containerID);
     },
     /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
-    createChildren: async (token, items, wait) => {
+    createChildren: async (token, items, wait, retry) => {
       const children = [];
       for (const item of items) {
-        const childID = await platform.createContainer(token, {
-          ...item,
-          is_carousel_item: true
-        });
+        const childID = await createReady(
+          token,
+          { ...item, is_carousel_item: true },
+          "carousel item",
+          wait,
+          retry
+        );
         if (!childID) return null;
-        if (!await isReady(token, childID, "carousel item", wait))
-          return null;
         children.push(childID);
       }
       return children;

package/dist/socials/threads/setters.cjs.js

@@ -54,25 +54,47 @@ function createPublisher(platform) {
     }
     return true;
   };
+  const createReady = async (token, params, label, wait, retry) => {
+    const attempts = Math.max(1, retry?.attempts ?? 3);
+    const backoffMS = retry?.backoffMS ?? 2e3;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+      const id = await platform.createContainer(token, params);
+      if (id && await isReady(token, id, label, wait)) return id;
+      if (attempt < attempts) {
+        const delay = backoffMS * 2 ** (attempt - 1);
+        console.warn(
+          `[naystack] ${platform.name} ${label} attempt ${attempt}/${attempts} failed \u2014 retrying in ${delay}ms`
+        );
+        await sleep(delay);
+      }
+    }
+    return null;
+  };
   return {
     /** Creates a container, waits for it to finish processing, then publishes it. */
-    publish: async (token, params, wait) => {
-      const containerID = await platform.createContainer(token, params);
+    publish: async (token, params, wait, retry) => {
+      const containerID = await createReady(
+        token,
+        params,
+        "container",
+        wait,
+        retry
+      );
       if (!containerID) return null;
-      if (!await isReady(token, containerID, "container", wait)) return null;
       return platform.publish(token, containerID);
     },
     /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
-    createChildren: async (token, items, wait) => {
+    createChildren: async (token, items, wait, retry) => {
       const children = [];
       for (const item of items) {
-        const childID = await platform.createContainer(token, {
-          ...item,
-          is_carousel_item: true
-        });
+        const childID = await createReady(
+          token,
+          { ...item, is_carousel_item: true },
+          "carousel item",
+          wait,
+          retry
+        );
         if (!childID) return null;
-        if (!await isReady(token, childID, "carousel item", wait))
-          return null;
         children.push(childID);
       }
       return children;
@@ -159,13 +181,15 @@ var createThreadsPost = async (token, input, replyToID) => {
     const children = await publisher.createChildren(
       token,
       media.map((item) => mediaParams(item)),
-      post.wait
+      post.wait,
+      post.retry
     );
     if (!children) return null;
     return publisher.publish(
       token,
       { ...shared, media_type: "CAROUSEL", children: children.join(",") },
-      post.wait
+      post.wait,
+      post.retry
     );
   }
   return publisher.publish(
@@ -175,7 +199,8 @@ var createThreadsPost = async (token, input, replyToID) => {
       ...shared,
       link_attachment: post.linkAttachment
     },
-    post.wait
+    post.wait,
+    post.retry
   );
 };
 var createThread = async (token, posts) => {

package/dist/socials/threads/setters.esm.js

@@ -27,25 +27,47 @@ function createPublisher(platform) {
     }
     return true;
   };
+  const createReady = async (token, params, label, wait, retry) => {
+    const attempts = Math.max(1, retry?.attempts ?? 3);
+    const backoffMS = retry?.backoffMS ?? 2e3;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+      const id = await platform.createContainer(token, params);
+      if (id && await isReady(token, id, label, wait)) return id;
+      if (attempt < attempts) {
+        const delay = backoffMS * 2 ** (attempt - 1);
+        console.warn(
+          `[naystack] ${platform.name} ${label} attempt ${attempt}/${attempts} failed \u2014 retrying in ${delay}ms`
+        );
+        await sleep(delay);
+      }
+    }
+    return null;
+  };
   return {
     /** Creates a container, waits for it to finish processing, then publishes it. */
-    publish: async (token, params, wait) => {
-      const containerID = await platform.createContainer(token, params);
+    publish: async (token, params, wait, retry) => {
+      const containerID = await createReady(
+        token,
+        params,
+        "container",
+        wait,
+        retry
+      );
       if (!containerID) return null;
-      if (!await isReady(token, containerID, "container", wait)) return null;
       return platform.publish(token, containerID);
     },
     /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
-    createChildren: async (token, items, wait) => {
+    createChildren: async (token, items, wait, retry) => {
       const children = [];
       for (const item of items) {
-        const childID = await platform.createContainer(token, {
-          ...item,
-          is_carousel_item: true
-        });
+        const childID = await createReady(
+          token,
+          { ...item, is_carousel_item: true },
+          "carousel item",
+          wait,
+          retry
+        );
         if (!childID) return null;
-        if (!await isReady(token, childID, "carousel item", wait))
-          return null;
         children.push(childID);
       }
       return children;
@@ -132,13 +154,15 @@ var createThreadsPost = async (token, input, replyToID) => {
     const children = await publisher.createChildren(
       token,
       media.map((item) => mediaParams(item)),
-      post.wait
+      post.wait,
+      post.retry
     );
     if (!children) return null;
     return publisher.publish(
       token,
       { ...shared, media_type: "CAROUSEL", children: children.join(",") },
-      post.wait
+      post.wait,
+      post.retry
     );
   }
   return publisher.publish(
@@ -148,7 +172,8 @@ var createThreadsPost = async (token, input, replyToID) => {
       ...shared,
       link_attachment: post.linkAttachment
     },
-    post.wait
+    post.wait,
+    post.retry
   );
 };
 var createThread = async (token, posts) => {

package/dist/socials/threads/types.d.mts

@@ -1,4 +1,4 @@
-import { WaitForContainerOptions } from '../meta/container.mjs';
+import { WaitForContainerOptions, RetryOptions } from '../meta/container.mjs';
 import { MetaMediaType } from '../meta/types.mjs';
 
 /**
@@ -40,6 +40,7 @@ type ThreadsPostMedia = {
  * @property replyToID - Parent post id, to make this post a reply.
  * @property replyControl - Who may reply.
  * @property wait - Container polling settings.
+ * @property retry - Container-creation retry settings. See {@link RetryOptions}.
  *
  * @category Socials
  */
@@ -50,6 +51,7 @@ type ThreadsPostInput = {
     replyToID?: string;
     replyControl?: "everyone" | "accounts_you_follow" | "mentioned_only";
     wait?: WaitForContainerOptions;
+    retry?: RetryOptions;
 };
 
 export type { ThreadsPost, ThreadsPostInput, ThreadsPostMedia };

package/dist/socials/threads/types.d.ts

@@ -1,4 +1,4 @@
-import { WaitForContainerOptions } from '../meta/container.js';
+import { WaitForContainerOptions, RetryOptions } from '../meta/container.js';
 import { MetaMediaType } from '../meta/types.js';
 
 /**
@@ -40,6 +40,7 @@ type ThreadsPostMedia = {
  * @property replyToID - Parent post id, to make this post a reply.
  * @property replyControl - Who may reply.
  * @property wait - Container polling settings.
+ * @property retry - Container-creation retry settings. See {@link RetryOptions}.
  *
  * @category Socials
  */
@@ -50,6 +51,7 @@ type ThreadsPostInput = {
     replyToID?: string;
     replyControl?: "everyone" | "accounts_you_follow" | "mentioned_only";
     wait?: WaitForContainerOptions;
+    retry?: RetryOptions;
 };
 
 export type { ThreadsPost, ThreadsPostInput, ThreadsPostMedia };