@zhin.js/adapter-weixin-ilink 1.0.1 → 1.1.2

package/lib/index.js

@@ -1,38 +1,7 @@
-/**
- * 微信 iLink（ClawBot）适配器入口
- */
-import path from "node:path";
-import { usePlugin } from "zhin.js";
-import { WeixinIlinkAdapter } from "./adapter.js";
-import { registerRoutes } from "./routes.js";
-export * from "./types.js";
-export { WeixinIlinkEndpoint } from "./endpoint.js";
-export { WeixinIlinkAdapter } from "./adapter.js";
-export { WeixinIlinkTypingIndicatorManager, enableTypingIndicator, } from "./typing-indicator.js";
-export { registerLoginAssistRoutes } from "./login-assist-routes.js";
-const plugin = usePlugin();
-const { provide, useContext, root } = plugin;
-provide({
-    name: "weixin-ilink",
-    description: "WeChat personal account via Tencent iLink Endpoint API (ClawBot)",
-    mounted: async (p) => {
-        const adapter = new WeixinIlinkAdapter(p);
-        await adapter.start();
-        return adapter;
-    },
-    dispose: async (adapter) => {
-        await adapter.stop();
-    },
-});
-useContext("web", (pageManager) => {
-    pageManager.addEntry({
-        id: "weixin-ilink",
-        development: path.resolve(import.meta.dirname, "../client/index.tsx"),
-        production: path.resolve(import.meta.dirname, "../dist/index.js"),
-        meta: { name: "微信 iLink" },
-    });
-});
-useContext("router", "weixin-ilink", async (router, adapter) => {
-    registerRoutes(router, adapter, root);
-});
-//# sourceMappingURL=index.js.map
+export { formatInboundContent, formatOutboundSegments, inboundMessageId, resolveWeixinIlinkConfig, segmentLocalPath, sleep, } from './protocol.js';
+export { WeixinIlinkStateStore, } from './credentials.js';
+export { IlinkClientMetadata, sanitizeBotAgent, } from './ilink-meta.js';
+export { WeixinContextTokenStore } from './context-store.js';
+export { IlinkSessionGuard, SESSION_EXPIRED_ERRCODE, SESSION_PAUSE_DURATION_MS, } from './ilink-session-guard.js';
+export { WeixinIlinkClient, weixinIlinkClient, } from './client.js';
+export { WeixinIlinkEndpoint, } from './endpoint.js';

package/lib/login.d.ts

@@ -1,6 +1,5 @@
-import type { Plugin } from "zhin.js";
-import { type WeixinIlinkCredentials } from "./credentials.js";
-import type { WeixinIlinkEndpointConfig } from "./types.js";
-export declare function resolveCredentials(plugin: Plugin, config: WeixinIlinkEndpointConfig): Promise<WeixinIlinkCredentials>;
-export declare function loginWithQr(plugin: Plugin, config: WeixinIlinkEndpointConfig): Promise<WeixinIlinkCredentials>;
-//# sourceMappingURL=login.d.ts.map
+import type { IlinkClientMetadata } from './ilink-meta.js';
+import { type WeixinIlinkCredentials, type WeixinIlinkStateStore } from './credentials.js';
+import type { ResolvedWeixinIlinkConfig } from './protocol.js';
+export declare function resolveCredentials(config: ResolvedWeixinIlinkConfig, metadata: IlinkClientMetadata, state: WeixinIlinkStateStore, signal?: AbortSignal): Promise<WeixinIlinkCredentials>;
+export declare function loginWithQr(config: ResolvedWeixinIlinkConfig, metadata: IlinkClientMetadata, state: WeixinIlinkStateStore, signal?: AbortSignal): Promise<WeixinIlinkCredentials>;

package/lib/login.js

@@ -1,121 +1,129 @@
-import { apiGetFetch, apiPostFetch } from "./ilink-api.js";
-import { buildBaseInfo, DEFAULT_API_BASE_URL } from "./ilink-meta.js";
-import { logger } from "./ilink-logger.js";
-import { loadCredentials, saveCredentials, } from "./credentials.js";
-const DEFAULT_ILINK_BOT_TYPE = "3";
+/**
+ * Resolve iLink bot credentials (config / endpoint state / QR login).
+ * No legacy Plugin / loginAssist dependency — QR URL is logged for manual scan.
+ */
+import { apiGetFetch, apiPostFetch } from './ilink-api.js';
+import { logger } from './ilink-logger.js';
+const DEFAULT_ILINK_BOT_TYPE = '3';
 const QR_LONG_POLL_TIMEOUT_MS = 35_000;
 const LOGIN_TIMEOUT_MS = 480_000;
 function getLocalBotTokenList() {
     return [];
 }
-async function fetchQRCode(apiBaseUrl, botType) {
+async function fetchQRCode(apiBaseUrl, botType, metadata) {
     const rawText = await apiPostFetch({
         baseUrl: apiBaseUrl,
+        metadata,
         endpoint: `ilink/bot/get_bot_qrcode?bot_type=${encodeURIComponent(botType)}`,
-        body: JSON.stringify({ local_token_list: getLocalBotTokenList(), base_info: buildBaseInfo() }),
-        label: "fetchQRCode",
+        body: JSON.stringify({
+            local_token_list: getLocalBotTokenList(),
+            base_info: metadata.buildBaseInfo(),
+        }),
+        label: 'fetchQRCode',
     });
     return JSON.parse(rawText);
 }
-async function pollQRStatus(apiBaseUrl, qrcode) {
+async function pollQRStatus(apiBaseUrl, qrcode, metadata, signal) {
     try {
         const endpoint = `ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(qrcode)}`;
         const rawText = await apiGetFetch({
             baseUrl: apiBaseUrl,
+            metadata,
             endpoint,
             timeoutMs: QR_LONG_POLL_TIMEOUT_MS,
-            label: "pollQRStatus",
+            label: 'pollQRStatus',
+            abortSignal: signal,
         });
         return JSON.parse(rawText);
     }
     catch (err) {
-        if (err instanceof Error && err.name === "AbortError") {
-            return { status: "wait" };
+        if (err instanceof Error && err.name === 'AbortError') {
+            // 外部 stop 的 abort 不能吞掉当普通长轮询超时
+            if (signal?.aborted)
+                throw err;
+            return { status: 'wait' };
         }
         logger.warn(`pollQRStatus error: ${String(err)}`);
-        return { status: "wait" };
+        return { status: 'wait' };
     }
 }
-export async function resolveCredentials(plugin, config) {
-    const envToken = process.env.WEIXIN_ILINK_TOKEN?.trim() || config.botToken?.trim();
-    if (envToken) {
-        const stored = loadCredentials(config.name);
+function abortError() {
+    return Object.assign(new Error('扫码登录已取消'), { name: 'AbortError' });
+}
+function sleepWithAbort(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(abortError());
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(abortError());
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+export async function resolveCredentials(config, metadata, state, signal) {
+    const configuredToken = config.botToken?.trim();
+    if (configuredToken) {
+        const stored = state.loadCredentials();
         return {
-            botToken: envToken,
+            botToken: configuredToken,
             ilinkUserId: stored?.ilinkUserId,
             ilinkBotId: stored?.ilinkBotId,
-            baseUrl: config.baseUrl ?? stored?.baseUrl ?? DEFAULT_API_BASE_URL,
+            baseUrl: config.baseUrl,
         };
     }
-    const stored = loadCredentials(config.name);
+    const stored = state.loadCredentials();
     if (stored?.botToken) {
         return {
             ...stored,
-            baseUrl: config.baseUrl ?? stored.baseUrl ?? DEFAULT_API_BASE_URL,
+            baseUrl: config.baseUrl,
         };
     }
-    return loginWithQr(plugin, config);
+    return loginWithQr(config, metadata, state, signal);
 }
-export async function loginWithQr(plugin, config) {
-    const apiBaseUrl = config.baseUrl ?? DEFAULT_API_BASE_URL;
-    const qr = await fetchQRCode(apiBaseUrl, DEFAULT_ILINK_BOT_TYPE);
+export async function loginWithQr(config, metadata, state, signal) {
+    const apiBaseUrl = config.baseUrl;
+    const qr = await fetchQRCode(apiBaseUrl, DEFAULT_ILINK_BOT_TYPE, metadata);
     const qrcodeUrl = qr.qrcode_img_content || qr.qrcode;
-    const loginAssist = plugin.inject("loginAssist");
-    if (!loginAssist) {
-        throw new Error("loginAssist 服务不可用，请确保已加载 zhin 核心服务");
-    }
-    void loginAssist.waitForInput("weixin-ilink", config.name, "qrcode", {
-        message: "请用微信扫描 ClawBot 二维码完成登录",
-        image: qrcodeUrl.startsWith("data:") ? qrcodeUrl : undefined,
-        url: qrcodeUrl.startsWith("http") ? qrcodeUrl : undefined,
-        qrcode: qr.qrcode,
-    });
-    const assistTask = loginAssist
-        .listPending()
-        .find((t) => t.adapter === "weixin-ilink" && t.endpointId === config.name);
+    logger.info(`weixin-ilink QR login for ${config.id}: scan with WeChat ClawBot entry — ${qrcodeUrl.slice(0, 120)}${qrcodeUrl.length > 120 ? '…' : ''}`);
     const deadline = Date.now() + LOGIN_TIMEOUT_MS;
     let currentBaseUrl = apiBaseUrl;
-    try {
-        while (Date.now() < deadline) {
-            const status = await pollQRStatus(currentBaseUrl, qr.qrcode);
-            if (status.status === "scaned_but_redirect" && status.redirect_host) {
-                currentBaseUrl = status.redirect_host.startsWith("http")
-                    ? status.redirect_host
-                    : `https://${status.redirect_host}`;
-            }
-            if (status.status === "confirmed" || status.status === "binded_redirect") {
-                if (!status.bot_token && status.status !== "binded_redirect") {
-                    throw new Error("扫码成功但未返回 bot_token");
-                }
-                const creds = {
-                    botToken: status.bot_token ?? loadCredentials(config.name)?.botToken ?? "",
-                    ilinkUserId: status.ilink_user_id,
-                    ilinkBotId: status.ilink_endpoint_id,
-                    baseUrl: status.baseurl ?? currentBaseUrl,
-                };
-                if (!creds.botToken) {
-                    throw new Error("binded_redirect 但本地无有效 bot_token");
-                }
-                saveCredentials(config.name, creds);
-                if (assistTask)
-                    loginAssist.submit(assistTask.id, "confirmed");
-                return creds;
+    while (Date.now() < deadline) {
+        // stop() 的 AbortSignal：不打满 8 分钟，立即退出登录循环
+        if (signal?.aborted)
+            throw abortError();
+        const status = await pollQRStatus(currentBaseUrl, qr.qrcode, metadata, signal);
+        if (status.status === 'scaned_but_redirect' && status.redirect_host) {
+            currentBaseUrl = status.redirect_host.startsWith('http')
+                ? status.redirect_host
+                : `https://${status.redirect_host}`;
+        }
+        if (status.status === 'confirmed' || status.status === 'binded_redirect') {
+            if (!status.bot_token && status.status !== 'binded_redirect') {
+                throw new Error('扫码成功但未返回 bot_token');
             }
-            if (status.status === "expired") {
-                if (assistTask)
-                    loginAssist.cancel(assistTask.id, "expired");
-                throw new Error("二维码已过期，请重启 bot 重新登录");
+            const creds = {
+                botToken: status.bot_token ?? state.loadCredentials()?.botToken ?? '',
+                ilinkUserId: status.ilink_user_id,
+                ilinkBotId: status.ilink_endpoint_id,
+                baseUrl: status.baseurl ?? currentBaseUrl,
+            };
+            if (!creds.botToken) {
+                throw new Error('binded_redirect 但本地无有效 bot_token');
             }
-            await new Promise((r) => setTimeout(r, 500));
+            state.saveCredentials(creds);
+            return creds;
         }
-        if (assistTask)
-            loginAssist.cancel(assistTask.id, "timeout");
-        throw new Error("微信扫码登录超时");
-    }
-    catch (err) {
-        if (assistTask)
-            loginAssist.cancel(assistTask.id, String(err));
-        throw err;
+        if (status.status === 'expired') {
+            throw new Error('二维码已过期，请重启 bot 重新登录');
+        }
+        await sleepWithAbort(500, signal);
     }
+    throw new Error('微信扫码登录超时');
 }
-//# sourceMappingURL=login.js.map

package/lib/media-download.d.ts

@@ -1,5 +1,5 @@
 import type { WeixinInboundMediaOpts } from "./weixin-inbound.js";
-import type { WeixinMessage } from "./ilink-types.js";
+import { type WeixinMessage } from './ilink-types.js';
 /** Persist a buffer via the framework's unified media store. */
 type SaveMediaFn = (buffer: Buffer, contentType?: string, subdir?: string, maxBytes?: number, originalFilename?: string) => Promise<{
     path: string;
@@ -16,4 +16,3 @@ export declare function downloadMediaFromItem(item: WeixinMessage["item_list"] e
     label: string;
 }): Promise<WeixinInboundMediaOpts>;
 export {};
-//# sourceMappingURL=media-download.d.ts.map

package/lib/media-download.js

@@ -2,7 +2,7 @@ import { logger } from "./ilink-logger.js";
 import { getMimeFromFilename } from "./mime.js";
 import { downloadAndDecryptBuffer, downloadPlainCdnBuffer, } from "./pic-decrypt.js";
 import { silkToWav } from "./silk-transcode.js";
-import { MessageItemType } from "./ilink-types.js";
+import { MessageItemType } from './ilink-types.js';
 const WEIXIN_MEDIA_MAX_BYTES = 100 * 1024 * 1024;
 /**
  * Download and decrypt media from a single MessageItem.
@@ -92,4 +92,3 @@ export async function downloadMediaFromItem(item, deps) {
     }
     return result;
 }
-//# sourceMappingURL=media-download.js.map

package/lib/mime.d.ts

@@ -6,4 +6,3 @@ export declare function getExtensionFromMime(mimeType: string): string;
 export declare function sniffMimeFromBuffer(buf: Buffer): string | undefined;
 /** Get file extension from Content-Type header or URL path. Returns ".bin" for unknown. */
 export declare function getExtensionFromContentTypeOrUrl(contentType: string | null, url: string): string;
-//# sourceMappingURL=mime.d.ts.map

package/lib/mime.js

@@ -96,4 +96,3 @@ export function getExtensionFromContentTypeOrUrl(contentType, url) {
     const knownExts = new Set(Object.keys(EXTENSION_TO_MIME));
     return knownExts.has(ext) ? ext : ".bin";
 }
-//# sourceMappingURL=mime.js.map

package/lib/outbound-media.d.ts

@@ -1,5 +1,4 @@
-import type { MessageSegment, SendContent } from "zhin.js";
-export declare function segmentMediaRef(seg: MessageSegment): string | undefined;
-/** 将 base64 / 远程图落盘，供 sendWeixinMediaFile 上传 */
-export declare function materializeOutboundMedia(content: SendContent, outboundDir: string): Promise<SendContent>;
-//# sourceMappingURL=outbound-media.d.ts.map
+import type { WeixinWireSegment } from './protocol.js';
+export type OutboundWireContent = string | WeixinWireSegment | ReadonlyArray<string | WeixinWireSegment>;
+/** 将 canonical MediaRef 媒体段物化为本地文件（kind=path），供 sendWeixinMediaFile 上传 */
+export declare function materializeOutboundMedia(content: OutboundWireContent, outboundDir: string): Promise<OutboundWireContent>;

package/lib/outbound-media.js

@@ -1,122 +1,121 @@
 /**
- * 微信 iLink 出站媒体：base64 / 远程 URL 须落盘后再走 CDN 上传。
+ * 微信 iLink 出站媒体物化：canonical MediaRef（`data.media`，MediaRef-only）→ 本地文件，
+ * 再由 sendWeixinMediaFile 走 CDN 上传。
+ * - kind=url    → 下载落盘后上传；
+ * - kind=base64 → 解码落盘后上传；
+ * - kind=path   → 本地文件直接上传；
+ * - kind=file   → 微信无不透明平台引用投递面，warn 丢弃。
+ * 无 media 或物化失败的媒体段 warn 丢弃（weixin_ilink_outbound_media_dropped）。
  */
-import crypto from "node:crypto";
-import fs from "node:fs";
-import path from "node:path";
-import { downloadRemoteImageToTemp } from "./upload.js";
-import { getExtensionFromMime } from "./mime.js";
-const MEDIA_TYPES = new Set(["image", "video", "file", "record", "audio"]);
-function isRemoteUrl(value) {
-    return /^https?:\/\//i.test(value);
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { isMediaRef } from '@zhin.js/im-contract';
+import { formatCompact, getLogger } from '@zhin.js/logger';
+import { downloadRemoteImageToTemp } from './upload.js';
+import { getExtensionFromMime } from './mime.js';
+const logger = getLogger('weixin-ilink');
+const MEDIA_TYPES = new Set(['image', 'video', 'file', 'record', 'audio']);
+function dropMediaSegment(type, reason) {
+    logger.warn(formatCompact({
+        op: 'weixin_ilink_outbound_media_dropped',
+        type,
+        reason,
+    }));
+    return null;
 }
-function isInlineMediaRef(value) {
-    return value.startsWith("base64://") || /^data:[^/]+\/[^;]+;base64,/i.test(value);
-}
-function normalizeLocalPath(value) {
-    return value.replace(/^file:\/\//, "");
-}
-export function segmentMediaRef(seg) {
-    const data = seg.data;
-    const candidates = [data.file, data.path, data.url].filter((v) => typeof v === "string" && Boolean(v));
-    return candidates[0];
-}
-function extractBase64Buffer(data) {
-    const url = typeof data.url === "string" ? data.url : undefined;
-    const file = typeof data.file === "string" ? data.file : undefined;
-    const base64 = typeof data.base64 === "string" ? data.base64 : undefined;
-    if (url?.startsWith("base64://")) {
-        return Buffer.from(url.slice(9), "base64");
-    }
-    if (url && /^data:[^/]+\/[^;]+;base64,/i.test(url)) {
-        return Buffer.from(url.replace(/^data:[^/]+\/[^;]+;base64,/, ""), "base64");
-    }
-    if (file?.startsWith("base64://")) {
-        return Buffer.from(file.slice(9), "base64");
-    }
-    if (base64) {
-        const raw = base64.startsWith("base64://") ? base64.slice(9) : base64;
-        return Buffer.from(raw, "base64");
-    }
-    return undefined;
-}
-function resolveExt(seg, mime) {
-    const data = seg.data;
-    const name = typeof data.name === "string" ? data.name : undefined;
-    if (name) {
-        const ext = path.extname(name);
+function resolveExt(seg, media) {
+    if (media.file_name) {
+        const ext = path.extname(media.file_name);
         if (ext)
             return ext;
     }
-    const mimeHint = mime ?? (typeof data.mime === "string" ? data.mime : typeof data.mimeType === "string" ? data.mimeType : undefined);
-    if (mimeHint) {
-        return getExtensionFromMime(mimeHint) ?? ".bin";
+    if (media.mime_type) {
+        return getExtensionFromMime(media.mime_type) ?? '.bin';
     }
-    if (seg.type === "image")
-        return ".png";
-    if (seg.type === "video")
-        return ".mp4";
-    if (seg.type === "record" || seg.type === "audio")
-        return ".mp3";
-    return ".bin";
+    if (seg.type === 'image')
+        return '.png';
+    if (seg.type === 'video')
+        return '.mp4';
+    if (seg.type === 'record' || seg.type === 'audio')
+        return '.mp3';
+    return '.bin';
 }
-function withLocalFile(seg, filePath) {
-    const data = { ...seg.data, file: filePath };
-    delete data.base64;
-    return { type: seg.type, data };
+function withLocalPath(seg, media, filePath) {
+    return {
+        type: seg.type,
+        data: { ...(seg.data ?? {}), media: { ...media, kind: 'path', value: filePath } },
+    };
 }
-function writeOutboundBuffer(buffer, outboundDir, seg) {
+function writeOutboundBuffer(buffer, outboundDir, seg, media) {
     fs.mkdirSync(outboundDir, { recursive: true });
-    const ext = resolveExt(seg);
-    const filePath = path.join(outboundDir, `out-${seg.type}-${Date.now()}-${crypto.randomBytes(4).toString("hex")}${ext}`);
+    const ext = resolveExt(seg, media);
+    const filePath = path.join(outboundDir, `out-${seg.type}-${Date.now()}-${crypto.randomBytes(4).toString('hex')}${ext}`);
     fs.writeFileSync(filePath, buffer);
     return filePath;
 }
 async function materializeSegment(seg, outboundDir) {
     if (!MEDIA_TYPES.has(seg.type))
         return seg;
-    const ref = segmentMediaRef(seg);
-    if (ref && !isInlineMediaRef(ref)) {
-        const local = normalizeLocalPath(ref);
-        if (isRemoteUrl(local)) {
-            const downloaded = await downloadRemoteImageToTemp(local, outboundDir);
-            return withLocalFile(seg, downloaded);
+    const media = (seg.data ?? {}).media;
+    if (!isMediaRef(media)) {
+        return dropMediaSegment(seg.type, 'missing_media_ref');
+    }
+    switch (media.kind) {
+        case 'url': {
+            try {
+                const downloaded = await downloadRemoteImageToTemp(media.value, outboundDir);
+                return withLocalPath(seg, media, downloaded);
+            }
+            catch (err) {
+                logger.warn(formatCompact({
+                    op: 'weixin_ilink_outbound_media_dropped',
+                    type: seg.type,
+                    reason: 'download_failed',
+                    error: err instanceof Error ? err.message : String(err),
+                }));
+                return null;
+            }
         }
-        if (fs.existsSync(local)) {
-            return withLocalFile(seg, local);
+        case 'base64':
+            return withLocalPath(seg, media, writeOutboundBuffer(Buffer.from(media.value, 'base64'), outboundDir, seg, media));
+        case 'path': {
+            if (!fs.existsSync(media.value)) {
+                return dropMediaSegment(seg.type, 'missing_source');
+            }
+            return withLocalPath(seg, media, media.value);
         }
+        case 'file':
+            // 平台不透明引用（如 Telegram file_id）：微信 iLink 无对应投递面
+            return dropMediaSegment(seg.type, 'unsupported_media_kind');
     }
-    const buffer = extractBase64Buffer(seg.data);
-    if (buffer) {
-        return withLocalFile(seg, writeOutboundBuffer(buffer, outboundDir, seg));
-    }
-    return seg;
 }
 function asSegments(content) {
-    if (typeof content === "string") {
-        return [{ type: "text", data: { text: content } }];
+    if (typeof content === 'string') {
+        return [{ type: 'text', data: { text: content } }];
     }
     if (!Array.isArray(content)) {
-        return typeof content === "object" && content !== null && "type" in content
+        return typeof content === 'object' && content !== null && 'type' in content
             ? [content]
             : [];
     }
     return content.flatMap((item) => {
-        if (typeof item === "string")
-            return [{ type: "text", data: { text: item } }];
-        return typeof item === "object" && item !== null && "type" in item ? [item] : [];
+        if (typeof item === 'string')
+            return [{ type: 'text', data: { text: item } }];
+        return typeof item === 'object' && item !== null && 'type' in item ? [item] : [];
     });
 }
-/** 将 base64 / 远程图落盘，供 sendWeixinMediaFile 上传 */
+/** 将 canonical MediaRef 媒体段物化为本地文件（kind=path），供 sendWeixinMediaFile 上传 */
 export async function materializeOutboundMedia(content, outboundDir) {
     const segments = asSegments(content);
-    const out = await Promise.all(segments.map((seg) => materializeSegment(seg, outboundDir)));
-    if (typeof content === "string") {
-        return out[0]?.type === "text" ? out[0].data.text : content;
+    const out = (await Promise.all(segments.map((seg) => materializeSegment(seg, outboundDir))))
+        .filter((seg) => seg !== null);
+    if (typeof content === 'string') {
+        return out[0]?.type === 'text' ? String(out[0].data?.text ?? content) : content;
     }
     if (!Array.isArray(content)) {
-        return out[0] ?? content;
+        // 单个媒体段被丢弃时降级为空文本，避免未物化段漏到 endpoint
+        return out[0] ?? { type: 'text', data: { text: '' } };
     }
     return out;
 }
-//# sourceMappingURL=outbound-media.js.map

package/lib/pic-decrypt.d.ts

@@ -7,4 +7,3 @@ export declare function downloadAndDecryptBuffer(encryptedQueryParam: string, ae
  * Download plain (unencrypted) bytes from the CDN. Returns the raw Buffer.
  */
 export declare function downloadPlainCdnBuffer(encryptedQueryParam: string, cdnBaseUrl: string, label: string, fullUrl?: string): Promise<Buffer>;
-//# sourceMappingURL=pic-decrypt.d.ts.map

package/lib/pic-decrypt.js

@@ -86,4 +86,3 @@ export async function downloadPlainCdnBuffer(encryptedQueryParam, cdnBaseUrl, la
     logger.debug(`${label}: fetching url=${url}`);
     return fetchCdnBytes(url, label);
 }
-//# sourceMappingURL=pic-decrypt.js.map

package/lib/protocol.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Weixin iLink protocol helpers (no legacy Adapter/Endpoint / segment-mapper).
+ * Canonicalization is owned by gateway/core before endpoint.send.
+ */
+import { type ConversationRef, type Segment } from '@zhin.js/im-contract';
+import type { WeixinMessage } from './ilink-types.js';
+/** One expanded Weixin iLink endpoint configuration produced by AdapterIndex. */
+export interface WeixinIlinkEndpointConfig {
+    readonly id: string;
+    readonly botAgent?: string;
+    readonly baseUrl?: string;
+    readonly cdnBaseUrl?: string;
+    readonly longPollTimeoutMs?: number;
+    readonly botToken?: string;
+    readonly dataDir?: string;
+}
+export interface ResolvedWeixinIlinkConfig {
+    readonly context: 'weixin-ilink';
+    readonly id: string;
+    readonly botAgent?: string;
+    readonly baseUrl: string;
+    readonly cdnBaseUrl: string;
+    readonly longPollTimeoutMs: number;
+    readonly botToken?: string;
+    readonly dataDir: string;
+}
+export interface WeixinWireSegment {
+    readonly type: string;
+    readonly data?: Record<string, unknown>;
+}
+export interface WeixinInboundMediaPaths {
+    readonly decryptedPicPath?: string;
+    readonly decryptedVideoPath?: string;
+    readonly decryptedFilePath?: string;
+    readonly decryptedVoicePath?: string;
+}
+export type WeixinMessageWithMedia = WeixinMessage & {
+    readonly _media?: WeixinInboundMediaPaths;
+};
+export declare function resolveWeixinIlinkConfig(config: WeixinIlinkEndpointConfig): ResolvedWeixinIlinkConfig;
+/** Build inbound text for OutboundMessageService.receive (gateway owns reply routing). */
+export declare function formatInboundContent(msg: WeixinMessageWithMedia): string;
+export declare function weixinInboundSegments(msg: WeixinMessageWithMedia): readonly Segment[];
+export declare function weixinReplyTo(msg: WeixinMessageWithMedia): Readonly<{
+    id: string;
+}> | undefined;
+export declare function inboundMessageId(msg: WeixinMessage): string;
+/**
+ * 入站归一化 → ConversationRef：个人微信无群/频道概念，全部会话都是
+ * 与 `from_user_id` 的 private 会话（无 parent）。
+ */
+export declare function weixinIlinkInboundConversation(endpointKey: string, userId: string): ConversationRef;
+/**
+ * Wire-encode an already-rendered outbound payload into Weixin wire segments.
+ * Segment canonicalization is intentionally not done here.
+ */
+export declare function formatOutboundSegments(payload: unknown): WeixinWireSegment[];
+/** 物化后的媒体段（data.media kind=path）→ 本地文件路径；其余返回 undefined。 */
+export declare function segmentLocalPath(seg: WeixinWireSegment): string | undefined;
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;