@pawastation/wechat-kf 0.1.1

package/dist/src/accounts.js

@@ -0,0 +1,205 @@
+/**
+ * Account resolution for WeChat KF
+ *
+ * Accounts are dynamically discovered from webhook callbacks.
+ * Each openKfId becomes an independent accountId (like Telegram chat groups).
+ * Enterprise credentials (corpId, appSecret, token, encodingAESKey) are shared.
+ */
+import { mkdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { atomicWriteFile } from "./fs-utils.js";
+const DEFAULT_PORT = 9999;
+const DEFAULT_PATH = "/wechat-kf";
+/** In-memory set of discovered kfids */
+const discoveredKfIds = new Set();
+/** In-memory set of disabled kfids (persisted to disk) */
+const disabledKfIds = new Set();
+let stateDir = null;
+export function setStateDir(dir) {
+    stateDir = dir;
+}
+export function getChannelConfig(cfg) {
+    return (cfg.channels?.["wechat-kf"] ?? {});
+}
+/** Register a dynamically discovered kfid */
+export async function registerKfId(kfId) {
+    if (!kfId || discoveredKfIds.has(kfId))
+        return;
+    discoveredKfIds.add(kfId);
+    await persistKfIds();
+}
+/** Get all known kfids */
+export function getKnownKfIds() {
+    return Array.from(discoveredKfIds);
+}
+/** Get all known kfids that are currently enabled */
+export function getEnabledKfIds() {
+    return Array.from(discoveredKfIds).filter((id) => !disabledKfIds.has(id));
+}
+/** Check whether a kfid is enabled (not in the disabled set) */
+export function isKfIdEnabled(kfId) {
+    return !disabledKfIds.has(resolveKfId(kfId));
+}
+/** Disable a kfid (add to disabled set). Returns true if the state changed. */
+export async function disableKfId(kfId) {
+    if (!kfId)
+        return false;
+    const resolved = resolveKfId(kfId);
+    if (disabledKfIds.has(resolved))
+        return false;
+    disabledKfIds.add(resolved);
+    await persistDisabledKfIds();
+    return true;
+}
+/** Enable a previously disabled kfid. Returns true if the state changed. */
+export async function enableKfId(kfId) {
+    if (!kfId)
+        return false;
+    const resolved = resolveKfId(kfId);
+    if (!disabledKfIds.has(resolved))
+        return false;
+    disabledKfIds.delete(resolved);
+    await persistDisabledKfIds();
+    return true;
+}
+/**
+ * Delete a kfid entirely — removes from discovered set and adds to disabled set
+ * so it won't be re-activated if the webhook delivers it again before restart.
+ * Returns true if the kfid was known (and thus actually removed).
+ */
+export async function deleteKfId(kfId) {
+    if (!kfId)
+        return false;
+    const resolved = resolveKfId(kfId);
+    const wasKnown = discoveredKfIds.has(resolved);
+    discoveredKfIds.delete(resolved);
+    disabledKfIds.add(resolved);
+    await persistKfIds();
+    await persistDisabledKfIds();
+    return wasKnown;
+}
+/**
+ * Resolve a potentially lowercased kfId to its original-case form.
+ * Falls back to the input if no match is found in the discovered set.
+ */
+function resolveKfId(kfId) {
+    // Direct match — fast path
+    if (discoveredKfIds.has(kfId) || disabledKfIds.has(kfId))
+        return kfId;
+    // Case-insensitive lookup in discovered set
+    for (const id of discoveredKfIds) {
+        if (id.toLowerCase() === kfId.toLowerCase())
+            return id;
+    }
+    // Case-insensitive lookup in disabled set
+    for (const id of disabledKfIds) {
+        if (id.toLowerCase() === kfId.toLowerCase())
+            return id;
+    }
+    return kfId;
+}
+/** Load persisted kfids from state dir */
+export async function loadKfIds(dir) {
+    stateDir = dir;
+    try {
+        const data = await readFile(join(dir, "wechat-kf-kfids.json"), "utf8");
+        const ids = JSON.parse(data);
+        if (Array.isArray(ids)) {
+            for (const id of ids)
+                discoveredKfIds.add(id);
+        }
+    }
+    catch {
+        // No persisted state yet, that's fine
+    }
+    try {
+        const data = await readFile(join(dir, "wechat-kf-disabled-kfids.json"), "utf8");
+        const ids = JSON.parse(data);
+        if (Array.isArray(ids)) {
+            for (const id of ids)
+                disabledKfIds.add(id);
+        }
+    }
+    catch {
+        // No persisted disabled state yet, that's fine
+    }
+}
+/** Persist kfids to state dir */
+async function persistKfIds() {
+    if (!stateDir)
+        return;
+    try {
+        await mkdir(stateDir, { recursive: true });
+        await atomicWriteFile(join(stateDir, "wechat-kf-kfids.json"), JSON.stringify(Array.from(discoveredKfIds)));
+    }
+    catch {
+        // Best effort
+    }
+}
+/** Persist disabled kfids to state dir */
+async function persistDisabledKfIds() {
+    if (!stateDir)
+        return;
+    try {
+        await mkdir(stateDir, { recursive: true });
+        await atomicWriteFile(join(stateDir, "wechat-kf-disabled-kfids.json"), JSON.stringify(Array.from(disabledKfIds)));
+    }
+    catch {
+        // Best effort
+    }
+}
+export function listAccountIds(_cfg) {
+    // Return discovered kfids as account ids, excluding disabled ones
+    const ids = getEnabledKfIds();
+    return ids.length > 0 ? ids : ["default"];
+}
+/**
+ * Recover the original case-sensitive kfId from the normalized (lowercased) accountId.
+ * OpenClaw core normalizes accountIds to lowercase, but WeChat KF API requires
+ * the original case-sensitive openKfId.
+ */
+function recoverOriginalKfId(normalizedId) {
+    if (normalizedId === "default")
+        return undefined;
+    // Look up the original-case kfId from our discovered set
+    for (const kfId of discoveredKfIds) {
+        if (kfId.toLowerCase() === normalizedId.toLowerCase())
+            return kfId;
+    }
+    // Fallback: return as-is (may fail if case matters)
+    return normalizedId;
+}
+/**
+ * Reset all module-level mutable state.
+ * @internal Exposed for testing only — allows test isolation between runs.
+ */
+export function _reset() {
+    discoveredKfIds.clear();
+    disabledKfIds.clear();
+    stateDir = null;
+}
+export function resolveAccount(cfg, accountId) {
+    const config = getChannelConfig(cfg);
+    const id = accountId ?? "default";
+    const corpId = config.corpId;
+    const appSecret = config.appSecret;
+    const token = config.token;
+    const encodingAESKey = config.encodingAESKey;
+    const kfIdDisabled = id !== "default" && !isKfIdEnabled(id);
+    const enabled = kfIdDisabled ? false : (config.enabled ?? false);
+    const configured = !!(corpId && appSecret && token && encodingAESKey);
+    return {
+        accountId: id,
+        enabled,
+        configured,
+        corpId,
+        appSecret,
+        token,
+        encodingAESKey,
+        openKfId: recoverOriginalKfId(id),
+        webhookPort: config.webhookPort ?? DEFAULT_PORT,
+        webhookPath: config.webhookPath ?? DEFAULT_PATH,
+        config,
+    };
+}
+//# sourceMappingURL=accounts.js.map

package/dist/src/accounts.js.map

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

package/dist/src/api.d.ts

@@ -0,0 +1,29 @@
+/**
+ * WeCom Customer Service API wrapper
+ */
+import type { WechatKfSendMsgResponse, WechatKfSyncMsgRequest, WechatKfSyncMsgResponse, WechatMediaUploadResponse } from "./types.js";
+/** Pull messages from WeChat KF */
+export declare function syncMessages(corpId: string, appSecret: string, params: WechatKfSyncMsgRequest): Promise<WechatKfSyncMsgResponse>;
+/** Send a text message to a WeChat user */
+export declare function sendTextMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, content: string): Promise<WechatKfSendMsgResponse>;
+/** Download media file from WeChat */
+export declare function downloadMedia(corpId: string, appSecret: string, mediaId: string): Promise<Buffer>;
+type WechatMediaType = "image" | "voice" | "video" | "file";
+/** Upload media file to WeChat */
+export declare function uploadMedia(corpId: string, appSecret: string, type: WechatMediaType, buffer: Buffer, filename: string): Promise<WechatMediaUploadResponse>;
+/** Send an image message to a WeChat user */
+export declare function sendImageMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, mediaId: string): Promise<WechatKfSendMsgResponse>;
+/** Send a voice message to a WeChat user */
+export declare function sendVoiceMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, mediaId: string): Promise<WechatKfSendMsgResponse>;
+/** Send a video message to a WeChat user */
+export declare function sendVideoMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, mediaId: string): Promise<WechatKfSendMsgResponse>;
+/** Send a file message to a WeChat user */
+export declare function sendFileMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, mediaId: string): Promise<WechatKfSendMsgResponse>;
+/** Send a link message to a WeChat user */
+export declare function sendLinkMessage(corpId: string, appSecret: string, toUser: string, openKfId: string, link: {
+    title: string;
+    desc?: string;
+    url: string;
+    thumb_media_id: string;
+}): Promise<WechatKfSendMsgResponse>;
+export {};

package/dist/src/api.js

@@ -0,0 +1,172 @@
+/**
+ * WeCom Customer Service API wrapper
+ */
+import { extname } from "node:path";
+import { API_POST_TIMEOUT_MS, MEDIA_TIMEOUT_MS, TOKEN_EXPIRED_CODES } from "./constants.js";
+import { clearAccessToken, getAccessToken } from "./token.js";
+const MIME_MAP = {
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".png": "image/png",
+    ".gif": "image/gif",
+    ".bmp": "image/bmp",
+    ".webp": "image/webp",
+    ".amr": "audio/amr",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".ogg": "audio/ogg",
+    ".silk": "audio/silk",
+    ".m4a": "audio/mp4",
+    ".aac": "audio/aac",
+    ".mp4": "video/mp4",
+    ".avi": "video/x-msvideo",
+    ".mov": "video/quicktime",
+};
+const BASE = "https://qyapi.weixin.qq.com/cgi-bin";
+/**
+ * Check whether a WeCom API response indicates a business error.
+ * Successful responses have errcode === 0 or omit errcode entirely (undefined).
+ * Using a truthy check so that both 0 and undefined are treated as success.
+ */
+function hasApiError(errcode) {
+    return !!errcode;
+}
+async function apiPost(path, token, body) {
+    const resp = await fetch(`${BASE}${path}?access_token=${token}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(API_POST_TIMEOUT_MS),
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => "");
+        throw new Error(`[wechat-kf] API ${path} HTTP ${resp.status}: ${text.slice(0, 200)}`);
+    }
+    return (await resp.json());
+}
+/**
+ * Call apiPost with automatic token refresh on token-expired errors.
+ * Detects errcode 40014/42001/40001, clears the cached token, fetches a
+ * new one and retries exactly once.
+ */
+async function apiPostWithTokenRetry(path, corpId, appSecret, body) {
+    let token = await getAccessToken(corpId, appSecret);
+    const data = await apiPost(path, token, body);
+    const result = data;
+    if (typeof result.errcode === "number" && TOKEN_EXPIRED_CODES.has(result.errcode)) {
+        clearAccessToken(corpId, appSecret);
+        token = await getAccessToken(corpId, appSecret);
+        return apiPost(path, token, body);
+    }
+    return data;
+}
+/** Pull messages from WeChat KF */
+export async function syncMessages(corpId, appSecret, params) {
+    const data = await apiPostWithTokenRetry("/kf/sync_msg", corpId, appSecret, params);
+    if (hasApiError(data.errcode)) {
+        throw new Error(`[wechat-kf] sync_msg failed: ${data.errcode} ${data.errmsg}`);
+    }
+    return data;
+}
+async function sendMessage(corpId, appSecret, toUser, openKfId, msgtype, payload) {
+    const body = {
+        touser: toUser,
+        open_kfid: openKfId,
+        msgtype,
+        ...payload,
+    };
+    const data = await apiPostWithTokenRetry("/kf/send_msg", corpId, appSecret, body);
+    if (hasApiError(data.errcode)) {
+        throw new Error(`[wechat-kf] send_msg failed: ${data.errcode} ${data.errmsg}`);
+    }
+    return data;
+}
+/** Send a text message to a WeChat user */
+export function sendTextMessage(corpId, appSecret, toUser, openKfId, content) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "text", { text: { content } });
+}
+/** Download media file from WeChat */
+export async function downloadMedia(corpId, appSecret, mediaId) {
+    const attemptDownload = async (token) => {
+        const resp = await fetch(`${BASE}/media/get?access_token=${token}&media_id=${mediaId}`, {
+            signal: AbortSignal.timeout(MEDIA_TIMEOUT_MS),
+        });
+        if (!resp.ok) {
+            throw new Error(`[wechat-kf] download media failed: ${resp.status} ${resp.statusText}`);
+        }
+        const contentType = resp.headers.get("content-type") ?? "";
+        if (contentType.includes("application/json")) {
+            const data = (await resp.json());
+            return { buffer: Buffer.alloc(0), errcode: data.errcode, errmsg: data.errmsg };
+        }
+        return { buffer: Buffer.from(await resp.arrayBuffer()) };
+    };
+    let token = await getAccessToken(corpId, appSecret);
+    const result = await attemptDownload(token);
+    if (result.errcode !== undefined) {
+        // Token-expired error: clear and retry once
+        if (TOKEN_EXPIRED_CODES.has(result.errcode)) {
+            clearAccessToken(corpId, appSecret);
+            token = await getAccessToken(corpId, appSecret);
+            const retry = await attemptDownload(token);
+            if (retry.errcode !== undefined) {
+                throw new Error(`[wechat-kf] download media failed: ${retry.errcode} ${retry.errmsg}`);
+            }
+            return retry.buffer;
+        }
+        throw new Error(`[wechat-kf] download media failed: ${result.errcode} ${result.errmsg}`);
+    }
+    return result.buffer;
+}
+/** Upload media file to WeChat */
+export async function uploadMedia(corpId, appSecret, type, buffer, filename) {
+    const doUpload = async (token) => {
+        const formData = new FormData();
+        const ext = extname(filename).toLowerCase();
+        const mime = MIME_MAP[ext] ?? "application/octet-stream";
+        const blob = new Blob([new Uint8Array(buffer)], { type: mime });
+        formData.append("media", blob, filename);
+        const resp = await fetch(`${BASE}/media/upload?access_token=${token}&type=${type}`, {
+            method: "POST",
+            body: formData,
+            signal: AbortSignal.timeout(MEDIA_TIMEOUT_MS),
+        });
+        if (!resp.ok) {
+            const text = await resp.text().catch(() => "");
+            throw new Error(`[wechat-kf] upload media HTTP ${resp.status}: ${text.slice(0, 200)}`);
+        }
+        return (await resp.json());
+    };
+    let token = await getAccessToken(corpId, appSecret);
+    let data = await doUpload(token);
+    if (TOKEN_EXPIRED_CODES.has(data.errcode)) {
+        clearAccessToken(corpId, appSecret);
+        token = await getAccessToken(corpId, appSecret);
+        data = await doUpload(token);
+    }
+    if (hasApiError(data.errcode)) {
+        throw new Error(`[wechat-kf] upload media failed: ${data.errcode} ${data.errmsg}`);
+    }
+    return data;
+}
+/** Send an image message to a WeChat user */
+export function sendImageMessage(corpId, appSecret, toUser, openKfId, mediaId) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "image", { image: { media_id: mediaId } });
+}
+/** Send a voice message to a WeChat user */
+export function sendVoiceMessage(corpId, appSecret, toUser, openKfId, mediaId) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "voice", { voice: { media_id: mediaId } });
+}
+/** Send a video message to a WeChat user */
+export function sendVideoMessage(corpId, appSecret, toUser, openKfId, mediaId) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "video", { video: { media_id: mediaId } });
+}
+/** Send a file message to a WeChat user */
+export function sendFileMessage(corpId, appSecret, toUser, openKfId, mediaId) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "file", { file: { media_id: mediaId } });
+}
+/** Send a link message to a WeChat user */
+export function sendLinkMessage(corpId, appSecret, toUser, openKfId, link) {
+    return sendMessage(corpId, appSecret, toUser, openKfId, "link", { link });
+}
+//# sourceMappingURL=api.js.map

package/dist/src/api.js.map

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

package/dist/src/bot.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Message processing — pull messages via sync_msg and dispatch to OpenClaw agent.
+ *
+ * Architecture:
+ * - Each openKfId is an independent account with its own cursor and session
+ * - sync_msg is called with open_kfid filter to only pull messages for that kf account
+ * - Plugin layer: download media, save via MediaPaths/MediaTypes
+ * - OpenClaw runner: handles media understanding (transcription, vision, etc.)
+ */
+import { type PluginRuntime } from "./runtime.js";
+import type { OpenClawConfig, ResolvedWechatKfAccount, WechatKfMessage } from "./types.js";
+export type Logger = {
+    info: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+};
+export type BotContext = {
+    cfg: OpenClawConfig;
+    runtime?: PluginRuntime;
+    stateDir: string;
+    log?: Logger;
+};
+declare function isDuplicate(msgid: string): boolean;
+/** Exposed for testing only — do not use in production code. */
+export declare const _testing: {
+    kfLocks: Map<string, Promise<void>>;
+    processedMsgIds: Set<string>;
+    isDuplicate: typeof isDuplicate;
+    DEDUP_MAX_SIZE: number;
+    handleEvent: typeof handleEvent;
+    resetState(): void;
+};
+declare function handleEvent(ctx: BotContext, _account: ResolvedWechatKfAccount, msg: WechatKfMessage): Promise<void>;
+export declare function handleWebhookEvent(ctx: BotContext, openKfId: string, syncToken: string): Promise<void>;
+export {};