@elizaos/plugin-whatsapp 0.1.7-alpha.1

package/Readme.md

@@ -0,0 +1,154 @@
+# WhatsApp Cloud API Plugin
+
+A plugin for integrating WhatsApp Cloud API with your application.
+
+## Installation
+
+</file>
+
+npm install @eliza/plugin-whatsapp
+
+## Configuration
+
+typescript
+import { WhatsAppPlugin } from '@eliza/plugin-whatsapp';
+const whatsappPlugin = new WhatsAppPlugin({
+accessToken: 'your_access_token',
+phoneNumberId: 'your_phone_number_id',
+webhookVerifyToken: 'your_webhook_verify_token',
+businessAccountId: 'your_business_account_id'
+});
+
+## Usage
+
+### Sending Messages
+
+typescript
+// Send a text message
+await whatsappPlugin.sendMessage({
+type: 'text',
+to: '1234567890',
+content: 'Hello from WhatsApp!'
+});
+// Send a template message
+await whatsappPlugin.sendMessage({
+type: 'template',
+to: '1234567890',
+content: {
+name: 'hello_world',
+language: {
+code: 'en'
+}
+}
+});
+
+### Handling Webhooks
+
+typescript
+// Verify webhook
+app.get('/webhook', (req, res) => {
+const verified = await whatsappPlugin.verifyWebhook(req.query['hub.verify_token']);
+if (verified) {
+res.send(req.query['hub.challenge']);
+} else {
+res.sendStatus(403);
+}
+});
+// Handle webhook events
+app.post('/webhook', (req, res) => {
+await whatsappPlugin.handleWebhook(req.body);
+res.sendStatus(200);
+});
+
+## Features
+
+-   Send text messages
+-   Send template messages
+-   Webhook verification
+-   Webhook event handling
+-   Message status updates
+
+## API Reference
+
+### WhatsAppPlugin
+
+#### Constructor
+
+-   `config: WhatsAppConfig` - Configuration object for the plugin
+
+#### Methods
+
+-   `sendMessage(message: WhatsAppMessage): Promise<any>` - Send a WhatsApp message
+-   `handleWebhook(event: WhatsAppWebhookEvent): Promise<void>` - Process incoming webhook events
+-   `verifyWebhook(token: string): Promise<boolean>` - Verify webhook token
+
+### Types
+
+typescript
+interface WhatsAppConfig {
+accessToken: string;
+phoneNumberId: string;
+webhookVerifyToken?: string;
+businessAccountId?: string;
+}
+interface WhatsAppMessage {
+type: 'text' | 'template';
+to: string;
+content: string | WhatsAppTemplate;
+}
+interface WhatsAppTemplate {
+name: string;
+language: {
+code: string;
+};
+components?: Array<{
+type: string;
+parameters: Array<{
+type: string;
+text?: string;
+}>;
+}>;
+}
+
+## Error Handling
+
+The plugin throws errors in the following cases:
+
+-   Invalid configuration
+-   Failed message sending
+-   Webhook verification failure
+-   Invalid webhook payload
+
+Example error handling:
+
+typescript
+try {
+await whatsappPlugin.sendMessage({
+type: 'text',
+to: '1234567890',
+content: 'Hello!'
+});
+} catch (error) {
+console.error('Failed to send message:', error.message);
+}
+
+## Best Practices
+
+1. Always validate phone numbers before sending messages
+2. Use template messages for first-time messages to users
+3. Store message IDs for tracking delivery status
+4. Implement proper error handling
+5. Set up webhook retry mechanisms
+6. Keep your access tokens secure
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,72 @@
+import { Plugin } from '@elizaos/core';
+
+interface WhatsAppConfig {
+    accessToken: string;
+    phoneNumberId: string;
+    webhookVerifyToken?: string;
+    businessAccountId?: string;
+}
+interface WhatsAppMessage {
+    type: "text" | "template";
+    to: string;
+    content: string | WhatsAppTemplate;
+}
+interface WhatsAppTemplate {
+    name: string;
+    language: {
+        code: string;
+    };
+    components?: Array<{
+        type: string;
+        parameters: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }>;
+}
+interface WhatsAppWebhookEvent {
+    object: string;
+    entry: Array<{
+        id: string;
+        changes: Array<{
+            value: {
+                messaging_product: string;
+                metadata: {
+                    display_phone_number: string;
+                    phone_number_id: string;
+                };
+                statuses?: Array<{
+                    id: string;
+                    status: string;
+                    timestamp: string;
+                    recipient_id: string;
+                }>;
+                messages?: Array<{
+                    from: string;
+                    id: string;
+                    timestamp: string;
+                    text?: {
+                        body: string;
+                    };
+                    type: string;
+                }>;
+            };
+            field: string;
+        }>;
+    }>;
+}
+
+declare class WhatsAppPlugin implements Plugin {
+    private config;
+    private client;
+    private messageHandler;
+    private webhookHandler;
+    name: string;
+    description: string;
+    constructor(config: WhatsAppConfig);
+    sendMessage(message: WhatsAppMessage): Promise<any>;
+    handleWebhook(event: WhatsAppWebhookEvent): Promise<void>;
+    verifyWebhook(token: string): Promise<boolean>;
+}
+
+export { type WhatsAppConfig, type WhatsAppMessage, WhatsAppPlugin, type WhatsAppTemplate, type WhatsAppWebhookEvent };

package/dist/index.mjs

@@ -0,0 +1,116 @@
+// src/client.ts
+import axios from "axios";
+var WhatsAppClient = class {
+  client;
+  config;
+  constructor(config) {
+    this.config = config;
+    this.client = axios.create({
+      baseURL: "https://graph.facebook.com/v17.0",
+      headers: {
+        Authorization: `Bearer ${config.accessToken}`,
+        "Content-Type": "application/json"
+      }
+    });
+  }
+  async sendMessage(message) {
+    const endpoint = `/${this.config.phoneNumberId}/messages`;
+    const payload = {
+      messaging_product: "whatsapp",
+      recipient_type: "individual",
+      to: message.to,
+      type: message.type,
+      ...message.type === "text" ? { text: { body: message.content } } : { template: message.content }
+    };
+    return this.client.post(endpoint, payload);
+  }
+  async verifyWebhook(token) {
+    return token === this.config.webhookVerifyToken;
+  }
+};
+
+// src/handlers/message.handler.ts
+var MessageHandler = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async send(message) {
+    try {
+      const response = await this.client.sendMessage(message);
+      return response.data;
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new Error(
+          `Failed to send WhatsApp message: ${error.message}`
+        );
+      }
+      throw new Error("Failed to send WhatsApp message");
+    }
+  }
+};
+
+// src/handlers/webhook.handler.ts
+var WebhookHandler = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async handle(event) {
+    try {
+      if (event.entry?.[0]?.changes?.[0]?.value?.messages) {
+        const messages = event.entry[0].changes[0].value.messages;
+        for (const message of messages) {
+          await this.handleMessage(message);
+        }
+      }
+      if (event.entry?.[0]?.changes?.[0]?.value?.statuses) {
+        const statuses = event.entry[0].changes[0].value.statuses;
+        for (const status of statuses) {
+          await this.handleStatus(status);
+        }
+      }
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new Error(
+          `Failed to send WhatsApp message: ${error.message}`
+        );
+      }
+      throw new Error("Failed to send WhatsApp message");
+    }
+  }
+  async handleMessage(message) {
+    console.log("Received message:", message);
+  }
+  async handleStatus(status) {
+    console.log("Received status update:", status);
+  }
+};
+
+// src/index.ts
+var WhatsAppPlugin = class {
+  constructor(config) {
+    this.config = config;
+    this.name = "WhatsApp Cloud API Plugin";
+    this.description = "A plugin for integrating WhatsApp Cloud API with your application.";
+    this.client = new WhatsAppClient(config);
+    this.messageHandler = new MessageHandler(this.client);
+    this.webhookHandler = new WebhookHandler(this.client);
+  }
+  client;
+  messageHandler;
+  webhookHandler;
+  name;
+  description;
+  async sendMessage(message) {
+    return this.messageHandler.send(message);
+  }
+  async handleWebhook(event) {
+    return this.webhookHandler.handle(event);
+  }
+  async verifyWebhook(token) {
+    return this.client.verifyWebhook(token);
+  }
+};
+export {
+  WhatsAppPlugin
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/handlers/message.handler.ts","../src/handlers/webhook.handler.ts","../src/index.ts"],"sourcesContent":["import axios, { AxiosInstance } from \"axios\";\nimport { WhatsAppConfig, WhatsAppMessage } from \"./types\";\n\nexport class WhatsAppClient {\n    private client: AxiosInstance;\n    private config: WhatsAppConfig;\n\n    constructor(config: WhatsAppConfig) {\n        this.config = config;\n        this.client = axios.create({\n            baseURL: \"https://graph.facebook.com/v17.0\",\n            headers: {\n                Authorization: `Bearer ${config.accessToken}`,\n                \"Content-Type\": \"application/json\",\n            },\n        });\n    }\n\n    async sendMessage(message: WhatsAppMessage): Promise<any> {\n        const endpoint = `/${this.config.phoneNumberId}/messages`;\n\n        const payload = {\n            messaging_product: \"whatsapp\",\n            recipient_type: \"individual\",\n            to: message.to,\n            type: message.type,\n            ...(message.type === \"text\"\n                ? { text: { body: message.content } }\n                : { template: message.content }),\n        };\n\n        return this.client.post(endpoint, payload);\n    }\n\n    async verifyWebhook(token: string): Promise<boolean> {\n        return token === this.config.webhookVerifyToken;\n    }\n}\n","import { WhatsAppClient } from \"../client\";\nimport { WhatsAppMessage } from \"../types\";\n\nexport class MessageHandler {\n    constructor(private client: WhatsAppClient) {}\n\n    async send(message: WhatsAppMessage): Promise<any> {\n        try {\n            const response = await this.client.sendMessage(message);\n            return response.data;\n        } catch (error: unknown) {\n            if (error instanceof Error) {\n                throw new Error(\n                    `Failed to send WhatsApp message: ${error.message}`\n                );\n            }\n            throw new Error('Failed to send WhatsApp message');\n        }\n    }\n}\n","import { WhatsAppClient } from \"../client\";\nimport { WhatsAppWebhookEvent } from \"../types\";\n\nexport class WebhookHandler {\n    constructor(private client: WhatsAppClient) {}\n\n    async handle(event: WhatsAppWebhookEvent): Promise<void> {\n        try {\n            // Process messages\n            if (event.entry?.[0]?.changes?.[0]?.value?.messages) {\n                const messages = event.entry[0].changes[0].value.messages;\n                for (const message of messages) {\n                    await this.handleMessage(message);\n                }\n            }\n\n            // Process status updates\n            if (event.entry?.[0]?.changes?.[0]?.value?.statuses) {\n                const statuses = event.entry[0].changes[0].value.statuses;\n                for (const status of statuses) {\n                    await this.handleStatus(status);\n                }\n            }\n        } catch (error: unknown) {\n            if (error instanceof Error) {\n                throw new Error(\n                    `Failed to send WhatsApp message: ${error.message}`\n                );\n            }\n            throw new Error(\"Failed to send WhatsApp message\");\n        }\n    }\n\n    private async handleMessage(message: any): Promise<void> {\n        // Implement message handling logic\n        // This could emit events or trigger callbacks based on your framework's needs\n        console.log(\"Received message:\", message);\n    }\n\n    private async handleStatus(status: any): Promise<void> {\n        // Implement status update handling logic\n        // This could emit events or trigger callbacks based on your framework's needs\n        console.log(\"Received status update:\", status);\n    }\n}\n","import { Plugin } from \"@elizaos/core\";\nimport { WhatsAppClient } from \"./client\";\nimport { WhatsAppConfig, WhatsAppMessage, WhatsAppWebhookEvent } from \"./types\";\nimport { MessageHandler, WebhookHandler } from \"./handlers\";\n\nexport class WhatsAppPlugin implements Plugin {\n    private client: WhatsAppClient;\n    private messageHandler: MessageHandler;\n    private webhookHandler: WebhookHandler;\n\n    name: string;\n    description: string;\n\n    constructor(private config: WhatsAppConfig) {\n        this.name = \"WhatsApp Cloud API Plugin\";\n        this.description =\n            \"A plugin for integrating WhatsApp Cloud API with your application.\";\n        this.client = new WhatsAppClient(config);\n        this.messageHandler = new MessageHandler(this.client);\n        this.webhookHandler = new WebhookHandler(this.client);\n    }\n\n    async sendMessage(message: WhatsAppMessage): Promise<any> {\n        return this.messageHandler.send(message);\n    }\n\n    async handleWebhook(event: WhatsAppWebhookEvent): Promise<void> {\n        return this.webhookHandler.handle(event);\n    }\n\n    async verifyWebhook(token: string): Promise<boolean> {\n        return this.client.verifyWebhook(token);\n    }\n}\n\nexport * from \"./types\";\n"],"mappings":"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","names":[]}

package/eslint.config.mjs

@@ -0,0 +1,9 @@
+import eslintGlobalConfig from "../../eslint.config.mjs";
+
+export default [
+    ...eslintGlobalConfig,
+    {
+        files: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"],
+        ignores: ["**/node_modules/**", "**/dist/**"],
+    },
+];

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@elizaos/plugin-whatsapp",
+  "version": "0.1.7-alpha.1",
+  "description": "WhatsApp Cloud API plugin",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsup --format esm --dts",
+    "dev": "tsup --format esm --dts --watch",
+    "test": "jest",
+    "lint": "eslint --fix  --cache ."
+  },
+  "dependencies": {
+    "@elizaos/core": "workspace:*",
+    "axios": "1.7.8"
+  },
+  "devDependencies": {
+    "@types/jest": "29.5.14",
+    "@types/node": "20.17.9",
+    "@typescript-eslint/eslint-plugin": "8.16.0",
+    "@typescript-eslint/parser": "8.16.0",
+    "jest": "29.7.0",
+    "ts-jest": "29.2.5",
+    "typescript": "5.6.3"
+  }
+}

package/src/client.ts

@@ -0,0 +1,38 @@
+import axios, { AxiosInstance } from "axios";
+import { WhatsAppConfig, WhatsAppMessage } from "./types";
+
+export class WhatsAppClient {
+    private client: AxiosInstance;
+    private config: WhatsAppConfig;
+
+    constructor(config: WhatsAppConfig) {
+        this.config = config;
+        this.client = axios.create({
+            baseURL: "https://graph.facebook.com/v17.0",
+            headers: {
+                Authorization: `Bearer ${config.accessToken}`,
+                "Content-Type": "application/json",
+            },
+        });
+    }
+
+    async sendMessage(message: WhatsAppMessage): Promise<any> {
+        const endpoint = `/${this.config.phoneNumberId}/messages`;
+
+        const payload = {
+            messaging_product: "whatsapp",
+            recipient_type: "individual",
+            to: message.to,
+            type: message.type,
+            ...(message.type === "text"
+                ? { text: { body: message.content } }
+                : { template: message.content }),
+        };
+
+        return this.client.post(endpoint, payload);
+    }
+
+    async verifyWebhook(token: string): Promise<boolean> {
+        return token === this.config.webhookVerifyToken;
+    }
+}

package/src/handlers/index.ts

@@ -0,0 +1,2 @@
+export * from "./message.handler";
+export * from "./webhook.handler";

package/src/handlers/message.handler.ts

@@ -0,0 +1,20 @@
+import { WhatsAppClient } from "../client";
+import { WhatsAppMessage } from "../types";
+
+export class MessageHandler {
+    constructor(private client: WhatsAppClient) {}
+
+    async send(message: WhatsAppMessage): Promise<any> {
+        try {
+            const response = await this.client.sendMessage(message);
+            return response.data;
+        } catch (error: unknown) {
+            if (error instanceof Error) {
+                throw new Error(
+                    `Failed to send WhatsApp message: ${error.message}`
+                );
+            }
+            throw new Error('Failed to send WhatsApp message');
+        }
+    }
+}

package/src/handlers/webhook.handler.ts

@@ -0,0 +1,45 @@
+import { WhatsAppClient } from "../client";
+import { WhatsAppWebhookEvent } from "../types";
+
+export class WebhookHandler {
+    constructor(private client: WhatsAppClient) {}
+
+    async handle(event: WhatsAppWebhookEvent): Promise<void> {
+        try {
+            // Process messages
+            if (event.entry?.[0]?.changes?.[0]?.value?.messages) {
+                const messages = event.entry[0].changes[0].value.messages;
+                for (const message of messages) {
+                    await this.handleMessage(message);
+                }
+            }
+
+            // Process status updates
+            if (event.entry?.[0]?.changes?.[0]?.value?.statuses) {
+                const statuses = event.entry[0].changes[0].value.statuses;
+                for (const status of statuses) {
+                    await this.handleStatus(status);
+                }
+            }
+        } catch (error: unknown) {
+            if (error instanceof Error) {
+                throw new Error(
+                    `Failed to send WhatsApp message: ${error.message}`
+                );
+            }
+            throw new Error("Failed to send WhatsApp message");
+        }
+    }
+
+    private async handleMessage(message: any): Promise<void> {
+        // Implement message handling logic
+        // This could emit events or trigger callbacks based on your framework's needs
+        console.log("Received message:", message);
+    }
+
+    private async handleStatus(status: any): Promise<void> {
+        // Implement status update handling logic
+        // This could emit events or trigger callbacks based on your framework's needs
+        console.log("Received status update:", status);
+    }
+}

package/src/index.ts

@@ -0,0 +1,36 @@
+import { Plugin } from "@elizaos/core";
+import { WhatsAppClient } from "./client";
+import { WhatsAppConfig, WhatsAppMessage, WhatsAppWebhookEvent } from "./types";
+import { MessageHandler, WebhookHandler } from "./handlers";
+
+export class WhatsAppPlugin implements Plugin {
+    private client: WhatsAppClient;
+    private messageHandler: MessageHandler;
+    private webhookHandler: WebhookHandler;
+
+    name: string;
+    description: string;
+
+    constructor(private config: WhatsAppConfig) {
+        this.name = "WhatsApp Cloud API Plugin";
+        this.description =
+            "A plugin for integrating WhatsApp Cloud API with your application.";
+        this.client = new WhatsAppClient(config);
+        this.messageHandler = new MessageHandler(this.client);
+        this.webhookHandler = new WebhookHandler(this.client);
+    }
+
+    async sendMessage(message: WhatsAppMessage): Promise<any> {
+        return this.messageHandler.send(message);
+    }
+
+    async handleWebhook(event: WhatsAppWebhookEvent): Promise<void> {
+        return this.webhookHandler.handle(event);
+    }
+
+    async verifyWebhook(token: string): Promise<boolean> {
+        return this.client.verifyWebhook(token);
+    }
+}
+
+export * from "./types";

package/src/types.ts

@@ -0,0 +1,58 @@
+export interface WhatsAppConfig {
+    accessToken: string;
+    phoneNumberId: string;
+    webhookVerifyToken?: string;
+    businessAccountId?: string;
+}
+
+export interface WhatsAppMessage {
+    type: "text" | "template";
+    to: string;
+    content: string | WhatsAppTemplate;
+}
+
+export interface WhatsAppTemplate {
+    name: string;
+    language: {
+        code: string;
+    };
+    components?: Array<{
+        type: string;
+        parameters: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }>;
+}
+
+export interface WhatsAppWebhookEvent {
+    object: string;
+    entry: Array<{
+        id: string;
+        changes: Array<{
+            value: {
+                messaging_product: string;
+                metadata: {
+                    display_phone_number: string;
+                    phone_number_id: string;
+                };
+                statuses?: Array<{
+                    id: string;
+                    status: string;
+                    timestamp: string;
+                    recipient_id: string;
+                }>;
+                messages?: Array<{
+                    from: string;
+                    id: string;
+                    timestamp: string;
+                    text?: {
+                        body: string;
+                    };
+                    type: string;
+                }>;
+            };
+            field: string;
+        }>;
+    }>;
+}

package/src/utils/index.ts

@@ -0,0 +1 @@
+export * from "./validators";

package/src/utils/validators.ts

@@ -0,0 +1,44 @@
+import { WhatsAppMessage, WhatsAppTemplate, WhatsAppConfig } from "../types";
+
+export function validateConfig(config: WhatsAppConfig): void {
+    if (!config.accessToken) {
+        throw new Error("WhatsApp access token is required");
+    }
+    if (!config.phoneNumberId) {
+        throw new Error("WhatsApp phone number ID is required");
+    }
+}
+
+export function validateMessage(message: WhatsAppMessage): void {
+    if (!message.to) {
+        throw new Error("Recipient phone number is required");
+    }
+
+    if (!message.type) {
+        throw new Error("Message type is required");
+    }
+
+    if (!message.content) {
+        throw new Error("Message content is required");
+    }
+
+    if (message.type === "template") {
+        validateTemplate(message.content as WhatsAppTemplate);
+    }
+}
+
+export function validateTemplate(template: WhatsAppTemplate): void {
+    if (!template.name) {
+        throw new Error("Template name is required");
+    }
+
+    if (!template.language || !template.language.code) {
+        throw new Error("Template language code is required");
+    }
+}
+
+export function validatePhoneNumber(phoneNumber: string): boolean {
+    // Basic phone number validation - can be enhanced based on requirements
+    const phoneRegex = /^\d{1,15}$/;
+    return phoneRegex.test(phoneNumber);
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+    "extends": "../core/tsconfig.json",
+    "compilerOptions": {
+        "outDir": "./dist",
+        "rootDir": "src",
+        "baseUrl": ".",
+        "types": [
+            "node",
+            "jest"
+        ]
+    },
+    "include": [
+        "src/**/*.ts"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist",
+        "**/*.test.ts"
+    ]
+}

package/tsup.config.ts

@@ -0,0 +1,19 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+    entry: ["src/index.ts"],
+    outDir: "dist",
+    sourcemap: true,
+    clean: true,
+    format: ["esm"], // Ensure you're targeting CommonJS
+    external: [
+        "dotenv", // Externalize dotenv to prevent bundling
+        "fs", // Externalize fs to use Node.js built-in module
+        "path", // Externalize other built-ins if necessary
+        "@reflink/reflink",
+        "@node-llama-cpp",
+        "https",
+        "http",
+        "agentkeepalive",
+    ],
+});