naystack 1.8.12 → 1.8.14

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

@@ -1,4 +1,6 @@
-import { InstagramConversation, InstagramError, InstagramMedia, InstagramMessage, InstagramUser } from './types.mjs';
+import { GraphError, ContainerState } from '../meta/types.mjs';
+import { InstagramConversation, InstagramMedia, InstagramMessage, InstagramUser } from './types.mjs';
+import '../meta/container.mjs';
 
 /**
  * Fetches an Instagram user's profile. Defaults to the authenticated user (`"me"`).
@@ -18,7 +20,7 @@ import { InstagramConversation, InstagramError, InstagramMedia, InstagramMessage
  *
  * @category Socials
  */
-declare const getInstagramUser: <T = InstagramUser>(token: string, id?: string, fields?: string[]) => Promise<(T & InstagramError) | null>;
+declare const getInstagramUser: <T = InstagramUser>(token: string, id?: string, fields?: string[]) => Promise<(T & GraphError) | null>;
 /**
  * Fetches the authenticated user's recent Instagram media.
  *
@@ -41,7 +43,7 @@ declare const getInstagramUser: <T = InstagramUser>(token: string, id?: string,
  */
 declare const getInstagramMedia: <T = InstagramMedia>(token: string, fields?: string[], limit?: number) => Promise<({
     data: T[];
-} & InstagramError) | null>;
+} & GraphError) | null>;
 /**
  * Fetches Instagram conversations (DM threads) with pagination support.
  *
@@ -92,7 +94,7 @@ declare const getInstagramConversations: (token: string, limit?: number, cursor?
  */
 declare const getInstagramConversationsByUser: (token: string, userID: string) => Promise<({
     data: InstagramConversation[];
-} & InstagramError) | null>;
+} & GraphError) | null>;
 /**
  * Fetches the single conversation between the authenticated user and the given user.
  * Filters for conversations with exactly 2 participants.
@@ -149,6 +151,54 @@ declare const getInstagramConversation: (token: string, id: string, cursor?: str
  *
  * @category Socials
  */
-declare const getInstagramMessage: <T = InstagramMessage>(token: string, id: string, fields?: string[]) => Promise<(T & InstagramError) | null>;
+declare const getInstagramMessage: <T = InstagramMessage>(token: string, id: string, fields?: string[]) => Promise<(T & GraphError) | null>;
+/**
+ * Reads a media container's processing status. Videos and reels must reach
+ * `FINISHED` before they can be published.
+ *
+ * @param token - Instagram access token.
+ * @param id - Container id from `createInstagramContainer`.
+ * @returns Promise of `{ status, error? }`, or `null` if the status was unreadable.
+ *
+ * @example
+ * ```ts
+ * import { getInstagramContainerStatus } from "naystack/socials";
+ *
+ * const state = await getInstagramContainerStatus(accessToken, containerId);
+ * if (state?.status === "FINISHED") await publishInstagramContainer(accessToken, containerId);
+ * ```
+ *
+ * @category Socials
+ */
+declare const getInstagramContainerStatus: (token: string, id: string) => Promise<ContainerState | null>;
+/**
+ * Checks whether an access token is allowed to publish.
+ *
+ * Meta exposes no scope-listing endpoint for Instagram Login tokens, so this probes
+ * the publishing quota — a read-only endpoint that needs exactly the same
+ * `instagram_business_content_publish` scope publishing does. Nothing is posted.
+ *
+ * Worth calling before {@link createInstagramPost} in a scheduled job: a token whose
+ * access was revoked fails here with a clear reason, instead of surfacing later as a
+ * container error.
+ *
+ * Rejects — rather than answering `false` — if the request itself fails, so a network
+ * blip is never reported as a missing permission.
+ *
+ * @param token - Instagram access token.
+ * @returns Promise of `true` if the token can publish. On `false`, the API's reason is logged.
+ *
+ * @example
+ * ```ts
+ * import { canPublishToInstagram } from "naystack/socials";
+ *
+ * if (!(await canPublishToInstagram(process.env.INSTAGRAM_ACCESS_TOKEN!))) {
+ *   throw new Error("Instagram token cannot publish — reconnect with the publish scope");
+ * }
+ * ```
+ *
+ * @category Socials
+ */
+declare const canPublishToInstagram: (token: string) => Promise<boolean>;
 
-export { getInstagramConversation, getInstagramConversationByUser, getInstagramConversations, getInstagramConversationsByUser, getInstagramMedia, getInstagramMessage, getInstagramUser };
+export { canPublishToInstagram, getInstagramContainerStatus, getInstagramConversation, getInstagramConversationByUser, getInstagramConversations, getInstagramConversationsByUser, getInstagramMedia, getInstagramMessage, getInstagramUser };

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

@@ -1,4 +1,6 @@
-import { InstagramConversation, InstagramError, InstagramMedia, InstagramMessage, InstagramUser } from './types.js';
+import { GraphError, ContainerState } from '../meta/types.js';
+import { InstagramConversation, InstagramMedia, InstagramMessage, InstagramUser } from './types.js';
+import '../meta/container.js';
 
 /**
  * Fetches an Instagram user's profile. Defaults to the authenticated user (`"me"`).
@@ -18,7 +20,7 @@ import { InstagramConversation, InstagramError, InstagramMedia, InstagramMessage
  *
  * @category Socials
  */
-declare const getInstagramUser: <T = InstagramUser>(token: string, id?: string, fields?: string[]) => Promise<(T & InstagramError) | null>;
+declare const getInstagramUser: <T = InstagramUser>(token: string, id?: string, fields?: string[]) => Promise<(T & GraphError) | null>;
 /**
  * Fetches the authenticated user's recent Instagram media.
  *
@@ -41,7 +43,7 @@ declare const getInstagramUser: <T = InstagramUser>(token: string, id?: string,
  */
 declare const getInstagramMedia: <T = InstagramMedia>(token: string, fields?: string[], limit?: number) => Promise<({
     data: T[];
-} & InstagramError) | null>;
+} & GraphError) | null>;
 /**
  * Fetches Instagram conversations (DM threads) with pagination support.
  *
@@ -92,7 +94,7 @@ declare const getInstagramConversations: (token: string, limit?: number, cursor?
  */
 declare const getInstagramConversationsByUser: (token: string, userID: string) => Promise<({
     data: InstagramConversation[];
-} & InstagramError) | null>;
+} & GraphError) | null>;
 /**
  * Fetches the single conversation between the authenticated user and the given user.
  * Filters for conversations with exactly 2 participants.
@@ -149,6 +151,54 @@ declare const getInstagramConversation: (token: string, id: string, cursor?: str
  *
  * @category Socials
  */
-declare const getInstagramMessage: <T = InstagramMessage>(token: string, id: string, fields?: string[]) => Promise<(T & InstagramError) | null>;
+declare const getInstagramMessage: <T = InstagramMessage>(token: string, id: string, fields?: string[]) => Promise<(T & GraphError) | null>;
+/**
+ * Reads a media container's processing status. Videos and reels must reach
+ * `FINISHED` before they can be published.
+ *
+ * @param token - Instagram access token.
+ * @param id - Container id from `createInstagramContainer`.
+ * @returns Promise of `{ status, error? }`, or `null` if the status was unreadable.
+ *
+ * @example
+ * ```ts
+ * import { getInstagramContainerStatus } from "naystack/socials";
+ *
+ * const state = await getInstagramContainerStatus(accessToken, containerId);
+ * if (state?.status === "FINISHED") await publishInstagramContainer(accessToken, containerId);
+ * ```
+ *
+ * @category Socials
+ */
+declare const getInstagramContainerStatus: (token: string, id: string) => Promise<ContainerState | null>;
+/**
+ * Checks whether an access token is allowed to publish.
+ *
+ * Meta exposes no scope-listing endpoint for Instagram Login tokens, so this probes
+ * the publishing quota — a read-only endpoint that needs exactly the same
+ * `instagram_business_content_publish` scope publishing does. Nothing is posted.
+ *
+ * Worth calling before {@link createInstagramPost} in a scheduled job: a token whose
+ * access was revoked fails here with a clear reason, instead of surfacing later as a
+ * container error.
+ *
+ * Rejects — rather than answering `false` — if the request itself fails, so a network
+ * blip is never reported as a missing permission.
+ *
+ * @param token - Instagram access token.
+ * @returns Promise of `true` if the token can publish. On `false`, the API's reason is logged.
+ *
+ * @example
+ * ```ts
+ * import { canPublishToInstagram } from "naystack/socials";
+ *
+ * if (!(await canPublishToInstagram(process.env.INSTAGRAM_ACCESS_TOKEN!))) {
+ *   throw new Error("Instagram token cannot publish — reconnect with the publish scope");
+ * }
+ * ```
+ *
+ * @category Socials
+ */
+declare const canPublishToInstagram: (token: string) => Promise<boolean>;
 
-export { getInstagramConversation, getInstagramConversationByUser, getInstagramConversations, getInstagramConversationsByUser, getInstagramMedia, getInstagramMessage, getInstagramUser };
+export { canPublishToInstagram, getInstagramContainerStatus, getInstagramConversation, getInstagramConversationByUser, getInstagramConversations, getInstagramConversationsByUser, getInstagramMedia, getInstagramMessage, getInstagramUser };

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

@@ -1,36 +1,55 @@
-// 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;
+
 // 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) => ({
@@ -46,8 +65,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
+      }
     }
   );
 };
@@ -56,9 +77,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,
@@ -72,10 +95,36 @@ 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;
+};
 export {
+  canPublishToInstagram,
+  getInstagramContainerStatus,
   getInstagramConversation,
   getInstagramConversationByUser,
   getInstagramConversations,

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

@@ -20,35 +20,213 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/socials/instagram/setters.ts
 var setters_exports = {};
 __export(setters_exports, {
+  createInstagramPost: () => createInstagramPost,
   sendInstagramMessage: () => sendInstagramMessage
 });
 module.exports = __toCommonJS(setters_exports);
 
+// 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;
+    }
+    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;
     }
-  }).then((res) => res.json());
+  };
 }
 
 // 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
+      }
     }
   });
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createInstagramPost,
   sendInstagramMessage
 });

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

@@ -1,5 +1,45 @@
-import { InstagramError } from './types.mjs';
+import { GraphError } from '../meta/types.mjs';
+import { InstagramPostInput } from './types.mjs';
+import '../meta/container.mjs';
 
+/**
+ * Publishes to Instagram — feed image, reel, story or carousel, chosen from the
+ * media you pass. Creates the media container, waits for Instagram to finish
+ * processing it, then publishes.
+ *
+ * Needs an access token with the `instagram_business_content_publish` scope and an
+ * Instagram professional account. Media URLs must be publicly reachable (Instagram
+ * downloads them server-side) and images must be JPEG. Instagram allows 100
+ * published posts per rolling 24 hours.
+ *
+ * @param token - Instagram access token.
+ * @param input - See {@link InstagramPostInput}.
+ * @returns Promise of the published media id, or `null` if any step failed (the API's error is logged).
+ *
+ * @example
+ * ```ts
+ * import { createInstagramPost } from "naystack/socials";
+ *
+ * // Reel
+ * await createInstagramPost(accessToken, {
+ *   media: { url: "https://cdn.example.com/promo.mp4", type: "video" },
+ *   caption: "Behind the scenes",
+ *   shareToFeed: true,
+ * });
+ *
+ * // Carousel
+ * await createInstagramPost(accessToken, {
+ *   caption: "Campaign recap",
+ *   media: [
+ *     { url: "https://cdn.example.com/1.jpg", type: "image" },
+ *     { url: "https://cdn.example.com/2.mp4", type: "video" },
+ *   ],
+ * });
+ * ```
+ *
+ * @category Socials
+ */
+declare const createInstagramPost: (token: string, input: InstagramPostInput) => Promise<string | null>;
 /**
  * Sends a text message to an Instagram user via the Instagram Messaging API.
  *
@@ -21,6 +61,6 @@ import { InstagramError } from './types.mjs';
 declare const sendInstagramMessage: (token: string, to: string, text: string) => Promise<({
     recipient_id?: string;
     message_id?: string;
-} & InstagramError) | null>;
+} & GraphError) | null>;
 
-export { sendInstagramMessage };
+export { createInstagramPost, sendInstagramMessage };

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

@@ -1,5 +1,45 @@
-import { InstagramError } from './types.js';
+import { GraphError } from '../meta/types.js';
+import { InstagramPostInput } from './types.js';
+import '../meta/container.js';
 
+/**
+ * Publishes to Instagram — feed image, reel, story or carousel, chosen from the
+ * media you pass. Creates the media container, waits for Instagram to finish
+ * processing it, then publishes.
+ *
+ * Needs an access token with the `instagram_business_content_publish` scope and an
+ * Instagram professional account. Media URLs must be publicly reachable (Instagram
+ * downloads them server-side) and images must be JPEG. Instagram allows 100
+ * published posts per rolling 24 hours.
+ *
+ * @param token - Instagram access token.
+ * @param input - See {@link InstagramPostInput}.
+ * @returns Promise of the published media id, or `null` if any step failed (the API's error is logged).
+ *
+ * @example
+ * ```ts
+ * import { createInstagramPost } from "naystack/socials";
+ *
+ * // Reel
+ * await createInstagramPost(accessToken, {
+ *   media: { url: "https://cdn.example.com/promo.mp4", type: "video" },
+ *   caption: "Behind the scenes",
+ *   shareToFeed: true,
+ * });
+ *
+ * // Carousel
+ * await createInstagramPost(accessToken, {
+ *   caption: "Campaign recap",
+ *   media: [
+ *     { url: "https://cdn.example.com/1.jpg", type: "image" },
+ *     { url: "https://cdn.example.com/2.mp4", type: "video" },
+ *   ],
+ * });
+ * ```
+ *
+ * @category Socials
+ */
+declare const createInstagramPost: (token: string, input: InstagramPostInput) => Promise<string | null>;
 /**
  * Sends a text message to an Instagram user via the Instagram Messaging API.
  *
@@ -21,6 +61,6 @@ import { InstagramError } from './types.js';
 declare const sendInstagramMessage: (token: string, to: string, text: string) => Promise<({
     recipient_id?: string;
     message_id?: string;
-} & InstagramError) | null>;
+} & GraphError) | null>;
 
-export { sendInstagramMessage };
+export { createInstagramPost, sendInstagramMessage };