nstarter-http-request 0.1.11 → 0.1.13

package/dist/types/adapter/undici.adapter.d.ts

@@ -36,7 +36,6 @@ export declare class UndiciAdapter extends BaseHttpAdapter {
     /**
      * 构建 Dispatcher（代理或 TLS 配置）
      * @param options 请求选项
-     * @param timeout 请求总超时时间
      */
     private buildDispatcher;
     /**
@@ -63,6 +62,10 @@ export declare class UndiciAdapter extends BaseHttpAdapter {
      * 获取请求级超时时间。
      */
     private resolveTimeout;
+    /**
+     * 获取传给 undici 的阶段超时时间。0 用于内部禁用 undici 默认阶段超时。
+     */
+    private resolveUndiciTimeout;
     /**
      * 判断超时时间是否启用。
      */
@@ -74,28 +77,37 @@ export declare class UndiciAdapter extends BaseHttpAdapter {
      */
     private handleUndiciError;
     /**
-     * 按 axios 默认行为处理非 2xx 状态码。
+     * 2xx 和 304 作为成功结果返回。undici 未跟跳的 3xx 交回调用方。
      */
     private ensureSuccessStatus;
     /**
-     * 按 axios maxContentLength 行为限制非流式响应体大小。
+     * 解析 Content-Length 响应头。仅接受合法的非负整数，重复头/非法值视为未知。
+     */
+    private parseContentLength;
+    /**
+     * 丢弃未读完的响应体并终止下载。
+     * undici 的 BodyReadable.destroy() 不带错误时会以 RequestAbortedError 触发 error 事件，
+     * 没有监听器会变成未捕获异常，因此先挂空监听器。
      */
-    private ensureResponseBodySize;
+    private discardBody;
     /**
-     * 计算已读取响应体的字节大小。
+     * 带大小上限地读取非流式响应体。
+     *
+     * 1. Content-Length 预检：响应头已声明超限时，不读取响应体，直接销毁并拒绝。
+     * 2. 逐分块累计字节数，累计值超过上限（等于上限放行）立即销毁响应流并拒绝，后续数据不再下载；
+     *    该行为对齐 axios（Node http 适配器）的 maxContentLength。
      */
-    private getBodySize;
+    private readBodyWithLimit;
+    /**
+     * 基于已读取（已受大小限制）的字节构造 Response，复用运行时的 blob/formData 解析逻辑。
+     */
+    private toFetchResponse;
     /**
      * 读取响应体
      * @param response Undici 响应对象
-     * @param responseType 响应类型
+     * @param options 请求选项
      */
     private readResponseBody;
-    /**
-     * 按 axios 的默认兼容行为读取 JSON 响应。
-     * 空响应体或非 JSON 文本不应让成功状态码请求因为解析失败变成异常。
-     */
-    private readJsonResponseBody;
     /**
      * 获取状态文本
      * @param statusCode 状态码

package/dist/types/adapter/undici.adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"undici.adapter.d.ts","sourceRoot":"","sources":["../../../src/adapter/undici.adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACR,kBAAkB,EAClB,YAAY,EAEf,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAOzC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAS1C;;GAEG;AACH,qBAAa,aAAc,SAAQ,eAAe;IAC9C,SAAgB,IAAI,wBAAkC;IAEtD;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;;OAGG;cACa,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IA0DrF;;;OAGG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA2BvB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IA2BjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;;OAIG;YACW,gBAAgB;IAsC9B;;;OAGG;YACW,oBAAoB;IAalC;;;OAGG;IACH,OAAO,CAAC,aAAa;CAGxB"}
+{"version":3,"file":"undici.adapter.d.ts","sourceRoot":"","sources":["../../../src/adapter/undici.adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACR,kBAAkB,EAClB,YAAY,EACf,MAAM,UAAU,CAAC;AAKlB,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAOzC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAU1C;;GAEG;AACH,qBAAa,aAAc,SAAQ,eAAe;IAC9C,SAAgB,IAAI,wBAAkC;IAEtD;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;;OAGG;cACa,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IA4DrF;;;OAGG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;OAGG;IACH,OAAO,CAAC,eAAe;IA4BvB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IA4BjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAKnB;;;;;;OAMG;YACW,iBAAiB;IAgC/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;;;OAIG;YACW,gBAAgB;IA0C9B;;;OAGG;IACH,OAAO,CAAC,aAAa;CAGxB"}

package/dist/types/client.d.ts

@@ -47,6 +47,13 @@ export declare class NsHttpClient implements IHttpClient {
      * @returns 响应结果
      */
     request<T = any>(options: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     *
+     * @param options 请求选项
+     * @param remainedRedirects 剩余可重定向次数
+     * @returns 响应结果
+     */
+    private safeRequest;
     /**
      * 便捷方法：GET 请求
      */
@@ -71,6 +78,10 @@ export declare class NsHttpClient implements IHttpClient {
      * 记录响应日志
      */
     private logResponse;
+    /**
+     * 销毁不再交给调用方的响应流
+     */
+    private discardResponseStream;
     /**
      * 判断响应数据是否为流对象（Node.js Readable）
      */

package/dist/types/client.d.ts.map

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

package/dist/types/const/config.const.d.ts

@@ -16,6 +16,12 @@ export declare const DEFAULT_LOGGING_CONFIG: LoggingConfig;
  * 默认请求配置
  */
 export declare const DEFAULT_REQUEST_CONFIG: RequestConfig;
+/**
+ * 响应体大小预检的线上长度容差比例。
+ * axios 的 onDownloadProgress.total 是压缩后的 Content-Length，而 maxContentLength 按解压后计数；
+ * 不可压缩数据经 gzip 等压缩后可能略大于解压大小，预检仅在超过上限该比例时提前中止。
+ */
+export declare const MAX_RESPONSE_SIZE_TOLERANCE_RATIO = 0.01;
 /**
  * 默认 HTTP 客户端配置
  */

package/dist/types/const/config.const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.const.d.ts","sourceRoot":"","sources":["../../../src/const/config.const.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACjB,MAAM,UAAU,CAAC;AAIlB;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAgB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cASrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAKpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAOpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,gBAKxC,CAAC"}
+{"version":3,"file":"config.const.d.ts","sourceRoot":"","sources":["../../../src/const/config.const.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACjB,MAAM,UAAU,CAAC;AAIlB;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAgB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cASrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAKpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAMpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,OAAO,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,gBAKxC,CAAC"}

package/dist/types/types/config.d.ts

@@ -59,8 +59,8 @@ export interface LoggingConfig {
  * 请求配置
  */
 export interface RequestConfig {
-    /** 超时时间（毫秒） */
-    timeout: number;
+    /** 超时时间（毫秒）；不配置表示不限制请求超时 */
+    timeout?: number;
     /** 重试次数 */
     retries: number;
     /** 重试延迟（毫秒） */

package/dist/types/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACR,OAAO,EACP,iBAAiB,EACjB,eAAe,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE;QACH,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAA;KACnB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,YAAY;IACZ,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB;IAChB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,WAAW;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wBAAwB;IACxB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,YAAY;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY;IACZ,eAAe,EAAE,OAAO,CAAC;IACzB,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc;IACd,MAAM,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,cAAc;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB;IAClB,mBAAmB,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,YAAY;IACZ,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW;IACX,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW;IACX,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW;IACX,OAAO,EAAE,aAAa,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACpC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACR,OAAO,EACP,iBAAiB,EACjB,eAAe,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE;QACH,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAA;KACnB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,YAAY;IACZ,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB;IAChB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,WAAW;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wBAAwB;IACxB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,YAAY;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY;IACZ,eAAe,EAAE,OAAO,CAAC;IACzB,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc;IACd,MAAM,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,cAAc;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB;IAClB,mBAAmB,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,YAAY;IACZ,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW;IACX,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW;IACX,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW;IACX,OAAO,EAAE,aAAa,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACpC"}

package/dist/types/types/errors.d.ts

@@ -10,7 +10,32 @@ export declare class HttpError extends Error {
     readonly status?: number | undefined;
     readonly response?: HttpResponse | undefined;
     readonly request?: HttpRequestOptions | undefined;
-    constructor(message: string, code: string, status?: number | undefined, response?: HttpResponse | undefined, request?: HttpRequestOptions | undefined);
+    readonly retriable: boolean;
+    /**
+     * @param message 错误信息
+     * @param code 错误码
+     * @param status HTTP 状态码
+     * @param response 响应（不应携带不再需要的大体积响应体）
+     * @param request 请求选项
+     * @param retriable 是否允许重试，默认 true；重试无法改变结果的确定性失败应传 false
+     */
+    constructor(message: string, code: string, status?: number | undefined, response?: HttpResponse | undefined, request?: HttpRequestOptions | undefined, retriable?: boolean);
+}
+/**
+ * 响应体超过 maxResponseBodySize 限制的错误。
+ *
+ * - 错误码与文案对齐 axios 的 maxContentLength（ERR_BAD_RESPONSE）。
+ * - 重试不会改变响应体大小，因此标记为不可重试，避免每次重试都重复下载。
+ * - 不携带 response：仅保留状态码，防止超限数据随错误对象存活（与 axios 抛出该错误时一致）。
+ */
+export declare class ResponseTooLargeError extends HttpError {
+    readonly maxResponseBodySize: number;
+    /**
+     * @param maxResponseBodySize 响应体大小上限
+     * @param request 请求选项
+     * @param status 响应状态码（未知时不传）
+     */
+    constructor(maxResponseBodySize: number, request: HttpRequestOptions, status?: number);
 }
 /**
  * 安全验证错误

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE3E;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;aAGZ,IAAI,EAAE,MAAM;aACZ,MAAM,CAAC,EAAE,MAAM;aACf,QAAQ,CAAC,EAAE,YAAY;aACvB,OAAO,CAAC,EAAE,kBAAkB;gBAJ5C,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,QAAQ,CAAC,EAAE,YAAY,YAAA,EACvB,OAAO,CAAC,EAAE,kBAAkB,YAAA;CAMnD;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGhB,IAAI,EAAE,MAAM;aACZ,GAAG,CAAC,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,YAAA;CAMnC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE3E;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;aAWZ,IAAI,EAAE,MAAM;aACZ,MAAM,CAAC,EAAE,MAAM;aACf,QAAQ,CAAC,EAAE,YAAY;aACvB,OAAO,CAAC,EAAE,kBAAkB;aAC5B,SAAS;IAd7B;;;;;;;OAOG;gBAEC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,QAAQ,CAAC,EAAE,YAAY,YAAA,EACvB,OAAO,CAAC,EAAE,kBAAkB,YAAA,EAC5B,SAAS,UAAO;CAMvC;AAED;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;aAO5B,mBAAmB,EAAE,MAAM;IAN/C;;;;OAIG;gBAEiB,mBAAmB,EAAE,MAAM,EAC3C,OAAO,EAAE,kBAAkB,EAC3B,MAAM,CAAC,EAAE,MAAM;CAWtB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGhB,IAAI,EAAE,MAAM;aACZ,GAAG,CAAC,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,YAAA;CAMnC"}

package/dist/types/types/request_response.d.ts

@@ -23,7 +23,7 @@ export interface HttpRequestOptions {
     params?: Record<string, string | number | boolean>;
     /** 请求体 */
     body?: any;
-    /** 请求超时（毫秒，覆盖全局配置） */
+    /** 请求超时（毫秒，覆盖全局配置）；不配置表示不限制请求超时 */
     timeout?: number;
     /** 重试次数（覆盖全局配置） */
     retries?: number;

package/dist/types/types/request_response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request_response.d.ts","sourceRoot":"","sources":["../../../src/types/request_response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,YAAY,GAClB,aAAa,GACb,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,QAAQ,GACR,UAAU,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,cAAc;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU;IACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC1C,eAAe;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACnD,UAAU;IACV,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,WAAW;IACX,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,GAAG;IACjC,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU;IACV,IAAI,EAAE,CAAC,CAAC;IACR,WAAW;IACX,MAAM,EAAE,kBAAkB,CAAC;CAC9B"}
+{"version":3,"file":"request_response.d.ts","sourceRoot":"","sources":["../../../src/types/request_response.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,YAAY,GAClB,aAAa,GACb,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,QAAQ,GACR,UAAU,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,cAAc;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU;IACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC1C,eAAe;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACnD,UAAU;IACV,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,WAAW;IACX,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,GAAG;IACjC,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU;IACV,IAAI,EAAE,CAAC,CAAC;IACR,WAAW;IACX,MAAM,EAAE,kBAAkB,CAAC;CAC9B"}

package/dist/types/utils/index.d.ts

@@ -1,6 +1,7 @@
 export * as IpRangeUtils from './ip.range';
 export * as CommonUtils from './common';
 export * as DomainUtils from './domain';
+export * as RedirectUtils from './redirect';
 export * as TraceContextUtils from './trace.context';
 export { TraceContext } from './trace.context';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,WAAW,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,WAAW,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,iBAAiB,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,WAAW,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,WAAW,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,aAAa,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,iBAAiB,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/utils/redirect.d.ts

@@ -0,0 +1,26 @@
+import type { HttpRequestOptions, HttpResponse } from '../types';
+import { EClientAdapter } from '../const';
+/**
+ * 判断状态码是否需要跟跳。
+ * @param status HTTP 状态码
+ */
+export declare function isRedirectStatus(status: number): boolean;
+/**
+ * 根据响应里的 Location 构造下一跳请求。
+ * 没有 Location 时返回 undefined，调用方把当前 3xx 原样返回。
+ * axios：POST 的 301/302，以及非 GET/HEAD 的 303，改成 GET 并去掉 body 和 content-*。
+ * undici：只有非 HEAD 的 303 改成 GET 并去掉 body；303 仍去掉 content-*。
+ * 两边都去掉 host；跨域去掉 authorization、cookie、proxy-authorization。
+ * @param options 当前这一跳的请求
+ * @param response 当前这一跳的响应
+ * @param adapter 当前适配器
+ * @param configuredTimeout 客户端配置中的超时。请求未单独设置时使用。
+ */
+export declare function buildRedirectOptions(options: HttpRequestOptions, response: HttpResponse, adapter: EClientAdapter, configuredTimeout?: number): HttpRequestOptions | undefined;
+/**
+ * 跟跳共用同一次超时。把本跳已经花掉的时间从 redirectOptions.timeout 扣掉。
+ * @param redirectOptions 下一跳请求
+ * @param startTime 本跳开始时间
+ */
+export declare function consumeRedirectTimeout(redirectOptions: HttpRequestOptions, startTime: number): void;
+//# sourceMappingURL=redirect.d.ts.map

package/dist/types/utils/redirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect.d.ts","sourceRoot":"","sources":["../../../src/utils/redirect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,kBAAkB,EAClB,YAAY,EACf,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAe1C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,cAAc,EACvB,iBAAiB,CAAC,EAAE,MAAM,GAC3B,kBAAkB,GAAG,SAAS,CA6ChC;AAgDD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAClC,eAAe,EAAE,kBAAkB,EACnC,SAAS,EAAE,MAAM,GAClB,IAAI,CAgBN"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nstarter-http-request",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "nstarter HTTP 请求客户端插件",
   "license": "MIT",
   "repository": {

package/src/adapter/axios.adapter.ts

@@ -7,16 +7,24 @@ import type {
     HttpResponse,
     ProxyConfig
 } from '../types';
-import { HttpError } from '../types';
+import {
+    HttpError,
+    ResponseTooLargeError
+} from '../types';
 import { BaseHttpAdapter } from './base';
 import type {
+    AxiosProgressEvent,
     AxiosProxyConfig,
     AxiosRequestConfig
 } from 'axios';
 import axios from 'axios';
 import { HttpsProxyAgent } from 'https-proxy-agent';
 import * as https from 'https';
-import { EClientAdapter } from '../const';
+import {
+    MAX_RESPONSE_SIZE_TOLERANCE_RATIO,
+    EClientAdapter
+} from '../const';
+import { RedirectUtils } from '../utils';
 
 
 /**
@@ -42,7 +50,9 @@ export class AxiosAdapter extends BaseHttpAdapter {
         }
 
         const url = this.buildUrl(options.url, options.params);
+        const timeout = options.timeout ?? this.requestConfig.timeout;
         const axiosConfig = this.buildAxiosConfig(options, url);
+        const signalState = this.buildAxiosSignals(axiosConfig, options, timeout);
 
         try {
             const startTime = Date.now();
@@ -67,8 +77,80 @@ export class AxiosAdapter extends BaseHttpAdapter {
 
             return response;
         } catch (error: any) {
-            throw this.handleAxiosError(error, options);
+            throw signalState.abortError() ?? this.handleAxiosError(error, options);
+        } finally {
+            signalState.cleanup();
+        }
+    }
+
+    /**
+     * 创建整次请求超时与响应体超限两个中止信号，合并后写入 axiosConfig（原地修改）。
+     * 返回 catch 中还原中止原因的 abortError（非本方法中止时返回 undefined），以及 finally 中清理定时器的 cleanup。
+     */
+    private buildAxiosSignals(axiosConfig: AxiosRequestConfig, options: HttpRequestOptions, timeout?: number): {
+        abortError: () => HttpError | undefined,
+        cleanup: () => void
+    } {
+        // maxRedirects 为 0 时 axios 使用原生 http 而不是 follow-redirects。
+        // 原生 timeout 是套接字空闲超时，在比如持续上传的场景下会被不断重置，需要使用中止信号来结束请求。
+        const deadline = this.createDeadline(timeout);
+        const bodySizeGuard = this.createBodySizeGuard(options);
+        const signals = [deadline.signal, bodySizeGuard.signal].filter((item): item is AbortSignal => !!item);
+        axiosConfig.signal = signals.length > 1 ? AbortSignal.any(signals) : signals[0];
+        axiosConfig.onDownloadProgress = bodySizeGuard.onDownloadProgress;
+
+        return {
+            abortError: () => {
+                if (deadline.timedOut()) {
+                    return new HttpError(
+                        `timeout of ${ timeout }ms exceeded`,
+                        'ECONNABORTED',
+                        undefined,
+                        undefined,
+                        options
+                    );
+                }
+                if (bodySizeGuard.exceeded()) {
+                    return new ResponseTooLargeError(this.requestConfig.maxResponseBodySize, options);
+                }
+                return undefined;
+            },
+            cleanup: deadline.cleanup
+        };
+    }
+
+    /**
+     * 创建 Content-Length 预检。
+     *
+     * axios 的 Node http 适配器只按已收到的分块累计 maxContentLength，响应头已声明超限时仍会下载到上限才中断。
+     * 这里借助 onDownloadProgress 的 total（响应头 Content-Length），在首个分块到达时就中止请求。
+     * - 无 Content-Length（chunked）时不触发，由 axios 的分块累计兜底；
+     * - stream 响应不启用，避免额外插入转换流；
+     * - total 是线上字节，对几乎不可压缩的 gzip 响应可能略大于解压后的大小，
+     *   因此比较时保留 MAX_RESPONSE_SIZE_TOLERANCE_RATIO 的容差。
+     */
+    private createBodySizeGuard(options: HttpRequestOptions): {
+        signal?: AbortSignal,
+        onDownloadProgress?: (event: AxiosProgressEvent) => void,
+        exceeded: () => boolean
+    } {
+        const maxRespBodySize = this.resolveMaxResponseBodySize();
+        if (options.responseType === 'stream' || maxRespBodySize === undefined) {
+            return { exceeded: () => false };
         }
+
+        const controller = new AbortController();
+        let exceeded = false;
+        return {
+            signal: controller.signal,
+            onDownloadProgress: (event) => {
+                if (typeof event.total === 'number' && event.total > maxRespBodySize + Math.ceil(maxRespBodySize * MAX_RESPONSE_SIZE_TOLERANCE_RATIO)) {
+                    exceeded = true;
+                    controller.abort();
+                }
+            },
+            exceeded: () => exceeded
+        };
     }
 
     /**
@@ -81,14 +163,20 @@ export class AxiosAdapter extends BaseHttpAdapter {
             method: options.method.toLowerCase(),
             url,
             headers: options.headers || {},
-            timeout: options.timeout ?? this.requestConfig.timeout,
             maxRedirects: this.requestConfig.maxRedirects,
+            validateStatus: (status: number) => {
+                return (status >= 200 && status < 300) || status === 304 || RedirectUtils.isRedirectStatus(status);
+            },
             maxContentLength: this.requestConfig.maxResponseBodySize,
             maxBodyLength: this.requestConfig.maxRequestBodySize,
             httpsAgent: new https.Agent({
                 rejectUnauthorized: this.securityConfig.rejectUnauthorized
             })
         };
+        const timeout = options.timeout ?? this.requestConfig.timeout;
+        if (timeout !== undefined) {
+            axiosConfig.timeout = timeout;
+        }
 
         // 设置请求体
         if (options.body !== undefined) {
@@ -178,6 +266,12 @@ export class AxiosAdapter extends BaseHttpAdapter {
      * @param options 请求选项
      */
     private handleAxiosError(error: any, options: HttpRequestOptions): HttpError {
+        // axios 没有为 maxContentLength 超限提供专用错误码（与 5xx 共用 ERR_BAD_RESPONSE），
+        // 只能靠固定的消息前缀识别，识别后转成不可重试的 ResponseTooLargeError。
+        if (error.isAxiosError && error.code === 'ERR_BAD_RESPONSE' && error.message.startsWith('maxContentLength size of')) {
+            return new ResponseTooLargeError(this.requestConfig.maxResponseBodySize, options);
+        }
+
         if (error.isAxiosError) {
             return new HttpError(
                 error.message,
@@ -223,4 +317,34 @@ export class AxiosAdapter extends BaseHttpAdapter {
 
         return config;
     }
+
+    /**
+     * 按墙钟时间中止请求，到点后 timedOut 为 true
+     * @param timeout 超时时间，单位毫秒
+     * @returns 中止信号、是否超时、清理函数
+     */
+    private createDeadline(timeout?: number): {
+        signal?: AbortSignal,
+        timedOut: () => boolean,
+        cleanup: () => void
+    } {
+        if (typeof timeout !== 'number' || !Number.isFinite(timeout) || timeout <= 0) {
+            return {
+                timedOut: () => false,
+                cleanup: () => undefined
+            };
+        }
+        const controller = new AbortController();
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+        }, timeout);
+        timer.unref?.();
+        return {
+            signal: controller.signal,
+            timedOut: () => timedOut,
+            cleanup: () => clearTimeout(timer)
+        };
+    }
 }

package/src/adapter/base.ts

@@ -10,11 +10,14 @@ import type {
     SecurityConfig,
     ILogger
 } from '../types';
+import { HttpError } from '../types';
 import { CommonUtils } from '../utils';
 import type { EClientAdapter } from '../const';
 
 /**
  * HTTP 适配器抽象基类
+ * 
+ * g-7114106599：不允许直接跟跳3XX，防止SSRF。调用方需要自行处理 3XX 响应。
  */
 export abstract class BaseHttpAdapter implements IHttpAdapter {
     protected requestConfig: RequestConfig;
@@ -22,7 +25,7 @@ export abstract class BaseHttpAdapter implements IHttpAdapter {
     protected logger?: ILogger;
 
     constructor(requestConfig: RequestConfig, securityConfig: SecurityConfig, logger?: ILogger) {
-        this.requestConfig = requestConfig;
+        this.requestConfig = { ...requestConfig, maxRedirects: 0 };
         this.securityConfig = securityConfig;
         this.logger = logger;
     }
@@ -85,6 +88,16 @@ export abstract class BaseHttpAdapter implements IHttpAdapter {
                     error: error instanceof Error ? error.message : String(error)
                 });
 
+                // 默认所有错误均可重试；仅在 HttpError 的 retriable 为 false 时终止重试
+                if (error instanceof HttpError && !error.retriable) {
+                    this.logger?.debug('HTTP request error is not retriable, skip remaining retries', {
+                        method: options.method,
+                        url: options.url,
+                        attempt: attempt + 1
+                    });
+                    break;
+                }
+
                 // 最后一次尝试，不再重试
                 if (attempt === retries) {
                     break;
@@ -106,6 +119,14 @@ export abstract class BaseHttpAdapter implements IHttpAdapter {
         throw lastError;
     }
 
+    /**
+     * @returns 有效的响应体大小上限；不限制时返回 undefined
+     */
+    protected resolveMaxResponseBodySize(): number | undefined {
+        const max = this.requestConfig.maxResponseBodySize;
+        return typeof max === 'number' && max > 0 ? max : undefined;
+    }
+
     /**
      * 更新请求配置
      * @param config 新的请求配置