@zhin.js/adapter-weixin-ilink 0.1.0

package/lib/ilink-api.d.ts

@@ -0,0 +1,81 @@
+import type { GetUploadUrlReq, GetUploadUrlResp, GetUpdatesReq, GetUpdatesResp, NotifyStopResp, NotifyStartResp, SendMessageReq, SendTypingReq, GetConfigResp } from "./ilink-types.js";
+export { buildBaseInfo, sanitizeBotAgent } from "./ilink-meta.js";
+export type WeixinApiOptions = {
+    baseUrl: string;
+    token?: string;
+    timeoutMs?: number;
+    /** Long-poll timeout for getUpdates (server may hold the request up to this). */
+    longPollTimeoutMs?: number;
+};
+/**
+ * GET fetch wrapper: send a GET request to a Weixin API endpoint.
+ * When `timeoutMs` is set, the request is aborted after that many milliseconds.
+ * Query parameters should already be encoded in `endpoint`.
+ * Returns the raw response text on success; throws on HTTP error or (if used) timeout abort.
+ */
+export declare function apiGetFetch(params: {
+    baseUrl: string;
+    endpoint: string;
+    timeoutMs?: number;
+    label: string;
+}): Promise<string>;
+/**
+ * Common fetch wrapper: POST JSON to a Weixin API endpoint.
+ * When `timeoutMs` is provided, the request is aborted after that many milliseconds.
+ * When omitted, no client-side timeout is applied (relies on OS/TCP stack).
+ * When `abortSignal` is provided, an external channel stop also aborts the request.
+ * Returns the raw response text on success; throws on HTTP error or timeout.
+ */
+export declare function apiPostFetch(params: {
+    baseUrl: string;
+    endpoint: string;
+    body: string;
+    token?: string;
+    timeoutMs?: number;
+    label: string;
+    abortSignal?: AbortSignal;
+}): Promise<string>;
+/**
+ * Long-poll getUpdates. Server should hold the request until new messages or timeout.
+ *
+ * On client-side timeout (no server response within timeoutMs), returns an empty response
+ * with ret=0 so the caller can simply retry. This is normal for long-poll.
+ */
+export declare function getUpdates(params: GetUpdatesReq & {
+    baseUrl: string;
+    token?: string;
+    timeoutMs?: number;
+    /**
+     * Optional external abort signal (e.g. from the gateway when stopping the
+     * channel). When this aborts, the in-flight long-poll is terminated
+     * immediately so the monitor loop can exit well within the gateway's
+     * channel-stop budget (#141).
+     */
+    abortSignal?: AbortSignal;
+}): Promise<GetUpdatesResp>;
+/** Get a pre-signed CDN upload URL for a file. */
+export declare function getUploadUrl(params: GetUploadUrlReq & WeixinApiOptions): Promise<GetUploadUrlResp>;
+/** Send a single message downstream. */
+export declare function sendMessage(params: WeixinApiOptions & {
+    body: SendMessageReq;
+}): Promise<void>;
+/** Fetch bot config (includes typing_ticket) for a given user. */
+export declare function getConfig(params: WeixinApiOptions & {
+    ilinkUserId: string;
+    contextToken?: string;
+}): Promise<GetConfigResp>;
+/** Send a typing indicator to a user. */
+export declare function sendTyping(params: WeixinApiOptions & {
+    body: SendTypingReq;
+}): Promise<void>;
+/**
+ * Notify Weixin that this channel client is stopping (gateway shutdown / channel stop).
+ * Uses a standalone timeout (not the gateway abort signal) so the request can finish
+ * after OpenClaw has already aborted the long-poll.
+ */
+export declare function notifyStop(params: WeixinApiOptions): Promise<NotifyStopResp>;
+/**
+ * Notify Weixin that this channel client is starting (gateway startup / channel start).
+ */
+export declare function notifyStart(params: WeixinApiOptions): Promise<NotifyStartResp>;
+//# sourceMappingURL=ilink-api.d.ts.map

package/lib/ilink-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ilink-api.d.ts","sourceRoot":"","sources":["../src/ilink-api.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AA4CF;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BlB;AAuBD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,GAAG,OAAO,CAAC,MAAM,CAAC,CAgClB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,GACA,OAAO,CAAC,cAAc,CAAC,CAiCzB;AAED,kDAAkD;AAClD,wBAAsB,YAAY,CAChC,MAAM,EAAE,eAAe,GAAG,gBAAgB,GACzC,OAAO,CAAC,gBAAgB,CAAC,CAwB3B;AAED,wCAAwC;AACxC,wBAAsB,WAAW,CAC/B,MAAM,EAAE,gBAAgB,GAAG;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GAClD,OAAO,CAAC,IAAI,CAAC,CASf;AAED,kEAAkE;AAClE,wBAAsB,SAAS,CAC7B,MAAM,EAAE,gBAAgB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE,OAAO,CAAC,aAAa,CAAC,CAexB;AAED,yCAAyC;AACzC,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,GAAG;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACjD,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAUlF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAUpF"}

package/lib/ilink-api.js

@@ -0,0 +1,273 @@
+import crypto from "node:crypto";
+import { logger } from "./ilink-logger.js";
+import { buildBaseInfo, ILINK_APP_CLIENT_VERSION, ILINK_APP_ID, } from "./ilink-meta.js";
+import { redactBody, redactUrl } from "./ilink-redact.js";
+export { buildBaseInfo, sanitizeBotAgent } from "./ilink-meta.js";
+/** Default timeout for long-poll getUpdates requests. */
+const DEFAULT_LONG_POLL_TIMEOUT_MS = 35_000;
+/** Default timeout for regular API requests (sendMessage, getUploadUrl). */
+const DEFAULT_API_TIMEOUT_MS = 15_000;
+/** Default timeout for lightweight API requests (getConfig, sendTyping). */
+const DEFAULT_CONFIG_TIMEOUT_MS = 10_000;
+function ensureTrailingSlash(url) {
+    return url.endsWith("/") ? url : `${url}/`;
+}
+/** X-WECHAT-UIN header: random uint32 -> decimal string -> base64. */
+function randomWechatUin() {
+    const uint32 = crypto.randomBytes(4).readUInt32BE(0);
+    return Buffer.from(String(uint32), "utf-8").toString("base64");
+}
+/** Build headers shared by both GET and POST requests. */
+function buildCommonHeaders() {
+    const headers = {
+        "iLink-App-Id": ILINK_APP_ID,
+        "iLink-App-ClientVersion": String(ILINK_APP_CLIENT_VERSION),
+    };
+    return headers;
+}
+function buildHeaders(opts) {
+    const headers = {
+        "Content-Type": "application/json",
+        AuthorizationType: "ilink_bot_token",
+        "X-WECHAT-UIN": randomWechatUin(),
+        ...buildCommonHeaders(),
+    };
+    if (opts.token?.trim()) {
+        headers.Authorization = `Bearer ${opts.token.trim()}`;
+    }
+    logger.debug(`requestHeaders: ${JSON.stringify({ ...headers, Authorization: headers.Authorization ? "Bearer ***" : undefined })}`);
+    return headers;
+}
+/**
+ * GET fetch wrapper: send a GET request to a Weixin API endpoint.
+ * When `timeoutMs` is set, the request is aborted after that many milliseconds.
+ * Query parameters should already be encoded in `endpoint`.
+ * Returns the raw response text on success; throws on HTTP error or (if used) timeout abort.
+ */
+export async function apiGetFetch(params) {
+    const base = ensureTrailingSlash(params.baseUrl);
+    const url = new URL(params.endpoint, base);
+    const hdrs = buildCommonHeaders();
+    logger.debug(`GET ${redactUrl(url.toString())}`);
+    const timeoutMs = params.timeoutMs;
+    const controller = timeoutMs != null && timeoutMs > 0 ? new AbortController() : undefined;
+    const t = controller != null && timeoutMs != null
+        ? setTimeout(() => controller.abort(), timeoutMs)
+        : undefined;
+    try {
+        const res = await fetch(url.toString(), {
+            method: "GET",
+            headers: hdrs,
+            ...(controller ? { signal: controller.signal } : {}),
+        });
+        if (t !== undefined)
+            clearTimeout(t);
+        const rawText = await res.text();
+        logger.debug(`${params.label} status=${res.status} raw=${redactBody(rawText)}`);
+        if (!res.ok) {
+            throw new Error(`${params.label} ${res.status}: ${rawText}`);
+        }
+        return rawText;
+    }
+    catch (err) {
+        if (t !== undefined)
+            clearTimeout(t);
+        throw err;
+    }
+}
+function combineAbortSignals(internal, external) {
+    if (!internal && !external)
+        return { cleanup: () => { } };
+    if (!internal)
+        return { signal: external, cleanup: () => { } };
+    if (!external)
+        return { signal: internal.signal, cleanup: () => { } };
+    if (external.aborted) {
+        internal.abort();
+        return { signal: internal.signal, cleanup: () => { } };
+    }
+    const onExternalAbort = () => internal.abort();
+    external.addEventListener("abort", onExternalAbort, { once: true });
+    return {
+        signal: internal.signal,
+        cleanup: () => external.removeEventListener("abort", onExternalAbort),
+    };
+}
+/**
+ * Common fetch wrapper: POST JSON to a Weixin API endpoint.
+ * When `timeoutMs` is provided, the request is aborted after that many milliseconds.
+ * When omitted, no client-side timeout is applied (relies on OS/TCP stack).
+ * When `abortSignal` is provided, an external channel stop also aborts the request.
+ * Returns the raw response text on success; throws on HTTP error or timeout.
+ */
+export async function apiPostFetch(params) {
+    const base = ensureTrailingSlash(params.baseUrl);
+    const url = new URL(params.endpoint, base);
+    const hdrs = buildHeaders({ token: params.token });
+    logger.debug(`POST ${redactUrl(url.toString())} body=${redactBody(params.body)}`);
+    const controller = params.timeoutMs !== undefined ? new AbortController() : undefined;
+    const t = controller != null && params.timeoutMs !== undefined
+        ? setTimeout(() => controller.abort(), params.timeoutMs)
+        : undefined;
+    const { signal, cleanup } = combineAbortSignals(controller, params.abortSignal);
+    try {
+        const res = await fetch(url.toString(), {
+            method: "POST",
+            headers: hdrs,
+            body: params.body,
+            ...(signal ? { signal } : {}),
+        });
+        const rawText = await res.text();
+        logger.debug(`${params.label} status=${res.status} raw=${redactBody(rawText)}`);
+        if (!res.ok) {
+            throw new Error(`${params.label} ${res.status}: ${rawText}`);
+        }
+        return rawText;
+    }
+    catch (err) {
+        throw err;
+    }
+    finally {
+        if (t !== undefined)
+            clearTimeout(t);
+        cleanup();
+    }
+}
+/**
+ * Long-poll getUpdates. Server should hold the request until new messages or timeout.
+ *
+ * On client-side timeout (no server response within timeoutMs), returns an empty response
+ * with ret=0 so the caller can simply retry. This is normal for long-poll.
+ */
+export async function getUpdates(params) {
+    const timeout = params.timeoutMs ?? DEFAULT_LONG_POLL_TIMEOUT_MS;
+    try {
+        const rawText = await apiPostFetch({
+            baseUrl: params.baseUrl,
+            endpoint: "ilink/bot/getupdates",
+            body: JSON.stringify({
+                get_updates_buf: params.get_updates_buf ?? "",
+                base_info: buildBaseInfo(),
+            }),
+            token: params.token,
+            timeoutMs: timeout,
+            label: "getUpdates",
+            abortSignal: params.abortSignal,
+        });
+        const resp = JSON.parse(rawText);
+        return resp;
+    }
+    catch (err) {
+        // Long-poll timeout *or* external abort both surface as AbortError. The caller
+        // re-checks `abortSignal?.aborted` after we return; when aborted, it exits
+        // the loop. When not aborted (i.e. plain client-side long-poll timeout),
+        // returning the empty response lets the caller retry — preserving prior
+        // behavior for the normal long-poll case.
+        if (err instanceof Error && err.name === "AbortError") {
+            if (params.abortSignal?.aborted) {
+                logger.debug(`getUpdates: aborted by external signal`);
+            }
+            else {
+                logger.debug(`getUpdates: client-side timeout after ${timeout}ms, returning empty response`);
+            }
+            return { ret: 0, msgs: [], get_updates_buf: params.get_updates_buf };
+        }
+        throw err;
+    }
+}
+/** Get a pre-signed CDN upload URL for a file. */
+export async function getUploadUrl(params) {
+    const rawText = await apiPostFetch({
+        baseUrl: params.baseUrl,
+        endpoint: "ilink/bot/getuploadurl",
+        body: JSON.stringify({
+            filekey: params.filekey,
+            media_type: params.media_type,
+            to_user_id: params.to_user_id,
+            rawsize: params.rawsize,
+            rawfilemd5: params.rawfilemd5,
+            filesize: params.filesize,
+            thumb_rawsize: params.thumb_rawsize,
+            thumb_rawfilemd5: params.thumb_rawfilemd5,
+            thumb_filesize: params.thumb_filesize,
+            no_need_thumb: params.no_need_thumb,
+            aeskey: params.aeskey,
+            base_info: buildBaseInfo(),
+        }),
+        token: params.token,
+        timeoutMs: params.timeoutMs ?? DEFAULT_API_TIMEOUT_MS,
+        label: "getUploadUrl",
+    });
+    const resp = JSON.parse(rawText);
+    return resp;
+}
+/** Send a single message downstream. */
+export async function sendMessage(params) {
+    await apiPostFetch({
+        baseUrl: params.baseUrl,
+        endpoint: "ilink/bot/sendmessage",
+        body: JSON.stringify({ ...params.body, base_info: buildBaseInfo() }),
+        token: params.token,
+        timeoutMs: params.timeoutMs ?? DEFAULT_API_TIMEOUT_MS,
+        label: "sendMessage",
+    });
+}
+/** Fetch bot config (includes typing_ticket) for a given user. */
+export async function getConfig(params) {
+    const rawText = await apiPostFetch({
+        baseUrl: params.baseUrl,
+        endpoint: "ilink/bot/getconfig",
+        body: JSON.stringify({
+            ilink_user_id: params.ilinkUserId,
+            context_token: params.contextToken,
+            base_info: buildBaseInfo(),
+        }),
+        token: params.token,
+        timeoutMs: params.timeoutMs ?? DEFAULT_CONFIG_TIMEOUT_MS,
+        label: "getConfig",
+    });
+    const resp = JSON.parse(rawText);
+    return resp;
+}
+/** Send a typing indicator to a user. */
+export async function sendTyping(params) {
+    await apiPostFetch({
+        baseUrl: params.baseUrl,
+        endpoint: "ilink/bot/sendtyping",
+        body: JSON.stringify({ ...params.body, base_info: buildBaseInfo() }),
+        token: params.token,
+        timeoutMs: params.timeoutMs ?? DEFAULT_CONFIG_TIMEOUT_MS,
+        label: "sendTyping",
+    });
+}
+/**
+ * Notify Weixin that this channel client is stopping (gateway shutdown / channel stop).
+ * Uses a standalone timeout (not the gateway abort signal) so the request can finish
+ * after OpenClaw has already aborted the long-poll.
+ */
+export async function notifyStop(params) {
+    const rawText = await apiPostFetch({
+        baseUrl: params.baseUrl,
+        endpoint: "ilink/bot/msg/notifystop",
+        body: JSON.stringify({ base_info: buildBaseInfo() }),
+        token: params.token,
+        timeoutMs: params.timeoutMs ?? DEFAULT_CONFIG_TIMEOUT_MS,
+        label: "notifyStop",
+    });
+    return JSON.parse(rawText);
+}
+/**
+ * Notify Weixin that this channel client is starting (gateway startup / channel start).
+ */
+export async function notifyStart(params) {
+    const rawText = await apiPostFetch({
+        baseUrl: params.baseUrl,
+        endpoint: "ilink/bot/msg/notifystart",
+        body: JSON.stringify({ base_info: buildBaseInfo() }),
+        token: params.token,
+        timeoutMs: params.timeoutMs ?? DEFAULT_CONFIG_TIMEOUT_MS,
+        label: "notifyStart",
+    });
+    return JSON.parse(rawText);
+}
+//# sourceMappingURL=ilink-api.js.map

package/lib/ilink-api.js.map

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

package/lib/ilink-config-cache.d.ts

@@ -0,0 +1,19 @@
+/** Subset of getConfig fields that we actually need; add new fields here as needed. */
+export interface CachedConfig {
+    typingTicket: string;
+}
+/**
+ * Per-user getConfig cache with periodic random refresh (within 24h) and
+ * exponential-backoff retry (up to 1h) on failure.
+ */
+export declare class WeixinConfigManager {
+    private apiOpts;
+    private log;
+    private cache;
+    constructor(apiOpts: {
+        baseUrl: string;
+        token?: string;
+    }, log: (msg: string) => void);
+    getForUser(userId: string, contextToken?: string): Promise<CachedConfig>;
+}
+//# sourceMappingURL=ilink-config-cache.d.ts.map

package/lib/ilink-config-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ilink-config-cache.d.ts","sourceRoot":"","sources":["../src/ilink-config-cache.ts"],"names":[],"mappings":"AAEA,uFAAuF;AACvF,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB;AAaD;;;GAGG;AACH,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,GAAG;IAJb,OAAO,CAAC,KAAK,CAAuC;gBAG1C,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC5C,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI;IAG9B,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAgD/E"}

package/lib/ilink-config-cache.js

@@ -0,0 +1,64 @@
+import { getConfig } from "./ilink-api.js";
+const CONFIG_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const CONFIG_CACHE_INITIAL_RETRY_MS = 2_000;
+const CONFIG_CACHE_MAX_RETRY_MS = 60 * 60 * 1000;
+/**
+ * Per-user getConfig cache with periodic random refresh (within 24h) and
+ * exponential-backoff retry (up to 1h) on failure.
+ */
+export class WeixinConfigManager {
+    apiOpts;
+    log;
+    cache = new Map();
+    constructor(apiOpts, log) {
+        this.apiOpts = apiOpts;
+        this.log = log;
+    }
+    async getForUser(userId, contextToken) {
+        const now = Date.now();
+        const entry = this.cache.get(userId);
+        const shouldFetch = !entry || now >= entry.nextFetchAt;
+        if (shouldFetch) {
+            let fetchOk = false;
+            try {
+                const resp = await getConfig({
+                    baseUrl: this.apiOpts.baseUrl,
+                    token: this.apiOpts.token,
+                    ilinkUserId: userId,
+                    contextToken,
+                });
+                if (resp.ret === 0) {
+                    this.cache.set(userId, {
+                        config: { typingTicket: resp.typing_ticket ?? "" },
+                        everSucceeded: true,
+                        nextFetchAt: now + Math.random() * CONFIG_CACHE_TTL_MS,
+                        retryDelayMs: CONFIG_CACHE_INITIAL_RETRY_MS,
+                    });
+                    this.log(`[weixin] config ${entry?.everSucceeded ? "refreshed" : "cached"} for ${userId}`);
+                    fetchOk = true;
+                }
+            }
+            catch (err) {
+                this.log(`[weixin] getConfig failed for ${userId} (ignored): ${String(err)}`);
+            }
+            if (!fetchOk) {
+                const prevDelay = entry?.retryDelayMs ?? CONFIG_CACHE_INITIAL_RETRY_MS;
+                const nextDelay = Math.min(prevDelay * 2, CONFIG_CACHE_MAX_RETRY_MS);
+                if (entry) {
+                    entry.nextFetchAt = now + nextDelay;
+                    entry.retryDelayMs = nextDelay;
+                }
+                else {
+                    this.cache.set(userId, {
+                        config: { typingTicket: "" },
+                        everSucceeded: false,
+                        nextFetchAt: now + CONFIG_CACHE_INITIAL_RETRY_MS,
+                        retryDelayMs: CONFIG_CACHE_INITIAL_RETRY_MS,
+                    });
+                }
+            }
+        }
+        return this.cache.get(userId)?.config ?? { typingTicket: "" };
+    }
+}
+//# sourceMappingURL=ilink-config-cache.js.map

package/lib/ilink-config-cache.js.map

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

package/lib/ilink-logger.d.ts

@@ -0,0 +1,10 @@
+export type IlinkLogger = {
+    debug: (msg: string) => void;
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    withAccount: (accountId: string) => IlinkLogger;
+};
+export declare function setIlinkLogger(next: IlinkLogger): void;
+export declare const logger: IlinkLogger;
+//# sourceMappingURL=ilink-logger.d.ts.map

package/lib/ilink-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ilink-logger.d.ts","sourceRoot":"","sources":["../src/ilink-logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,WAAW,CAAC;CACjD,CAAC;AAmBF,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAEtD;AAED,eAAO,MAAM,MAAM,EAAE,WAMpB,CAAC"}

package/lib/ilink-logger.js

@@ -0,0 +1,27 @@
+let sink = {
+    debug: () => { },
+    info: () => { },
+    warn: (msg) => console.warn(`[weixin-ilink] ${msg}`),
+    error: (msg) => console.error(`[weixin-ilink] ${msg}`),
+    withAccount(accountId) {
+        const prefix = `[weixin-ilink:${accountId}]`;
+        return {
+            debug: (msg) => sink.debug(`${prefix} ${msg}`),
+            info: (msg) => sink.info(`${prefix} ${msg}`),
+            warn: (msg) => sink.warn(`${prefix} ${msg}`),
+            error: (msg) => sink.error(`${prefix} ${msg}`),
+            withAccount: () => this,
+        };
+    },
+};
+export function setIlinkLogger(next) {
+    sink = next;
+}
+export const logger = {
+    debug: (msg) => sink.debug(msg),
+    info: (msg) => sink.info(msg),
+    warn: (msg) => sink.warn(msg),
+    error: (msg) => sink.error(msg),
+    withAccount: (accountId) => sink.withAccount(accountId),
+};
+//# sourceMappingURL=ilink-logger.js.map

package/lib/ilink-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ilink-logger.js","sourceRoot":"","sources":["../src/ilink-logger.ts"],"names":[],"mappings":"AAQA,IAAI,IAAI,GAAgB;IACtB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;IACpD,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,kBAAkB,GAAG,EAAE,CAAC;IACtD,WAAW,CAAC,SAAS;QACnB,MAAM,MAAM,GAAG,iBAAiB,SAAS,GAAG,CAAC;QAC7C,OAAO;YACL,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;YAC9C,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;YAC5C,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;YAC5C,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;YAC9C,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI;SACxB,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,IAAI,GAAG,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAgB;IACjC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;IAC/B,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC7B,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;IAC/B,WAAW,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;CACxD,CAAC"}

package/lib/ilink-meta.d.ts

@@ -0,0 +1,13 @@
+import type { BaseInfo } from "./ilink-types.js";
+export declare const ILINK_APP_ID = "bot";
+export declare const DEFAULT_CDN_BASE_URL = "https://novac2c.cdn.weixin.qq.com/c2c";
+export declare const DEFAULT_API_BASE_URL = "https://ilinkai.weixin.qq.com";
+export declare function configureIlinkMeta(opts: {
+    botAgent?: string;
+    version?: string;
+}): void;
+export declare function buildClientVersion(version: string): number;
+export declare const ILINK_APP_CLIENT_VERSION: number;
+export declare function sanitizeBotAgent(raw: string | undefined): string;
+export declare function buildBaseInfo(): BaseInfo;
+//# sourceMappingURL=ilink-meta.d.ts.map

package/lib/ilink-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ilink-meta.d.ts","sourceRoot":"","sources":["../src/ilink-meta.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,eAAO,MAAM,YAAY,QAAQ,CAAC;AAClC,eAAO,MAAM,oBAAoB,0CAA0C,CAAC;AAC5E,eAAO,MAAM,oBAAoB,kCAAkC,CAAC;AAoBpE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGtF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,eAAO,MAAM,wBAAwB,QAAqC,CAAC;AAE3E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAUhE;AAED,wBAAgB,aAAa,IAAI,QAAQ,CAKxC"}

package/lib/ilink-meta.js

@@ -0,0 +1,57 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+export const ILINK_APP_ID = "bot";
+export const DEFAULT_CDN_BASE_URL = "https://novac2c.cdn.weixin.qq.com/c2c";
+export const DEFAULT_API_BASE_URL = "https://ilinkai.weixin.qq.com";
+const DEFAULT_BOT_AGENT = "Zhin.js";
+const BOT_AGENT_MAX_LEN = 256;
+let channelVersion = "0.0.0";
+let configuredBotAgent;
+function readPackageVersion() {
+    try {
+        const pkgPath = path.join(path.dirname(fileURLToPath(import.meta.url)), "../package.json");
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+channelVersion = readPackageVersion();
+export function configureIlinkMeta(opts) {
+    if (opts.botAgent)
+        configuredBotAgent = opts.botAgent;
+    if (opts.version)
+        channelVersion = opts.version;
+}
+export function buildClientVersion(version) {
+    const parts = version.split(".").map((p) => parseInt(p, 10));
+    const major = parts[0] ?? 0;
+    const minor = parts[1] ?? 0;
+    const patch = parts[2] ?? 0;
+    return ((major & 0xff) << 16) | ((minor & 0xff) << 8) | (patch & 0xff);
+}
+export const ILINK_APP_CLIENT_VERSION = buildClientVersion(channelVersion);
+export function sanitizeBotAgent(raw) {
+    if (!raw || typeof raw !== "string")
+        return configuredBotAgent ?? DEFAULT_BOT_AGENT;
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return configuredBotAgent ?? DEFAULT_BOT_AGENT;
+    const productRe = /^[A-Za-z0-9_.\-]{1,32}\/[A-Za-z0-9_.+\-]{1,32}$/;
+    const tokens = trimmed.split(/\s+/).filter((tok) => productRe.test(tok));
+    if (tokens.length === 0)
+        return configuredBotAgent ?? DEFAULT_BOT_AGENT;
+    const joined = tokens.join(" ");
+    if (Buffer.byteLength(joined, "utf-8") <= BOT_AGENT_MAX_LEN)
+        return joined;
+    return (configuredBotAgent ?? DEFAULT_BOT_AGENT);
+}
+export function buildBaseInfo() {
+    return {
+        channel_version: channelVersion,
+        bot_agent: sanitizeBotAgent(configuredBotAgent),
+    };
+}
+//# sourceMappingURL=ilink-meta.js.map

package/lib/ilink-meta.js.map

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

package/lib/ilink-random.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generate a prefixed unique ID using timestamp + crypto random bytes.
+ * Format: `{prefix}:{timestamp}-{8-char hex}`
+ */
+export declare function generateId(prefix: string): string;
+/**
+ * Generate a temporary file name with random suffix.
+ * Format: `{prefix}-{timestamp}-{8-char hex}{ext}`
+ */
+export declare function tempFileName(prefix: string, ext: string): string;
+//# sourceMappingURL=ilink-random.d.ts.map

package/lib/ilink-random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ilink-random.d.ts","sourceRoot":"","sources":["../src/ilink-random.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/lib/ilink-random.js

@@ -0,0 +1,16 @@
+import crypto from "node:crypto";
+/**
+ * Generate a prefixed unique ID using timestamp + crypto random bytes.
+ * Format: `{prefix}:{timestamp}-{8-char hex}`
+ */
+export function generateId(prefix) {
+    return `${prefix}:${Date.now()}-${crypto.randomBytes(4).toString("hex")}`;
+}
+/**
+ * Generate a temporary file name with random suffix.
+ * Format: `{prefix}-{timestamp}-{8-char hex}{ext}`
+ */
+export function tempFileName(prefix, ext) {
+    return `${prefix}-${Date.now()}-${crypto.randomBytes(4).toString("hex")}${ext}`;
+}
+//# sourceMappingURL=ilink-random.js.map

package/lib/ilink-random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ilink-random.js","sourceRoot":"","sources":["../src/ilink-random.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,GAAW;IACtD,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC;AAClF,CAAC"}