naystack 1.8.11 → 1.8.13

package/dist/socials/index.cjs.js

@@ -20,6 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/socials/index.ts
 var socials_exports = {};
 __export(socials_exports, {
+  canPublishToInstagram: () => canPublishToInstagram,
+  createInstagramPost: () => createInstagramPost,
   createThread: () => createThread,
   createThreadsPost: () => createThreadsPost,
   getInstagramConversation: () => getInstagramConversation,
@@ -38,39 +40,65 @@ __export(socials_exports, {
 });
 module.exports = __toCommonJS(socials_exports);
 
-// src/socials/instagram/utils.ts
-function getInstagramURL(token, path, params) {
-  return `https://graph.instagram.com/v23.0/${path}?${Object.keys(params).map((key) => `${key}=${params[key]}`).join("&")}&access_token=${token}`;
-}
-function getInstagramData(token, path, params = {}, postData) {
-  return fetch(getInstagramURL(token, path, params), {
-    method: postData ? "POST" : "GET",
-    body: JSON.stringify(postData),
-    headers: {
-      Authorization: `Bearer ${token}`,
-      "Content-Type": "application/json"
+// src/socials/meta/request.ts
+function createGraphClient(baseURL) {
+  const buildURL = (token, path, params = {}) => {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== void 0) search.set(key, String(value));
     }
-  }).then((res) => res.json());
+    search.set("access_token", token);
+    return `${baseURL}/${path}?${search.toString()}`;
+  };
+  const request = async (token, path, options = {}) => {
+    const response = await fetch(buildURL(token, path, options.params), {
+      method: options.method || (options.body ? "POST" : "GET"),
+      headers: {
+        Authorization: `Bearer ${token}`,
+        ...options.body ? { "Content-Type": "application/json" } : {}
+      },
+      ...options.body ? { body: JSON.stringify(options.body) } : {}
+    });
+    return response.json().catch(() => null);
+  };
+  return { buildURL, request };
+}
+function readGraphID(label, result) {
+  if (result?.error) {
+    console.error(`[naystack] ${label} failed: ${result.error.message}`);
+    return null;
+  }
+  return result?.id || null;
 }
 
+// src/socials/instagram/utils.ts
+var client = createGraphClient("https://graph.instagram.com/v23.0");
+var getInstagramData = client.request;
+
 // src/socials/instagram/getters.ts
 var getInstagramUser = (token, id, fields) => {
   return getInstagramData(token, id || "me", {
-    fields: fields ? fields.join(",") : "username,followers_count,media_count"
+    params: {
+      fields: fields ? fields.join(",") : "username,followers_count,media_count"
+    }
   });
 };
 var getInstagramMedia = (token, fields, limit = 12) => {
   return getInstagramData(token, "me/media", {
-    fields: fields ? fields.join(",") : "like_count,comments_count,permalink",
-    limit: limit?.toString()
+    params: {
+      fields: fields ? fields.join(",") : "like_count,comments_count,permalink",
+      limit
+    }
   });
 };
 var getInstagramConversations = async (token, limit = 25, cursor) => {
   const result = await getInstagramData(token, "me/conversations", {
-    platform: "instagram",
-    fields: "participants,messages,updated_time",
-    limit: limit.toString(),
-    ...cursor ? { after: cursor } : {}
+    params: {
+      platform: "instagram",
+      fields: "participants,messages,updated_time",
+      limit,
+      after: cursor
+    }
   });
   return {
     data: result?.data.map((item) => ({
@@ -86,8 +114,10 @@ var getInstagramConversationsByUser = (token, userID) => {
     token,
     "me/conversations",
     {
-      fields: "participants,messages,updated_time",
-      user_id: userID
+      params: {
+        fields: "participants,messages,updated_time",
+        user_id: userID
+      }
     }
   );
 };
@@ -96,9 +126,11 @@ var getInstagramConversationByUser = async (token, userID) => {
   return res?.data?.find((item) => item.participants?.data.length === 2);
 };
 var getInstagramConversation = async (token, id, cursor) => {
-  const result = await getInstagramData(token, id + "", {
-    fields: "participants,messages,updated_time",
-    ...cursor ? { after: cursor } : {}
+  const result = await getInstagramData(token, id, {
+    params: {
+      fields: "participants,messages,updated_time",
+      after: cursor
+    }
   });
   return {
     messages: result?.messages?.data,
@@ -112,21 +144,191 @@ var getInstagramConversation = async (token, id, cursor) => {
 };
 var getInstagramMessage = (token, id, fields) => {
   return getInstagramData(token, id, {
-    fields: fields ? fields.join(",") : "id,created_time,from,to,message"
+    params: {
+      fields: fields ? fields.join(",") : "id,created_time,from,to,message"
+    }
   });
 };
+var getInstagramContainerStatus = async (token, id) => {
+  const result = await getInstagramData(token, id, { params: { fields: "status_code,status" } });
+  if (!result?.status_code) return null;
+  return {
+    status: result.status_code,
+    error: result.status_code === "ERROR" ? result.status : void 0
+  };
+};
+var canPublishToInstagram = async (token) => {
+  const result = await getInstagramData(
+    token,
+    "me/content_publishing_limit",
+    { params: { fields: "quota_usage" } }
+  );
+  if (!Array.isArray(result?.data)) {
+    console.error(
+      `[naystack] Instagram token cannot publish${result?.error ? `: ${result.error.message}` : ""}`
+    );
+    return false;
+  }
+  return true;
+};
+
+// src/socials/meta/container.ts
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function waitForContainer(getState, { intervalMS = 5e3, timeoutMS = 3e5 } = {}) {
+  const deadline = Date.now() + timeoutMS;
+  let state = await getState();
+  if (!state) {
+    await sleep(2e3);
+    return null;
+  }
+  while (state?.status === "IN_PROGRESS" && Date.now() < deadline) {
+    await sleep(intervalMS);
+    state = await getState();
+  }
+  return state;
+}
+function createPublisher(platform) {
+  const isReady = async (token, id, label, wait) => {
+    const state = await waitForContainer(
+      () => platform.getStatus(token, id),
+      wait
+    );
+    if (state && state.status !== "FINISHED" && state.status !== "PUBLISHED") {
+      console.error(
+        `[naystack] ${platform.name} ${label} ${id} is ${state.status}${state.error ? `: ${state.error}` : ""}`
+      );
+      return false;
+    }
+    return true;
+  };
+  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);
+      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) => {
+      const children = [];
+      for (const item of items) {
+        const childID = await platform.createContainer(token, {
+          ...item,
+          is_carousel_item: true
+        });
+        if (!childID) return null;
+        if (!await isReady(token, childID, "carousel item", wait))
+          return null;
+        children.push(childID);
+      }
+      return children;
+    }
+  };
+}
 
 // src/socials/instagram/setters.ts
+var publisher = createPublisher({
+  name: "Instagram",
+  getStatus: getInstagramContainerStatus,
+  createContainer: async (token, params) => readGraphID(
+    "Instagram media container",
+    await getInstagramData(token, "me/media", {
+      params,
+      method: "POST"
+    })
+  ),
+  publish: async (token, creationID) => readGraphID(
+    "Instagram publish",
+    await getInstagramData(token, "me/media_publish", {
+      params: { creation_id: creationID },
+      method: "POST"
+    })
+  )
+});
+var mediaParams = (media) => ({
+  media_type: media.type === "video" ? "VIDEO" : void 0,
+  image_url: media.type === "image" ? media.url : void 0,
+  video_url: media.type === "video" ? media.url : void 0,
+  // Instagram accepts alt text on images only.
+  alt_text: media.type === "image" ? media.altText : void 0
+});
+var createInstagramPost = async (token, input) => {
+  const media = [input.media].flat();
+  const first = media[0];
+  if (!first) {
+    console.error(
+      "[naystack] Instagram posts need at least one image or video"
+    );
+    return null;
+  }
+  if (input.story) {
+    return publisher.publish(
+      token,
+      {
+        ...mediaParams(first),
+        media_type: "STORIES",
+        alt_text: void 0
+      },
+      input.wait
+    );
+  }
+  if (media.length > 1) {
+    const children = await publisher.createChildren(
+      token,
+      media.map(mediaParams),
+      input.wait
+    );
+    if (!children) return null;
+    return publisher.publish(
+      token,
+      {
+        media_type: "CAROUSEL",
+        children: children.join(","),
+        caption: input.caption
+      },
+      input.wait
+    );
+  }
+  if (first.type === "video") {
+    return publisher.publish(
+      token,
+      {
+        media_type: "REELS",
+        video_url: first.url,
+        caption: input.caption,
+        cover_url: input.coverURL,
+        thumb_offset: input.thumbOffset,
+        share_to_feed: input.shareToFeed,
+        audio_name: input.audioName,
+        collaborators: input.collaborators && JSON.stringify(input.collaborators)
+      },
+      input.wait
+    );
+  }
+  return publisher.publish(
+    token,
+    {
+      image_url: first.url,
+      caption: input.caption,
+      alt_text: first.altText,
+      location_id: input.locationID
+    },
+    input.wait
+  );
+};
 var sendInstagramMessage = (token, to, text) => {
-  return getInstagramData(token, "me/messages", void 0, {
-    recipient: { id: to },
-    message: {
-      text
+  return getInstagramData(token, "me/messages", {
+    body: {
+      recipient: { id: to },
+      message: {
+        text
+      }
     }
   });
 };
 
-// src/socials/meta-webhook.ts
+// src/socials/meta/webhook.ts
 var import_server = require("next/server");
 var verifyWebhook = (secret) => (req) => {
   const params = req.nextUrl.searchParams;
@@ -155,69 +357,91 @@ var setupInstagramWebhook = (options) => {
 };
 
 // src/socials/threads/utils.ts
-function getThreadsURL(token, path, params) {
-  return `https://graph.threads.net/v1.0/${path}?${Object.keys(params).map((key) => `${key}=${params[key]}`).join("&")}&access_token=${token}`;
-}
-function getThreadsData(token, path, params, method) {
-  return fetch(getThreadsURL(token, path, params), {
-    method: method || "GET"
-  }).then((res) => res.json());
-}
+var client2 = createGraphClient("https://graph.threads.net/v1.0");
+var getThreadsData = client2.request;
 
 // src/socials/threads/getters.ts
 var getThread = (token, id, fields) => {
   return getThreadsData(token, id, {
-    fields: fields ? fields.join(",") : "text,permalink,username"
+    params: { fields: fields ? fields.join(",") : "text,permalink,username" }
   });
 };
 var getThreads = (token, fields) => {
   return getThreadsData(token, "me/threads", {
-    fields: fields ? fields.join(",") : "text,permalink,username"
+    params: { fields: fields ? fields.join(",") : "text,permalink,username" }
   }).then((res) => res?.data);
 };
 var getThreadsReplies = (token, id, fields) => {
   return getThreadsData(token, `${id}/replies`, {
-    fields: fields ? fields.join(",") : "text,username,permalink"
+    params: { fields: fields ? fields.join(",") : "text,username,permalink" }
   }).then((res) => res?.data);
 };
+var getThreadsContainerStatus = async (token, id) => {
+  const result = await getThreadsData(token, id, { params: { fields: "status,error_message" } });
+  if (!result?.status) return null;
+  return { status: result.status, error: result.error_message };
+};
 
 // src/socials/threads/setters.ts
-function createContainer(token, text, reply_to_id) {
-  return getThreadsData(
-    token,
-    "me/threads",
-    {
-      media_type: "TEXT",
-      text,
-      ...reply_to_id ? { reply_to_id } : {}
-    },
-    "POST"
-  ).then((res) => res?.id);
-}
-function publishContainer(token, creation_id) {
-  return getThreadsData(
+var publisher2 = createPublisher({
+  name: "Threads",
+  getStatus: getThreadsContainerStatus,
+  createContainer: async (token, params) => readGraphID(
+    "Threads container",
+    await getThreadsData(token, "me/threads", {
+      params,
+      method: "POST"
+    })
+  ),
+  publish: async (token, creationID) => readGraphID(
+    "Threads publish",
+    await getThreadsData(token, "me/threads_publish", {
+      params: { creation_id: creationID },
+      method: "POST"
+    })
+  )
+});
+var mediaParams2 = (media) => ({
+  media_type: media ? media.type === "video" ? "VIDEO" : "IMAGE" : "TEXT",
+  image_url: media?.type === "image" ? media.url : void 0,
+  video_url: media?.type === "video" ? media.url : void 0,
+  alt_text: media?.altText
+});
+var createThreadsPost = async (token, input, replyToID) => {
+  const post = typeof input === "string" ? { text: input } : input;
+  const media = post.media ? [post.media].flat() : [];
+  const shared = {
+    text: post.text,
+    reply_to_id: post.replyToID || replyToID,
+    reply_control: post.replyControl
+  };
+  if (media.length > 1) {
+    const children = await publisher2.createChildren(
+      token,
+      media.map((item) => mediaParams2(item)),
+      post.wait
+    );
+    if (!children) return null;
+    return publisher2.publish(
+      token,
+      { ...shared, media_type: "CAROUSEL", children: children.join(",") },
+      post.wait
+    );
+  }
+  return publisher2.publish(
     token,
-    "me/threads_publish",
     {
-      creation_id
+      ...mediaParams2(media[0]),
+      ...shared,
+      link_attachment: post.linkAttachment
     },
-    "POST"
-  ).then((res) => res?.id);
-}
-var createThreadsPost = async (token, text, reply_to_id) => {
-  const containerID = await createContainer(token, text, reply_to_id);
-  if (!containerID) return null;
-  await new Promise((resolve) => setTimeout(resolve, 2e3));
-  return publishContainer(token, containerID);
+    post.wait
+  );
 };
-var createThread = async (token, threads) => {
+var createThread = async (token, posts) => {
   const publishedIDs = [];
-  for (const thread of threads) {
-    const postID = await createThreadsPost(
-      token,
-      thread.split("\n").join("%0A"),
-      publishedIDs.at(-1)
-    );
+  for (const post of posts) {
+    const postID = await createThreadsPost(token, post, publishedIDs.at(-1));
     if (postID) publishedIDs.push(postID);
   }
   return publishedIDs[0];
@@ -240,6 +464,8 @@ var setupThreadsWebhook = (options) => {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  canPublishToInstagram,
+  createInstagramPost,
   createThread,
   createThreadsPost,
   getInstagramConversation,

package/dist/socials/index.d.mts

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

package/dist/socials/index.d.ts

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