@nextclaw/channel-extension-whatsapp 0.1.1-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NextClaw contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/index.js

@@ -0,0 +1 @@
+export {};

package/dist/main.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/main.js

@@ -0,0 +1,12 @@
+import { WhatsAppChannel } from "./services/whatsapp-channel.service.js";
+import { startBusChannelExtension, warnNcpEventError } from "@nextclaw/extension-sdk";
+//#region src/main.ts
+await startBusChannelExtension({
+	channelId: "whatsapp",
+	createChannel: ({ config, bus }) => new WhatsAppChannel(config, bus),
+	onChannelStartError: warnNcpEventError("whatsapp")
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","names":[],"sources":["../src/main.ts"],"sourcesContent":["import type { Config, MessageBus } from \"@nextclaw/core\";\nimport { startBusChannelExtension, warnNcpEventError } from \"@nextclaw/extension-sdk\";\nimport { WhatsAppChannel } from \"./services/whatsapp-channel.service.js\";\n\nawait startBusChannelExtension<Config[\"channels\"][\"whatsapp\"], MessageBus>({\n  channelId: \"whatsapp\",\n  createChannel: ({ config, bus }) => new WhatsAppChannel(config, bus),\n  onChannelStartError: warnNcpEventError(\"whatsapp\"),\n});\n"],"mappings":";;;AAIA,MAAM,yBAAqE;CACzE,WAAW;CACX,gBAAgB,EAAE,QAAQ,UAAU,IAAI,gBAAgB,QAAQ,IAAI;CACpE,qBAAqB,kBAAkB,WAAW;CACnD,CAAC"}

package/dist/services/whatsapp-channel.service.js

@@ -0,0 +1,102 @@
+import { BaseChannel } from "@nextclaw/core";
+import WebSocket from "ws";
+//#region src/services/whatsapp-channel.service.ts
+var WhatsAppChannel = class extends BaseChannel {
+	name = "whatsapp";
+	ws = null;
+	connected = false;
+	constructor(config, bus) {
+		super(config, bus);
+	}
+	start = async () => {
+		this.running = true;
+		const bridgeUrl = this.config.bridgeUrl;
+		while (this.running) try {
+			await new Promise((resolve, reject) => {
+				const ws = new WebSocket(bridgeUrl);
+				this.ws = ws;
+				ws.on("open", () => {
+					this.connected = true;
+				});
+				ws.on("message", (data) => {
+					const payload = data.toString();
+					this.handleBridgeMessage(payload);
+				});
+				ws.on("close", () => {
+					this.connected = false;
+					this.ws = null;
+					resolve();
+				});
+				ws.on("error", (_err) => {
+					this.connected = false;
+					this.ws = null;
+					reject(_err);
+				});
+			});
+		} catch {
+			if (!this.running) break;
+			await sleep(5e3);
+		}
+	};
+	stop = async () => {
+		this.running = false;
+		this.connected = false;
+		if (this.ws) {
+			this.ws.close();
+			this.ws = null;
+		}
+	};
+	send = async (msg) => {
+		if (!this.ws || !this.connected) return;
+		const payload = {
+			type: "send",
+			to: msg.chatId,
+			text: msg.content
+		};
+		this.ws.send(JSON.stringify(payload));
+	};
+	handleBridgeMessage = async (raw) => {
+		let data;
+		try {
+			data = JSON.parse(raw);
+		} catch {
+			return;
+		}
+		const msgType = data.type;
+		if (msgType === "message") {
+			const pn = data.pn ?? "";
+			const sender = data.sender ?? "";
+			let content = data.content ?? "";
+			const userId = pn || sender;
+			const senderId = userId.includes("@") ? userId.split("@")[0] : userId;
+			if (content === "[Voice Message]") content = "[Voice Message: Transcription not available for WhatsApp yet]";
+			await this.handleMessage({
+				senderId,
+				chatId: sender || userId,
+				content,
+				attachments: [],
+				metadata: {
+					message_id: data.id,
+					timestamp: data.timestamp,
+					is_group: Boolean(data.isGroup)
+				}
+			});
+			return;
+		}
+		if (msgType === "status") {
+			const status = data.status;
+			if (status === "connected") this.connected = true;
+			else if (status === "disconnected") this.connected = false;
+			return;
+		}
+		if (msgType === "qr") return;
+		if (msgType === "error") return;
+	};
+};
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//#endregion
+export { WhatsAppChannel };
+
+//# sourceMappingURL=whatsapp-channel.service.js.map

package/dist/services/whatsapp-channel.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-channel.service.js","names":[],"sources":["../../src/services/whatsapp-channel.service.ts"],"sourcesContent":["import { BaseChannel, type Config, type MessageBus, type OutboundMessage } from \"@nextclaw/core\";\nimport WebSocket from \"ws\";\nexport class WhatsAppChannel extends BaseChannel<Config[\"channels\"][\"whatsapp\"]> {\n    name = \"whatsapp\";\n    private ws: WebSocket | null = null;\n    private connected = false;\n    constructor(config: Config[\"channels\"][\"whatsapp\"], bus: MessageBus) {\n        super(config, bus);\n    }\n    start = async (): Promise<void> => {\n        this.running = true;\n        const bridgeUrl = this.config.bridgeUrl;\n        while (this.running) {\n            try {\n                await new Promise<void>((resolve, reject) => {\n                    const ws = new WebSocket(bridgeUrl);\n                    this.ws = ws;\n                    ws.on(\"open\", () => {\n                        this.connected = true;\n                    });\n                    ws.on(\"message\", (data: WebSocket.RawData) => {\n                        const payload = data.toString();\n                        void this.handleBridgeMessage(payload);\n                    });\n                    ws.on(\"close\", () => {\n                        this.connected = false;\n                        this.ws = null;\n                        resolve();\n                    });\n                    ws.on(\"error\", (_err: Error) => {\n                        this.connected = false;\n                        this.ws = null;\n                        reject(_err);\n                    });\n                });\n            }\n            catch {\n                if (!this.running) {\n                    break;\n                }\n                await sleep(5000);\n            }\n        }\n    };\n    stop = async (): Promise<void> => {\n        this.running = false;\n        this.connected = false;\n        if (this.ws) {\n            this.ws.close();\n            this.ws = null;\n        }\n    };\n    send = async (msg: OutboundMessage): Promise<void> => {\n        if (!this.ws || !this.connected) {\n            return;\n        }\n        const payload = {\n            type: \"send\",\n            to: msg.chatId,\n            text: msg.content\n        };\n        this.ws.send(JSON.stringify(payload));\n    };\n    private handleBridgeMessage = async (raw: string): Promise<void> => {\n        let data: Record<string, unknown>;\n        try {\n            data = JSON.parse(raw) as Record<string, unknown>;\n        }\n        catch {\n            return;\n        }\n        const msgType = data.type as string | undefined;\n        if (msgType === \"message\") {\n            const pn = (data.pn as string | undefined) ?? \"\";\n            const sender = (data.sender as string | undefined) ?? \"\";\n            let content = (data.content as string | undefined) ?? \"\";\n            const userId = pn || sender;\n            const senderId = userId.includes(\"@\") ? userId.split(\"@\")[0] : userId;\n            if (content === \"[Voice Message]\") {\n                content = \"[Voice Message: Transcription not available for WhatsApp yet]\";\n            }\n            await this.handleMessage({\n                senderId,\n                chatId: sender || userId,\n                content,\n                attachments: [],\n                metadata: {\n                    message_id: data.id,\n                    timestamp: data.timestamp,\n                    is_group: Boolean(data.isGroup)\n                }\n            });\n            return;\n        }\n        if (msgType === \"status\") {\n            const status = data.status as string | undefined;\n            if (status === \"connected\") {\n                this.connected = true;\n            }\n            else if (status === \"disconnected\") {\n                this.connected = false;\n            }\n            return;\n        }\n        if (msgType === \"qr\") {\n            return;\n        }\n        if (msgType === \"error\") {\n            return;\n        }\n    };\n}\nfunction sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n"],"mappings":";;;AAEA,IAAa,kBAAb,cAAqC,YAA4C;CAC7E,OAAO;CACP,KAA+B;CAC/B,YAAoB;CACpB,YAAY,QAAwC,KAAiB;AACjE,QAAM,QAAQ,IAAI;;CAEtB,QAAQ,YAA2B;AAC/B,OAAK,UAAU;EACf,MAAM,YAAY,KAAK,OAAO;AAC9B,SAAO,KAAK,QACR,KAAI;AACA,SAAM,IAAI,SAAe,SAAS,WAAW;IACzC,MAAM,KAAK,IAAI,UAAU,UAAU;AACnC,SAAK,KAAK;AACV,OAAG,GAAG,cAAc;AAChB,UAAK,YAAY;MACnB;AACF,OAAG,GAAG,YAAY,SAA4B;KAC1C,MAAM,UAAU,KAAK,UAAU;AAC1B,UAAK,oBAAoB,QAAQ;MACxC;AACF,OAAG,GAAG,eAAe;AACjB,UAAK,YAAY;AACjB,UAAK,KAAK;AACV,cAAS;MACX;AACF,OAAG,GAAG,UAAU,SAAgB;AAC5B,UAAK,YAAY;AACjB,UAAK,KAAK;AACV,YAAO,KAAK;MACd;KACJ;UAEA;AACF,OAAI,CAAC,KAAK,QACN;AAEJ,SAAM,MAAM,IAAK;;;CAI7B,OAAO,YAA2B;AAC9B,OAAK,UAAU;AACf,OAAK,YAAY;AACjB,MAAI,KAAK,IAAI;AACT,QAAK,GAAG,OAAO;AACf,QAAK,KAAK;;;CAGlB,OAAO,OAAO,QAAwC;AAClD,MAAI,CAAC,KAAK,MAAM,CAAC,KAAK,UAClB;EAEJ,MAAM,UAAU;GACZ,MAAM;GACN,IAAI,IAAI;GACR,MAAM,IAAI;GACb;AACD,OAAK,GAAG,KAAK,KAAK,UAAU,QAAQ,CAAC;;CAEzC,sBAA8B,OAAO,QAA+B;EAChE,IAAI;AACJ,MAAI;AACA,UAAO,KAAK,MAAM,IAAI;UAEpB;AACF;;EAEJ,MAAM,UAAU,KAAK;AACrB,MAAI,YAAY,WAAW;GACvB,MAAM,KAAM,KAAK,MAA6B;GAC9C,MAAM,SAAU,KAAK,UAAiC;GACtD,IAAI,UAAW,KAAK,WAAkC;GACtD,MAAM,SAAS,MAAM;GACrB,MAAM,WAAW,OAAO,SAAS,IAAI,GAAG,OAAO,MAAM,IAAI,CAAC,KAAK;AAC/D,OAAI,YAAY,kBACZ,WAAU;AAEd,SAAM,KAAK,cAAc;IACrB;IACA,QAAQ,UAAU;IAClB;IACA,aAAa,EAAE;IACf,UAAU;KACN,YAAY,KAAK;KACjB,WAAW,KAAK;KAChB,UAAU,QAAQ,KAAK,QAAQ;KAClC;IACJ,CAAC;AACF;;AAEJ,MAAI,YAAY,UAAU;GACtB,MAAM,SAAS,KAAK;AACpB,OAAI,WAAW,YACX,MAAK,YAAY;YAEZ,WAAW,eAChB,MAAK,YAAY;AAErB;;AAEJ,MAAI,YAAY,KACZ;AAEJ,MAAI,YAAY,QACZ;;;AAIZ,SAAS,MAAM,IAA2B;AACtC,QAAO,IAAI,SAAS,YAAY,WAAW,SAAS,GAAG,CAAC"}

package/nextclaw.extension.json

@@ -0,0 +1,31 @@
+{
+  "id": "nextclaw-channel-extension-whatsapp",
+  "name": "NextClaw WhatsApp Channel Extension",
+  "version": "0.1.0",
+  "server": {
+    "type": "stdio",
+    "command": "node",
+    "args": ["dist/main.js"]
+  },
+  "contributes": {
+    "channels": [
+      {
+        "id": "whatsapp",
+        "name": "WhatsApp",
+        "description": "WhatsApp bridge channel",
+        "configSchema": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "bridgeUrl": { "type": "string" },
+            "allowFrom": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        }
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@nextclaw/channel-extension-whatsapp",
+  "version": "0.1.1-beta.0",
+  "private": false,
+  "description": "NextClaw WhatsApp channel extension process.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "nextclaw.extension.json"
+  ],
+  "dependencies": {
+    "ws": "^8.18.0",
+    "@nextclaw/core": "0.12.25-beta.0",
+    "@nextclaw/extension-sdk": "0.1.12-beta.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.6",
+    "@types/ws": "^8.5.14",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts src/main.ts --dts.sourcemap --clean --target es2022 --no-fixedExtension --unbundle",
+    "lint": "eslint src --max-warnings=0",
+    "tsc": "tsc -p tsconfig.json"
+  }
+}