@zhin.js/adapter-weixin-ilink 3.0.2 → 3.0.3

package/lib/ilink-redact.js

@@ -51,4 +51,3 @@ export function redactUrl(rawUrl) {
         return truncate(rawUrl, 80);
     }
 }
-//# sourceMappingURL=ilink-redact.js.map

package/lib/ilink-session-guard.d.ts

@@ -13,4 +13,3 @@ export declare function assertSessionActive(accountId: string): void;
  * @internal
  */
 export declare function _resetForTest(): void;
-//# sourceMappingURL=ilink-session-guard.d.ts.map

package/lib/ilink-session-guard.js

@@ -46,4 +46,3 @@ export function assertSessionActive(accountId) {
 export function _resetForTest() {
     pauseUntilMap.clear();
 }
-//# sourceMappingURL=ilink-session-guard.js.map

package/lib/ilink-types.d.ts

@@ -230,4 +230,3 @@ export interface NotifyStartResp {
     ret?: number;
     errmsg?: string;
 }
-//# sourceMappingURL=ilink-types.d.ts.map

package/lib/ilink-types.js

@@ -32,4 +32,3 @@ export const TypingStatus = {
     TYPING: 1,
     CANCEL: 2,
 };
-//# sourceMappingURL=ilink-types.js.map

package/lib/index.d.ts

@@ -1,19 +1,4 @@
-import type { Router } from "@zhin.js/host-router";
-import { PageManager } from "@zhin.js/host-api";
-import { WeixinIlinkAdapter } from "./adapter.js";
-declare module "zhin.js" {
-    namespace Plugin {
-        interface Contexts {
-            web: PageManager;
-            router: Router;
-        }
-    }
-    interface Adapters {
-        "weixin-ilink": WeixinIlinkAdapter;
-    }
-}
-export * from "./types.js";
-export { WeixinIlinkEndpoint } from "./endpoint.js";
-export { WeixinIlinkAdapter } from "./adapter.js";
-export { registerLoginAssistRoutes } from "./login-assist-routes.js";
-//# sourceMappingURL=index.d.ts.map
+export { formatInboundContent, formatOutboundSegments, inboundMessageId, resolveWeixinIlinkConfig, segmentLocalPath, sleep, type ResolvedWeixinIlinkConfig, type WeixinIlinkAdapterConfig, type WeixinIlinkEndpointConfig, type WeixinInboundMediaPaths, type WeixinMessageWithMedia, type WeixinWireSegment, } from './protocol.js';
+export type { WeixinMessage, MessageItem } from './ilink-types.js';
+export type { WeixinIlinkCredentials } from './credentials.js';
+export { WeixinIlinkEndpoint, type WeixinIlinkEndpointOptions, type WeixinIlinkGetUpdates, type WeixinIlinkNotifyStart, type WeixinIlinkNotifyStop, type WeixinIlinkSendText, } from './endpoint.js';

package/lib/index.js

@@ -1,37 +1,2 @@
-/**
- * 微信 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 { 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 { WeixinIlinkEndpoint, } from './endpoint.js';

package/lib/login.d.ts

@@ -1,6 +1,4 @@
-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 WeixinIlinkCredentials } from './credentials.js';
+import type { ResolvedWeixinIlinkConfig } from './protocol.js';
+export declare function resolveCredentials(config: ResolvedWeixinIlinkConfig): Promise<WeixinIlinkCredentials>;
+export declare function loginWithQr(config: ResolvedWeixinIlinkConfig): Promise<WeixinIlinkCredentials>;

package/lib/login.js

@@ -1,8 +1,12 @@
-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 (env / config / sidecar file / QR login).
+ * No legacy Plugin / loginAssist dependency — QR URL is logged for manual scan.
+ */
+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';
 const QR_LONG_POLL_TIMEOUT_MS = 35_000;
 const LOGIN_TIMEOUT_MS = 480_000;
 function getLocalBotTokenList() {
@@ -13,7 +17,7 @@ async function fetchQRCode(apiBaseUrl, botType) {
         baseUrl: apiBaseUrl,
         endpoint: `ilink/bot/get_bot_qrcode?bot_type=${encodeURIComponent(botType)}`,
         body: JSON.stringify({ local_token_list: getLocalBotTokenList(), base_info: buildBaseInfo() }),
-        label: "fetchQRCode",
+        label: 'fetchQRCode',
     });
     return JSON.parse(rawText);
 }
@@ -24,19 +28,19 @@ async function pollQRStatus(apiBaseUrl, qrcode) {
             baseUrl: apiBaseUrl,
             endpoint,
             timeoutMs: QR_LONG_POLL_TIMEOUT_MS,
-            label: "pollQRStatus",
+            label: 'pollQRStatus',
         });
         return JSON.parse(rawText);
     }
     catch (err) {
-        if (err instanceof Error && err.name === "AbortError") {
-            return { status: "wait" };
+        if (err instanceof Error && err.name === 'AbortError') {
+            return { status: 'wait' };
         }
         logger.warn(`pollQRStatus error: ${String(err)}`);
-        return { status: "wait" };
+        return { status: 'wait' };
     }
 }
-export async function resolveCredentials(plugin, config) {
+export async function resolveCredentials(config) {
     const envToken = process.env.WEIXIN_ILINK_TOKEN?.trim() || config.botToken?.trim();
     if (envToken) {
         const stored = loadCredentials(config.name);
@@ -54,68 +58,42 @@ export async function resolveCredentials(plugin, config) {
             baseUrl: config.baseUrl ?? stored.baseUrl ?? DEFAULT_API_BASE_URL,
         };
     }
-    return loginWithQr(plugin, config);
+    return loginWithQr(config);
 }
-export async function loginWithQr(plugin, config) {
+export async function loginWithQr(config) {
     const apiBaseUrl = config.baseUrl ?? DEFAULT_API_BASE_URL;
     const qr = await fetchQRCode(apiBaseUrl, DEFAULT_ILINK_BOT_TYPE);
     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.name}: 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) {
+        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');
             }
-            if (status.status === "expired") {
-                if (assistTask)
-                    loginAssist.cancel(assistTask.id, "expired");
-                throw new Error("二维码已过期，请重启 bot 重新登录");
+            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');
             }
-            await new Promise((r) => setTimeout(r, 500));
+            saveCredentials(config.name, 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 new Promise((r) => setTimeout(r, 500));
     }
+    throw new Error('微信扫码登录超时');
 }
-//# sourceMappingURL=login.js.map

package/lib/media-download.d.ts

@@ -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

@@ -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,5 @@
-import type { MessageSegment, SendContent } from "zhin.js";
-export declare function segmentMediaRef(seg: MessageSegment): string | undefined;
+import type { WeixinWireSegment } from './protocol.js';
+export type OutboundWireContent = string | WeixinWireSegment | ReadonlyArray<string | WeixinWireSegment>;
+export declare function segmentMediaRef(seg: WeixinWireSegment): string | undefined;
 /** 将 base64 / 远程图落盘，供 sendWeixinMediaFile 上传 */
-export declare function materializeOutboundMedia(content: SendContent, outboundDir: string): Promise<SendContent>;
-//# sourceMappingURL=outbound-media.d.ts.map
+export declare function materializeOutboundMedia(content: OutboundWireContent, outboundDir: string): Promise<OutboundWireContent>;

package/lib/outbound-media.js

@@ -1,74 +1,77 @@
 /**
  * 微信 iLink 出站媒体：base64 / 远程 URL 须落盘后再走 CDN 上传。
  */
-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"]);
+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);
 }
 function isInlineMediaRef(value) {
-    return value.startsWith("base64://") || /^data:[^/]+\/[^;]+;base64,/i.test(value);
+    return value.startsWith('base64://') || /^data:[^/]+\/[^;]+;base64,/i.test(value);
 }
 function normalizeLocalPath(value) {
-    return value.replace(/^file:\/\//, "");
+    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));
+    if (!data)
+        return undefined;
+    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");
+    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");
+        return Buffer.from(url.replace(/^data:[^/]+\/[^;]+;base64,/, ''), 'base64');
     }
-    if (file?.startsWith("base64://")) {
-        return Buffer.from(file.slice(9), "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");
+        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;
+    const data = (seg.data ?? {});
+    const name = typeof data.name === 'string' ? data.name : undefined;
     if (name) {
         const ext = path.extname(name);
         if (ext)
             return ext;
     }
-    const mimeHint = mime ?? (typeof data.mime === "string" ? data.mime : typeof data.mimeType === "string" ? data.mimeType : undefined);
+    const mimeHint = mime
+        ?? (typeof data.mime === 'string' ? data.mime : typeof data.mimeType === 'string' ? data.mimeType : undefined);
     if (mimeHint) {
-        return getExtensionFromMime(mimeHint) ?? ".bin";
+        return getExtensionFromMime(mimeHint) ?? '.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 };
+    const data = { ...(seg.data ?? {}), file: filePath };
     delete data.base64;
     return { type: seg.type, data };
 }
 function writeOutboundBuffer(buffer, outboundDir, seg) {
     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 filePath = path.join(outboundDir, `out-${seg.type}-${Date.now()}-${crypto.randomBytes(4).toString('hex')}${ext}`);
     fs.writeFileSync(filePath, buffer);
     return filePath;
 }
@@ -86,37 +89,36 @@ async function materializeSegment(seg, outboundDir) {
             return withLocalFile(seg, local);
         }
     }
-    const buffer = extractBase64Buffer(seg.data);
+    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 上传 */
 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;
+    if (typeof content === 'string') {
+        return out[0]?.type === 'text' ? String(out[0].data?.text ?? content) : content;
     }
     if (!Array.isArray(content)) {
         return out[0] ?? content;
     }
     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,52 @@
+/**
+ * Weixin iLink protocol helpers (no legacy Adapter/Endpoint / segment-mapper).
+ * Canonicalization is owned by gateway/core before endpoint.send.
+ */
+import type { WeixinMessage } from './ilink-types.js';
+/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
+export interface WeixinIlinkAdapterConfig {
+    readonly name?: string;
+    readonly botAgent?: string;
+    readonly baseUrl?: string;
+    readonly cdnBaseUrl?: string;
+    readonly longPollTimeoutMs?: number;
+    readonly botToken?: string;
+    /** Transitional: legacy root `endpoints[]` with `context: weixin-ilink`. */
+    readonly endpoints?: ReadonlyArray<Partial<ResolvedWeixinIlinkConfig> & {
+        readonly context?: string;
+    }>;
+}
+export interface ResolvedWeixinIlinkConfig {
+    readonly context: 'weixin-ilink';
+    readonly name: string;
+    readonly botAgent?: string;
+    readonly baseUrl: string;
+    readonly cdnBaseUrl: string;
+    readonly longPollTimeoutMs: number;
+    readonly botToken?: string;
+}
+export type WeixinIlinkEndpointConfig = ResolvedWeixinIlinkConfig;
+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?: WeixinIlinkAdapterConfig): ResolvedWeixinIlinkConfig;
+/** Build inbound text for MessageGateway.receive (gateway owns reply routing). */
+export declare function formatInboundContent(msg: WeixinMessageWithMedia): string;
+export declare function inboundMessageId(msg: WeixinMessage): string;
+/**
+ * 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[];
+export declare function segmentLocalPath(seg: WeixinWireSegment): string | undefined;
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;

package/lib/protocol.js

@@ -0,0 +1,109 @@
+/**
+ * Weixin iLink protocol helpers (no legacy Adapter/Endpoint / segment-mapper).
+ * Canonicalization is owned by gateway/core before endpoint.send.
+ */
+import { pickCredential } from '@zhin.js/adapter';
+import { bodyFromItemList, isMediaItem } from './weixin-inbound.js';
+import { DEFAULT_API_BASE_URL, DEFAULT_CDN_BASE_URL } from './ilink-meta.js';
+const DEFAULT_LONG_POLL_TIMEOUT_MS = 35_000;
+export function resolveWeixinIlinkConfig(config = {}) {
+    const entry = config.endpoints?.find((item) => item.context === 'weixin-ilink');
+    const name = (typeof config.name === 'string' && config.name)
+        || (typeof entry?.name === 'string' && entry.name)
+        || process.env.WEIXIN_ILINK_BOT_NAME
+        || 'weixin-ilink-bot';
+    const botToken = pickCredential(typeof config.botToken === 'string' ? config.botToken.trim() : config.botToken, typeof entry?.botToken === 'string' ? entry.botToken.trim() : entry?.botToken, process.env.WEIXIN_ILINK_TOKEN?.trim());
+    // No throw here: missing botToken is resolved later by resolveCredentials()
+    // (sidecar credentials file / QR login) during endpoint.start().
+    return {
+        context: 'weixin-ilink',
+        name,
+        botAgent: config.botAgent ?? entry?.botAgent,
+        baseUrl: config.baseUrl ?? entry?.baseUrl ?? DEFAULT_API_BASE_URL,
+        cdnBaseUrl: config.cdnBaseUrl ?? entry?.cdnBaseUrl ?? DEFAULT_CDN_BASE_URL,
+        longPollTimeoutMs: config.longPollTimeoutMs
+            ?? entry?.longPollTimeoutMs
+            ?? DEFAULT_LONG_POLL_TIMEOUT_MS,
+        botToken,
+    };
+}
+/** Build inbound text for MessageGateway.receive (gateway owns reply routing). */
+export function formatInboundContent(msg) {
+    const parts = [];
+    const text = bodyFromItemList(msg.item_list);
+    if (text)
+        parts.push(text);
+    const media = msg._media;
+    if (media?.decryptedPicPath) {
+        parts.push(`[image: ${media.decryptedPicPath}]`);
+    }
+    else if (media?.decryptedVideoPath) {
+        parts.push(`[video: ${media.decryptedVideoPath}]`);
+    }
+    else if (media?.decryptedFilePath) {
+        parts.push(`[file: ${media.decryptedFilePath}]`);
+    }
+    else if (media?.decryptedVoicePath) {
+        parts.push(`[record: ${media.decryptedVoicePath}]`);
+    }
+    else if (!text && msg.item_list?.some((item) => isMediaItem(item))) {
+        parts.push('[媒体消息]');
+    }
+    return parts.join('\n').trim() || '';
+}
+export function inboundMessageId(msg) {
+    return String(msg.message_id ?? msg.client_id ?? msg.seq ?? Date.now());
+}
+/**
+ * Wire-encode an already-rendered outbound payload into Weixin wire segments.
+ * Segment canonicalization is intentionally not done here.
+ */
+export function formatOutboundSegments(payload) {
+    if (typeof payload === 'string') {
+        return [{ type: 'text', data: { text: payload } }];
+    }
+    const items = Array.isArray(payload)
+        ? payload
+        : payload && typeof payload === 'object' && 'type' in payload
+            ? [payload]
+            : [];
+    if (items.length === 0) {
+        const text = payload == null
+            ? ''
+            : typeof payload === 'object'
+                ? JSON.stringify(payload)
+                : String(payload);
+        return [{ type: 'text', data: { text } }];
+    }
+    const segs = [];
+    for (const item of items) {
+        if (typeof item === 'string') {
+            segs.push({ type: 'text', data: { text: item } });
+            continue;
+        }
+        segs.push({ type: item.type, data: item.data ?? {} });
+    }
+    return segs.length ? segs : [{ type: 'text', data: { text: '' } }];
+}
+export function segmentLocalPath(seg) {
+    const data = seg.data ?? {};
+    const candidates = [data.file, data.path, data.url].filter((value) => typeof value === 'string' && Boolean(value));
+    const ref = candidates[0];
+    if (!ref || ref.startsWith('base64://') || /^data:/.test(ref) || /^https?:\/\//i.test(ref)) {
+        return undefined;
+    }
+    return ref.replace(/^file:\/\//, '');
+}
+export function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(timer);
+            resolve();
+        }, { once: true });
+    });
+}

package/lib/silk-transcode.d.ts

@@ -6,4 +6,3 @@
  * 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.js

@@ -61,4 +61,3 @@ export async function silkToWav(silkBuf) {
         return null;
     }
 }
-//# sourceMappingURL=silk-transcode.js.map