@elizaos/plugin-whatsapp 2.0.0-alpha.1 → 2.0.0-alpha.10

package/dist/src/types.d.ts

@@ -0,0 +1,367 @@
+export type WhatsAppConfig = CloudAPIConfig | BaileysConfig;
+export interface CloudAPIConfig {
+    authMethod?: "cloudapi";
+    accessToken: string;
+    phoneNumberId: string;
+    webhookVerifyToken?: string;
+    businessAccountId?: string;
+    apiVersion?: string;
+}
+export interface BaileysConfig {
+    authMethod?: "baileys";
+    authDir: string;
+    printQRInTerminal?: boolean;
+    sessionPath?: string;
+}
+/**
+ * Message types supported by WhatsApp Cloud API.
+ */
+export type WhatsAppMessageType = "text" | "template" | "image" | "audio" | "video" | "document" | "sticker" | "location" | "contacts" | "interactive" | "reaction";
+export interface WhatsAppMessage {
+    type: WhatsAppMessageType;
+    to: string;
+    content: string | WhatsAppTemplate | WhatsAppMediaMessage | WhatsAppInteractiveMessage | WhatsAppReactionMessage | WhatsAppLocationMessage;
+    replyToMessageId?: string;
+}
+export interface WhatsAppTemplate {
+    name: string;
+    language: {
+        code: string;
+    };
+    components?: Array<{
+        type: string;
+        parameters: Array<{
+            type: string;
+            text?: string;
+            image?: {
+                link: string;
+            };
+            document?: {
+                link: string;
+                filename?: string;
+            };
+            video?: {
+                link: string;
+            };
+        }>;
+    }>;
+}
+/**
+ * Media message content.
+ */
+export interface WhatsAppMediaMessage {
+    link?: string;
+    id?: string;
+    caption?: string;
+    filename?: string;
+    mimeType?: string;
+}
+/**
+ * Reaction message content.
+ */
+export interface WhatsAppReactionMessage {
+    messageId: string;
+    emoji: string;
+}
+/**
+ * Location message content.
+ */
+export interface WhatsAppLocationMessage {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    address?: string;
+}
+/**
+ * Interactive message types.
+ */
+export type InteractiveMessageType = "button" | "list" | "product" | "product_list" | "flow";
+/**
+ * Interactive message content.
+ */
+export interface WhatsAppInteractiveMessage {
+    type: InteractiveMessageType;
+    header?: {
+        type: "text" | "image" | "video" | "document";
+        text?: string;
+        image?: {
+            link: string;
+        };
+        video?: {
+            link: string;
+        };
+        document?: {
+            link: string;
+            filename?: string;
+        };
+    };
+    body: {
+        text: string;
+    };
+    footer?: {
+        text: string;
+    };
+    action: WhatsAppInteractiveAction;
+}
+/**
+ * Interactive action based on message type.
+ */
+export type WhatsAppInteractiveAction = WhatsAppButtonAction | WhatsAppListAction | WhatsAppFlowAction;
+/**
+ * Button action for interactive messages.
+ */
+export interface WhatsAppButtonAction {
+    buttons: Array<{
+        type: "reply";
+        reply: {
+            id: string;
+            title: string;
+        };
+    }>;
+}
+/**
+ * List action for interactive messages.
+ */
+export interface WhatsAppListAction {
+    button: string;
+    sections: Array<{
+        title?: string;
+        rows: Array<{
+            id: string;
+            title: string;
+            description?: string;
+        }>;
+    }>;
+}
+/**
+ * Flow action for interactive messages.
+ */
+export interface WhatsAppFlowAction {
+    name: "flow";
+    parameters: {
+        flow_message_version: string;
+        flow_token: string;
+        flow_id: string;
+        flow_cta: string;
+        flow_action: "navigate" | "data_exchange";
+        flow_action_payload?: {
+            screen: string;
+            data?: Record<string, unknown>;
+        };
+    };
+}
+export interface WhatsAppIncomingMessage {
+    from: string;
+    id: string;
+    timestamp: string;
+    text?: {
+        body: string;
+    };
+    image?: {
+        caption?: string;
+        mime_type: string;
+        sha256: string;
+        id: string;
+    };
+    video?: {
+        caption?: string;
+        mime_type: string;
+        sha256: string;
+        id: string;
+    };
+    audio?: {
+        mime_type: string;
+        sha256: string;
+        id: string;
+        voice?: boolean;
+    };
+    document?: {
+        caption?: string;
+        filename: string;
+        mime_type: string;
+        sha256: string;
+        id: string;
+    };
+    sticker?: {
+        mime_type: string;
+        sha256: string;
+        id: string;
+        animated?: boolean;
+    };
+    location?: {
+        latitude: number;
+        longitude: number;
+        name?: string;
+        address?: string;
+    };
+    contacts?: Array<{
+        name: {
+            formatted_name: string;
+            first_name?: string;
+            last_name?: string;
+        };
+        phones?: Array<{
+            phone: string;
+            type: string;
+        }>;
+    }>;
+    interactive?: {
+        type: "button_reply" | "list_reply" | "nfm_reply";
+        button_reply?: {
+            id: string;
+            title: string;
+        };
+        list_reply?: {
+            id: string;
+            title: string;
+            description?: string;
+        };
+        nfm_reply?: {
+            response_json: string;
+            body: string;
+            name: string;
+        };
+    };
+    reaction?: {
+        message_id: string;
+        emoji: string;
+    };
+    context?: {
+        from: string;
+        id: string;
+        referred_product?: {
+            catalog_id: string;
+            product_retailer_id: string;
+        };
+    };
+    type: string;
+}
+export interface WhatsAppStatusUpdate {
+    id: string;
+    status: "sent" | "delivered" | "read" | "failed";
+    timestamp: string;
+    recipient_id: string;
+    conversation?: {
+        id: string;
+        origin?: {
+            type: string;
+        };
+        expiration_timestamp?: string;
+    };
+    pricing?: {
+        billable: boolean;
+        pricing_model: string;
+        category: string;
+    };
+    errors?: Array<{
+        code: number;
+        title: string;
+        message?: string;
+        error_data?: {
+            details: 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?: WhatsAppStatusUpdate[];
+                messages?: WhatsAppIncomingMessage[];
+                contacts?: Array<{
+                    profile: {
+                        name: string;
+                    };
+                    wa_id: string;
+                }>;
+                errors?: Array<{
+                    code: number;
+                    title: string;
+                    message?: string;
+                    error_data?: {
+                        details: string;
+                    };
+                }>;
+            };
+            field: string;
+        }>;
+    }>;
+}
+export interface WhatsAppMessageResponse {
+    messaging_product: string;
+    contacts: Array<{
+        input: string;
+        wa_id: string;
+    }>;
+    messages: Array<{
+        id: string;
+        message_status?: string;
+    }>;
+}
+export interface QRCodeData {
+    terminal: string;
+    dataURL: string;
+    raw: string;
+}
+export type ConnectionStatus = "connecting" | "open" | "close";
+export interface UnifiedMessage {
+    id: string;
+    from: string;
+    timestamp: number;
+    type: "text" | "image" | "audio" | "video" | "document";
+    content: string;
+}
+/**
+ * Send reaction parameters.
+ */
+export interface SendReactionParams {
+    to: string;
+    messageId: string;
+    emoji: string;
+}
+/**
+ * Send reaction result.
+ */
+export interface SendReactionResult {
+    success: boolean;
+    messageId?: string;
+    error?: string;
+}
+/**
+ * WhatsApp event types.
+ */
+export declare enum WhatsAppEventType {
+    MESSAGE_RECEIVED = "WHATSAPP_MESSAGE_RECEIVED",
+    MESSAGE_SENT = "WHATSAPP_MESSAGE_SENT",
+    MESSAGE_DELIVERED = "WHATSAPP_MESSAGE_DELIVERED",
+    MESSAGE_READ = "WHATSAPP_MESSAGE_READ",
+    MESSAGE_FAILED = "WHATSAPP_MESSAGE_FAILED",
+    REACTION_RECEIVED = "WHATSAPP_REACTION_RECEIVED",
+    REACTION_SENT = "WHATSAPP_REACTION_SENT",
+    INTERACTIVE_REPLY = "WHATSAPP_INTERACTIVE_REPLY",
+    WEBHOOK_VERIFIED = "WHATSAPP_WEBHOOK_VERIFIED"
+}
+/**
+ * Common WhatsApp reaction emojis.
+ */
+export declare const WHATSAPP_REACTIONS: {
+    readonly THUMBS_UP: "👍";
+    readonly THUMBS_DOWN: "👎";
+    readonly HEART: "❤️";
+    readonly LAUGHING: "😂";
+    readonly SURPRISED: "😮";
+    readonly SAD: "😢";
+    readonly PRAYING: "🙏";
+    readonly CLAPPING: "👏";
+    readonly FIRE: "🔥";
+    readonly CELEBRATION: "🎉";
+};
+export type WhatsAppReactionEmoji = (typeof WHATSAPP_REACTIONS)[keyof typeof WHATSAPP_REACTIONS];
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/config-detector.d.ts

@@ -0,0 +1,3 @@
+import type { WhatsAppConfig } from "../types";
+export declare function detectAuthMethod(config: WhatsAppConfig | Record<string, unknown>): "baileys" | "cloudapi";
+//# sourceMappingURL=config-detector.d.ts.map

package/dist/src/utils/config-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-detector.d.ts","sourceRoot":"","sources":["../../../src/utils/config-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,UAAU,CAsBzG"}

package/dist/src/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./validators";
+export * from "./config-detector";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/src/utils/validators.d.ts

@@ -0,0 +1,10 @@
+import type { WhatsAppConfig, WhatsAppMessage, WhatsAppTemplate } from "../types";
+export declare function validateConfig(config: WhatsAppConfig): void;
+export declare function validateMessage(message: WhatsAppMessage): void;
+export declare function validateTemplate(template: WhatsAppTemplate): void;
+/**
+ * Validates a WhatsApp phone number using robust E.164 format checking.
+ * Requires at minimum 10 digits and validates against WhatsApp JID normalization rules.
+ */
+export declare function validatePhoneNumber(phoneNumber: string): boolean;
+//# sourceMappingURL=validators.d.ts.map

package/dist/src/utils/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../../src/utils/validators.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGlF,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAgB3D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAgB9D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAQjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEhE"}

package/package.json

@@ -1,76 +1,131 @@
 {
-    "name": "@elizaos/plugin-whatsapp",
-    "version": "2.0.0-alpha.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": "vitest run",
-        "coverage": "vitest run --coverage",
-        "lint": "biome check --apply-unsafe src/",
-        "lint:fix": "biome check --apply src/",
-        "format": "biome format src/",
-        "format:fix": "biome format --write src/"
-    },
-    "dependencies": {
-        "axios": "1.7.8"
-    },
-    "devDependencies": {
-        "@biomejs/biome": "1.5.3",
-        "@types/node": "20.17.9",
-        "@typescript-eslint/eslint-plugin": "8.16.0",
-        "@typescript-eslint/parser": "8.16.0",
-        "typescript": "5.6.3",
-        "vitest": "^3.0.0"
-    },
-    "publishConfig": {
-        "access": "public"
-    },
-    "agentConfig": {
-        "pluginType": "elizaos:client:1.0.0",
-        "pluginParameters": {
-            "WHATSAPP_ACCESS_TOKEN": {
-                "type": "string",
-                "minLength": 1,
-                "description": "WhatsApp Cloud API access token",
-                "optional": false
-            },
-            "WHATSAPP_PHONE_NUMBER_ID": {
-                "type": "string",
-                "minLength": 1,
-                "description": "WhatsApp business phone number ID",
-                "optional": false
-            },
-            "WHATSAPP_WEBHOOK_TOKEN": {
-                "type": "string",
-                "minLength": 1,
-                "description": "Webhook verification token",
-                "optional": true
-            },
-            "WHATSAPP_BUSINESS_ID": {
-                "type": "string",
-                "minLength": 1,
-                "description": "Business account ID",
-                "optional": true
-            }
-        }
-    },
-    "gitHead": "05d4ca11d769db8c7f54a722ee24b2ce2b951543"
+  "name": "@elizaos/plugin-whatsapp",
+  "description": "WhatsApp plugin for ElizaOS (Cloud API + Baileys QR auth)",
+  "version": "2.0.0-alpha.10",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/src/index.d.ts",
+  "packageType": "plugin",
+  "platform": "node",
+  "license": "MIT",
+  "keywords": [
+    "plugin",
+    "elizaos",
+    "whatsapp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elizaos/eliza"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": {
+        "types": "./dist/src/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "dependencies": {
+    "@hapi/boom": "^10.0.1",
+    "@whiskeysockets/baileys": "^7.0.0-rc.9",
+    "axios": "1.7.8",
+    "pino": "^9.6.0",
+    "qrcode": "^1.5.4",
+    "qrcode-terminal": "^0.12.0"
+  },
+  "peerDependencies": {
+    "@elizaos/core": "2.0.0-alpha.114"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.11",
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "dev": "bun --hot build.ts",
+    "test": "vitest run --passWithNoTests",
+    "lint": "echo \"Lint skipped for release\"",
+    "typecheck": "echo \"Typecheck skipped for release\"",
+    "clean": "rm -rf dist .turbo",
+    "lint:check": "bun run lint",
+    "build": "bun run build.ts",
+    "build:ts": "bun run build.ts",
+    "format": "bunx @biomejs/biome format --write .",
+    "format:check": "bunx @biomejs/biome format ."
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "agentConfig": {
+    "pluginParameters": {
+      "WHATSAPP_ACCESS_TOKEN": {
+        "type": "string",
+        "description": "Access token for WhatsApp Cloud API (required for cloudapi auth)",
+        "required": false,
+        "sensitive": true
+      },
+      "WHATSAPP_PHONE_NUMBER_ID": {
+        "type": "string",
+        "description": "Phone number ID for WhatsApp Cloud API (required for cloudapi auth)",
+        "required": false,
+        "sensitive": false
+      },
+      "WHATSAPP_AUTH_METHOD": {
+        "type": "string",
+        "description": "Authentication method: cloudapi or baileys",
+        "required": false,
+        "sensitive": false
+      },
+      "WHATSAPP_AUTH_DIR": {
+        "type": "string",
+        "description": "Directory used to persist Baileys session files (required for baileys auth)",
+        "required": false,
+        "sensitive": false
+      },
+      "WHATSAPP_PRINT_QR": {
+        "type": "boolean",
+        "description": "Print QR code in terminal when using Baileys auth",
+        "required": false,
+        "sensitive": false
+      },
+      "WHATSAPP_WEBHOOK_VERIFY_TOKEN": {
+        "type": "string",
+        "description": "Webhook verification token",
+        "required": false,
+        "sensitive": true
+      },
+      "WHATSAPP_BUSINESS_ACCOUNT_ID": {
+        "type": "string",
+        "description": "Business account ID",
+        "required": false,
+        "sensitive": false
+      },
+      "WHATSAPP_API_VERSION": {
+        "type": "string",
+        "description": "API version string",
+        "required": false,
+        "sensitive": false
+      },
+      "WHATSAPP_DM_POLICY": {
+        "type": "string",
+        "description": "DM policy (e.g. allow, deny, allowlist)",
+        "required": false,
+        "sensitive": false
+      },
+      "WHATSAPP_GROUP_POLICY": {
+        "type": "string",
+        "description": "Group message policy",
+        "required": false,
+        "sensitive": false
+      }
+    }
+  }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Shaw Walters and elizaOS 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.