@zhin.js/adapter-weixin-ilink 0.1.0

package/lib/routes.d.ts

@@ -0,0 +1,8 @@
+/**
+ * weixin-ilink HTTP 路由
+ */
+import type { Router } from "@zhin.js/host-router";
+import type { Plugin } from "zhin.js";
+import type { WeixinIlinkAdapter } from "./adapter.js";
+export declare function registerRoutes(router: Router, adapter: WeixinIlinkAdapter, root: Plugin): void;
+//# sourceMappingURL=routes.d.ts.map

package/lib/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,GACX,IAAI,CA0BN"}

package/lib/routes.js

@@ -0,0 +1,29 @@
+import { registerLoginAssistRoutes } from "./login-assist-routes.js";
+export function registerRoutes(router, adapter, root) {
+    registerLoginAssistRoutes(router, root);
+    router.get("/api/weixin-ilink/bots", async (ctx) => {
+        try {
+            const bots = Array.from(adapter.bots.values());
+            const data = bots.map((bot) => ({
+                name: bot.$config.name,
+                connected: bot.$connected,
+                status: bot.$connected ? "online" : "offline",
+                hasCredentials: Boolean(bot.hasCredentials),
+            }));
+            ctx.body = {
+                success: true,
+                data,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        catch (error) {
+            ctx.status = 500;
+            ctx.body = {
+                success: false,
+                error: "WEIXIN_ILINK_API_ERROR",
+                message: error.message,
+            };
+        }
+    });
+}
+//# sourceMappingURL=routes.js.map

package/lib/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,OAA2B,EAC3B,IAAY;IAEZ,yBAAyB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAExC,MAAM,CAAC,GAAG,CAAC,wBAAwB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC9B,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI;gBACtB,SAAS,EAAE,GAAG,CAAC,UAAU;gBACzB,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBAC7C,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;aAC5C,CAAC,CAAC,CAAC;YACJ,GAAG,CAAC,IAAI,GAAG;gBACT,OAAO,EAAE,IAAI;gBACb,IAAI;gBACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;YACjB,GAAG,CAAC,IAAI,GAAG;gBACT,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,wBAAwB;gBAC/B,OAAO,EAAG,KAAe,CAAC,OAAO;aAClC,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/lib/silk-transcode.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Try to transcode a SILK audio buffer to WAV using silk-wasm.
+ * silk-wasm's decode() returns { data: Uint8Array (pcm_s16le), duration: number }.
+ *
+ * Returns a WAV Buffer on success, or null if silk-wasm is unavailable or decoding fails.
+ * Callers should fall back to passing the raw SILK file when null is returned.
+ */
+export declare function silkToWav(silkBuf: Buffer): Promise<Buffer | null>;
+//# sourceMappingURL=silk-transcode.d.ts.map

package/lib/silk-transcode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"silk-transcode.d.ts","sourceRoot":"","sources":["../src/silk-transcode.ts"],"names":[],"mappings":"AAiDA;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBvE"}

package/lib/silk-transcode.js

@@ -0,0 +1,64 @@
+import { logger } from "./ilink-logger.js";
+/** Default sample rate for Weixin voice messages. */
+const SILK_SAMPLE_RATE = 24_000;
+/**
+ * Wrap raw pcm_s16le bytes in a WAV container.
+ * Mono channel, 16-bit signed little-endian.
+ */
+function pcmBytesToWav(pcm, sampleRate) {
+    const pcmBytes = pcm.byteLength;
+    const totalSize = 44 + pcmBytes;
+    const buf = Buffer.allocUnsafe(totalSize);
+    let offset = 0;
+    buf.write("RIFF", offset);
+    offset += 4;
+    buf.writeUInt32LE(totalSize - 8, offset);
+    offset += 4;
+    buf.write("WAVE", offset);
+    offset += 4;
+    buf.write("fmt ", offset);
+    offset += 4;
+    buf.writeUInt32LE(16, offset);
+    offset += 4; // fmt chunk size
+    buf.writeUInt16LE(1, offset);
+    offset += 2; // PCM format
+    buf.writeUInt16LE(1, offset);
+    offset += 2; // mono
+    buf.writeUInt32LE(sampleRate, offset);
+    offset += 4;
+    buf.writeUInt32LE(sampleRate * 2, offset);
+    offset += 4; // byte rate (mono 16-bit)
+    buf.writeUInt16LE(2, offset);
+    offset += 2; // block align
+    buf.writeUInt16LE(16, offset);
+    offset += 2; // bits per sample
+    buf.write("data", offset);
+    offset += 4;
+    buf.writeUInt32LE(pcmBytes, offset);
+    offset += 4;
+    Buffer.from(pcm.buffer, pcm.byteOffset, pcm.byteLength).copy(buf, offset);
+    return buf;
+}
+/**
+ * Try to transcode a SILK audio buffer to WAV using silk-wasm.
+ * silk-wasm's decode() returns { data: Uint8Array (pcm_s16le), duration: number }.
+ *
+ * Returns a WAV Buffer on success, or null if silk-wasm is unavailable or decoding fails.
+ * Callers should fall back to passing the raw SILK file when null is returned.
+ */
+export async function silkToWav(silkBuf) {
+    try {
+        const { decode } = await import("silk-wasm");
+        logger.debug(`silkToWav: decoding ${silkBuf.length} bytes of SILK`);
+        const result = await decode(silkBuf, SILK_SAMPLE_RATE);
+        logger.debug(`silkToWav: decoded duration=${result.duration}ms pcmBytes=${result.data.byteLength}`);
+        const wav = pcmBytesToWav(result.data, SILK_SAMPLE_RATE);
+        logger.debug(`silkToWav: WAV size=${wav.length}`);
+        return wav;
+    }
+    catch (err) {
+        logger.warn(`silkToWav: transcode failed, will use raw silk err=${String(err)}`);
+        return null;
+    }
+}
+//# sourceMappingURL=silk-transcode.js.map

package/lib/silk-transcode.js.map

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

package/lib/types.d.ts

@@ -0,0 +1,26 @@
+export interface WeixinIlinkBotConfig {
+    context: "weixin-ilink";
+    name: string;
+    /** 观测用 bot_agent，默认 Zhin.js/<version> */
+    botAgent?: string;
+    /** iLink API 根地址，默认 https://ilinkai.weixin.qq.com */
+    baseUrl?: string;
+    /** CDN 根地址 */
+    cdnBaseUrl?: string;
+    /** 长轮询超时（ms），默认 35000 */
+    longPollTimeoutMs?: number;
+    /** 直接配置 token（优先于侧车凭证文件） */
+    botToken?: string;
+    typingIndicator?: {
+        enabled?: boolean;
+        /** sendTyping 保活间隔（ms） */
+        keepaliveIntervalMs?: number;
+        privateConfig?: {
+            type?: "typing";
+            autoRemove?: boolean;
+            platformConfig?: Record<string, unknown>;
+        };
+    };
+}
+export type { WeixinMessage, MessageItem } from "./ilink-types.js";
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,0BAA0B;QAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,aAAa,CAAC,EAAE;YACd,IAAI,CAAC,EAAE,QAAQ,CAAC;YAChB,UAAU,CAAC,EAAE,OAAO,CAAC;YACrB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SAC1C,CAAC;KACH,CAAC;CACH;AAED,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

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

package/lib/typing-indicator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 微信 iLink Typing Indicator（iLink sendTyping API → 微信「正在输入」）
+ */
+import type { WeixinIlinkBot } from "./bot.js";
+import { type TypingIndicator, type TypingIndicatorConfig } from "@zhin.js/agent";
+export interface WeixinIlinkTypingIndicatorConfig {
+    enabled?: boolean;
+    /** sendTyping 保活间隔（ms），长任务期间重复发送；默认 5000 */
+    keepaliveIntervalMs?: number;
+    privateConfig?: Partial<TypingIndicatorConfig>;
+}
+export declare class WeixinIlinkTypingIndicatorManager {
+    private manager;
+    private config;
+    private bot;
+    constructor(bot: WeixinIlinkBot, config?: WeixinIlinkTypingIndicatorConfig);
+    private registerAdapter;
+    start(options: {
+        messageId?: string;
+        sessionId: string;
+        userId?: string;
+        groupId?: string;
+        sceneType: "private" | "group";
+    }): Promise<TypingIndicator>;
+    stop(options: {
+        sessionId: string;
+        userId?: string;
+        groupId?: string;
+    }): Promise<void>;
+}
+export declare function enableTypingIndicator(bot: WeixinIlinkBot, config?: WeixinIlinkTypingIndicatorConfig): WeixinIlinkTypingIndicatorManager;
+//# sourceMappingURL=typing-indicator.d.ts.map

package/lib/typing-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-indicator.d.ts","sourceRoot":"","sources":["../src/typing-indicator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAE3B,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,gCAAgC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAChD;AAYD,qBAAa,iCAAiC;IAC5C,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,GAAG,CAAiB;gBAEhB,GAAG,EAAE,cAAc,EAAE,MAAM,GAAE,gCAAqC;IAsB9E,OAAO,CAAC,eAAe;IAiBjB,KAAK,CAAC,OAAO,EAAE;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC;KAChC,GAAG,OAAO,CAAC,eAAe,CAAC;IAuBtB,IAAI,CAAC,OAAO,EAAE;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;CAWlB;AAaD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,cAAc,EACnB,MAAM,CAAC,EAAE,gCAAgC,GACxC,iCAAiC,CAInC"}

package/lib/typing-indicator.js

@@ -0,0 +1,95 @@
+import { NativeTypingIndicatorAdapter, TypingIndicatorManager, } from "@zhin.js/agent";
+import { TypingStatus } from "./ilink-types.js";
+const DEFAULT_CONFIG = {
+    enabled: true,
+    keepaliveIntervalMs: 5_000,
+    privateConfig: {
+        type: "typing",
+        autoRemove: true,
+        platformConfig: { keepaliveIntervalMs: 5_000 },
+    },
+};
+export class WeixinIlinkTypingIndicatorManager {
+    manager;
+    config;
+    bot;
+    constructor(bot, config = {}) {
+        this.bot = bot;
+        this.config = {
+            ...DEFAULT_CONFIG,
+            ...config,
+            privateConfig: {
+                ...DEFAULT_CONFIG.privateConfig,
+                ...config.privateConfig,
+                platformConfig: {
+                    keepaliveIntervalMs: config.keepaliveIntervalMs ?? DEFAULT_CONFIG.keepaliveIntervalMs,
+                    ...config.privateConfig?.platformConfig,
+                },
+            },
+        };
+        this.manager = new TypingIndicatorManager({
+            type: "typing",
+            autoRemove: true,
+        });
+        this.registerAdapter();
+    }
+    registerAdapter() {
+        const adapter = new NativeTypingIndicatorAdapter("weixin-ilink", async (options) => {
+            const peerId = resolvePeerId(options);
+            if (!peerId)
+                return;
+            await this.bot.sendTypingToUser(peerId, TypingStatus.TYPING);
+        }, async (options) => {
+            const peerId = resolvePeerId(options);
+            if (!peerId)
+                return;
+            await this.bot.sendTypingToUser(peerId, TypingStatus.CANCEL);
+        });
+        this.manager.registerAdapter(adapter);
+    }
+    async start(options) {
+        if (!this.config.enabled) {
+            return {
+                start: async () => { },
+                stop: async () => { },
+                isActive: () => false,
+            };
+        }
+        const peerId = resolvePeerId(options);
+        const typingOptions = {
+            messageId: options.messageId,
+            sessionId: options.sessionId,
+            userId: peerId,
+            groupId: options.groupId,
+            platform: "weixin-ilink",
+            botId: this.bot.$id,
+            sceneType: "private",
+        };
+        return this.manager.start(typingOptions, this.config.privateConfig);
+    }
+    async stop(options) {
+        const peerId = resolvePeerId(options);
+        await this.manager.stop({
+            sessionId: options.sessionId,
+            userId: peerId,
+            groupId: options.groupId,
+            platform: "weixin-ilink",
+            botId: this.bot.$id,
+            sceneType: "private",
+        });
+    }
+}
+function resolvePeerId(options) {
+    const raw = options.userId?.trim()
+        || (options.sessionId ? options.sessionId.split(":").filter(Boolean).at(-1) : undefined);
+    if (!raw)
+        return undefined;
+    const hash = raw.indexOf("#");
+    return hash >= 0 ? raw.slice(0, hash) : raw;
+}
+export function enableTypingIndicator(bot, config) {
+    const manager = new WeixinIlinkTypingIndicatorManager(bot, config);
+    bot.$typingIndicator = manager;
+    return manager;
+}
+//# sourceMappingURL=typing-indicator.js.map

package/lib/typing-indicator.js.map

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

package/lib/upload.d.ts

@@ -0,0 +1,43 @@
+import type { WeixinApiOptions } from "./ilink-api.js";
+export type UploadedFileInfo = {
+    filekey: string;
+    /** 由 upload_param 上传后 CDN 返回的下载加密参数; fill into ImageItem.media.encrypt_query_param */
+    downloadEncryptedQueryParam: string;
+    /** AES-128-ECB key, hex-encoded; convert to base64 for CDNMedia.aes_key */
+    aeskey: string;
+    /** Plaintext file size in bytes */
+    fileSize: number;
+    /** Ciphertext file size in bytes (AES-128-ECB with PKCS7 padding); use for ImageItem.hd_size / mid_size */
+    fileSizeCiphertext: number;
+};
+/**
+ * Download a remote media URL (image, video, file) to a local temp file in destDir.
+ * Returns the local file path; extension is inferred from Content-Type / URL.
+ */
+export declare function downloadRemoteImageToTemp(url: string, destDir: string): Promise<string>;
+/** Upload a local image file to the Weixin CDN with AES-128-ECB encryption. */
+export declare function uploadFileToWeixin(params: {
+    filePath: string;
+    toUserId: string;
+    opts: WeixinApiOptions;
+    cdnBaseUrl: string;
+}): Promise<UploadedFileInfo>;
+/** Upload a local video file to the Weixin CDN. */
+export declare function uploadVideoToWeixin(params: {
+    filePath: string;
+    toUserId: string;
+    opts: WeixinApiOptions;
+    cdnBaseUrl: string;
+}): Promise<UploadedFileInfo>;
+/**
+ * Upload a local file attachment (non-image, non-video) to the Weixin CDN.
+ * Uses media_type=FILE; no thumbnail required.
+ */
+export declare function uploadFileAttachmentToWeixin(params: {
+    filePath: string;
+    fileName: string;
+    toUserId: string;
+    opts: WeixinApiOptions;
+    cdnBaseUrl: string;
+}): Promise<UploadedFileInfo>;
+//# sourceMappingURL=upload.d.ts.map

package/lib/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAQvD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,2BAA2B,EAAE,MAAM,CAAC;IACpC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,2GAA2G;IAC3G,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB7F;AAkED,+EAA+E;AAC/E,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAM5B;AAED,mDAAmD;AACnD,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAM5B;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAM5B"}

package/lib/upload.js

@@ -0,0 +1,106 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { getUploadUrl } from "./ilink-api.js";
+import { aesEcbPaddedSize } from "./aes-ecb.js";
+import { uploadBufferToCdn } from "./cdn-upload.js";
+import { logger } from "./ilink-logger.js";
+import { getExtensionFromContentTypeOrUrl } from "./mime.js";
+import { tempFileName } from "./ilink-random.js";
+import { UploadMediaType } from "./ilink-types.js";
+/**
+ * Download a remote media URL (image, video, file) to a local temp file in destDir.
+ * Returns the local file path; extension is inferred from Content-Type / URL.
+ */
+export async function downloadRemoteImageToTemp(url, destDir) {
+    logger.debug(`downloadRemoteImageToTemp: fetching url=${url}`);
+    const res = await fetch(url);
+    if (!res.ok) {
+        const msg = `remote media download failed: ${res.status} ${res.statusText} url=${url}`;
+        logger.error(`downloadRemoteImageToTemp: ${msg}`);
+        throw new Error(msg);
+    }
+    const buf = Buffer.from(await res.arrayBuffer());
+    logger.debug(`downloadRemoteImageToTemp: downloaded ${buf.length} bytes`);
+    await fs.mkdir(destDir, { recursive: true });
+    const ext = getExtensionFromContentTypeOrUrl(res.headers.get("content-type"), url);
+    const name = tempFileName("weixin-remote", ext);
+    const filePath = path.join(destDir, name);
+    await fs.writeFile(filePath, buf);
+    logger.debug(`downloadRemoteImageToTemp: saved to ${filePath} ext=${ext}`);
+    return filePath;
+}
+/**
+ * Common upload pipeline: read file → hash → gen aeskey → getUploadUrl → uploadBufferToCdn → return info.
+ */
+async function uploadMediaToCdn(params) {
+    const { filePath, toUserId, opts, cdnBaseUrl, mediaType, label } = params;
+    const plaintext = await fs.readFile(filePath);
+    const rawsize = plaintext.length;
+    const rawfilemd5 = crypto.createHash("md5").update(plaintext).digest("hex");
+    const filesize = aesEcbPaddedSize(rawsize);
+    const filekey = crypto.randomBytes(16).toString("hex");
+    const aeskey = crypto.randomBytes(16);
+    logger.debug(`${label}: file=${filePath} rawsize=${rawsize} filesize=${filesize} md5=${rawfilemd5} filekey=${filekey}`);
+    const uploadUrlResp = await getUploadUrl({
+        ...opts,
+        filekey,
+        media_type: mediaType,
+        to_user_id: toUserId,
+        rawsize,
+        rawfilemd5,
+        filesize,
+        no_need_thumb: true,
+        aeskey: aeskey.toString("hex"),
+    });
+    const uploadFullUrl = uploadUrlResp.upload_full_url?.trim();
+    const uploadParam = uploadUrlResp.upload_param;
+    if (!uploadFullUrl && !uploadParam) {
+        logger.error(`${label}: getUploadUrl returned no upload URL (need upload_full_url or upload_param), resp=${JSON.stringify(uploadUrlResp)}`);
+        throw new Error(`${label}: getUploadUrl returned no upload URL`);
+    }
+    const { downloadParam: downloadEncryptedQueryParam } = await uploadBufferToCdn({
+        buf: plaintext,
+        uploadFullUrl: uploadFullUrl || undefined,
+        uploadParam: uploadParam ?? undefined,
+        filekey,
+        cdnBaseUrl,
+        aeskey,
+        label: `${label}[orig filekey=${filekey}]`,
+    });
+    return {
+        filekey,
+        downloadEncryptedQueryParam,
+        aeskey: aeskey.toString("hex"),
+        fileSize: rawsize,
+        fileSizeCiphertext: filesize,
+    };
+}
+/** Upload a local image file to the Weixin CDN with AES-128-ECB encryption. */
+export async function uploadFileToWeixin(params) {
+    return uploadMediaToCdn({
+        ...params,
+        mediaType: UploadMediaType.IMAGE,
+        label: "uploadFileToWeixin",
+    });
+}
+/** Upload a local video file to the Weixin CDN. */
+export async function uploadVideoToWeixin(params) {
+    return uploadMediaToCdn({
+        ...params,
+        mediaType: UploadMediaType.VIDEO,
+        label: "uploadVideoToWeixin",
+    });
+}
+/**
+ * Upload a local file attachment (non-image, non-video) to the Weixin CDN.
+ * Uses media_type=FILE; no thumbnail required.
+ */
+export async function uploadFileAttachmentToWeixin(params) {
+    return uploadMediaToCdn({
+        ...params,
+        mediaType: UploadMediaType.FILE,
+        label: "uploadFileAttachmentToWeixin",
+    });
+}
+//# sourceMappingURL=upload.js.map

package/lib/upload.js.map

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

package/lib/weixin-inbound.d.ts

@@ -0,0 +1,71 @@
+import type { WeixinMessage, MessageItem } from "./ilink-types.js";
+/**
+ * Restore persisted context tokens for an account into the in-memory map.
+ * Called once during gateway startAccount to survive restarts.
+ */
+export declare function restoreContextTokens(accountId: string): void;
+/** Remove all context tokens for a given account (memory + disk). */
+export declare function clearContextTokensForAccount(accountId: string): void;
+/** Store a context token for a given account+user pair (memory + disk). */
+export declare function setContextToken(accountId: string, userId: string, token: string): void;
+/** Retrieve the cached context token for a given account+user pair. */
+export declare function getContextToken(accountId: string, userId: string): string | undefined;
+/**
+ * Find all accountIds that have an active contextToken for the given userId.
+ * Used to infer the sending bot account from the recipient address when
+ * accountId is not explicitly provided (e.g. cron delivery).
+ *
+ * Returns all matching accountIds (not just the first) so the caller can
+ * detect ambiguity when multiple accounts have sessions with the same user.
+ */
+export declare function findAccountIdsByContextToken(accountIds: string[], userId: string): string[];
+/** Inbound context passed to the OpenClaw core pipeline (matches MsgContext shape). */
+export type WeixinMsgContext = {
+    Body: string;
+    From: string;
+    To: string;
+    AccountId: string;
+    OriginatingChannel: "openclaw-weixin";
+    OriginatingTo: string;
+    MessageSid: string;
+    Timestamp?: number;
+    Provider: "openclaw-weixin";
+    ChatType: "direct";
+    /** Set by monitor after resolveAgentRoute so dispatchReplyFromConfig uses the correct session. */
+    SessionKey?: string;
+    context_token?: string;
+    MediaUrl?: string;
+    MediaPath?: string;
+    MediaType?: string;
+    /** Raw message body for framework command authorization. */
+    CommandBody?: string;
+    /** Whether the sender is authorized to execute slash commands. */
+    CommandAuthorized?: boolean;
+};
+/** Returns true if the message item is a media type (image, video, file, or voice). */
+export declare function isMediaItem(item: MessageItem): boolean;
+export declare function bodyFromItemList(itemList?: MessageItem[]): string;
+export type WeixinInboundMediaOpts = {
+    /** Local path to decrypted image file. */
+    decryptedPicPath?: string;
+    /** Local path to transcoded/raw voice file (.wav or .silk). */
+    decryptedVoicePath?: string;
+    /** MIME type for the voice file (e.g. "audio/wav" or "audio/silk"). */
+    voiceMediaType?: string;
+    /** Local path to decrypted file attachment. */
+    decryptedFilePath?: string;
+    /** MIME type for the file attachment (guessed from file_name). */
+    fileMediaType?: string;
+    /** Local path to decrypted video file. */
+    decryptedVideoPath?: string;
+};
+/**
+ * Convert a WeixinMessage from getUpdates to the inbound MsgContext for the core pipeline.
+ * Media: only pass MediaPath (local file, after CDN download + decrypt).
+ * We never pass MediaUrl — the upstream CDN URL is encrypted/auth-only.
+ * Priority when multiple media types present: image > video > file > voice.
+ */
+export declare function weixinMessageToMsgContext(msg: WeixinMessage, accountId: string, opts?: WeixinInboundMediaOpts): WeixinMsgContext;
+/** Extract the context_token from an inbound WeixinMsgContext. */
+export declare function getContextTokenFromMsgContext(ctx: WeixinMsgContext): string | undefined;
+//# sourceMappingURL=weixin-inbound.d.ts.map

package/lib/weixin-inbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weixin-inbound.d.ts","sourceRoot":"","sources":["../src/weixin-inbound.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA8CnE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAiB5D;AAED,qEAAqE;AACrE,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAcpE;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKtF;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOrF;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,MAAM,GACb,MAAM,EAAE,CAEV;AAUD,uFAAuF;AACvF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAOtD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,CAyBjE;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,sBAAsB,GAC5B,gBAAgB,CAiClB;AAED,kEAAkE;AAClE,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAEvF"}