naystack 1.8.17 → 1.8.18

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
@@ -352,6 +356,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 +522,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

@@ -309,6 +309,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 +474,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);
@@ -242,6 +243,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 +263,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

@@ -215,6 +215,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 +234,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/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.18",
   "description": "A stack built with Next + GraphQL + S3 + Auth",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",