naystack 1.5.9 → 1.5.10

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

@@ -1,6 +1,36 @@
 import * as next_server from 'next/server';
 import { NextRequest } from 'next/server';
 
+/**
+ * Sets up GET (verification) and POST (event handling) route handlers for the Threads webhook.
+ *
+ * - **GET**: Responds to Meta's webhook verification challenge (checks `hub.verify_token` against `secret`).
+ * - **POST**: Parses incoming webhook events and calls your `callback` for each event.
+ *
+ * @param options - Configuration object.
+ * @param options.secret - The verify token you configured in the Meta Developer Portal.
+ * @param options.callback - Called for each webhook event: `(field, value) => Promise<boolean>`.
+ *   - `field` — Event field name.
+ *   - `value` — Event payload.
+ *   Return `true` to acknowledge; return `false` to respond with HTTP 500.
+ * @returns Object with `GET` and `POST` — export as your route's handlers.
+ *
+ * @example
+ * ```ts
+ * // app/api/webhooks/threads/route.ts
+ * import { setupThreadsWebhook } from "naystack/socials";
+ *
+ * export const { GET, POST } = setupThreadsWebhook({
+ *   secret: process.env.WEBHOOK_SECRET!,
+ *   callback: async (field, value) => {
+ *     console.log("Threads event:", field, value);
+ *     return true; // Return false to respond with 500
+ *   },
+ * });
+ * ```
+ *
+ * @category Socials
+ */
 declare const setupThreadsWebhook: (options: {
     secret: string;
     callback: (type: string, value: any) => Promise<boolean>;

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

@@ -1,6 +1,36 @@
 import * as next_server from 'next/server';
 import { NextRequest } from 'next/server';
 
+/**
+ * Sets up GET (verification) and POST (event handling) route handlers for the Threads webhook.
+ *
+ * - **GET**: Responds to Meta's webhook verification challenge (checks `hub.verify_token` against `secret`).
+ * - **POST**: Parses incoming webhook events and calls your `callback` for each event.
+ *
+ * @param options - Configuration object.
+ * @param options.secret - The verify token you configured in the Meta Developer Portal.
+ * @param options.callback - Called for each webhook event: `(field, value) => Promise<boolean>`.
+ *   - `field` — Event field name.
+ *   - `value` — Event payload.
+ *   Return `true` to acknowledge; return `false` to respond with HTTP 500.
+ * @returns Object with `GET` and `POST` — export as your route's handlers.
+ *
+ * @example
+ * ```ts
+ * // app/api/webhooks/threads/route.ts
+ * import { setupThreadsWebhook } from "naystack/socials";
+ *
+ * export const { GET, POST } = setupThreadsWebhook({
+ *   secret: process.env.WEBHOOK_SECRET!,
+ *   callback: async (field, value) => {
+ *     console.log("Threads event:", field, value);
+ *     return true; // Return false to respond with 500
+ *   },
+ * });
+ * ```
+ *
+ * @category Socials
+ */
 declare const setupThreadsWebhook: (options: {
     secret: string;
     callback: (type: string, value: any) => Promise<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "naystack",
-  "version": "1.5.9",
+  "version": "1.5.10",
   "description": "A stack built with Next + GraphQL + S3 + Auth",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
@@ -9,7 +9,8 @@
     "dist"
   ],
   "scripts": {
-    "build": "NODE_OPTIONS='--max-old-space-size=16384' tsup"
+    "build": "NODE_OPTIONS='--max-old-space-size=16384' tsup",
+    "docs": "typedoc"
   },
   "exports": {
     "./auth": {
@@ -125,6 +126,7 @@
     "prettier": "^3.5.3",
     "tsup": "^8.5.0",
     "tsx": "^4.20.5",
+    "typedoc": "^0.28.16",
     "typescript": "^5.9.2",
     "typescript-eslint": "^8.31.1"
   },