naystack 1.8.17 → 1.8.19

package/dist/auth/index.cjs.js

@@ -727,21 +727,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }

package/dist/auth/index.esm.js

@@ -685,21 +685,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }

package/dist/auth/instagram/index.cjs.js

@@ -250,21 +250,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }

package/dist/auth/instagram/index.esm.js

@@ -222,21 +222,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }

package/dist/auth/instagram/route.cjs.js

@@ -239,21 +239,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }

package/dist/auth/instagram/route.esm.js

@@ -215,21 +215,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }

package/dist/socials/index.cjs.js

@@ -29,12 +29,16 @@ __export(socials_exports, {
   getInstagramConversationByUser: () => getInstagramConversationByUser,
   getInstagramConversations: () => getInstagramConversations,
   getInstagramConversationsByUser: () => getInstagramConversationsByUser,
+  getInstagramData: () => getInstagramData,
   getInstagramMedia: () => getInstagramMedia,
   getInstagramMessage: () => getInstagramMessage,
   getInstagramUser: () => getInstagramUser,
   getThread: () => getThread,
   getThreads: () => getThreads,
+  getThreadsData: () => getThreadsData,
   getThreadsReplies: () => getThreadsReplies,
+  readGraphID: () => readGraphID,
+  replyToInstagramComment: () => replyToInstagramComment,
   sendInstagramMessage: () => sendInstagramMessage,
   setupInstagramWebhook: () => setupInstagramWebhook,
   setupThreadsWebhook: () => setupThreadsWebhook
@@ -231,21 +235,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }
@@ -352,6 +365,13 @@ var createInstagramPost = async (token, input) => {
     input.retry
   );
 };
+var replyToInstagramComment = async (token, commentID, text) => readGraphID(
+  "Instagram comment reply",
+  await getInstagramData(token, `${commentID}/replies`, {
+    params: { message: text },
+    method: "POST"
+  })
+);
 var sendInstagramMessage = (token, to, text) => {
   return getInstagramData(token, "me/messages", {
     body: {
@@ -511,12 +531,16 @@ var setupThreadsWebhook = (options) => {
   getInstagramConversationByUser,
   getInstagramConversations,
   getInstagramConversationsByUser,
+  getInstagramData,
   getInstagramMedia,
   getInstagramMessage,
   getInstagramUser,
   getThread,
   getThreads,
+  getThreadsData,
   getThreadsReplies,
+  readGraphID,
+  replyToInstagramComment,
   sendInstagramMessage,
   setupInstagramWebhook,
   setupThreadsWebhook

package/dist/socials/index.d.mts

@@ -1,11 +1,14 @@
 export { canPublishToInstagram, getInstagramConversation, getInstagramConversationByUser, getInstagramConversations, getInstagramConversationsByUser, getInstagramMedia, getInstagramMessage, getInstagramUser } from './instagram/getters.mjs';
-export { createInstagramPost, sendInstagramMessage } from './instagram/setters.mjs';
+export { createInstagramPost, replyToInstagramComment, sendInstagramMessage } from './instagram/setters.mjs';
 export { InstagramConversation, InstagramMedia, InstagramMessage, InstagramPostInput, InstagramPostMedia, InstagramUser } from './instagram/types.mjs';
+export { getInstagramData } from './instagram/utils.mjs';
 export { setupInstagramWebhook } from './instagram/webhook.mjs';
 export { RetryOptions, WaitForContainerOptions } from './meta/container.mjs';
-export { GraphError, MetaMediaType } from './meta/types.mjs';
+export { GraphClient, GraphRequestOptions, readGraphID } from './meta/request.mjs';
+export { GraphError, GraphParams, MetaMediaType } from './meta/types.mjs';
 export { getThread, getThreads, getThreadsReplies } from './threads/getters.mjs';
 export { createThread, createThreadsPost } from './threads/setters.mjs';
+export { getThreadsData } from './threads/utils.mjs';
 export { ThreadsPost, ThreadsPostInput, ThreadsPostMedia } from './threads/types.mjs';
 export { setupThreadsWebhook } from './threads/webhook.mjs';
 import 'next/server';

package/dist/socials/index.d.ts

@@ -1,11 +1,14 @@
 export { canPublishToInstagram, getInstagramConversation, getInstagramConversationByUser, getInstagramConversations, getInstagramConversationsByUser, getInstagramMedia, getInstagramMessage, getInstagramUser } from './instagram/getters.js';
-export { createInstagramPost, sendInstagramMessage } from './instagram/setters.js';
+export { createInstagramPost, replyToInstagramComment, sendInstagramMessage } from './instagram/setters.js';
 export { InstagramConversation, InstagramMedia, InstagramMessage, InstagramPostInput, InstagramPostMedia, InstagramUser } from './instagram/types.js';
+export { getInstagramData } from './instagram/utils.js';
 export { setupInstagramWebhook } from './instagram/webhook.js';
 export { RetryOptions, WaitForContainerOptions } from './meta/container.js';
-export { GraphError, MetaMediaType } from './meta/types.js';
+export { GraphClient, GraphRequestOptions, readGraphID } from './meta/request.js';
+export { GraphError, GraphParams, MetaMediaType } from './meta/types.js';
 export { getThread, getThreads, getThreadsReplies } from './threads/getters.js';
 export { createThread, createThreadsPost } from './threads/setters.js';
+export { getThreadsData } from './threads/utils.js';
 export { ThreadsPost, ThreadsPostInput, ThreadsPostMedia } from './threads/types.js';
 export { setupThreadsWebhook } from './threads/webhook.js';
 import 'next/server';

package/dist/socials/index.esm.js

@@ -188,21 +188,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }
@@ -309,6 +318,13 @@ var createInstagramPost = async (token, input) => {
     input.retry
   );
 };
+var replyToInstagramComment = async (token, commentID, text) => readGraphID(
+  "Instagram comment reply",
+  await getInstagramData(token, `${commentID}/replies`, {
+    params: { message: text },
+    method: "POST"
+  })
+);
 var sendInstagramMessage = (token, to, text) => {
   return getInstagramData(token, "me/messages", {
     body: {
@@ -467,12 +483,16 @@ export {
   getInstagramConversationByUser,
   getInstagramConversations,
   getInstagramConversationsByUser,
+  getInstagramData,
   getInstagramMedia,
   getInstagramMessage,
   getInstagramUser,
   getThread,
   getThreads,
+  getThreadsData,
   getThreadsReplies,
+  readGraphID,
+  replyToInstagramComment,
   sendInstagramMessage,
   setupInstagramWebhook,
   setupThreadsWebhook

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

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var setters_exports = {};
 __export(setters_exports, {
   createInstagramPost: () => createInstagramPost,
+  replyToInstagramComment: () => replyToInstagramComment,
   sendInstagramMessage: () => sendInstagramMessage
 });
 module.exports = __toCommonJS(setters_exports);
@@ -128,21 +129,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }
@@ -242,6 +252,13 @@ var createInstagramPost = async (token, input) => {
     input.retry
   );
 };
+var replyToInstagramComment = async (token, commentID, text) => readGraphID(
+  "Instagram comment reply",
+  await getInstagramData(token, `${commentID}/replies`, {
+    params: { message: text },
+    method: "POST"
+  })
+);
 var sendInstagramMessage = (token, to, text) => {
   return getInstagramData(token, "me/messages", {
     body: {
@@ -255,5 +272,6 @@ var sendInstagramMessage = (token, to, text) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createInstagramPost,
+  replyToInstagramComment,
   sendInstagramMessage
 });

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

@@ -40,6 +40,28 @@ import '../meta/container.mjs';
  * @category Socials
  */
 declare const createInstagramPost: (token: string, input: InstagramPostInput) => Promise<string | null>;
+/**
+ * Replies to a comment on one of your Instagram posts, as your account.
+ *
+ * Needs the `instagram_business_manage_comments` scope. The reply lands in the
+ * comment's own thread — Instagram nests one level, so replying to a reply
+ * attaches to the same top-level comment.
+ *
+ * @param token - Instagram access token.
+ * @param commentID - The comment being replied to.
+ * @param text - Reply text.
+ * @returns Promise of the new comment's id, or `null` if the call failed (the API's error is logged).
+ *
+ * @example
+ * ```ts
+ * import { replyToInstagramComment } from "naystack/socials";
+ *
+ * await replyToInstagramComment(accessToken, commentId, "Applications are open in our bio!");
+ * ```
+ *
+ * @category Socials
+ */
+declare const replyToInstagramComment: (token: string, commentID: string, text: string) => Promise<string | null>;
 /**
  * Sends a text message to an Instagram user via the Instagram Messaging API.
  *
@@ -63,4 +85,4 @@ declare const sendInstagramMessage: (token: string, to: string, text: string) =>
     message_id?: string;
 } & GraphError) | null>;
 
-export { createInstagramPost, sendInstagramMessage };
+export { createInstagramPost, replyToInstagramComment, sendInstagramMessage };

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

@@ -40,6 +40,28 @@ import '../meta/container.js';
  * @category Socials
  */
 declare const createInstagramPost: (token: string, input: InstagramPostInput) => Promise<string | null>;
+/**
+ * Replies to a comment on one of your Instagram posts, as your account.
+ *
+ * Needs the `instagram_business_manage_comments` scope. The reply lands in the
+ * comment's own thread — Instagram nests one level, so replying to a reply
+ * attaches to the same top-level comment.
+ *
+ * @param token - Instagram access token.
+ * @param commentID - The comment being replied to.
+ * @param text - Reply text.
+ * @returns Promise of the new comment's id, or `null` if the call failed (the API's error is logged).
+ *
+ * @example
+ * ```ts
+ * import { replyToInstagramComment } from "naystack/socials";
+ *
+ * await replyToInstagramComment(accessToken, commentId, "Applications are open in our bio!");
+ * ```
+ *
+ * @category Socials
+ */
+declare const replyToInstagramComment: (token: string, commentID: string, text: string) => Promise<string | null>;
 /**
  * Sends a text message to an Instagram user via the Instagram Messaging API.
  *
@@ -63,4 +85,4 @@ declare const sendInstagramMessage: (token: string, to: string, text: string) =>
     message_id?: string;
 } & GraphError) | null>;
 
-export { createInstagramPost, sendInstagramMessage };
+export { createInstagramPost, replyToInstagramComment, sendInstagramMessage };

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

@@ -101,21 +101,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }
@@ -215,6 +224,13 @@ var createInstagramPost = async (token, input) => {
     input.retry
   );
 };
+var replyToInstagramComment = async (token, commentID, text) => readGraphID(
+  "Instagram comment reply",
+  await getInstagramData(token, `${commentID}/replies`, {
+    params: { message: text },
+    method: "POST"
+  })
+);
 var sendInstagramMessage = (token, to, text) => {
   return getInstagramData(token, "me/messages", {
     body: {
@@ -227,5 +243,6 @@ var sendInstagramMessage = (token, to, text) => {
 };
 export {
   createInstagramPost,
+  replyToInstagramComment,
   sendInstagramMessage
 };

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

@@ -2,12 +2,33 @@ import { GraphError } from '../meta/types.mjs';
 import { GraphRequestOptions } from '../meta/request.mjs';
 
 /**
- * Fetches JSON from the Instagram Graph API.
+ * Calls the Instagram Graph API directly — the escape hatch for endpoints this
+ * module doesn't wrap. Despite the name it does POSTs too: Graph mutations take
+ * their arguments as query `params`, so pass `method: "POST"` with `params`.
+ *
+ * The base URL and API version stay pinned here, so callers never hardcode either.
+ * Pair it with {@link readGraphID} to unwrap an `id` and log the API's own error.
  *
  * @param token - Instagram access token.
- * @param path - API path.
- * @param options - `params` (query), `method`, `body`.
- * @returns Promise of `(T & GraphError) | null`.
+ * @param path - API path, relative to the versioned root (e.g. `"me/media"`).
+ * @param options - See {@link GraphRequestOptions} — `params` (query), `method`, `body`.
+ * @returns Promise of `(T & GraphError) | null` — check `.error` before reading `T`.
+ *
+ * @example
+ * ```ts
+ * import { getInstagramData, readGraphID } from "naystack/socials";
+ *
+ * // An endpoint with no dedicated helper.
+ * const id = readGraphID(
+ *   "Instagram comment reply",
+ *   await getInstagramData<{ id: string }>(token, `${commentID}/replies`, {
+ *     params: { message: "thanks!" },
+ *     method: "POST",
+ *   }),
+ * );
+ * ```
+ *
+ * @category Socials
  */
 declare const getInstagramData: <T>(token: string, path: string, options?: GraphRequestOptions) => Promise<(T & GraphError) | null>;
 

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

@@ -2,12 +2,33 @@ import { GraphError } from '../meta/types.js';
 import { GraphRequestOptions } from '../meta/request.js';
 
 /**
- * Fetches JSON from the Instagram Graph API.
+ * Calls the Instagram Graph API directly — the escape hatch for endpoints this
+ * module doesn't wrap. Despite the name it does POSTs too: Graph mutations take
+ * their arguments as query `params`, so pass `method: "POST"` with `params`.
+ *
+ * The base URL and API version stay pinned here, so callers never hardcode either.
+ * Pair it with {@link readGraphID} to unwrap an `id` and log the API's own error.
  *
  * @param token - Instagram access token.
- * @param path - API path.
- * @param options - `params` (query), `method`, `body`.
- * @returns Promise of `(T & GraphError) | null`.
+ * @param path - API path, relative to the versioned root (e.g. `"me/media"`).
+ * @param options - See {@link GraphRequestOptions} — `params` (query), `method`, `body`.
+ * @returns Promise of `(T & GraphError) | null` — check `.error` before reading `T`.
+ *
+ * @example
+ * ```ts
+ * import { getInstagramData, readGraphID } from "naystack/socials";
+ *
+ * // An endpoint with no dedicated helper.
+ * const id = readGraphID(
+ *   "Instagram comment reply",
+ *   await getInstagramData<{ id: string }>(token, `${commentID}/replies`, {
+ *     params: { message: "thanks!" },
+ *     method: "POST",
+ *   }),
+ * );
+ * ```
+ *
+ * @category Socials
  */
 declare const getInstagramData: <T>(token: string, path: string, options?: GraphRequestOptions) => Promise<(T & GraphError) | null>;
 

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

@@ -80,21 +80,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }

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

@@ -49,7 +49,16 @@ declare function createPublisher(platform: {
 }): {
     /** Creates a container, waits for it to finish processing, then publishes it. */
     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. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: (token: string, items: GraphParams[], wait?: WaitForContainerOptions, retry?: RetryOptions) => Promise<string[] | null>;
 };
 

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

@@ -49,7 +49,16 @@ declare function createPublisher(platform: {
 }): {
     /** Creates a container, waits for it to finish processing, then publishes it. */
     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. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: (token: string, items: GraphParams[], wait?: WaitForContainerOptions, retry?: RetryOptions) => Promise<string[] | null>;
 };
 

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

@@ -56,21 +56,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }

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

@@ -83,21 +83,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }

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

@@ -56,21 +56,30 @@ function createPublisher(platform) {
       if (!containerID) return null;
       return platform.publish(token, containerID);
     },
-    /** Creates and awaits every carousel child, resolving to their ids — or `null` if any failed. */
+    /**
+     * Creates and awaits every carousel child **in parallel**, resolving to
+     * their ids in input order — or `null` if any failed.
+     *
+     * Parallel because each child is an independent create-then-poll and Meta
+     * spends ~5s accepting a single container, so ten sequential children cost
+     * ~50s of mostly waiting — past what a serverless caller can fit in its
+     * timeout. `Promise.all` preserves input order, which the carousel's slide
+     * order depends on.
+     */
     createChildren: async (token, items, wait, retry) => {
-      const children = [];
-      for (const item of items) {
-        const childID = await createReady(
-          token,
-          { ...item, is_carousel_item: true },
-          "carousel item",
-          wait,
-          retry
-        );
-        if (!childID) return null;
-        children.push(childID);
-      }
-      return children;
+      const children = await Promise.all(
+        items.map(
+          (item) => createReady(
+            token,
+            { ...item, is_carousel_item: true },
+            "carousel item",
+            wait,
+            retry
+          )
+        )
+      );
+      const created = children.filter((childID) => childID !== null);
+      return created.length === children.length ? created : null;
     }
   };
 }

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

@@ -2,12 +2,16 @@ import { GraphError } from '../meta/types.mjs';
 import { GraphRequestOptions } from '../meta/request.mjs';
 
 /**
- * Fetches JSON from the Threads Graph API.
+ * Calls the Threads Graph API directly — the escape hatch for endpoints this
+ * module doesn't wrap. The Instagram counterpart is {@link getInstagramData};
+ * see it for the POST-via-`params` convention and an example.
  *
  * @param token - Threads access token.
- * @param path - API path.
- * @param options - `params` (query), `method`, `body`.
- * @returns Promise of `(T & GraphError) | null`.
+ * @param path - API path, relative to the versioned root (e.g. `"me/threads"`).
+ * @param options - See {@link GraphRequestOptions} — `params` (query), `method`, `body`.
+ * @returns Promise of `(T & GraphError) | null` — check `.error` before reading `T`.
+ *
+ * @category Socials
  */
 declare const getThreadsData: <T>(token: string, path: string, options?: GraphRequestOptions) => Promise<(T & GraphError) | null>;
 

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

@@ -2,12 +2,16 @@ import { GraphError } from '../meta/types.js';
 import { GraphRequestOptions } from '../meta/request.js';
 
 /**
- * Fetches JSON from the Threads Graph API.
+ * Calls the Threads Graph API directly — the escape hatch for endpoints this
+ * module doesn't wrap. The Instagram counterpart is {@link getInstagramData};
+ * see it for the POST-via-`params` convention and an example.
  *
  * @param token - Threads access token.
- * @param path - API path.
- * @param options - `params` (query), `method`, `body`.
- * @returns Promise of `(T & GraphError) | null`.
+ * @param path - API path, relative to the versioned root (e.g. `"me/threads"`).
+ * @param options - See {@link GraphRequestOptions} — `params` (query), `method`, `body`.
+ * @returns Promise of `(T & GraphError) | null` — check `.error` before reading `T`.
+ *
+ * @category Socials
  */
 declare const getThreadsData: <T>(token: string, path: string, options?: GraphRequestOptions) => Promise<(T & GraphError) | null>;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "naystack",
-  "version": "1.8.17",
+  "version": "1.8.19",
   "description": "A stack built with Next + GraphQL + S3 + Auth",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",