webaiapi 0.0.0-stage → 0.1.0

package/dist/utils/errors.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 自定义异常 —— `legacy-python/src/utils/exceptions.py` 的移植。
+ *
+ * TypeScript 没有「继承 Exception 并按类型捕获」的惯用法，这里保留类层次
+ * （`instanceof` 判断依然好用），但**新增 `code` 字段**：路由层需要把不同异常
+ * 映射成不同的 HTTP 状态码与 OpenAI 错误码，靠字符串比较太脆。
+ *
+ * 与原实现的差异：
+ * - Python 侧 `LoginRequiredException` / `LoginExpiredException` / `RateLimitException` /
+ *   `NetworkException` / `ResponseTimeoutException` / `NoAvailableInstanceError` /
+ *   `AccountBannedError` 定义了但**从未被抛出**（只有 `ModelNotFoundError` 与
+ *   `PlatformUnavailableException` 在用）。这里保留它们（成本极低，且是公开 API 的
+ *   一部分语义），但标注清楚。
+ */
+export declare class AIAPIServiceError extends Error {
+    /** OpenAI 风格错误码（`buildOpenAiError` 的 `code`）。 */
+    readonly code: string;
+    /** 建议的 HTTP 状态码。 */
+    readonly statusCode: number;
+    constructor(message: string, options?: {
+        code?: string;
+        statusCode?: number;
+    });
+}
+/** 需要登录。 */
+export declare class LoginRequiredError extends AIAPIServiceError {
+    constructor(message?: string);
+}
+/** 登录已过期。 */
+export declare class LoginExpiredError extends AIAPIServiceError {
+    constructor(message?: string);
+}
+/** 触发限流。 */
+export declare class RateLimitError extends AIAPIServiceError {
+    constructor(message?: string);
+}
+/** 网络异常。 */
+export declare class NetworkError extends AIAPIServiceError {
+    constructor(message?: string);
+}
+/** 响应超时。 */
+export declare class ResponseTimeoutError extends AIAPIServiceError {
+    constructor(message?: string);
+}
+/** 模型未找到（**在用**：`ModelRouter` 路由失败时抛出，映射为 404）。 */
+export declare class ModelNotFoundError extends AIAPIServiceError {
+    constructor(model: string);
+}
+/** Provider 未找到。 */
+export declare class ProviderNotFoundError extends AIAPIServiceError {
+    constructor(provider: string);
+}
+/** 没有可用的浏览器实例。 */
+export declare class NoAvailableInstanceError extends AIAPIServiceError {
+    constructor(message?: string);
+}
+/** 账号被封禁。 */
+export declare class AccountBannedError extends AIAPIServiceError {
+    constructor(message?: string);
+}
+/** 无效请求（映射为 400）。 */
+export declare class InvalidRequestError extends AIAPIServiceError {
+    constructor(message?: string);
+}
+/** 认证失败（映射为 401）。 */
+export declare class AuthenticationError extends AIAPIServiceError {
+    constructor(message?: string);
+}
+/**
+ * 平台所有账号都不可用（**在用**）。
+ *
+ * 当某平台的所有账号都失败（凭证失效 / 限流 / 被封）时抛出：
+ * - `mix` 模型：router 捕获后切换到下一个优先级平台
+ * - 平台名模型（如 `chatglm`）：不跨平台，直接返回错误给用户
+ */
+export declare class PlatformUnavailableError extends AIAPIServiceError {
+    readonly platform: string;
+    constructor(platform: string, message?: string);
+}
+/** 把任意抛出物转成错误消息（`catch (e)` 的 `e` 类型不确定）。 */
+export declare function errorMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,oBAAoB;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,EAOhF;CACF;AAED,YAAY;AACZ,qBAAa,kBAAmB,SAAQ,iBAAiB;IACvD,YAAY,OAAO,SAAc,EAEhC;CACF;AAED,aAAa;AACb,qBAAa,iBAAkB,SAAQ,iBAAiB;IACtD,YAAY,OAAO,SAAgB,EAElC;CACF;AAED,YAAY;AACZ,qBAAa,cAAe,SAAQ,iBAAiB;IACnD,YAAY,OAAO,SAAiB,EAEnC;CACF;AAED,YAAY;AACZ,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,YAAY,OAAO,SAAS,EAE3B;CACF;AAED,YAAY;AACZ,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,YAAY,OAAO,SAAyB,EAE3C;CACF;AAED,mDAAmD;AACnD,qBAAa,kBAAmB,SAAQ,iBAAiB;IACvD,YAAY,KAAK,EAAE,MAAM,EAExB;CACF;AAED,oBAAoB;AACpB,qBAAa,qBAAsB,SAAQ,iBAAiB;IAC1D,YAAY,QAAQ,EAAE,MAAM,EAE3B;CACF;AAED,kBAAkB;AAClB,qBAAa,wBAAyB,SAAQ,iBAAiB;IAC7D,YAAY,OAAO,SAAe,EAEjC;CACF;AAED,aAAa;AACb,qBAAa,kBAAmB,SAAQ,iBAAiB;IACvD,YAAY,OAAO,SAAW,EAE7B;CACF;AAED,qBAAqB;AACrB,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,YAAY,OAAO,SAAS,EAE3B;CACF;AAED,qBAAqB;AACrB,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,YAAY,OAAO,SAAS,EAE3B;CACF;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAK,EAQzC;CACF;AAED,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD"}

package/dist/utils/errors.js

@@ -0,0 +1,115 @@
+/**
+ * 自定义异常 —— `legacy-python/src/utils/exceptions.py` 的移植。
+ *
+ * TypeScript 没有「继承 Exception 并按类型捕获」的惯用法，这里保留类层次
+ * （`instanceof` 判断依然好用），但**新增 `code` 字段**：路由层需要把不同异常
+ * 映射成不同的 HTTP 状态码与 OpenAI 错误码，靠字符串比较太脆。
+ *
+ * 与原实现的差异：
+ * - Python 侧 `LoginRequiredException` / `LoginExpiredException` / `RateLimitException` /
+ *   `NetworkException` / `ResponseTimeoutException` / `NoAvailableInstanceError` /
+ *   `AccountBannedError` 定义了但**从未被抛出**（只有 `ModelNotFoundError` 与
+ *   `PlatformUnavailableException` 在用）。这里保留它们（成本极低，且是公开 API 的
+ *   一部分语义），但标注清楚。
+ */
+export class AIAPIServiceError extends Error {
+    /** OpenAI 风格错误码（`buildOpenAiError` 的 `code`）。 */
+    code;
+    /** 建议的 HTTP 状态码。 */
+    statusCode;
+    constructor(message, options = {}) {
+        super(message);
+        this.name = new.target.name;
+        this.code = options.code ?? 'internal_error';
+        this.statusCode = options.statusCode ?? 500;
+        // 让 `instanceof` 在编译到 ES5 目标时也可靠（这里目标是 ES2023，仅为稳妥保留）
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** 需要登录。 */
+export class LoginRequiredError extends AIAPIServiceError {
+    constructor(message = '需要登录后才能使用') {
+        super(message, { code: 'login_required', statusCode: 401 });
+    }
+}
+/** 登录已过期。 */
+export class LoginExpiredError extends AIAPIServiceError {
+    constructor(message = '登录已过期，请重新登录') {
+        super(message, { code: 'login_expired', statusCode: 401 });
+    }
+}
+/** 触发限流。 */
+export class RateLimitError extends AIAPIServiceError {
+    constructor(message = '请求过于频繁，请稍后再试') {
+        super(message, { code: 'rate_limit_exceeded', statusCode: 429 });
+    }
+}
+/** 网络异常。 */
+export class NetworkError extends AIAPIServiceError {
+    constructor(message = '网络异常') {
+        super(message, { code: 'network_error', statusCode: 502 });
+    }
+}
+/** 响应超时。 */
+export class ResponseTimeoutError extends AIAPIServiceError {
+    constructor(message = '请求超时：服务器未能在规定时间内完成响应') {
+        super(message, { code: 'request_timeout', statusCode: 504 });
+    }
+}
+/** 模型未找到（**在用**：`ModelRouter` 路由失败时抛出，映射为 404）。 */
+export class ModelNotFoundError extends AIAPIServiceError {
+    constructor(model) {
+        super(`模型 '${model}' 不存在或不可用`, { code: 'model_not_found', statusCode: 404 });
+    }
+}
+/** Provider 未找到。 */
+export class ProviderNotFoundError extends AIAPIServiceError {
+    constructor(provider) {
+        super(`Provider '${provider}' 不存在`, { code: 'provider_not_found', statusCode: 404 });
+    }
+}
+/** 没有可用的浏览器实例。 */
+export class NoAvailableInstanceError extends AIAPIServiceError {
+    constructor(message = '没有可用的浏览器实例') {
+        super(message, { code: 'no_available_instance', statusCode: 503 });
+    }
+}
+/** 账号被封禁。 */
+export class AccountBannedError extends AIAPIServiceError {
+    constructor(message = '账号已被封禁') {
+        super(message, { code: 'account_banned', statusCode: 403 });
+    }
+}
+/** 无效请求（映射为 400）。 */
+export class InvalidRequestError extends AIAPIServiceError {
+    constructor(message = '无效请求') {
+        super(message, { code: 'invalid_request_error', statusCode: 400 });
+    }
+}
+/** 认证失败（映射为 401）。 */
+export class AuthenticationError extends AIAPIServiceError {
+    constructor(message = '认证失败') {
+        super(message, { code: 'invalid_api_key', statusCode: 401 });
+    }
+}
+/**
+ * 平台所有账号都不可用（**在用**）。
+ *
+ * 当某平台的所有账号都失败（凭证失效 / 限流 / 被封）时抛出：
+ * - `mix` 模型：router 捕获后切换到下一个优先级平台
+ * - 平台名模型（如 `chatglm`）：不跨平台，直接返回错误给用户
+ */
+export class PlatformUnavailableError extends AIAPIServiceError {
+    platform;
+    constructor(platform, message = '') {
+        super(message
+            ? `平台 '${platform}' 不可用: ${message}`
+            : `平台 '${platform}' 不可用（所有账号均失败）`, { code: 'platform_unavailable', statusCode: 503 });
+        this.platform = platform;
+    }
+}
+/** 把任意抛出物转成错误消息（`catch (e)` 的 `e` 类型不确定）。 */
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,iDAAiD;IACxC,IAAI,CAAS;IAEtB,oBAAoB;IACX,UAAU,CAAS;IAE5B,YAAY,OAAe,EAAE,OAAO,GAA2C,EAAE;QAC/E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,gBAAgB,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;QAC5C,sDAAsD;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,YAAY;AACZ,MAAM,OAAO,kBAAmB,SAAQ,iBAAiB;IACvD,YAAY,OAAO,GAAG,WAAW;QAC/B,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,aAAa;AACb,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IACtD,YAAY,OAAO,GAAG,aAAa;QACjC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,YAAY;AACZ,MAAM,OAAO,cAAe,SAAQ,iBAAiB;IACnD,YAAY,OAAO,GAAG,cAAc;QAClC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IACnE,CAAC;CACF;AAED,YAAY;AACZ,MAAM,OAAO,YAAa,SAAQ,iBAAiB;IACjD,YAAY,OAAO,GAAG,MAAM;QAC1B,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,YAAY;AACZ,MAAM,OAAO,oBAAqB,SAAQ,iBAAiB;IACzD,YAAY,OAAO,GAAG,sBAAsB;QAC1C,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,OAAO,kBAAmB,SAAQ,iBAAiB;IACvD,YAAY,KAAa;QACvB,KAAK,CAAC,OAAO,KAAK,WAAW,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF;AAED,oBAAoB;AACpB,MAAM,OAAO,qBAAsB,SAAQ,iBAAiB;IAC1D,YAAY,QAAgB;QAC1B,KAAK,CAAC,aAAa,QAAQ,OAAO,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IACvF,CAAC;CACF;AAED,kBAAkB;AAClB,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IAC7D,YAAY,OAAO,GAAG,YAAY;QAChC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IACrE,CAAC;CACF;AAED,aAAa;AACb,MAAM,OAAO,kBAAmB,SAAQ,iBAAiB;IACvD,YAAY,OAAO,GAAG,QAAQ;QAC5B,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,qBAAqB;AACrB,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD,YAAY,OAAO,GAAG,MAAM;QAC1B,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IACrE,CAAC;CACF;AAED,qBAAqB;AACrB,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD,YAAY,OAAO,GAAG,MAAM;QAC1B,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IACpD,QAAQ,CAAS;IAE1B,YAAY,QAAgB,EAAE,OAAO,GAAG,EAAE;QACxC,KAAK,CACH,OAAO;YACL,CAAC,CAAC,OAAO,QAAQ,UAAU,OAAO,EAAE;YACpC,CAAC,CAAC,OAAO,QAAQ,gBAAgB,EACnC,EAAE,IAAI,EAAE,sBAAsB,EAAE,UAAU,EAAE,GAAG,EAAE,CAClD,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,6CAA6C;AAC7C,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/utils/mutex.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 简单互斥锁 —— 替代 Python 的 `asyncio.Lock`。
+ *
+ * Node 没有内置的异步锁，而为这一处需求引入依赖不划算，所以自己实现（约 30 行）。
+ *
+ * 用法：
+ * ```ts
+ * const lock = new Mutex();
+ * await lock.run(async () => { ... });   // 等价于 Python 的 `async with lock:`
+ * if (lock.isLocked) { ... }             // 等价于 Python 的 `lock.locked()`
+ * ```
+ */
+export declare class Mutex {
+    /** 等待者队列：release 时把锁直接交给队首（而不是先释放再竞争）。 */
+    private readonly waiters;
+    private held;
+    /** 当前是否已被持有。 */
+    get isLocked(): boolean;
+    /** 等待者数量（仅用于诊断/测试）。 */
+    get pending(): number;
+    /**
+     * 获取锁；返回释放函数。
+     *
+     * 请在 `finally` 里调用释放函数，保证异常路径也能解锁。
+     */
+    acquire(): Promise<() => void>;
+    /** 在锁保护下执行 `fn`（等价于 Python 的 `async with lock:`）。 */
+    run<T>(fn: () => Promise<T>): Promise<T>;
+    private release;
+}
+//# sourceMappingURL=mutex.d.ts.map

package/dist/utils/mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.d.ts","sourceRoot":"","sources":["../../src/utils/mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,qBAAa,KAAK;IAChB,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD,OAAO,CAAC,IAAI,CAAS;IAErB,gBAAgB;IAChB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,uBAAuB;IACvB,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,CAWnC;IAED,qDAAqD;IAC/C,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAO7C;IAED,OAAO,CAAC,OAAO;CAShB"}

package/dist/utils/mutex.js

@@ -0,0 +1,61 @@
+/**
+ * 简单互斥锁 —— 替代 Python 的 `asyncio.Lock`。
+ *
+ * Node 没有内置的异步锁，而为这一处需求引入依赖不划算，所以自己实现（约 30 行）。
+ *
+ * 用法：
+ * ```ts
+ * const lock = new Mutex();
+ * await lock.run(async () => { ... });   // 等价于 Python 的 `async with lock:`
+ * if (lock.isLocked) { ... }             // 等价于 Python 的 `lock.locked()`
+ * ```
+ */
+export class Mutex {
+    /** 等待者队列：release 时把锁直接交给队首（而不是先释放再竞争）。 */
+    waiters = [];
+    held = false;
+    /** 当前是否已被持有。 */
+    get isLocked() {
+        return this.held;
+    }
+    /** 等待者数量（仅用于诊断/测试）。 */
+    get pending() {
+        return this.waiters.length;
+    }
+    /**
+     * 获取锁；返回释放函数。
+     *
+     * 请在 `finally` 里调用释放函数，保证异常路径也能解锁。
+     */
+    async acquire() {
+        if (!this.held) {
+            this.held = true;
+            return () => this.release();
+        }
+        await new Promise((resolve) => {
+            this.waiters.push(resolve);
+        });
+        // 被唤醒时锁已经「转交」给它，仍处于 held 状态
+        return () => this.release();
+    }
+    /** 在锁保护下执行 `fn`（等价于 Python 的 `async with lock:`）。 */
+    async run(fn) {
+        const release = await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            release();
+        }
+    }
+    release() {
+        const next = this.waiters.shift();
+        if (next) {
+            // 直接转交，避免「释放 → 被别的调用抢占」导致排队失效
+            next();
+            return;
+        }
+        this.held = false;
+    }
+}
+//# sourceMappingURL=mutex.js.map

package/dist/utils/mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.js","sourceRoot":"","sources":["../../src/utils/mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,KAAK;IAChB,0CAA0C;IACzB,OAAO,GAAsB,EAAE,CAAC;IAEzC,IAAI,GAAG,KAAK,CAAC;IAErB,gBAAgB;IAChB,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,4BAA4B;QAC5B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,GAAG,CAAI,EAAoB;QAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,OAAO;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,8BAA8B;YAC9B,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/utils/prompt.d.ts

@@ -0,0 +1,150 @@
+/**
+ * 是否输出 ANSI 颜色。
+ *
+ * 遵循 `NO_COLOR` 约定（https://no-color.org），且只在输出为 TTY 时上色 ——
+ * 否则 `webapi login > log.txt` 会把转义序列写进文件。
+ */
+export declare function supportsColor(): boolean;
+export declare const cyan: (text: string) => string;
+export declare const bold: (text: string) => string;
+export declare const dim: (text: string) => string;
+/**
+ * 字符串在终端里占的**列数**。
+ *
+ * ⚠️ 存在的理由：`String.prototype.length` / `padEnd` 数的是**码元**，
+ * 而中文、全角标点在终端占**两列**。用 `padEnd` 对齐「ChatGLM (智谱)」这种
+ * 中英混排的表，第二列会参差不齐 —— 菜单看着就是乱的。
+ */
+export declare function displayWidth(text: string): number;
+/** 按**显示宽度**右填空格（`padEnd` 的中英混排安全版）。 */
+export declare function padDisplay(text: string, width: number): string;
+/**
+ * 当前是否处于**可交互**环境（两端都是 TTY）。
+ *
+ * 只要有一端不是 TTY 就不能走 raw mode：`stdout` 被重定向时用户看不到菜单，
+ * `stdin` 被重定向时按键根本到不了我们手上。
+ */
+export declare function isInteractive(): boolean;
+export interface Choice<T> {
+    /** 返回给调用方的值。 */
+    value: T;
+    /** 显示文本。 */
+    label: string;
+    /** 补充说明（灰色，跟在 label 后面）。 */
+    hint?: string;
+    /** 非空表示**当前不可选**，内容是不可选的原因（会显示给用户）。 */
+    disabled?: string;
+}
+/**
+ * 把选项列表渲染成多行文本。
+ *
+ * 返回 `string[]` 而不是拼好的字符串：调用方需要知道**行数**才能在原地重绘
+ * （光标上移 N 行 → 清除 → 重画），而且逐行更好断言。
+ */
+export declare function renderChoiceList<T>(choices: ReadonlyArray<Choice<T>>, selectedIndex: number, options?: {
+    numbered?: boolean;
+    indent?: string;
+}): string[];
+/** {@link resolveChoiceInput} 的判定结果。 */
+export type ChoiceResolution = {
+    kind: 'ok';
+    index: number;
+} | {
+    kind: 'cancel';
+} | {
+    kind: 'retry';
+    reason: string;
+};
+/**
+ * 把用户输入的一行文本解析成「选中了第几项」。
+ *
+ * 与 {@link selectOne} 的**非 TTY 降级路径**共用同一套规则，保证两条路径
+ * 对「空输入 / 数字 / q / 越界」的处理完全一致 —— 否则会出现
+ * 「管道里能用、终端里不能用」这种最难复现的差异。
+ *
+ * 规则：
+ * - 空输入（直接回车）→ 默认项（{@link defaultIndex}，未指定则第 1 项）
+ * - `数字` → 第 N 项（1 起算）
+ * - `q` / `Q` → 取消（返回 `cancel`）
+ * - 其余、越界、以及选中 **disabled** 项 → `retry`（带原因，让调用方提示后重问）
+ *
+ * ⚠️ disabled 项**返回 retry 而不是静默忽略**：用户在非 TTY 下看不到「不可选」
+ * 的视觉提示，必须明确告诉他原因，否则他会以为自己选错了数字。
+ */
+export declare function resolveChoiceInput<T>(raw: string, choices: ReadonlyArray<Choice<T>>, defaultIndex?: number): ChoiceResolution;
+/** 从 `defaultIndex` 开始往后找第一个可选中的项（找不到返回 0）。 */
+export declare function firstSelectableIndex<T>(choices: ReadonlyArray<Choice<T>>): number;
+/** 一个按键事件。 */
+export type KeyToken = {
+    kind: 'up';
+} | {
+    kind: 'down';
+} | {
+    kind: 'enter';
+} | {
+    kind: 'cancel';
+} | {
+    kind: 'sigint';
+} | {
+    kind: 'char';
+    value: string;
+};
+/**
+ * 把一段输入切成**逐个按键**。
+ *
+ * ## ⚠️ 为什么必须做这件事（真实缺陷，不是洁癖）
+ * `stdin` 的 `data` 事件**不保证一次只有一个按键**：
+ * - 按住方向键时终端会把多个 `\u001b[B` 合并成一个 chunk；
+ * - 粘贴、管道、`script` 这类 pty 转发会一次送进来一整串（如 `\u001b[B\r`）；
+ * - 高延迟/慢终端下两次按键可能落在同一个 chunk 里。
+ *
+ * 若像最初那样用一个 `switch (chunk)` 精确匹配整块，**只有恰好等于
+ * `'\u001b[B'` 的 chunk 才生效**，其余情况全部落进 `default` 分支被丢掉 ——
+ * 表现为「方向键时灵时不灵」「按了回车没反应」，且完全不打日志。
+ *
+ * ## 返回值里的 `rest`
+ * 流式解析时末尾可能是**半个转义序列**（chunk 在 `\u001b` 或 `\u001b[` 处被切开），
+ * 这部分要留给下一个 chunk 拼接，所以放在 `rest` 里返回而不是当成按键。
+ *
+ * 但「单独按下 Esc」产生的**恰好也是**一个孤立 `\u001b` —— 两者无法只靠字节区分。
+ * 因此调用方在 `rest` 非空时起一个 ~40ms 的定时器：等不到后续字节，
+ * 就带 `flushTrailingEscape: true` 再解析一次，把它判定为 Esc。
+ *
+ * @param options.flushTrailingEscape 等待超时后的收尾解析：把末尾残缺的转义
+ *   序列当作「用户按了 Esc」（不这么做的话按 Esc 会永久挂住）。
+ */
+export declare function tokenizeKeys(input: string, options?: {
+    flushTrailingEscape?: boolean;
+}): {
+    tokens: KeyToken[];
+    rest: string;
+};
+/** 读取一段文本输入（可带默认值 / 校验）。取消（EOF）返回 `null`。 */
+export declare function inputText(options: {
+    message: string;
+    defaultValue?: string;
+    /** 返回非空字符串表示校验失败，内容会作为提示显示给用户。 */
+    validate?: (value: string) => string | null;
+}): Promise<string | null>;
+/** 是 / 否确认。取消（EOF）返回 `null`。 */
+export declare function confirmYesNo(options: {
+    message: string;
+    defaultYes?: boolean;
+}): Promise<boolean | null>;
+/**
+ * 让用户从列表里选一项。
+ *
+ * - TTY：↑/↓ 高亮 + Enter 确认（数字键可直接跳）
+ * - 非 TTY（管道 / CI）：打印编号列表，读一行
+ * - 两者都用同一套 {@link resolveChoiceInput} 判定，行为一致
+ *
+ * @returns 选中的值；用户取消（Esc / Ctrl+C / EOF）返回 `null`。
+ */
+export declare function selectOne<T>(options: {
+    message: string;
+    choices: ReadonlyArray<Choice<T>>;
+    defaultIndex?: number;
+    /** 强制走非 TTY 路径（`--no-input` 与单测用）。 */
+    forcePlain?: boolean;
+}): Promise<T | null>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/utils/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/utils/prompt.ts"],"names":[],"mappings":"AA4BA;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAGvC;AAMD,eAAO,MAAM,IAAI,SAAU,MAAM,KAAG,MAAwB,CAAC;AAC7D,eAAO,MAAM,IAAI,SAAU,MAAM,KAAG,MAAuB,CAAC;AAC5D,eAAO,MAAM,GAAG,SAAU,MAAM,KAAG,MAAuB,CAAC;AAe3D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAMD,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,gBAAgB;IAChB,KAAK,EAAE,CAAC,CAAC;IACT,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EACjC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,MAAM,EAAE,CAkBV;AAED,wCAAwC;AACxC,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EACjC,YAAY,SAAI,GACf,gBAAgB,CAgBlB;AAaD,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAGjF;AAMD,cAAc;AACd,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9C;IAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAsEtC;AA4BD,6CAA6C;AAC7C,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAC7C,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBzB;AAED,gCAAgC;AAChC,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAc1B;AA6ND;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAQpB"}