nstarter-http-request 0.1.0

package/dist/esm/const/ip.const.js

@@ -0,0 +1,107 @@
+import { compileIpv4Ranges, compileIpv6Ranges, } from '../utils/ip.range';
+/**
+ * 私有 IP 地址范围（RFC 1918）
+ */
+const PRIVATE_IPV4_RANGES = [
+    '10.0.0.0/8', // 10.0.0.0 - 10.255.255.255
+    '172.16.0.0/12', // 172.16.0.0 - 172.31.255.255
+    '192.168.0.0/16', // 192.168.0.0 - 192.168.255.255
+    '100.64.0.0/10' // 100.64.0.0 - 100.127.255.255 (Shared Address Space, RFC 6598)
+];
+/**
+ * 私有 IPv6 地址范围
+ */
+const PRIVATE_IPV6_RANGES = [
+    'fc00::/7', // Unique Local Address (ULA)
+    'fd00::/8' // Unique Local Address (ULA)
+];
+/**
+ * 本地回环地址范围
+ */
+const LOOPBACK_IPV4_RANGES = [
+    '127.0.0.0/8' // 127.0.0.0 - 127.255.255.255
+];
+const LOOPBACK_IPV6_RANGES = [
+    '::1/128' // ::1
+];
+/**
+ * Link-Local 地址范围
+ */
+const LINK_LOCAL_IPV4_RANGES = [
+    '169.254.0.0/16' // 169.254.0.0 - 169.254.255.255
+];
+const LINK_LOCAL_IPV6_RANGES = [
+    'fe80::/10' // fe80:: - febf::
+];
+/**
+ * 组播地址范围
+ */
+const MULTICAST_IPV4_RANGES = [
+    '224.0.0.0/4' // 224.0.0.0 - 239.255.255.255
+];
+const MULTICAST_IPV6_RANGES = [
+    'ff00::/8' // ff00:: - ffff::
+];
+/**
+ * 其他保留地址范围
+ */
+const RESERVED_IPV4_RANGES = [
+    '0.0.0.0/8', // Current network (RFC 1122)
+    '192.0.0.0/24', // IETF Protocol Assignments (RFC 6890)
+    '192.0.2.0/24', // TEST-NET-1 (RFC 5737)
+    '198.18.0.0/15', // Benchmarking (RFC 2544)
+    '198.51.100.0/24', // TEST-NET-2 (RFC 5737)
+    '203.0.113.0/24', // TEST-NET-3 (RFC 5737)
+    '240.0.0.0/4', // Reserved (RFC 1112)
+    '255.255.255.255/32' // Broadcast
+];
+const RESERVED_IPV6_RANGES = [
+    '::/128', // Unspecified
+    '::ffff:0:0/96', // IPv4-mapped IPv6
+    '64:ff9b::/96', // IPv4/IPv6 translation (RFC 6052)
+    '100::/64', // Discard prefix (RFC 6666)
+    '2001::/32', // TEREDO (RFC 4380)
+    '2001:10::/28', // Deprecated (RFC 4843)
+    '2001:db8::/32' // Documentation (RFC 3849)
+];
+/**
+ * IPV4 校验地址范围（原始 CIDR 字符串）
+ */
+export const IPV4_RANGES = {
+    private: PRIVATE_IPV4_RANGES,
+    loopback: LOOPBACK_IPV4_RANGES,
+    linkLocal: LINK_LOCAL_IPV4_RANGES,
+    multicast: MULTICAST_IPV4_RANGES,
+    reserved: RESERVED_IPV4_RANGES
+};
+/**
+ * IPV6 校验地址范围（原始 CIDR 字符串）
+ */
+export const IPV6_RANGES = {
+    private: PRIVATE_IPV6_RANGES,
+    loopback: LOOPBACK_IPV6_RANGES,
+    linkLocal: LINK_LOCAL_IPV6_RANGES,
+    multicast: MULTICAST_IPV6_RANGES,
+    reserved: RESERVED_IPV6_RANGES
+};
+/**
+ * 预编译的 IPV4 校验地址范围（高性能版本）
+ */
+export const COMPILED_IPV4_RANGES = {
+    private: compileIpv4Ranges(PRIVATE_IPV4_RANGES),
+    loopback: compileIpv4Ranges(LOOPBACK_IPV4_RANGES),
+    linkLocal: compileIpv4Ranges(LINK_LOCAL_IPV4_RANGES),
+    multicast: compileIpv4Ranges(MULTICAST_IPV4_RANGES),
+    reserved: compileIpv4Ranges(RESERVED_IPV4_RANGES)
+};
+/**
+ * 预编译的 IPV6 校验地址范围（高性能版本）
+ */
+export const COMPILED_IPV6_RANGES = {
+    private: compileIpv6Ranges(PRIVATE_IPV6_RANGES),
+    loopback: compileIpv6Ranges(LOOPBACK_IPV6_RANGES),
+    linkLocal: compileIpv6Ranges(LINK_LOCAL_IPV6_RANGES),
+    multicast: compileIpv6Ranges(MULTICAST_IPV6_RANGES),
+    reserved: compileIpv6Ranges(RESERVED_IPV6_RANGES)
+};
+//# sourceMappingURL=ip.const.js.map

package/dist/esm/const/ip.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip.const.js","sourceRoot":"","sources":["../../../src/const/ip.const.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EACjB,iBAAiB,GACpB,MAAM,mBAAmB,CAAC;AAM3B;;GAEG;AACH,MAAM,mBAAmB,GAAG;IACxB,YAAY,EAAQ,4BAA4B;IAChD,eAAe,EAAK,8BAA8B;IAClD,gBAAgB,EAAI,gCAAgC;IACpD,eAAe,CAAK,gEAAgE;CACvF,CAAC;AAEF;;GAEG;AACH,MAAM,mBAAmB,GAAG;IACxB,UAAU,EAAU,6BAA6B;IACjD,UAAU,CAAU,6BAA6B;CACpD,CAAC;AAEF;;GAEG;AACH,MAAM,oBAAoB,GAAG;IACzB,aAAa,CAAO,8BAA8B;CACrD,CAAC;AAEF,MAAM,oBAAoB,GAAG;IACzB,SAAS,CAAW,MAAM;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,sBAAsB,GAAG;IAC3B,gBAAgB,CAAI,gCAAgC;CACvD,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC3B,WAAW,CAAS,kBAAkB;CACzC,CAAC;AAEF;;GAEG;AACH,MAAM,qBAAqB,GAAG;IAC1B,aAAa,CAAO,8BAA8B;CACrD,CAAC;AAEF,MAAM,qBAAqB,GAAG;IAC1B,UAAU,CAAU,kBAAkB;CACzC,CAAC;AAEF;;GAEG;AACH,MAAM,oBAAoB,GAAG;IACzB,WAAW,EAAS,6BAA6B;IACjD,cAAc,EAAM,uCAAuC;IAC3D,cAAc,EAAM,wBAAwB;IAC5C,eAAe,EAAK,0BAA0B;IAC9C,iBAAiB,EAAG,wBAAwB;IAC5C,gBAAgB,EAAI,wBAAwB;IAC5C,aAAa,EAAO,sBAAsB;IAC1C,oBAAoB,CAAC,YAAY;CACpC,CAAC;AAEF,MAAM,oBAAoB,GAAG;IACzB,QAAQ,EAAY,cAAc;IAClC,eAAe,EAAK,mBAAmB;IACvC,cAAc,EAAM,mCAAmC;IACvD,UAAU,EAAU,4BAA4B;IAChD,WAAW,EAAS,oBAAoB;IACxC,cAAc,EAAM,wBAAwB;IAC5C,eAAe,CAAK,2BAA2B;CAClD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,OAAO,EAAE,mBAAmB;IAC5B,QAAQ,EAAE,oBAAoB;IAC9B,SAAS,EAAE,sBAAsB;IACjC,SAAS,EAAE,qBAAqB;IAChC,QAAQ,EAAE,oBAAoB;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,OAAO,EAAE,mBAAmB;IAC5B,QAAQ,EAAE,oBAAoB;IAC9B,SAAS,EAAE,sBAAsB;IACjC,SAAS,EAAE,qBAAqB;IAChC,QAAQ,EAAE,oBAAoB;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAM7B;IACA,OAAO,EAAE,iBAAiB,CAAC,mBAAmB,CAAC;IAC/C,QAAQ,EAAE,iBAAiB,CAAC,oBAAoB,CAAC;IACjD,SAAS,EAAE,iBAAiB,CAAC,sBAAsB,CAAC;IACpD,SAAS,EAAE,iBAAiB,CAAC,qBAAqB,CAAC;IACnD,QAAQ,EAAE,iBAAiB,CAAC,oBAAoB,CAAC;CACpD,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAM7B;IACA,OAAO,EAAE,iBAAiB,CAAC,mBAAmB,CAAC;IAC/C,QAAQ,EAAE,iBAAiB,CAAC,oBAAoB,CAAC;IACjD,SAAS,EAAE,iBAAiB,CAAC,sBAAsB,CAAC;IACpD,SAAS,EAAE,iBAAiB,CAAC,qBAAqB,CAAC;IACnD,QAAQ,EAAE,iBAAiB,CAAC,oBAAoB,CAAC;CACpD,CAAC"}

package/dist/esm/index.js

@@ -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.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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/esm/logger/base.js

@@ -0,0 +1,55 @@
+/**
+ * 日志记录器基础接口和实现
+ */
+import { ELogLevel } from '../const';
+/**
+ * 抽象日志记录器基类
+ */
+export class BaseLogger {
+    constructor(minLevel = ELogLevel.INFO) {
+        this.minLevel = minLevel;
+    }
+    /**
+     * 检查日志级别是否应该记录
+     * @param level 日志级别
+     * @returns 是否应该记录
+     */
+    shouldLog(level) {
+        const levels = [ELogLevel.DEBUG, ELogLevel.INFO, ELogLevel.WARN, ELogLevel.ERROR];
+        const minLevelIndex = levels.indexOf(this.minLevel);
+        const currentLevelIndex = levels.indexOf(level);
+        return currentLevelIndex >= minLevelIndex;
+    }
+    /**
+     * 设置最小日志级别
+     * @param level 最小日志级别
+     */
+    setMinLevel(level) {
+        this.minLevel = level;
+    }
+    /**
+     * 获取当前最小日志级别
+     * @returns 最小日志级别
+     */
+    getMinLevel() {
+        return this.minLevel;
+    }
+}
+/**
+ * 空日志记录器（不记录任何日志）
+ */
+export class NullLogger {
+    debug() {
+        // 不做任何事
+    }
+    info() {
+        // 不做任何事
+    }
+    warn() {
+        // 不做任何事
+    }
+    error() {
+        // 不做任何事
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/logger/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/logger/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC;;GAEG;AACH,MAAM,OAAgB,UAAU;IAG5B,YAAY,WAAsB,SAAS,CAAC,IAAI;QAC5C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACO,SAAS,CAAC,KAAgB;QAChC,MAAM,MAAM,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QAClF,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO,iBAAiB,IAAI,aAAa,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACI,WAAW,CAAC,KAAgB;QAC/B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;CASJ;AAED;;GAEG;AACH,MAAM,OAAO,UAAU;IACZ,KAAK;QACR,QAAQ;IACZ,CAAC;IAEM,IAAI;QACP,QAAQ;IACZ,CAAC;IAEM,IAAI;QACP,QAAQ;IACZ,CAAC;IAEM,KAAK;QACR,QAAQ;IACZ,CAAC;CACJ"}

package/dist/esm/logger/http_client.logger.js

@@ -0,0 +1,205 @@
+/**
+ * HTTP 客户端日志记录器实现
+ */
+import { LogFilter } from './log.filter';
+/**
+ * HTTP 客户端日志记录器
+ * 将通用 ILogger 包装成专门的 IHttpClientLogger
+ */
+export class NsHttpClientLogger {
+    constructor(config) {
+        this.logger = config.logger;
+        this.filter = config.filter;
+        this.logRequestBody = config.logRequestBody ?? false;
+        this.logResponseBody = config.logResponseBody ?? false;
+        this.bodyMaxLength = config.bodyMaxLength ?? 1024;
+    }
+    /**
+     * 记录失败的请求
+     */
+    logFailed(resOptions) {
+        const fullOptions = {
+            ...resOptions,
+            isSuccess: false,
+            timestamp: Date.now()
+        };
+        // 应用过滤器
+        if (this.filter && !this.filter.shouldLog(fullOptions)) {
+            return;
+        }
+        const meta = this.buildLogMeta(fullOptions);
+        this.logger.error(`HTTP request failed: ${fullOptions.request.method} ${fullOptions.request.url}`, meta);
+    }
+    /**
+     * 记录成功的请求
+     */
+    logSuccess(resOptions) {
+        const fullOptions = {
+            ...resOptions,
+            isSuccess: true,
+            timestamp: Date.now()
+        };
+        // 应用过滤器
+        if (this.filter && !this.filter.shouldLog(fullOptions)) {
+            return;
+        }
+        const meta = this.buildLogMeta(fullOptions);
+        this.logger.info(`HTTP request succeeded: ${fullOptions.request.method} ${fullOptions.request.url}`, meta);
+    }
+    /**
+     * 构建日志元数据
+     */
+    buildLogMeta(options) {
+        const meta = {
+            method: options.request.method,
+            url: options.request.url,
+            duration: options.duration,
+            timestamp: options.timestamp,
+            retryCount: options.retryCount
+        };
+        // 添加场景信息
+        if (options.request.scenario) {
+            meta.scenario = options.request.scenario;
+        }
+        // 添加请求元数据
+        if (options.request.meta) {
+            meta.requestMeta = options.request.meta;
+        }
+        if (options.isSuccess) {
+            // 成功的请求
+            meta.status = options.response.status;
+            meta.statusText = options.response.statusText;
+            // 记录流式响应指标
+            if (options.streamMetrics) {
+                meta.streamMetrics = {
+                    ttfb: options.streamMetrics.ttfb,
+                    completed: options.streamMetrics.completed
+                };
+                if (options.streamMetrics.completed) {
+                    meta.streamMetrics.totalDuration = options.streamMetrics.totalDuration;
+                    meta.streamMetrics.streamDuration =
+                        (options.streamMetrics.totalDuration ?? 0) - options.streamMetrics.ttfb;
+                    if (options.streamMetrics.bytesTransferred !== undefined) {
+                        meta.streamMetrics.bytesTransferred = options.streamMetrics.bytesTransferred;
+                        meta.streamMetrics.bytesTransferredHuman =
+                            this.formatBytes(options.streamMetrics.bytesTransferred);
+                        // 计算吞吐量
+                        const streamDuration = meta.streamMetrics.streamDuration;
+                        if (streamDuration > 0) {
+                            const throughputBps = options.streamMetrics.bytesTransferred / (streamDuration / 1000);
+                            meta.streamMetrics.throughput = `${(throughputBps / 1024).toFixed(2)} KB/s`;
+                        }
+                    }
+                }
+            }
+            // 记录响应体（如果启用，且不是流式响应）
+            if (this.logResponseBody && !options.streamMetrics) {
+                meta.responseBody = this.truncateBody(options.response.data);
+            }
+            else if (options.streamMetrics && !options.streamMetrics.completed) {
+                // 流式响应但未完成，标记为流
+                meta.responseBody = '# --- stream (in progress) --- #';
+            }
+            else if (options.streamMetrics && options.streamMetrics.completed) {
+                // 流式响应已完成
+                meta.responseBody = '# --- stream (completed) --- #';
+            }
+        }
+        else {
+            // 失败的请求
+            meta.error = options.error.message;
+            meta.errorCode = options.errorCode;
+            if (options.status !== undefined) {
+                meta.status = options.status;
+            }
+            if (options.response) {
+                meta.responseBody = this.truncateBody(options.response.data);
+            }
+        }
+        // 记录请求体（如果启用）
+        if (this.logRequestBody) {
+            meta.requestBody = this.truncateBody(options.request.body);
+        }
+        return meta;
+    }
+    /**
+     * 格式化字节数为人类可读格式
+     */
+    formatBytes(bytes) {
+        if (bytes === 0) {
+            return '0 Bytes';
+        }
+        const k = 1024;
+        const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;
+    }
+    /**
+     * 截断请求/响应体到指定长度
+     * 对于特殊类型（Stream、Buffer等）返回标记文本
+     */
+    truncateBody(body) {
+        // 处理 null 和 undefined
+        if (body === null) {
+            return '# --- null --- #';
+        }
+        if (body === undefined) {
+            return '# --- undefined --- #';
+        }
+        // 处理基本类型
+        if (typeof body === 'number' || typeof body === 'boolean') {
+            return body;
+        }
+        // 处理字符串
+        if (typeof body === 'string') {
+            if (body.length <= this.bodyMaxLength) {
+                return body;
+            }
+            return body.substring(0, this.bodyMaxLength) + '... (truncated)';
+        }
+        // 处理 Buffer
+        if (Buffer.isBuffer(body)) {
+            return `# --- buffer (${body.length} bytes) --- #`;
+        }
+        // 处理 Stream
+        if (typeof body === 'object' && typeof body.pipe === 'function') {
+            return '# --- stream --- #';
+        }
+        // 处理 ArrayBuffer
+        if (body instanceof ArrayBuffer ||
+            (typeof body === 'object' && body.constructor?.name === 'ArrayBuffer')) {
+            return `# --- arraybuffer (${body.byteLength} bytes) --- #`;
+        }
+        // 处理 Blob (浏览器环境)
+        if (typeof body === 'object' && body.constructor?.name === 'Blob') {
+            return `# --- blob (${body.size} bytes) --- #`;
+        }
+        // 处理普通对象和数组
+        try {
+            const bodyStr = JSON.stringify(body);
+            if (bodyStr.length <= this.bodyMaxLength) {
+                return body;
+            }
+            return bodyStr.substring(0, this.bodyMaxLength) + '... (truncated)';
+        }
+        catch {
+            return '[unable to serialize body]';
+        }
+    }
+    /**
+     * 创建 HTTP 客户端日志记录器
+     * @param logger 底层日志记录器
+     * @param filterConfig 过滤器配置
+     * @param options 其他选项
+     */
+    static create(logger, filterConfig, options) {
+        return new NsHttpClientLogger({
+            logger,
+            filter: filterConfig ? new LogFilter(filterConfig) : undefined,
+            logRequestBody: options?.logRequestBody,
+            logResponseBody: options?.logResponseBody,
+            bodyMaxLength: options?.bodyMaxLength
+        });
+    }
+}
+//# sourceMappingURL=http_client.logger.js.map

package/dist/esm/logger/http_client.logger.js.map

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

package/dist/esm/logger/index.js

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

package/dist/esm/logger/index.js.map

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

package/dist/esm/logger/log.filter.js

@@ -0,0 +1,122 @@
+/**
+ * 日志过滤器实现
+ */
+/**
+ * 默认日志过滤器
+ */
+export class LogFilter {
+    constructor(config = {}) {
+        this.config = config;
+    }
+    /**
+     * 判断是否应该记录此日志
+     * @param options 日志选项（成功或失败）
+     * @returns 是否应该记录
+     */
+    shouldLog(options) {
+        return (this.checkSuccessOrFailedFilter(options) &&
+            this.checkMethodFilter(options) &&
+            this.checkUrlPatternFilter(options) &&
+            this.checkScenarioFilter(options) &&
+            this.checkStatusCodeFilter(options) &&
+            this.checkDurationFilter(options) &&
+            this.checkCustomFilter(options));
+    }
+    /**
+     * 检查成功/失败过滤
+     */
+    checkSuccessOrFailedFilter(options) {
+        if (this.config.onlyFailed && options.isSuccess) {
+            return false;
+        }
+        if (this.config.onlySuccess && !options.isSuccess) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 检查 HTTP 方法过滤
+     */
+    checkMethodFilter(options) {
+        if (this.config.methods && this.config.methods.length > 0) {
+            return this.config.methods.includes(options.request.method);
+        }
+        return true;
+    }
+    /**
+     * 检查 URL 模式过滤
+     */
+    checkUrlPatternFilter(options) {
+        if (this.config.urlPatterns && this.config.urlPatterns.length > 0) {
+            return this.config.urlPatterns.some(pattern => {
+                if (typeof pattern === 'string') {
+                    return options.request.url.includes(pattern);
+                }
+                return pattern.test(options.request.url);
+            });
+        }
+        return true;
+    }
+    /**
+     * 检查场景过滤
+     */
+    checkScenarioFilter(options) {
+        if (this.config.scenarios && this.config.scenarios.length > 0) {
+            return !!options.request.scenario && this.config.scenarios.includes(options.request.scenario);
+        }
+        return true;
+    }
+    /**
+     * 检查状态码过滤
+     */
+    checkStatusCodeFilter(options) {
+        const status = options.isSuccess ? options.response.status : options.status;
+        if (status === undefined) {
+            return true;
+        }
+        // 检查特定状态码
+        if (this.config.statusCodes && this.config.statusCodes.length > 0) {
+            if (!this.config.statusCodes.includes(status)) {
+                return false;
+            }
+        }
+        // 检查状态码范围
+        if (this.config.statusCodeRanges && this.config.statusCodeRanges.length > 0) {
+            return this.config.statusCodeRanges.some(range => status >= range.min && status <= range.max);
+        }
+        return true;
+    }
+    /**
+     * 检查请求耗时过滤
+     */
+    checkDurationFilter(options) {
+        if (this.config.minDuration !== undefined && options.duration !== undefined) {
+            return options.duration >= this.config.minDuration;
+        }
+        return true;
+    }
+    /**
+     * 检查自定义过滤函数
+     */
+    checkCustomFilter(options) {
+        if (this.config.customFilter) {
+            return this.config.customFilter(options);
+        }
+        return true;
+    }
+    /**
+     * 更新过滤器配置
+     * @param config 新的配置
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * 获取当前配置
+     * @returns 当前配置
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=log.filter.js.map

package/dist/esm/logger/log.filter.js.map

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

package/dist/esm/security/dns.validator.js

@@ -0,0 +1,133 @@
+/**
+ * DNS 验证器
+ */
+import { promises as dns } from 'node:dns';
+import { LRUCache } from 'lru-cache';
+import { CommonUtils } from '../utils';
+import { DEFAULT_DNS_CACHE_TTL, DEFAULT_DNS_RESOLVE_TIMEOUT, DEFAULT_DNS_CACHE_MAX_SIZE } from '../const';
+import { IpValidator } from './ip.validator';
+/**
+ * DNS 验证器类
+ */
+export class DnsValidator {
+    constructor(cacheTtl = DEFAULT_DNS_CACHE_TTL, resolveTimeout = DEFAULT_DNS_RESOLVE_TIMEOUT, maxCacheSize = DEFAULT_DNS_CACHE_MAX_SIZE) {
+        this.cacheTtl = cacheTtl;
+        this.resolveTimeout = resolveTimeout;
+        this.cache = new LRUCache({
+            max: maxCacheSize,
+            ttl: cacheTtl,
+            // 启用 TTL 自动清理
+            ttlAutopurge: true,
+            // 更新访问时间，实现真正的 LRU
+            updateAgeOnGet: true,
+            // 更新访问时间时也更新 has() 调用
+            updateAgeOnHas: true,
+        });
+    }
+    /**
+     * 解析域名
+     * @param hostname 域名
+     * @returns DNS 解析结果
+     */
+    async resolve(hostname) {
+        // 检查缓存
+        const cached = this.cache.get(hostname);
+        if (cached) {
+            return cached;
+        }
+        try {
+            // 尝试解析 IPv4 和 IPv6
+            const addresses = [];
+            try {
+                const ipv4Addresses = await CommonUtils.withTimeout(dns.resolve4(hostname), this.resolveTimeout, 'DNS resolution timed out');
+                addresses.push(...ipv4Addresses);
+            }
+            catch {
+                // IPv4 解析失败，继续尝试 IPv6
+            }
+            try {
+                const ipv6Addresses = await CommonUtils.withTimeout(dns.resolve6(hostname), this.resolveTimeout, 'DNS resolution timed out');
+                addresses.push(...ipv6Addresses);
+            }
+            catch {
+                // IPv6 解析失败
+            }
+            if (addresses.length === 0) {
+                throw new Error(`Unable to resolve hostname: ${hostname}`);
+            }
+            const result = {
+                hostname,
+                addresses,
+                timestamp: Date.now(),
+                ttl: this.cacheTtl
+            };
+            // 存入缓存，LRUCache 会自动处理 TTL 和容量限制
+            this.cache.set(hostname, result);
+            return result;
+        }
+        catch (error) {
+            throw new Error(`DNS resolution failed for ${hostname}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * 解析并验证域名（包括 IP 安全检查）
+     * @param hostname 域名
+     * @param allowPrivateIp 是否允许私有 IP
+     * @returns DNS 解析结果和验证结果
+     */
+    async resolveAndValidate(hostname, allowPrivateIp = false) {
+        const dnsResult = await this.resolve(hostname);
+        const validationResults = IpValidator.validateMany(dnsResult.addresses, allowPrivateIp);
+        const invalidIps = validationResults
+            .filter(result => !result.valid)
+            .map(result => result.ip);
+        return {
+            dnsResult,
+            allValid: invalidIps.length === 0,
+            invalidIps
+        };
+    }
+    /**
+     * 清空缓存
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * 清除指定域名的缓存
+     * @param hostname 域名
+     */
+    clearCacheFor(hostname) {
+        this.cache.delete(hostname);
+    }
+    /**
+     * 获取缓存大小
+     * @returns 缓存条目数量
+     */
+    getCacheSize() {
+        return this.cache.size;
+    }
+    /**
+     * 清理过期的缓存条目
+     * LRUCache 会自动清理过期条目（ttlAutopurge: true），此方法主动触发清理
+     */
+    cleanExpiredCache() {
+        this.cache.purgeStale();
+    }
+    /**
+     * 获取缓存的最大容量
+     * @returns 最大缓存条目数量
+     */
+    getMaxCacheSize() {
+        return this.cache.max;
+    }
+    /**
+     * 检查缓存中是否存在指定域名
+     * @param hostname 域名
+     * @returns 是否存在
+     */
+    hasCache(hostname) {
+        return this.cache.has(hostname);
+    }
+}
+//# sourceMappingURL=dns.validator.js.map