nstarter-http-request 0.1.0

package/dist/cjs/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/cjs/logger/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./base"), exports);
+__exportStar(require("./http_client.logger"), exports);
+__exportStar(require("./log.filter"), exports);
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * 日志过滤器实现
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogFilter = void 0;
+/**
+ * 默认日志过滤器
+ */
+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 };
+    }
+}
+exports.LogFilter = LogFilter;
+//# sourceMappingURL=log.filter.js.map

package/dist/cjs/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/cjs/security/dns.validator.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * DNS 验证器
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DnsValidator = void 0;
+const node_dns_1 = require("node:dns");
+const lru_cache_1 = require("lru-cache");
+const utils_1 = require("../utils");
+const const_1 = require("../const");
+const ip_validator_1 = require("./ip.validator");
+/**
+ * DNS 验证器类
+ */
+class DnsValidator {
+    constructor(cacheTtl = const_1.DEFAULT_DNS_CACHE_TTL, resolveTimeout = const_1.DEFAULT_DNS_RESOLVE_TIMEOUT, maxCacheSize = const_1.DEFAULT_DNS_CACHE_MAX_SIZE) {
+        this.cacheTtl = cacheTtl;
+        this.resolveTimeout = resolveTimeout;
+        this.cache = new lru_cache_1.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 utils_1.CommonUtils.withTimeout(node_dns_1.promises.resolve4(hostname), this.resolveTimeout, 'DNS resolution timed out');
+                addresses.push(...ipv4Addresses);
+            }
+            catch {
+                // IPv4 解析失败，继续尝试 IPv6
+            }
+            try {
+                const ipv6Addresses = await utils_1.CommonUtils.withTimeout(node_dns_1.promises.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 = ip_validator_1.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);
+    }
+}
+exports.DnsValidator = DnsValidator;
+//# sourceMappingURL=dns.validator.js.map

package/dist/cjs/security/dns.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns.validator.js","sourceRoot":"","sources":["../../../src/security/dns.validator.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAA2C;AAC3C,yCAAqC;AACrC,oCAAuC;AACvC,oCAIkB;AAIlB,iDAA6C;AAG7C;;GAEG;AACH,MAAa,YAAY;IAKrB,YACI,QAAQ,GAAG,6BAAqB,EAChC,cAAc,GAAG,mCAA2B,EAC5C,YAAY,GAAG,kCAA0B;QAEzC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,oBAAQ,CAAoB;YACzC,GAAG,EAAE,YAAY;YACjB,GAAG,EAAE,QAAQ;YACb,cAAc;YACd,YAAY,EAAE,IAAI;YAClB,mBAAmB;YACnB,cAAc,EAAE,IAAI;YACpB,sBAAsB;YACtB,cAAc,EAAE,IAAI;SACvB,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAO,CAAC,QAAgB;QACjC,OAAO;QACP,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,MAAM,EAAE,CAAC;YACT,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YACD,mBAAmB;YACnB,MAAM,SAAS,GAAa,EAAE,CAAC;YAE/B,IAAI,CAAC;gBACD,MAAM,aAAa,GAAG,MAAM,mBAAW,CAAC,WAAW,CAAC,mBAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,0BAA0B,CAAC,CAAC;gBAC7H,SAAS,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACL,sBAAsB;YAC1B,CAAC;YAED,IAAI,CAAC;gBACD,MAAM,aAAa,GAAG,MAAM,mBAAW,CAAC,WAAW,CAAC,mBAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,0BAA0B,CAAC,CAAC;gBAC7H,SAAS,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACL,YAAY;YAChB,CAAC;YAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,+BAAgC,QAAS,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,MAAM,MAAM,GAAc;gBACtB,QAAQ;gBACR,SAAS;gBACT,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,GAAG,EAAE,IAAI,CAAC,QAAQ;aACrB,CAAC;YAEF,gCAAgC;YAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAEjC,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACX,6BAA8B,QAAS,KAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAE,EAAE,CACzG,CAAC;QACN,CAAC;IACL,CAAC;IAGD;;;;;OAKG;IACI,KAAK,CAAC,kBAAkB,CAC3B,QAAgB,EAChB,cAAc,GAAG,KAAK;QAEtB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,iBAAiB,GAAG,0BAAW,CAAC,YAAY,CAAC,SAAS,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAExF,MAAM,UAAU,GAAG,iBAAiB;aAC/B,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC/B,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE9B,OAAO;YACH,SAAS;YACT,QAAQ,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;YACjC,UAAU;SACb,CAAC;IACN,CAAC;IAED;;OAEG;IACI,UAAU;QACb,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,QAAgB;QACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACI,YAAY;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACI,iBAAiB;QACpB,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACI,eAAe;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,QAAQ,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACJ;AApJD,oCAoJC"}

package/dist/cjs/security/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./dns.validator"), exports);
+__exportStar(require("./ip.validator"), exports);
+__exportStar(require("./url.validator"), exports);
+__exportStar(require("./ssrf.guard"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/security/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/security/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,iDAA+B;AAC/B,kDAAgC;AAChC,+CAA6B"}

package/dist/cjs/security/ip.validator.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * IP 地址验证器
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IpValidator = void 0;
+const node_net_1 = require("node:net");
+const utils_1 = require("../utils");
+const const_1 = require("../const");
+/**
+ * IP 地址验证器类
+ */
+class IpValidator {
+    /**
+     * 验证 IP 地址是否安全
+     * @param ip IP 地址
+     * @param allowPrivateIp 是否允许私有 IP
+     * @returns 验证结果
+     */
+    static validate(ip, allowPrivateIp = false) {
+        // 检查是否为有效的 IP 地址
+        const isV4 = (0, node_net_1.isIPv4)(ip);
+        const isV6 = (0, node_net_1.isIPv6)(ip);
+        if (!isV4 && !isV6) {
+            return {
+                valid: false,
+                ip,
+                isPrivate: false,
+                isLoopback: false,
+                isLinkLocal: false,
+                isMulticast: false,
+                isReserved: false,
+                reason: 'Invalid IP address format'
+            };
+        }
+        // 使用预编译的范围进行高性能检查
+        let isPrivate;
+        let isLoopback;
+        let isLinkLocal;
+        let isMulticast;
+        let isReserved;
+        if (isV4) {
+            isPrivate = utils_1.IpRangeUtils.isIpv4InAnyCompiledRange(ip, const_1.COMPILED_IPV4_RANGES.private);
+            isLoopback = utils_1.IpRangeUtils.isIpv4InAnyCompiledRange(ip, const_1.COMPILED_IPV4_RANGES.loopback);
+            isLinkLocal = utils_1.IpRangeUtils.isIpv4InAnyCompiledRange(ip, const_1.COMPILED_IPV4_RANGES.linkLocal);
+            isMulticast = utils_1.IpRangeUtils.isIpv4InAnyCompiledRange(ip, const_1.COMPILED_IPV4_RANGES.multicast);
+            isReserved = utils_1.IpRangeUtils.isIpv4InAnyCompiledRange(ip, const_1.COMPILED_IPV4_RANGES.reserved);
+        }
+        else {
+            isPrivate = utils_1.IpRangeUtils.isIpv6InAnyCompiledRange(ip, const_1.COMPILED_IPV6_RANGES.private);
+            isLoopback = utils_1.IpRangeUtils.isIpv6InAnyCompiledRange(ip, const_1.COMPILED_IPV6_RANGES.loopback);
+            isLinkLocal = utils_1.IpRangeUtils.isIpv6InAnyCompiledRange(ip, const_1.COMPILED_IPV6_RANGES.linkLocal);
+            isMulticast = utils_1.IpRangeUtils.isIpv6InAnyCompiledRange(ip, const_1.COMPILED_IPV6_RANGES.multicast);
+            isReserved = utils_1.IpRangeUtils.isIpv6InAnyCompiledRange(ip, const_1.COMPILED_IPV6_RANGES.reserved);
+        }
+        // 基础验证信息
+        const baseResult = {
+            ip,
+            isPrivate,
+            isLoopback,
+            isLinkLocal,
+            isMulticast,
+            isReserved
+        };
+        // 检查是否为受限 IP - 按优先级顺序检查
+        const restrictions = [
+            { condition: isLoopback, reason: 'Loopback address is not allowed' },
+            { condition: isLinkLocal, reason: 'Link-local address is not allowed' },
+            { condition: isMulticast, reason: 'Multicast address is not allowed' },
+            { condition: isReserved, reason: 'Reserved address is not allowed' },
+            { condition: isPrivate && !allowPrivateIp, reason: 'Private IP address is not allowed' }
+        ];
+        for (const { condition, reason } of restrictions) {
+            if (condition) {
+                return {
+                    valid: false,
+                    ...baseResult,
+                    reason
+                };
+            }
+        }
+        return {
+            valid: true,
+            ...baseResult
+        };
+    }
+    /**
+     * 批量验证 IP 地址
+     * @param ips IP 地址列表
+     * @param allowPrivateIp 是否允许私有 IP
+     * @returns 验证结果列表
+     */
+    static validateMany(ips, allowPrivateIp = false) {
+        return ips.map(ip => this.validate(ip, allowPrivateIp));
+    }
+    /**
+     * 检查是否所有 IP 地址都有效
+     * @param ips IP 地址列表
+     * @param allowPrivateIp 是否允许私有 IP
+     * @returns 是否所有 IP 都有效
+     */
+    static validateAll(ips, allowPrivateIp = false) {
+        return this.validateMany(ips, allowPrivateIp).every(result => result.valid);
+    }
+}
+exports.IpValidator = IpValidator;
+//# sourceMappingURL=ip.validator.js.map

package/dist/cjs/security/ip.validator.js.map

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

package/dist/cjs/security/ssrf.guard.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * SSRF 防护
+ * 整合 IP、DNS 和 URL 验证，防止服务器端请求伪造攻击
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SsrfGuard = void 0;
+const node_url_1 = require("node:url");
+const node_net_1 = require("node:net");
+const types_1 = require("../types");
+const dns_validator_1 = require("./dns.validator");
+const ip_validator_1 = require("./ip.validator");
+const url_validator_1 = require("./url.validator");
+/**
+ * SSRF 防护类
+ */
+class SsrfGuard {
+    constructor(config) {
+        this.config = config;
+        this.dnsValidator = new dns_validator_1.DnsValidator(config.dnsCacheTtl, undefined, // 使用默认的 DNS 解析超时
+        config.dnsCacheMaxSize);
+        this.urlValidator = new url_validator_1.UrlValidator(config.whitelist, config.blacklist);
+    }
+    /**
+     * 验证 URL 是否安全
+     * @param url 要验证的 URL
+     * @returns 验证结果
+     */
+    async validate(url) {
+        let parsedUrl;
+        try {
+            parsedUrl = new node_url_1.URL(url);
+        }
+        catch (error) {
+            return {
+                passed: false,
+                originalUrl: url,
+                hostname: '',
+                reason: 'Invalid URL format'
+            };
+        }
+        const hostname = parsedUrl.hostname;
+        // 第一步：URL 验证（黑白名单）
+        const urlValidation = this.urlValidator.validate(url);
+        if (!urlValidation.valid) {
+            return {
+                passed: false,
+                originalUrl: url,
+                hostname,
+                reason: urlValidation.reason
+            };
+        }
+        // 第二步：检查是否为 IP 地址
+        const ipVersion = (0, node_net_1.isIP)(hostname);
+        if (ipVersion !== 0) {
+            // 直接使用 IP 地址，需要验证 IP 安全性
+            if (!this.config.enableIpValidation) {
+                return {
+                    passed: true,
+                    originalUrl: url,
+                    hostname,
+                    resolvedIps: [hostname],
+                    safeIp: hostname
+                };
+            }
+            const ipValidation = ip_validator_1.IpValidator.validate(hostname, this.config.allowPrivateIp);
+            if (!ipValidation.valid) {
+                return {
+                    passed: false,
+                    originalUrl: url,
+                    hostname,
+                    resolvedIps: [hostname],
+                    reason: ipValidation.reason
+                };
+            }
+            return {
+                passed: true,
+                originalUrl: url,
+                hostname,
+                resolvedIps: [hostname],
+                safeIp: hostname
+            };
+        }
+        // 第三步：DNS 解析和验证
+        if (!this.config.enableDnsValidation) {
+            return {
+                passed: true,
+                originalUrl: url,
+                hostname
+            };
+        }
+        try {
+            const { dnsResult, allValid, invalidIps } = await this.dnsValidator.resolveAndValidate(hostname, this.config.allowPrivateIp);
+            if (!allValid) {
+                return {
+                    passed: false,
+                    originalUrl: url,
+                    hostname,
+                    resolvedIps: dnsResult.addresses,
+                    reason: `DNS resolved to unsafe IP addresses: ${invalidIps.join(', ')}`
+                };
+            }
+            // 选择第一个有效的 IP 地址
+            const safeIp = dnsResult.addresses[0];
+            return {
+                passed: true,
+                originalUrl: url,
+                hostname,
+                resolvedIps: dnsResult.addresses,
+                safeIp
+            };
+        }
+        catch (error) {
+            return {
+                passed: false,
+                originalUrl: url,
+                hostname,
+                reason: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+    /**
+     * 验证并返回安全的 URL
+     * @param url 要验证的 URL
+     * @returns 安全的 URL 和验证结果
+     * @throws {SecurityError} 验证失败时抛出错误
+     */
+    async validateAndGetSafeUrl(url) {
+        const result = await this.validate(url);
+        if (!result.passed) {
+            throw new types_1.SecurityError(result.reason || 'URL validation failed', 'SSRF_VALIDATION_FAILED', url);
+        }
+        return {
+            safeUrl: url,
+            result
+        };
+    }
+    /**
+     * 更新配置
+     * @param config 新的安全配置
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+        // 如果 DNS 缓存配置变更，需要重新创建 DNS 验证器
+        if (config.dnsCacheTtl !== undefined || config.dnsCacheMaxSize !== undefined) {
+            this.dnsValidator = new dns_validator_1.DnsValidator(this.config.dnsCacheTtl, undefined, this.config.dnsCacheMaxSize);
+        }
+        if (config.whitelist !== undefined || config.blacklist !== undefined) {
+            this.urlValidator = new url_validator_1.UrlValidator(config.whitelist ?? this.config.whitelist, config.blacklist ?? this.config.blacklist);
+        }
+    }
+    /**
+     * 清空 DNS 缓存
+     */
+    clearDnsCache() {
+        this.dnsValidator.clearCache();
+    }
+    /**
+     * 获取 DNS 缓存大小
+     * @returns 缓存条目数量
+     */
+    getDnsCacheSize() {
+        return this.dnsValidator.getCacheSize();
+    }
+    /**
+     * 清理过期的 DNS 缓存
+     */
+    cleanExpiredDnsCache() {
+        this.dnsValidator.cleanExpiredCache();
+    }
+    /**
+     * 获取当前配置
+     * @returns 安全配置副本
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.SsrfGuard = SsrfGuard;
+//# sourceMappingURL=ssrf.guard.js.map

package/dist/cjs/security/ssrf.guard.js.map

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