@xuanyue202/wechat-mp 2026.3.21

package/dist/src/crypto.test.js

@@ -0,0 +1,76 @@
+import { describe, expect, it } from "vitest";
+import { buildWechatMpXml, computeMsgSignature, computeSignature, decryptWechatMpMessage, encryptWechatMpMessage, parseWechatMpXml, verifyMsgSignature, verifySignature, } from "./crypto.js";
+const encodingAESKey = "abcdefghijklmnopqrstuvwxyz0123456789ABCDEFG";
+const appId = "wx-test-appid";
+describe("wechat-mp crypto", () => {
+    it("verifies callback signatures", () => {
+        const signature = computeSignature({
+            token: "callback-token",
+            timestamp: "1710000000",
+            nonce: "nonce-1",
+        });
+        expect(verifySignature({
+            token: "callback-token",
+            timestamp: "1710000000",
+            nonce: "nonce-1",
+            signature,
+        })).toBe(true);
+        expect(verifySignature({
+            token: "callback-token",
+            timestamp: "1710000000",
+            nonce: "nonce-1",
+            signature: "bad-signature",
+        })).toBe(false);
+    });
+    it("encrypts and decrypts safe-mode payloads", () => {
+        const plaintext = buildWechatMpXml({
+            ToUserName: appId,
+            FromUserName: "openid-1",
+            CreateTime: "1710000000",
+            MsgType: "text",
+            Content: "hello",
+            MsgId: "msg-1",
+        });
+        const encrypted = encryptWechatMpMessage({
+            encodingAESKey,
+            appId,
+            plaintext,
+        }).encrypt;
+        const decrypted = decryptWechatMpMessage({
+            encodingAESKey,
+            encrypt: encrypted,
+            expectedAppId: appId,
+        });
+        expect(decrypted.plaintext).toBe(plaintext);
+        expect(decrypted.appId).toBe(appId);
+    });
+    it("verifies msg_signature with encrypted payload", () => {
+        const signature = computeMsgSignature({
+            token: "callback-token",
+            timestamp: "1710000000",
+            nonce: "nonce-1",
+            encrypt: "encrypted-body",
+        });
+        expect(verifyMsgSignature({
+            token: "callback-token",
+            timestamp: "1710000000",
+            nonce: "nonce-1",
+            encrypt: "encrypted-body",
+            msgSignature: signature,
+        })).toBe(true);
+    });
+    it("parses xml bodies", () => {
+        const xml = buildWechatMpXml({
+            ToUserName: appId,
+            FromUserName: "openid-1",
+            MsgType: "text",
+            Content: "hello",
+            MsgId: "msg-1",
+        });
+        const parsed = parseWechatMpXml(xml);
+        expect(parsed.ToUserName).toBe(appId);
+        expect(parsed.FromUserName).toBe("openid-1");
+        expect(parsed.Content).toBe("hello");
+    });
+});
+//# sourceMappingURL=crypto.test.js.map

package/dist/src/crypto.test.js.map

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

package/dist/src/dispatch.d.ts

@@ -0,0 +1,15 @@
+import type { PluginConfig, PluginRuntime, ResolvedWechatMpAccount, WechatMpInboundCandidate } from "./types.js";
+export declare function dispatchWechatMpCandidate(params: {
+    cfg: PluginConfig;
+    account: ResolvedWechatMpAccount;
+    candidate: WechatMpInboundCandidate;
+    runtime: PluginRuntime;
+    onChunk?: (text: string) => Promise<void>;
+    log?: (message: string) => void;
+    error?: (message: string) => void;
+}): Promise<{
+    dispatched: boolean;
+    reason?: string;
+    combinedReply?: string;
+}>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/src/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/dispatch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AA4CpB,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,GAAG,EAAE,YAAY,CAAC;IAClB,OAAO,EAAE,uBAAuB,CAAC;IACjC,SAAS,EAAE,wBAAwB,CAAC;IACpC,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsK5E"}

package/dist/src/dispatch.js

@@ -0,0 +1,193 @@
+import { resolveAllowFrom } from "./config.js";
+import { updateAccountState } from "./state.js";
+import { normalizeWechatMpText, resolveRenderMarkdown } from "./text.js";
+function createLogger(opts) {
+    return {
+        info: (message) => (opts.log ?? console.log)(`[wechat-mp] ${message}`),
+        warn: (message) => (opts.log ?? console.log)(`[wechat-mp] [WARN] ${message}`),
+        error: (message) => (opts.error ?? console.error)(`[wechat-mp] [ERROR] ${message}`),
+    };
+}
+function isSenderAllowed(account, senderId) {
+    const policy = account.config.dmPolicy ?? "open";
+    if (policy === "disabled") {
+        return { allowed: false, reason: "dm disabled" };
+    }
+    if (policy === "allowlist") {
+        const allowFrom = resolveAllowFrom(account.config);
+        const allowed = allowFrom.includes(senderId.trim().toLowerCase());
+        return allowed ? { allowed: true } : { allowed: false, reason: "sender not in allowlist" };
+    }
+    if (policy === "pairing") {
+        const allowFrom = resolveAllowFrom(account.config);
+        if (allowFrom.length > 0 && !allowFrom.includes(senderId.trim().toLowerCase())) {
+            return { allowed: false, reason: "sender not paired" };
+        }
+    }
+    return { allowed: true };
+}
+function buildCandidateBody(candidate) {
+    if (candidate.msgType === "text") {
+        return String(candidate.content ?? "").trim();
+    }
+    const parts = [`[event:${candidate.event ?? "unknown"}]`];
+    if (candidate.eventKey) {
+        parts.push(`eventKey=${candidate.eventKey}`);
+    }
+    if (candidate.ticket) {
+        parts.push(`ticket=${candidate.ticket}`);
+    }
+    return parts.join("\n").trim();
+}
+export async function dispatchWechatMpCandidate(params) {
+    const logger = createLogger({ log: params.log, error: params.error });
+    const { candidate } = params;
+    if (!candidate.hasUserIntent) {
+        return { dispatched: false, reason: "non-intentful event" };
+    }
+    const bodyRaw = buildCandidateBody(candidate);
+    if (!bodyRaw) {
+        return { dispatched: false, reason: "empty inbound body" };
+    }
+    const policyResult = isSenderAllowed(params.account, candidate.openId);
+    if (!policyResult.allowed) {
+        logger.info(`skip sender=${candidate.openId} reason=${policyResult.reason ?? "policy rejected"}`);
+        return { dispatched: false, reason: policyResult.reason };
+    }
+    const channel = params.runtime.channel;
+    const resolveAgentRoute = channel?.routing?.resolveAgentRoute;
+    const dispatchReply = channel?.reply?.dispatchReplyWithBufferedBlockDispatcher;
+    if (!resolveAgentRoute || !dispatchReply) {
+        const message = "runtime routing or buffered reply dispatcher unavailable";
+        logger.warn(message);
+        await updateAccountState(params.account.accountId, { lastError: message });
+        return { dispatched: false, reason: message };
+    }
+    const route = resolveAgentRoute({
+        cfg: params.cfg,
+        channel: "wechat-mp",
+        accountId: params.account.accountId,
+        peer: { kind: "dm", id: candidate.openId },
+    });
+    const fromLabel = `user:${candidate.openId}`;
+    const from = `wechat-mp:${candidate.target}`;
+    const to = candidate.target;
+    const effectiveSessionKey = route.sessionKey;
+    const storePath = channel.session?.resolveStorePath?.(params.cfg.session?.store, {
+        agentId: route.agentId,
+    });
+    const previousTimestamp = storePath
+        ? channel.session?.readSessionUpdatedAt?.({
+            storePath,
+            sessionKey: effectiveSessionKey,
+        })
+        : null;
+    const envelopeOptions = channel.reply?.resolveEnvelopeFormatOptions?.(params.cfg);
+    const body = channel.reply?.formatAgentEnvelope
+        ? channel.reply.formatAgentEnvelope({
+            channel: "WeChat MP",
+            from: fromLabel,
+            previousTimestamp: previousTimestamp ?? undefined,
+            envelope: envelopeOptions,
+            body: bodyRaw,
+        })
+        : bodyRaw;
+    const ctxPayload = channel.reply?.finalizeInboundContext?.({
+        Body: body,
+        RawBody: bodyRaw,
+        CommandBody: bodyRaw,
+        From: from,
+        To: to,
+        SessionKey: effectiveSessionKey,
+        AccountId: route.accountId ?? params.account.accountId,
+        ChatType: "direct",
+        ConversationLabel: fromLabel,
+        SenderName: candidate.openId,
+        SenderId: candidate.openId,
+        Provider: "wechat-mp",
+        Surface: "wechat-mp",
+        MessageSid: candidate.msgId,
+        OriginatingChannel: "wechat-mp",
+        OriginatingTo: to,
+        EventName: candidate.event,
+        EventKey: candidate.eventKey,
+    }) ?? {
+        Body: body,
+        RawBody: bodyRaw,
+        CommandBody: bodyRaw,
+        From: from,
+        To: to,
+        SessionKey: effectiveSessionKey,
+        AccountId: route.accountId ?? params.account.accountId,
+        ChatType: "direct",
+        ConversationLabel: fromLabel,
+        SenderName: candidate.openId,
+        SenderId: candidate.openId,
+        Provider: "wechat-mp",
+        Surface: "wechat-mp",
+        MessageSid: candidate.msgId,
+        OriginatingChannel: "wechat-mp",
+        OriginatingTo: to,
+        EventName: candidate.event,
+        EventKey: candidate.eventKey,
+    };
+    ctxPayload.CommandAuthorized = true;
+    if (channel.session?.recordInboundSession && storePath) {
+        await channel.session.recordInboundSession({
+            storePath,
+            sessionKey: String(ctxPayload.SessionKey ?? effectiveSessionKey),
+            ctx: ctxPayload,
+            updateLastRoute: {
+                sessionKey: String((route.mainSessionKey ?? effectiveSessionKey) || effectiveSessionKey),
+                channel: "wechat-mp",
+                to,
+                accountId: route.accountId ?? params.account.accountId,
+            },
+            onRecordError: (error) => {
+                logger.error(`recordInboundSession failed: ${String(error)}`);
+            },
+        });
+    }
+    const convertTables = channel.text?.convertMarkdownTables && channel.text?.resolveMarkdownTableMode
+        ? (text) => channel.text.convertMarkdownTables(text, channel.text.resolveMarkdownTableMode({
+            cfg: params.cfg,
+            channel: "wechat-mp",
+            accountId: params.account.accountId,
+        }))
+        : (text) => text;
+    const renderMarkdown = resolveRenderMarkdown(params.account.config);
+    const responseChunks = [];
+    await dispatchReply({
+        ctx: ctxPayload,
+        cfg: params.cfg,
+        dispatcherOptions: {
+            deliver: async (payload) => {
+                const text = String(payload.text ?? "").trim();
+                if (!text)
+                    return;
+                const convertedText = convertTables(text);
+                if (!convertedText)
+                    return;
+                const normalizedText = normalizeWechatMpText(convertedText, renderMarkdown);
+                if (!normalizedText)
+                    return;
+                if (params.onChunk) {
+                    await params.onChunk(normalizedText);
+                    return;
+                }
+                responseChunks.push(normalizedText);
+            },
+            onError: (error, info) => {
+                logger.error(`${info.kind} reply failed: ${String(error)}`);
+            },
+        },
+    });
+    const combinedReply = params.onChunk ? "" : responseChunks.join("\n\n").trim();
+    if (combinedReply) {
+        await updateAccountState(params.account.accountId, {
+            lastOutboundAt: Date.now(),
+        });
+    }
+    return { dispatched: true, combinedReply };
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/src/dispatch.js.map

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

package/dist/src/dispatch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dispatch.test.d.ts.map

package/dist/src/dispatch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.test.d.ts","sourceRoot":"","sources":["../../src/dispatch.test.ts"],"names":[],"mappings":""}

package/dist/src/dispatch.test.js

@@ -0,0 +1,231 @@
+import { describe, expect, it, vi } from "vitest";
+import { dispatchWechatMpCandidate } from "./dispatch.js";
+function createAccount(overrides) {
+    return {
+        accountId: "default",
+        name: "WeChat MP (default)",
+        enabled: true,
+        configured: true,
+        canSendActive: true,
+        config: {
+            appId: "wx-test-appid",
+            appSecret: "secret",
+            token: "token",
+            encodingAESKey: "abcdefghijklmnopqrstuvwxyz0123456789ABCDEFG",
+            webhookPath: "/wechat-mp",
+            messageMode: "safe",
+            replyMode: "passive",
+            dmPolicy: "open",
+        },
+        ...overrides,
+    };
+}
+function createRuntime(replyTexts = ["reply text"]) {
+    const resolveAgentRoute = vi.fn(() => ({
+        sessionKey: "session-1",
+        accountId: "default",
+        agentId: "agent-1",
+    }));
+    const dispatchReplyWithBufferedBlockDispatcher = vi.fn(async (params) => {
+        for (const text of replyTexts) {
+            await params.dispatcherOptions.deliver({ text });
+        }
+    });
+    const recordInboundSession = vi.fn(async () => undefined);
+    const readSessionUpdatedAt = vi.fn(() => null);
+    const resolveStorePath = vi.fn(() => "/tmp/session-store");
+    const runtime = {
+        channel: {
+            routing: { resolveAgentRoute },
+            reply: {
+                dispatchReplyWithBufferedBlockDispatcher,
+            },
+            session: {
+                resolveStorePath,
+                readSessionUpdatedAt,
+                recordInboundSession,
+            },
+        },
+    };
+    return {
+        runtime,
+        resolveAgentRoute,
+        dispatchReplyWithBufferedBlockDispatcher,
+        recordInboundSession,
+    };
+}
+function createTextCandidate() {
+    return {
+        accountId: "default",
+        openId: "openid-1",
+        appId: "wx-test-appid",
+        target: "user:openid-1@default",
+        sessionKey: "dm:wx-test-appid:openid-1",
+        createTime: 1710000000,
+        msgType: "text",
+        msgId: "msg-1",
+        dedupeKey: "msg-1",
+        encrypted: true,
+        hasUserIntent: true,
+        content: "hello",
+        toUserName: "gh_xxx",
+        raw: {
+            ToUserName: "gh_xxx",
+            FromUserName: "openid-1",
+            CreateTime: 1710000000,
+            MsgType: "text",
+            Content: "hello",
+            MsgId: "msg-1",
+        },
+    };
+}
+function createEventCandidate(intentful) {
+    return {
+        accountId: "default",
+        openId: "openid-1",
+        appId: "wx-test-appid",
+        target: "user:openid-1@default",
+        sessionKey: "dm:wx-test-appid:openid-1",
+        createTime: 1710000000,
+        msgType: "event",
+        dedupeKey: `event:${intentful ? "click" : "view"}`,
+        encrypted: true,
+        hasUserIntent: intentful,
+        event: intentful ? "click" : "view",
+        eventKey: intentful ? "MENU_KEY" : "https://example.com",
+        toUserName: "gh_xxx",
+        raw: {
+            ToUserName: "gh_xxx",
+            FromUserName: "openid-1",
+            CreateTime: 1710000000,
+            MsgType: "event",
+            Event: intentful ? "CLICK" : "VIEW",
+            EventKey: intentful ? "MENU_KEY" : "https://example.com",
+        },
+    };
+}
+describe("wechat-mp dispatch", () => {
+    it("dispatches text candidate into runtime mainline", async () => {
+        const account = createAccount();
+        const { runtime, resolveAgentRoute, dispatchReplyWithBufferedBlockDispatcher, recordInboundSession } = createRuntime();
+        const result = await dispatchWechatMpCandidate({
+            cfg: {},
+            account,
+            candidate: createTextCandidate(),
+            runtime,
+        });
+        expect(result.dispatched).toBe(true);
+        expect(result.combinedReply).toBe("reply text");
+        expect(resolveAgentRoute).toHaveBeenCalledTimes(1);
+        expect(dispatchReplyWithBufferedBlockDispatcher).toHaveBeenCalledTimes(1);
+        expect(recordInboundSession).toHaveBeenCalledTimes(1);
+        const calls = recordInboundSession.mock.calls;
+        const recordCall = calls[0]?.[0];
+        expect(recordCall?.sessionKey).toBe("session-1");
+        expect(recordCall?.ctx?.SessionKey).toBe("session-1");
+        expect(recordCall?.ctx?.CommandAuthorized).toBe(true);
+    });
+    it("skips non-intentful event candidate", async () => {
+        const account = createAccount();
+        const { runtime, resolveAgentRoute, dispatchReplyWithBufferedBlockDispatcher } = createRuntime();
+        const result = await dispatchWechatMpCandidate({
+            cfg: {},
+            account,
+            candidate: createEventCandidate(false),
+            runtime,
+        });
+        expect(result.dispatched).toBe(false);
+        expect(result.reason).toBe("non-intentful event");
+        expect(resolveAgentRoute).not.toHaveBeenCalled();
+        expect(dispatchReplyWithBufferedBlockDispatcher).not.toHaveBeenCalled();
+    });
+    it("dispatches intentful event candidate", async () => {
+        const account = createAccount();
+        const { runtime, resolveAgentRoute, dispatchReplyWithBufferedBlockDispatcher } = createRuntime();
+        const result = await dispatchWechatMpCandidate({
+            cfg: {},
+            account,
+            candidate: createEventCandidate(true),
+            runtime,
+        });
+        expect(result.dispatched).toBe(true);
+        expect(resolveAgentRoute).toHaveBeenCalledTimes(1);
+        expect(dispatchReplyWithBufferedBlockDispatcher).toHaveBeenCalledTimes(1);
+    });
+    it("merges delivered chunks by default", async () => {
+        const account = createAccount();
+        const { runtime } = createRuntime(["step 1", "step 2"]);
+        const result = await dispatchWechatMpCandidate({
+            cfg: {},
+            account,
+            candidate: createTextCandidate(),
+            runtime,
+        });
+        expect(result.combinedReply).toBe("step 1\n\nstep 2");
+    });
+    it("forwards chunks one by one in split mode", async () => {
+        const account = createAccount();
+        const { runtime } = createRuntime(["step 1", "", "step 2"]);
+        const onChunk = vi.fn(async () => undefined);
+        const result = await dispatchWechatMpCandidate({
+            cfg: {},
+            account,
+            candidate: createTextCandidate(),
+            runtime,
+            onChunk,
+        });
+        expect(onChunk).toHaveBeenCalledTimes(2);
+        expect(onChunk).toHaveBeenNthCalledWith(1, "step 1");
+        expect(onChunk).toHaveBeenNthCalledWith(2, "step 2");
+        expect(result.combinedReply).toBe("");
+    });
+    it("normalizes markdown text by default in reply path", async () => {
+        const account = createAccount();
+        const { runtime } = createRuntime(["**bold text** and `code`"]);
+        const result = await dispatchWechatMpCandidate({
+            cfg: {},
+            account,
+            candidate: createTextCandidate(),
+            runtime,
+        });
+        // Default renderMarkdown=true strips markdown formatting
+        expect(result.combinedReply).toBe("bold text and code");
+    });
+    it("skips markdown normalization when renderMarkdown is false", async () => {
+        const account = createAccount({
+            config: {
+                appId: "wx-test-appid",
+                appSecret: "secret",
+                token: "token",
+                encodingAESKey: "abcdefghijklmnopqrstuvwxyz0123456789ABCDEFG",
+                webhookPath: "/wechat-mp",
+                messageMode: "safe",
+                replyMode: "passive",
+                dmPolicy: "open",
+                renderMarkdown: false,
+            },
+        });
+        const { runtime } = createRuntime(["**bold text** and `code`"]);
+        const result = await dispatchWechatMpCandidate({
+            cfg: {},
+            account,
+            candidate: createTextCandidate(),
+            runtime,
+        });
+        // renderMarkdown=false preserves original markdown
+        expect(result.combinedReply).toBe("**bold text** and `code`");
+    });
+    it("applies markdown normalization to multiple chunks", async () => {
+        const account = createAccount();
+        const { runtime } = createRuntime(["# Heading", "**bold** text"]);
+        const result = await dispatchWechatMpCandidate({
+            cfg: {},
+            account,
+            candidate: createTextCandidate(),
+            runtime,
+        });
+        // Headings become bracketed, bold is stripped
+        expect(result.combinedReply).toBe("[Heading]\n\nbold text");
+    });
+});
+//# sourceMappingURL=dispatch.test.js.map

package/dist/src/dispatch.test.js.map

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

package/dist/src/inbound.d.ts

@@ -0,0 +1,7 @@
+import type { ResolvedWechatMpAccount, WechatMpInboundCandidate, WechatMpInboundMessage } from "./types.js";
+export declare function normalizeWechatMpInbound(params: {
+    account: ResolvedWechatMpAccount;
+    message: WechatMpInboundMessage;
+    encrypted: boolean;
+}): WechatMpInboundCandidate | null;
+//# sourceMappingURL=inbound.d.ts.map

package/dist/src/inbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../src/inbound.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EAExB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAmBpB,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,uBAAuB,CAAC;IACjC,OAAO,EAAE,sBAAsB,CAAC;IAChC,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,wBAAwB,GAAG,IAAI,CAoElC"}

package/dist/src/inbound.js

@@ -0,0 +1,82 @@
+import { buildWechatMpSessionKey, buildWechatMpTarget } from "./config.js";
+const INTENTFUL_EVENTS = new Set(["subscribe", "scan", "click"]);
+const TRACKED_EVENTS = new Set([
+    "subscribe",
+    "unsubscribe",
+    "scan",
+    "click",
+    "view",
+]);
+function normalizeEventName(raw) {
+    const value = String(raw ?? "").trim().toLowerCase();
+    if (TRACKED_EVENTS.has(value)) {
+        return value;
+    }
+    return undefined;
+}
+export function normalizeWechatMpInbound(params) {
+    const { account, message, encrypted } = params;
+    const openId = String(message.FromUserName ?? "").trim();
+    if (!openId)
+        return null;
+    const createTime = Number(message.CreateTime ?? 0) || 0;
+    const target = buildWechatMpTarget(openId, account.accountId);
+    const sessionKey = account.config.appId
+        ? buildWechatMpSessionKey(account.config.appId, openId)
+        : undefined;
+    if (message.MsgType === "text") {
+        const content = String(message.Content ?? "").trim();
+        if (!content)
+            return null;
+        const msgId = String(message.MsgId ?? "").trim() || undefined;
+        return {
+            accountId: account.accountId,
+            openId,
+            appId: account.config.appId,
+            target,
+            sessionKey,
+            createTime,
+            msgType: "text",
+            msgId,
+            dedupeKey: msgId || `text:${account.accountId}:${openId}:${createTime}:${content}`,
+            encrypted,
+            hasUserIntent: true,
+            content,
+            toUserName: String(message.ToUserName ?? "").trim() || undefined,
+            raw: message,
+        };
+    }
+    if (message.MsgType === "event") {
+        const eventValue = "Event" in message && typeof message.Event === "string"
+            ? message.Event
+            : undefined;
+        const event = normalizeEventName(eventValue);
+        if (!event)
+            return null;
+        const eventKey = "EventKey" in message && typeof message.EventKey === "string"
+            ? message.EventKey.trim() || undefined
+            : undefined;
+        const ticket = "Ticket" in message && typeof message.Ticket === "string"
+            ? message.Ticket.trim() || undefined
+            : undefined;
+        return {
+            accountId: account.accountId,
+            openId,
+            appId: account.config.appId,
+            target,
+            sessionKey,
+            createTime,
+            msgType: "event",
+            dedupeKey: `event:${account.accountId}:${openId}:${event}:${eventKey ?? ""}:${createTime}`,
+            encrypted,
+            hasUserIntent: INTENTFUL_EVENTS.has(event),
+            event,
+            eventKey,
+            ticket,
+            toUserName: String(message.ToUserName ?? "").trim() || undefined,
+            raw: message,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=inbound.js.map