nstarter-http-request 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+* 0.1.0
+    * Initial release.
+

package/README.md

@@ -0,0 +1,160 @@
+# nstarter-http-request
+
+HTTP 请求客户端插件，提供 SSRF 防护、日志记录、正向代理等安全特性。
+
+## 核心特性
+
+- 🔒 **SSRF 防护**：DNS/IP 验证，阻止访问内网地址
+- 📝 **完善日志**：请求/响应日志记录与过滤
+- 🔄 **多适配器**：支持 Axios 和 Undici
+- 🌐 **代理支持**：HTTP/HTTPS 正向代理
+- ⚡ **重试机制**：可配置的请求重试策略
+- 🎯 **类型安全**：完整 TypeScript 类型支持
+
+## 包结构
+
+```
+plugin-http-request/
+├── src/                           # 源代码目录
+│   ├── adapter/                   # HTTP 适配器层
+│   │   ├── base.ts                # 适配器基类
+│   │   ├── axios.adapter.ts       # Axios 适配器实现
+│   │   └── undici.adapter.ts      # Undici 适配器实现
+│   ├── security/                  # 安全防护模块
+│   │   ├── ssrf.guard.ts          # SSRF 防护核心
+│   │   ├── dns.validator.ts       # DNS 验证器（域名解析）
+│   │   ├── ip.validator.ts        # IP 地址验证器（私有/保留IP检测）
+│   │   └── url.validator.ts       # URL 验证器（黑白名单）
+│   ├── logger/                    # 日志记录模块
+│   │   ├── base.ts                # 日志记录器基类和接口
+│   │   ├── console.logger.ts      # 控制台日志实现
+│   │   ├── http_client.logger.ts  # HTTP 客户端专用日志
+│   │   └── log.filter.ts          # 日志过滤器（按方法、URL、状态码等）
+│   ├── types/                     # TypeScript 类型定义
+│   │   ├── config.ts              # 配置相关类型
+│   │   ├── request_response.ts    # 请求/响应类型
+│   │   ├── security.ts            # 安全相关类型
+│   │   ├── logger.ts              # 日志相关类型
+│   │   ├── adapter.ts             # 适配器接口类型
+│   │   ├── client.ts              # 客户端接口类型
+│   │   ├── errors.ts              # 错误类型定义
+│   │   └── index.ts               # 类型统一导出
+│   ├── utils/                     # 工具函数集
+│   │   ├── domain.matcher.ts      # 域名匹配工具（支持完全匹配、后缀匹配）
+│   │   ├── ip.range.ts            # IP 范围解析工具（CIDR 支持）
+│   │   └── common.ts              # 通用工具函数
+│   ├── const/                     # 常量定义
+│   │   ├── config.const.ts        # 默认配置常量
+│   │   ├── enum.const.ts          # 枚举常量（适配器类型、日志级别）
+│   │   └── ip.const.ts            # IP 相关常量（私有IP段、保留IP段）
+│   ├── client.ts                  # HTTP 客户端核心类（NsHttpClient）
+│   ├── config.ts                  # 配置合并与验证
+│   └── index.ts                   # 主入口文件
+├── test/                          # 测试文件目录
+│   ├── adapter/                   # 适配器测试
+│   ├── security/                  # 安全模块测试
+│   ├── logger/                    # 日志模块测试
+│   ├── utils/                     # 工具函数测试
+│   ├── integration/               # 集成测试
+│   ├── client.test.ts             # 客户端测试
+│   └── config.test.ts             # 配置测试
+└── dist/                          # 构建输出目录
+    ├── cjs/                       # CommonJS 格式（Node.js require）
+    ├── esm/                       # ES Module 格式（import）
+    └── types/                     # TypeScript 类型声明文件
+```
+
+### 核心模块说明
+
+- **client.ts** - 提供统一的 HTTP 客户端接口，整合适配器、安全防护、日志等功能
+- **adapter/** - 适配器模式实现，支持多种 HTTP 库（Axios、Undici），可扩展
+- **security/** - SSRF 防护核心，包含 DNS 解析、IP 验证、URL 黑白名单等安全检查
+- **logger/** - 可配置的日志系统，支持请求/响应记录、敏感信息过滤、条件日志
+- **utils/** - 工具集，包含域名匹配工具（黑白名单、no_proxy）、IP 段解析（CIDR）等辅助功能
+- **types/** - 完整的 TypeScript 类型定义，确保类型安全
+
+## 本地开发
+
+```bash
+# 在项目根目录安装依赖
+npm install
+
+# 构建此包（在根目录执行）
+nx build nstarter-http-request
+
+# 运行测试（在根目录执行）
+nx test nstarter-http-request
+
+# 代码检查（在根目录执行）
+nx eslint nstarter-http-request
+
+# 清理构建产物（在根目录执行）
+nx run nstarter-http-request:clean
+
+# 构建所有包
+nx run-many -t build
+
+# 测试所有包
+nx run-many -t test
+```
+
+## 快速开始
+
+### 基础使用
+
+```typescript
+import { NsHttpClient, EClientAdapter } from 'nstarter-http-request';
+
+// 创建客户端实例
+const client = new NsHttpClient({
+  adapter: EClientAdapter.axios,
+  security: {
+    enableDnsValidation: true,
+    enableIpValidation: true,
+    allowPrivateIp: false
+  }
+});
+
+// GET 请求
+const response = await client.get('https://api.example.com/users');
+
+// POST 请求
+const user = await client.post('https://api.example.com/users', {
+  name: 'John',
+  email: 'john@example.com'
+});
+```
+
+### 完整配置示例
+
+详细配置说明请参考 [配置文档](./docs/configuration.md)
+
+```typescript
+import { NsHttpClient, EClientAdapter } from 'nstarter-http-request';
+
+const client = new NsHttpClient({
+  adapter: EClientAdapter.axios,
+  security: {
+    enableDnsValidation: true,
+    enableIpValidation: true,
+    allowPrivateIp: false
+  },
+  logging: {
+    enabled: true
+  },
+  request: {
+    timeout: 30000,
+    retries: 3
+  }
+});
+```
+
+## 详细文档
+
+- [完整配置示例](./docs/configuration.md) - 所有配置选项的详细说明
+- [安全配置](./docs/security.md) - SSRF 防护、SSL 验证、域名黑白名单等安全特性
+- [日志配置](./docs/logging.md) - 日志记录、过滤、自定义日志器等
+- [正向代理配置](./docs/proxy.md) - HTTP/HTTPS 正向代理和 no_proxy 配置
+- [适配器切换](./docs/adapters.md) - Axios 和 Undici 适配器的选择与切换
+- [W3C Trace Context 支持](./docs/trace-context.md) - 分布式链路追踪支持
+

package/dist/cjs/adapter/axios.adapter.js

@@ -0,0 +1,224 @@
+"use strict";
+/**
+ * Axios 适配器实现
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AxiosAdapter = void 0;
+const types_1 = require("../types");
+const base_1 = require("./base");
+const axios_1 = __importDefault(require("axios"));
+const https_proxy_agent_1 = require("https-proxy-agent");
+const https = __importStar(require("https"));
+const const_1 = require("../const");
+/**
+ * Axios 适配器
+ */
+class AxiosAdapter extends base_1.BaseHttpAdapter {
+    constructor() {
+        super(...arguments);
+        this.name = const_1.EClientAdapter.axios;
+    }
+    /**
+     * 检查 Axios 是否可用
+     */
+    isAvailable() {
+        return !!axios_1.default;
+    }
+    /**
+     * 发送请求
+     * @param options 请求选项
+     */
+    async sendRequest(options) {
+        if (!this.isAvailable()) {
+            throw new Error('Axios is not available. Please install it: npm install axios');
+        }
+        const url = this.buildUrl(options.url, options.params);
+        const axiosConfig = this.buildAxiosConfig(options, url);
+        try {
+            const startTime = Date.now();
+            const axiosResponse = await (0, axios_1.default)(axiosConfig);
+            const duration = Date.now() - startTime;
+            this.logger?.debug('HTTP request completed', {
+                method: options.method,
+                url,
+                status: axiosResponse.status,
+                duration
+            });
+            // 转换为标准响应格式
+            const response = {
+                status: axiosResponse.status,
+                statusText: axiosResponse.statusText,
+                headers: this.normalizeHeaders(axiosResponse.headers),
+                data: axiosResponse.data,
+                config: options
+            };
+            return response;
+        }
+        catch (error) {
+            throw this.handleAxiosError(error, options);
+        }
+    }
+    /**
+     * 构建 Axios 配置
+     * @param options 请求选项
+     * @param url 完整 URL
+     */
+    buildAxiosConfig(options, url) {
+        const axiosConfig = {
+            method: options.method.toLowerCase(),
+            url,
+            headers: options.headers || {},
+            timeout: options.timeout ?? this.requestConfig.timeout,
+            maxRedirects: this.requestConfig.maxRedirects,
+            maxContentLength: this.requestConfig.maxResponseBodySize,
+            maxBodyLength: this.requestConfig.maxRequestBodySize,
+            validateStatus: () => true,
+            httpsAgent: new https.Agent({
+                rejectUnauthorized: this.securityConfig.rejectUnauthorized
+            })
+        };
+        // 设置请求体
+        if (options.body !== undefined) {
+            axiosConfig.data = options.body;
+        }
+        // 设置响应类型
+        if (options.responseType) {
+            axiosConfig.responseType = options.responseType;
+        }
+        // 配置代理
+        this.configureAxiosProxy(axiosConfig, options);
+        return axiosConfig;
+    }
+    /**
+     * 配置 Axios 代理
+     * @param axiosConfig Axios 配置对象
+     * @param options 请求选项
+     */
+    configureAxiosProxy(axiosConfig, options) {
+        // 设置代理（全局配置）
+        if (this.requestConfig.proxy) {
+            axiosConfig.proxy = this.buildProxyConfig(this.requestConfig.proxy);
+        }
+        else {
+            // 显式的禁用代理, 防止axios默认从环境变量中 HTTP_PROXY、HTTPS_PROXY 读取代理配置. 
+            axiosConfig.proxy = false;
+        }
+        // 设置正向代理（如果请求元数据中包含代理信息）
+        const forwardProxyMeta = options.meta?.__forwardProxy;
+        if (forwardProxyMeta) {
+            this.applyForwardProxy(axiosConfig, forwardProxyMeta);
+        }
+    }
+    /**
+     * 应用正向代理配置
+     * @param axiosConfig Axios 配置对象
+     * @param forwardProxyMeta 正向代理元数据
+     */
+    applyForwardProxy(axiosConfig, forwardProxyMeta) {
+        const { proxyUrl, isHttps } = forwardProxyMeta;
+        if (isHttps) {
+            // HTTPS 请求使用 HttpsProxyAgent，并应用证书校验配置
+            axiosConfig.httpsAgent = new https_proxy_agent_1.HttpsProxyAgent(proxyUrl, {
+                rejectUnauthorized: this.securityConfig.rejectUnauthorized
+            });
+            axiosConfig.proxy = false;
+            this.logger?.debug('Using HttpsProxyAgent for HTTPS request', {
+                proxyUrl,
+                rejectUnauthorized: this.securityConfig.rejectUnauthorized
+            });
+        }
+        else {
+            // HTTP 请求直接设置 proxy
+            const parsedProxyUrl = new URL(proxyUrl);
+            axiosConfig.proxy = {
+                host: parsedProxyUrl.hostname,
+                port: Number(parsedProxyUrl.port),
+                protocol: 'http'
+            };
+            // 处理代理认证
+            if (parsedProxyUrl.username && parsedProxyUrl.password) {
+                axiosConfig.proxy.auth = {
+                    username: decodeURIComponent(parsedProxyUrl.username),
+                    password: decodeURIComponent(parsedProxyUrl.password)
+                };
+            }
+            this.logger?.debug('Using proxy for HTTP request', {
+                host: axiosConfig.proxy.host,
+                port: axiosConfig.proxy.port
+            });
+        }
+    }
+    /**
+     * 处理 Axios 错误
+     * @param error 错误对象
+     * @param options 请求选项
+     */
+    handleAxiosError(error, options) {
+        if (error.isAxiosError) {
+            return new types_1.HttpError(error.message, error.code || 'AXIOS_ERROR', error.response?.status, error.response ? {
+                status: error.response.status,
+                statusText: error.response.statusText,
+                headers: this.normalizeHeaders(error.response.headers),
+                data: error.response.data,
+                config: options
+            } : undefined, options);
+        }
+        return new types_1.HttpError(error.message || 'Unknown error', 'UNKNOWN_ERROR', undefined, undefined, options);
+    }
+    /**
+     * 构建代理配置
+     * @param proxy 代理配置
+     */
+    buildProxyConfig(proxy) {
+        const config = {
+            host: proxy.host,
+            port: proxy.port,
+            protocol: proxy.protocol
+        };
+        if (proxy.auth) {
+            config.auth = {
+                username: proxy.auth.username,
+                password: proxy.auth.password
+            };
+        }
+        return config;
+    }
+}
+exports.AxiosAdapter = AxiosAdapter;
+//# sourceMappingURL=axios.adapter.js.map

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

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

package/dist/cjs/adapter/base.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * HTTP 适配器基础实现
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseHttpAdapter = void 0;
+const utils_1 = require("../utils");
+/**
+ * HTTP 适配器抽象基类
+ */
+class BaseHttpAdapter {
+    constructor(requestConfig, securityConfig, logger) {
+        this.requestConfig = requestConfig;
+        this.securityConfig = securityConfig;
+        this.logger = logger;
+    }
+    /**
+     * 发送请求（带重试机制）
+     * @param options 请求选项
+     */
+    async request(options) {
+        const retries = options.retries ?? this.requestConfig.retries;
+        const retryDelay = this.requestConfig.retryDelay;
+        const timeout = options.timeout ?? this.requestConfig.timeout;
+        // 合并选项
+        const finalOptions = {
+            ...options,
+            timeout
+        };
+        let lastError;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            try {
+                this.logger?.debug(`HTTP request attempt ${attempt + 1}/${retries + 1}`, {
+                    method: options.method,
+                    url: options.url,
+                    scenario: options.scenario
+                });
+                const response = await this.sendRequest(finalOptions);
+                if (attempt > 0) {
+                    this.logger?.debug(`HTTP request succeeded after ${attempt} retries`, {
+                        method: options.method,
+                        url: options.url,
+                        status: response.status
+                    });
+                }
+                return response;
+            }
+            catch (error) {
+                lastError = error;
+                this.logger?.debug(`HTTP request attempt ${attempt + 1} failed`, {
+                    method: options.method,
+                    url: options.url,
+                    error: error instanceof Error ? error.message : String(error)
+                });
+                // 最后一次尝试，不再重试
+                if (attempt === retries) {
+                    break;
+                }
+                // 等待后重试
+                await utils_1.CommonUtils.delay(retryDelay * (attempt + 1));
+            }
+        }
+        // 所有尝试都失败了
+        this.logger?.debug('All HTTP request attempts failed', {
+            method: options.method,
+            url: options.url,
+            attempts: retries + 1,
+            error: lastError instanceof Error ? lastError.message : String(lastError)
+        });
+        throw lastError;
+    }
+    /**
+     * 更新请求配置
+     * @param config 新的请求配置
+     */
+    updateConfig(config) {
+        this.requestConfig = { ...this.requestConfig, ...config };
+    }
+    /**
+     * 设置日志记录器
+     * @param logger 日志记录器
+     */
+    setLogger(logger) {
+        this.logger = logger;
+    }
+    /**
+     * 构建查询字符串
+     * @param params 查询参数
+     */
+    buildQueryString(params) {
+        if (!params || Object.keys(params).length === 0) {
+            return '';
+        }
+        const searchParams = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            searchParams.append(key, String(value));
+        }
+        return searchParams.toString();
+    }
+    /**
+     * 构建完整 URL
+     * @param url 基础 URL
+     * @param params 查询参数
+     */
+    buildUrl(url, params) {
+        const queryString = this.buildQueryString(params);
+        if (!queryString) {
+            return url;
+        }
+        const separator = url.includes('?') ? '&' : '?';
+        return `${url}${separator}${queryString}`;
+    }
+    /**
+     * 标准化响应头
+     * @param headers 原始响应头
+     */
+    normalizeHeaders(headers) {
+        const normalized = {};
+        if (!headers) {
+            return normalized;
+        }
+        // 处理不同的头格式
+        if (typeof headers === 'object') {
+            for (const [key, value] of Object.entries(headers)) {
+                if (value !== undefined && value !== null) {
+                    normalized[key.toLowerCase()] = String(value);
+                }
+            }
+        }
+        return normalized;
+    }
+}
+exports.BaseHttpAdapter = BaseHttpAdapter;
+//# sourceMappingURL=base.js.map

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

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

package/dist/cjs/adapter/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("./axios.adapter"), exports);
+__exportStar(require("./undici.adapter"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapter/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,kDAAgC;AAChC,mDAAiC"}