@pawastation/wechat-kf 0.1.2 → 0.2.0

package/dist/src/types.d.ts

@@ -4,15 +4,10 @@ export type WechatKfConfig = {
     appSecret?: string;
     token?: string;
     encodingAESKey?: string;
-    webhookPort?: number;
     webhookPath?: string;
     dmPolicy?: "open" | "pairing" | "allowlist" | "disabled";
     allowFrom?: string[];
 };
-export type OpenClawConfig = {
-    channels?: Record<string, unknown>;
-    [key: string]: unknown;
-};
 export type ResolvedWechatKfAccount = {
     accountId: string;
     enabled: boolean;
@@ -22,7 +17,6 @@ export type ResolvedWechatKfAccount = {
     token?: string;
     encodingAESKey?: string;
     openKfId?: string;
-    webhookPort: number;
     webhookPath: string;
     config: WechatKfConfig;
 };
@@ -42,6 +36,8 @@ export type WechatKfSyncMsgRequest = {
 export type WechatKfMergedMsgItem = {
     sender_name?: string;
     msg_content?: string;
+    send_time?: number;
+    msgtype?: string;
 };
 export type WechatKfMessage = {
     msgid: string;
@@ -53,6 +49,7 @@ export type WechatKfMessage = {
     msgtype: string;
     text?: {
         content: string;
+        menu_id?: string;
     };
     image?: {
         media_id: string;
@@ -103,6 +100,7 @@ export type WechatKfMessage = {
         title?: string;
         appid?: string;
         pagepath?: string;
+        thumb_media_id?: string;
     };
     business_card?: {
         userid?: string;
@@ -115,6 +113,22 @@ export type WechatKfMessage = {
         }[];
         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;
@@ -149,6 +163,54 @@ export type WechatKfSendMsgRequest = {
         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;

package/dist/src/webhook.d.ts

@@ -1,22 +1,22 @@
 /**
- * HTTP webhook server for WeChat KF callbacks
+ * 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.registerHttpHandler(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).
  */
-import { type Server } from "node:http";
-export type WebhookHandler = (openKfId: string, token: string) => void | Promise<void>;
-export type WebhookOptions = {
-    port: number;
-    path: string;
-    callbackToken: string;
-    encodingAESKey: string;
-    corpId: string;
-    onEvent: WebhookHandler;
-    log?: {
-        info: (...a: unknown[]) => void;
-        error: (...a: unknown[]) => void;
-    };
-};
-export declare function createWebhookServer(opts: WebhookOptions): Server;
+export declare function handleWechatKfWebhook(req: IncomingMessage, res: ServerResponse): Promise<boolean>;

package/dist/src/webhook.js

@@ -1,13 +1,19 @@
 /**
- * HTTP webhook server for WeChat KF callbacks
+ * 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.registerHttpHandler(handleWechatKfWebhook).
  */
-import { createServer } from "node:http";
+import { registerKfId } from "./accounts.js";
+import { handleWebhookEvent } from "./bot.js";
+import { formatError, logTag } from "./constants.js";
 import { decrypt, verifySignature } from "./crypto.js";
-function parseQuery(url) {
+import { getSharedContext } from "./monitor.js";
+export function parseQuery(url) {
     const idx = url.indexOf("?");
     if (idx < 0)
         return {};
@@ -23,7 +29,7 @@ function parseQuery(url) {
     }
     return params;
 }
-function readBody(req, maxSize = 64 * 1024) {
+export function readBody(req, maxSize = 64 * 1024) {
     return new Promise((resolve, reject) => {
         const chunks = [];
         let size = 0;
@@ -38,7 +44,7 @@ function readBody(req, maxSize = 64 * 1024) {
                 // can still write a response (413). Resume drains remaining data.
                 req.removeAllListeners("data");
                 req.resume();
-                reject(new Error("[wechat-kf] request body too large"));
+                reject(new Error(`${logTag()} request body too large`));
                 return;
             }
             chunks.push(c);
@@ -54,85 +60,96 @@ function readBody(req, maxSize = 64 * 1024) {
     });
 }
 /** Extract a tag value from XML string */
-function xmlTag(xml, tag) {
+export function xmlTag(xml, tag) {
     const re = new RegExp(`<${tag}><!\\[CDATA\\[(.+?)\\]\\]></${tag}>|<${tag}>(.+?)</${tag}>`);
     const m = xml.match(re);
     return m?.[1] ?? m?.[2];
 }
-export function createWebhookServer(opts) {
-    const { path, callbackToken, encodingAESKey, onEvent, log } = opts;
-    const server = createServer(async (req, res) => {
-        const url = req.url ?? "/";
-        const pathname = url.split("?")[0];
-        if (pathname !== path) {
-            res.writeHead(404);
-            res.end("not found");
-            return;
-        }
-        const query = parseQuery(url);
-        try {
-            if (req.method === "GET") {
-                // URL verification
-                const { msg_signature, timestamp, nonce, echostr } = query;
-                if (!msg_signature || !timestamp || !nonce || !echostr) {
-                    res.writeHead(400);
-                    res.end("missing params");
-                    return;
-                }
-                if (!verifySignature(callbackToken, timestamp, nonce, echostr, msg_signature)) {
-                    res.writeHead(403);
-                    res.end("signature mismatch");
-                    return;
-                }
-                const { message } = decrypt(encodingAESKey, echostr);
-                res.writeHead(200, { "Content-Type": "text/plain" });
-                res.end(message);
-                return;
+/**
+ * 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") {
+            // URL verification
+            const { msg_signature, timestamp, nonce, echostr } = query;
+            if (!msg_signature || !timestamp || !nonce || !echostr) {
+                res.writeHead(400);
+                res.end("missing params");
+                return true;
             }
-            if (req.method === "POST") {
-                const { msg_signature, timestamp, nonce } = query;
-                const body = await readBody(req);
-                // Extract Encrypt from XML
-                const encryptedMsg = xmlTag(body, "Encrypt");
-                if (!encryptedMsg || !msg_signature || !timestamp || !nonce) {
-                    res.writeHead(400);
-                    res.end("bad request");
-                    return;
-                }
-                if (!verifySignature(callbackToken, timestamp, nonce, encryptedMsg, msg_signature)) {
-                    res.writeHead(403);
-                    res.end("signature mismatch");
-                    return;
-                }
-                const { message } = decrypt(encodingAESKey, encryptedMsg);
-                // Parse decrypted XML for Token and OpenKfId
-                const eventToken = xmlTag(message, "Token") ?? "";
-                const openKfId = xmlTag(message, "OpenKfId") ?? "";
-                // Respond immediately, process async
-                res.writeHead(200, { "Content-Type": "text/plain" });
-                res.end("success");
-                // Trigger message sync
-                Promise.resolve(onEvent(openKfId, eventToken)).catch((err) => {
-                    (log?.error ?? console.error)("[wechat-kf] onEvent error:", err);
-                });
-                return;
+            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;
             }
-            res.writeHead(405);
-            res.end("method not allowed");
+            const { message } = decrypt(ctx.encodingAESKey, echostr);
+            res.writeHead(200, { "Content-Type": "text/plain" });
+            res.end(message);
+            return true;
         }
-        catch (err) {
-            if (err instanceof Error && err.message.includes("body too large")) {
-                res.writeHead(413);
-                res.end("payload too large");
-                return;
+        if (req.method === "POST") {
+            const { msg_signature, timestamp, nonce } = query;
+            const body = await readBody(req);
+            // Extract Encrypt from XML
+            const encryptedMsg = xmlTag(body, "Encrypt");
+            if (!encryptedMsg || !msg_signature || !timestamp || !nonce) {
+                res.writeHead(400);
+                res.end("bad request");
+                return true;
             }
-            (log?.error ?? console.error)("[wechat-kf] webhook error:", err);
-            if (!res.headersSent) {
-                res.writeHead(500);
-                res.end("internal error");
+            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);
+            // Parse decrypted XML for Token and OpenKfId
+            const eventToken = xmlTag(message, "Token") ?? "";
+            const openKfId = xmlTag(message, "OpenKfId") ?? "";
+            // Respond immediately, process async
+            res.writeHead(200, { "Content-Type": "text/plain" });
+            res.end("success");
+            // Fire-and-forget: register kfId and trigger message sync
+            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;
         }
-    });
-    return server;
+        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/src/webhook.js.map

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

package/dist/src/wechat-kf-directives.d.ts

@@ -1,14 +1,17 @@
 /**
  * WeChat KF directive parser
  *
- * Parses [[wechat_link: title | desc | url | thumbUrl]] directives
- * embedded in agent text replies. The framework doesn't recognize these
- * directives, so the text arrives intact for plugin-level interception.
+ * Parses [[wechat_*: ...]] directives embedded in agent text replies.
+ * The framework doesn't recognize these directives, so the text arrives
+ * intact for plugin-level interception.
  *
- * Syntax (pipe-separated fields):
- *   [[wechat_link: title | url]]                      → 2 fields
- *   [[wechat_link: title | desc | url]]               → 3 fields
- *   [[wechat_link: title | desc | url | thumbUrl]]    → 4 fields
+ * Supported directives:
+ *   [[wechat_link: title | desc | url | thumbUrl]]
+ *   [[wechat_location: name | address | lat | lng]]
+ *   [[wechat_miniprogram: appid | title | pagepath | thumbUrl]]
+ *   [[wechat_menu: header | Option1, Option2, Option3 | footer]]
+ *   [[wechat_business_card: USERID]]
+ *   [[wechat_ca_link: https://work.weixin.qq.com/ca/...]]
  */
 export type WechatLinkDirective = {
     title: string;
@@ -16,12 +19,78 @@ export type WechatLinkDirective = {
     url: string;
     thumbUrl?: string;
 };
+export type WechatLocationDirective = {
+    name: string;
+    address?: string;
+    latitude: number;
+    longitude: number;
+};
+export type WechatMenuItemDirective = {
+    type: "click";
+    id?: string;
+    content: string;
+} | {
+    type: "view";
+    url: string;
+    content: string;
+} | {
+    type: "miniprogram";
+    appid: string;
+    pagepath: string;
+    content: string;
+} | {
+    type: "text";
+    content: string;
+    noNewline?: boolean;
+};
+export type WechatMenuDirective = {
+    headContent?: string;
+    items: WechatMenuItemDirective[];
+    tailContent?: string;
+};
+export type WechatMiniprogramDirective = {
+    appid: string;
+    title: string;
+    pagepath: string;
+    thumbUrl?: string;
+};
+export type WechatBusinessCardDirective = {
+    userid: string;
+};
+export type WechatCaLinkDirective = {
+    link_url: string;
+};
+export type WechatRawDirective = {
+    msgtype: string;
+    payload: Record<string, unknown>;
+};
 export type WechatDirectiveResult = {
     text: string;
     link?: WechatLinkDirective;
+    location?: WechatLocationDirective;
+    miniprogram?: WechatMiniprogramDirective;
+    menu?: WechatMenuDirective;
+    businessCard?: WechatBusinessCardDirective;
+    caLink?: WechatCaLinkDirective;
+    raw?: WechatRawDirective;
+};
+export type ProtectedRange = {
+    start: number;
+    end: number;
 };
 /**
- * Quick check whether text contains a `[[wechat_link:...]]` directive.
+ * Scan text left-to-right and collect ranges that should be treated as
+ * "protected" — i.e. directive syntax inside them must be ignored.
+ *
+ * Three zone types (checked in priority order):
+ *  1. Fenced code blocks (``` or ~~~, with optional 0-3 leading spaces + lang tag)
+ *  2. Inline code spans (backtick sequences, matching equal-length closer)
+ *  3. Blockquote lines (line starting with optional whitespace + `>`)
+ */
+export declare function findProtectedRanges(text: string): ProtectedRange[];
+/**
+ * Quick check whether text contains a `[[wechat_link:...]]` directive
+ * outside of markdown code blocks, inline code, and blockquotes.
  */
 export declare function hasWechatLinkDirective(text: string): boolean;
 /**
@@ -31,4 +100,58 @@ export declare function hasWechatLinkDirective(text: string): boolean;
  * plus the parsed link fields. If parsing fails (e.g. invalid URL),
  * returns the original text unchanged with no link.
  */
-export declare function parseWechatLinkDirective(text: string): WechatDirectiveResult;
+export declare function parseWechatLinkDirective(text: string, protectedRanges?: ProtectedRange[]): WechatDirectiveResult;
+export declare function parseWechatLocationDirective(text: string, protectedRanges?: ProtectedRange[]): WechatDirectiveResult;
+export declare function parseWechatMiniprogramDirective(text: string, protectedRanges?: ProtectedRange[]): WechatDirectiveResult;
+export declare function parseWechatMenuDirective(text: string, protectedRanges?: ProtectedRange[]): WechatDirectiveResult;
+/**
+ * Convert a parsed WechatMenuDirective into the API `msgmenu` payload.
+ *
+ * Click items get auto-incrementing IDs (only among click items that lack
+ * an explicit `id`). Explicit IDs are preserved as-is.
+ */
+export declare function buildMsgMenuPayload(menu: WechatMenuDirective): {
+    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;
+};
+export declare function parseWechatBusinessCardDirective(text: string, protectedRanges?: ProtectedRange[]): WechatDirectiveResult;
+export declare function parseWechatCaLinkDirective(text: string, protectedRanges?: ProtectedRange[]): WechatDirectiveResult;
+export declare function parseWechatRawDirective(text: string, protectedRanges?: ProtectedRange[]): WechatDirectiveResult;
+/**
+ * Quick check whether text contains any `[[wechat_*:...]]` directive
+ * outside of markdown code blocks, inline code, and blockquotes.
+ */
+export declare function hasWechatDirective(text: string): boolean;
+/**
+ * Parse the first matching directive from text.
+ * Tries parsers in order: link → location → miniprogram → menu → business_card → ca_link → raw.
+ * Returns the first successful parse result.
+ * Directives inside markdown code blocks, inline code, or blockquotes are ignored.
+ */
+export declare function parseWechatDirective(text: string): WechatDirectiveResult;