npm - @elizaos/plugin-whatsapp - Versions diffs - 0.1.7-alpha.2 → 0.1.8 - Mend

@elizaos/plugin-whatsapp 0.1.7-alpha.2 → 0.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

package/README.md +226 -0
package/dist/{index.mjs → index.js} +1 -1
package/dist/index.js.map +1 -0
package/package.json +40 -25
package/.turbo/turbo-build.log +0 -17
package/Readme.md +0 -154
package/dist/index.mjs.map +0 -1
package/eslint.config.mjs +0 -9
package/src/client.ts +0 -38
package/src/handlers/index.ts +0 -2
package/src/handlers/message.handler.ts +0 -20
package/src/handlers/webhook.handler.ts +0 -45
package/src/index.ts +0 -36
package/src/types.ts +0 -58
package/src/utils/index.ts +0 -1
package/src/utils/validators.ts +0 -44
package/tsconfig.json +0 -20
package/tsup.config.ts +0 -19
/package/dist/{index.d.mts → index.d.ts} +0 -0

package/README.md ADDED Viewed

@@ -0,0 +1,226 @@
+# @elizaos/plugin-whatsapp
+A plugin for integrating WhatsApp Cloud API with your application, providing comprehensive messaging capabilities and webhook handling.
+## Overview
+This plugin provides functionality to:
+- Send text and template messages via WhatsApp
+- Handle incoming webhook events
+- Manage message status updates
+- Process message delivery notifications
+- Handle authentication and session management
+## Installation
+```bash
+npm install @elizaos/plugin-whatsapp
+```
+## Configuration
+The plugin requires the following environment variables:
+```env
+WHATSAPP_ACCESS_TOKEN=your_access_token       # Required: WhatsApp Cloud API access token
+WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id # Required: WhatsApp business phone number ID
+WHATSAPP_WEBHOOK_TOKEN=your_webhook_token     # Optional: Webhook verification token
+WHATSAPP_BUSINESS_ID=your_business_id        # Optional: Business account ID
+```
+## Usage
+### Basic Setup
+```typescript
+import { WhatsAppPlugin } from "@elizaos/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",
+});
+```
+### 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
+## Error Handling
+The plugin throws errors in the following cases:
+```typescript
+try {
+    await whatsappPlugin.sendMessage({
+        type: "text",
+        to: "1234567890",
+        content: "Hello!",
+    });
+} catch (error) {
+    console.error("Failed to send message:", error.message);
+}
+```
+Common error cases:
+- Invalid configuration
+- Failed message sending
+- Webhook verification failure
+- Invalid webhook payload
+## 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
+## API Reference
+### Core Interfaces
+```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;
+        }>;
+    }>;
+}
+```
+### Plugin Methods
+- `sendMessage`: Send WhatsApp messages
+- `handleWebhook`: Process incoming webhook events
+- `verifyWebhook`: Verify webhook authenticity
+- Message and status handlers
+## Development
+### Building
+```bash
+npm run build
+```
+### Testing
+```bash
+npm run test
+```
+### Linting
+```bash
+npm run lint
+```
+## Security Best Practices
+- Store credentials securely using environment variables
+- Validate all phone numbers before sending messages
+- Use template messages for first-time contacts
+- Implement proper error handling
+- Keep dependencies updated
+- Monitor API usage and rate limits
+- Use HTTPS for all API communication
+## Contributing
+Contributions are welcome! Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file for more information.
+## Credits
+This plugin integrates with and builds upon several key technologies:
+- [WhatsApp Cloud API](https://developers.facebook.com/docs/whatsapp/cloud-api): Meta's official WhatsApp Business Platform
+- [Axios](https://axios-http.com/): Promise-based HTTP client for API requests
+- [Meta for Developers](https://developers.facebook.com/): Meta's developer platform and tools
+Special thanks to:
+- The Eliza community for their contributions and feedback
+For more information about WhatsApp Cloud API and its capabilities, visit:
+- [WhatsApp Business Platform Documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/overview)
+- [Meta for Developers Blog](https://developers.facebook.com/blog/)
+- [WhatsApp Business API GitHub](https://github.com/WhatsApp/WhatsApp-Business-API-Setup-Scripts)
+## License
+This plugin is part of the Eliza project. See the main project repository for license information.

package/dist/{index.mjs → index.js} RENAMED Viewed

@@ -113,4 +113,4 @@ var WhatsAppPlugin = class {
 export {
   WhatsAppPlugin
 };
-//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -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/package.json CHANGED Viewed

@@ -1,27 +1,42 @@
 {
-  "name": "@elizaos/plugin-whatsapp",
-  "version": "0.1.7-alpha.2",
-  "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": "0.1.7-alpha.2",
-    "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"
-  },
-  "gitHead": "256e6634696074cdb38f3f79bc383fed04376688"
+    "name": "@elizaos/plugin-whatsapp",
+    "version": "0.1.8+build.1",
+    "description": "WhatsApp Cloud API plugin",
+    "type": "module",
+    "main": "dist/index.js",
+    "module": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        "./package.json": "./package.json",
+        ".": {
+            "import": {
+                "@elizaos/source": "./src/index.ts",
+                "types": "./dist/index.d.ts",
+                "default": "./dist/index.js"
+            }
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsup --format esm --dts",
+        "dev": "tsup --format esm --dts --watch",
+        "test": "jest",
+        "lint": "eslint --fix  --cache ."
+    },
+    "dependencies": {
+        "@elizaos/core": "0.1.8+build.1",
+        "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"
+    },
+    "gitHead": "d55c86c961960b4b34528c358eb34b2ff4b34d87"
 }

package/.turbo/turbo-build.log DELETED Viewed

@@ -1,17 +0,0 @@
-> @elizaos/plugin-whatsapp@0.1.7-alpha.2 build /home/runner/work/eliza/eliza/packages/plugin-whatsapp
-> tsup --format esm --dts
-[34mCLI[39m Building entry: src/index.ts
-[34mCLI[39m Using tsconfig: tsconfig.json
-[34mCLI[39m tsup v8.3.5
-[34mCLI[39m Using tsup config: /home/runner/work/eliza/eliza/packages/plugin-whatsapp/tsup.config.ts
-[34mCLI[39m Target: esnext
-[34mCLI[39m Cleaning output folder
-[34mESM[39m Build start
-[32mESM[39m [1mdist/index.mjs     [22m[32m3.06 KB[39m
-[32mESM[39m [1mdist/index.mjs.map [22m[32m7.09 KB[39m
-[32mESM[39m ⚡️ Build success in 31ms
-[34mDTS[39m Build start
-[32mDTS[39m ⚡️ Build success in 6502ms
-[32mDTS[39m [1mdist/index.d.mts [22m[32m1.90 KB[39m

package/Readme.md DELETED Viewed

@@ -1,154 +0,0 @@
-# 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.mjs.map DELETED Viewed

@@ -1 +0,0 @@

- {"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 DELETED Viewed

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

package/src/client.ts DELETED Viewed

@@ -1,38 +0,0 @@
-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 DELETED Viewed

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

package/src/handlers/message.handler.ts DELETED Viewed

@@ -1,20 +0,0 @@
-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 DELETED Viewed

@@ -1,45 +0,0 @@
-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 DELETED Viewed

@@ -1,36 +0,0 @@
-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 DELETED Viewed

@@ -1,58 +0,0 @@
-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 DELETED Viewed

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

package/src/utils/validators.ts DELETED Viewed

@@ -1,44 +0,0 @@
-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 DELETED Viewed

@@ -1,20 +0,0 @@
-{
-    "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 DELETED Viewed

@@ -1,19 +0,0 @@
-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",
-    ],
-});

/package/dist/{index.d.mts → index.d.ts} RENAMED Viewed

File without changes