Add Messenger adapter

.changeset/add-facebook-adapter.md

@@ -0,0 +1,5 @@
+---
+"@chat-adapter/messenger": minor
+---
+
+Add Messenger adapter with support for messages, reactions, postbacks, typing indicators, and webhook verification

examples/nextjs-chat/.env.example

@@ -21,6 +21,11 @@ BOT_USERNAME=mybot
 # DISCORD_BOT_TOKEN=your-bot-token
 # DISCORD_PUBLIC_KEY=your-public-key
 
+# Facebook Messenger (optional)
+# FACEBOOK_APP_SECRET=your-app-secret
+# FACEBOOK_PAGE_ACCESS_TOKEN=your-page-access-token
+# FACEBOOK_VERIFY_TOKEN=your-verify-token
+
 # GitHub (optional) - use PAT OR GitHub App, not both
 # PAT authentication:
 # GITHUB_TOKEN=ghp_xxxxxxxxxxxx

examples/nextjs-chat/package.json

@@ -12,14 +12,15 @@
   },
   "dependencies": {
     "@chat-adapter/discord": "workspace:*",
+    "@chat-adapter/messenger": "workspace:*",
     "@chat-adapter/gchat": "workspace:*",
     "@chat-adapter/github": "workspace:*",
     "@chat-adapter/linear": "workspace:*",
     "@chat-adapter/slack": "workspace:*",
     "@chat-adapter/state-memory": "workspace:*",
     "@chat-adapter/state-redis": "workspace:*",
-    "@chat-adapter/telegram": "workspace:*",
     "@chat-adapter/teams": "workspace:*",
+    "@chat-adapter/telegram": "workspace:*",
     "@chat-adapter/whatsapp": "workspace:*",
     "ai": "^6.0.5",
     "chat": "workspace:*",

examples/nextjs-chat/src/app/api/webhooks/[platform]/route.ts

@@ -29,7 +29,7 @@ export async function POST(
 }
 
 // GET handler — serves as health check, but also forwards to webhook handler
-// for platforms that need GET verification (e.g. WhatsApp challenge-response)
+// for platforms that need GET verification (e.g. WhatsApp/Facebook challenge-response)
 export async function GET(
   request: Request,
   { params }: { params: Promise<{ platform: string }> }

examples/nextjs-chat/src/lib/adapters.ts

@@ -2,6 +2,10 @@ import {
   createDiscordAdapter,
   type DiscordAdapter,
 } from "@chat-adapter/discord";
+import {
+  createMessengerAdapter,
+  type MessengerAdapter,
+} from "@chat-adapter/messenger";
 import {
   createGoogleChatAdapter,
   type GoogleChatAdapter,
@@ -26,6 +30,7 @@ const logger = new ConsoleLogger("info");
 
 export interface Adapters {
   discord?: DiscordAdapter;
+  messenger?: MessengerAdapter;
   gchat?: GoogleChatAdapter;
   github?: GitHubAdapter;
   linear?: LinearAdapter;
@@ -91,6 +96,12 @@ const LINEAR_METHODS = [
   "addReaction",
   "fetchMessages",
 ];
+const MESSENGER_METHODS = [
+  "postMessage",
+  "startTyping",
+  "openDM",
+  "fetchMessages",
+];
 const TELEGRAM_METHODS = [
   "postMessage",
   "editMessage",
@@ -137,6 +148,18 @@ export function buildAdapters(): Adapters {
     );
   }
 
+  // Messenger adapter (optional) - env vars: FACEBOOK_APP_SECRET, FACEBOOK_PAGE_ACCESS_TOKEN, FACEBOOK_VERIFY_TOKEN
+  if (process.env.FACEBOOK_APP_SECRET) {
+    adapters.messenger = withRecording(
+      createMessengerAdapter({
+        userName: "Chat SDK Bot",
+        logger: logger.child("messenger"),
+      }),
+      "messenger",
+      MESSENGER_METHODS
+    );
+  }
+
   // Slack adapter (optional) - env vars: SLACK_SIGNING_SECRET + (SLACK_BOT_TOKEN or SLACK_CLIENT_ID/SECRET)
   if (process.env.SLACK_SIGNING_SECRET) {
     adapters.slack = withRecording(

packages/adapter-messenger/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@chat-adapter/messenger",
+  "version": "4.15.0",
+  "description": "Messenger adapter for chat",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@chat-adapter/shared": "workspace:*",
+    "chat": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vercel/chat.git",
+    "directory": "packages/adapter-messenger"
+  },
+  "homepage": "https://github.com/vercel/chat#readme",
+  "bugs": {
+    "url": "https://github.com/vercel/chat/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "chat",
+    "messenger",
+    "bot",
+    "adapter"
+  ],
+  "license": "MIT"
+}