@pawastation/wechat-kf 0.1.1

package/dist/src/runtime.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Plugin runtime reference
+ * Stores the PluginRuntime provided by OpenClaw gateway at startup.
+ */
+import type { OpenClawConfig } from "./types.js";
+export type SaveMediaResult = {
+    path: string;
+};
+export type AgentRoute = {
+    sessionKey: string;
+    agentId: string;
+};
+export type ResolveAgentRouteOpts = {
+    cfg: OpenClawConfig;
+    channel: string;
+    accountId: string;
+    peer: {
+        kind: string;
+        id: string;
+    };
+};
+export type EnvelopeFormatOptions = Record<string, unknown>;
+export type FormatAgentEnvelopeOpts = {
+    channel: string;
+    from: string;
+    timestamp: Date;
+    envelope: EnvelopeFormatOptions;
+    body: string;
+};
+export type InboundContext = Record<string, unknown>;
+export type FinalizeInboundContextOpts = {
+    Body: string;
+    RawBody: string;
+    CommandBody: string;
+    From: string;
+    To: string;
+    SessionKey: string;
+    AccountId: string;
+    ChatType: string;
+    SenderName: string;
+    SenderId: string;
+    Provider: string;
+    Surface: string;
+    MessageSid: string;
+    Timestamp: number;
+    WasMentioned: boolean;
+    CommandAuthorized: boolean;
+    OriginatingChannel: string;
+    OriginatingTo: string;
+    MediaPaths?: string[];
+    MediaTypes?: string[];
+};
+export type HumanDelayConfig = Record<string, unknown>;
+export type ReplyPayload = {
+    text?: string;
+    attachments?: Array<{
+        path?: string;
+        type?: string;
+        url?: string;
+    }>;
+};
+export type ReplyErrorInfo = {
+    kind?: string;
+};
+export type ReplyDispatcherResult = {
+    dispatcher?: unknown;
+    replyOptions?: unknown;
+    markDispatchIdle?: () => void;
+};
+export type DispatchReplyResult = {
+    queuedFinal?: boolean;
+    counts?: {
+        final?: number;
+    };
+};
+export type SystemEventOpts = {
+    sessionKey: string;
+    contextKey: string;
+};
+export type ChunkMode = "length" | "newline";
+export interface PluginRuntime {
+    channel: {
+        media: {
+            saveMediaBuffer: (buffer: Buffer, mimeType: string, direction: string, opts: unknown | undefined, filename: string) => Promise<SaveMediaResult>;
+        };
+        routing: {
+            resolveAgentRoute: (opts: ResolveAgentRouteOpts) => AgentRoute;
+        };
+        reply: {
+            resolveEnvelopeFormatOptions: (cfg: OpenClawConfig) => EnvelopeFormatOptions;
+            formatAgentEnvelope: (opts: FormatAgentEnvelopeOpts) => string;
+            finalizeInboundContext: (opts: FinalizeInboundContextOpts) => InboundContext;
+            createReplyDispatcherWithTyping: (opts: {
+                humanDelay: HumanDelayConfig;
+                deliver: (payload: ReplyPayload) => Promise<void>;
+                onError: (err: unknown, info: ReplyErrorInfo) => void;
+            }) => ReplyDispatcherResult;
+            dispatchReplyFromConfig: (opts: {
+                ctx: InboundContext;
+                cfg: OpenClawConfig;
+                dispatcher: unknown;
+                replyOptions: unknown;
+            }) => Promise<DispatchReplyResult>;
+            resolveHumanDelayConfig: (cfg: OpenClawConfig, agentId: string) => HumanDelayConfig;
+        };
+        text: {
+            resolveTextChunkLimit: (cfg: OpenClawConfig, channel: string, accountId: string, opts: {
+                fallbackLimit: number;
+            }) => number;
+            resolveChunkMode: (cfg: OpenClawConfig, channel: string) => ChunkMode;
+            chunkTextWithMode: (text: string, limit: number, mode: ChunkMode) => string[];
+        };
+    };
+    system: {
+        enqueueSystemEvent: (message: string, opts: SystemEventOpts) => void;
+    };
+    state?: {
+        resolveStateDir?: () => string;
+    };
+    /** Optional error logger exposed by some runtime implementations. */
+    error?: (...args: unknown[]) => void;
+    [key: string]: unknown;
+}
+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/src/runtime.js

@@ -0,0 +1,22 @@
+/**
+ * Plugin runtime reference
+ * Stores the PluginRuntime provided by OpenClaw gateway at startup.
+ */
+let runtime = null;
+export function setRuntime(next) {
+    runtime = next;
+}
+export function getRuntime() {
+    if (!runtime) {
+        throw new Error("[wechat-kf] 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/src/runtime.js.map

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

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+/** Markdown to Unicode text formatting (shared by both outbound paths) */
+export declare function formatText(text: string): string;
+/** 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;
+}>;

package/dist/src/send-utils.js

@@ -0,0 +1,89 @@
+/**
+ * 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 { MEDIA_DOWNLOAD_TIMEOUT_MS } from "./constants.js";
+import { markdownToUnicode } from "./unicode-format.js";
+/** 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",
+};
+function contentTypeToExt(contentType) {
+    return CONTENT_TYPE_EXT_MAP[contentType] ?? "";
+}
+/** 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 ([".amr", ".mp3", ".wav", ".ogg", ".silk", ".m4a", ".aac"].includes(ext))
+        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(`[wechat-kf] 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 };
+}
+//# sourceMappingURL=send-utils.js.map

package/dist/src/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/src/send.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Send message helpers
+ */
+import type { ResolvedWechatKfAccount } from "./types.js";
+export declare function sendText(account: ResolvedWechatKfAccount, toUser: string, content: string): Promise<{
+    messageId: string;
+}>;

package/dist/src/send.js

@@ -0,0 +1,13 @@
+/**
+ * Send message helpers
+ */
+import { sendTextMessage } from "./api.js";
+export async function sendText(account, toUser, content) {
+    const openKfId = account.openKfId ?? account.accountId;
+    if (!account.corpId || !account.appSecret || !openKfId) {
+        throw new Error("[wechat-kf] missing corpId/appSecret/openKfId for sending");
+    }
+    const result = await sendTextMessage(account.corpId, account.appSecret, toUser, openKfId, content);
+    return { messageId: result.msgid };
+}
+//# sourceMappingURL=send.js.map

package/dist/src/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../src/send.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAgC,EAChC,MAAc,EACd,OAAe;IAEf,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;IACvD,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnG,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AACrC,CAAC"}

package/dist/src/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/src/token.js

@@ -0,0 +1,57 @@
+/**
+ * access_token retrieval and caching
+ */
+import { createHash } from "node:crypto";
+import { TOKEN_FETCH_TIMEOUT_MS } from "./constants.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;
+    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(`[wechat-kf] gettoken HTTP ${resp.status}: ${text.slice(0, 200)}`);
+    }
+    const data = (await resp.json());
+    if (data.errcode !== 0) {
+        throw new Error(`[wechat-kf] gettoken failed: ${data.errcode} ${data.errmsg}`);
+    }
+    cache.set(cacheKey, {
+        token: data.access_token,
+        expiresAt: Date.now() + data.expires_in * 1000,
+    });
+    return data.access_token;
+}
+/** Clear cached token (e.g. on auth error) */
+export function clearAccessToken(corpId, appSecret) {
+    cache.delete(makeCacheKey(corpId, appSecret));
+}
+//# sourceMappingURL=token.js.map

package/dist/src/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/token.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,SAAiB;IAC5D,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/E,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;AAC7B,CAAC;AAOD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;AAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEnD,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,kCAAkC;AAE3E,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,SAAiB;IACpE,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEnC,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,iBAAiB,EAAE,CAAC;QAChE,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,2DAA2D;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,SAAiB,EAAE,QAAgB;IACjF,0DAA0D;IAC1D,MAAM,GAAG,GAAG,uDAAuD,kBAAkB,CAAC,MAAM,CAAC,eAAe,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;IAC5I,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC5B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,sBAAsB,CAAC;KACpD,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAA8B,CAAC;IAE9D,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;QAClB,KAAK,EAAE,IAAI,CAAC,YAAY;QACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI;KAC/C,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,YAAY,CAAC;AAC3B,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,SAAiB;IAChE,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,173 @@
+export type WechatKfConfig = {
+    enabled?: boolean;
+    corpId?: string;
+    appSecret?: string;
+    token?: string;
+    encodingAESKey?: string;
+    webhookPort?: number;
+    webhookPath?: string;
+    dmPolicy?: "open" | "pairing" | "allowlist" | "disabled";
+    allowFrom?: string[];
+};
+export type OpenClawConfig = {
+    channels?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+export type ResolvedWechatKfAccount = {
+    accountId: string;
+    enabled: boolean;
+    configured: boolean;
+    corpId?: string;
+    appSecret?: string;
+    token?: string;
+    encodingAESKey?: string;
+    openKfId?: string;
+    webhookPort: number;
+    webhookPath: string;
+    config: WechatKfConfig;
+};
+export type WechatAccessTokenResponse = {
+    errcode: number;
+    errmsg: string;
+    access_token: string;
+    expires_in: number;
+};
+export type WechatKfSyncMsgRequest = {
+    cursor?: string;
+    token?: string;
+    limit?: number;
+    voice_format?: number;
+    open_kfid?: string;
+};
+export type WechatKfMergedMsgItem = {
+    sender_name?: string;
+    msg_content?: string;
+};
+export type WechatKfMessage = {
+    msgid: string;
+    open_kfid: string;
+    external_userid: string;
+    send_time: number;
+    origin: number;
+    servicer_userid?: string;
+    msgtype: string;
+    text?: {
+        content: string;
+    };
+    image?: {
+        media_id: string;
+    };
+    voice?: {
+        media_id: string;
+    };
+    video?: {
+        media_id: string;
+    };
+    file?: {
+        media_id: string;
+    };
+    location?: {
+        latitude: number;
+        longitude: number;
+        name: string;
+        address: string;
+    };
+    link?: {
+        title: string;
+        desc: string;
+        url: string;
+        pic_url: string;
+    };
+    event?: {
+        event_type: string;
+        open_kfid?: string;
+        external_userid?: string;
+        scene?: string;
+        scene_param?: string;
+        welcome_code?: string;
+        fail_msgid?: string;
+        fail_type?: number;
+        servicer_userid?: string;
+        status?: number;
+    };
+    merged_msg?: {
+        title?: string;
+        item?: WechatKfMergedMsgItem[];
+    };
+    channels?: {
+        nickname?: string;
+        title?: string;
+        sub_type?: number;
+    };
+    miniprogram?: {
+        title?: string;
+        appid?: string;
+        pagepath?: string;
+    };
+    business_card?: {
+        userid?: string;
+    };
+    msgmenu?: {
+        head_content?: string;
+        list?: {
+            id: string;
+            content?: string;
+        }[];
+        tail_content?: string;
+    };
+};
+export type WechatKfSyncMsgResponse = {
+    errcode: number;
+    errmsg: string;
+    next_cursor: string;
+    has_more: number;
+    msg_list: WechatKfMessage[];
+};
+export type WechatKfSendMsgRequest = {
+    touser: string;
+    open_kfid: string;
+    msgid?: string;
+    msgtype: string;
+    text?: {
+        content: string;
+    };
+    image?: {
+        media_id: string;
+    };
+    file?: {
+        media_id: string;
+    };
+    voice?: {
+        media_id: string;
+    };
+    video?: {
+        media_id: string;
+    };
+    link?: {
+        title: string;
+        desc?: string;
+        url: string;
+        thumb_media_id: string;
+    };
+};
+export type WechatKfSendMsgResponse = {
+    errcode: number;
+    errmsg: string;
+    msgid: string;
+};
+export type WechatMediaUploadResponse = {
+    errcode: number;
+    errmsg: string;
+    type: string;
+    media_id: string;
+    created_at: number;
+};
+export type WechatCallbackXml = {
+    ToUserName: string;
+    CreateTime: string;
+    MsgType: string;
+    Event?: string;
+    Token?: string;
+    OpenKfId?: string;
+    Encrypt?: string;
+};

package/dist/src/types.js

@@ -0,0 +1,3 @@
+// ── WeChat KF Plugin Types ──
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,+BAA+B"}

package/dist/src/unicode-format.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Markdown → Unicode text formatting
+ *
+ * Converts markdown bold/italic/bold-italic to Unicode Mathematical
+ * Alphanumeric Symbols. Only converts ASCII letters (a-z, A-Z) and
+ * digits (0-9) — other characters pass through unchanged.
+ *
+ * This is meant for plain-text surfaces like WeChat KF where
+ * rich text / HTML isn't supported.
+ */
+/**
+ * Convert markdown formatting to Unicode styled text.
+ *
+ * Handles:
+ * - `***text***` or `___text___` → bold italic
+ * - `**text**` or `__text__` → bold
+ * - `*text*` or `_text_` → italic
+ * - `` `code` `` → left as-is (backtick preserved)
+ * - ``` code blocks ``` → left as-is
+ * - `# headings` → 𝗛𝗲𝗮𝗱𝗶𝗻𝗴 (bold, # stripped)
+ * - `- list items` / `* list items` → • item
+ * - `1. numbered` → 1. (kept)
+ * - `[text](url)` → text (url)
+ * - `~~strikethrough~~` → stripped markers (no unicode strikethrough that's reliable)
+ */
+export declare function markdownToUnicode(text: string): string;