naystack 1.8.12 → 1.8.14

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

@@ -1,3 +1,6 @@
+import { WaitForContainerOptions } from '../meta/container.mjs';
+import { MetaMediaType } from '../meta/types.mjs';
+
 /**
  * Threads post (single post or reply).
  *
@@ -12,5 +15,41 @@ type ThreadsPost = {
     permalink: string;
     username: string;
 };
+/**
+ * One image or video to publish. The URL must be publicly reachable — Threads
+ * downloads it server-side.
+ *
+ * @property url - Public URL. Images: JPEG/PNG, 8 MB max. Videos: MP4/MOV, 1 GB / 5 min max.
+ * @property type - `"image"` or `"video"`.
+ * @property altText - Accessibility description.
+ *
+ * @category Socials
+ */
+type ThreadsPostMedia = {
+    url: string;
+    type: MetaMediaType;
+    altText?: string;
+};
+/**
+ * Input for {@link createThreadsPost}. What gets published follows from `media`:
+ * none is a text post, one is a single image or video, 2–20 is a carousel.
+ *
+ * @property text - Post text, 500 characters max.
+ * @property media - One item or an array.
+ * @property linkAttachment - URL to render as a preview card. Text-only posts.
+ * @property replyToID - Parent post id, to make this post a reply.
+ * @property replyControl - Who may reply.
+ * @property wait - Container polling settings.
+ *
+ * @category Socials
+ */
+type ThreadsPostInput = {
+    text?: string;
+    media?: ThreadsPostMedia | ThreadsPostMedia[];
+    linkAttachment?: string;
+    replyToID?: string;
+    replyControl?: "everyone" | "accounts_you_follow" | "mentioned_only";
+    wait?: WaitForContainerOptions;
+};
 
-export type { ThreadsPost };
+export type { ThreadsPost, ThreadsPostInput, ThreadsPostMedia };

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

@@ -1,3 +1,6 @@
+import { WaitForContainerOptions } from '../meta/container.js';
+import { MetaMediaType } from '../meta/types.js';
+
 /**
  * Threads post (single post or reply).
  *
@@ -12,5 +15,41 @@ type ThreadsPost = {
     permalink: string;
     username: string;
 };
+/**
+ * One image or video to publish. The URL must be publicly reachable — Threads
+ * downloads it server-side.
+ *
+ * @property url - Public URL. Images: JPEG/PNG, 8 MB max. Videos: MP4/MOV, 1 GB / 5 min max.
+ * @property type - `"image"` or `"video"`.
+ * @property altText - Accessibility description.
+ *
+ * @category Socials
+ */
+type ThreadsPostMedia = {
+    url: string;
+    type: MetaMediaType;
+    altText?: string;
+};
+/**
+ * Input for {@link createThreadsPost}. What gets published follows from `media`:
+ * none is a text post, one is a single image or video, 2–20 is a carousel.
+ *
+ * @property text - Post text, 500 characters max.
+ * @property media - One item or an array.
+ * @property linkAttachment - URL to render as a preview card. Text-only posts.
+ * @property replyToID - Parent post id, to make this post a reply.
+ * @property replyControl - Who may reply.
+ * @property wait - Container polling settings.
+ *
+ * @category Socials
+ */
+type ThreadsPostInput = {
+    text?: string;
+    media?: ThreadsPostMedia | ThreadsPostMedia[];
+    linkAttachment?: string;
+    replyToID?: string;
+    replyControl?: "everyone" | "accounts_you_follow" | "mentioned_only";
+    wait?: WaitForContainerOptions;
+};
 
-export type { ThreadsPost };
+export type { ThreadsPost, ThreadsPostInput, ThreadsPostMedia };

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

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

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

@@ -1,23 +1,14 @@
+import { GraphError } from '../meta/types.mjs';
+import { GraphRequestOptions } from '../meta/request.mjs';
+
 /**
- * Builds a Threads Graph API URL with the given path and query parameters (includes `access_token`).
- *
- * @param token - Threads access token.
- * @param path - API path (e.g. `"me/threads"`, `"me/threads_publish"`).
- * @param params - Query parameters.
- * @returns Full URL string.
- * @category Socials
- */
-declare function getThreadsURL(token: string, path: string, params: Record<string, string>): string;
-/**
- * Fetches JSON from the Threads Graph API (GET or POST).
+ * Fetches JSON from the Threads Graph API.
  *
  * @param token - Threads access token.
  * @param path - API path.
- * @param params - Query parameters.
- * @param method - Set to `"POST"` for mutations; defaults to `"GET"`.
- * @returns Promise of response data (typed as `T`) or `null`.
- * @category Socials
+ * @param options - `params` (query), `method`, `body`.
+ * @returns Promise of `(T & GraphError) | null`.
  */
-declare function getThreadsData<T>(token: string, path: string, params: Record<string, string>, method?: "POST"): Promise<T | null>;
+declare const getThreadsData: <T>(token: string, path: string, options?: GraphRequestOptions) => Promise<(T & GraphError) | null>;
 
-export { getThreadsData, getThreadsURL };
+export { getThreadsData };

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

@@ -1,23 +1,14 @@
+import { GraphError } from '../meta/types.js';
+import { GraphRequestOptions } from '../meta/request.js';
+
 /**
- * Builds a Threads Graph API URL with the given path and query parameters (includes `access_token`).
- *
- * @param token - Threads access token.
- * @param path - API path (e.g. `"me/threads"`, `"me/threads_publish"`).
- * @param params - Query parameters.
- * @returns Full URL string.
- * @category Socials
- */
-declare function getThreadsURL(token: string, path: string, params: Record<string, string>): string;
-/**
- * Fetches JSON from the Threads Graph API (GET or POST).
+ * Fetches JSON from the Threads Graph API.
  *
  * @param token - Threads access token.
  * @param path - API path.
- * @param params - Query parameters.
- * @param method - Set to `"POST"` for mutations; defaults to `"GET"`.
- * @returns Promise of response data (typed as `T`) or `null`.
- * @category Socials
+ * @param options - `params` (query), `method`, `body`.
+ * @returns Promise of `(T & GraphError) | null`.
  */
-declare function getThreadsData<T>(token: string, path: string, params: Record<string, string>, method?: "POST"): Promise<T | null>;
+declare const getThreadsData: <T>(token: string, path: string, options?: GraphRequestOptions) => Promise<(T & GraphError) | null>;
 
-export { getThreadsData, getThreadsURL };
+export { getThreadsData };

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

@@ -1,13 +1,30 @@
-// 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());
+// 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 };
 }
+
+// src/socials/threads/utils.ts
+var client = createGraphClient("https://graph.threads.net/v1.0");
+var getThreadsData = client.request;
 export {
-  getThreadsData,
-  getThreadsURL
+  getThreadsData
 };

package/dist/socials/threads/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/threads/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/package.json

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