@acosmi/sdk-ts 2.11.0 → 2.13.0

package/dist/node/index.cjs

@@ -107,6 +107,19 @@ function isWindowLimitStreamError(err) {
   }
   return false;
 }
+function isContinuableWindowLimitError(err) {
+  return isWindowLimitError(err) && err.windowOverridable === true;
+}
+function getWindowLimitStreamDetails(err) {
+  if (!isWindowLimitStreamError(err)) return null;
+  const e = err ?? {};
+  const kind = e.windowKind === "FIVE_HOUR" || e.windowKind === "WEEKLY" ? e.windowKind : void 0;
+  return {
+    windowKind: kind,
+    windowResetAt: typeof e.windowResetAt === "string" ? e.windowResetAt : void 0,
+    windowOverridable: typeof e.windowOverridable === "boolean" ? e.windowOverridable : void 0
+  };
+}
 exports.RateLimitError = void 0; exports.BusinessError = void 0; exports.OrderTerminalError = void 0; exports.ModelNotFoundError = void 0; exports.HTTPError = void 0; exports.NetworkError = void 0; exports.StreamError = void 0; var windowLimitErrorCode, windowLimitStreamCode;
 var init_errors = __esm({
   "src/shared/errors.ts"() {
@@ -160,6 +173,12 @@ var init_errors = __esm({
       windowKind;
       /** 窗口限额场景: 预计恢复时间 (ISO-8601 UTC); 缺失为 undefined */
       windowResetAt;
+      /**
+       * [W1 2026-07-11 软限额] 窗口限额场景: 该 429 可否被用户「继续」开关豁免 —
+       * true = 5 小时软限额严格模式 (客户端可提示「继续任务」以消耗周配额继续);
+       * false/缺失 = 周窗/显式禁止/灰度关 (硬等待, 无豁免路径, 老网关不返回时为 undefined)。
+       */
+      windowOverridable;
       constructor(statusCode, opts = {}) {
         let msg;
         if (opts.type) {
@@ -180,6 +199,7 @@ var init_errors = __esm({
         this.errorCode = opts.errorCode;
         this.windowKind = opts.windowKind;
         this.windowResetAt = opts.windowResetAt;
+        this.windowOverridable = opts.windowOverridable;
       }
     };
     exports.NetworkError = class extends Error {
@@ -1960,6 +1980,7 @@ function parseHTTPErrorWithHeader(statusCode, body, header) {
   let errorCode;
   let windowKind;
   let windowResetAt;
+  let windowOverridable;
   try {
     const obj = JSON.parse(bodyStr);
     if (obj && typeof obj === "object") {
@@ -1975,10 +1996,20 @@ function parseHTTPErrorWithHeader(statusCode, body, header) {
       if (typeof top.errorCode === "string") errorCode = top.errorCode;
       if (top.windowKind === "FIVE_HOUR" || top.windowKind === "WEEKLY") windowKind = top.windowKind;
       if (typeof top.windowResetAt === "string") windowResetAt = top.windowResetAt;
+      if (typeof top.windowOverridable === "boolean") windowOverridable = top.windowOverridable;
     }
   } catch {
   }
-  return new exports.HTTPError(statusCode, { type, message, retryAfter, body: bodyStr, errorCode, windowKind, windowResetAt });
+  return new exports.HTTPError(statusCode, {
+    type,
+    message,
+    retryAfter,
+    body: bodyStr,
+    errorCode,
+    windowKind,
+    windowResetAt,
+    windowOverridable
+  });
 }
 function classifyTransport(op, urlStr, err) {
   const ne = new exports.NetworkError(op, urlStr, err);
@@ -2767,6 +2798,64 @@ var Client = class _Client {
     );
     return resp.data;
   }
+  /**
+   * [W1 2026-07-11 软限额] 设置当前用户 5 小时窗口软限额「继续」开关 (v2.12+)。
+   *
+   * enabled=true = 软限额 (到达 5h 后继续消耗周配额, 默认); false = 严格模式 (到达即等待逐步恢复)。
+   * userId 由网关从鉴权态解析 (客户端永不传), 故只需 enabled + 可选 source (审计: web /
+   * crabcode-gui / crabcode-tui / dialog)。用于个人中心开关、429 严格模式「重新开启继续」续跑。
+   *
+   * @returns 网关回显的新状态 { enabled }。
+   */
+  async setWindowContinuePreference(enabled, opts) {
+    const resp = await this.doJSON(
+      "POST",
+      "/entitlements/window-continue-pref",
+      { enabled, source: opts?.source },
+      opts?.signal
+    );
+    return { enabled: resp.data.enabled };
+  }
+  /**
+   * [W-MEMBERSHIP 2026-08-01 邀请奖励] 查询当前用户窗口重置券总览 (v2.13+)。
+   *
+   * 重置券由邀请奖励发放 (被邀请人激活并达到用量门槛后计一次), 每张可清空一次滚动窗口已用量
+   * (见 redeemWindowReset)。userId 由网关从鉴权态解析, 客户端永不传。
+   * 用于个人中心邀请栏与 429 窗口限额弹窗展示"还剩几张券 + 最近到期时间 + 邀请进度"。
+   *
+   * @returns 券余量 / 最近到期 / 累计发放与使用 / 邀请已达标与待达标数。
+   */
+  async getWindowResetSummary(signal) {
+    const resp = await this.doJSON(
+      "GET",
+      "/entitlements/window-reset/summary",
+      null,
+      signal
+    );
+    return resp.data;
+  }
+  /**
+   * [W-MEMBERSHIP 2026-08-01 邀请奖励] 消费一张窗口重置券, 清空当前滚动窗口已用量 (v2.13+)。
+   *
+   * **幂等键语义**: 传 `clientRequestId` 时同一 ID 重放**不会二次扣券** — 网关按该键返回首次
+   * 结果 (`remaining` 与首次一致)。网络重试 / 用户连点必须**复用同一 ID**; 换 ID = 换一次真实
+   * 扣券。不传则不幂等, 每次调用都是一次真实扣券。
+   *
+   * 业务错 (信封 `code != 0`) 按 SDK 惯例抛 `BusinessError` (message 含机器码), 常见两种:
+   *   - `NO_AVAILABLE_CREDIT` — 无可用券 (未发放 / 已用尽 / 已过期)
+   *   - `NO_WINDOW_USAGE` — 当前窗口无已用量, 无可重置 (不扣券)
+   *
+   * @returns 扣减后剩余可用券张数 { remaining }。
+   */
+  async redeemWindowReset(opts) {
+    const resp = await this.doJSON(
+      "POST",
+      "/entitlements/window-reset/redeem",
+      { clientRequestId: opts?.clientRequestId },
+      opts?.signal
+    );
+    return { remaining: resp.data.remaining };
+  }
   /**
    * 查询单个模型的能力矩阵
    * 优先从 listModels 缓存读取, miss 时调用 listModels 刷新
@@ -7724,10 +7813,12 @@ exports.findFirstModelByInputModality = findFirstModelByInputModality;
 exports.generateState = generateState;
 exports.getAdapter = getAdapter;
 exports.getAdapterForModel = getAdapterForModel;
+exports.getWindowLimitStreamDetails = getWindowLimitStreamDetails;
 exports.isBillingConfirmable = isBillingConfirmable;
 exports.isChannelInboundEvent = isChannelInboundEvent;
 exports.isComplianceBusinessError = isComplianceBusinessError;
 exports.isComplianceTerminalError = isComplianceTerminalError;
+exports.isContinuableWindowLimitError = isContinuableWindowLimitError;
 exports.isIntegrationStatus = isIntegrationStatus;
 exports.isInvalidGrantError = isInvalidGrantError;
 exports.isPlatform = isPlatform;