nstarter-http-request 0.1.0

package/dist/types/security/ssrf.guard.d.ts

@@ -0,0 +1,54 @@
+/**
+ * SSRF 防护
+ * 整合 IP、DNS 和 URL 验证，防止服务器端请求伪造攻击
+ */
+import type { ISsrfGuard, SecurityConfig, SsrfGuardResult } from '../types';
+/**
+ * SSRF 防护类
+ */
+export declare class SsrfGuard implements ISsrfGuard {
+    private dnsValidator;
+    private urlValidator;
+    private config;
+    constructor(config: SecurityConfig);
+    /**
+     * 验证 URL 是否安全
+     * @param url 要验证的 URL
+     * @returns 验证结果
+     */
+    validate(url: string): Promise<SsrfGuardResult>;
+    /**
+     * 验证并返回安全的 URL
+     * @param url 要验证的 URL
+     * @returns 安全的 URL 和验证结果
+     * @throws {SecurityError} 验证失败时抛出错误
+     */
+    validateAndGetSafeUrl(url: string): Promise<{
+        safeUrl: string;
+        result: SsrfGuardResult;
+    }>;
+    /**
+     * 更新配置
+     * @param config 新的安全配置
+     */
+    updateConfig(config: Partial<SecurityConfig>): void;
+    /**
+     * 清空 DNS 缓存
+     */
+    clearDnsCache(): void;
+    /**
+     * 获取 DNS 缓存大小
+     * @returns 缓存条目数量
+     */
+    getDnsCacheSize(): number;
+    /**
+     * 清理过期的 DNS 缓存
+     */
+    cleanExpiredDnsCache(): void;
+    /**
+     * 获取当前配置
+     * @returns 安全配置副本
+     */
+    getConfig(): SecurityConfig;
+}
+//# sourceMappingURL=ssrf.guard.d.ts.map

package/dist/types/security/ssrf.guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssrf.guard.d.ts","sourceRoot":"","sources":["../../../src/security/ssrf.guard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACR,UAAU,EACV,cAAc,EACd,eAAe,EAClB,MAAM,UAAU,CAAC;AAMlB;;GAEG;AACH,qBAAa,SAAU,YAAW,UAAU;IACxC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,cAAc;IAUlC;;;;OAIG;IACU,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA0G5D;;;;;OAKG;IACU,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC;IAiBtG;;;OAGG;IACI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAoB1D;;OAEG;IACI,aAAa,IAAI,IAAI;IAI5B;;;OAGG;IACI,eAAe,IAAI,MAAM;IAIhC;;OAEG;IACI,oBAAoB,IAAI,IAAI;IAInC;;;OAGG;IACI,SAAS,IAAI,cAAc;CAGrC"}

package/dist/types/security/url.validator.d.ts

@@ -0,0 +1,76 @@
+/**
+ * URL 验证器
+ */
+import type { UrlValidationResult } from '../types';
+/**
+ * URL 验证器类
+ */
+export declare class UrlValidator {
+    private whitelist;
+    private blacklist;
+    private whitelistRegexps;
+    private blacklistRegexps;
+    constructor(whitelist?: string[], blacklist?: string[]);
+    /**
+     * 验证 URL
+     * @param url URL 字符串
+     * @returns 验证结果
+     */
+    validate(url: string): UrlValidationResult;
+    /**
+     * 检查域名是否匹配任一模式（使用预生成的正则表达式）
+     * @param hostname 域名
+     * @param regexps 正则表达式列表
+     * @returns 是否匹配
+     */
+    private matchesAny;
+    /**
+     * 更新白名单
+     * @param whitelist 新的白名单
+     */
+    setWhitelist(whitelist: string[]): void;
+    /**
+     * 更新黑名单
+     * @param blacklist 新的黑名单
+     */
+    setBlacklist(blacklist: string[]): void;
+    /**
+     * 添加到白名单
+     * @param patterns 要添加的模式
+     */
+    addToWhitelist(...patterns: string[]): void;
+    /**
+     * 添加到黑名单
+     * @param patterns 要添加的模式
+     */
+    addToBlacklist(...patterns: string[]): void;
+    /**
+     * 从白名单移除
+     * @param patterns 要移除的模式
+     */
+    removeFromWhitelist(...patterns: string[]): void;
+    /**
+     * 从黑名单移除
+     * @param patterns 要移除的模式
+     */
+    removeFromBlacklist(...patterns: string[]): void;
+    /**
+     * 获取白名单
+     * @returns 白名单副本
+     */
+    getWhitelist(): string[];
+    /**
+     * 获取黑名单
+     * @returns 黑名单副本
+     */
+    getBlacklist(): string[];
+    /**
+     * 清空白名单
+     */
+    clearWhitelist(): void;
+    /**
+     * 清空黑名单
+     */
+    clearBlacklist(): void;
+}
+//# sourceMappingURL=url.validator.d.ts.map

package/dist/types/security/url.validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.validator.d.ts","sourceRoot":"","sources":["../../../src/security/url.validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,gBAAgB,CAAW;IACnC,OAAO,CAAC,gBAAgB,CAAW;gBAEvB,SAAS,GAAE,MAAM,EAAO,EAAE,SAAS,GAAE,MAAM,EAAO;IAQ9D;;;;OAIG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB;IAiEjD;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAIlB;;;OAGG;IACI,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAK9C;;;OAGG;IACI,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAK9C;;;OAGG;IACI,cAAc,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKlD;;;OAGG;IACI,cAAc,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKlD;;;OAGG;IACI,mBAAmB,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKvD;;;OAGG;IACI,mBAAmB,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKvD;;;OAGG;IACI,YAAY,IAAI,MAAM,EAAE;IAI/B;;;OAGG;IACI,YAAY,IAAI,MAAM,EAAE;IAI/B;;OAEG;IACI,cAAc,IAAI,IAAI;IAK7B;;OAEG;IACI,cAAc,IAAI,IAAI;CAIhC"}

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

@@ -0,0 +1,30 @@
+/**
+ * 适配器相关类型定义
+ */
+import type { HttpRequestOptions, HttpResponse } from './request_response';
+import type { RequestConfig } from './config';
+import type { EClientAdapter } from '../const';
+/**
+ * HTTP 适配器接口
+ */
+export interface IHttpAdapter {
+    /** 适配器名称 */
+    readonly name: EClientAdapter;
+    /**
+     * 发送 HTTP 请求
+     * @param options 请求选项
+     * @returns 响应结果
+     */
+    request: <T = any>(options: HttpRequestOptions) => Promise<HttpResponse<T>>;
+    /**
+     * 检查适配器是否可用
+     * @returns 是否可用
+     */
+    isAvailable: () => boolean;
+    /**
+     * 更新适配器配置
+     * @param config 请求配置
+     */
+    updateConfig: (config: Partial<RequestConfig>) => void;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/types/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACR,kBAAkB,EAClB,YAAY,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAE9B;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5E;;;OAGG;IACH,WAAW,EAAE,MAAM,OAAO,CAAC;IAE3B;;;OAGG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC;CAC1D"}

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

@@ -0,0 +1,85 @@
+/**
+ * 客户端相关类型定义
+ */
+import type { HttpRequestOptions, HttpResponse } from './request_response';
+import type { EClientAdapter } from '../const';
+/**
+ * 正向代理配置
+ */
+export interface IForwardProxy {
+    enabled: boolean;
+    https_proxy: string;
+    http_proxy: string;
+    no_proxy: string[];
+}
+/**
+ * HTTP 客户端接口
+ */
+export interface IHttpClient {
+    /**
+     * 挂载适配器.
+     * @param adapter
+     * @returns this
+     */
+    withAdapter: (adapter: EClientAdapter) => this;
+    /**
+     * 挂载正向代理.
+     * @param proxy
+     * @returns this
+     */
+    withForwardProxy: (proxy: IForwardProxy) => this;
+    /**
+     * 发送 HTTP 请求
+     * @param options 请求选项
+     * @returns 响应结果
+     */
+    request: <T = any>(options: HttpRequestOptions) => Promise<HttpResponse<T>>;
+    /**
+     * GET 请求
+     * @param url 请求 URL
+     * @param options 其他请求选项
+     * @returns 响应结果
+     */
+    get: <T = any>(url: string, options?: Partial<Omit<HttpRequestOptions, 'method' | 'url'>>) => Promise<HttpResponse<T>>;
+    /**
+     * POST 请求
+     * @param url 请求 URL
+     * @param body 请求体
+     * @param options 其他请求选项
+     * @returns 响应结果
+     */
+    post: <T = any>(url: string, body?: any, options?: Partial<Omit<HttpRequestOptions, 'method' | 'url' | 'body'>>) => Promise<HttpResponse<T>>;
+    /**
+     * PUT 请求
+     * @param url 请求 URL
+     * @param body 请求体
+     * @param options 其他请求选项
+     * @returns 响应结果
+     */
+    put: <T = any>(url: string, body?: any, options?: Partial<Omit<HttpRequestOptions, 'method' | 'url' | 'body'>>) => Promise<HttpResponse<T>>;
+    /**
+     * DELETE 请求
+     * @param url 请求 URL
+     * @param options 其他请求选项
+     * @returns 响应结果
+     */
+    delete: <T = any>(url: string, options?: Partial<Omit<HttpRequestOptions, 'method' | 'url'>>) => Promise<HttpResponse<T>>;
+    /**
+     * PATCH 请求
+     * @param url 请求 URL
+     * @param body 请求体
+     * @param options 其他请求选项
+     * @returns 响应结果
+     */
+    patch: <T = any>(url: string, body?: any, options?: Partial<Omit<HttpRequestOptions, 'method' | 'url' | 'body'>>) => Promise<HttpResponse<T>>;
+    /**
+     * 清空 DNS 缓存
+     */
+    clearDnsCache: () => void;
+    /**
+     * 获取 DNS 缓存大小
+     * @returns 缓存条目数量
+     */
+    getDnsCacheSize: () => number;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/types/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACR,kBAAkB,EAClB,YAAY,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB;;;;OAIG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAE/C;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAEjD;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5E;;;;;OAKG;IACH,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EACT,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC,KAC5D,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9B;;;;;;OAMG;IACH,IAAI,EAAE,CAAC,CAAC,GAAG,GAAG,EACV,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC,KACrE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9B;;;;;;OAMG;IACH,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EACT,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC,KACrE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9B;;;;;OAKG;IACH,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC,KAC5D,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9B;;;;;;OAMG;IACH,KAAK,EAAE,CAAC,CAAC,GAAG,GAAG,EACX,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC,KACrE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAG9B;;OAEG;IACH,aAAa,EAAE,MAAM,IAAI,CAAC;IAE1B;;;OAGG;IACH,eAAe,EAAE,MAAM,MAAM,CAAC;CACjC"}

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

@@ -0,0 +1,99 @@
+/**
+ * 配置相关类型定义
+ */
+import type { ILogger, IHttpClientLogger, LogFilterConfig } from './logger';
+import type { EClientAdapter } from '../const';
+/**
+ * 代理配置
+ */
+export interface ProxyConfig {
+    host: string;
+    port: number;
+    protocol: 'http' | 'https';
+    auth?: {
+        username: string;
+        password: string;
+    };
+}
+/**
+ * 安全配置
+ */
+export interface SecurityConfig {
+    /** 证书校验 **/
+    rejectUnauthorized: boolean;
+    /** 启用 DNS 验证 */
+    enableDnsValidation: boolean;
+    /** 启用 IP 地址验证 */
+    enableIpValidation: boolean;
+    /** 允许访问私有 IP */
+    allowPrivateIp: boolean;
+    /** 域名白名单（支持通配符，如 *.example.com 匹配一级子域名） */
+    whitelist: string[];
+    /** 域名黑名单（支持通配符，如 *.example.com 匹配一级子域名） */
+    blacklist: string[];
+    /** DNS 缓存 TTL（毫秒） */
+    dnsCacheTtl: number;
+    /** DNS 缓存最大条目数 */
+    dnsCacheMaxSize: number;
+}
+/**
+ * 日志配置
+ */
+export interface LoggingConfig {
+    /** 启用日志 */
+    enabled: boolean;
+    /** 自定义日志记录器（通用） */
+    logger?: ILogger;
+    /** 自定义 HTTP 客户端日志记录器 */
+    httpLogger?: IHttpClientLogger;
+    /** 记录请求体 */
+    logRequestBody: boolean;
+    /** 记录响应体 */
+    logResponseBody: boolean;
+    /** 响应体最大记录长度（字节） */
+    bodyMaxLength: number;
+    /** 日志过滤器配置 */
+    filter?: LogFilterConfig;
+}
+/**
+ * 请求配置
+ */
+export interface RequestConfig {
+    /** 超时时间（毫秒） */
+    timeout: number;
+    /** 重试次数 */
+    retries: number;
+    /** 重试延迟（毫秒） */
+    retryDelay: number;
+    /** 代理配置 */
+    proxy?: ProxyConfig;
+    /** 最大重定向次数 */
+    maxRedirects: number;
+    /** 最大请求体大小（字节） */
+    maxRequestBodySize: number;
+    /** 最大响应体大小（字节） */
+    maxResponseBodySize: number;
+}
+/**
+ * HTTP 客户端配置
+ */
+export interface HttpClientConfig {
+    /** 适配器类型 */
+    adapter: EClientAdapter;
+    /** 安全配置 */
+    security: SecurityConfig;
+    /** 日志配置 */
+    logging: LoggingConfig;
+    /** 请求配置 */
+    request: RequestConfig;
+}
+/**
+ * 部分 HTTP 客户端配置（用于创建实例时）
+ */
+export interface PartialHttpClientConfig {
+    adapter?: EClientAdapter;
+    security?: Partial<SecurityConfig>;
+    logging?: Partial<LoggingConfig>;
+    request?: Partial<RequestConfig>;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,23 @@
+/**
+ * 错误类型定义
+ */
+import type { HttpRequestOptions, HttpResponse } from './request_response';
+/**
+ * HTTP 错误
+ */
+export declare class HttpError extends Error {
+    readonly code: string;
+    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);
+}
+/**
+ * 安全验证错误
+ */
+export declare class SecurityError extends Error {
+    readonly code: string;
+    readonly url?: string | undefined;
+    constructor(message: string, code: string, url?: string | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,10 @@
+export * from './request_response';
+export * from './config';
+export * from './errors';
+export * from './security';
+export * from './ip';
+export * from './logger';
+export * from './adapter';
+export * from './client';
+export * from './trace';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AAGnC,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,MAAM,CAAC;AAGrB,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAG1B,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC"}

package/dist/types/types/ip.d.ts

@@ -0,0 +1,32 @@
+/**
+ * IP 相关类型定义
+ */
+/**
+ * 预编译的 IPv4 CIDR 范围
+ */
+export interface CompiledIpv4Range {
+    /** 网络地址（数字形式） */
+    network: number;
+    /** 子网掩码（数字形式） */
+    mask: number;
+    /** 原始 CIDR 字符串 */
+    cidr: string;
+}
+/**
+ * 预编译的 IPv6 CIDR 范围
+ */
+export interface CompiledIpv6Range {
+    /** 网络地址高 64 位 */
+    networkHigh: bigint;
+    /** 网络地址低 64 位 */
+    networkLow: bigint;
+    /** 子网掩码高 64 位 */
+    maskHigh: bigint;
+    /** 子网掩码低 64 位 */
+    maskLow: bigint;
+    /** CIDR 前缀长度 */
+    prefix: number;
+    /** 原始 CIDR 字符串 */
+    cidr: string;
+}
+//# sourceMappingURL=ip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ip.d.ts","sourceRoot":"","sources":["../../../src/types/ip.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/types/logger.d.ts

@@ -0,0 +1,136 @@
+/**
+ * 日志相关类型定义
+ */
+import type { HttpRequestOptions, HttpResponse } from './request_response';
+/**
+ * 日志记录器接口
+ */
+export interface ILogger {
+    debug: (message: string, meta?: Record<string, any>) => void;
+    info: (message: string, meta?: Record<string, any>) => void;
+    warn: (message: string, meta?: Record<string, any>) => void;
+    error: (message: string, meta?: Record<string, any>) => void;
+}
+/**
+ * 请求失败选项
+ */
+export interface IResFailedOptions {
+    /** 是否成功 */
+    isSuccess: false;
+    /** 时间戳 */
+    timestamp: number;
+    /** 请求选项 */
+    request: HttpRequestOptions;
+    /** 错误信息 */
+    error: Error;
+    /** 错误码 */
+    errorCode?: string;
+    /** HTTP 状态码（如果有响应） */
+    status?: number;
+    /** 响应对象（如果有） */
+    response?: HttpResponse;
+    /** 请求耗时（毫秒） */
+    duration?: number;
+    /** 重试次数 */
+    retryCount?: number;
+}
+/**
+ * 流式响应相关指标.
+ */
+export interface IStreamMetrics {
+    /** 首次响应时间（TTFB - Time To First Byte，毫秒） */
+    ttfb: number;
+    /** 流是否已完成 */
+    completed: boolean;
+    /** 流完成总耗时（毫秒，仅在流完成时有值） */
+    totalDuration?: number;
+    /** 流传输的字节数（如果可统计） */
+    bytesTransferred?: number;
+}
+/**
+ * 请求成功选项
+ */
+export interface IResSuccessOptions {
+    /** 是否成功 */
+    isSuccess: true;
+    /** 时间戳 */
+    timestamp: number;
+    /** 请求选项 */
+    request: HttpRequestOptions;
+    /** 响应对象 */
+    response: HttpResponse;
+    /** 请求耗时（毫秒） */
+    duration: number;
+    /** 重试次数 */
+    retryCount?: number;
+    /** 流式响应相关指标（仅当 responseType 为 stream 时） */
+    streamMetrics?: IStreamMetrics;
+}
+/**
+ * 日志过滤器接口
+ */
+export interface ILogFilter {
+    /**
+     * 判断是否应该记录此日志
+     * @param options 日志选项（成功或失败）
+     * @returns 是否应该记录
+     */
+    shouldLog: (options: IResSuccessOptions | IResFailedOptions) => boolean;
+}
+/**
+ * 日志过滤器配置
+ */
+export interface LogFilterConfig {
+    /** 只记录特定 HTTP 方法 */
+    methods?: string[];
+    /** 只记录特定 URL 模式（支持正则表达式） */
+    urlPatterns?: (string | RegExp)[];
+    /** 只记录特定场景 */
+    scenarios?: string[];
+    /** 只记录特定状态码 */
+    statusCodes?: number[];
+    /** 只记录特定状态码范围 */
+    statusCodeRanges?: Array<{
+        min: number;
+        max: number;
+    }>;
+    /** 只记录失败的请求 */
+    onlyFailed?: boolean;
+    /** 只记录成功的请求 */
+    onlySuccess?: boolean;
+    /** 只记录耗时超过指定毫秒数的请求 */
+    minDuration?: number;
+    /** 自定义过滤函数 */
+    customFilter?: (options: IResSuccessOptions | IResFailedOptions) => boolean;
+}
+/**
+ * HTTP 客户端日志记录器
+ */
+export interface IHttpClientLogger {
+    /**
+     * 记录失败的请求
+     * @param resOptions 请求失败选项
+     */
+    logFailed: (resOptions: Omit<IResFailedOptions, 'isSuccess' | 'timestamp'>) => void;
+    /**
+     * 记录成功的请求
+     * @param resOptions 请求成功选项
+     */
+    logSuccess: (resOptions: Omit<IResSuccessOptions, 'isSuccess' | 'timestamp'>) => void;
+}
+/**
+ * HTTP 客户端日志记录器配置
+ */
+export interface HttpClientLoggerConfig {
+    /** 底层日志记录器 */
+    logger: ILogger;
+    /** 日志过滤器（可选） */
+    filter?: ILogFilter;
+    /** 是否记录请求体 */
+    logRequestBody?: boolean;
+    /** 是否记录响应体 */
+    logResponseBody?: boolean;
+    /** 响应体最大记录长度（字节） */
+    bodyMaxLength?: number;
+}
+//# sourceMappingURL=logger.d.ts.map

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

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

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

@@ -0,0 +1,54 @@
+/**
+ * 请求和响应类型定义
+ */
+/**
+ * HTTP 方法
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+/**
+ * 响应类型.
+ */
+export type ResponseType = 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream' | 'formdata';
+/**
+ * HTTP 请求选项
+ */
+export interface HttpRequestOptions {
+    /** HTTP 方法 */
+    method: HttpMethod;
+    /** 请求 URL */
+    url: string;
+    /** 请求头 */
+    headers?: Record<string, string | number>;
+    /** URL 查询参数 */
+    params?: Record<string, string | number | boolean>;
+    /** 请求体 */
+    body?: any;
+    /** 请求超时（毫秒，覆盖全局配置） */
+    timeout?: number;
+    /** 重试次数（覆盖全局配置） */
+    retries?: number;
+    /** 业务场景标识 */
+    scenario?: string;
+    /** 业务元数据 */
+    meta?: Record<string, any>;
+    /** 响应类型 */
+    responseType?: ResponseType;
+    /** W3C Trace Context traceparent 头（用于分布式链路追踪） */
+    traceparent?: string;
+}
+/**
+ * HTTP 响应
+ */
+export interface HttpResponse<T = any> {
+    /** 响应状态码 */
+    status: number;
+    /** 响应状态文本 */
+    statusText: string;
+    /** 响应头 */
+    headers: Record<string, string>;
+    /** 响应体 */
+    data: T;
+    /** 请求配置 */
+    config: HttpRequestOptions;
+}
+//# sourceMappingURL=request_response.d.ts.map

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

@@ -0,0 +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"}