@krischoichoi/channel-weixin 0.6.0

package/lib/ilink/base-info.js

@@ -0,0 +1,11 @@
+export const DEFAULT_BOT_AGENT = 'DeepSeekHarness';
+/** Build the `base_info` object sent with every iLink CGI request. */
+export function buildBaseInfo(opts = {}) {
+    const info = {};
+    if (opts.channelVersion)
+        info.channel_version = opts.channelVersion;
+    // bot_agent falls back to DeepSeekHarness when the caller did not supply one.
+    info.bot_agent = opts.botAgent ?? DEFAULT_BOT_AGENT;
+    return info;
+}
+//# sourceMappingURL=base-info.js.map

package/lib/ilink/base-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-info.js","sourceRoot":"","sources":["../../src/ilink/base-info.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AASnD,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,OAA6B,EAAE;IAC3D,MAAM,IAAI,GAAkB,EAAE,CAAC;IAC/B,IAAI,IAAI,CAAC,cAAc;QAAE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC;IACpE,8EAA8E;IAC9E,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACpD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/ilink/client.d.ts

@@ -0,0 +1,110 @@
+import { type HttpTransport } from '../transport.js';
+import type { ILinkGetConfigRequest, ILinkGetConfigResponse, ILinkGetUpdatesResponse, ILinkGetUploadUrlRequest, ILinkGetUploadUrlResponse, ILinkNotifyResponse, ILinkQrCodeResponse, ILinkQrStatusResponse, ILinkSendMessageRequest, ILinkSendMessageResponse, ILinkSendTypingRequest, ILinkSendTypingResponse } from './types.js';
+export interface ILinkClientOptions {
+    /** API base URL; may be updated per-account after QR redirect. */
+    baseUrl: string;
+    /** CDN base URL for media operations (WX5 scaffold). */
+    cdnBaseUrl?: string;
+    /** Bot token for authenticated requests. */
+    token?: string;
+    /** Timeout for regular API requests (ms). */
+    timeoutMs?: number;
+    /** Timeout for the getUpdates long-poll (ms). */
+    longPollTimeoutMs?: number;
+    /** bot_agent string for base_info. */
+    botAgent?: string;
+    /** Injectable transport (tests). */
+    transport?: HttpTransport;
+    /** Injectable clock (tests). */
+    now?: () => number;
+    /** Optional route tag emitted as SKRouteTag. */
+    routeTag?: string;
+    /** Injectable random source for X-WECHAT-UIN (tests). */
+    rand?: () => number;
+}
+export interface GetUpdatesParams {
+    getUpdatesBuf?: string;
+    /** Long-poll timeout override (dynamic from server). */
+    longPollTimeoutMs?: number;
+    /** External abort signal (channel stop). */
+    signal?: AbortSignal;
+}
+export interface GetUpdatesResult {
+    msgs: ILinkGetUpdatesResponse['msgs'];
+    get_updates_buf?: string;
+    /** Next long-poll timeout suggested by the server. */
+    nextLongPollTimeoutMs?: number;
+    /** Whether the response came from a long-poll client-side timeout (empty msgs). */
+    timedOut?: boolean;
+}
+/** Optional local state supplied when requesting a QR login challenge. */
+export interface GetBotQrcodeOptions {
+    /** Recent locally-held bot tokens. Values are never logged. */
+    localTokens?: readonly string[];
+    /** External abort signal for the request. */
+    signal?: AbortSignal;
+}
+export declare class ILinkClient {
+    private readonly options;
+    private _baseUrl;
+    private readonly configuredBaseAuthority;
+    private readonly cdnBaseUrl;
+    private _token?;
+    private readonly timeoutMs;
+    private readonly longPollTimeoutMs;
+    private readonly botAgent;
+    private readonly transport;
+    private readonly now;
+    private readonly rand;
+    private readonly routeTag?;
+    private readonly accountId;
+    constructor(options: ILinkClientOptions, accountId?: string);
+    /** Current effective API base URL (mutable after QR redirect). */
+    get baseUrl(): string;
+    /** Update the effective base URL (QR redirect / confirmed baseurl). */
+    setBaseUrl(baseUrl: string): void;
+    /** Update the bot token (post-QR-confirm). */
+    setToken(token?: string): void;
+    get token(): string | undefined;
+    /** CDN base URL (no trailing slash). */
+    get cdnUrl(): string;
+    private headers;
+    private baseInfo;
+    private post;
+    private get;
+    private parseResponse;
+    /** POST /ilink/bot/get_bot_qrcode?bot_type=3 with { local_token_list: [] }. */
+    getBotQrcode(options?: GetBotQrcodeOptions): Promise<ILinkQrCodeResponse>;
+    /**
+     * GET /ilink/bot/get_qrcode_status?qrcode=... (optionally &verify_code=...).
+     *
+     * This is a long-poll endpoint: the server holds the request open while the
+     * status is `wait` (before the user scans). A client-side long-poll timeout
+     * is therefore normal control flow — same semantics as `getUpdates` — and is
+     * mapped back to `{ status: 'wait' }` so `WeixinQrAuth` never has to reason
+     * about HTTP timeouts: timeout → wait → pending → next poll.
+     */
+    getQrcodeStatus(qrcode: string, opts?: {
+        verifyCode?: string;
+        signal?: AbortSignal;
+    }): Promise<ILinkQrStatusResponse>;
+    /**
+     * POST /ilink/bot/getupdates.
+     * A long-poll client-side timeout is normal control flow: returns an empty
+     * result with `timedOut: true` so the monitor can simply retry.
+     */
+    getUpdates(params?: GetUpdatesParams): Promise<GetUpdatesResult>;
+    /** POST /ilink/bot/sendmessage. */
+    sendMessage(req: ILinkSendMessageRequest, signal?: AbortSignal): Promise<ILinkSendMessageResponse>;
+    /** POST /ilink/bot/getuploadurl (WX5 media upload slot). */
+    getUploadUrl(req: ILinkGetUploadUrlRequest, signal?: AbortSignal): Promise<ILinkGetUploadUrlResponse>;
+    /** POST /ilink/bot/getconfig. */
+    getConfig(req: ILinkGetConfigRequest, signal?: AbortSignal): Promise<ILinkGetConfigResponse>;
+    /** POST /ilink/bot/sendtyping. */
+    sendTyping(req: ILinkSendTypingRequest, signal?: AbortSignal): Promise<ILinkSendTypingResponse>;
+    /** POST /ilink/bot/msg/notifystart (best effort). */
+    notifyStart(signal?: AbortSignal): Promise<ILinkNotifyResponse>;
+    /** POST /ilink/bot/msg/notifystop (best effort). */
+    notifyStop(signal?: AbortSignal): Promise<ILinkNotifyResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/lib/ilink/client.d.ts.map

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

package/lib/ilink/client.js

@@ -0,0 +1,308 @@
+/**
+ * Classification: C — duplicate protocol implementation [@deprecated upstream-gap].
+ *
+ * iLink HTTP client (QR code, getUpdates long-poll, sendmessage, getconfig,
+ * sendtyping, getuploadurl, notify). Self-implemented because the official
+ * Tencent/openclaw-weixin @ 2.4.6 equivalents for these calls (api/api.js +
+ * auth/login-qr.js) are coupled to the OpenClaw runtime via util/logger.ts /
+ * auth/accounts.ts and execute OpenClaw side effects at import time (do not
+ * drag the OpenClaw runtime into DSH). Marked upstream-gap; official
+ * source of truth = @tencent-weixin/openclaw-weixin/dist/src/api/api.js.
+ * DO NOT delete wholesale this milestone.
+ */
+/**
+ * ILinkClient — thin, endpoint-aware client over the base {@link HttpTransport}.
+ *
+ * Owns the iLink endpoint paths, request/response shapes and error
+ * normalization. The base URL is mutable per account so QR-redirect and
+ * confirmed `baseurl` can update all later calls (getUpdates / sendMessage /
+ * QR status).
+ */
+import pkg from '../../package.json' with { type: 'json' };
+import { z } from 'zod';
+import { FetchTransport } from '../transport.js';
+import { buildHeaders } from './headers.js';
+import { buildBaseInfo } from './base-info.js';
+import { DEFAULT_CDN_BASE_URL, DEFAULT_LONG_POLL_TIMEOUT_MS, ENDPOINT_GET_BOT_QRCODE, ENDPOINT_GET_CONFIG, ENDPOINT_GET_QRCODE_STATUS, ENDPOINT_GET_UPDATES, ENDPOINT_GET_UPLOAD_URL, ENDPOINT_NOTIFY_START, ENDPOINT_NOTIFY_STOP, ENDPOINT_SEND_MESSAGE, ENDPOINT_SEND_TYPING, DEFAULT_BOT_TYPE, DEFAULT_QR_POLL_TIMEOUT_MS, } from './constants.js';
+import { normalizeILinkError } from './errors.js';
+import { getConfigResponseSchema, getUpdatesResponseSchema, getUploadUrlResponseSchema, notifyResponseSchema, qrCodeResponseSchema, qrStatusResponseSchema, responseEnvelopeSchema, sendMessageResponseSchema, sendTypingResponseSchema, } from './schema.js';
+const localTokenArraySchema = z.array(z.unknown());
+const localTokenSchema = z.string().trim().min(1).max(4096);
+const MAX_LOCAL_TOKENS = 10;
+/** Validate, normalize, deduplicate, and bound QR local tokens at the wire boundary. */
+function normalizeLocalTokens(value) {
+    const parsed = localTokenArraySchema.safeParse(value);
+    if (!parsed.success)
+        return [];
+    const tokens = [];
+    const seen = new Set();
+    for (const item of parsed.data) {
+        const token = localTokenSchema.safeParse(item);
+        if (!token.success || seen.has(token.data))
+            continue;
+        seen.add(token.data);
+        tokens.push(token.data);
+        if (tokens.length === MAX_LOCAL_TOKENS)
+            break;
+    }
+    return tokens;
+}
+function ensureSlash(url) {
+    return url.endsWith('/') ? url : `${url}/`;
+}
+const OFFICIAL_ILINK_HOST_SUFFIX = 'weixin.qq.com';
+function parseIlinkBaseUrl(value) {
+    let url;
+    try {
+        url = new URL(value.trim());
+    }
+    catch {
+        throw new TypeError('invalid iLink base URL');
+    }
+    if (url.protocol !== 'https:' ||
+        !url.hostname ||
+        url.username ||
+        url.password ||
+        url.search ||
+        url.hash) {
+        throw new TypeError('invalid iLink base URL');
+    }
+    return url;
+}
+function isOfficialIlinkHost(hostname) {
+    const normalized = hostname.toLowerCase();
+    return normalized === OFFICIAL_ILINK_HOST_SUFFIX || normalized.endsWith(`.${OFFICIAL_ILINK_HOST_SUFFIX}`);
+}
+function serializeBaseUrl(url) {
+    return url.toString().replace(/\/+$/, '');
+}
+export class ILinkClient {
+    options;
+    _baseUrl;
+    configuredBaseAuthority;
+    cdnBaseUrl;
+    _token;
+    timeoutMs;
+    longPollTimeoutMs;
+    botAgent;
+    transport;
+    now;
+    rand;
+    routeTag;
+    accountId;
+    constructor(options, accountId = 'main') {
+        this.options = options;
+        this.accountId = accountId;
+        const configuredBaseUrl = parseIlinkBaseUrl(options.baseUrl);
+        this.configuredBaseAuthority = configuredBaseUrl.host.toLowerCase();
+        this._baseUrl = serializeBaseUrl(configuredBaseUrl);
+        this.cdnBaseUrl = (options.cdnBaseUrl ?? DEFAULT_CDN_BASE_URL).replace(/\/+$/, '');
+        this._token = options.token;
+        this.timeoutMs = options.timeoutMs ?? 15_000;
+        this.longPollTimeoutMs = options.longPollTimeoutMs ?? DEFAULT_LONG_POLL_TIMEOUT_MS;
+        this.botAgent = options.botAgent ?? 'DeepSeekHarness/' + pkg.version;
+        this.rand = options.rand ?? Math.random;
+        this.now = options.now ?? Date.now;
+        this.routeTag = options.routeTag;
+        this.transport = options.transport ?? new FetchTransport({ timeoutMs: this.timeoutMs });
+    }
+    /** Current effective API base URL (mutable after QR redirect). */
+    get baseUrl() {
+        return this._baseUrl;
+    }
+    /** Update the effective base URL (QR redirect / confirmed baseurl). */
+    setBaseUrl(baseUrl) {
+        const candidate = parseIlinkBaseUrl(baseUrl);
+        const candidateHost = candidate.hostname.toLowerCase();
+        const candidateAuthority = candidate.host.toLowerCase();
+        if (candidateAuthority !== this.configuredBaseAuthority && !isOfficialIlinkHost(candidateHost)) {
+            throw new TypeError('untrusted iLink base URL host');
+        }
+        this._baseUrl = serializeBaseUrl(candidate);
+    }
+    /** Update the bot token (post-QR-confirm). */
+    setToken(token) {
+        this._token = token?.trim() ? token : undefined;
+    }
+    get token() {
+        return this._token;
+    }
+    /** CDN base URL (no trailing slash). */
+    get cdnUrl() {
+        return this.cdnBaseUrl;
+    }
+    headers() {
+        return buildHeaders({ token: this._token, routeTag: this.routeTag, rand: this.rand });
+    }
+    baseInfo() {
+        return buildBaseInfo({ botAgent: this.botAgent });
+    }
+    async post(endpoint, body, signal, timeoutMs) {
+        const url = ensureSlash(this._baseUrl) + endpoint;
+        try {
+            const init = { method: 'POST', headers: this.headers(), body };
+            if (timeoutMs !== undefined)
+                init.timeoutMs = timeoutMs;
+            return await this.transport.request(url, init, signal);
+        }
+        catch (error) {
+            throw normalizeILinkError(error, { operation: endpoint, accountId: this.accountId });
+        }
+    }
+    async get(endpoint, signal, timeoutMs) {
+        const url = ensureSlash(this._baseUrl) + endpoint;
+        const init = { method: 'GET', headers: this.headers() };
+        if (timeoutMs !== undefined)
+            init.timeoutMs = timeoutMs;
+        try {
+            return await this.transport.request(url, init, signal);
+        }
+        catch (error) {
+            throw normalizeILinkError(error, { operation: endpoint, accountId: this.accountId });
+        }
+    }
+    parseResponse(schema, raw, operation) {
+        // Decode the common error envelope first. Error responses are not required
+        // to carry endpoint-specific success fields such as QR content.
+        const envelope = responseEnvelopeSchema.safeParse(raw);
+        if (envelope.success &&
+            ((envelope.data.ret !== undefined && envelope.data.ret !== 0) ||
+                (envelope.data.errcode !== undefined && envelope.data.errcode !== 0))) {
+            throw normalizeILinkError(new Error(envelope.data.errmsg ?? 'iLink protocol error'), {
+                operation,
+                accountId: this.accountId,
+                ret: envelope.data.ret,
+                errcode: envelope.data.errcode,
+                errmsg: envelope.data.errmsg,
+            });
+        }
+        const parsed = schema.safeParse(raw);
+        if (!parsed.success) {
+            throw normalizeILinkError(new Error('invalid iLink response shape'), {
+                operation,
+                accountId: this.accountId,
+            });
+        }
+        const response = parsed.data;
+        return response;
+    }
+    /** POST /ilink/bot/get_bot_qrcode?bot_type=3 with { local_token_list: [] }. */
+    async getBotQrcode(options = {}) {
+        const endpoint = `${ENDPOINT_GET_BOT_QRCODE}?bot_type=${encodeURIComponent(DEFAULT_BOT_TYPE)}`;
+        const raw = await this.post(endpoint, {
+            local_token_list: normalizeLocalTokens(options.localTokens),
+        }, options.signal);
+        return this.parseResponse(qrCodeResponseSchema, raw, ENDPOINT_GET_BOT_QRCODE);
+    }
+    /**
+     * GET /ilink/bot/get_qrcode_status?qrcode=... (optionally &verify_code=...).
+     *
+     * This is a long-poll endpoint: the server holds the request open while the
+     * status is `wait` (before the user scans). A client-side long-poll timeout
+     * is therefore normal control flow — same semantics as `getUpdates` — and is
+     * mapped back to `{ status: 'wait' }` so `WeixinQrAuth` never has to reason
+     * about HTTP timeouts: timeout → wait → pending → next poll.
+     */
+    async getQrcodeStatus(qrcode, opts = {}) {
+        let endpoint = `${ENDPOINT_GET_QRCODE_STATUS}?qrcode=${encodeURIComponent(qrcode)}`;
+        if (opts.verifyCode) {
+            endpoint += `&verify_code=${encodeURIComponent(opts.verifyCode)}`;
+        }
+        try {
+            const raw = await this.get(endpoint, opts.signal, DEFAULT_QR_POLL_TIMEOUT_MS);
+            return this.parseResponse(qrStatusResponseSchema, raw, ENDPOINT_GET_QRCODE_STATUS);
+        }
+        catch (error) {
+            if (isClientAbortOrTimeout(error)) {
+                return { status: 'wait' };
+            }
+            throw error;
+        }
+    }
+    /**
+     * POST /ilink/bot/getupdates.
+     * A long-poll client-side timeout is normal control flow: returns an empty
+     * result with `timedOut: true` so the monitor can simply retry.
+     */
+    async getUpdates(params = {}) {
+        const timeout = params.longPollTimeoutMs ?? this.longPollTimeoutMs;
+        try {
+            const raw = await this.post(ENDPOINT_GET_UPDATES, { get_updates_buf: params.getUpdatesBuf ?? '', base_info: this.baseInfo() }, params.signal, timeout);
+            const resp = this.parseResponse(getUpdatesResponseSchema, raw, ENDPOINT_GET_UPDATES);
+            return {
+                msgs: resp.msgs ?? [],
+                get_updates_buf: resp.get_updates_buf,
+                nextLongPollTimeoutMs: resp.longpolling_timeout_ms,
+                timedOut: false,
+            };
+        }
+        catch (error) {
+            if (isLongPollClientTimeout(error)) {
+                return { msgs: [], get_updates_buf: params.getUpdatesBuf, timedOut: true };
+            }
+            throw error;
+        }
+    }
+    /** POST /ilink/bot/sendmessage. */
+    async sendMessage(req, signal) {
+        const body = { ...req, base_info: req.base_info ?? this.baseInfo() };
+        const raw = await this.post(ENDPOINT_SEND_MESSAGE, body, signal);
+        return this.parseResponse(sendMessageResponseSchema, raw, ENDPOINT_SEND_MESSAGE);
+    }
+    /** POST /ilink/bot/getuploadurl (WX5 media upload slot). */
+    async getUploadUrl(req, signal) {
+        const body = { ...req, base_info: req.base_info ?? this.baseInfo() };
+        const raw = await this.post(ENDPOINT_GET_UPLOAD_URL, body, signal);
+        return this.parseResponse(getUploadUrlResponseSchema, raw, ENDPOINT_GET_UPLOAD_URL);
+    }
+    /** POST /ilink/bot/getconfig. */
+    async getConfig(req, signal) {
+        const body = { ...req, base_info: req.base_info ?? this.baseInfo() };
+        const raw = await this.post(ENDPOINT_GET_CONFIG, body, signal);
+        return this.parseResponse(getConfigResponseSchema, raw, ENDPOINT_GET_CONFIG);
+    }
+    /** POST /ilink/bot/sendtyping. */
+    async sendTyping(req, signal) {
+        const body = { ...req, base_info: req.base_info ?? this.baseInfo() };
+        const raw = await this.post(ENDPOINT_SEND_TYPING, body, signal);
+        return this.parseResponse(sendTypingResponseSchema, raw, ENDPOINT_SEND_TYPING);
+    }
+    /** POST /ilink/bot/msg/notifystart (best effort). */
+    async notifyStart(signal) {
+        const raw = await this.post(ENDPOINT_NOTIFY_START, { base_info: this.baseInfo() }, signal);
+        return this.parseResponse(notifyResponseSchema, raw, ENDPOINT_NOTIFY_START);
+    }
+    /** POST /ilink/bot/msg/notifystop (best effort). */
+    async notifyStop(signal) {
+        const raw = await this.post(ENDPOINT_NOTIFY_STOP, { base_info: this.baseInfo() }, signal);
+        return this.parseResponse(notifyResponseSchema, raw, ENDPOINT_NOTIFY_STOP);
+    }
+}
+/** A long-poll getUpdates client-side timeout (AbortError from the timeout) is treated as empty. */
+function isLongPollClientTimeout(error) {
+    return isClientAbortOrTimeout(error);
+}
+/**
+ * Client-side abort/timeout (walking the `.cause` chain) — the transport and
+ * `normalizeILinkError` wrap the raw `AbortError`, so we must follow `cause`
+ * to classify a long-poll timeout as normal control flow rather than an error.
+ */
+function isClientAbortOrTimeout(error) {
+    let cur = error;
+    // Guard against cycles.
+    const seen = new Set();
+    while (cur && !seen.has(cur)) {
+        seen.add(cur);
+        const name = cur?.name;
+        if (name === 'AbortError' || name === 'ILinkAbortError' || name === 'ILinkTimeoutError' || name === 'TimeoutError') {
+            return true;
+        }
+        const msg = typeof cur?.message === 'string' ? cur.message : '';
+        if (msg.includes('http request aborted') || msg.includes('timed out')) {
+            return true;
+        }
+        cur = cur?.cause;
+    }
+    return false;
+}
+//# sourceMappingURL=client.js.map

package/lib/ilink/client.js.map

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

package/lib/ilink/constants.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Classification: C — duplicate protocol constants [@deprecated upstream-gap].
+ *
+ * iLink endpoint table + header names + wire values self-maintained. The
+ * official package's constants live in api/types.js (endpoint paths are NOT
+ * exported there — they are hard-coded inside api/api.js, which is OpenClaw
+ * coupled). The endpoint PATH strings here are protocol knowledge that the
+ * official coupled module owns; kept behind the facade as an upstream-gap
+ * until Tencent exposes public host-neutral API endpoints. Marked upstream-gap.
+ */
+/**
+ * Tencent Weixin iLink protocol constants.
+ *
+ * Endpoint paths, header names and fixed wire values for the direct iLink
+ * client. Clean-room implementation ported from the Tencent/openclaw-weixin
+ * protocol description (see THIRD_PARTY_NOTICES for provenance).
+ */
+/** Default API base URL for all iLink CGI requests. */
+export declare const DEFAULT_BASE_URL = "https://ilinkai.weixin.qq.com";
+/** Default CDN base URL for media download/upload. */
+export declare const DEFAULT_CDN_BASE_URL = "https://novac2c.cdn.weixin.qq.com/c2c";
+/** Default bot type used for QR login (`get_bot_qrcode?bot_type=3`). */
+export declare const DEFAULT_BOT_TYPE = "3";
+/** iLink-App-Id constant fixed by the protocol for bot clients. */
+export declare const ILINK_APP_ID = "bot";
+/** Authorization scheme for the `Authorization` header. */
+export declare const AUTHORIZATION_TYPE = "ilink_bot_token";
+/** Header names used by the iLink protocol. */
+export declare const HEADER_CONTENT_TYPE = "Content-Type";
+export declare const HEADER_AUTHORIZATION_TYPE = "AuthorizationType";
+export declare const HEADER_AUTHORIZATION = "Authorization";
+export declare const HEADER_X_WECHAT_UIN = "X-WECHAT-UIN";
+export declare const HEADER_ILINK_APP_ID = "iLink-App-Id";
+export declare const HEADER_ILINK_APP_CLIENT_VERSION = "iLink-App-ClientVersion";
+export declare const HEADER_SK_ROUTE_TAG = "SKRouteTag";
+/** API endpoint paths (relative to the base URL). */
+export declare const ENDPOINT_GET_BOT_QRCODE = "ilink/bot/get_bot_qrcode";
+export declare const ENDPOINT_GET_QRCODE_STATUS = "ilink/bot/get_qrcode_status";
+export declare const ENDPOINT_GET_UPDATES = "ilink/bot/getupdates";
+export declare const ENDPOINT_SEND_MESSAGE = "ilink/bot/sendmessage";
+export declare const ENDPOINT_GET_CONFIG = "ilink/bot/getconfig";
+export declare const ENDPOINT_SEND_TYPING = "ilink/bot/sendtyping";
+export declare const ENDPOINT_NOTIFY_START = "ilink/bot/msg/notifystart";
+export declare const ENDPOINT_NOTIFY_STOP = "ilink/bot/msg/notifystop";
+export declare const ENDPOINT_GET_UPLOAD_URL = "ilink/bot/getuploadurl";
+/** Default long-poll timeout for `getUpdates` (server holds the request). */
+export declare const DEFAULT_LONG_POLL_TIMEOUT_MS = 35000;
+/** Default long-poll timeout for `get_qrcode_status` (server holds the request). */
+export declare const DEFAULT_QR_POLL_TIMEOUT_MS = 35000;
+/** Default timeout for regular API requests (`sendMessage`, QR calls). */
+export declare const DEFAULT_API_TIMEOUT_MS = 15000;
+/** Default timeout for lightweight API requests (`getConfig`, `sendTyping`). */
+export declare const DEFAULT_CONFIG_TIMEOUT_MS = 10000;
+/**
+ * Exit code `-14` reported by the server when the bot token is stale /
+ * expired. Detected and surfaced as a typed `StaleTokenError`.
+ */
+export declare const STALE_TOKEN_ERRCODE = -14;
+//# sourceMappingURL=constants.d.ts.map

package/lib/ilink/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/ilink/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH;;;;;;GAMG;AAEH,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,kCAAkC,CAAC;AAEhE,sDAAsD;AACtD,eAAO,MAAM,oBAAoB,0CAA0C,CAAC;AAE5E,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,mEAAmE;AACnE,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AAEpD,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAC7D,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,eAAO,MAAM,+BAA+B,4BAA4B,CAAC;AACzE,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD,qDAAqD;AACrD,eAAO,MAAM,uBAAuB,6BAA6B,CAAC;AAClE,eAAO,MAAM,0BAA0B,gCAAgC,CAAC;AACxE,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,qBAAqB,8BAA8B,CAAC;AACjE,eAAO,MAAM,oBAAoB,6BAA6B,CAAC;AAC/D,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAEhE,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD,oFAAoF;AACpF,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,MAAM,CAAC"}

package/lib/ilink/constants.js

@@ -0,0 +1,59 @@
+/**
+ * Classification: C — duplicate protocol constants [@deprecated upstream-gap].
+ *
+ * iLink endpoint table + header names + wire values self-maintained. The
+ * official package's constants live in api/types.js (endpoint paths are NOT
+ * exported there — they are hard-coded inside api/api.js, which is OpenClaw
+ * coupled). The endpoint PATH strings here are protocol knowledge that the
+ * official coupled module owns; kept behind the facade as an upstream-gap
+ * until Tencent exposes public host-neutral API endpoints. Marked upstream-gap.
+ */
+/**
+ * Tencent Weixin iLink protocol constants.
+ *
+ * Endpoint paths, header names and fixed wire values for the direct iLink
+ * client. Clean-room implementation ported from the Tencent/openclaw-weixin
+ * protocol description (see THIRD_PARTY_NOTICES for provenance).
+ */
+/** Default API base URL for all iLink CGI requests. */
+export const DEFAULT_BASE_URL = 'https://ilinkai.weixin.qq.com';
+/** Default CDN base URL for media download/upload. */
+export const DEFAULT_CDN_BASE_URL = 'https://novac2c.cdn.weixin.qq.com/c2c';
+/** Default bot type used for QR login (`get_bot_qrcode?bot_type=3`). */
+export const DEFAULT_BOT_TYPE = '3';
+/** iLink-App-Id constant fixed by the protocol for bot clients. */
+export const ILINK_APP_ID = 'bot';
+/** Authorization scheme for the `Authorization` header. */
+export const AUTHORIZATION_TYPE = 'ilink_bot_token';
+/** Header names used by the iLink protocol. */
+export const HEADER_CONTENT_TYPE = 'Content-Type';
+export const HEADER_AUTHORIZATION_TYPE = 'AuthorizationType';
+export const HEADER_AUTHORIZATION = 'Authorization';
+export const HEADER_X_WECHAT_UIN = 'X-WECHAT-UIN';
+export const HEADER_ILINK_APP_ID = 'iLink-App-Id';
+export const HEADER_ILINK_APP_CLIENT_VERSION = 'iLink-App-ClientVersion';
+export const HEADER_SK_ROUTE_TAG = 'SKRouteTag';
+/** API endpoint paths (relative to the base URL). */
+export const ENDPOINT_GET_BOT_QRCODE = 'ilink/bot/get_bot_qrcode';
+export const ENDPOINT_GET_QRCODE_STATUS = 'ilink/bot/get_qrcode_status';
+export const ENDPOINT_GET_UPDATES = 'ilink/bot/getupdates';
+export const ENDPOINT_SEND_MESSAGE = 'ilink/bot/sendmessage';
+export const ENDPOINT_GET_CONFIG = 'ilink/bot/getconfig';
+export const ENDPOINT_SEND_TYPING = 'ilink/bot/sendtyping';
+export const ENDPOINT_NOTIFY_START = 'ilink/bot/msg/notifystart';
+export const ENDPOINT_NOTIFY_STOP = 'ilink/bot/msg/notifystop';
+export const ENDPOINT_GET_UPLOAD_URL = 'ilink/bot/getuploadurl';
+/** Default long-poll timeout for `getUpdates` (server holds the request). */
+export const DEFAULT_LONG_POLL_TIMEOUT_MS = 35_000;
+/** Default long-poll timeout for `get_qrcode_status` (server holds the request). */
+export const DEFAULT_QR_POLL_TIMEOUT_MS = 35_000;
+/** Default timeout for regular API requests (`sendMessage`, QR calls). */
+export const DEFAULT_API_TIMEOUT_MS = 15_000;
+/** Default timeout for lightweight API requests (`getConfig`, `sendTyping`). */
+export const DEFAULT_CONFIG_TIMEOUT_MS = 10_000;
+/**
+ * Exit code `-14` reported by the server when the bot token is stale /
+ * expired. Detected and surfaced as a typed `StaleTokenError`.
+ */
+export const STALE_TOKEN_ERRCODE = -14;
+//# sourceMappingURL=constants.js.map

package/lib/ilink/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/ilink/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH;;;;;;GAMG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AAEhE,sDAAsD;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAG,uCAAuC,CAAC;AAE5E,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC,mEAAmE;AACnE,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAElC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAEpD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAC;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAClD,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAClD,MAAM,CAAC,MAAM,+BAA+B,GAAG,yBAAyB,CAAC;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEhD,qDAAqD;AACrD,MAAM,CAAC,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AAClE,MAAM,CAAC,MAAM,0BAA0B,GAAG,6BAA6B,CAAC;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAC/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,wBAAwB,CAAC;AAEhE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAEnD,oFAAoF;AACpF,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAEjD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,gFAAgF;AAChF,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,EAAE,CAAC"}