@elizaos/plugin-whatsapp 2.0.0-alpha.4 → 2.0.0-alpha.537

package/dist/src/types.d.ts

@@ -0,0 +1,396 @@
+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 NormalizedMessage {
+	id: string;
+	from: string;
+	timestamp: number;
+	type: "text" | "image" | "audio" | "video" | "document";
+	content: string;
+	chatId?: string;
+	senderId?: string;
+	replyToId?: 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,5 @@
+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,CAC9B,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/C,SAAS,GAAG,UAAU,CAsBxB"}

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

@@ -0,0 +1,3 @@
+export * from "./config-detector";
+export * from "./validators";
+//# 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,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}

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

@@ -0,0 +1,14 @@
+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,11 +1,11 @@
 {
   "name": "@elizaos/plugin-whatsapp",
-  "description": "WhatsApp Cloud API plugin for ElizaOS",
-  "version": "2.0.0-alpha.4",
+  "description": "WhatsApp plugin for ElizaOS (Cloud API + Baileys QR auth)",
+  "version": "2.0.0-alpha.537",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "types": "dist/src/index.d.ts",
   "packageType": "plugin",
   "platform": "node",
   "license": "MIT",
@@ -22,7 +22,7 @@
     "./package.json": "./package.json",
     ".": {
       "import": {
-        "types": "./dist/index.d.ts",
+        "types": "./dist/src/index.d.ts",
         "default": "./dist/index.js"
       }
     }
@@ -33,29 +33,99 @@
     "package.json"
   ],
   "dependencies": {
-    "axios": "1.7.8"
+    "@hapi/boom": "^10.0.1",
+    "@whiskeysockets/baileys": "^7.0.0-rc.9",
+    "axios": "^1.16.0",
+    "pino": "^10.3.1",
+    "qrcode": "^1.5.4",
+    "qrcode-terminal": "^0.12.0"
   },
   "peerDependencies": {
-    "@elizaos/core": "2.0.0-alpha.3"
+    "@elizaos/core": "^2.0.0-alpha.537"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.11",
+    "@biomejs/biome": "^2.4.14",
     "@types/node": "^25.0.3",
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.0",
+    "vitest": "^4.0.0"
   },
   "scripts": {
     "dev": "bun --hot build.ts",
-    "test": "vitest run || echo 'TypeScript tests skipped - no tests found'",
-    "lint": "bunx @biomejs/biome check --write --unsafe .",
-    "typecheck": "tsc --noEmit",
+    "test": "vitest run --config ./vitest.config.ts",
+    "lint": "bunx @biomejs/biome check --write --config-path ./biome.json .",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
     "clean": "rm -rf dist .turbo",
-    "lint:check": "bunx @biomejs/biome check .",
+    "lint:check": "bunx @biomejs/biome check --config-path ./biome.json .",
     "build": "bun run build.ts",
     "build:ts": "bun run build.ts",
-    "format": "bunx @biomejs/biome format --write .",
-    "format:check": "bunx @biomejs/biome format ."
+    "format": "bunx @biomejs/biome format --write --config-path ./biome.json .",
+    "format:check": "bunx @biomejs/biome format --config-path ./biome.json ."
   },
   "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/dist/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./index";
-export { default } from "./index";