nstarter-http-request 0.1.0

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

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * URL 验证器
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UrlValidator = void 0;
+const node_url_1 = require("node:url");
+const utils_1 = require("../utils");
+/**
+ * URL 验证器类
+ */
+class UrlValidator {
+    constructor(whitelist = [], blacklist = []) {
+        this.whitelist = whitelist;
+        this.blacklist = blacklist;
+        // 预生成正则表达式，提高匹配性能和安全性
+        this.whitelistRegexps = utils_1.DomainUtils.createDomainMatchers(whitelist);
+        this.blacklistRegexps = utils_1.DomainUtils.createDomainMatchers(blacklist);
+    }
+    /**
+     * 验证 URL
+     * @param url URL 字符串
+     * @returns 验证结果
+     */
+    validate(url) {
+        let parsedUrl;
+        try {
+            parsedUrl = new node_url_1.URL(url);
+        }
+        catch {
+            return {
+                valid: false,
+                url,
+                inWhitelist: false,
+                inBlacklist: false,
+                reason: 'Invalid URL format'
+            };
+        }
+        // 只允许 http 和 https 协议
+        if (parsedUrl.protocol !== 'http:' && parsedUrl.protocol !== 'https:') {
+            return {
+                valid: false,
+                url,
+                inWhitelist: false,
+                inBlacklist: false,
+                reason: `Protocol ${parsedUrl.protocol} is not allowed. Only http and https are supported.`
+            };
+        }
+        const hostname = parsedUrl.hostname;
+        // 检查白名单（使用预生成的正则表达式）
+        const inWhitelist = this.matchesAny(hostname, this.whitelistRegexps);
+        // 检查黑名单（使用预生成的正则表达式）
+        const inBlacklist = this.matchesAny(hostname, this.blacklistRegexps);
+        // 配了白名单, 优先使用白名单模式, 在名单内的域名通过, 其余拒绝.
+        // 同时配有黑名单, 黑名单辅助拒绝其余通过的域名.
+        if (this.whitelist.length > 0 && !inWhitelist) {
+            return {
+                valid: false,
+                url,
+                inWhitelist,
+                inBlacklist,
+                reason: 'Domain is not in whitelist'
+            };
+        }
+        // 配了黑名单, 使用黑名单模式, 在黑名单内的域名拒绝, 其余通过.
+        if (this.blacklist.length > 0 && inBlacklist) {
+            return {
+                valid: false,
+                url,
+                inWhitelist,
+                inBlacklist,
+                reason: 'Domain is in blacklist'
+            };
+        }
+        // 黑白名单没配的, 默认通过.
+        return {
+            valid: true,
+            url,
+            inWhitelist,
+            inBlacklist
+        };
+    }
+    /**
+     * 检查域名是否匹配任一模式（使用预生成的正则表达式）
+     * @param hostname 域名
+     * @param regexps 正则表达式列表
+     * @returns 是否匹配
+     */
+    matchesAny(hostname, regexps) {
+        return regexps.some(regex => regex.test(hostname));
+    }
+    /**
+     * 更新白名单
+     * @param whitelist 新的白名单
+     */
+    setWhitelist(whitelist) {
+        this.whitelist = whitelist;
+        this.whitelistRegexps = utils_1.DomainUtils.createDomainMatchers(whitelist);
+    }
+    /**
+     * 更新黑名单
+     * @param blacklist 新的黑名单
+     */
+    setBlacklist(blacklist) {
+        this.blacklist = blacklist;
+        this.blacklistRegexps = utils_1.DomainUtils.createDomainMatchers(blacklist);
+    }
+    /**
+     * 添加到白名单
+     * @param patterns 要添加的模式
+     */
+    addToWhitelist(...patterns) {
+        this.whitelist.push(...patterns);
+        this.whitelistRegexps = utils_1.DomainUtils.createDomainMatchers(this.whitelist);
+    }
+    /**
+     * 添加到黑名单
+     * @param patterns 要添加的模式
+     */
+    addToBlacklist(...patterns) {
+        this.blacklist.push(...patterns);
+        this.blacklistRegexps = utils_1.DomainUtils.createDomainMatchers(this.blacklist);
+    }
+    /**
+     * 从白名单移除
+     * @param patterns 要移除的模式
+     */
+    removeFromWhitelist(...patterns) {
+        this.whitelist = this.whitelist.filter(p => !patterns.includes(p));
+        this.whitelistRegexps = utils_1.DomainUtils.createDomainMatchers(this.whitelist);
+    }
+    /**
+     * 从黑名单移除
+     * @param patterns 要移除的模式
+     */
+    removeFromBlacklist(...patterns) {
+        this.blacklist = this.blacklist.filter(p => !patterns.includes(p));
+        this.blacklistRegexps = utils_1.DomainUtils.createDomainMatchers(this.blacklist);
+    }
+    /**
+     * 获取白名单
+     * @returns 白名单副本
+     */
+    getWhitelist() {
+        return [...this.whitelist];
+    }
+    /**
+     * 获取黑名单
+     * @returns 黑名单副本
+     */
+    getBlacklist() {
+        return [...this.blacklist];
+    }
+    /**
+     * 清空白名单
+     */
+    clearWhitelist() {
+        this.whitelist = [];
+        this.whitelistRegexps = [];
+    }
+    /**
+     * 清空黑名单
+     */
+    clearBlacklist() {
+        this.blacklist = [];
+        this.blacklistRegexps = [];
+    }
+}
+exports.UrlValidator = UrlValidator;
+//# sourceMappingURL=url.validator.js.map

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

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

package/dist/cjs/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../../src/client.ts","../../src/config.ts","../../src/index.ts","../../src/adapter/axios.adapter.ts","../../src/adapter/base.ts","../../src/adapter/index.ts","../../src/adapter/undici.adapter.ts","../../src/const/config.const.ts","../../src/const/dns.const.ts","../../src/const/enum.const.ts","../../src/const/index.ts","../../src/const/ip.const.ts","../../src/logger/base.ts","../../src/logger/http_client.logger.ts","../../src/logger/index.ts","../../src/logger/log.filter.ts","../../src/security/dns.validator.ts","../../src/security/index.ts","../../src/security/ip.validator.ts","../../src/security/ssrf.guard.ts","../../src/security/url.validator.ts","../../src/types/adapter.ts","../../src/types/client.ts","../../src/types/config.ts","../../src/types/errors.ts","../../src/types/index.ts","../../src/types/ip.ts","../../src/types/logger.ts","../../src/types/request_response.ts","../../src/types/security.ts","../../src/types/trace.ts","../../src/utils/common.ts","../../src/utils/domain.ts","../../src/utils/index.ts","../../src/utils/ip.range.ts","../../src/utils/trace.context.ts"],"version":"5.9.3"}

package/dist/cjs/types/adapter.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 适配器相关类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=adapter.js.map

package/dist/cjs/types/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/types/adapter.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/types/client.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 客户端相关类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=client.js.map

package/dist/cjs/types/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/types/client.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/types/config.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 配置相关类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist/cjs/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/types/config.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/types/errors.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * 错误类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecurityError = exports.HttpError = void 0;
+/**
+ * HTTP 错误
+ */
+class HttpError extends Error {
+    constructor(message, code, status, response, request) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.response = response;
+        this.request = request;
+        this.name = 'HttpError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.HttpError = HttpError;
+/**
+ * 安全验证错误
+ */
+class SecurityError extends Error {
+    constructor(message, code, url) {
+        super(message);
+        this.code = code;
+        this.url = url;
+        this.name = 'SecurityError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.SecurityError = SecurityError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH;;GAEG;AACH,MAAa,SAAU,SAAQ,KAAK;IAChC,YACI,OAAe,EACC,IAAY,EACZ,MAAe,EACf,QAAuB,EACvB,OAA4B;QAE5C,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAS;QACf,aAAQ,GAAR,QAAQ,CAAe;QACvB,YAAO,GAAP,OAAO,CAAqB;QAG5C,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;CACJ;AAZD,8BAYC;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IACpC,YACI,OAAe,EACC,IAAY,EACZ,GAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,QAAG,GAAH,GAAG,CAAS;QAG5B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;CACJ;AAVD,sCAUC"}

package/dist/cjs/types/index.js

@@ -0,0 +1,35 @@
+"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("./request_response"), exports);
+// 配置相关
+__exportStar(require("./config"), exports);
+// 错误类
+__exportStar(require("./errors"), exports);
+// 安全和验证
+__exportStar(require("./security"), exports);
+// IP 相关
+__exportStar(require("./ip"), exports);
+// 日志相关
+__exportStar(require("./logger"), exports);
+// 适配器相关
+__exportStar(require("./adapter"), exports);
+// 客户端相关
+__exportStar(require("./client"), exports);
+// trace 相关
+__exportStar(require("./trace"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,qDAAmC;AAEnC,OAAO;AACP,2CAAyB;AAEzB,MAAM;AACN,2CAAyB;AAEzB,QAAQ;AACR,6CAA2B;AAE3B,QAAQ;AACR,uCAAqB;AAErB,OAAO;AACP,2CAAyB;AAEzB,QAAQ;AACR,4CAA0B;AAE1B,QAAQ;AACR,2CAAyB;AAEzB,WAAW;AACX,0CAAwB"}

package/dist/cjs/types/ip.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * IP 相关类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ip.js.map

package/dist/cjs/types/ip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip.js","sourceRoot":"","sources":["../../../src/types/ip.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/types/logger.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 日志相关类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=logger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/types/logger.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/types/request_response.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 请求和响应类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=request_response.js.map

package/dist/cjs/types/request_response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request_response.js","sourceRoot":"","sources":["../../../src/types/request_response.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/types/security.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 安全和验证相关类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=security.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../../src/types/security.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/types/trace.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceFlags = void 0;
+/**
+ * Trace 标志位
+ */
+var TraceFlags;
+(function (TraceFlags) {
+    /** 未采样 */
+    TraceFlags[TraceFlags["NONE"] = 0] = "NONE";
+    /** 已采样 */
+    TraceFlags[TraceFlags["SAMPLED"] = 1] = "SAMPLED";
+})(TraceFlags || (exports.TraceFlags = TraceFlags = {}));
+//# sourceMappingURL=trace.js.map

package/dist/cjs/types/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/types/trace.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,UAKX;AALD,WAAY,UAAU;IAClB,UAAU;IACV,2CAAW,CAAA;IACX,UAAU;IACV,iDAAc,CAAA;AAClB,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB"}

package/dist/cjs/utils/common.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delay = delay;
+exports.withTimeout = withTimeout;
+/**
+ * 延迟函数
+ * @param ms 延迟毫秒数
+ */
+function delay(ms) {
+    return new Promise(resolve => {
+        setTimeout(resolve, ms);
+    });
+}
+/**
+ * 超时函数
+ * @param promise 原始 Promise
+ * @param ms 超时毫秒数
+ * @param message 超时错误消息
+ * @returns 超时后的 Promise
+ */
+function withTimeout(promise, ms, message = 'Operation timed out') {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(message));
+        }, ms);
+        promise
+            .then(resolve, reject)
+            .finally(() => clearTimeout(timer));
+    });
+}
+//# sourceMappingURL=common.js.map

package/dist/cjs/utils/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/utils/common.ts"],"names":[],"mappings":";;AAIA,sBAIC;AASD,kCAUC;AA3BD;;;GAGG;AACH,SAAgB,KAAK,CAAC,EAAU;IAC5B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QACzB,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,WAAW,CAAI,OAAmB,EAAE,EAAU,EAAE,OAAO,GAAG,qBAAqB;IAC3F,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/B,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,OAAO;aACF,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;aACrB,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cjs/utils/domain.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLegacyDomainMatchers = exports.createDomainMatchers = void 0;
+const escape_string_regexp_1 = __importDefault(require("escape-string-regexp"));
+/**
+ * 根据域名模式列表生成正则表达式数组（通配符模式）
+ * 支持规则：
+ *  1. 通配符匹配 eg `*.example.com`（只匹配一级子域名，不包括根域名和多级子域名）
+ *  2. 精确匹配 eg `example.com`（仅匹配指定域名）
+ *
+ * @param patterns 域名模式列表
+ * @returns 正则表达式数组
+ *
+ * @example
+ * ```typescript
+ * const regexps = createDomainMatchers(['example.com', '*.example.com']);
+ * regexps[0].test('example.com');          // true - 精确匹配
+ * regexps[1].test('api.example.com');      // true - 通配符匹配一级子域名
+ * regexps[1].test('test.api.example.com'); // false - 不匹配多级子域名
+ * regexps[1].test('example.com');          // false - 不匹配根域名
+ * ```
+ */
+const createDomainMatchers = (patterns) => {
+    return patterns.map((pattern) => {
+        const trimmedPattern = pattern.trim();
+        // 通配符模式：*.example.com
+        // 只匹配一级子域名（如 api.example.com, www.example.com）
+        // 不匹配根域名（example.com）和多级子域名（test.api.example.com）
+        if (trimmedPattern.startsWith('*.')) {
+            const domain = trimmedPattern.slice(2); // 移除 *. 前缀
+            const escapedDomain = (0, escape_string_regexp_1.default)(domain);
+            // 匹配：一个或多个非点字符（一级子域名）+ 点 + 域名
+            return new RegExp(`^[^.]+\\.${escapedDomain}$`, 'i');
+        }
+        // 精确匹配：example.com
+        // 仅匹配指定的域名
+        const escapedPattern = (0, escape_string_regexp_1.default)(trimmedPattern);
+        return new RegExp(`^${escapedPattern}$`, 'i');
+    });
+};
+exports.createDomainMatchers = createDomainMatchers;
+/**
+ * 根据域名模式列表生成正则表达式数组（传统模式，用于正向代理等场景）
+ * @TODO 需要存量用户跑完正向代理兼容后切换到通配符模式.
+ * 支持规则：
+ *  1. 完全匹配 eg `www.example.com`
+ *  2. 后缀匹配 eg `.example.com`（匹配所有子域名）
+ *  3. 前缀匹配 eg `172.168.0.`（主要用于 IP 地址匹配）
+ *
+ * @param patterns 域名模式列表
+ * @returns 正则表达式数组
+ *
+ * @example
+ * ```typescript
+ * const regexps = createLegacyDomainMatchers(['example.com', '.example.com']);
+ * regexps[0].test('example.com');  // true - 完全匹配
+ * regexps[1].test('api.example.com');  // true - 后缀匹配
+ * ```
+ */
+const createLegacyDomainMatchers = (patterns) => {
+    return patterns.map((pattern) => {
+        const lowerPattern = pattern.toLowerCase();
+        // 以 . 开头，生成后缀匹配正则（如 .example.com 匹配所有子域名）
+        if (lowerPattern.startsWith('.')) {
+            return new RegExp(`${(0, escape_string_regexp_1.default)(pattern)}$`, 'i');
+        }
+        // 以 . 结尾，生成前缀匹配正则（如 172.168.0. 匹配 172.168.0.x）
+        if (lowerPattern.endsWith('.')) {
+            return new RegExp(`^${(0, escape_string_regexp_1.default)(pattern)}`, 'i');
+        }
+        // 字符串完全匹配
+        return new RegExp(`^${(0, escape_string_regexp_1.default)(pattern)}$`, 'i');
+    });
+};
+exports.createLegacyDomainMatchers = createLegacyDomainMatchers;
+//# sourceMappingURL=domain.js.map

package/dist/cjs/utils/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../../src/utils/domain.ts"],"names":[],"mappings":";;;;;;AAAA,gFAAgD;AAEhD;;;;;;;;;;;;;;;;;GAiBG;AACI,MAAM,oBAAoB,GAAG,CAAC,QAAkB,EAAY,EAAE;IACjE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC5B,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAEtC,sBAAsB;QACtB,+CAA+C;QAC/C,kDAAkD;QAClD,IAAI,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW;YACnD,MAAM,aAAa,GAAG,IAAA,8BAAY,EAAC,MAAM,CAAC,CAAC;YAC3C,8BAA8B;YAC9B,OAAO,IAAI,MAAM,CAAC,YAAa,aAAc,GAAG,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC;QAED,mBAAmB;QACnB,WAAW;QACX,MAAM,cAAc,GAAG,IAAA,8BAAY,EAAC,cAAc,CAAC,CAAC;QACpD,OAAO,IAAI,MAAM,CAAC,IAAK,cAAe,GAAG,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAnBW,QAAA,oBAAoB,wBAmB/B;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACI,MAAM,0BAA0B,GAAG,CAAC,QAAkB,EAAY,EAAE;IACvE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAE3C,0CAA0C;QAC1C,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,MAAM,CAAC,GAAI,IAAA,8BAAY,EAAC,OAAO,CAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC1D,CAAC;QAED,+CAA+C;QAC/C,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,MAAM,CAAC,IAAK,IAAA,8BAAY,EAAC,OAAO,CAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QAC1D,CAAC;QAED,UAAU;QACV,OAAO,IAAI,MAAM,CAAC,IAAK,IAAA,8BAAY,EAAC,OAAO,CAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAjBW,QAAA,0BAA0B,8BAiBrC"}

package/dist/cjs/utils/index.js

@@ -0,0 +1,44 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceContext = exports.TraceContextUtils = exports.DomainUtils = exports.CommonUtils = exports.IpRangeUtils = void 0;
+exports.IpRangeUtils = __importStar(require("./ip.range"));
+exports.CommonUtils = __importStar(require("./common"));
+exports.DomainUtils = __importStar(require("./domain"));
+exports.TraceContextUtils = __importStar(require("./trace.context"));
+// 导出 TraceContext 类供外部直接使用
+var trace_context_1 = require("./trace.context");
+Object.defineProperty(exports, "TraceContext", { enumerable: true, get: function () { return trace_context_1.TraceContext; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2DAA2C;AAC3C,wDAAwC;AACxC,wDAAwC;AACxC,qEAAqD;AAErD,2BAA2B;AAC3B,iDAA+C;AAAtC,6GAAA,YAAY,OAAA"}