@yaoqi10012/wechat-kf 0.3.1

package/dist/types.d.ts

@@ -0,0 +1,236 @@
+export type WechatKfConfig = {
+    enabled?: boolean;
+    corpId?: string;
+    appSecret?: string;
+    token?: string;
+    encodingAESKey?: string;
+    webhookPath?: string;
+    dmPolicy?: "open" | "pairing" | "allowlist" | "disabled";
+    allowFrom?: string[];
+    debounceMs?: number;
+};
+export type ResolvedWechatKfAccount = {
+    accountId: string;
+    enabled: boolean;
+    configured: boolean;
+    corpId?: string;
+    appSecret?: string;
+    token?: string;
+    encodingAESKey?: string;
+    openKfId?: string;
+    webhookPath: string;
+    config: WechatKfConfig;
+};
+export type WechatAccessTokenResponse = {
+    errcode: number;
+    errmsg: string;
+    access_token: string;
+    expires_in: number;
+};
+export type WechatKfSyncMsgRequest = {
+    cursor?: string;
+    token?: string;
+    limit?: number;
+    voice_format?: number;
+    open_kfid?: string;
+};
+export type WechatKfMergedMsgItem = {
+    sender_name?: string;
+    msg_content?: string;
+    send_time?: number;
+    msgtype?: string;
+};
+export type WechatKfMessage = {
+    msgid: string;
+    open_kfid: string;
+    external_userid: string;
+    send_time: number;
+    origin: number;
+    servicer_userid?: string;
+    msgtype: string;
+    text?: {
+        content: string;
+        menu_id?: string;
+    };
+    image?: {
+        media_id: string;
+    };
+    voice?: {
+        media_id: string;
+    };
+    video?: {
+        media_id: string;
+    };
+    file?: {
+        media_id: string;
+    };
+    location?: {
+        latitude: number;
+        longitude: number;
+        name: string;
+        address: string;
+    };
+    link?: {
+        title: string;
+        desc: string;
+        url: string;
+        pic_url: string;
+    };
+    event?: {
+        event_type: string;
+        open_kfid?: string;
+        external_userid?: string;
+        scene?: string;
+        scene_param?: string;
+        welcome_code?: string;
+        fail_msgid?: string;
+        fail_type?: number;
+        servicer_userid?: string;
+        status?: number;
+    };
+    merged_msg?: {
+        title?: string;
+        item?: WechatKfMergedMsgItem[];
+    };
+    channels?: {
+        nickname?: string;
+        title?: string;
+        sub_type?: number;
+    };
+    miniprogram?: {
+        title?: string;
+        appid?: string;
+        pagepath?: string;
+        thumb_media_id?: string;
+    };
+    business_card?: {
+        userid?: string;
+    };
+    msgmenu?: {
+        head_content?: string;
+        list?: {
+            id: string;
+            content?: string;
+        }[];
+        tail_content?: string;
+    };
+    channels_shop_product?: {
+        product_id?: string;
+        head_image?: string;
+        title?: string;
+        sales_price?: string;
+        shop_nickname?: string;
+        shop_head_image?: string;
+    };
+    channels_shop_order?: {
+        order_id?: string;
+        product_titles?: string;
+        price_wording?: string;
+        state?: string;
+        image_url?: string;
+        shop_nickname?: string;
+    };
+};
+export type WechatKfSyncMsgResponse = {
+    errcode: number;
+    errmsg: string;
+    next_cursor: string;
+    has_more: number;
+    msg_list: WechatKfMessage[];
+};
+export type WechatKfSendMsgRequest = {
+    touser: string;
+    open_kfid: string;
+    msgid?: string;
+    msgtype: string;
+    text?: {
+        content: string;
+    };
+    image?: {
+        media_id: string;
+    };
+    file?: {
+        media_id: string;
+    };
+    voice?: {
+        media_id: string;
+    };
+    video?: {
+        media_id: string;
+    };
+    link?: {
+        title: string;
+        desc?: string;
+        url: string;
+        thumb_media_id: string;
+    };
+    miniprogram?: {
+        appid: string;
+        title?: string;
+        thumb_media_id: string;
+        pagepath: string;
+    };
+    msgmenu?: {
+        head_content?: string;
+        list?: Array<{
+            type: "click";
+            click: {
+                id?: string;
+                content: string;
+            };
+        } | {
+            type: "view";
+            view: {
+                url: string;
+                content: string;
+            };
+        } | {
+            type: "miniprogram";
+            miniprogram: {
+                appid: string;
+                pagepath: string;
+                content: string;
+            };
+        } | {
+            type: "text";
+            text: {
+                content: string;
+                no_newline?: number;
+            };
+        }>;
+        tail_content?: string;
+    };
+    location?: {
+        name?: string;
+        address?: string;
+        latitude: number;
+        longitude: number;
+    };
+    business_card?: {
+        userid: string;
+    };
+    ca_link?: {
+        link_url: string;
+    };
+};
+export type WechatKfSendMsgResponse = {
+    errcode: number;
+    errmsg: string;
+    msgid: string;
+};
+export type WechatMediaUploadResponse = {
+    errcode: number;
+    errmsg: string;
+    type: string;
+    media_id: string;
+    created_at: number;
+};
+export type WechatCallbackXml = {
+    ToUserName: string;
+    CreateTime: string;
+    MsgType: string;
+    Event?: string;
+    Token?: string;
+    OpenKfId?: string;
+    Encrypt?: string;
+};

package/dist/types.js

@@ -0,0 +1,3 @@
+// ── WeChat KF Plugin Types ──
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+BAA+B"}

package/dist/unicode-format.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Markdown → Unicode text formatting
+ *
+ * Converts markdown bold/italic/bold-italic to Unicode Mathematical
+ * Alphanumeric Symbols. Only converts ASCII letters (a-z, A-Z) and
+ * digits (0-9) — other characters pass through unchanged.
+ *
+ * This is meant for plain-text surfaces like WeChat KF where
+ * rich text / HTML isn't supported.
+ */
+/**
+ * Convert markdown formatting to Unicode styled text.
+ *
+ * Handles:
+ * - `***text***` or `___text___` → bold italic
+ * - `**text**` or `__text__` → bold
+ * - `*text*` or `_text_` → italic
+ * - `` `code` `` → left as-is (backtick preserved)
+ * - ``` code blocks ``` → left as-is
+ * - `# headings` → 𝗛𝗲𝗮𝗱𝗶𝗻𝗴 (bold, # stripped)
+ * - `- list items` / `* list items` → • item
+ * - `1. numbered` → 1. (kept)
+ * - `[text](url)` → text (url)
+ * - `~~strikethrough~~` → stripped markers (no unicode strikethrough that's reliable)
+ */
+export declare function markdownToUnicode(text: string): string;

package/dist/unicode-format.js

@@ -0,0 +1,157 @@
+/**
+ * Markdown → Unicode text formatting
+ *
+ * Converts markdown bold/italic/bold-italic to Unicode Mathematical
+ * Alphanumeric Symbols. Only converts ASCII letters (a-z, A-Z) and
+ * digits (0-9) — other characters pass through unchanged.
+ *
+ * This is meant for plain-text surfaces like WeChat KF where
+ * rich text / HTML isn't supported.
+ */
+// Unicode Mathematical Alphanumeric offsets for A-Z, a-z
+// Bold: U+1D400 (A) / U+1D41A (a)
+// Italic: U+1D434 (A) / U+1D44E (a)
+// Bold Italic: U+1D468 (A) / U+1D482 (a)
+// Bold digits: U+1D7CE (0)
+const BOLD_UPPER_START = 0x1d400;
+const BOLD_LOWER_START = 0x1d41a;
+const BOLD_DIGIT_START = 0x1d7ce;
+const ITALIC_UPPER_START = 0x1d434;
+const ITALIC_LOWER_START = 0x1d44e;
+// Italic has no digit variant — use normal digits
+const BOLD_ITALIC_UPPER_START = 0x1d468;
+const BOLD_ITALIC_LOWER_START = 0x1d482;
+function mapChar(ch, upperStart, lowerStart, digitStart) {
+    const code = ch.charCodeAt(0);
+    if (code >= 65 && code <= 90) {
+        // A-Z
+        return String.fromCodePoint(upperStart + (code - 65));
+    }
+    if (code >= 97 && code <= 122) {
+        // a-z
+        return String.fromCodePoint(lowerStart + (code - 97));
+    }
+    if (digitStart !== undefined && code >= 48 && code <= 57) {
+        // 0-9
+        return String.fromCodePoint(digitStart + (code - 48));
+    }
+    return ch;
+}
+function toBold(text) {
+    return [...text].map((ch) => mapChar(ch, BOLD_UPPER_START, BOLD_LOWER_START, BOLD_DIGIT_START)).join("");
+}
+function toItalic(text) {
+    return [...text]
+        .map((ch) => {
+        // Special case: italic lowercase 'h' is U+210E (ℎ) not in the block
+        if (ch === "h")
+            return "\u210E";
+        return mapChar(ch, ITALIC_UPPER_START, ITALIC_LOWER_START);
+    })
+        .join("");
+}
+function toBoldItalic(text) {
+    return [...text].map((ch) => mapChar(ch, BOLD_ITALIC_UPPER_START, BOLD_ITALIC_LOWER_START)).join("");
+}
+/** Regex matching any placeholder inserted by steps 1-4. */
+const PLACEHOLDER_RE = /\x00(?:CB|IC|ES)\d+\x00/g;
+/**
+ * Apply a Unicode transform while preserving placeholder sequences.
+ * Splits text on placeholder boundaries, transforms only non-placeholder
+ * segments, and reassembles.
+ */
+function applyTransform(text, transform) {
+    let result = "";
+    let lastIndex = 0;
+    for (const match of text.matchAll(PLACEHOLDER_RE)) {
+        const idx = match.index;
+        if (idx > lastIndex) {
+            result += transform(text.slice(lastIndex, idx));
+        }
+        result += match[0];
+        lastIndex = idx + match[0].length;
+    }
+    if (lastIndex < text.length) {
+        result += transform(text.slice(lastIndex));
+    }
+    return result;
+}
+/**
+ * Convert markdown formatting to Unicode styled text.
+ *
+ * Handles:
+ * - `***text***` or `___text___` → bold italic
+ * - `**text**` or `__text__` → bold
+ * - `*text*` or `_text_` → italic
+ * - `` `code` `` → left as-is (backtick preserved)
+ * - ``` code blocks ``` → left as-is
+ * - `# headings` → 𝗛𝗲𝗮𝗱𝗶𝗻𝗴 (bold, # stripped)
+ * - `- list items` / `* list items` → • item
+ * - `1. numbered` → 1. (kept)
+ * - `[text](url)` → text (url)
+ * - `~~strikethrough~~` → stripped markers (no unicode strikethrough that's reliable)
+ */
+export function markdownToUnicode(text) {
+    if (!text)
+        return text;
+    // 1. Preserve code blocks
+    const codeBlocks = [];
+    let result = text.replace(/```[\s\S]*?```/g, (match) => {
+        codeBlocks.push(match.replace(/^```\w*\n?/, "").replace(/\n?```$/, ""));
+        return `\x00CB${codeBlocks.length - 1}\x00`;
+    });
+    // 2. Preserve inline code
+    const inlineCodes = [];
+    result = result.replace(/`([^`\n]+)`/g, (_match, code) => {
+        inlineCodes.push(code);
+        return `\x00IC${inlineCodes.length - 1}\x00`;
+    });
+    // 3. Images: ![alt](url) → [alt](url)  (must come before link handling)
+    result = result.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, "[$1]($2)");
+    // 4. Escape characters: protect \* \_ \~ \` \# \[ \] \( \) \\ \- \!
+    const escapes = [];
+    result = result.replace(/\\([*_~`#[\]()\\!-])/g, (_m, ch) => {
+        escapes.push(ch);
+        return `\x00ES${escapes.length - 1}\x00`;
+    });
+    // 5. Links: [text](url) → text (url)
+    result = result.replace(/\[([^\]]*)\]\(([^)]+)\)/g, "$1 ($2)");
+    // 6. Headings: # text → bold text (before bold/italic so inner markers are also bolded)
+    result = result.replace(/^(#{1,6})\s+(.+)$/gm, (_m, _hashes, content) => {
+        // Strip any inline bold/italic markers before applying bold
+        const stripped = content.replace(/\*{1,3}([^*]+)\*{1,3}/g, "$1").replace(/_{1,3}([^_]+)_{1,3}/g, "$1");
+        return applyTransform(stripped, toBold);
+    });
+    // 7. Bold italic: ***text*** or ___text___ (multiline with [\s\S])
+    result = result.replace(/\*{3}([\s\S]+?)\*{3}/g, (_m, inner) => applyTransform(inner, toBoldItalic));
+    result = result.replace(/_{3}([\s\S]+?)_{3}/g, (_m, inner) => applyTransform(inner, toBoldItalic));
+    // 8. Bold: **text** or __text__ (multiline with [\s\S])
+    result = result.replace(/\*{2}([\s\S]+?)\*{2}/g, (_m, inner) => applyTransform(inner, toBold));
+    result = result.replace(/_{2}([\s\S]+?)_{2}/g, (_m, inner) => applyTransform(inner, toBold));
+    // 9. Italic: *text* or _text_ (but not inside words for _)
+    // Use [^*\n] to avoid matching list markers like "* item *"
+    result = result.replace(/(?<!\w)\*([^*\n]+?)\*(?!\w)/g, (_m, inner) => applyTransform(inner, toItalic));
+    result = result.replace(/(?<!\w)_([^_\n]+?)_(?!\w)/g, (_m, inner) => applyTransform(inner, toItalic));
+    // 10. Strikethrough: ~~text~~ → just remove markers
+    result = result.replace(/~~([\s\S]+?)~~/g, "$1");
+    // 11. Task lists (must come before unordered list handling)
+    result = result.replace(/^([ \t]*)-\s+\[x\]\s+/gm, "$1\u2611 ");
+    result = result.replace(/^([ \t]*)-\s+\[ \]\s+/gm, "$1\u2610 ");
+    // 12. Unordered list: - item or * item → • item
+    result = result.replace(/^[ \t]*[-*]\s+/gm, "• ");
+    // 13. Blockquotes: > text → ┃ text
+    result = result.replace(/^>\s?/gm, "┃ ");
+    // 14. Horizontal rules
+    result = result.replace(/^[-*_]{3,}$/gm, "─────────");
+    // 15. Restore code blocks with visual markers
+    result = result.replace(/\x00CB(\d+)\x00/g, (_m, idx) => {
+        const code = codeBlocks[Number(idx)] ?? "";
+        return `\n━━━ code ━━━\n${code}\n━━━━━━━━━━━━\n`;
+    });
+    // 16. Restore inline code with backtick markers
+    result = result.replace(/\x00IC(\d+)\x00/g, (_m, idx) => `\`${inlineCodes[Number(idx)] ?? ""}\``);
+    // 17. Restore escape characters
+    result = result.replace(/\x00ES(\d+)\x00/g, (_m, idx) => escapes[Number(idx)] ?? "");
+    return result;
+}
+//# sourceMappingURL=unicode-format.js.map

package/dist/unicode-format.js.map

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

package/dist/webhook.d.ts

@@ -0,0 +1,22 @@
+/**
+ * HTTP webhook handler for WeChat KF callbacks
+ *
+ * Handles:
+ * - GET: URL verification (echostr decrypt)
+ * - POST: Event notification (decrypt XML → trigger sync_msg)
+ *
+ * Designed to be registered on the framework's shared gateway server
+ * via api.registerHttpRoute({ path, handler: handleWechatKfWebhook }).
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+export declare function parseQuery(url: string): Record<string, string>;
+export declare function readBody(req: IncomingMessage, maxSize?: number): Promise<string>;
+/** Extract a tag value from XML string */
+export declare function xmlTag(xml: string, tag: string): string | undefined;
+/**
+ * Framework-compatible HTTP handler for WeChat KF webhooks.
+ *
+ * Returns `true` if the request was handled, `false` if the path doesn't
+ * match (so the framework can try other plugins).
+ */
+export declare function handleWechatKfWebhook(req: IncomingMessage, res: ServerResponse): Promise<boolean>;

package/dist/webhook.js

@@ -0,0 +1,148 @@
+/**
+ * HTTP webhook handler for WeChat KF callbacks
+ *
+ * Handles:
+ * - GET: URL verification (echostr decrypt)
+ * - POST: Event notification (decrypt XML → trigger sync_msg)
+ *
+ * Designed to be registered on the framework's shared gateway server
+ * via api.registerHttpRoute({ path, handler: handleWechatKfWebhook }).
+ */
+import { registerKfId } from "./accounts.js";
+import { handleWebhookEvent } from "./bot.js";
+import { formatError, logTag } from "./constants.js";
+import { decrypt, verifySignature } from "./crypto.js";
+import { getSharedContext } from "./monitor.js";
+export function parseQuery(url) {
+    const idx = url.indexOf("?");
+    if (idx < 0)
+        return {};
+    const params = {};
+    for (const pair of url.slice(idx + 1).split("&")) {
+        const eqIdx = pair.indexOf("=");
+        if (eqIdx < 0)
+            continue;
+        const k = pair.slice(0, eqIdx);
+        const v = pair.slice(eqIdx + 1);
+        if (k)
+            params[decodeURIComponent(k)] = decodeURIComponent(v);
+    }
+    return params;
+}
+export function readBody(req, maxSize = 64 * 1024) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        let rejected = false;
+        req.on("data", (c) => {
+            if (rejected)
+                return;
+            size += c.length;
+            if (size > maxSize) {
+                rejected = true;
+                req.removeAllListeners("data");
+                req.resume();
+                reject(new Error(`${logTag()} request body too large`));
+                return;
+            }
+            chunks.push(c);
+        });
+        req.on("end", () => {
+            if (!rejected)
+                resolve(Buffer.concat(chunks).toString("utf8"));
+        });
+        req.on("error", (err) => {
+            if (!rejected)
+                reject(err);
+        });
+    });
+}
+/** Extract a tag value from XML string */
+export function xmlTag(xml, tag) {
+    const re = new RegExp(`<${tag}><!\\[CDATA\\[(.+?)\\]\\]></${tag}>|<${tag}>(.+?)</${tag}>`);
+    const m = xml.match(re);
+    return m?.[1] ?? m?.[2];
+}
+/**
+ * Framework-compatible HTTP handler for WeChat KF webhooks.
+ *
+ * Returns `true` if the request was handled, `false` if the path doesn't
+ * match (so the framework can try other plugins).
+ */
+export async function handleWechatKfWebhook(req, res) {
+    const ctx = getSharedContext();
+    if (!ctx)
+        return false;
+    const url = req.url ?? "/";
+    const pathname = url.split("?")[0];
+    if (pathname !== ctx.webhookPath)
+        return false;
+    const query = parseQuery(url);
+    try {
+        if (req.method === "GET") {
+            const { msg_signature, timestamp, nonce, echostr } = query;
+            if (!msg_signature || !timestamp || !nonce || !echostr) {
+                res.writeHead(400);
+                res.end("missing params");
+                return true;
+            }
+            if (!verifySignature(ctx.callbackToken, timestamp, nonce, echostr, msg_signature)) {
+                ctx.botCtx.log?.warn(`${logTag()} callback signature verification failed (GET)`);
+                res.writeHead(403);
+                res.end("signature mismatch");
+                return true;
+            }
+            const { message } = decrypt(ctx.encodingAESKey, echostr);
+            res.writeHead(200, { "Content-Type": "text/plain" });
+            res.end(message);
+            return true;
+        }
+        if (req.method === "POST") {
+            const { msg_signature, timestamp, nonce } = query;
+            const body = await readBody(req);
+            const encryptedMsg = xmlTag(body, "Encrypt");
+            if (!encryptedMsg || !msg_signature || !timestamp || !nonce) {
+                res.writeHead(400);
+                res.end("bad request");
+                return true;
+            }
+            if (!verifySignature(ctx.callbackToken, timestamp, nonce, encryptedMsg, msg_signature)) {
+                ctx.botCtx.log?.warn(`${logTag()} callback signature verification failed (POST)`);
+                res.writeHead(403);
+                res.end("signature mismatch");
+                return true;
+            }
+            const { message } = decrypt(ctx.encodingAESKey, encryptedMsg);
+            const eventToken = xmlTag(message, "Token") ?? "";
+            const openKfId = xmlTag(message, "OpenKfId") ?? "";
+            res.writeHead(200, { "Content-Type": "text/plain" });
+            res.end("success");
+            Promise.resolve((async () => {
+                if (openKfId) {
+                    await registerKfId(openKfId);
+                }
+                await handleWebhookEvent(ctx.botCtx, openKfId, eventToken);
+            })()).catch((err) => {
+                ctx.botCtx.log?.error(`${logTag()} webhook event processing error: ${formatError(err)}`);
+            });
+            return true;
+        }
+        res.writeHead(405);
+        res.end("method not allowed");
+        return true;
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes("body too large")) {
+            res.writeHead(413);
+            res.end("payload too large");
+            return true;
+        }
+        ctx.botCtx.log?.error(`${logTag()} webhook error: ${formatError(err)}`);
+        if (!res.headersSent) {
+            res.writeHead(500);
+            res.end("internal error");
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=webhook.js.map

package/dist/webhook.js.map

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