@kenz1117/dsh-ui-usage-billing 0.9.6 → 0.9.8

package/lib/types/resilience.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 上游网络请求的稳定性工具：有限重试（指数退避）与每平台熔断冷却门。
+ *
+ * 计费插件对三类上游做实时请求——pricing（汇率 / OpenRouter / models.dev）、
+ * balance（各厂商余额）、subscriptions（各订阅额度）。单次失败会被调用方降级，
+ * 但反复的瞬时失败（网络波动 / 5xx / 429）会让 30 秒轮询每次打满超时。这里提供
+ * 两个纯工具：`withRetry` 对可重试错误做指数退避，`createCooldownGate` 在单一
+ * 上游连续失败后短路一段时间，避免把请求打到已不可用的服务上。
+ */
+/** 是否是可重试的错误：网络性失败（TypeError / Abort / Timeout）或 5xx / 429。
+ *  401 / 403 鉴权失败与 404 不可重试——重试只放大错误、不会变好。 */
+export declare function isRetryableError(error: unknown): boolean;
+/** 重试配置。 */
+export interface RetryOptions {
+    /** 除首次尝试外的额外重试次数（默认 1）。 */
+    retries?: number;
+    /** 首次退避基数（默认 250ms）。 */
+    baseDelayMs?: number;
+    /** 退避上限（默认 2000ms）。 */
+    maxDelayMs?: number;
+    /** 何时重试；默认 {@link isRetryableError}。 */
+    shouldRetry?: (error: unknown) => boolean;
+}
+/**
+ * 对一次上游请求做有限重试：可重试错误时按指数退避（+同量级抖动）重试。
+ * @param fn - 发起请求的异步函数。
+ * @param options - 重试策略（见 {@link RetryOptions}）。
+ * @returns fn 的结果；重试耗尽后抛出最后一次错误。
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/** 熔断冷却门配置。 */
+export interface CooldownGateOptions {
+    /** 连续失败达到该次数进入冷却（默认 3）。 */
+    failures?: number;
+    /** 冷却时长（默认 30 秒）。 */
+    cooldownMs?: number;
+}
+/** 每平台熔断门：check 是否允许请求；fail / success 上报结果。 */
+export interface CooldownGate {
+    /** 该平台是否允许发起请求。false 表示处于冷却中，调用方应短路为不可用。 */
+    check(key: string): boolean;
+    /** 上报一次失败（可能进入冷却）。 */
+    fail(key: string): void;
+    /** 上报一次成功（重置失败计数与冷却）。 */
+    success(key: string): void;
+}
+/** 每平台冷熔断：连续失败达阈值后短路一段真实时间，成功后复位。 */
+export declare function createCooldownGate(options?: CooldownGateOptions): CooldownGate;
+//# sourceMappingURL=resilience.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kenz1117/dsh-ui-usage-billing",
   "description": "Usage billing dashboard for DeepSeek Harness: sidebar cost metrics plus a full dashboard modal, priced from a current multi-provider catalog with real usage aggregated from session logs.",
-  "version": "0.9.6",
+  "version": "0.9.8",
   "publishConfig": {
     "access": "public"
   },