naystack 1.8.12 → 1.8.14

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

@@ -1,27 +1,204 @@
+// 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));
+    }
+    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
-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}`;
+var client = createGraphClient("https://graph.instagram.com/v23.0");
+var getInstagramData = client.request;
+
+// src/socials/instagram/getters.ts
+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
+  };
+};
+
+// 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 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"
+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;
     }
-  }).then((res) => res.json());
+    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 */ ? "VIDEO" : void 0,
+  image_url: media.type === "photo" /* Photo */ ? media.url : void 0,
+  video_url: media.type === "video" /* Video */ ? media.url : void 0,
+  // Instagram accepts alt text on images only.
+  alt_text: media.type === "photo" /* Photo */ ? 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" /* 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
+      }
     }
   });
 };
 export {
+  createInstagramPost,
   sendInstagramMessage
 };

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

@@ -1,3 +1,6 @@
+import { WaitForContainerOptions } from '../meta/container.mjs';
+import { MetaMediaType } from '../meta/types.mjs';
+
 /**
  * Instagram Messaging API message shape.
  *
@@ -84,20 +87,54 @@ type InstagramConversation = {
     };
 };
 /**
- * Instagram Graph API error response shape.
+ * One image or video to publish. The URL must be publicly reachable — Instagram
+ * downloads it server-side.
  *
- * @property error - Error details from the API (message, type, code, subcode, trace id).
+ * @property url - Public URL. Images must be **JPEG**.
+ * @property type - `"image"` or `"video"`.
+ * @property altText - Accessibility description, up to 1000 characters. Images only.
  *
  * @category Socials
  */
-type InstagramError = {
-    error?: {
-        message: string;
-        type: string;
-        code: number;
-        error_subcode: number;
-        fbtrace_id: string;
-    };
+type InstagramPostMedia = {
+    url: string;
+    type: MetaMediaType;
+    altText?: string;
+};
+/**
+ * Input for {@link createInstagramPost}. What gets published follows from `media`:
+ *
+ * | `media` | Result |
+ * | --- | --- |
+ * | one image | feed image |
+ * | one video | reel |
+ * | 2–10 items | carousel (counts as one post) |
+ * | any, with `story: true` | story, from the first item |
+ *
+ * @property media - One item or an array. Images are cropped to the first item's aspect ratio in a carousel.
+ * @property caption - Post caption.
+ * @property story - Publish as a 24-hour story instead of to the feed. Uses the first media item only.
+ * @property locationID - Facebook Page id to tag as the location. Single images only.
+ * @property coverURL - Reels: public URL of a cover image. Takes precedence over `thumbOffset`.
+ * @property thumbOffset - Reels: frame to use as the thumbnail, in milliseconds.
+ * @property shareToFeed - Reels: also show the reel in the feed, not only the Reels tab.
+ * @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.
+ *
+ * @category Socials
+ */
+type InstagramPostInput = {
+    media: InstagramPostMedia | InstagramPostMedia[];
+    caption?: string;
+    story?: boolean;
+    locationID?: string;
+    coverURL?: string;
+    thumbOffset?: number;
+    shareToFeed?: boolean;
+    audioName?: string;
+    collaborators?: string[];
+    wait?: WaitForContainerOptions;
 };
 
-export type { InstagramConversation, InstagramError, InstagramMedia, InstagramMessage, InstagramUser };
+export type { InstagramConversation, InstagramMedia, InstagramMessage, InstagramPostInput, InstagramPostMedia, InstagramUser };

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

@@ -1,3 +1,6 @@
+import { WaitForContainerOptions } from '../meta/container.js';
+import { MetaMediaType } from '../meta/types.js';
+
 /**
  * Instagram Messaging API message shape.
  *
@@ -84,20 +87,54 @@ type InstagramConversation = {
     };
 };
 /**
- * Instagram Graph API error response shape.
+ * One image or video to publish. The URL must be publicly reachable — Instagram
+ * downloads it server-side.
  *
- * @property error - Error details from the API (message, type, code, subcode, trace id).
+ * @property url - Public URL. Images must be **JPEG**.
+ * @property type - `"image"` or `"video"`.
+ * @property altText - Accessibility description, up to 1000 characters. Images only.
  *
  * @category Socials
  */
-type InstagramError = {
-    error?: {
-        message: string;
-        type: string;
-        code: number;
-        error_subcode: number;
-        fbtrace_id: string;
-    };
+type InstagramPostMedia = {
+    url: string;
+    type: MetaMediaType;
+    altText?: string;
+};
+/**
+ * Input for {@link createInstagramPost}. What gets published follows from `media`:
+ *
+ * | `media` | Result |
+ * | --- | --- |
+ * | one image | feed image |
+ * | one video | reel |
+ * | 2–10 items | carousel (counts as one post) |
+ * | any, with `story: true` | story, from the first item |
+ *
+ * @property media - One item or an array. Images are cropped to the first item's aspect ratio in a carousel.
+ * @property caption - Post caption.
+ * @property story - Publish as a 24-hour story instead of to the feed. Uses the first media item only.
+ * @property locationID - Facebook Page id to tag as the location. Single images only.
+ * @property coverURL - Reels: public URL of a cover image. Takes precedence over `thumbOffset`.
+ * @property thumbOffset - Reels: frame to use as the thumbnail, in milliseconds.
+ * @property shareToFeed - Reels: also show the reel in the feed, not only the Reels tab.
+ * @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.
+ *
+ * @category Socials
+ */
+type InstagramPostInput = {
+    media: InstagramPostMedia | InstagramPostMedia[];
+    caption?: string;
+    story?: boolean;
+    locationID?: string;
+    coverURL?: string;
+    thumbOffset?: number;
+    shareToFeed?: boolean;
+    audioName?: string;
+    collaborators?: string[];
+    wait?: WaitForContainerOptions;
 };
 
-export type { InstagramConversation, InstagramError, InstagramMedia, InstagramMessage, InstagramUser };
+export type { InstagramConversation, InstagramMedia, InstagramMessage, InstagramPostInput, InstagramPostMedia, InstagramUser };

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

@@ -20,25 +20,38 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/socials/instagram/utils.ts
 var utils_exports = {};
 __export(utils_exports, {
-  getInstagramData: () => getInstagramData,
-  getInstagramURL: () => getInstagramURL
+  getInstagramData: () => getInstagramData
 });
 module.exports = __toCommonJS(utils_exports);
-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 };
 }
+
+// src/socials/instagram/utils.ts
+var client = createGraphClient("https://graph.instagram.com/v23.0");
+var getInstagramData = client.request;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  getInstagramData,
-  getInstagramURL
+  getInstagramData
 });

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

@@ -1,25 +1,14 @@
-import { InstagramError } from './types.mjs';
+import { GraphError } from '../meta/types.mjs';
+import { GraphRequestOptions } from '../meta/request.mjs';
 
 /**
- * Builds an Instagram Graph API URL with the given path and query parameters (includes `access_token`).
- *
- * @param token - Instagram access token.
- * @param path - API path (e.g. `"me"`, `"me/media"`, `"me/conversations"`).
- * @param params - Additional query parameters.
- * @returns Full URL string.
- * @category Socials
- */
-declare function getInstagramURL(token: string, path: string, params: Record<string, string>): string;
-/**
- * Fetches JSON from the Instagram Graph API (GET or POST depending on whether `postData` is provided).
+ * Fetches JSON from the Instagram Graph API.
  *
  * @param token - Instagram access token.
  * @param path - API path.
- * @param params - Query parameters (default: `{}`).
- * @param postData - Optional POST body (if provided, the request becomes a POST).
- * @returns Promise of `(T & InstagramError) | null`.
- * @category Socials
+ * @param options - `params` (query), `method`, `body`.
+ * @returns Promise of `(T & GraphError) | null`.
  */
-declare function getInstagramData<T>(token: string, path: string, params?: Record<string, string>, postData?: object): Promise<(T & InstagramError) | null>;
+declare const getInstagramData: <T>(token: string, path: string, options?: GraphRequestOptions) => Promise<(T & GraphError) | null>;
 
-export { getInstagramData, getInstagramURL };
+export { getInstagramData };

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

@@ -1,25 +1,14 @@
-import { InstagramError } from './types.js';
+import { GraphError } from '../meta/types.js';
+import { GraphRequestOptions } from '../meta/request.js';
 
 /**
- * Builds an Instagram Graph API URL with the given path and query parameters (includes `access_token`).
- *
- * @param token - Instagram access token.
- * @param path - API path (e.g. `"me"`, `"me/media"`, `"me/conversations"`).
- * @param params - Additional query parameters.
- * @returns Full URL string.
- * @category Socials
- */
-declare function getInstagramURL(token: string, path: string, params: Record<string, string>): string;
-/**
- * Fetches JSON from the Instagram Graph API (GET or POST depending on whether `postData` is provided).
+ * Fetches JSON from the Instagram Graph API.
  *
  * @param token - Instagram access token.
  * @param path - API path.
- * @param params - Query parameters (default: `{}`).
- * @param postData - Optional POST body (if provided, the request becomes a POST).
- * @returns Promise of `(T & InstagramError) | null`.
- * @category Socials
+ * @param options - `params` (query), `method`, `body`.
+ * @returns Promise of `(T & GraphError) | null`.
  */
-declare function getInstagramData<T>(token: string, path: string, params?: Record<string, string>, postData?: object): Promise<(T & InstagramError) | null>;
+declare const getInstagramData: <T>(token: string, path: string, options?: GraphRequestOptions) => Promise<(T & GraphError) | null>;
 
-export { getInstagramData, getInstagramURL };
+export { getInstagramData };

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

@@ -1,18 +1,30 @@
-// 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 };
 }
+
+// src/socials/instagram/utils.ts
+var client = createGraphClient("https://graph.instagram.com/v23.0");
+var getInstagramData = client.request;
 export {
-  getInstagramData,
-  getInstagramURL
+  getInstagramData
 };

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

@@ -24,7 +24,7 @@ __export(webhook_exports, {
 });
 module.exports = __toCommonJS(webhook_exports);
 
-// 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;

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

@@ -1,4 +1,4 @@
-// src/socials/meta-webhook.ts
+// src/socials/meta/webhook.ts
 import { NextResponse } from "next/server";
 var verifyWebhook = (secret) => (req) => {
   const params = req.nextUrl.searchParams;

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

@@ -0,0 +1,82 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/socials/meta/container.ts
+var container_exports = {};
+__export(container_exports, {
+  createPublisher: () => createPublisher
+});
+module.exports = __toCommonJS(container_exports);
+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;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createPublisher
+});

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

@@ -0,0 +1,38 @@
+import { GraphParams, ContainerState } from './types.mjs';
+
+/**
+ * Polling settings for a media container.
+ *
+ * @property intervalMS - Delay between status checks. Default: `5000`.
+ * @property timeoutMS - Give up after this long. Default: `300000` (Meta stops processing after ~5 min).
+ *
+ * @category Socials
+ */
+type WaitForContainerOptions = {
+    intervalMS?: number;
+    timeoutMS?: 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
+ * post shape goes through it.
+ *
+ * @param platform.name - Used in error logs, e.g. `"Instagram"`.
+ * @param platform.createContainer - Creates a container, resolving to its id.
+ * @param platform.getStatus - Reads a container's state by id.
+ * @param platform.publish - Publishes a finished container, resolving to the post id.
+ * @returns `{ publish, createChildren }`.
+ */
+declare function createPublisher(platform: {
+    name: string;
+    createContainer: (token: string, params: GraphParams) => Promise<string | null>;
+    getStatus: (token: string, id: string) => Promise<ContainerState | null>;
+    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>;
+    /** 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>;
+};
+
+export { type WaitForContainerOptions, createPublisher };