@flink-app/whatsapp-plugin 2.0.0-alpha.74

package/dist/whatsappContext.js

@@ -0,0 +1,236 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWhatsappContext = createWhatsappContext;
+exports.createScopedWhatsappContext = createScopedWhatsappContext;
+const transport = __importStar(require("./WhatsappTransport"));
+const DEFAULT_VERSION = "v21.0";
+function getVersion(conn) {
+    var _a;
+    return (_a = conn.graphApiVersion) !== null && _a !== void 0 ? _a : DEFAULT_VERSION;
+}
+function createScopedContext(getConn) {
+    return {
+        async send(opts) {
+            const conn = getConn();
+            const { to } = opts, rest = __rest(opts, ["to"]);
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, Object.assign({ to }, rest), getVersion(conn));
+        },
+        async sendText(to, text) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, { to, type: "text", text: { body: text } }, getVersion(conn));
+        },
+        async sendTemplate(to, template) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, { to, type: "template", template }, getVersion(conn));
+        },
+        async sendImage(to, image, caption) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, { to, type: "image", image: Object.assign(Object.assign({}, image), (caption ? { caption } : {})) }, getVersion(conn));
+        },
+        async sendDocument(to, doc, caption) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, { to, type: "document", document: Object.assign(Object.assign({}, doc), (caption ? { caption } : {})) }, getVersion(conn));
+        },
+        async sendInteractiveButtons(to, body, buttons) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, {
+                to,
+                type: "interactive",
+                interactive: {
+                    type: "button",
+                    body: { text: body },
+                    action: {
+                        buttons: buttons.map((b) => ({
+                            type: "reply",
+                            reply: { id: b.id, title: b.title },
+                        })),
+                    },
+                },
+            }, getVersion(conn));
+        },
+        async sendInteractiveList(to, body, buttonText, sections) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, {
+                to,
+                type: "interactive",
+                interactive: {
+                    type: "list",
+                    body: { text: body },
+                    action: {
+                        button: buttonText,
+                        sections,
+                    },
+                },
+            }, getVersion(conn));
+        },
+        async sendLocation(to, location) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, { to, type: "location", location }, getVersion(conn));
+        },
+        async sendReaction(to, messageId, emoji) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, { to, type: "reaction", reaction: { message_id: messageId, emoji } }, getVersion(conn));
+        },
+        async reply(message, text) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, {
+                to: message.from,
+                type: "text",
+                text: { body: text },
+                context: { message_id: message.messageId },
+            }, getVersion(conn));
+        },
+        async markAsRead(messageId) {
+            const conn = getConn();
+            await transport.markAsRead(conn.phoneNumberId, conn.accessToken, messageId, getVersion(conn));
+        },
+        async uploadMedia(file, mimeType, filename) {
+            const conn = getConn();
+            return transport.uploadMedia(conn.phoneNumberId, conn.accessToken, file, mimeType, filename, getVersion(conn));
+        },
+        async downloadMedia(mediaId) {
+            const conn = getConn();
+            return transport.downloadMedia(mediaId, conn.accessToken, getVersion(conn));
+        },
+    };
+}
+function createWhatsappContext(manager, addConnectionFn) {
+    const getConn = (connectionId) => {
+        return manager.get(connectionId !== null && connectionId !== void 0 ? connectionId : "default");
+    };
+    // Build the full object directly — do NOT spread a scoped context,
+    // because spreading eagerly evaluates getters before any connections have been added.
+    return {
+        async send(opts) {
+            const conn = getConn();
+            const { to } = opts, rest = __rest(opts, ["to"]);
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, Object.assign({ to }, rest), getVersion(conn));
+        },
+        async sendText(to, text) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, { to, type: "text", text: { body: text } }, getVersion(conn));
+        },
+        async sendTemplate(to, template) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, { to, type: "template", template }, getVersion(conn));
+        },
+        async sendImage(to, image, caption) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, { to, type: "image", image: Object.assign(Object.assign({}, image), (caption ? { caption } : {})) }, getVersion(conn));
+        },
+        async sendDocument(to, doc, caption) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, { to, type: "document", document: Object.assign(Object.assign({}, doc), (caption ? { caption } : {})) }, getVersion(conn));
+        },
+        async sendInteractiveButtons(to, body, buttons) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, {
+                to,
+                type: "interactive",
+                interactive: {
+                    type: "button",
+                    body: { text: body },
+                    action: {
+                        buttons: buttons.map((b) => ({
+                            type: "reply",
+                            reply: { id: b.id, title: b.title },
+                        })),
+                    },
+                },
+            }, getVersion(conn));
+        },
+        async sendInteractiveList(to, body, buttonText, sections) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, {
+                to,
+                type: "interactive",
+                interactive: {
+                    type: "list",
+                    body: { text: body },
+                    action: {
+                        button: buttonText,
+                        sections,
+                    },
+                },
+            }, getVersion(conn));
+        },
+        async sendLocation(to, location) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, { to, type: "location", location }, getVersion(conn));
+        },
+        async sendReaction(to, messageId, emoji) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, { to, type: "reaction", reaction: { message_id: messageId, emoji } }, getVersion(conn));
+        },
+        async reply(message, text) {
+            const conn = getConn();
+            return transport.sendMessage(conn.phoneNumberId, conn.accessToken, {
+                to: message.from,
+                type: "text",
+                text: { body: text },
+                context: { message_id: message.messageId },
+            }, getVersion(conn));
+        },
+        async markAsRead(messageId) {
+            const conn = getConn();
+            await transport.markAsRead(conn.phoneNumberId, conn.accessToken, messageId, getVersion(conn));
+        },
+        async uploadMedia(file, mimeType, filename) {
+            const conn = getConn();
+            return transport.uploadMedia(conn.phoneNumberId, conn.accessToken, file, mimeType, filename, getVersion(conn));
+        },
+        async downloadMedia(mediaId) {
+            const conn = getConn();
+            return transport.downloadMedia(mediaId, conn.accessToken, getVersion(conn));
+        },
+        addConnection(id, connection) {
+            addConnectionFn(id, connection);
+        },
+        removeConnection(id) {
+            manager.remove(id);
+        },
+        withConnection(id) {
+            return createScopedContext(() => manager.get(id));
+        },
+        listConnections() {
+            return manager.list();
+        },
+    };
+}
+function createScopedWhatsappContext(manager, connectionId) {
+    return createScopedContext(() => manager.get(connectionId));
+}

package/dist/whatsappFormatting.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Convert standard Markdown to WhatsApp formatting.
+ *
+ * WhatsApp uses:
+ *   *bold*
+ *   _italic_
+ *   ~strikethrough~
+ *   ```code```
+ *   `inline code` (not officially documented but works in most clients)
+ *
+ * Fenced code blocks and inline code are preserved as-is.
+ */
+export declare function toWhatsappFormat(md: string): string;

package/dist/whatsappFormatting.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toWhatsappFormat = toWhatsappFormat;
+/**
+ * Convert standard Markdown to WhatsApp formatting.
+ *
+ * WhatsApp uses:
+ *   *bold*
+ *   _italic_
+ *   ~strikethrough~
+ *   ```code```
+ *   `inline code` (not officially documented but works in most clients)
+ *
+ * Fenced code blocks and inline code are preserved as-is.
+ */
+function toWhatsappFormat(md) {
+    // Split into code-fenced blocks vs everything else so we never
+    // mangle content inside ``` … ```
+    const parts = md.split(/(```[\s\S]*?```)/g);
+    for (let i = 0; i < parts.length; i++) {
+        // Odd indices are fenced code blocks — leave them alone
+        if (i % 2 === 1)
+            continue;
+        let text = parts[i];
+        // Protect inline code spans from further transforms
+        const inlineCode = [];
+        text = text.replace(/`[^`]+`/g, (match) => {
+            inlineCode.push(match);
+            return `\x00IC${inlineCode.length - 1}\x00`;
+        });
+        // Headings: # … → *…* (bold as best approximation)
+        text = text.replace(/^#{1,6}\s+(.+)$/gm, "*$1*");
+        // Bold: **text** or __text__ → *text*
+        // Must run before italic so we don't eat the double markers
+        text = text.replace(/\*\*(.+?)\*\*/g, "*$1*");
+        text = text.replace(/__(.+?)__/g, "*$1*");
+        // Italic: *text* or _text_ → _text_
+        // Only match single * that aren't part of ** (already converted above)
+        text = text.replace(/(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)/g, "_$1_");
+        // Strikethrough: ~~text~~ → ~text~
+        text = text.replace(/~~(.+?)~~/g, "~$1~");
+        // Links: [text](url) → text (url)
+        text = text.replace(/\[([^\]]+)\]\(([^)]+)\)/g, "$1 ($2)");
+        // Images: ![alt](url) → url
+        text = text.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, "$2");
+        // Restore inline code spans
+        text = text.replace(/\x00IC(\d+)\x00/g, (_, idx) => inlineCode[Number(idx)]);
+        parts[i] = text;
+    }
+    return parts.join("");
+}

package/dist/whatsappRouter.d.ts

@@ -0,0 +1,6 @@
+import { WhatsappMessage, WhatsappRouteProps } from "./types";
+/**
+ * Returns true if the message matches the given route criteria.
+ * An empty/undefined Route always matches (catch-all).
+ */
+export declare function matchesRoute(message: WhatsappMessage, route: WhatsappRouteProps): boolean;

package/dist/whatsappRouter.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchesRoute = matchesRoute;
+function matchesStringOrRegExp(value, pattern) {
+    if (pattern instanceof RegExp) {
+        return pattern.test(value);
+    }
+    return value === pattern;
+}
+/**
+ * Returns true if the message matches the given route criteria.
+ * An empty/undefined Route always matches (catch-all).
+ */
+function matchesRoute(message, route) {
+    if (route.type !== undefined) {
+        if (Array.isArray(route.type)) {
+            if (!route.type.includes(message.type))
+                return false;
+        }
+        else {
+            if (message.type !== route.type)
+                return false;
+        }
+    }
+    if (route.from !== undefined) {
+        if (typeof route.from === "function") {
+            if (!route.from(message))
+                return false;
+        }
+        else if (!matchesStringOrRegExp(message.from, route.from)) {
+            return false;
+        }
+    }
+    if (route.pattern !== undefined) {
+        if (typeof route.pattern === "function") {
+            if (!route.pattern(message))
+                return false;
+        }
+        else if (!message.text || !matchesStringOrRegExp(message.text, route.pattern)) {
+            return false;
+        }
+    }
+    if (route.connectionId !== undefined) {
+        if (Array.isArray(route.connectionId)) {
+            if (!route.connectionId.includes(message.connectionId))
+                return false;
+        }
+        else {
+            if (message.connectionId !== route.connectionId)
+                return false;
+        }
+    }
+    return true;
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@flink-app/whatsapp-plugin",
+  "version": "2.0.0-alpha.74",
+  "description": "Flink plugin for bi-directional WhatsApp messaging via Cloud API with auto-discovered WhatsappHandler files",
+  "author": "joel@frost.se",
+  "license": "MIT",
+  "types": "dist/index.d.ts",
+  "main": "dist/index.js",
+  "bin": {
+    "flink-whatsapp": "bin/flink-whatsapp.js"
+  },
+  "exports": {
+    ".": {
+      "default": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./compiler": {
+      "default": "./dist/compiler.js",
+      "types": "./dist/compiler.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "22.13.10",
+    "tsc-watch": "^4.2.9",
+    "rimraf": "^5.0.5",
+    "@flink-app/flink": "2.0.0-alpha.74"
+  },
+  "peerDependencies": {
+    "@flink-app/flink": ">=2.0.0-alpha.74"
+  },
+  "scripts": {
+    "watch": "tsc-watch --project tsconfig.dist.json",
+    "build": "tsc --project tsconfig.dist.json",
+    "clean": "rimraf dist"
+  }
+}

package/src/WhatsappConnectionManager.ts

@@ -0,0 +1,67 @@
+import { FlinkLogFactory } from "@flink-app/flink";
+import { WhatsappConnectionOptions } from "./types";
+
+const log = FlinkLogFactory.createLogger("flink.whatsapp-plugin.connections");
+
+export class WhatsappConnectionManager {
+    private connections = new Map<string, WhatsappConnectionOptions>();
+    /** Reverse map: phoneNumberId → connection ID for webhook routing */
+    private phoneNumberIdMap = new Map<string, string>();
+
+    add(id: string, options: WhatsappConnectionOptions): void {
+        if (this.connections.has(id)) {
+            throw new Error(`WhatsApp connection "${id}" already exists`);
+        }
+
+        this.connections.set(id, options);
+        this.phoneNumberIdMap.set(options.phoneNumberId, id);
+        log.info(`Connection "${id}" added (phone number ID: ${options.phoneNumberId})`);
+    }
+
+    remove(id: string): void {
+        const conn = this.connections.get(id);
+        if (!conn) {
+            throw new Error(`WhatsApp connection "${id}" not found`);
+        }
+
+        this.phoneNumberIdMap.delete(conn.phoneNumberId);
+        this.connections.delete(id);
+        log.info(`Connection "${id}" removed`);
+    }
+
+    get(id: string): WhatsappConnectionOptions {
+        const conn = this.connections.get(id);
+        if (!conn) {
+            throw new Error(`WhatsApp connection "${id}" not found`);
+        }
+        return conn;
+    }
+
+    has(id: string): boolean {
+        return this.connections.has(id);
+    }
+
+    list(): string[] {
+        return Array.from(this.connections.keys());
+    }
+
+    /** Resolve a phone number ID from a webhook to a connection ID */
+    resolveConnectionId(phoneNumberId: string): string | undefined {
+        return this.phoneNumberIdMap.get(phoneNumberId);
+    }
+
+    /** Get any connection's appSecret for signature verification */
+    getAnyAppSecret(): string | undefined {
+        const first = this.connections.values().next();
+        return first.done ? undefined : first.value.appSecret;
+    }
+
+    /** Get all unique app secrets (for trying signature verification with multiple secrets) */
+    getAppSecrets(): string[] {
+        const secrets = new Set<string>();
+        for (const conn of this.connections.values()) {
+            secrets.add(conn.appSecret);
+        }
+        return Array.from(secrets);
+    }
+}