@yaoqi10012/wechat-kf 0.3.1

package/dist/reply-dispatcher.js

@@ -0,0 +1,216 @@
+/**
+ * Reply dispatcher for WeChat KF  (typing-aware streaming replies)
+ *
+ * Responsibility:
+ *   This module is used internally by `bot.ts` when the agent streams tokens
+ *   back to the user. It wraps OpenClaw's `createReplyDispatcherWithTyping` to
+ *   batch tokens into natural-looking messages with simulated human typing
+ *   delay, then delivers them through the WeChat KF API.
+ *
+ *   Text chunking is performed at delivery time via `chunkTextByUtf8Bytes`
+ *   (UTF-8 byte-aware, NOT the framework auto-chunker), because streaming
+ *   replies accumulate text incrementally.
+ *
+ * Counterpart:
+ *   `outbound.ts` handles the *other* outbound path: framework-driven direct
+ *   delivery where the framework itself pre-chunks text via the declared
+ *   `chunker` function.
+ *
+ * accountId = openKfId (dynamically discovered)
+ */
+import { resolveAccount } from "./accounts.js";
+import { sendBusinessCardMessage, sendCaLinkMessage, sendLinkMessage, sendLocationMessage, sendMiniprogramMessage, sendMsgMenuMessage, sendRawMessage, sendTextMessage, } from "./api.js";
+import { logTag, WECHAT_TEXT_CHUNK_BYTE_SAFETY_MARGIN, WECHAT_TEXT_CHUNK_LIMIT } from "./constants.js";
+import { getRuntime } from "./runtime.js";
+import { chunkTextByUtf8Bytes, formatText, mediaKindToWechatType, resolveThumbMediaId, uploadAndSendMedia, } from "./send-utils.js";
+import { buildMsgMenuPayload, parseWechatDirective } from "./wechat-kf-directives.js";
+export function createReplyDispatcher(params) {
+    const core = getRuntime();
+    const { cfg, agentId, externalUserId, openKfId, accountId } = params;
+    const account = resolveAccount(cfg, accountId);
+    const kfId = openKfId; // accountId IS the kfid
+    const byteLimit = WECHAT_TEXT_CHUNK_LIMIT - WECHAT_TEXT_CHUNK_BYTE_SAFETY_MARGIN;
+    const { dispatcher, replyOptions, markDispatchIdle } = core.channel.reply.createReplyDispatcherWithTyping({
+        humanDelay: core.channel.reply.resolveHumanDelayConfig(cfg, agentId),
+        deliver: async (payload) => {
+            const text = payload.text ?? "";
+            const mediaUrls = payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []);
+            const { corpId, appSecret } = account;
+            if (!corpId || !appSecret) {
+                throw new Error(`${logTag()} missing corpId/appSecret for send`);
+            }
+            // Handle media (image, voice, video, file) via framework loadWebMedia
+            for (const url of mediaUrls) {
+                try {
+                    const loaded = await core.media.loadWebMedia(url, { optimizeImages: false });
+                    const mediaType = mediaKindToWechatType(loaded.kind);
+                    await uploadAndSendMedia(corpId, appSecret, externalUserId, kfId, loaded.buffer, loaded.fileName ?? "file", mediaType);
+                }
+                catch (err) {
+                    params.runtime?.error?.(`${logTag()} failed to send media: ${String(err)}`);
+                }
+            }
+            // ── Intercept [[wechat_*:...]] directives BEFORE formatText ──
+            // Parse on raw text so fields stay clean (formatText would
+            // convert markdown inside the directive to unicode characters).
+            if (text.trim()) {
+                const directive = parseWechatDirective(text);
+                if (directive.link) {
+                    let linkSent = false;
+                    if (directive.link.thumbUrl) {
+                        try {
+                            const thumbMediaId = await resolveThumbMediaId(directive.link.thumbUrl, corpId, appSecret);
+                            await sendLinkMessage(corpId, appSecret, externalUserId, kfId, {
+                                title: directive.link.title,
+                                desc: directive.link.desc,
+                                url: directive.link.url,
+                                thumb_media_id: thumbMediaId,
+                            });
+                            linkSent = true;
+                        }
+                        catch (err) {
+                            params.runtime?.error?.(`${logTag()} failed to send link card: ${String(err)}`);
+                        }
+                    }
+                    // Send remaining text (or fallback with title:url if link card failed / no thumbUrl)
+                    const rawRemaining = linkSent
+                        ? directive.text
+                        : directive.text
+                            ? `${directive.text}\n${directive.link.title}: ${directive.link.url}`
+                            : `${directive.link.title}: ${directive.link.url}`;
+                    if (rawRemaining?.trim()) {
+                        const formatted = formatText(rawRemaining);
+                        const chunks = chunkTextByUtf8Bytes(formatted, byteLimit);
+                        for (const chunk of chunks) {
+                            await sendTextMessage(corpId, appSecret, externalUserId, kfId, chunk);
+                        }
+                    }
+                }
+                else if (directive.location) {
+                    try {
+                        await sendLocationMessage(corpId, appSecret, externalUserId, kfId, directive.location);
+                    }
+                    catch (err) {
+                        params.runtime?.error?.(`${logTag()} failed to send location: ${String(err)}`);
+                    }
+                    if (directive.text?.trim()) {
+                        const formatted = formatText(directive.text);
+                        const chunks = chunkTextByUtf8Bytes(formatted, byteLimit);
+                        for (const chunk of chunks) {
+                            await sendTextMessage(corpId, appSecret, externalUserId, kfId, chunk);
+                        }
+                    }
+                }
+                else if (directive.miniprogram) {
+                    let mpSent = false;
+                    if (directive.miniprogram.thumbUrl) {
+                        try {
+                            const thumbMediaId = await resolveThumbMediaId(directive.miniprogram.thumbUrl, corpId, appSecret);
+                            await sendMiniprogramMessage(corpId, appSecret, externalUserId, kfId, {
+                                appid: directive.miniprogram.appid,
+                                title: directive.miniprogram.title,
+                                pagepath: directive.miniprogram.pagepath,
+                                thumb_media_id: thumbMediaId,
+                            });
+                            mpSent = true;
+                        }
+                        catch (err) {
+                            params.runtime?.error?.(`${logTag()} failed to send miniprogram: ${String(err)}`);
+                        }
+                    }
+                    const rawRemaining = mpSent
+                        ? directive.text
+                        : directive.text
+                            ? `${directive.text}\n[小程序] ${directive.miniprogram.title}`
+                            : `[小程序] ${directive.miniprogram.title}`;
+                    if (rawRemaining?.trim()) {
+                        const formatted = formatText(rawRemaining);
+                        const chunks = chunkTextByUtf8Bytes(formatted, byteLimit);
+                        for (const chunk of chunks) {
+                            await sendTextMessage(corpId, appSecret, externalUserId, kfId, chunk);
+                        }
+                    }
+                }
+                else if (directive.menu) {
+                    try {
+                        const menuPayload = buildMsgMenuPayload(directive.menu);
+                        await sendMsgMenuMessage(corpId, appSecret, externalUserId, kfId, menuPayload);
+                    }
+                    catch (err) {
+                        params.runtime?.error?.(`${logTag()} failed to send menu: ${String(err)}`);
+                    }
+                    if (directive.text?.trim()) {
+                        const formatted = formatText(directive.text);
+                        const chunks = chunkTextByUtf8Bytes(formatted, byteLimit);
+                        for (const chunk of chunks) {
+                            await sendTextMessage(corpId, appSecret, externalUserId, kfId, chunk);
+                        }
+                    }
+                }
+                else if (directive.businessCard) {
+                    try {
+                        await sendBusinessCardMessage(corpId, appSecret, externalUserId, kfId, directive.businessCard);
+                    }
+                    catch (err) {
+                        params.runtime?.error?.(`${logTag()} failed to send business card: ${String(err)}`);
+                    }
+                    if (directive.text?.trim()) {
+                        const formatted = formatText(directive.text);
+                        const chunks = chunkTextByUtf8Bytes(formatted, byteLimit);
+                        for (const chunk of chunks) {
+                            await sendTextMessage(corpId, appSecret, externalUserId, kfId, chunk);
+                        }
+                    }
+                }
+                else if (directive.caLink) {
+                    try {
+                        await sendCaLinkMessage(corpId, appSecret, externalUserId, kfId, directive.caLink);
+                    }
+                    catch (err) {
+                        params.runtime?.error?.(`${logTag()} failed to send ca_link: ${String(err)}`);
+                    }
+                    if (directive.text?.trim()) {
+                        const formatted = formatText(directive.text);
+                        const chunks = chunkTextByUtf8Bytes(formatted, byteLimit);
+                        for (const chunk of chunks) {
+                            await sendTextMessage(corpId, appSecret, externalUserId, kfId, chunk);
+                        }
+                    }
+                }
+                else if (directive.raw) {
+                    try {
+                        await sendRawMessage(corpId, appSecret, externalUserId, kfId, directive.raw.msgtype, directive.raw.payload);
+                    }
+                    catch (err) {
+                        params.runtime?.error?.(`${logTag()} failed to send raw message: ${String(err)}`);
+                    }
+                    if (directive.text?.trim()) {
+                        const formatted = formatText(directive.text);
+                        const chunks = chunkTextByUtf8Bytes(formatted, byteLimit);
+                        for (const chunk of chunks) {
+                            await sendTextMessage(corpId, appSecret, externalUserId, kfId, chunk);
+                        }
+                    }
+                }
+                else {
+                    // No directive — normal path: formatText then chunk and send
+                    const formatted = formatText(text);
+                    if (formatted.trim()) {
+                        const chunks = chunkTextByUtf8Bytes(formatted, byteLimit);
+                        for (const chunk of chunks) {
+                            await sendTextMessage(corpId, appSecret, externalUserId, kfId, chunk);
+                        }
+                    }
+                }
+            }
+            if (!text.trim() && mediaUrls.length === 0) {
+                return;
+            }
+        },
+        onError: (err, info) => {
+            params.runtime?.error?.(`${logTag()} ${info?.kind ?? "unknown"} reply failed: ${String(err)}`);
+        },
+    });
+    return { dispatcher, replyOptions, markDispatchIdle };
+}
+//# sourceMappingURL=reply-dispatcher.js.map

package/dist/reply-dispatcher.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Plugin runtime reference
+ * Stores the PluginRuntime provided by OpenClaw gateway at startup.
+ */
+import type { PluginRuntime } from "openclaw/plugin-sdk";
+export declare function setRuntime(next: PluginRuntime): void;
+export declare function getRuntime(): PluginRuntime;
+/**
+ * Reset the module-level runtime reference to null.
+ * @internal Exposed for testing only — allows test isolation between runs.
+ */
+export declare function _reset(): void;

package/dist/runtime.js

@@ -0,0 +1,23 @@
+/**
+ * Plugin runtime reference
+ * Stores the PluginRuntime provided by OpenClaw gateway at startup.
+ */
+import { logTag } from "./constants.js";
+let runtime = null;
+export function setRuntime(next) {
+    runtime = next;
+}
+export function getRuntime() {
+    if (!runtime) {
+        throw new Error(`${logTag()} runtime not initialized — plugin not started via gateway?`);
+    }
+    return runtime;
+}
+/**
+ * Reset the module-level runtime reference to null.
+ * @internal Exposed for testing only — allows test isolation between runs.
+ */
+export function _reset() {
+    runtime = null;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,IAAI,OAAO,GAAyB,IAAI,CAAC;AAEzC,MAAM,UAAU,UAAU,CAAC,IAAmB;IAC5C,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,4DAA4D,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}

package/dist/send-utils.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Shared outbound utilities for WeChat KF
+ *
+ * Extracted helpers used by both outbound paths:
+ *   - outbound.ts      (framework-driven direct delivery)
+ *   - reply-dispatcher.ts (typing-aware streaming replies)
+ *
+ * Centralises Markdown formatting, media-type detection, and the
+ * upload-then-send media workflow so changes only need to happen once.
+ */
+/**
+ * Split text into chunks that each fit within `byteLimit` UTF-8 bytes.
+ *
+ * Iterates by code point (safe for surrogate pairs / emoji) and prefers
+ * breaking at newline or space boundaries.  When no natural break point
+ * exists the chunk is split at the byte-limit boundary (still on a code
+ * point edge, never mid-surrogate).
+ */
+export declare function chunkTextByUtf8Bytes(text: string, byteLimit: number): string[];
+/** Markdown to Unicode text formatting (shared by both outbound paths) */
+export declare function formatText(text: string): string;
+export declare function contentTypeToExt(contentType: string): string;
+/** Detect image MIME type from magic bytes (file header) */
+export declare function detectImageMime(buffer: Buffer): string | null;
+/** Map framework MediaKind to WeChat media type */
+export declare function mediaKindToWechatType(kind: string): "image" | "voice" | "video" | "file";
+/** Map file extension to WeChat media type */
+export declare function detectMediaType(ext: string): "image" | "voice" | "video" | "file";
+/** Upload media to WeChat and send via the appropriate message type */
+export declare function uploadAndSendMedia(corpId: string, appSecret: string, toUser: string, openKfId: string, buffer: Buffer, filename: string, mediaType: "image" | "voice" | "video" | "file"): Promise<{
+    msgid: string;
+}>;
+/**
+ * Download media from an HTTP/HTTPS URL and return the buffer + filename.
+ *
+ * WeChat does not accept external URLs directly — media must be uploaded to
+ * the temporary media store first.  This helper fetches the remote resource
+ * so the caller can then pass the buffer through `uploadAndSendMedia`.
+ */
+export declare function downloadMediaFromUrl(url: string): Promise<{
+    buffer: Buffer;
+    filename: string;
+    ext: string;
+}>;
+/**
+ * Resolve a thumbnail reference to a WeChat thumb_media_id.
+ *
+ * Accepts three kinds of input:
+ *   - URL (http://, https://) or local path (/, ~, file://, data:) → loadWebMedia + uploadMedia
+ *   - media_id string (anything else) → used directly
+ */
+export declare function resolveThumbMediaId(thumbRef: string, corpId: string, appSecret: string): Promise<string>;

package/dist/send-utils.js

@@ -0,0 +1,217 @@
+/**
+ * Shared outbound utilities for WeChat KF
+ *
+ * Extracted helpers used by both outbound paths:
+ *   - outbound.ts      (framework-driven direct delivery)
+ *   - reply-dispatcher.ts (typing-aware streaming replies)
+ *
+ * Centralises Markdown formatting, media-type detection, and the
+ * upload-then-send media workflow so changes only need to happen once.
+ */
+import { basename, extname } from "node:path";
+import { sendFileMessage, sendImageMessage, sendVideoMessage, sendVoiceMessage, uploadMedia } from "./api.js";
+import { logTag, MEDIA_DOWNLOAD_TIMEOUT_MS } from "./constants.js";
+import { getRuntime } from "./runtime.js";
+import { markdownToUnicode } from "./unicode-format.js";
+/** Calculate the UTF-8 byte length of a single code point. */
+function utf8ByteLengthOfCodePoint(cp) {
+    if (cp <= 0x7f)
+        return 1;
+    if (cp <= 0x7ff)
+        return 2;
+    if (cp <= 0xffff)
+        return 3;
+    return 4;
+}
+/**
+ * Split text into chunks that each fit within `byteLimit` UTF-8 bytes.
+ *
+ * Iterates by code point (safe for surrogate pairs / emoji) and prefers
+ * breaking at newline or space boundaries.  When no natural break point
+ * exists the chunk is split at the byte-limit boundary (still on a code
+ * point edge, never mid-surrogate).
+ */
+export function chunkTextByUtf8Bytes(text, byteLimit) {
+    if (byteLimit <= 0)
+        return [];
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return [];
+    const chunks = [];
+    let chunkStart = 0; // index into `trimmed` (UTF-16 offset)
+    let byteCount = 0;
+    let lastBreak = -1; // UTF-16 index of last space/newline *start*
+    let i = 0;
+    for (const char of trimmed) {
+        const cp = char.codePointAt(0);
+        const cpBytes = utf8ByteLengthOfCodePoint(cp);
+        if (byteCount + cpBytes > byteLimit) {
+            // Need to flush a chunk
+            if (lastBreak > chunkStart) {
+                // Break at the last whitespace
+                const chunk = trimmed.slice(chunkStart, lastBreak).trimEnd();
+                if (chunk)
+                    chunks.push(chunk);
+                chunkStart = lastBreak;
+                // Skip leading whitespace after break
+                while (chunkStart < trimmed.length && (trimmed[chunkStart] === " " || trimmed[chunkStart] === "\n")) {
+                    chunkStart++;
+                }
+                // Recalculate byteCount from chunkStart to i
+                byteCount = 0;
+                for (const c of trimmed.slice(chunkStart, i)) {
+                    byteCount += utf8ByteLengthOfCodePoint(c.codePointAt(0));
+                }
+                lastBreak = -1;
+            }
+            else {
+                // No break point — hard cut at current position
+                const chunk = trimmed.slice(chunkStart, i).trimEnd();
+                if (chunk)
+                    chunks.push(chunk);
+                chunkStart = i;
+                byteCount = 0;
+                lastBreak = -1;
+            }
+        }
+        // Track break points
+        if (char === "\n" || char === " ") {
+            lastBreak = i;
+        }
+        byteCount += cpBytes;
+        i += char.length; // 1 for BMP, 2 for supplementary
+    }
+    // Flush remaining
+    if (chunkStart < trimmed.length) {
+        const chunk = trimmed.slice(chunkStart).trim();
+        if (chunk)
+            chunks.push(chunk);
+    }
+    return chunks;
+}
+/** Markdown to Unicode text formatting (shared by both outbound paths) */
+export function formatText(text) {
+    return markdownToUnicode(text);
+}
+const CONTENT_TYPE_EXT_MAP = {
+    "image/jpeg": ".jpg",
+    "image/png": ".png",
+    "image/gif": ".gif",
+    "image/webp": ".webp",
+    "image/bmp": ".bmp",
+    "audio/amr": ".amr",
+    "audio/mpeg": ".mp3",
+    "audio/ogg": ".ogg",
+    "audio/wav": ".wav",
+    "audio/x-wav": ".wav",
+    "video/mp4": ".mp4",
+    "application/pdf": ".pdf",
+};
+export function contentTypeToExt(contentType) {
+    return CONTENT_TYPE_EXT_MAP[contentType] ?? "";
+}
+/** Detect image MIME type from magic bytes (file header) */
+export function detectImageMime(buffer) {
+    if (buffer.length < 4)
+        return null;
+    if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46)
+        return "image/gif";
+    if (buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47)
+        return "image/png";
+    if (buffer[0] === 0xff && buffer[1] === 0xd8)
+        return "image/jpeg";
+    if (buffer[0] === 0x42 && buffer[1] === 0x4d)
+        return "image/bmp";
+    if (buffer.length >= 12 &&
+        buffer.subarray(0, 4).toString() === "RIFF" &&
+        buffer.subarray(8, 12).toString() === "WEBP")
+        return "image/webp";
+    return null;
+}
+/** Map framework MediaKind to WeChat media type */
+export function mediaKindToWechatType(kind) {
+    switch (kind) {
+        case "image":
+            return "image";
+        case "audio":
+            return "voice";
+        case "video":
+            return "video";
+        default:
+            return "file"; // "document" | "unknown"
+    }
+}
+/** Map file extension to WeChat media type */
+export function detectMediaType(ext) {
+    ext = ext.toLowerCase();
+    if ([".jpg", ".jpeg", ".png", ".gif", ".bmp", ".webp"].includes(ext))
+        return "image";
+    if (ext === ".amr")
+        return "voice";
+    if ([".mp4", ".avi", ".mov", ".mkv", ".wmv"].includes(ext))
+        return "video";
+    return "file";
+}
+/** Upload media to WeChat and send via the appropriate message type */
+export async function uploadAndSendMedia(corpId, appSecret, toUser, openKfId, buffer, filename, mediaType) {
+    const uploaded = await uploadMedia(corpId, appSecret, mediaType, buffer, filename);
+    const mid = uploaded.media_id;
+    switch (mediaType) {
+        case "image":
+            return sendImageMessage(corpId, appSecret, toUser, openKfId, mid);
+        case "voice":
+            return sendVoiceMessage(corpId, appSecret, toUser, openKfId, mid);
+        case "video":
+            return sendVideoMessage(corpId, appSecret, toUser, openKfId, mid);
+        default:
+            return sendFileMessage(corpId, appSecret, toUser, openKfId, mid);
+    }
+}
+/**
+ * Download media from an HTTP/HTTPS URL and return the buffer + filename.
+ *
+ * WeChat does not accept external URLs directly — media must be uploaded to
+ * the temporary media store first.  This helper fetches the remote resource
+ * so the caller can then pass the buffer through `uploadAndSendMedia`.
+ */
+export async function downloadMediaFromUrl(url) {
+    const resp = await fetch(url, {
+        signal: AbortSignal.timeout(MEDIA_DOWNLOAD_TIMEOUT_MS),
+    });
+    if (!resp.ok) {
+        throw new Error(`${logTag()} failed to download media: HTTP ${resp.status} from ${url}`);
+    }
+    const buffer = Buffer.from(await resp.arrayBuffer());
+    const urlPath = new URL(resp.url ?? url).pathname;
+    let filename = basename(urlPath) || "download";
+    let ext = extname(filename);
+    // Fall back to Content-Type when URL has no extension
+    if (!ext) {
+        const ct = resp.headers.get("content-type")?.split(";")[0]?.trim() ?? "";
+        ext = contentTypeToExt(ct);
+        if (ext)
+            filename = `${filename}${ext}`;
+    }
+    return { buffer, filename, ext };
+}
+function isMediaSource(value) {
+    return /^(https?:\/\/|file:\/\/|data:|[~/])/.test(value);
+}
+/**
+ * Resolve a thumbnail reference to a WeChat thumb_media_id.
+ *
+ * Accepts three kinds of input:
+ *   - URL (http://, https://) or local path (/, ~, file://, data:) → loadWebMedia + uploadMedia
+ *   - media_id string (anything else) → used directly
+ */
+export async function resolveThumbMediaId(thumbRef, corpId, appSecret) {
+    if (isMediaSource(thumbRef)) {
+        const core = getRuntime();
+        const loaded = await core.media.loadWebMedia(thumbRef, { optimizeImages: false });
+        const uploaded = await uploadMedia(corpId, appSecret, "image", loaded.buffer, loaded.fileName ?? "thumb.jpg");
+        return uploaded.media_id;
+    }
+    // Treat as raw media_id
+    return thumbRef;
+}
+//# sourceMappingURL=send-utils.js.map

package/dist/send-utils.js.map

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

package/dist/token.d.ts

@@ -0,0 +1,8 @@
+/**
+ * access_token retrieval and caching
+ */
+/** Hash the cache key so appSecret is never stored as a plain-text Map key. @internal */
+export declare function makeCacheKey(corpId: string, appSecret: string): string;
+export declare function getAccessToken(corpId: string, appSecret: string): Promise<string>;
+/** Clear cached token (e.g. on auth error) */
+export declare function clearAccessToken(corpId: string, appSecret: string): void;

package/dist/token.js

@@ -0,0 +1,61 @@
+/**
+ * access_token retrieval and caching
+ */
+import { createHash } from "node:crypto";
+import { logTag, TOKEN_FETCH_TIMEOUT_MS } from "./constants.js";
+import { getSharedContext } from "./monitor.js";
+/** Hash the cache key so appSecret is never stored as a plain-text Map key. @internal */
+export function makeCacheKey(corpId, appSecret) {
+    const hash = createHash("sha256").update(appSecret).digest("hex").slice(0, 16);
+    return `${corpId}:${hash}`;
+}
+const cache = new Map();
+const pending = new Map();
+const REFRESH_MARGIN_MS = 5 * 60 * 1000; // refresh 5 minutes before expiry
+export async function getAccessToken(corpId, appSecret) {
+    const cacheKey = makeCacheKey(corpId, appSecret);
+    const cached = cache.get(cacheKey);
+    if (cached && Date.now() < cached.expiresAt - REFRESH_MARGIN_MS) {
+        return cached.token;
+    }
+    // Deduplicate concurrent requests for the same credentials
+    const inflight = pending.get(cacheKey);
+    if (inflight)
+        return inflight;
+    getSharedContext()?.botCtx.log?.debug?.(`${logTag()} fetching new access_token`);
+    const promise = fetchAccessToken(corpId, appSecret, cacheKey);
+    pending.set(cacheKey, promise);
+    try {
+        return await promise;
+    }
+    finally {
+        pending.delete(cacheKey);
+    }
+}
+async function fetchAccessToken(corpId, appSecret, cacheKey) {
+    // WeChat API requires credentials in URL query parameters
+    const url = `https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=${encodeURIComponent(corpId)}&corpsecret=${encodeURIComponent(appSecret)}`;
+    const resp = await fetch(url, {
+        signal: AbortSignal.timeout(TOKEN_FETCH_TIMEOUT_MS),
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => "");
+        throw new Error(`${logTag()} gettoken HTTP ${resp.status}: ${text.slice(0, 200)}`);
+    }
+    const data = (await resp.json());
+    if (data.errcode !== 0) {
+        throw new Error(`${logTag()} gettoken failed: ${data.errcode} ${data.errmsg}`);
+    }
+    cache.set(cacheKey, {
+        token: data.access_token,
+        expiresAt: Date.now() + data.expires_in * 1000,
+    });
+    getSharedContext()?.botCtx.log?.info(`${logTag()} access_token refreshed (expires_in=${data.expires_in}s)`);
+    return data.access_token;
+}
+/** Clear cached token (e.g. on auth error) */
+export function clearAccessToken(corpId, appSecret) {
+    cache.delete(makeCacheKey(corpId, appSecret));
+    getSharedContext()?.botCtx.log?.debug?.(`${logTag()} access_token cache cleared`);
+}
+//# sourceMappingURL=token.js.map

package/dist/token.js.map

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