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

package/lib/ilink-api.d.ts

@@ -1,7 +1,9 @@
+import { type IlinkClientMetadata } from "./ilink-meta.js";
 import type { GetUploadUrlReq, GetUploadUrlResp, GetUpdatesReq, GetUpdatesResp, NotifyStopResp, NotifyStartResp, SendMessageReq, SendTypingReq, GetConfigResp } from "./ilink-types.js";
-export { buildBaseInfo, sanitizeBotAgent } from "./ilink-meta.js";
+export { IlinkClientMetadata, sanitizeBotAgent } from "./ilink-meta.js";
 export type WeixinApiOptions = {
     baseUrl: string;
+    metadata: IlinkClientMetadata;
     token?: string;
     timeoutMs?: number;
     /** Long-poll timeout for getUpdates (server may hold the request up to this). */
@@ -15,9 +17,11 @@ export type WeixinApiOptions = {
  */
 export declare function apiGetFetch(params: {
     baseUrl: string;
+    metadata: IlinkClientMetadata;
     endpoint: string;
     timeoutMs?: number;
     label: string;
+    abortSignal?: AbortSignal;
 }): Promise<string>;
 /**
  * Common fetch wrapper: POST JSON to a Weixin API endpoint.
@@ -28,6 +32,7 @@ export declare function apiGetFetch(params: {
  */
 export declare function apiPostFetch(params: {
     baseUrl: string;
+    metadata: IlinkClientMetadata;
     endpoint: string;
     body: string;
     token?: string;
@@ -41,10 +46,7 @@ export declare function apiPostFetch(params: {
  * 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;
+export declare function getUpdates(params: GetUpdatesReq & WeixinApiOptions & {
     /**
      * Optional external abort signal (e.g. from the gateway when stopping the
      * channel). When this aborts, the in-flight long-poll is terminated
@@ -78,4 +80,3 @@ export declare function notifyStop(params: WeixinApiOptions): Promise<NotifyStop
  * 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.js

@@ -1,8 +1,8 @@
 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 { ILINK_APP_ID, } from "./ilink-meta.js";
 import { redactBody, redactUrl } from "./ilink-redact.js";
-export { buildBaseInfo, sanitizeBotAgent } from "./ilink-meta.js";
+export { IlinkClientMetadata, 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). */
@@ -18,10 +18,10 @@ function randomWechatUin() {
     return Buffer.from(String(uint32), "utf-8").toString("base64");
 }
 /** Build headers shared by both GET and POST requests. */
-function buildCommonHeaders() {
+function buildCommonHeaders(metadata) {
     const headers = {
         "iLink-App-Id": ILINK_APP_ID,
-        "iLink-App-ClientVersion": String(ILINK_APP_CLIENT_VERSION),
+        "iLink-App-ClientVersion": String(metadata.appClientVersion),
     };
     return headers;
 }
@@ -30,7 +30,7 @@ function buildHeaders(opts) {
         "Content-Type": "application/json",
         AuthorizationType: "ilink_bot_token",
         "X-WECHAT-UIN": randomWechatUin(),
-        ...buildCommonHeaders(),
+        ...buildCommonHeaders(opts.metadata),
     };
     if (opts.token?.trim()) {
         headers.Authorization = `Bearer ${opts.token.trim()}`;
@@ -47,18 +47,19 @@ function buildHeaders(opts) {
 export async function apiGetFetch(params) {
     const base = ensureTrailingSlash(params.baseUrl);
     const url = new URL(params.endpoint, base);
-    const hdrs = buildCommonHeaders();
+    const hdrs = buildCommonHeaders(params.metadata);
     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;
+    const { signal, cleanup } = combineAbortSignals(controller, params.abortSignal);
     try {
         const res = await fetch(url.toString(), {
             method: "GET",
             headers: hdrs,
-            ...(controller ? { signal: controller.signal } : {}),
+            ...(signal ? { signal } : {}),
         });
         if (t !== undefined)
             clearTimeout(t);
@@ -74,6 +75,9 @@ export async function apiGetFetch(params) {
             clearTimeout(t);
         throw err;
     }
+    finally {
+        cleanup();
+    }
 }
 function combineAbortSignals(internal, external) {
     if (!internal && !external)
@@ -103,7 +107,7 @@ function combineAbortSignals(internal, external) {
 export async function apiPostFetch(params) {
     const base = ensureTrailingSlash(params.baseUrl);
     const url = new URL(params.endpoint, base);
-    const hdrs = buildHeaders({ token: params.token });
+    const hdrs = buildHeaders({ metadata: params.metadata, 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
@@ -144,10 +148,11 @@ export async function getUpdates(params) {
     try {
         const rawText = await apiPostFetch({
             baseUrl: params.baseUrl,
+            metadata: params.metadata,
             endpoint: "ilink/bot/getupdates",
             body: JSON.stringify({
                 get_updates_buf: params.get_updates_buf ?? "",
-                base_info: buildBaseInfo(),
+                base_info: params.metadata.buildBaseInfo(),
             }),
             token: params.token,
             timeoutMs: timeout,
@@ -179,6 +184,7 @@ export async function getUpdates(params) {
 export async function getUploadUrl(params) {
     const rawText = await apiPostFetch({
         baseUrl: params.baseUrl,
+        metadata: params.metadata,
         endpoint: "ilink/bot/getuploadurl",
         body: JSON.stringify({
             filekey: params.filekey,
@@ -192,7 +198,7 @@ export async function getUploadUrl(params) {
             thumb_filesize: params.thumb_filesize,
             no_need_thumb: params.no_need_thumb,
             aeskey: params.aeskey,
-            base_info: buildBaseInfo(),
+            base_info: params.metadata.buildBaseInfo(),
         }),
         token: params.token,
         timeoutMs: params.timeoutMs ?? DEFAULT_API_TIMEOUT_MS,
@@ -205,8 +211,9 @@ export async function getUploadUrl(params) {
 export async function sendMessage(params) {
     await apiPostFetch({
         baseUrl: params.baseUrl,
+        metadata: params.metadata,
         endpoint: "ilink/bot/sendmessage",
-        body: JSON.stringify({ ...params.body, base_info: buildBaseInfo() }),
+        body: JSON.stringify({ ...params.body, base_info: params.metadata.buildBaseInfo() }),
         token: params.token,
         timeoutMs: params.timeoutMs ?? DEFAULT_API_TIMEOUT_MS,
         label: "sendMessage",
@@ -216,11 +223,12 @@ export async function sendMessage(params) {
 export async function getConfig(params) {
     const rawText = await apiPostFetch({
         baseUrl: params.baseUrl,
+        metadata: params.metadata,
         endpoint: "ilink/bot/getconfig",
         body: JSON.stringify({
             ilink_user_id: params.ilinkUserId,
             context_token: params.contextToken,
-            base_info: buildBaseInfo(),
+            base_info: params.metadata.buildBaseInfo(),
         }),
         token: params.token,
         timeoutMs: params.timeoutMs ?? DEFAULT_CONFIG_TIMEOUT_MS,
@@ -233,8 +241,9 @@ export async function getConfig(params) {
 export async function sendTyping(params) {
     await apiPostFetch({
         baseUrl: params.baseUrl,
+        metadata: params.metadata,
         endpoint: "ilink/bot/sendtyping",
-        body: JSON.stringify({ ...params.body, base_info: buildBaseInfo() }),
+        body: JSON.stringify({ ...params.body, base_info: params.metadata.buildBaseInfo() }),
         token: params.token,
         timeoutMs: params.timeoutMs ?? DEFAULT_CONFIG_TIMEOUT_MS,
         label: "sendTyping",
@@ -248,8 +257,9 @@ export async function sendTyping(params) {
 export async function notifyStop(params) {
     const rawText = await apiPostFetch({
         baseUrl: params.baseUrl,
+        metadata: params.metadata,
         endpoint: "ilink/bot/msg/notifystop",
-        body: JSON.stringify({ base_info: buildBaseInfo() }),
+        body: JSON.stringify({ base_info: params.metadata.buildBaseInfo() }),
         token: params.token,
         timeoutMs: params.timeoutMs ?? DEFAULT_CONFIG_TIMEOUT_MS,
         label: "notifyStop",
@@ -262,12 +272,12 @@ export async function notifyStop(params) {
 export async function notifyStart(params) {
     const rawText = await apiPostFetch({
         baseUrl: params.baseUrl,
+        metadata: params.metadata,
         endpoint: "ilink/bot/msg/notifystart",
-        body: JSON.stringify({ base_info: buildBaseInfo() }),
+        body: JSON.stringify({ base_info: params.metadata.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-config-cache.d.ts

@@ -1,3 +1,4 @@
+import { type WeixinApiOptions } from "./ilink-api.js";
 /** Subset of getConfig fields that we actually need; add new fields here as needed. */
 export interface CachedConfig {
     typingTicket: string;
@@ -7,13 +8,7 @@ export interface CachedConfig {
  * 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);
+    #private;
+    constructor(apiOptions: WeixinApiOptions, log: (msg: string) => void);
     getForUser(userId: string, contextToken?: string): Promise<CachedConfig>;
 }
-//# sourceMappingURL=ilink-config-cache.d.ts.map

package/lib/ilink-config-cache.js

@@ -7,39 +7,38 @@ const CONFIG_CACHE_MAX_RETRY_MS = 60 * 60 * 1000;
  * 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;
+    #cache = new Map();
+    #apiOptions;
+    #log;
+    constructor(apiOptions, log) {
+        this.#apiOptions = apiOptions;
+        this.#log = log;
     }
     async getForUser(userId, contextToken) {
         const now = Date.now();
-        const entry = this.cache.get(userId);
+        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,
+                    ...this.#apiOptions,
                     ilinkUserId: userId,
                     contextToken,
                 });
                 if (resp.ret === 0) {
-                    this.cache.set(userId, {
+                    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}`);
+                    this.#log(`[weixin] config ${entry?.everSucceeded ? "refreshed" : "cached"} for ${userId}`);
                     fetchOk = true;
                 }
             }
             catch (err) {
-                this.log(`[weixin] getConfig failed for ${userId} (ignored): ${String(err)}`);
+                this.#log(`[weixin] getConfig failed for ${userId} (ignored): ${String(err)}`);
             }
             if (!fetchOk) {
                 const prevDelay = entry?.retryDelayMs ?? CONFIG_CACHE_INITIAL_RETRY_MS;
@@ -49,7 +48,7 @@ export class WeixinConfigManager {
                     entry.retryDelayMs = nextDelay;
                 }
                 else {
-                    this.cache.set(userId, {
+                    this.#cache.set(userId, {
                         config: { typingTicket: "" },
                         everSucceeded: false,
                         nextFetchAt: now + CONFIG_CACHE_INITIAL_RETRY_MS,
@@ -58,7 +57,6 @@ export class WeixinConfigManager {
                 }
             }
         }
-        return this.cache.get(userId)?.config ?? { typingTicket: "" };
+        return this.#cache.get(userId)?.config ?? { typingTicket: "" };
     }
 }
-//# sourceMappingURL=ilink-config-cache.js.map

package/lib/ilink-logger.d.ts

@@ -5,6 +5,4 @@ export type IlinkLogger = {
     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.js

@@ -1,27 +1,12 @@
-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;
+function createIlinkLogger(prefix = '[weixin-ilink]') {
+    return Object.freeze({
+        debug: () => { },
+        info: () => { },
+        warn: (msg) => console.warn(`${prefix} ${msg}`),
+        error: (msg) => console.error(`${prefix} ${msg}`),
+        withAccount(accountId) {
+            return createIlinkLogger(`[weixin-ilink:${accountId}]`);
+        },
+    });
 }
-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
+export const logger = createIlinkLogger();

package/lib/ilink-meta.d.ts

@@ -2,12 +2,17 @@ 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
+export declare function sanitizeBotAgent(raw: string | undefined, fallback?: string): string;
+export interface IlinkClientMetadataOptions {
+    readonly botAgent?: string;
+    readonly version?: string;
+}
+/** Immutable request identity owned by one endpoint. */
+export declare class IlinkClientMetadata {
+    readonly channelVersion: string;
+    readonly botAgent: string;
+    readonly appClientVersion: number;
+    constructor(options?: IlinkClientMetadataOptions);
+    buildBaseInfo(): BaseInfo;
+}

package/lib/ilink-meta.js

@@ -6,8 +6,6 @@ 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");
@@ -18,13 +16,7 @@ function readPackageVersion() {
         return "0.0.0";
     }
 }
-channelVersion = readPackageVersion();
-export function configureIlinkMeta(opts) {
-    if (opts.botAgent)
-        configuredBotAgent = opts.botAgent;
-    if (opts.version)
-        channelVersion = opts.version;
-}
+const PACKAGE_VERSION = readPackageVersion();
 export function buildClientVersion(version) {
     const parts = version.split(".").map((p) => parseInt(p, 10));
     const major = parts[0] ?? 0;
@@ -32,26 +24,37 @@ export function buildClientVersion(version) {
     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) {
+export function sanitizeBotAgent(raw, fallback = DEFAULT_BOT_AGENT) {
     if (!raw || typeof raw !== "string")
-        return configuredBotAgent ?? DEFAULT_BOT_AGENT;
+        return fallback;
     const trimmed = raw.trim();
     if (!trimmed)
-        return configuredBotAgent ?? DEFAULT_BOT_AGENT;
+        return fallback;
     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;
+        return fallback;
     const joined = tokens.join(" ");
     if (Buffer.byteLength(joined, "utf-8") <= BOT_AGENT_MAX_LEN)
         return joined;
-    return (configuredBotAgent ?? DEFAULT_BOT_AGENT);
+    return fallback;
 }
-export function buildBaseInfo() {
-    return {
-        channel_version: channelVersion,
-        bot_agent: sanitizeBotAgent(configuredBotAgent),
-    };
+/** Immutable request identity owned by one endpoint. */
+export class IlinkClientMetadata {
+    channelVersion;
+    botAgent;
+    appClientVersion;
+    constructor(options = {}) {
+        this.channelVersion = options.version ?? PACKAGE_VERSION;
+        const defaultBotAgent = `Zhin.js/${this.channelVersion}`;
+        this.botAgent = sanitizeBotAgent(options.botAgent, defaultBotAgent);
+        this.appClientVersion = buildClientVersion(this.channelVersion);
+        Object.freeze(this);
+    }
+    buildBaseInfo() {
+        return {
+            channel_version: this.channelVersion,
+            bot_agent: this.botAgent,
+        };
+    }
 }
-//# sourceMappingURL=ilink-meta.js.map

package/lib/ilink-random.d.ts

@@ -8,4 +8,3 @@ export declare function generateId(prefix: string): string;
  * 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.js

@@ -13,4 +13,3 @@ export function generateId(prefix) {
 export function tempFileName(prefix, ext) {
     return `${prefix}-${Date.now()}-${crypto.randomBytes(4).toString("hex")}${ext}`;
 }
-//# sourceMappingURL=ilink-random.js.map

package/lib/ilink-redact.d.ts

@@ -18,4 +18,3 @@ export declare function redactBody(body: string | undefined, maxLen?: number): s
  * keeping only origin + pathname.
  */
 export declare function redactUrl(rawUrl: string): string;
-//# sourceMappingURL=ilink-redact.d.ts.map

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

@@ -1,16 +1,14 @@
-/** Error code returned by the server when the bot session has expired. */
 export declare const SESSION_EXPIRED_ERRCODE = -14;
-/** Pause all inbound/outbound API calls for `accountId` for one hour. */
-export declare function pauseSession(accountId: string): void;
-/** Returns `true` when the bot is still within its one-hour cooldown window. */
-export declare function isSessionPaused(accountId: string): boolean;
-/** Milliseconds remaining until the pause expires (0 when not paused). */
-export declare function getRemainingPauseMs(accountId: string): number;
-/** Throw if the session is currently paused. Call before any API request. */
-export declare function assertSessionActive(accountId: string): void;
-/**
- * Reset internal state — only for tests.
- * @internal
- */
-export declare function _resetForTest(): void;
-//# sourceMappingURL=ilink-session-guard.d.ts.map
+export declare const SESSION_PAUSE_DURATION_MS: number;
+/** Endpoint-owned cooldown state for an authenticated iLink session. */
+export declare class IlinkSessionGuard {
+    #private;
+    readonly accountId: string;
+    private readonly now;
+    private readonly pauseDurationMs;
+    constructor(accountId: string, now?: () => number, pauseDurationMs?: number);
+    pause(): void;
+    get paused(): boolean;
+    get remainingMs(): number;
+    assertActive(): void;
+}

package/lib/ilink-session-guard.js

@@ -1,49 +1,35 @@
-import { logger } from "./ilink-logger.js";
-const SESSION_PAUSE_DURATION_MS = 60 * 60 * 1000;
-/** Error code returned by the server when the bot session has expired. */
+import { logger } from './ilink-logger.js';
 export const SESSION_EXPIRED_ERRCODE = -14;
-const pauseUntilMap = new Map();
-/** Pause all inbound/outbound API calls for `accountId` for one hour. */
-export function pauseSession(accountId) {
-    const until = Date.now() + SESSION_PAUSE_DURATION_MS;
-    pauseUntilMap.set(accountId, until);
-    logger.info(`session-guard: paused accountId=${accountId} until=${new Date(until).toISOString()} (${SESSION_PAUSE_DURATION_MS / 1000}s)`);
-}
-/** Returns `true` when the bot is still within its one-hour cooldown window. */
-export function isSessionPaused(accountId) {
-    const until = pauseUntilMap.get(accountId);
-    if (until === undefined)
-        return false;
-    if (Date.now() >= until) {
-        pauseUntilMap.delete(accountId);
-        return false;
+export const SESSION_PAUSE_DURATION_MS = 60 * 60 * 1000;
+/** Endpoint-owned cooldown state for an authenticated iLink session. */
+export class IlinkSessionGuard {
+    accountId;
+    now;
+    pauseDurationMs;
+    #pauseUntil = 0;
+    constructor(accountId, now = Date.now, pauseDurationMs = SESSION_PAUSE_DURATION_MS) {
+        this.accountId = accountId;
+        this.now = now;
+        this.pauseDurationMs = pauseDurationMs;
     }
-    return true;
-}
-/** Milliseconds remaining until the pause expires (0 when not paused). */
-export function getRemainingPauseMs(accountId) {
-    const until = pauseUntilMap.get(accountId);
-    if (until === undefined)
-        return 0;
-    const remaining = until - Date.now();
-    if (remaining <= 0) {
-        pauseUntilMap.delete(accountId);
+    pause() {
+        this.#pauseUntil = this.now() + this.pauseDurationMs;
+        logger.info(`session-guard: paused accountId=${this.accountId} until=${new Date(this.#pauseUntil).toISOString()} (${this.pauseDurationMs / 1000}s)`);
+    }
+    get paused() {
+        return this.remainingMs > 0;
+    }
+    get remainingMs() {
+        const remaining = this.#pauseUntil - this.now();
+        if (remaining > 0)
+            return remaining;
+        this.#pauseUntil = 0;
         return 0;
     }
-    return remaining;
-}
-/** Throw if the session is currently paused. Call before any API request. */
-export function assertSessionActive(accountId) {
-    if (isSessionPaused(accountId)) {
-        const remainingMin = Math.ceil(getRemainingPauseMs(accountId) / 60_000);
-        throw new Error(`session paused for accountId=${accountId}, ${remainingMin} min remaining (errcode ${SESSION_EXPIRED_ERRCODE})`);
+    assertActive() {
+        const remaining = this.remainingMs;
+        if (remaining === 0)
+            return;
+        throw new Error(`session paused for accountId=${this.accountId}, ${Math.ceil(remaining / 60_000)} min remaining (errcode ${SESSION_EXPIRED_ERRCODE})`);
     }
 }
-/**
- * Reset internal state — only for tests.
- * @internal
- */
-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,20 +1,8 @@
-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 { WeixinIlinkTypingIndicatorManager, enableTypingIndicator, type WeixinIlinkTypingIndicatorConfig, } from "./typing-indicator.js";
-export { registerLoginAssistRoutes } from "./login-assist-routes.js";
-//# sourceMappingURL=index.d.ts.map
+export { formatInboundContent, formatOutboundSegments, inboundMessageId, resolveWeixinIlinkConfig, segmentLocalPath, sleep, type ResolvedWeixinIlinkConfig, type WeixinIlinkEndpointConfig, type WeixinInboundMediaPaths, type WeixinMessageWithMedia, type WeixinWireSegment, } from './protocol.js';
+export type { WeixinMessage, MessageItem } from './ilink-types.js';
+export { WeixinIlinkStateStore, type WeixinIlinkCredentials, } from './credentials.js';
+export { IlinkClientMetadata, sanitizeBotAgent, type IlinkClientMetadataOptions, } 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, type WeixinIlinkClientEventMap, } from './client.js';
+export { WeixinIlinkEndpoint, type WeixinIlinkEndpointOptions, type WeixinIlinkGetUpdates, type WeixinIlinkNotifyStart, type WeixinIlinkNotifyStop, type WeixinIlinkSendText, } from './endpoint.js';