@hazeljs/messaging 0.2.0-alpha.1

package/dist/adapters/telegram.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/telegram.adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4DAA4D;AAC5D,qBAAa,eAAgB,YAAW,eAAe;IACrD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAc;IAChD,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,EAAE,qBAAqB;IAKzC,mDAAmD;IACnD,MAAM,IAAI,QAAQ;IAIlB,gEAAgE;IAChE,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,eAAe,EAAE,GAAG,IAAI;IA4C3E,yCAAyC;IACnC,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IASnD,yFAAyF;IACzF,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI;CAc7E"}

package/dist/adapters/telegram.adapter.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramAdapter = void 0;
+/**
+ * Telegram channel adapter using Telegraf
+ */
+const telegraf_1 = require("telegraf");
+/** Telegram adapter - uses Telegraf for webhook handling */
+class TelegramAdapter {
+    constructor(config) {
+        this.channel = 'telegram';
+        this.config = config;
+        this.bot = new telegraf_1.Telegraf(config.botToken);
+    }
+    /** Get Telegraf instance for webhook middleware */
+    getBot() {
+        return this.bot;
+    }
+    /** Parse Telegram update (from webhook) into IncomingMessage */
+    parseIncoming(payload) {
+        const update = payload;
+        const msg = update.message ?? update.edited_message;
+        if (!msg?.text)
+            return null;
+        const from = msg.from;
+        const chat = msg.chat;
+        const fromAny = from;
+        const name = [fromAny?.first_name, fromAny?.last_name].filter(Boolean).join(' ') || fromAny?.username;
+        const chatAny = chat;
+        return {
+            id: String(msg.message_id),
+            channel: 'telegram',
+            conversationId: String(chat.id),
+            userId: String(from?.id ?? ''),
+            userName: name || undefined,
+            text: msg.text,
+            rawPayload: payload,
+            timestamp: new Date((msg.date ?? 0) * 1000),
+            sessionId: `telegram:${chat.id}`,
+            metadata: { chatType: chatAny.type },
+        };
+    }
+    /** Send response via Telegram Bot API */
+    async send(message) {
+        const chatId = message.conversationId;
+        const opts = {};
+        if (message.replyToMessageId) {
+            opts.reply_to_message_id = parseInt(message.replyToMessageId, 10);
+        }
+        await this.bot.telegram.sendMessage(chatId, message.text, opts);
+    }
+    /** Register handler that receives IncomingMessage and sends response via this adapter */
+    onMessage(handler) {
+        this.bot.on('text', async (ctx) => {
+            const normalized = this.parseIncoming(ctx.update);
+            if (!normalized || Array.isArray(normalized))
+                return;
+            const response = await handler(normalized);
+            if (response) {
+                await this.send({
+                    conversationId: normalized.conversationId,
+                    text: response,
+                    replyToMessageId: normalized.id,
+                });
+            }
+        });
+    }
+}
+exports.TelegramAdapter = TelegramAdapter;
+//# sourceMappingURL=telegram.adapter.js.map

package/dist/adapters/telegram.adapter.js.map

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

package/dist/adapters/telegram.adapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=telegram.adapter.test.d.ts.map

package/dist/adapters/telegram.adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.adapter.test.d.ts","sourceRoot":"","sources":["../../src/adapters/telegram.adapter.test.ts"],"names":[],"mappings":""}

package/dist/adapters/telegram.adapter.test.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * TelegramAdapter tests
+ */
+const telegram_adapter_1 = require("./telegram.adapter");
+const telegraf_1 = require("telegraf");
+// Mock Telegraf to avoid actual Telegram API calls
+const mockSendMessage = jest.fn().mockResolvedValue(undefined);
+let capturedTextHandler = null;
+jest.mock('telegraf', () => ({
+    Telegraf: jest.fn().mockImplementation(() => ({
+        telegram: { sendMessage: mockSendMessage },
+        on: jest.fn((event, handler) => {
+            if (event === 'text')
+                capturedTextHandler = handler;
+        }),
+    })),
+}));
+describe('TelegramAdapter', () => {
+    let adapter;
+    beforeEach(() => {
+        capturedTextHandler = null;
+        mockSendMessage.mockClear();
+        adapter = new telegram_adapter_1.TelegramAdapter({ botToken: 'test-token' });
+    });
+    describe('channel', () => {
+        it('has channel telegram', () => {
+            expect(adapter.channel).toBe('telegram');
+        });
+    });
+    describe('getBot', () => {
+        it('returns Telegraf instance', () => {
+            const bot = adapter.getBot();
+            expect(bot).toBeDefined();
+            expect(bot.telegram).toBeDefined();
+        });
+    });
+    describe('parseIncoming', () => {
+        it('returns null when no text message', () => {
+            expect(adapter.parseIncoming({})).toBeNull();
+            expect(adapter.parseIncoming({ message: { chat: {}, from: {} } })).toBeNull();
+        });
+        it('parses message from update.message', () => {
+            const payload = {
+                message: {
+                    message_id: 42,
+                    chat: { id: -100123, type: 'group' },
+                    from: { id: 12345, username: 'johndoe', first_name: 'John', last_name: 'Doe' },
+                    text: 'Hello bot',
+                    date: 1609459200,
+                },
+            };
+            const result = adapter.parseIncoming(payload);
+            expect(result).not.toBeNull();
+            const msg = Array.isArray(result) ? result[0] : result;
+            expect(msg?.id).toBe('42');
+            expect(msg?.channel).toBe('telegram');
+            expect(msg?.conversationId).toBe('-100123');
+            expect(msg?.userId).toBe('12345');
+            expect(msg?.userName).toBe('John Doe');
+            expect(msg?.text).toBe('Hello bot');
+            expect(msg?.sessionId).toBe('telegram:-100123');
+            expect(msg?.metadata?.chatType).toBe('group');
+        });
+        it('parses edited_message', () => {
+            const payload = {
+                edited_message: {
+                    message_id: 43,
+                    chat: { id: 999 },
+                    from: { id: 1 },
+                    text: 'Edited text',
+                },
+            };
+            const result = adapter.parseIncoming(payload);
+            expect(result).not.toBeNull();
+            const msg = Array.isArray(result) ? result[0] : result;
+            expect(msg?.text).toBe('Edited text');
+            expect(msg?.id).toBe('43');
+        });
+        it('uses username when first/last name not available', () => {
+            const payload = {
+                message: {
+                    message_id: 1,
+                    chat: { id: 1 },
+                    from: { id: 1, username: 'bob' },
+                    text: 'Hi',
+                },
+            };
+            const result = adapter.parseIncoming(payload);
+            const msg = Array.isArray(result) ? result[0] : result;
+            expect(msg?.userName).toBe('bob');
+        });
+    });
+    describe('send', () => {
+        it('sends message via Telegraf', async () => {
+            const mockInstance = telegraf_1.Telegraf.mock.results[0]?.value;
+            await adapter.send({
+                conversationId: '123',
+                text: 'Hello user',
+                replyToMessageId: '42',
+            });
+            expect(mockInstance.telegram.sendMessage).toHaveBeenCalledWith('123', 'Hello user', expect.objectContaining({ reply_to_message_id: 42 }));
+        });
+        it('sends without reply when replyToMessageId not provided', async () => {
+            const mockInstance = telegraf_1.Telegraf.mock.results[0]?.value;
+            await adapter.send({
+                conversationId: '456',
+                text: 'Standalone',
+            });
+            expect(mockInstance.telegram.sendMessage).toHaveBeenCalledWith('456', 'Standalone', {});
+        });
+    });
+    describe('onMessage', () => {
+        it('invokes handler and sends reply when handler returns response', async () => {
+            const handler = jest.fn().mockResolvedValue('Echo: Hello');
+            adapter.onMessage(handler);
+            expect(capturedTextHandler).not.toBeNull();
+            await capturedTextHandler({
+                update: {
+                    message: {
+                        message_id: 1,
+                        chat: { id: 123 },
+                        from: { id: 1 },
+                        text: 'Hello',
+                    },
+                },
+            });
+            expect(handler).toHaveBeenCalledWith(expect.objectContaining({
+                id: '1',
+                conversationId: '123',
+                text: 'Hello',
+            }));
+            expect(mockSendMessage).toHaveBeenCalledWith('123', 'Echo: Hello', expect.any(Object));
+        });
+        it('does not send when handler returns empty string', async () => {
+            const handler = jest.fn().mockResolvedValue('');
+            adapter.onMessage(handler);
+            await capturedTextHandler({
+                update: {
+                    message: {
+                        message_id: 2,
+                        chat: { id: 456 },
+                        from: { id: 2 },
+                        text: 'Hi',
+                    },
+                },
+            });
+            expect(handler).toHaveBeenCalled();
+            expect(mockSendMessage).not.toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=telegram.adapter.test.js.map

package/dist/adapters/telegram.adapter.test.js.map

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

package/dist/adapters/viber.adapter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Viber channel adapter
+ * Uses viber-bot (optional dependency)
+ */
+import type { IChannelAdapter, IncomingMessage, OutgoingMessage, MessagingChannel } from '../types/message.types';
+export interface ViberAdapterConfig {
+    authToken: string;
+    /** Webhook path, e.g. /viber/webhook */
+    webhookPath?: string;
+}
+/** Viber adapter - requires viber-bot to be installed */
+export declare class ViberAdapter implements IChannelAdapter {
+    readonly channel: MessagingChannel;
+    private config;
+    private bot;
+    constructor(config: ViberAdapterConfig);
+    private initBot;
+    /** Get raw viber-bot instance for advanced use */
+    getBot(): unknown;
+    /** Parse Viber webhook payload into IncomingMessage */
+    parseIncoming(payload: unknown): IncomingMessage | IncomingMessage[] | null;
+    /** Send response via Viber API */
+    send(message: OutgoingMessage): Promise<void>;
+    /** Register message handler - use with viber-bot middleware */
+    onMessage(handler: (msg: IncomingMessage) => Promise<string> | string): void;
+    /** Express/Hazel middleware for Viber webhook */
+    webhookMiddleware(): (req: unknown, res: unknown, next?: () => void) => void;
+}
+//# sourceMappingURL=viber.adapter.d.ts.map

package/dist/adapters/viber.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viber.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/viber.adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yDAAyD;AACzD,qBAAa,YAAa,YAAW,eAAe;IAClD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAW;IAC7C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,GAAG,CAAiB;gBAEhB,MAAM,EAAE,kBAAkB;IAKtC,OAAO,CAAC,OAAO;IAcf,kDAAkD;IAClD,MAAM,IAAI,OAAO;IAIjB,uDAAuD;IACvD,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,eAAe,EAAE,GAAG,IAAI;IAyB3E,kCAAkC;IAC5B,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnD,+DAA+D;IAC/D,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI;IAkC5E,iDAAiD;IACjD,iBAAiB,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI;CAW7E"}

package/dist/adapters/viber.adapter.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViberAdapter = void 0;
+/** Viber adapter - requires viber-bot to be installed */
+class ViberAdapter {
+    constructor(config) {
+        this.channel = 'viber';
+        this.bot = null;
+        this.config = config;
+        this.initBot();
+    }
+    initBot() {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const ViberBot = require('viber-bot').default;
+            this.bot = new ViberBot({
+                authToken: this.config.authToken,
+                name: 'HazelJS Bot',
+                avatar: '',
+            });
+        }
+        catch {
+            this.bot = null;
+        }
+    }
+    /** Get raw viber-bot instance for advanced use */
+    getBot() {
+        return this.bot;
+    }
+    /** Parse Viber webhook payload into IncomingMessage */
+    parseIncoming(payload) {
+        const event = payload;
+        if (event.event !== 'message' || !event.message?.text)
+            return null;
+        const sender = event.sender;
+        return {
+            id: String(event.message_token ?? Date.now()),
+            channel: 'viber',
+            conversationId: sender?.id ?? '',
+            userId: sender?.id ?? '',
+            userName: sender?.name,
+            text: event.message.text,
+            rawPayload: payload,
+            timestamp: new Date(event.timestamp ?? Date.now()),
+            sessionId: sender?.id ? `viber:${sender.id}` : undefined,
+        };
+    }
+    /** Send response via Viber API */
+    async send(message) {
+        if (!this.bot) {
+            throw new Error('viber-bot is not installed. Run: npm install viber-bot');
+        }
+        const bot = this.bot;
+        await bot.sendMessage({ id: message.conversationId }, message.text);
+    }
+    /** Register message handler - use with viber-bot middleware */
+    onMessage(handler) {
+        if (!this.bot)
+            return;
+        // eslint-disable-next-line @typescript-eslint/no-require-imports -- viber-bot is optional peer dep
+        const Events = require('viber-bot').Events;
+        this.bot.on(Events.MESSAGE_RECEIVED, async (message) => {
+            const m = message;
+            if (!m.text)
+                return;
+            const normalized = {
+                id: String(m.messageToken ?? Date.now()),
+                channel: 'viber',
+                conversationId: m.sender.id,
+                userId: m.sender.id,
+                userName: m.sender.name,
+                text: m.text,
+                timestamp: new Date(),
+                sessionId: `viber:${m.sender.id}`,
+            };
+            const response = await handler(normalized);
+            if (response) {
+                await this.send({
+                    conversationId: normalized.conversationId,
+                    text: response,
+                });
+            }
+        });
+    }
+    /** Express/Hazel middleware for Viber webhook */
+    webhookMiddleware() {
+        if (!this.bot) {
+            return (_req, _res, next) => {
+                if (next)
+                    next();
+            };
+        }
+        const bot = this.bot;
+        return bot.middleware();
+    }
+}
+exports.ViberAdapter = ViberAdapter;
+//# sourceMappingURL=viber.adapter.js.map

package/dist/adapters/viber.adapter.js.map

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

package/dist/adapters/viber.adapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=viber.adapter.test.d.ts.map

package/dist/adapters/viber.adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viber.adapter.test.d.ts","sourceRoot":"","sources":["../../src/adapters/viber.adapter.test.ts"],"names":[],"mappings":""}

package/dist/adapters/viber.adapter.test.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * ViberAdapter tests - viber-bot is optional, so we test parseIncoming and send with mocks
+ */
+const viber_adapter_1 = require("./viber.adapter");
+describe('ViberAdapter', () => {
+    let adapter;
+    beforeEach(() => {
+        adapter = new viber_adapter_1.ViberAdapter({ authToken: 'test-auth' });
+    });
+    describe('channel', () => {
+        it('has channel viber', () => {
+            expect(adapter.channel).toBe('viber');
+        });
+    });
+    describe('parseIncoming', () => {
+        it('returns null when event is not message', () => {
+            expect(adapter.parseIncoming({ event: 'delivered' })).toBeNull();
+            expect(adapter.parseIncoming({ event: 'seen' })).toBeNull();
+        });
+        it('returns null when no message text', () => {
+            expect(adapter.parseIncoming({ event: 'message', message: {}, sender: { id: '1' } })).toBeNull();
+        });
+        it('parses message event', () => {
+            const payload = {
+                event: 'message',
+                message: { text: 'Hello from Viber' },
+                sender: { id: 'viber-user-123', name: 'Alice' },
+                message_token: 98765,
+                timestamp: 1609459200000,
+            };
+            const result = adapter.parseIncoming(payload);
+            expect(result).not.toBeNull();
+            const msg = Array.isArray(result) ? result[0] : result;
+            expect(msg?.id).toBe('98765');
+            expect(msg?.channel).toBe('viber');
+            expect(msg?.conversationId).toBe('viber-user-123');
+            expect(msg?.userId).toBe('viber-user-123');
+            expect(msg?.userName).toBe('Alice');
+            expect(msg?.text).toBe('Hello from Viber');
+            expect(msg?.sessionId).toBe('viber:viber-user-123');
+        });
+        it('handles missing message_token with timestamp fallback', () => {
+            const payload = {
+                event: 'message',
+                message: { text: 'Hi' },
+                sender: { id: 'u1' },
+            };
+            const result = adapter.parseIncoming(payload);
+            expect(result).not.toBeNull();
+            const msg = Array.isArray(result) ? result[0] : result;
+            expect(msg?.id).toBeDefined();
+        });
+    });
+    describe('send', () => {
+        it('throws or succeeds depending on viber-bot availability', async () => {
+            try {
+                await adapter.send({ conversationId: 'x', text: 'Hi' });
+                expect(true).toBe(true); // viber-bot installed, send succeeded
+            }
+            catch (e) {
+                expect(e.message).toContain('viber-bot');
+            }
+        });
+    });
+    describe('getBot', () => {
+        it('returns bot instance or null', () => {
+            expect(adapter.getBot()).toBeDefined();
+        });
+    });
+    describe('parseIncoming with missing sender', () => {
+        it('handles event when sender is missing', () => {
+            const payload = {
+                event: 'message',
+                message: { text: 'Hi' },
+                message_token: 1,
+                timestamp: 1609459200000,
+            };
+            const result = adapter.parseIncoming(payload);
+            expect(result).not.toBeNull();
+            const msg = Array.isArray(result) ? result[0] : result;
+            expect(msg?.conversationId).toBe('');
+            expect(msg?.userId).toBe('');
+            expect(msg?.sessionId).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=viber.adapter.test.js.map

package/dist/adapters/viber.adapter.test.js.map

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

package/dist/adapters/whatsapp.adapter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * WhatsApp Cloud API channel adapter
+ * Uses Meta's Cloud API (Graph API) - no Puppeteer/QR required
+ */
+import type { IChannelAdapter, IncomingMessage, OutgoingMessage, MessagingChannel } from '../types/message.types';
+export interface WhatsAppAdapterConfig {
+    accessToken: string;
+    phoneNumberId: string;
+    /** Graph API version, e.g. v18.0 */
+    apiVersion?: string;
+}
+/** WhatsApp Cloud API adapter */
+export declare class WhatsAppAdapter implements IChannelAdapter {
+    readonly channel: MessagingChannel;
+    private config;
+    private baseUrl;
+    constructor(config: WhatsAppAdapterConfig);
+    private request;
+    /** Parse WhatsApp webhook payload into IncomingMessage(s) */
+    parseIncoming(payload: unknown): IncomingMessage | IncomingMessage[] | null;
+    /** Send text message via WhatsApp Cloud API */
+    send(message: OutgoingMessage): Promise<void>;
+    /** Verify webhook subscription (Meta sends hub.mode, hub.verify_token) */
+    verifyWebhook(payload: unknown, _headers?: Record<string, string>): boolean;
+}
+//# sourceMappingURL=whatsapp.adapter.d.ts.map

package/dist/adapters/whatsapp.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/whatsapp.adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,iCAAiC;AACjC,qBAAa,eAAgB,YAAW,eAAe;IACrD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAc;IAChD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,qBAAqB;YAQ3B,OAAO;IAiBrB,6DAA6D;IAC7D,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,eAAe,EAAE,GAAG,IAAI;IAgD3E,+CAA+C;IACzC,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAcnD,0EAA0E;IAC1E,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;CAK5E"}

package/dist/adapters/whatsapp.adapter.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsAppAdapter = void 0;
+const GRAPH_BASE = 'https://graph.facebook.com';
+/** WhatsApp Cloud API adapter */
+class WhatsAppAdapter {
+    constructor(config) {
+        this.channel = 'whatsapp';
+        this.config = {
+            apiVersion: 'v18.0',
+            ...config,
+        };
+        this.baseUrl = `${GRAPH_BASE}/${this.config.apiVersion}`;
+    }
+    async request(path, init = {}) {
+        const url = `${this.baseUrl}${path}`;
+        const res = await fetch(url, {
+            ...init,
+            headers: {
+                Authorization: `Bearer ${this.config.accessToken}`,
+                'Content-Type': 'application/json',
+                ...init.headers,
+            },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`WhatsApp API error ${res.status}: ${text}`);
+        }
+        return res.json();
+    }
+    /** Parse WhatsApp webhook payload into IncomingMessage(s) */
+    parseIncoming(payload) {
+        const body = payload;
+        const messages = [];
+        for (const entry of body.entry ?? []) {
+            for (const change of entry.changes ?? []) {
+                const value = change.value;
+                if (!value?.messages)
+                    continue;
+                for (const msg of value.messages) {
+                    if (msg.type !== 'text' || !msg.text?.body)
+                        continue;
+                    const contact = value.contacts?.[0]?.profile?.name;
+                    messages.push({
+                        id: msg.id,
+                        channel: 'whatsapp',
+                        conversationId: msg.from,
+                        userId: msg.from,
+                        userName: contact,
+                        text: msg.text.body,
+                        rawPayload: msg,
+                        timestamp: new Date(parseInt(msg.timestamp, 10) * 1000),
+                        sessionId: `whatsapp:${msg.from}`,
+                        metadata: { contextId: msg.context?.id },
+                    });
+                }
+            }
+        }
+        if (messages.length === 0)
+            return null;
+        if (messages.length === 1)
+            return messages[0];
+        return messages;
+    }
+    /** Send text message via WhatsApp Cloud API */
+    async send(message) {
+        await this.request(`/${this.config.phoneNumberId}/messages`, {
+            method: 'POST',
+            body: JSON.stringify({
+                messaging_product: 'whatsapp',
+                recipient_type: 'individual',
+                to: message.conversationId.replace(/\D/g, ''),
+                type: 'text',
+                text: { body: message.text },
+                context: message.replyToMessageId ? { message_id: message.replyToMessageId } : undefined,
+            }),
+        });
+    }
+    /** Verify webhook subscription (Meta sends hub.mode, hub.verify_token) */
+    verifyWebhook(payload, _headers) {
+        const q = payload;
+        const token = process.env.WHATSAPP_VERIFY_TOKEN;
+        return q['hub.mode'] === 'subscribe' && !!token && q['hub.verify_token'] === token;
+    }
+}
+exports.WhatsAppAdapter = WhatsAppAdapter;
+//# sourceMappingURL=whatsapp.adapter.js.map

package/dist/adapters/whatsapp.adapter.js.map

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

package/dist/adapters/whatsapp.adapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=whatsapp.adapter.test.d.ts.map

package/dist/adapters/whatsapp.adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.adapter.test.d.ts","sourceRoot":"","sources":["../../src/adapters/whatsapp.adapter.test.ts"],"names":[],"mappings":""}