nstarter-http-request 0.1.0

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

@@ -0,0 +1,68 @@
+/**
+ * Undici 适配器实现
+ */
+import type { HttpRequestOptions, HttpResponse } from '../types';
+import { BaseHttpAdapter } from './base';
+import { EClientAdapter } from '../const';
+/**
+ * Undici 适配器
+ */
+export declare class UndiciAdapter extends BaseHttpAdapter {
+    readonly name: EClientAdapter.undici;
+    /**
+     * 检查 Undici 是否可用
+     */
+    isAvailable(): boolean;
+    /**
+     * 发送请求
+     * @param options 请求选项
+     */
+    protected sendRequest<T>(options: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * 准备请求头
+     * @param headers 原始请求头
+     */
+    private prepareHeaders;
+    /**
+     * 准备请求体
+     * @param body 原始请求体
+     * @param headers 请求头
+     */
+    private prepareBody;
+    /**
+     * 构建 Dispatcher（代理或 TLS 配置）
+     * @param options 请求选项
+     */
+    private buildDispatcher;
+    /**
+     * 创建全局代理 Agent
+     */
+    private createGlobalProxyAgent;
+    /**
+     * 创建正向代理 Agent
+     * @param proxyUrl 代理 URL
+     */
+    private createForwardProxyAgent;
+    /**
+     * 构建 Undici 请求选项
+     */
+    private buildUndiciOptions;
+    /**
+     * 处理 Undici 错误
+     * @param error 错误对象
+     * @param options 请求选项
+     */
+    private handleUndiciError;
+    /**
+     * 读取响应体
+     * @param response Undici 响应对象
+     * @param responseType 响应类型
+     */
+    private readResponseBody;
+    /**
+     * 获取状态文本
+     * @param statusCode 状态码
+     */
+    private getStatusText;
+}
+//# sourceMappingURL=undici.adapter.d.ts.map

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

@@ -0,0 +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;AAE1C;;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;IAuCrF;;;OAGG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAgBnB;;;OAGG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;;OAIG;YACW,gBAAgB;IAsC9B;;;OAGG;IACH,OAAO,CAAC,aAAa;CAGxB"}

package/dist/types/client.d.ts

@@ -0,0 +1,105 @@
+/**
+ * HTTP 客户端核心类
+ */
+import type { PartialHttpClientConfig, HttpRequestOptions, HttpResponse, IHttpClient, IForwardProxy } from './types';
+import { EClientAdapter } from './const';
+/**
+ * HTTP 客户端
+ */
+export declare class NsHttpClient implements IHttpClient {
+    private config;
+    private adapter;
+    private ssrfGuard;
+    private logger;
+    private httpLogger?;
+    private forwardProxy?;
+    constructor(userConfig?: PartialHttpClientConfig);
+    /**
+     * 从配置创建 HTTP 客户端
+     * @param config
+     */
+    static fromHttpClientConfig(config?: PartialHttpClientConfig): NsHttpClient;
+    /**
+     * 挂载适配器.
+     * @param adapter
+     */
+    withAdapter(adapter: EClientAdapter): this;
+    /**
+     * 挂载正向代理.
+     * @param proxy
+     */
+    withForwardProxy(proxy: IForwardProxy): this;
+    /**
+     * 初始化日志记录器
+     */
+    private initLogger;
+    /**
+     * 初始化 HTTP 客户端日志记录器
+     */
+    private initHttpLogger;
+    /**
+     * 初始化适配器
+     */
+    private initAdapter;
+    /**
+     * 发送 HTTP 请求
+     * @param options 请求选项
+     * @returns 响应结果
+     */
+    request<T = any>(options: HttpRequestOptions): Promise<HttpResponse<T>>;
+    /**
+     * 便捷方法：GET 请求
+     */
+    get<T = any>(url: string, options?: Partial<Omit<HttpRequestOptions, 'method' | 'url'>>): Promise<HttpResponse<T>>;
+    /**
+     * 便捷方法：POST 请求
+     */
+    post<T = any>(url: string, body?: any, options?: Partial<Omit<HttpRequestOptions, 'method' | 'url' | 'body'>>): Promise<HttpResponse<T>>;
+    /**
+     * 便捷方法：PUT 请求
+     */
+    put<T = any>(url: string, body?: any, options?: Partial<Omit<HttpRequestOptions, 'method' | 'url' | 'body'>>): Promise<HttpResponse<T>>;
+    /**
+     * 便捷方法：DELETE 请求
+     */
+    delete<T = any>(url: string, options?: Partial<Omit<HttpRequestOptions, 'method' | 'url'>>): Promise<HttpResponse<T>>;
+    /**
+     * 便捷方法：PATCH 请求
+     */
+    patch<T = any>(url: string, body?: any, options?: Partial<Omit<HttpRequestOptions, 'method' | 'url' | 'body'>>): Promise<HttpResponse<T>>;
+    /**
+     * 记录响应日志
+     */
+    private logResponse;
+    /**
+     * 判断响应数据是否为流对象（Node.js Readable）
+     */
+    private isStreamResponse;
+    /**
+     * 包装流式响应，追踪流的完整生命周期
+     */
+    private wrapStreamResponse;
+    /**
+     * 记录流完成日志
+     */
+    private logStreamCompleted;
+    /**
+     * 记录错误日志
+     */
+    private logError;
+    /**
+     * 应用正向代理配置
+     * @param options 请求选项
+     */
+    private applyForwardProxy;
+    /**
+     * 清空 DNS 缓存
+     */
+    clearDnsCache(): void;
+    /**
+     * 获取 DNS 缓存大小
+     * @returns 缓存条目数量
+     */
+    getDnsCacheSize(): number;
+}
+//# sourceMappingURL=client.d.ts.map

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

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

package/dist/types/config.d.ts

@@ -0,0 +1,14 @@
+import type { HttpClientConfig, PartialHttpClientConfig } from './types';
+/**
+ * 合并配置
+ * @param userConfig 用户配置
+ * @returns 完整配置
+ */
+export declare function mergeConfig(userConfig?: PartialHttpClientConfig): HttpClientConfig;
+/**
+ * 验证配置
+ * @param config 配置
+ * @throws {Error} 配置无效时抛出错误
+ */
+export declare function validateConfig(config: HttpClientConfig): void;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,gBAAgB,EAChB,uBAAuB,EAC1B,MAAM,SAAS,CAAC;AASjB;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,GAAE,uBAA4B,GAAG,gBAAgB,CAgBtF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA4C7D"}

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

@@ -0,0 +1,23 @@
+import type { HttpClientConfig, LoggingConfig, RequestConfig, SecurityConfig } from '../types';
+/**
+ * DNS 缓存最大 TTL（毫秒）- 5 分钟
+ * 避免过长的缓存时间导致内存积压
+ */
+export declare const MAX_DNS_CACHE_TTL: number;
+/**
+ * 默认安全配置
+ */
+export declare const DEFAULT_SECURITY_CONFIG: SecurityConfig;
+/**
+ * 默认日志配置
+ */
+export declare const DEFAULT_LOGGING_CONFIG: LoggingConfig;
+/**
+ * 默认请求配置
+ */
+export declare const DEFAULT_REQUEST_CONFIG: RequestConfig;
+/**
+ * 默认 HTTP 客户端配置
+ */
+export declare const DEFAULT_HTTP_CLIENT_CONFIG: HttpClientConfig;
+//# sourceMappingURL=config.const.d.ts.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * 默认 DNS 缓存 TTL（毫秒）- 60 秒
+ */
+export declare const DEFAULT_DNS_CACHE_TTL = 60000;
+/**
+ * 默认 DNS 解析超时时间（毫秒）- 3 秒
+ */
+export declare const DEFAULT_DNS_RESOLVE_TIMEOUT = 3000;
+/**
+ * 默认 DNS 缓存最大条目数
+ */
+export declare const DEFAULT_DNS_CACHE_MAX_SIZE = 500;
+//# sourceMappingURL=dns.const.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dns.const.d.ts","sourceRoot":"","sources":["../../../src/const/dns.const.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,0BAA0B,MAAM,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * HTTP请求客户端适配器枚举.
+ */
+export declare enum EClientAdapter {
+    'axios' = "axios",
+    'undici' = "undici"
+}
+/**
+ * 日志级别
+ */
+export declare enum ELogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+//# sourceMappingURL=enum.const.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enum.const.d.ts","sourceRoot":"","sources":["../../../src/const/enum.const.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,cAAc;IACtB,OAAO,UAAU;IACjB,QAAQ,WAAW;CACtB;AAED;;GAEG;AACH,oBAAY,SAAS;IACjB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAClB"}

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

@@ -0,0 +1,5 @@
+export * from './ip.const';
+export * from './config.const';
+export * from './enum.const';
+export * from './dns.const';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/const/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,42 @@
+import type { CompiledIpv4Range, CompiledIpv6Range } from '../types';
+/**
+ * IPV4 校验地址范围（原始 CIDR 字符串）
+ */
+export declare const IPV4_RANGES: {
+    private: string[];
+    loopback: string[];
+    linkLocal: string[];
+    multicast: string[];
+    reserved: string[];
+};
+/**
+ * IPV6 校验地址范围（原始 CIDR 字符串）
+ */
+export declare const IPV6_RANGES: {
+    private: string[];
+    loopback: string[];
+    linkLocal: string[];
+    multicast: string[];
+    reserved: string[];
+};
+/**
+ * 预编译的 IPV4 校验地址范围（高性能版本）
+ */
+export declare const COMPILED_IPV4_RANGES: {
+    private: CompiledIpv4Range[];
+    loopback: CompiledIpv4Range[];
+    linkLocal: CompiledIpv4Range[];
+    multicast: CompiledIpv4Range[];
+    reserved: CompiledIpv4Range[];
+};
+/**
+ * 预编译的 IPV6 校验地址范围（高性能版本）
+ */
+export declare const COMPILED_IPV6_RANGES: {
+    private: CompiledIpv6Range[];
+    loopback: CompiledIpv6Range[];
+    linkLocal: CompiledIpv6Range[];
+    multicast: CompiledIpv6Range[];
+    reserved: CompiledIpv6Range[];
+};
+//# sourceMappingURL=ip.const.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ip.const.d.ts","sourceRoot":"","sources":["../../../src/const/ip.const.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,iBAAiB,EACjB,iBAAiB,EACpB,MAAM,UAAU,CAAC;AA6ElB;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;CAMvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;CAMvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAOhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAOhC,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+export * from './adapter';
+export * from './client';
+export * from './config';
+export * from './logger';
+export * from './security';
+export * from './types';
+export * from './utils';
+export * from './const';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * 日志记录器基础接口和实现
+ */
+import type { ILogger } from '../types';
+import { ELogLevel } from '../const';
+/**
+ * 抽象日志记录器基类
+ */
+export declare abstract class BaseLogger implements ILogger {
+    protected minLevel: ELogLevel;
+    constructor(minLevel?: ELogLevel);
+    /**
+     * 检查日志级别是否应该记录
+     * @param level 日志级别
+     * @returns 是否应该记录
+     */
+    protected shouldLog(level: ELogLevel): boolean;
+    /**
+     * 设置最小日志级别
+     * @param level 最小日志级别
+     */
+    setMinLevel(level: ELogLevel): void;
+    /**
+     * 获取当前最小日志级别
+     * @returns 最小日志级别
+     */
+    getMinLevel(): ELogLevel;
+    abstract debug(message: string, meta?: Record<string, any>): void;
+    abstract info(message: string, meta?: Record<string, any>): void;
+    abstract warn(message: string, meta?: Record<string, any>): void;
+    abstract error(message: string, meta?: Record<string, any>): void;
+}
+/**
+ * 空日志记录器（不记录任何日志）
+ */
+export declare class NullLogger implements ILogger {
+    debug(): void;
+    info(): void;
+    warn(): void;
+    error(): void;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/logger/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC;;GAEG;AACH,8BAAsB,UAAW,YAAW,OAAO;IAC/C,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAElB,QAAQ,GAAE,SAA0B;IAIhD;;;;OAIG;IACH,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAO9C;;;OAGG;IACI,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI1C;;;OAGG;IACI,WAAW,IAAI,SAAS;aAIf,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;aAExD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;aAEvD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;aAEvD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;CAC3E;AAED;;GAEG;AACH,qBAAa,UAAW,YAAW,OAAO;IAC/B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,IAAI,IAAI,IAAI;IAIZ,KAAK,IAAI,IAAI;CAGvB"}

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

@@ -0,0 +1,49 @@
+/**
+ * HTTP 客户端日志记录器实现
+ */
+import type { IHttpClientLogger, ILogger, IResFailedOptions, IResSuccessOptions, LogFilterConfig, HttpClientLoggerConfig } from '../types';
+/**
+ * HTTP 客户端日志记录器
+ * 将通用 ILogger 包装成专门的 IHttpClientLogger
+ */
+export declare class NsHttpClientLogger implements IHttpClientLogger {
+    private logger;
+    private filter?;
+    private logRequestBody;
+    private logResponseBody;
+    private bodyMaxLength;
+    constructor(config: HttpClientLoggerConfig);
+    /**
+     * 记录失败的请求
+     */
+    logFailed(resOptions: Omit<IResFailedOptions, 'isSuccess' | 'timestamp'>): void;
+    /**
+     * 记录成功的请求
+     */
+    logSuccess(resOptions: Omit<IResSuccessOptions, 'isSuccess' | 'timestamp'>): void;
+    /**
+     * 构建日志元数据
+     */
+    private buildLogMeta;
+    /**
+     * 格式化字节数为人类可读格式
+     */
+    private formatBytes;
+    /**
+     * 截断请求/响应体到指定长度
+     * 对于特殊类型（Stream、Buffer等）返回标记文本
+     */
+    private truncateBody;
+    /**
+     * 创建 HTTP 客户端日志记录器
+     * @param logger 底层日志记录器
+     * @param filterConfig 过滤器配置
+     * @param options 其他选项
+     */
+    static create(logger: ILogger, filterConfig?: LogFilterConfig, options?: {
+        logRequestBody?: boolean;
+        logResponseBody?: boolean;
+        bodyMaxLength?: number;
+    }): NsHttpClientLogger;
+}
+//# sourceMappingURL=http_client.logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http_client.logger.d.ts","sourceRoot":"","sources":["../../../src/logger/http_client.logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACR,iBAAiB,EACjB,OAAO,EAEP,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACzB,MAAM,UAAU,CAAC;AAGlB;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB;IACxD,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,EAAE,sBAAsB;IAQ1C;;OAEG;IACI,SAAS,CACZ,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,WAAW,CAAC,GAC/D,IAAI;IAoBP;;OAEG;IACI,UAAU,CACb,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,WAAW,CAAC,GAChE,IAAI;IAoBP;;OAEG;IACH,OAAO,CAAC,YAAY;IAsFpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAuDpB;;;;;OAKG;WACW,MAAM,CAChB,MAAM,EAAE,OAAO,EACf,YAAY,CAAC,EAAE,eAAe,EAC9B,OAAO,CAAC,EAAE;QACN,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;KACzB,GACF,kBAAkB;CASxB"}

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

@@ -0,0 +1,4 @@
+export * from './base';
+export * from './http_client.logger';
+export * from './log.filter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * 日志过滤器实现
+ */
+import type { ILogFilter, LogFilterConfig, IResSuccessOptions, IResFailedOptions } from '../types';
+/**
+ * 默认日志过滤器
+ */
+export declare class LogFilter implements ILogFilter {
+    private config;
+    constructor(config?: LogFilterConfig);
+    /**
+     * 判断是否应该记录此日志
+     * @param options 日志选项（成功或失败）
+     * @returns 是否应该记录
+     */
+    shouldLog(options: IResSuccessOptions | IResFailedOptions): boolean;
+    /**
+     * 检查成功/失败过滤
+     */
+    private checkSuccessOrFailedFilter;
+    /**
+     * 检查 HTTP 方法过滤
+     */
+    private checkMethodFilter;
+    /**
+     * 检查 URL 模式过滤
+     */
+    private checkUrlPatternFilter;
+    /**
+     * 检查场景过滤
+     */
+    private checkScenarioFilter;
+    /**
+     * 检查状态码过滤
+     */
+    private checkStatusCodeFilter;
+    /**
+     * 检查请求耗时过滤
+     */
+    private checkDurationFilter;
+    /**
+     * 检查自定义过滤函数
+     */
+    private checkCustomFilter;
+    /**
+     * 更新过滤器配置
+     * @param config 新的配置
+     */
+    updateConfig(config: LogFilterConfig): void;
+    /**
+     * 获取当前配置
+     * @returns 当前配置
+     */
+    getConfig(): LogFilterConfig;
+}
+//# sourceMappingURL=log.filter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.filter.d.ts","sourceRoot":"","sources":["../../../src/logger/log.filter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACR,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACpB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,qBAAa,SAAU,YAAW,UAAU;IACxC,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,GAAE,eAAoB;IAIxC;;;;OAIG;IACI,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,OAAO;IAY1E;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAuB7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;OAGG;IACI,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAIlD;;;OAGG;IACI,SAAS,IAAI,eAAe;CAGtC"}

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

@@ -0,0 +1,61 @@
+/**
+ * DNS 验证器
+ */
+import type { DnsResult } from '../types';
+/**
+ * DNS 验证器类
+ */
+export declare class DnsValidator {
+    private cache;
+    private cacheTtl;
+    private resolveTimeout;
+    constructor(cacheTtl?: number, resolveTimeout?: number, maxCacheSize?: number);
+    /**
+     * 解析域名
+     * @param hostname 域名
+     * @returns DNS 解析结果
+     */
+    resolve(hostname: string): Promise<DnsResult>;
+    /**
+     * 解析并验证域名（包括 IP 安全检查）
+     * @param hostname 域名
+     * @param allowPrivateIp 是否允许私有 IP
+     * @returns DNS 解析结果和验证结果
+     */
+    resolveAndValidate(hostname: string, allowPrivateIp?: boolean): Promise<{
+        dnsResult: DnsResult;
+        allValid: boolean;
+        invalidIps: string[];
+    }>;
+    /**
+     * 清空缓存
+     */
+    clearCache(): void;
+    /**
+     * 清除指定域名的缓存
+     * @param hostname 域名
+     */
+    clearCacheFor(hostname: string): void;
+    /**
+     * 获取缓存大小
+     * @returns 缓存条目数量
+     */
+    getCacheSize(): number;
+    /**
+     * 清理过期的缓存条目
+     * LRUCache 会自动清理过期条目（ttlAutopurge: true），此方法主动触发清理
+     */
+    cleanExpiredCache(): void;
+    /**
+     * 获取缓存的最大容量
+     * @returns 最大缓存条目数量
+     */
+    getMaxCacheSize(): number;
+    /**
+     * 检查缓存中是否存在指定域名
+     * @param hostname 域名
+     * @returns 是否存在
+     */
+    hasCache(hostname: string): boolean;
+}
+//# sourceMappingURL=dns.validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dns.validator.d.ts","sourceRoot":"","sources":["../../../src/security/dns.validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EACR,SAAS,EACZ,MAAM,UAAU,CAAC;AAIlB;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAS;gBAG3B,QAAQ,SAAwB,EAChC,cAAc,SAA8B,EAC5C,YAAY,SAA6B;IAgB7C;;;;OAIG;IACU,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAgD1D;;;;;OAKG;IACU,kBAAkB,CAC3B,QAAQ,EAAE,MAAM,EAChB,cAAc,UAAQ,GACvB,OAAO,CAAC;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAe7E;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB;;;OAGG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI5C;;;OAGG;IACI,YAAY,IAAI,MAAM;IAI7B;;;OAGG;IACI,iBAAiB,IAAI,IAAI;IAIhC;;;OAGG;IACI,eAAe,IAAI,MAAM;IAIhC;;;;OAIG;IACI,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAG7C"}

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

@@ -0,0 +1,5 @@
+export * from './dns.validator';
+export * from './ip.validator';
+export * from './url.validator';
+export * from './ssrf.guard';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/security/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * IP 地址验证器
+ */
+import type { IpValidationResult } from '../types';
+/**
+ * IP 地址验证器类
+ */
+export declare class IpValidator {
+    /**
+     * 验证 IP 地址是否安全
+     * @param ip IP 地址
+     * @param allowPrivateIp 是否允许私有 IP
+     * @returns 验证结果
+     */
+    static validate(ip: string, allowPrivateIp?: boolean): IpValidationResult;
+    /**
+     * 批量验证 IP 地址
+     * @param ips IP 地址列表
+     * @param allowPrivateIp 是否允许私有 IP
+     * @returns 验证结果列表
+     */
+    static validateMany(ips: string[], allowPrivateIp?: boolean): IpValidationResult[];
+    /**
+     * 检查是否所有 IP 地址都有效
+     * @param ips IP 地址列表
+     * @param allowPrivateIp 是否允许私有 IP
+     * @returns 是否所有 IP 都有效
+     */
+    static validateAll(ips: string[], allowPrivateIp?: boolean): boolean;
+}
+//# sourceMappingURL=ip.validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ip.validator.d.ts","sourceRoot":"","sources":["../../../src/security/ip.validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAQnD;;GAEG;AACH,qBAAa,WAAW;IACpB;;;;;OAKG;WACW,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,kBAAkB;IA0E9E;;;;;OAKG;WACW,YAAY,CACtB,GAAG,EAAE,MAAM,EAAE,EACb,cAAc,UAAQ,GACvB,kBAAkB,EAAE;IAIvB;;;;;OAKG;WACW,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,cAAc,UAAQ,GAAG,OAAO;CAG5E"}