mozi-bot 1.1.2 → 1.2.0

package/dist/channels/wecom/api.js

@@ -0,0 +1,98 @@
+/**
+ * 企业微信 API 客户端
+ * 基于企业微信服务端 API
+ */
+import axios from "axios";
+import { getChildLogger } from "../../utils/logger.js";
+const logger = getChildLogger("wecom-api");
+/** 企业微信 API 基础地址 */
+const WECOM_API_BASE = "https://qyapi.weixin.qq.com/cgi-bin";
+export class WeComApiClient {
+    config;
+    client;
+    tokenCache = null;
+    constructor(config) {
+        this.config = config;
+        this.client = axios.create({
+            baseURL: WECOM_API_BASE,
+            timeout: 30000,
+            headers: {
+                "Content-Type": "application/json",
+            },
+        });
+    }
+    /** 获取 Access Token */
+    async getAccessToken() {
+        // 检查缓存
+        if (this.tokenCache && this.tokenCache.expiresAt > Date.now() + 60000) {
+            return this.tokenCache.accessToken;
+        }
+        try {
+            const response = await this.client.get("/gettoken", {
+                params: {
+                    corpid: this.config.corpId,
+                    corpsecret: this.config.corpSecret,
+                },
+            });
+            const { access_token, expires_in, errcode, errmsg } = response.data;
+            if (errcode && errcode !== 0) {
+                throw new Error(`WeCom API error: ${errcode} - ${errmsg}`);
+            }
+            this.tokenCache = {
+                accessToken: access_token,
+                expiresAt: Date.now() + expires_in * 1000,
+            };
+            logger.debug("Access token refreshed");
+            return access_token;
+        }
+        catch (error) {
+            logger.error({ error }, "Failed to get access token");
+            throw error;
+        }
+    }
+    /** 发送应用消息 (文本) */
+    async sendTextMessage(userId, content) {
+        const token = await this.getAccessToken();
+        const data = {
+            touser: userId,
+            msgtype: "text",
+            agentid: this.config.agentId,
+            text: {
+                content,
+            },
+        };
+        const response = await this.client.post(`/message/send?access_token=${token}`, data);
+        if (response.data.errcode !== 0) {
+            throw new Error(`WeCom send error: ${response.data.errcode} - ${response.data.errmsg}`);
+        }
+        logger.debug({ userId, msgid: response.data.msgid }, "Text message sent");
+        return response.data;
+    }
+    /** 发送群聊消息 */
+    async sendGroupTextMessage(chatId, content) {
+        const token = await this.getAccessToken();
+        const data = {
+            chatid: chatId,
+            msgtype: "text",
+            text: {
+                content,
+            },
+        };
+        const response = await this.client.post(`/appchat/send?access_token=${token}`, data);
+        if (response.data.errcode !== 0) {
+            throw new Error(`WeCom group send error: ${response.data.errcode} - ${response.data.errmsg}`);
+        }
+        logger.debug({ chatId }, "Group text message sent");
+        return response.data;
+    }
+    /** 获取用户信息 */
+    async getUserInfo(userId) {
+        const token = await this.getAccessToken();
+        const response = await this.client.get(`/user/get?access_token=${token}&userid=${userId}`);
+        if (response.data.errcode !== 0) {
+            throw new Error(`WeCom get user error: ${response.data.errcode} - ${response.data.errmsg}`);
+        }
+        return response.data;
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/channels/wecom/api.js.map

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

package/dist/channels/wecom/crypto.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 企业微信消息加解密工具
+ * 实现 AES-256-CBC 加解密和签名验证
+ */
+export declare class WeComCrypto {
+    private token;
+    private encodingAESKey;
+    private corpId;
+    private aesKey;
+    constructor(token: string, encodingAESKey: string, corpId: string);
+    /** 验证签名 */
+    verifySignature(msgSignature: string, timestamp: string, nonce: string, echostr: string): boolean;
+    /** 生成签名 */
+    getSignature(timestamp: string, nonce: string, encryptedMsg: string): string;
+    /** 解密消息 */
+    decrypt(encrypted: string): {
+        message: string;
+        corpId: string;
+    };
+    /** 加密消息 */
+    encrypt(message: string): string;
+    /** 解密回调验证的 echostr */
+    decryptEchoStr(echostr: string): string;
+}
+//# sourceMappingURL=crypto.d.ts.map

package/dist/channels/wecom/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../../src/channels/wecom/crypto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;gBAEX,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAOjE,WAAW;IACX,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAKjG,WAAW;IACX,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAO5E,WAAW;IACX,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAyB/D,WAAW;IACX,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAuBhC,sBAAsB;IACtB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAIxC"}

package/dist/channels/wecom/crypto.js

@@ -0,0 +1,74 @@
+/**
+ * 企业微信消息加解密工具
+ * 实现 AES-256-CBC 加解密和签名验证
+ */
+import crypto from "crypto";
+export class WeComCrypto {
+    token;
+    encodingAESKey;
+    corpId;
+    aesKey;
+    constructor(token, encodingAESKey, corpId) {
+        this.token = token;
+        this.encodingAESKey = encodingAESKey;
+        this.corpId = corpId;
+        this.aesKey = Buffer.from(encodingAESKey + "=", "base64");
+    }
+    /** 验证签名 */
+    verifySignature(msgSignature, timestamp, nonce, echostr) {
+        const signature = this.getSignature(timestamp, nonce, echostr);
+        return signature === msgSignature;
+    }
+    /** 生成签名 */
+    getSignature(timestamp, nonce, encryptedMsg) {
+        const arr = [this.token, timestamp, nonce, encryptedMsg].sort();
+        const sha1 = crypto.createHash("sha1");
+        sha1.update(arr.join(""));
+        return sha1.digest("hex");
+    }
+    /** 解密消息 */
+    decrypt(encrypted) {
+        const iv = this.aesKey.subarray(0, 16);
+        const decipher = crypto.createDecipheriv("aes-256-cbc", this.aesKey, iv);
+        decipher.setAutoPadding(false);
+        let decrypted = Buffer.concat([
+            decipher.update(encrypted, "base64"),
+            decipher.final(),
+        ]);
+        // PKCS#7 去填充
+        const pad = decrypted[decrypted.length - 1] ?? 0;
+        decrypted = decrypted.subarray(0, decrypted.length - pad);
+        // 去掉前 16 字节随机数
+        const content = decrypted.subarray(16);
+        // 读取消息长度 (4 字节 big-endian)
+        const msgLen = content.readUInt32BE(0);
+        const message = content.subarray(4, 4 + msgLen).toString("utf-8");
+        const corpId = content.subarray(4 + msgLen).toString("utf-8");
+        return { message, corpId };
+    }
+    /** 加密消息 */
+    encrypt(message) {
+        const randomBytes = crypto.randomBytes(16);
+        const msgBuf = Buffer.from(message, "utf-8");
+        const msgLenBuf = Buffer.alloc(4);
+        msgLenBuf.writeUInt32BE(msgBuf.length, 0);
+        const corpIdBuf = Buffer.from(this.corpId, "utf-8");
+        let plainBuf = Buffer.concat([randomBytes, msgLenBuf, msgBuf, corpIdBuf]);
+        // PKCS#7 填充
+        const blockSize = 32;
+        const padLen = blockSize - (plainBuf.length % blockSize);
+        const padBuf = Buffer.alloc(padLen, padLen);
+        plainBuf = Buffer.concat([plainBuf, padBuf]);
+        const iv = this.aesKey.subarray(0, 16);
+        const cipher = crypto.createCipheriv("aes-256-cbc", this.aesKey, iv);
+        cipher.setAutoPadding(false);
+        const encrypted = Buffer.concat([cipher.update(plainBuf), cipher.final()]);
+        return encrypted.toString("base64");
+    }
+    /** 解密回调验证的 echostr */
+    decryptEchoStr(echostr) {
+        const { message } = this.decrypt(echostr);
+        return message;
+    }
+}
+//# sourceMappingURL=crypto.js.map

package/dist/channels/wecom/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../../src/channels/wecom/crypto.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,OAAO,WAAW;IACd,KAAK,CAAS;IACd,cAAc,CAAS;IACvB,MAAM,CAAS;IACf,MAAM,CAAS;IAEvB,YAAY,KAAa,EAAE,cAAsB,EAAE,MAAc;QAC/D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,GAAG,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,WAAW;IACX,eAAe,CAAC,YAAoB,EAAE,SAAiB,EAAE,KAAa,EAAE,OAAe;QACrF,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/D,OAAO,SAAS,KAAK,YAAY,CAAC;IACpC,CAAC;IAED,WAAW;IACX,YAAY,CAAC,SAAiB,EAAE,KAAa,EAAE,YAAoB;QACjE,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,WAAW;IACX,OAAO,CAAC,SAAiB;QACvB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzE,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE/B,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;YAC5B,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC;YACpC,QAAQ,CAAC,KAAK,EAAE;SACjB,CAAC,CAAC;QAEH,aAAa;QACb,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QACjD,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAE1D,eAAe;QACf,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAEvC,2BAA2B;QAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE9D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;IAED,WAAW;IACX,OAAO,CAAC,OAAe;QACrB,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClC,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEpD,IAAI,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;QAE1E,YAAY;QACZ,MAAM,SAAS,GAAG,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,SAAS,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QAE7C,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACrE,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE7B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3E,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,sBAAsB;IACtB,cAAc,CAAC,OAAe;QAC5B,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/channels/wecom/events.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 企业微信事件处理
+ * 处理回调消息和事件
+ */
+import type { InboundMessageContext, WeComConfig } from "../../types/index.js";
+/** 企业微信回调消息 */
+export interface WeComCallbackMessage {
+    ToUserName: string;
+    FromUserName: string;
+    CreateTime: number;
+    MsgType: string;
+    Content?: string;
+    MsgId?: string;
+    AgentID?: number;
+    Event?: string;
+    EventKey?: string;
+    ChatId?: string;
+}
+export declare class WeComEventHandler {
+    private config;
+    private crypto;
+    constructor(config: WeComConfig);
+    /** 验证回调 URL */
+    verifyUrl(msgSignature: string, timestamp: string, nonce: string, echostr: string): string | null;
+    /** 解析回调消息 */
+    parseMessage(msgSignature: string, timestamp: string, nonce: string, encryptedXml: string): WeComCallbackMessage | null;
+    /** 解析 XML 为消息对象 */
+    private parseXml;
+    /** 转换为统一消息上下文 */
+    convertToMessageContext(message: WeComCallbackMessage): InboundMessageContext | null;
+    /** 生成回复消息 XML */
+    generateReplyXml(toUser: string, fromUser: string, content: string, timestamp: number): string;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/channels/wecom/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/channels/wecom/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAM/E,eAAe;AACf,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,EAAE,WAAW;IAO/B,eAAe;IACf,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAcjG,aAAa;IACb,YAAY,CACV,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,GACnB,oBAAoB,GAAG,IAAI;IAgC9B,mBAAmB;IACnB,OAAO,CAAC,QAAQ;IAsBhB,iBAAiB;IACjB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,qBAAqB,GAAG,IAAI;IA6BpF,iBAAiB;IACjB,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM;CAwBV"}

package/dist/channels/wecom/events.js

@@ -0,0 +1,127 @@
+/**
+ * 企业微信事件处理
+ * 处理回调消息和事件
+ */
+import { WeComCrypto } from "./crypto.js";
+import { getChildLogger } from "../../utils/logger.js";
+const logger = getChildLogger("wecom-events");
+export class WeComEventHandler {
+    config;
+    crypto = null;
+    constructor(config) {
+        this.config = config;
+        if (config.token && config.encodingAESKey) {
+            this.crypto = new WeComCrypto(config.token, config.encodingAESKey, config.corpId);
+        }
+    }
+    /** 验证回调 URL */
+    verifyUrl(msgSignature, timestamp, nonce, echostr) {
+        if (!this.crypto) {
+            logger.warn("Crypto not configured, skipping verification");
+            return null;
+        }
+        if (!this.crypto.verifySignature(msgSignature, timestamp, nonce, echostr)) {
+            logger.warn("Invalid signature for URL verification");
+            return null;
+        }
+        return this.crypto.decryptEchoStr(echostr);
+    }
+    /** 解析回调消息 */
+    parseMessage(msgSignature, timestamp, nonce, encryptedXml) {
+        if (!this.crypto) {
+            logger.warn("Crypto not configured, cannot parse message");
+            return null;
+        }
+        // 从 XML 中提取加密内容
+        const encryptMatch = encryptedXml.match(/<Encrypt><!\[CDATA\[(.*?)\]\]><\/Encrypt>/);
+        if (!encryptMatch) {
+            logger.warn("No Encrypt field in XML");
+            return null;
+        }
+        const encrypted = encryptMatch[1];
+        if (!encrypted) {
+            logger.warn("Empty Encrypt field in XML");
+            return null;
+        }
+        // 验证签名
+        if (!this.crypto.verifySignature(msgSignature, timestamp, nonce, encrypted)) {
+            logger.warn("Invalid signature for message");
+            return null;
+        }
+        // 解密消息
+        const { message } = this.crypto.decrypt(encrypted);
+        // 解析 XML
+        return this.parseXml(message);
+    }
+    /** 解析 XML 为消息对象 */
+    parseXml(xml) {
+        const getValue = (tag) => {
+            const match = xml.match(new RegExp(`<${tag}><!\[CDATA\[(.*?)\]\]><\/${tag}>`));
+            if (match)
+                return match[1];
+            const numMatch = xml.match(new RegExp(`<${tag}>(\\d+)<\/${tag}>`));
+            return numMatch ? numMatch[1] : undefined;
+        };
+        return {
+            ToUserName: getValue("ToUserName") || "",
+            FromUserName: getValue("FromUserName") || "",
+            CreateTime: parseInt(getValue("CreateTime") || "0", 10),
+            MsgType: getValue("MsgType") || "",
+            Content: getValue("Content"),
+            MsgId: getValue("MsgId"),
+            AgentID: getValue("AgentID") ? parseInt(getValue("AgentID"), 10) : undefined,
+            Event: getValue("Event"),
+            EventKey: getValue("EventKey"),
+            ChatId: getValue("ChatId"),
+        };
+    }
+    /** 转换为统一消息上下文 */
+    convertToMessageContext(message) {
+        // 只处理文本消息
+        if (message.MsgType !== "text") {
+            logger.debug({ msgType: message.MsgType }, "Ignoring non-text message");
+            return null;
+        }
+        if (!message.Content) {
+            logger.debug("Empty content, ignoring");
+            return null;
+        }
+        // 判断是私聊还是群聊
+        const chatType = message.ChatId ? "group" : "direct";
+        const chatId = message.ChatId || `direct:${message.FromUserName}`;
+        return {
+            channelId: "wecom",
+            messageId: message.MsgId || `${message.CreateTime}`,
+            chatId,
+            chatType,
+            senderId: message.FromUserName,
+            senderName: undefined, // 需要额外调用 API 获取用户名
+            content: message.Content,
+            timestamp: message.CreateTime * 1000,
+            raw: message,
+        };
+    }
+    /** 生成回复消息 XML */
+    generateReplyXml(toUser, fromUser, content, timestamp) {
+        const xml = `<xml>
+<ToUserName><![CDATA[${toUser}]]></ToUserName>
+<FromUserName><![CDATA[${fromUser}]]></FromUserName>
+<CreateTime>${timestamp}</CreateTime>
+<MsgType><![CDATA[text]]></MsgType>
+<Content><![CDATA[${content}]]></Content>
+</xml>`;
+        if (this.crypto) {
+            const encrypted = this.crypto.encrypt(xml);
+            const nonce = Math.random().toString(36).substring(2, 15);
+            const signature = this.crypto.getSignature(String(timestamp), nonce, encrypted);
+            return `<xml>
+<Encrypt><![CDATA[${encrypted}]]></Encrypt>
+<MsgSignature><![CDATA[${signature}]]></MsgSignature>
+<TimeStamp>${timestamp}</TimeStamp>
+<Nonce><![CDATA[${nonce}]]></Nonce>
+</xml>`;
+        }
+        return xml;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/channels/wecom/events.js.map

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

package/dist/channels/wecom/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 企业微信通道适配器
+ *
+ * 使用 HTTP 回调模式，需要公网部署
+ */
+import { Router, type Request, type Response } from "express";
+import type { WeComConfig, ChannelMeta, OutboundMessage, SendResult } from "../../types/index.js";
+import { BaseChannelAdapter } from "../common/base.js";
+import { WeComApiClient } from "./api.js";
+export declare class WeComChannel extends BaseChannelAdapter {
+    readonly id: "wecom";
+    readonly meta: ChannelMeta;
+    private config;
+    private apiClient;
+    private eventHandler;
+    private initialized;
+    constructor(config: WeComConfig);
+    /** 初始化通道 */
+    initialize(): Promise<void>;
+    /** 关闭通道 */
+    shutdown(): Promise<void>;
+    /** 发送消息 */
+    sendMessage(message: OutboundMessage): Promise<SendResult>;
+    /** 发送文本消息 */
+    sendText(chatId: string, text: string, _replyToId?: string): Promise<SendResult>;
+    /** 检查通道状态 */
+    isHealthy(): Promise<boolean>;
+    /** 创建 Express 路由处理器 */
+    createRouter(): Router;
+    /** 处理 URL 验证 */
+    private handleUrlVerification;
+    /** 处理 Webhook 请求 */
+    handleWebhook(req: Request, res: Response): Promise<void>;
+    /** 获取 API 客户端 */
+    getApiClient(): WeComApiClient;
+}
+/** 创建企业微信通道 */
+export declare function createWeComChannel(config: WeComConfig): WeComChannel;
+//# sourceMappingURL=index.d.ts.map

package/dist/channels/wecom/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/wecom/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,eAAe,EACf,UAAU,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAqB1C,qBAAa,YAAa,SAAQ,kBAAkB;IAClD,QAAQ,CAAC,EAAE,EAAG,OAAO,CAAU;IAC/B,QAAQ,CAAC,IAAI,cAAc;IAE3B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,WAAW;IAQ/B,YAAY;IACN,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BjC,WAAW;IACL,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B,WAAW;IACL,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAsBhE,aAAa;IACP,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAItF,aAAa;IACP,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IASnC,uBAAuB;IACvB,YAAY,IAAI,MAAM;IAmBtB,gBAAgB;IAChB,OAAO,CAAC,qBAAqB;IAyB7B,oBAAoB;IACd,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA8C/D,iBAAiB;IACjB,YAAY,IAAI,cAAc;CAG/B;AAED,eAAe;AACf,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAEpE"}

package/dist/channels/wecom/index.js

@@ -0,0 +1,184 @@
+/**
+ * 企业微信通道适配器
+ *
+ * 使用 HTTP 回调模式，需要公网部署
+ */
+import { Router } from "express";
+import { BaseChannelAdapter } from "../common/base.js";
+import { WeComApiClient } from "./api.js";
+import { WeComEventHandler } from "./events.js";
+import { getChildLogger } from "../../utils/logger.js";
+/** 企业微信通道元数据 */
+const WECOM_META = {
+    id: "wecom",
+    name: "企业微信",
+    description: "企业微信自建应用机器人",
+    capabilities: {
+        chatTypes: ["direct", "group"],
+        supportsMedia: true,
+        supportsReply: false, // 企业微信不支持回复特定消息
+        supportsMention: true,
+        supportsReaction: false,
+        supportsThread: false,
+        supportsEdit: false,
+        maxMessageLength: 2048,
+    },
+};
+export class WeComChannel extends BaseChannelAdapter {
+    id = "wecom";
+    meta = WECOM_META;
+    config;
+    apiClient;
+    eventHandler;
+    initialized = false;
+    constructor(config) {
+        super();
+        this.config = config;
+        this.apiClient = new WeComApiClient(config);
+        this.eventHandler = new WeComEventHandler(config);
+        this.logger = getChildLogger("wecom");
+    }
+    /** 初始化通道 */
+    async initialize() {
+        if (this.initialized)
+            return;
+        this.logger.info("Initializing WeCom channel");
+        // 验证配置
+        if (!this.config.corpId || !this.config.corpSecret) {
+            throw new Error("WeCom corpId and corpSecret are required");
+        }
+        if (!this.config.agentId) {
+            throw new Error("WeCom agentId is required");
+        }
+        // 测试获取 token
+        try {
+            await this.apiClient.getAccessToken();
+            this.logger.info("Successfully authenticated with WeCom");
+        }
+        catch (error) {
+            this.logger.error({ error }, "Failed to authenticate with WeCom");
+            throw error;
+        }
+        this.initialized = true;
+    }
+    /** 关闭通道 */
+    async shutdown() {
+        this.logger.info("Shutting down WeCom channel");
+        this.initialized = false;
+    }
+    /** 发送消息 */
+    async sendMessage(message) {
+        try {
+            const { chatId, content } = message;
+            // 根据 chatId 前缀判断消息类型
+            if (chatId.startsWith("direct:")) {
+                // 私聊消息
+                const userId = chatId.replace("direct:", "");
+                await this.apiClient.sendTextMessage(userId, content);
+            }
+            else {
+                // 群聊消息
+                await this.apiClient.sendGroupTextMessage(chatId, content);
+            }
+            return { success: true };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error({ error, message }, "Failed to send message");
+            return { success: false, error: errorMessage };
+        }
+    }
+    /** 发送文本消息 */
+    async sendText(chatId, text, _replyToId) {
+        return this.sendMessage({ chatId, content: text });
+    }
+    /** 检查通道状态 */
+    async isHealthy() {
+        try {
+            await this.apiClient.getAccessToken();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** 创建 Express 路由处理器 */
+    createRouter() {
+        const router = Router();
+        // URL 验证 (GET 请求)
+        router.get("/webhook", (req, res) => {
+            this.handleUrlVerification(req, res);
+        });
+        // 消息回调 (POST 请求)
+        router.post("/webhook", (req, res) => {
+            this.handleWebhook(req, res).catch((error) => {
+                this.logger.error({ error }, "Webhook handler error");
+                res.status(500).send("Internal server error");
+            });
+        });
+        return router;
+    }
+    /** 处理 URL 验证 */
+    handleUrlVerification(req, res) {
+        const { msg_signature, timestamp, nonce, echostr } = req.query;
+        if (!msg_signature || !timestamp || !nonce || !echostr) {
+            this.logger.warn("Missing verification parameters");
+            res.status(400).send("Missing parameters");
+            return;
+        }
+        const decrypted = this.eventHandler.verifyUrl(msg_signature, timestamp, nonce, echostr);
+        if (decrypted) {
+            this.logger.info("URL verification successful");
+            res.send(decrypted);
+        }
+        else {
+            this.logger.warn("URL verification failed");
+            res.status(403).send("Verification failed");
+        }
+    }
+    /** 处理 Webhook 请求 */
+    async handleWebhook(req, res) {
+        const { msg_signature, timestamp, nonce } = req.query;
+        if (!msg_signature || !timestamp || !nonce) {
+            this.logger.warn("Missing webhook parameters");
+            res.status(400).send("Missing parameters");
+            return;
+        }
+        // 获取原始 XML 内容
+        const rawBody = typeof req.body === "string" ? req.body : JSON.stringify(req.body);
+        try {
+            const message = this.eventHandler.parseMessage(msg_signature, timestamp, nonce, rawBody);
+            if (!message) {
+                // 返回空响应
+                res.send("success");
+                return;
+            }
+            this.logger.debug({ message }, "Received message");
+            // 转换并处理消息
+            const context = this.eventHandler.convertToMessageContext(message);
+            if (context) {
+                // 异步处理消息，先返回响应
+                res.send("success");
+                this.handleInboundMessage(context).catch((error) => {
+                    this.logger.error({ error, context }, "Failed to handle message");
+                });
+            }
+            else {
+                res.send("success");
+            }
+        }
+        catch (error) {
+            this.logger.error({ error }, "Failed to parse message");
+            res.send("success"); // 企业微信要求返回成功，否则会重试
+        }
+    }
+    /** 获取 API 客户端 */
+    getApiClient() {
+        return this.apiClient;
+    }
+}
+/** 创建企业微信通道 */
+export function createWeComChannel(config) {
+    return new WeComChannel(config);
+}
+//# sourceMappingURL=index.js.map

package/dist/channels/wecom/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/channels/wecom/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAA+B,MAAM,SAAS,CAAC;AAO9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,gBAAgB;AAChB,MAAM,UAAU,GAAgB;IAC9B,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE;QACZ,SAAS,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC9B,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,KAAK,EAAE,gBAAgB;QACtC,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,KAAK;QACvB,cAAc,EAAE,KAAK;QACrB,YAAY,EAAE,KAAK;QACnB,gBAAgB,EAAE,IAAI;KACvB;CACF,CAAC;AAEF,MAAM,OAAO,YAAa,SAAQ,kBAAkB;IACzC,EAAE,GAAG,OAAgB,CAAC;IACtB,IAAI,GAAG,UAAU,CAAC;IAEnB,MAAM,CAAc;IACpB,SAAS,CAAiB;IAC1B,YAAY,CAAoB;IAChC,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAY,MAAmB;QAC7B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,YAAY;IACZ,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAE7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAE/C,OAAO;QACP,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,aAAa;QACb,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,mCAAmC,CAAC,CAAC;YAClE,MAAM,KAAK,CAAC;QACd,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,WAAW;IACX,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAChD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,WAAW;IACX,KAAK,CAAC,WAAW,CAAC,OAAwB;QACxC,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;YAEpC,qBAAqB;YACrB,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBACjC,OAAO;gBACP,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBAC7C,MAAM,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,OAAO;gBACP,MAAM,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC7D,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,wBAAwB,CAAC,CAAC;YAChE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QACjD,CAAC;IACH,CAAC;IAED,aAAa;IACb,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,IAAY,EAAE,UAAmB;QAC9D,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,aAAa;IACb,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,YAAY;QACV,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;QAExB,kBAAkB;QAClB,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;YACrD,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,iBAAiB;QACjB,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;YACtD,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,uBAAuB,CAAC,CAAC;gBACtD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,gBAAgB;IACR,qBAAqB,CAAC,GAAY,EAAE,GAAa;QACvD,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC;QAE/D,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;YACpD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS,CAC3C,aAAuB,EACvB,SAAmB,EACnB,KAAe,EACf,OAAiB,CAClB,CAAC;QAEF,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAChD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;YAC5C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,KAAK,CAAC,aAAa,CAAC,GAAY,EAAE,GAAa;QAC7C,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC;QAEtD,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAC/C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,cAAc;QACd,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEnF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAC5C,aAAuB,EACvB,SAAmB,EACnB,KAAe,EACf,OAAO,CACR,CAAC;YAEF,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,QAAQ;gBACR,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACpB,OAAO;YACT,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAEnD,UAAU;YACV,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;YACnE,IAAI,OAAO,EAAE,CAAC;gBACZ,eAAe;gBACf,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAEpB,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBACjD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,0BAA0B,CAAC,CAAC;gBACpE,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,yBAAyB,CAAC,CAAC;YACxD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB;QAC1C,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF;AAED,eAAe;AACf,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}