@auxiora/channels 1.0.0

package/dist/adapters/twilio.js

@@ -0,0 +1,193 @@
+import Twilio from 'twilio';
+import { audit } from '@auxiora/audit';
+const MAX_SMS_LENGTH = 1600; // SMS segment limit
+const MAX_WHATSAPP_LENGTH = 4096;
+export class TwilioAdapter {
+    type = 'twilio';
+    name = 'Twilio';
+    client;
+    config;
+    messageHandler;
+    errorHandler;
+    connected = false;
+    constructor(config) {
+        this.config = config;
+        this.client = Twilio(config.accountSid, config.authToken);
+    }
+    async connect() {
+        // Verify credentials by fetching account info
+        try {
+            await this.client.api.accounts(this.config.accountSid).fetch();
+            this.connected = true;
+            audit('channel.connected', { channelType: 'twilio' });
+        }
+        catch (error) {
+            throw new Error(`Failed to connect to Twilio: ${error instanceof Error ? error.message : error}`);
+        }
+    }
+    async disconnect() {
+        this.connected = false;
+        audit('channel.disconnected', { channelType: 'twilio' });
+    }
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Handle incoming webhook from Twilio
+     * Call this from your HTTP server when receiving POST to your webhook URL
+     */
+    async handleWebhook(body) {
+        const isWhatsApp = body.From.startsWith('whatsapp:');
+        // Check allowed numbers (strip whatsapp: prefix for matching)
+        const senderNumber = isWhatsApp ? body.From.replace('whatsapp:', '') : body.From;
+        if (this.config.allowedNumbers?.length && !this.config.allowedNumbers.includes(senderNumber)) {
+            audit('message.filtered', { channelType: 'twilio', senderId: body.From, reason: 'number_not_allowed' });
+            return null;
+        }
+        const inbound = {
+            id: body.MessageSid,
+            channelType: 'twilio',
+            channelId: isWhatsApp ? 'whatsapp' : 'sms',
+            senderId: body.From,
+            content: body.Body,
+            timestamp: Date.now(),
+            attachments: body.NumMedia && parseInt(body.NumMedia, 10) > 0
+                ? [{
+                        type: body.MediaContentType0?.startsWith('image/') ? 'image' : 'file',
+                        url: body.MediaUrl0,
+                        mimeType: body.MediaContentType0,
+                    }]
+                : undefined,
+            raw: body,
+        };
+        audit('message.received', {
+            channelType: 'twilio',
+            senderId: inbound.senderId,
+            channelId: inbound.channelId,
+            isWhatsApp,
+        });
+        if (this.messageHandler) {
+            try {
+                await this.messageHandler(inbound);
+            }
+            catch (error) {
+                this.errorHandler?.(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        // Return null to indicate no TwiML response needed
+        // Or return TwiML XML string if you want to respond immediately
+        return null;
+    }
+    /**
+     * Send message to a phone number
+     * @param channelId Phone number in E.164 format (+1234567890) or whatsapp:+1234567890
+     */
+    async send(channelId, message) {
+        try {
+            const isWhatsApp = channelId.startsWith('whatsapp:');
+            const fromNumber = isWhatsApp
+                ? this.config.whatsappNumber || `whatsapp:${this.config.phoneNumber}`
+                : this.config.phoneNumber;
+            if (!fromNumber) {
+                return { success: false, error: 'No phone number configured for this channel type' };
+            }
+            const maxLength = isWhatsApp ? MAX_WHATSAPP_LENGTH : MAX_SMS_LENGTH;
+            const chunks = this.chunkMessage(message.content, maxLength);
+            let lastMessageSid;
+            for (const chunk of chunks) {
+                const sent = await this.client.messages.create({
+                    from: fromNumber,
+                    to: channelId,
+                    body: chunk,
+                });
+                lastMessageSid = sent.sid;
+            }
+            audit('message.sent', {
+                channelType: 'twilio',
+                channelId,
+                messageId: lastMessageSid,
+                isWhatsApp,
+            });
+            return { success: true, messageId: lastMessageSid };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            audit('channel.error', {
+                channelType: 'twilio',
+                action: 'send',
+                error: errorMessage,
+            });
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * Send SMS to a phone number
+     */
+    async sendSMS(to, message) {
+        // Ensure proper format
+        const phoneNumber = to.startsWith('+') ? to : `+${to}`;
+        return this.send(phoneNumber, { content: message });
+    }
+    /**
+     * Send WhatsApp message
+     */
+    async sendWhatsApp(to, message) {
+        // Ensure proper format
+        const phoneNumber = to.replace('whatsapp:', '');
+        const whatsappTo = `whatsapp:${phoneNumber.startsWith('+') ? phoneNumber : `+${phoneNumber}`}`;
+        return this.send(whatsappTo, { content: message });
+    }
+    chunkMessage(content, maxLength) {
+        if (content.length <= maxLength) {
+            return [content];
+        }
+        const chunks = [];
+        let remaining = content;
+        while (remaining.length > 0) {
+            if (remaining.length <= maxLength) {
+                chunks.push(remaining);
+                break;
+            }
+            let breakPoint = remaining.lastIndexOf('\n', maxLength);
+            if (breakPoint === -1 || breakPoint < maxLength / 2) {
+                breakPoint = remaining.lastIndexOf(' ', maxLength);
+            }
+            if (breakPoint === -1 || breakPoint < maxLength / 2) {
+                breakPoint = maxLength;
+            }
+            chunks.push(remaining.slice(0, breakPoint));
+            remaining = remaining.slice(breakPoint).trimStart();
+        }
+        return chunks;
+    }
+    /**
+     * Validate Twilio webhook signature
+     */
+    validateWebhookSignature(signature, url, params) {
+        return Twilio.validateRequest(this.config.authToken, signature, url, params);
+    }
+    /**
+     * Generate TwiML response for immediate reply
+     */
+    static generateTwiML(message) {
+        return `<?xml version="1.0" encoding="UTF-8"?>
+<Response>
+  <Message>${this.escapeXml(message)}</Message>
+</Response>`;
+    }
+    static escapeXml(text) {
+        return text
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&apos;');
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    onError(handler) {
+        this.errorHandler = handler;
+    }
+}
+//# sourceMappingURL=twilio.js.map

package/dist/adapters/twilio.js.map

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

package/dist/adapters/whatsapp.d.ts

@@ -0,0 +1,99 @@
+import type { ChannelAdapter, InboundMessage, OutboundMessage, SendResult } from '../types.js';
+export interface WhatsAppAdapterConfig {
+    phoneNumberId: string;
+    accessToken: string;
+    verifyToken: string;
+    allowedNumbers?: string[];
+}
+interface WhatsAppWebhookBody {
+    object: string;
+    entry: Array<{
+        id: string;
+        changes: Array<{
+            value: {
+                messaging_product: string;
+                metadata: {
+                    display_phone_number: string;
+                    phone_number_id: string;
+                };
+                contacts?: Array<{
+                    profile: {
+                        name: string;
+                    };
+                    wa_id: string;
+                }>;
+                messages?: Array<WhatsAppIncomingMessage>;
+                statuses?: Array<{
+                    id: string;
+                    status: string;
+                    timestamp: string;
+                }>;
+            };
+            field: string;
+        }>;
+    }>;
+}
+interface WhatsAppIncomingMessage {
+    from: string;
+    id: string;
+    timestamp: string;
+    type: string;
+    text?: {
+        body: string;
+    };
+    image?: {
+        id: string;
+        mime_type: string;
+        sha256: string;
+        caption?: string;
+    };
+    document?: {
+        id: string;
+        mime_type: string;
+        filename?: string;
+        sha256: string;
+        caption?: string;
+    };
+    audio?: {
+        id: string;
+        mime_type: string;
+    };
+    video?: {
+        id: string;
+        mime_type: string;
+    };
+    context?: {
+        from: string;
+        id: string;
+    };
+}
+export declare class WhatsAppAdapter implements ChannelAdapter {
+    readonly type: "whatsapp";
+    readonly name = "WhatsApp";
+    private config;
+    private messageHandler?;
+    private errorHandler?;
+    private connected;
+    constructor(config: WhatsAppAdapterConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    /**
+     * Verify webhook subscription from Meta.
+     * Returns the challenge string if the verify token matches.
+     */
+    verifyWebhook(mode: string, token: string, challenge: string): string | null;
+    /**
+     * Handle incoming webhook from WhatsApp Business API.
+     * Call this from your HTTP server when receiving POST to your webhook URL.
+     */
+    handleWebhook(body: WhatsAppWebhookBody): Promise<void>;
+    private handleMessage;
+    private toInboundMessage;
+    send(channelId: string, message: OutboundMessage): Promise<SendResult>;
+    private chunkMessage;
+    onMessage(handler: (message: InboundMessage) => Promise<void>): void;
+    onError(handler: (error: Error) => void): void;
+}
+export {};
+//# sourceMappingURL=whatsapp.d.ts.map

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

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

package/dist/adapters/whatsapp.js

@@ -0,0 +1,218 @@
+import { audit } from '@auxiora/audit';
+const GRAPH_API_BASE = 'https://graph.facebook.com/v18.0';
+const MAX_MESSAGE_LENGTH = 4096;
+export class WhatsAppAdapter {
+    type = 'whatsapp';
+    name = 'WhatsApp';
+    config;
+    messageHandler;
+    errorHandler;
+    connected = false;
+    constructor(config) {
+        this.config = config;
+    }
+    async connect() {
+        // Verify credentials by checking the phone number ID
+        const response = await fetch(`${GRAPH_API_BASE}/${this.config.phoneNumberId}`, {
+            headers: {
+                'Authorization': `Bearer ${this.config.accessToken}`,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to verify WhatsApp credentials: ${response.status} ${response.statusText}`);
+        }
+        this.connected = true;
+        audit('channel.connected', {
+            channelType: 'whatsapp',
+            phoneNumberId: this.config.phoneNumberId,
+        });
+    }
+    async disconnect() {
+        this.connected = false;
+        audit('channel.disconnected', { channelType: 'whatsapp' });
+    }
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Verify webhook subscription from Meta.
+     * Returns the challenge string if the verify token matches.
+     */
+    verifyWebhook(mode, token, challenge) {
+        if (mode === 'subscribe' && token === this.config.verifyToken) {
+            return challenge;
+        }
+        return null;
+    }
+    /**
+     * Handle incoming webhook from WhatsApp Business API.
+     * Call this from your HTTP server when receiving POST to your webhook URL.
+     */
+    async handleWebhook(body) {
+        if (body.object !== 'whatsapp_business_account')
+            return;
+        for (const entry of body.entry) {
+            for (const change of entry.changes) {
+                if (change.field !== 'messages')
+                    continue;
+                const messages = change.value.messages;
+                if (!messages)
+                    continue;
+                const contacts = change.value.contacts;
+                for (const msg of messages) {
+                    const contact = contacts?.find((c) => c.wa_id === msg.from);
+                    await this.handleMessage(msg, contact);
+                }
+            }
+        }
+    }
+    async handleMessage(msg, contact) {
+        // Only process text messages for now
+        if (msg.type !== 'text' && msg.type !== 'image' && msg.type !== 'document')
+            return;
+        // Check allowed numbers
+        if (this.config.allowedNumbers?.length && !this.config.allowedNumbers.includes(msg.from)) {
+            audit('message.filtered', { channelType: 'whatsapp', senderId: msg.from, reason: 'number_not_allowed' });
+            return;
+        }
+        const inbound = this.toInboundMessage(msg, contact);
+        audit('message.received', {
+            channelType: 'whatsapp',
+            senderId: inbound.senderId,
+            channelId: inbound.channelId,
+        });
+        if (this.messageHandler) {
+            try {
+                await this.messageHandler(inbound);
+            }
+            catch (error) {
+                this.errorHandler?.(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+    }
+    toInboundMessage(msg, contact) {
+        let content = '';
+        const attachments = [];
+        switch (msg.type) {
+            case 'text':
+                content = msg.text?.body || '';
+                break;
+            case 'image':
+                content = msg.image?.caption || '';
+                attachments.push({
+                    type: 'image',
+                    mimeType: msg.image?.mime_type,
+                });
+                break;
+            case 'document':
+                content = msg.document?.caption || '';
+                attachments.push({
+                    type: 'file',
+                    mimeType: msg.document?.mime_type,
+                    filename: msg.document?.filename,
+                });
+                break;
+            case 'audio':
+                attachments.push({
+                    type: 'audio',
+                    mimeType: msg.audio?.mime_type,
+                });
+                break;
+            case 'video':
+                attachments.push({
+                    type: 'video',
+                    mimeType: msg.video?.mime_type,
+                });
+                break;
+        }
+        return {
+            id: msg.id,
+            channelType: 'whatsapp',
+            channelId: msg.from,
+            senderId: msg.from,
+            senderName: contact?.profile.name,
+            content,
+            timestamp: parseInt(msg.timestamp, 10) * 1000,
+            replyToId: msg.context?.id,
+            attachments: attachments.length > 0 ? attachments : undefined,
+            raw: msg,
+        };
+    }
+    async send(channelId, message) {
+        try {
+            const chunks = this.chunkMessage(message.content);
+            let lastMessageId;
+            for (const chunk of chunks) {
+                const body = {
+                    messaging_product: 'whatsapp',
+                    recipient_type: 'individual',
+                    to: channelId,
+                    type: 'text',
+                    text: { body: chunk },
+                };
+                if (message.replyToId) {
+                    body.context = { message_id: message.replyToId };
+                }
+                const response = await fetch(`${GRAPH_API_BASE}/${this.config.phoneNumberId}/messages`, {
+                    method: 'POST',
+                    headers: {
+                        'Authorization': `Bearer ${this.config.accessToken}`,
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(body),
+                });
+                if (!response.ok) {
+                    const errorText = await response.text().catch(() => response.statusText);
+                    throw new Error(`WhatsApp API error ${response.status}: ${errorText}`);
+                }
+                const result = await response.json();
+                lastMessageId = result.messages?.[0]?.id;
+            }
+            audit('message.sent', {
+                channelType: 'whatsapp',
+                channelId,
+                messageId: lastMessageId,
+            });
+            return { success: true, messageId: lastMessageId };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            audit('channel.error', {
+                channelType: 'whatsapp',
+                action: 'send',
+                error: errorMessage,
+            });
+            return { success: false, error: errorMessage };
+        }
+    }
+    chunkMessage(content) {
+        if (content.length <= MAX_MESSAGE_LENGTH) {
+            return [content];
+        }
+        const chunks = [];
+        let remaining = content;
+        while (remaining.length > 0) {
+            if (remaining.length <= MAX_MESSAGE_LENGTH) {
+                chunks.push(remaining);
+                break;
+            }
+            let breakPoint = remaining.lastIndexOf('\n', MAX_MESSAGE_LENGTH);
+            if (breakPoint === -1 || breakPoint < MAX_MESSAGE_LENGTH / 2) {
+                breakPoint = remaining.lastIndexOf(' ', MAX_MESSAGE_LENGTH);
+            }
+            if (breakPoint === -1 || breakPoint < MAX_MESSAGE_LENGTH / 2) {
+                breakPoint = MAX_MESSAGE_LENGTH;
+            }
+            chunks.push(remaining.slice(0, breakPoint));
+            remaining = remaining.slice(breakPoint).trimStart();
+        }
+        return chunks;
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    onError(handler) {
+        this.errorHandler = handler;
+    }
+}
+//# sourceMappingURL=whatsapp.js.map

package/dist/adapters/whatsapp.js.map

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

package/dist/adapters/zalo.d.ts

@@ -0,0 +1,64 @@
+import type { ChannelAdapter, InboundMessage, OutboundMessage, SendResult } from '../types.js';
+export interface ZaloAdapterConfig {
+    oaAccessToken: string;
+    oaSecretKey: string;
+    allowedUserIds?: string[];
+}
+interface ZaloWebhookEvent {
+    app_id: string;
+    sender: {
+        id: string;
+    };
+    recipient: {
+        id: string;
+    };
+    event_name: string;
+    message?: {
+        msg_id: string;
+        text?: string;
+        attachments?: Array<{
+            type: string;
+            payload: {
+                url?: string;
+                thumbnail?: string;
+                id?: string;
+                size?: number;
+                name?: string;
+                type?: string;
+            };
+        }>;
+        quote_msg_id?: string;
+    };
+    timestamp: string;
+}
+export declare class ZaloAdapter implements ChannelAdapter {
+    readonly type: "zalo";
+    readonly name = "Zalo";
+    private config;
+    private messageHandler?;
+    private errorHandler?;
+    private connected;
+    private userNameCache;
+    constructor(config: ZaloAdapterConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    /**
+     * Verify the webhook signature from Zalo.
+     * Returns true if the signature is valid.
+     */
+    verifyWebhookSignature(body: string, signature: string): boolean;
+    /**
+     * Handle incoming webhook from Zalo OA.
+     * Call this from your HTTP server when receiving POST to your webhook URL.
+     */
+    handleWebhook(event: ZaloWebhookEvent): Promise<void>;
+    private getUserName;
+    private toInboundMessage;
+    send(channelId: string, message: OutboundMessage): Promise<SendResult>;
+    private chunkMessage;
+    onMessage(handler: (message: InboundMessage) => Promise<void>): void;
+    onError(handler: (error: Error) => void): void;
+}
+export {};
+//# sourceMappingURL=zalo.d.ts.map

package/dist/adapters/zalo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zalo.d.ts","sourceRoot":"","sources":["../../src/adapters/zalo.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,KAAK,CAAC;YAClB,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE;gBACP,GAAG,CAAC,EAAE,MAAM,CAAC;gBACb,SAAS,CAAC,EAAE,MAAM,CAAC;gBACnB,EAAE,CAAC,EAAE,MAAM,CAAC;gBACZ,IAAI,CAAC,EAAE,MAAM,CAAC;gBACd,IAAI,CAAC,EAAE,MAAM,CAAC;gBACd,IAAI,CAAC,EAAE,MAAM,CAAC;aACf,CAAC;SACH,CAAC,CAAC;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAuBD,qBAAa,WAAY,YAAW,cAAc;IAChD,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,IAAI,UAAU;IAEvB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,cAAc,CAAC,CAA6C;IACpE,OAAO,CAAC,YAAY,CAAC,CAAyB;IAC9C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAkC;gBAE3C,MAAM,EAAE,iBAAiB;IAI/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAOhE;;;OAGG;IACG,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;YAuC7C,WAAW;IA4BzB,OAAO,CAAC,gBAAgB;IAiClB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAuD5E,OAAO,CAAC,YAAY;IA6BpB,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIpE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;CAG/C"}