@nest-omni/core 4.1.3-25 → 4.1.3-27

package/http-client/services/logging.service.js

@@ -25,6 +25,7 @@ const http_log_entity_1 = require("../entities/http-log.entity");
 const request_id_util_1 = require("../utils/request-id.util");
 const context_extractor_util_1 = require("../utils/context-extractor.util");
 const call_stack_extractor_util_1 = require("../utils/call-stack-extractor.util");
+const sanitize_util_1 = require("../utils/sanitize.util");
 const transaction_1 = require("@nest-omni/transaction");
 /**
  * HTTP日志服务
@@ -61,13 +62,15 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
     }
     initRepository(dataSource, tableName) {
         try {
-            this.logRepository = (0, transaction_1.getDataSource)(dataSource).getRepository(http_log_entity_1.HttpLogEntity);
+            this.logRepository =
+                (0, transaction_1.getDataSource)(dataSource).getRepository(http_log_entity_1.HttpLogEntity);
             this.logger.log('Database logging initialized');
             return this.logRepository;
         }
         catch (error) {
-            this.logger.error('Failed to initialize database logging', error);
-            throw error;
+            this.logger.warn('Database logging not available, continuing without it');
+            this.logRepository = null;
+            return null;
         }
     }
     /**
@@ -77,16 +80,16 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
         // 从ContextProvider获取上下文信息
         const context = context_extractor_util_1.ContextExtractor.getHttpContext();
         const actualRequestId = requestId || context.requestId || (0, request_id_util_1.generateRequestId)();
-        const { logHeaders = true, logBody = true, sanitizeHeaders = [], } = loggingOptions || {};
+        const { logHeaders = true, logBody = true, sanitize = [], } = loggingOptions || {};
         const logData = {
             requestId: actualRequestId,
             userId: context.userId,
-            method: config.method ? config.method.toUpperCase() : 'GET',
-            url: config.url,
-            headers: logHeaders
-                ? this.sanitizeHeaders(config.headers, sanitizeHeaders)
+            method: (config === null || config === void 0 ? void 0 : config.method) ? config.method.toUpperCase() : 'GET',
+            url: config ? sanitize_util_1.SanitizeUtil.sanitizeQueryString(config.url, sanitize) : '',
+            headers: logHeaders && config
+                ? sanitize_util_1.SanitizeUtil.sanitizeHeaders(config.headers, sanitize)
                 : undefined,
-            body: logBody ? this.sanitizeBody(config.data) : undefined,
+            body: logBody && config ? sanitize_util_1.SanitizeUtil.sanitizeBody(config.data, sanitize) : undefined,
             clientIp: context.clientIp,
             serviceName: context.appId,
         };
@@ -107,8 +110,8 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
      */
     logRequestSuccess(response_1, startTime_1, requestId_1, loggingOptions_1) {
         return __awaiter(this, arguments, void 0, function* (response, startTime, requestId, loggingOptions, databaseLogging = false, retryRecords, circuitBreakerState, decoratorContext, clientName, callingContext) {
-            var _a, _b, _c, _d;
-            const { logHeaders = true, logBody = true, sanitizeHeaders = [], } = loggingOptions || {};
+            var _a, _b, _c, _d, _e, _f;
+            const { logHeaders = true, logBody = true, sanitize = [], } = loggingOptions || {};
             const responseTime = Date.now() - startTime;
             // 获取当前上下文信息
             const context = context_extractor_util_1.ContextExtractor.getHttpContext();
@@ -118,9 +121,9 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
                 statusCode: response.status,
                 responseTime,
                 headers: logHeaders
-                    ? this.sanitizeHeaders(response.headers, sanitizeHeaders)
+                    ? sanitize_util_1.SanitizeUtil.sanitizeHeaders(response.headers, sanitize)
                     : undefined,
-                body: logBody ? this.sanitizeBody(response.data) : undefined,
+                body: logBody ? sanitize_util_1.SanitizeUtil.sanitizeBody(response.data, sanitize) : undefined,
                 responseSize: JSON.stringify(response.data).length,
                 circuitBreakerState,
             };
@@ -139,7 +142,7 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
                     dataSource: (_a = loggingOptions.databaseLogging) === null || _a === void 0 ? void 0 : _a.dataSource,
                     tableName: (_b = loggingOptions.databaseLogging) === null || _b === void 0 ? void 0 : _b.tableName,
                 });
-                this.initRepository(loggingOptions.databaseLogging.dataSource, loggingOptions.databaseLogging.tableName);
+                this.initRepository(((_c = loggingOptions.databaseLogging) === null || _c === void 0 ? void 0 : _c.dataSource) || 'default', ((_d = loggingOptions.databaseLogging) === null || _d === void 0 ? void 0 : _d.tableName) || 'http_log');
             }
             // 数据库日志记录
             if (databaseLogging && this.logRepository) {
@@ -156,25 +159,25 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
                 this.saveToDatabase({
                     requestId,
                     userId: context.userId,
-                    method: ((_c = response.config.method) === null || _c === void 0 ? void 0 : _c.toUpperCase()) || 'UNKNOWN',
-                    url: this.getFullUrl(response.config) || '',
-                    headers: this.sanitizeHeaders(response.config.headers, sanitizeHeaders),
-                    body: this.sanitizeBodyAsString(response.config.data),
-                    params: response.config.params,
+                    method: ((_e = response.config.method) === null || _e === void 0 ? void 0 : _e.toUpperCase()) || 'UNKNOWN',
+                    url: sanitize_util_1.SanitizeUtil.sanitizeQueryString(this.getFullUrl(response.config), sanitize),
+                    headers: sanitize_util_1.SanitizeUtil.sanitizeHeaders(response.config.headers, sanitize),
+                    body: sanitize_util_1.SanitizeUtil.sanitizeBodyAsString(response.config.data, sanitize),
+                    params: sanitize_util_1.SanitizeUtil.sanitizeParams(response.config.params, sanitize),
                     statusCode: response.status,
                     responseTime,
                     attemptCount: (retryRecords === null || retryRecords === void 0 ? void 0 : retryRecords.length)
                         ? Math.max(...retryRecords.map((r) => r.attempt)) + 1
                         : 1,
                     success: true,
-                    responseHeaders: this.sanitizeHeaders(response.headers, sanitizeHeaders),
+                    responseHeaders: sanitize_util_1.SanitizeUtil.sanitizeHeaders(response.headers, sanitize),
                     responseBody: logBody
-                        ? this.sanitizeBodyAsString(response.data)
+                        ? sanitize_util_1.SanitizeUtil.sanitizeBodyAsString(response.data, sanitize)
                         : undefined,
                     serviceName: clientName || context.appId,
                     operationName: callInfo.operationName,
                     clientIp: context.clientIp,
-                    source: (_d = context.metadata) === null || _d === void 0 ? void 0 : _d.source,
+                    source: (_f = context.metadata) === null || _f === void 0 ? void 0 : _f.source,
                     tags: context.tags,
                     metadata: logData,
                     retryRecords,
@@ -187,8 +190,8 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
      * 记录请求错误
      */
     logRequestError(error, startTime, requestId, attemptCount, loggingOptions, databaseLogging = false, retryRecords, circuitBreakerState, decoratorContext, clientName, callingContext) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-        const { logHeaders = true, sanitizeHeaders = [] } = loggingOptions;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+        const { logHeaders = true, sanitize = [] } = loggingOptions;
         const responseTime = Date.now() - startTime;
         // 获取当前上下文信息
         const context = context_extractor_util_1.ContextExtractor.getHttpContext();
@@ -202,7 +205,7 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
             errorCode: error.code,
             statusCode: (_a = error.response) === null || _a === void 0 ? void 0 : _a.status,
             headers: ((_b = error.config) === null || _b === void 0 ? void 0 : _b.headers) && logHeaders
-                ? this.sanitizeHeaders(error.config.headers, sanitizeHeaders)
+                ? sanitize_util_1.SanitizeUtil.sanitizeHeaders(error.config.headers, sanitize)
                 : undefined,
             circuitBreakerState,
         };
@@ -222,7 +225,7 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
                 break;
         }
         if (!this.logRepository) {
-            this.initRepository(loggingOptions.databaseLogging.dataSource, loggingOptions.databaseLogging.tableName);
+            this.initRepository(((_c = loggingOptions.databaseLogging) === null || _c === void 0 ? void 0 : _c.dataSource) || 'default', ((_d = loggingOptions.databaseLogging) === null || _d === void 0 ? void 0 : _d.tableName) || 'http_log');
         }
         // 数据库日志记录
         if (databaseLogging && this.logRepository) {
@@ -233,14 +236,14 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
             this.saveToDatabase({
                 requestId,
                 userId: context.userId,
-                method: ((_d = (_c = error.config) === null || _c === void 0 ? void 0 : _c.method) === null || _d === void 0 ? void 0 : _d.toUpperCase()) || 'UNKNOWN',
-                url: this.getFullUrl(error.config) || '',
-                headers: ((_e = error.config) === null || _e === void 0 ? void 0 : _e.headers)
-                    ? this.sanitizeHeaders(error.config.headers, sanitizeHeaders)
+                method: ((_f = (_e = error.config) === null || _e === void 0 ? void 0 : _e.method) === null || _f === void 0 ? void 0 : _f.toUpperCase()) || 'UNKNOWN',
+                url: sanitize_util_1.SanitizeUtil.sanitizeQueryString(this.getFullUrl(error.config), sanitize),
+                headers: ((_g = error.config) === null || _g === void 0 ? void 0 : _g.headers)
+                    ? sanitize_util_1.SanitizeUtil.sanitizeHeaders(error.config.headers, sanitize)
                     : {},
-                body: this.sanitizeBodyAsString((_f = error.config) === null || _f === void 0 ? void 0 : _f.data),
-                params: (_g = error.config) === null || _g === void 0 ? void 0 : _g.params,
-                statusCode: (_h = error.response) === null || _h === void 0 ? void 0 : _h.status,
+                body: sanitize_util_1.SanitizeUtil.sanitizeBodyAsString((_h = error.config) === null || _h === void 0 ? void 0 : _h.data, sanitize),
+                params: sanitize_util_1.SanitizeUtil.sanitizeParams((_j = error.config) === null || _j === void 0 ? void 0 : _j.params, sanitize),
+                statusCode: (_k = error.response) === null || _k === void 0 ? void 0 : _k.status,
                 responseTime,
                 attemptCount,
                 success: false,
@@ -250,7 +253,7 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
                 serviceName: clientName || context.appId,
                 operationName: callInfo.operationName,
                 clientIp: context.clientIp,
-                source: (_j = context.metadata) === null || _j === void 0 ? void 0 : _j.source,
+                source: (_l = context.metadata) === null || _l === void 0 ? void 0 : _l.source,
                 tags: context.tags,
                 metadata: logData,
                 retryRecords,
@@ -374,6 +377,50 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
             };
         });
     }
+    /**
+     * 获取日志队列统计信息
+     */
+    getQueueStats() {
+        return {
+            queueSize: this.logQueue.length,
+            isProcessing: this.isProcessing,
+            config: Object.assign({}, this.asyncConfig),
+        };
+    }
+    /**
+     * 手动刷新日志队列
+     */
+    manualFlush() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve) => {
+                const checkProcessing = () => {
+                    if (!this.isProcessing) {
+                        this.flush();
+                        // 等待刷新完成
+                        setTimeout(() => resolve(), 100);
+                    }
+                    else {
+                        setTimeout(checkProcessing, 50);
+                    }
+                };
+                checkProcessing();
+            });
+        });
+    }
+    /**
+     * 设置异步日志配置
+     */
+    setAsyncConfig(config) {
+        Object.assign(this.asyncConfig, config);
+        // 重启刷新任务
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+        }
+        if (this.asyncConfig.enabled) {
+            this.startFlushTask();
+        }
+        this.logger.log(`Async log config updated: ${JSON.stringify(this.asyncConfig)}`);
+    }
     /**
      * 提取调用信息
      */
@@ -536,141 +583,6 @@ let HttpLoggingService = HttpLoggingService_1 = class HttpLoggingService {
             }
         });
     }
-    /**
-     * 获取日志队列统计信息
-     */
-    getQueueStats() {
-        return {
-            queueSize: this.logQueue.length,
-            isProcessing: this.isProcessing,
-            config: Object.assign({}, this.asyncConfig),
-        };
-    }
-    /**
-     * 手动刷新日志队列
-     */
-    manualFlush() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return new Promise((resolve) => {
-                const checkProcessing = () => {
-                    if (!this.isProcessing) {
-                        this.flush();
-                        // 等待刷新完成
-                        setTimeout(() => resolve(), 100);
-                    }
-                    else {
-                        setTimeout(checkProcessing, 50);
-                    }
-                };
-                checkProcessing();
-            });
-        });
-    }
-    /**
-     * 设置异步日志配置
-     */
-    setAsyncConfig(config) {
-        Object.assign(this.asyncConfig, config);
-        // 重启刷新任务
-        if (this.flushTimer) {
-            clearInterval(this.flushTimer);
-        }
-        if (this.asyncConfig.enabled) {
-            this.startFlushTask();
-        }
-        this.logger.log(`Async log config updated: ${JSON.stringify(this.asyncConfig)}`);
-    }
-    /**
-     * 转换请求体为字符串
-     */
-    sanitizeBodyAsString(data) {
-        if (!data)
-            return undefined;
-        if (typeof data === 'string') {
-            return data.length > 5000 ? data.substring(0, 5000) + '...' : data;
-        }
-        const jsonString = JSON.stringify(data);
-        return jsonString.length > 5000
-            ? jsonString.substring(0, 5000) + '...'
-            : jsonString;
-    }
-    /**
-     * 清理敏感头信息
-     */
-    sanitizeHeaders(headers, sanitizeHeaders) {
-        if (!headers)
-            return {};
-        const sanitized = {};
-        const defaultSensitiveHeaders = [
-            'authorization',
-            'apikey',
-            'password',
-            'token',
-            'secret',
-            'cookie',
-            'set-cookie',
-            'x-api-key',
-            'x-auth-token',
-        ];
-        const headersToSanitize = [...defaultSensitiveHeaders, ...sanitizeHeaders];
-        Object.keys(headers).forEach((key) => {
-            if (headersToSanitize.some((sensitive) => key.toLowerCase().includes(sensitive.toLowerCase()))) {
-                sanitized[key] = '[FILTERED]';
-            }
-            else {
-                sanitized[key] = String(headers[key]);
-            }
-        });
-        return sanitized;
-    }
-    /**
-     * 清理敏感请求体信息
-     */
-    sanitizeBody(body) {
-        if (!body)
-            return undefined;
-        if (typeof body === 'string') {
-            try {
-                body = JSON.parse(body);
-            }
-            catch (_a) {
-                return body.length > 1000 ? body.substring(0, 1000) + '...' : body;
-            }
-        }
-        if (typeof body === 'object') {
-            const sanitized = Object.assign({}, body);
-            const sensitiveFields = [
-                'password',
-                'secret',
-                'token',
-                'key',
-                'authorization',
-                'credential',
-                'private',
-                'confidential',
-                'ssn',
-                'creditCard',
-            ];
-            this.sanitizeObject(sanitized, sensitiveFields);
-            return sanitized;
-        }
-        return body;
-    }
-    /**
-     * 递归清理对象中的敏感字段
-     */
-    sanitizeObject(obj, sensitiveFields) {
-        if (typeof obj !== 'object' || obj === null)
-            return;
-        for (const key in obj) {
-            if (sensitiveFields.some((field) => key.toLowerCase().includes(field.toLowerCase()))) {
-                obj[key] = '[FILTERED]';
-            }
-            else if (typeof obj[key] === 'object') {
-                this.sanitizeObject(obj[key], sensitiveFields);
-            }
-        }
-    }
     /**
      * 获取完整URL
      * @param config Axios请求配置

package/http-client/utils/curl-generator.util.js

@@ -137,13 +137,10 @@ class CurlGenerator {
                 config.url = urlMatch[1];
             }
             // 提取头信息
-            const headerMatches = curlCommand.match(/-H\s+'([^:]+):\s*([^']+)'/g) || [];
+            const headerMatches = Array.from(curlCommand.matchAll(/-H\s+'([^:]+):\s*([^']+)'/g));
             config.headers = {};
             headerMatches.forEach((header) => {
-                const headerMatch = header.match(/-H\s+'([^:]+):\s*([^']+)'/);
-                if (headerMatch) {
-                    config.headers[headerMatch[1]] = headerMatch[2];
-                }
+                config.headers[header[1]] = header[2];
             });
             // 提取数据
             const dataMatch = curlCommand.match(/-d\s+'([^']+)'/);

package/http-client/utils/index.d.ts

@@ -3,3 +3,4 @@ export * from './retry-recorder.util';
 export * from './context-extractor.util';
 export * from './call-stack-extractor.util';
 export * from './proxy-environment.util';
+export * from './sanitize.util';

package/http-client/utils/index.js

@@ -19,3 +19,4 @@ __exportStar(require("./retry-recorder.util"), exports);
 __exportStar(require("./context-extractor.util"), exports);
 __exportStar(require("./call-stack-extractor.util"), exports);
 __exportStar(require("./proxy-environment.util"), exports);
+__exportStar(require("./sanitize.util"), exports);

package/http-client/utils/proxy-environment.util.d.ts

@@ -12,6 +12,18 @@ export declare class ProxyEnvironmentParser {
      * @returns 解析后的代理配置，如果不应使用代理则返回 false
      */
     static parseFromEnvironment(protocol?: 'http' | 'https', targetUrl?: string): false | Required<Omit<ProxyConfig, 'enabled' | 'fromEnvironment'>>;
+    /**
+     * 获取所有代理相关的环境变量
+     */
+    static getProxyEnvironmentVariables(): {
+        HTTP_PROXY?: string;
+        HTTPS_PROXY?: string;
+        NO_PROXY?: string;
+    };
+    /**
+     * 检查是否设置了代理环境变量
+     */
+    static hasProxyEnvironment(): boolean;
     /**
      * 解析代理 URL
      * 支持格式: http://proxy:port, http://user:pass@proxy:port
@@ -27,16 +39,4 @@ export declare class ProxyEnvironmentParser {
      * 支持精确匹配和 CIDR 表示法
      */
     private static isIpMatch;
-    /**
-     * 获取所有代理相关的环境变量
-     */
-    static getProxyEnvironmentVariables(): {
-        HTTP_PROXY?: string;
-        HTTPS_PROXY?: string;
-        NO_PROXY?: string;
-    };
-    /**
-     * 检查是否设置了代理环境变量
-     */
-    static hasProxyEnvironment(): boolean;
 }

package/http-client/utils/proxy-environment.util.js

@@ -40,6 +40,23 @@ class ProxyEnvironmentParser {
             return false;
         }
     }
+    /**
+     * 获取所有代理相关的环境变量
+     */
+    static getProxyEnvironmentVariables() {
+        return {
+            HTTP_PROXY: process.env.HTTP_PROXY || process.env.http_proxy,
+            HTTPS_PROXY: process.env.HTTPS_PROXY || process.env.https_proxy,
+            NO_PROXY: process.env.NO_PROXY || process.env.no_proxy,
+        };
+    }
+    /**
+     * 检查是否设置了代理环境变量
+     */
+    static hasProxyEnvironment() {
+        const vars = this.getProxyEnvironmentVariables();
+        return !!(vars.HTTP_PROXY || vars.HTTPS_PROXY);
+    }
     /**
      * 解析代理 URL
      * 支持格式: http://proxy:port, http://user:pass@proxy:port
@@ -50,7 +67,11 @@ class ProxyEnvironmentParser {
             const config = {
                 protocol: url.protocol.replace(':', '') || 'http',
                 host: url.hostname,
-                port: url.port ? parseInt(url.port, 10) : url.protocol === 'https:' ? 443 : 80,
+                port: url.port
+                    ? parseInt(url.port, 10)
+                    : url.protocol === 'https:'
+                        ? 443
+                        : 80,
                 auth: undefined,
             };
             // 解析认证信息
@@ -79,7 +100,9 @@ class ProxyEnvironmentParser {
             const url = new URL(targetUrl);
             const hostname = url.hostname;
             // NO_PROXY 可以是逗号分隔的列表
-            const bypassList = noProxy.split(',').map((item) => item.trim().toLowerCase());
+            const bypassList = noProxy
+                .split(',')
+                .map((item) => item.trim().toLowerCase());
             for (const bypass of bypassList) {
                 if (!bypass)
                     continue;
@@ -126,23 +149,6 @@ class ProxyEnvironmentParser {
         }
         return false;
     }
-    /**
-     * 获取所有代理相关的环境变量
-     */
-    static getProxyEnvironmentVariables() {
-        return {
-            HTTP_PROXY: process.env.HTTP_PROXY || process.env.http_proxy,
-            HTTPS_PROXY: process.env.HTTPS_PROXY || process.env.https_proxy,
-            NO_PROXY: process.env.NO_PROXY || process.env.no_proxy,
-        };
-    }
-    /**
-     * 检查是否设置了代理环境变量
-     */
-    static hasProxyEnvironment() {
-        const vars = this.getProxyEnvironmentVariables();
-        return !!(vars.HTTP_PROXY || vars.HTTPS_PROXY);
-    }
 }
 exports.ProxyEnvironmentParser = ProxyEnvironmentParser;
 ProxyEnvironmentParser.logger = new common_1.Logger(ProxyEnvironmentParser.name);

package/http-client/utils/retry-recorder.util.d.ts

@@ -21,10 +21,6 @@ export declare class RetryRecorder {
      * 获取重试原因
      */
     private static getRetryReason;
-    /**
-     * 过滤敏感头信息
-     */
-    private static sanitizeHeaders;
     /**
      * 添加重试记录
      */

package/http-client/utils/retry-recorder.util.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RetryRecorder = void 0;
+const sanitize_util_1 = require("./sanitize.util");
 /**
  * 请求重试记录器
  */
@@ -22,7 +23,7 @@ class RetryRecorder {
             requestConfig: {
                 method: ((_a = config.method) === null || _a === void 0 ? void 0 : _a.toUpperCase()) || 'UNKNOWN',
                 url: config.url || '',
-                headers: this.sanitizeHeaders(config.headers || {}),
+                headers: sanitize_util_1.SanitizeUtil.sanitizeHeaders(config.headers || {}),
             },
         };
     }
@@ -83,32 +84,6 @@ class RetryRecorder {
         }
         return `HTTP error: ${status}`;
     }
-    /**
-     * 过滤敏感头信息
-     */
-    static sanitizeHeaders(headers) {
-        const sanitized = {};
-        const sensitiveKeys = [
-            'authorization',
-            'apikey',
-            'password',
-            'secret',
-            'token',
-            'x-api-key',
-            'x-auth-token',
-            'cookie',
-            'set-cookie',
-        ];
-        Object.entries(headers).forEach(([key, value]) => {
-            if (sensitiveKeys.some((sensitive) => key.toLowerCase().includes(sensitive))) {
-                sanitized[key] = '[FILTERED]';
-            }
-            else {
-                sanitized[key] = value;
-            }
-        });
-        return sanitized;
-    }
     /**
      * 添加重试记录
      */

package/http-client/utils/sanitize.util.d.ts

@@ -0,0 +1,58 @@
+/**
+ * HTTP 请求数据脱敏工具
+ * 统一处理 headers、body、query string 的敏感信息过滤
+ */
+export declare class SanitizeUtil {
+    /**
+     * 默认敏感字段列表
+     */
+    private static readonly DEFAULT_SENSITIVE_FIELDS;
+    /**
+     * 脱敏 headers
+     * @param headers - 原始 headers 对象
+     * @param sensitiveFields - 自定义敏感字段列表
+     * @returns 脱敏后的 headers
+     */
+    static sanitizeHeaders(headers: any, sensitiveFields?: string[]): Record<string, string>;
+    /**
+     * 脱敏 body
+     * @param body - 原始 body 数据
+     * @param sensitiveFields - 自定义敏感字段列表
+     * @returns 脱敏后的 body
+     */
+    static sanitizeBody(body: any, sensitiveFields?: string[]): any;
+    /**
+     * 脱敏 URL 中的 query string
+     * @param url - 原始 URL
+     * @param sensitiveFields - 自定义敏感字段列表
+     * @returns 脱敏后的 URL
+     */
+    static sanitizeQueryString(url: string, sensitiveFields?: string[]): string;
+    /**
+     * 脱敏 params 对象
+     * @param params - 原始 params 对象
+     * @param sensitiveFields - 自定义敏感字段列表
+     * @returns 脱敏后的 params
+     */
+    static sanitizeParams(params: Record<string, any>, sensitiveFields?: string[]): Record<string, any>;
+    /**
+     * 将 body 转换为字符串并脱敏
+     * @param data - 原始数据
+     * @param sensitiveFields - 自定义敏感字段列表
+     * @returns 脱敏后的字符串
+     */
+    static sanitizeBodyAsString(data: any, sensitiveFields?: string[]): string | undefined;
+    /**
+     * 判断字段是否为敏感字段
+     * @param key - 字段名
+     * @param sensitiveFields - 敏感字段列表
+     * @returns 是否为敏感字段
+     */
+    private static isSensitiveField;
+    /**
+     * 递归脱敏对象中的敏感字段
+     * @param obj - 目标对象
+     * @param sensitiveFields - 敏感字段列表
+     */
+    private static sanitizeObject;
+}