nstarter-http-request 0.1.0

package/dist/cjs/adapter/undici.adapter.js

@@ -0,0 +1,272 @@
+"use strict";
+/**
+ * Undici 适配器实现
+ */
+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.UndiciAdapter = void 0;
+const types_1 = require("../types");
+const base_1 = require("./base");
+const undici_1 = __importStar(require("undici"));
+const http_1 = require("http");
+const const_1 = require("../const");
+/**
+ * Undici 适配器
+ */
+class UndiciAdapter extends base_1.BaseHttpAdapter {
+    constructor() {
+        super(...arguments);
+        this.name = const_1.EClientAdapter.undici;
+    }
+    /**
+     * 检查 Undici 是否可用
+     */
+    isAvailable() {
+        return !!undici_1.default;
+    }
+    /**
+     * 发送请求
+     * @param options 请求选项
+     */
+    async sendRequest(options) {
+        if (!this.isAvailable()) {
+            throw new Error('Undici is not available. Please install it: npm install undici');
+        }
+        const fullUrl = this.buildUrl(options.url, options.params);
+        const headers = this.prepareHeaders(options.headers);
+        const body = this.prepareBody(options.body, headers);
+        const dispatcher = this.buildDispatcher(options);
+        const undiciOptions = this.buildUndiciOptions(options, headers, body, dispatcher);
+        try {
+            const startTime = Date.now();
+            const response = await undici_1.default.request(fullUrl, undiciOptions);
+            const duration = Date.now() - startTime;
+            this.logger?.debug('HTTP request completed', {
+                method: options.method,
+                url: fullUrl,
+                status: response.statusCode,
+                duration
+            });
+            const data = await this.readResponseBody(response, options.responseType);
+            const httpResponse = {
+                status: response.statusCode,
+                statusText: this.getStatusText(response.statusCode),
+                headers: this.normalizeHeaders(response.headers),
+                data,
+                config: options
+            };
+            return httpResponse;
+        }
+        catch (error) {
+            throw this.handleUndiciError(error, options);
+        }
+    }
+    /**
+     * 准备请求头
+     * @param headers 原始请求头
+     */
+    prepareHeaders(headers) {
+        const prepared = {};
+        if (headers) {
+            for (const [key, value] of Object.entries(headers)) {
+                prepared[key] = typeof value === 'number' ? String(value) : value;
+            }
+        }
+        return prepared;
+    }
+    /**
+     * 准备请求体
+     * @param body 原始请求体
+     * @param headers 请求头
+     */
+    prepareBody(body, headers) {
+        if (body === undefined) {
+            return undefined;
+        }
+        if (typeof body === 'object' && !(body instanceof Buffer)) {
+            // 自动设置 Content-Type
+            if (!headers['content-type'] && !headers['Content-Type']) {
+                headers['Content-Type'] = 'application/json';
+            }
+            return JSON.stringify(body);
+        }
+        return body;
+    }
+    /**
+     * 构建 Dispatcher（代理或 TLS 配置）
+     * @param options 请求选项
+     */
+    buildDispatcher(options) {
+        let dispatcher;
+        // 如果 rejectUnauthorized 为 false，需要创建 Agent 来设置 TLS 选项
+        if (!this.securityConfig.rejectUnauthorized) {
+            dispatcher = new undici_1.Agent({
+                connect: {
+                    rejectUnauthorized: false
+                }
+            });
+        }
+        // 有代理时，创建 ProxyAgent
+        if (this.requestConfig.proxy) {
+            dispatcher = this.createGlobalProxyAgent();
+        }
+        // 设置正向代理（如果请求元数据中包含代理信息，会覆盖全局代理配置）
+        const forwardProxyMeta = options.meta?.__forwardProxy;
+        if (forwardProxyMeta) {
+            dispatcher = this.createForwardProxyAgent(forwardProxyMeta.proxyUrl);
+        }
+        return dispatcher;
+    }
+    /**
+     * 创建全局代理 Agent
+     */
+    createGlobalProxyAgent() {
+        const { protocol, host, port, auth } = this.requestConfig.proxy;
+        let proxyUrl = `${protocol}://${host}:${port}`;
+        if (auth) {
+            const encodedUsername = encodeURIComponent(auth.username);
+            const encodedPassword = encodeURIComponent(auth.password);
+            proxyUrl = `${protocol}://${encodedUsername}:${encodedPassword}@${host}:${port}`;
+        }
+        const agent = new undici_1.ProxyAgent({
+            uri: proxyUrl,
+            connect: {
+                rejectUnauthorized: this.securityConfig.rejectUnauthorized
+            }
+        });
+        this.logger?.debug('Using ProxyAgent with global proxy config', {
+            host,
+            port,
+            protocol,
+            rejectUnauthorized: this.securityConfig.rejectUnauthorized
+        });
+        return agent;
+    }
+    /**
+     * 创建正向代理 Agent
+     * @param proxyUrl 代理 URL
+     */
+    createForwardProxyAgent(proxyUrl) {
+        const agent = new undici_1.ProxyAgent({
+            uri: proxyUrl,
+            connect: {
+                rejectUnauthorized: this.securityConfig.rejectUnauthorized
+            }
+        });
+        this.logger?.debug('Using ProxyAgent for forward proxy (overrides global proxy)', {
+            proxyUrl,
+            rejectUnauthorized: this.securityConfig.rejectUnauthorized
+        });
+        return agent;
+    }
+    /**
+     * 构建 Undici 请求选项
+     */
+    buildUndiciOptions(options, headers, body, dispatcher) {
+        return {
+            method: options.method,
+            headers,
+            body,
+            bodyTimeout: options.timeout ?? this.requestConfig.timeout,
+            headersTimeout: options.timeout ?? this.requestConfig.timeout,
+            maxRedirections: this.requestConfig.maxRedirects,
+            ...(dispatcher && { dispatcher }),
+        };
+    }
+    /**
+     * 处理 Undici 错误
+     * @param error 错误对象
+     * @param options 请求选项
+     */
+    handleUndiciError(error, options) {
+        const errorMessage = error instanceof Error ? error.message : 'Undici request failed';
+        const errorCode = (error && typeof error === 'object' && 'code' in error && typeof error.code === 'string')
+            ? error.code
+            : 'UNDICI_ERROR';
+        return new types_1.HttpError(errorMessage, errorCode, undefined, undefined, options);
+    }
+    /**
+     * 读取响应体
+     * @param response Undici 响应对象
+     * @param responseType 响应类型
+     */
+    async readResponseBody(response, responseType) {
+        try {
+            switch (responseType) {
+                case 'text': {
+                    return (await response.body.text());
+                }
+                case 'arraybuffer': {
+                    return (await response.body.arrayBuffer());
+                }
+                case 'stream': {
+                    // undici 返回 BodyReadable (继承自 Node.js Readable)
+                    return response.body;
+                }
+                case 'blob': {
+                    return (await response.body.blob());
+                }
+                case 'formdata': {
+                    return (await response.body.formData());
+                }
+                case 'json': {
+                    return (await response.body.json());
+                }
+                default: {
+                    const text = await response.body.text();
+                    try {
+                        return JSON.parse(text);
+                    }
+                    catch {
+                        // 如果不是有效的 JSON，返回原文本
+                        return text;
+                    }
+                }
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to read response body: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * 获取状态文本
+     * @param statusCode 状态码
+     */
+    getStatusText(statusCode) {
+        return http_1.STATUS_CODES[statusCode] || 'Unknown';
+    }
+}
+exports.UndiciAdapter = UndiciAdapter;
+//# sourceMappingURL=undici.adapter.js.map

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

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

package/dist/cjs/client.js

@@ -0,0 +1,409 @@
+"use strict";
+/**
+ * HTTP 客户端核心类
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NsHttpClient = void 0;
+const config_1 = require("./config");
+const security_1 = require("./security");
+const adapter_1 = require("./adapter");
+const logger_1 = require("./logger");
+const const_1 = require("./const");
+const types_1 = require("./types");
+const utils_1 = require("./utils");
+const node_stream_1 = require("node:stream");
+/**
+ * HTTP 客户端
+ */
+class NsHttpClient {
+    constructor(userConfig = {}) {
+        // 合并配置
+        this.config = (0, config_1.mergeConfig)(userConfig);
+        // 验证配置
+        (0, config_1.validateConfig)(this.config);
+        // 初始化日志记录器
+        this.logger = this.initLogger();
+        this.httpLogger = this.initHttpLogger();
+        // 初始化 SSRF 防护
+        this.ssrfGuard = new security_1.SsrfGuard(this.config.security);
+        // 初始化适配器
+        this.adapter = this.initAdapter();
+        this.logger.debug('NsHttpClient initialized', {
+            adapter: this.config.adapter,
+            security: {
+                enableDnsValidation: this.config.security.enableDnsValidation,
+                enableIpValidation: this.config.security.enableIpValidation,
+                allowPrivateIp: this.config.security.allowPrivateIp
+            }
+        });
+    }
+    /**
+     * 从配置创建 HTTP 客户端
+     * @param config
+     */
+    static fromHttpClientConfig(config = {}) {
+        return new NsHttpClient(config);
+    }
+    /**
+     * 挂载适配器.
+     * @param adapter
+     */
+    withAdapter(adapter) {
+        this.config.adapter = adapter;
+        this.adapter = this.initAdapter();
+        return this;
+    }
+    /**
+     * 挂载正向代理.
+     * @param proxy
+     */
+    withForwardProxy(proxy) {
+        this.forwardProxy = proxy;
+        this.logger.info('Forward proxy configured', {
+            enabled: proxy.enabled,
+            http_proxy: proxy.http_proxy,
+            https_proxy: proxy.https_proxy,
+            no_proxy_count: proxy.no_proxy?.length || 0
+        });
+        return this;
+    }
+    /**
+     * 初始化日志记录器
+     */
+    initLogger() {
+        if (!this.config.logging.enabled) {
+            return new logger_1.NullLogger();
+        }
+        return this.config.logging.logger || new logger_1.NullLogger();
+    }
+    /**
+     * 初始化 HTTP 客户端日志记录器
+     */
+    initHttpLogger() {
+        if (!this.config.logging.enabled) {
+            return undefined;
+        }
+        // 如果用户提供了自定义的 httpLogger，直接使用
+        if (this.config.logging.httpLogger) {
+            return this.config.logging.httpLogger;
+        }
+        // 否则，使用 NsHttpClientLogger 包装通用的 logger
+        return logger_1.NsHttpClientLogger.create(this.logger, this.config.logging.filter, {
+            logRequestBody: this.config.logging.logRequestBody,
+            logResponseBody: this.config.logging.logResponseBody,
+            bodyMaxLength: this.config.logging.bodyMaxLength
+        });
+    }
+    /**
+     * 初始化适配器
+     */
+    initAdapter() {
+        const adapter = this.config.adapter === const_1.EClientAdapter.axios
+            ? new adapter_1.AxiosAdapter(this.config.request, this.config.security, this.logger)
+            : new adapter_1.UndiciAdapter(this.config.request, this.config.security, this.logger);
+        if (!adapter.isAvailable()) {
+            throw new Error(`Adapter "${this.config.adapter}" is not available. ` +
+                `Please install it: npm install ${this.config.adapter}`);
+        }
+        return adapter;
+    }
+    /**
+     * 发送 HTTP 请求
+     * @param options 请求选项
+     * @returns 响应结果
+     */
+    async request(options) {
+        const startTime = Date.now();
+        try {
+            // 安全验证
+            const { safeUrl, result: ssrfResult } = await this.ssrfGuard.validateAndGetSafeUrl(options.url);
+            this.logger.debug('URL validation passed', {
+                originalUrl: options.url,
+                safeUrl,
+                resolvedIps: ssrfResult.resolvedIps,
+                scenario: options.scenario
+            });
+            // 使用安全的 URL 发起请求
+            const safeOptions = {
+                ...options,
+                url: safeUrl
+            };
+            // 如果 URL 被替换为 IP，需要设置 Host 头
+            if (ssrfResult.safeIp && ssrfResult.hostname !== ssrfResult.safeIp) {
+                safeOptions.headers = {
+                    ...safeOptions.headers,
+                    Host: ssrfResult.hostname
+                };
+            }
+            // 处理 W3C Trace Context traceparent 头
+            if (options.traceparent) {
+                // 验证 traceparent 格式
+                if (!utils_1.TraceContextUtils.isValidTraceParent(options.traceparent)) {
+                    this.logger.warn('Invalid traceparent format, ignoring', {
+                        traceparent: options.traceparent
+                    });
+                }
+                else {
+                    safeOptions.headers = {
+                        ...safeOptions.headers,
+                        traceparent: options.traceparent
+                    };
+                    this.logger.debug('Traceparent header added', {
+                        traceparent: options.traceparent,
+                        sampled: utils_1.TraceContextUtils.isSampled(options.traceparent)
+                    });
+                }
+            }
+            // 应用正向代理配置
+            if (this.forwardProxy) {
+                this.applyForwardProxy(safeOptions);
+            }
+            // 发起请求
+            const response = await this.adapter.request(safeOptions);
+            // 首次响应时间（TTFB）
+            const ttfb = Date.now() - startTime;
+            // 如果是流式响应，包装流对象以追踪完整生命周期
+            if (options.responseType === 'stream' && this.isStreamResponse(response.data)) {
+                return this.wrapStreamResponse(safeOptions, response, startTime, ttfb);
+            }
+            // 记录非流式响应日志
+            this.logResponse(safeOptions, response, ttfb);
+            return response;
+        }
+        catch (error) {
+            // 记录错误日志
+            this.logError(options, error, Date.now() - startTime);
+            throw error;
+        }
+    }
+    /**
+     * 便捷方法：GET 请求
+     */
+    async get(url, options) {
+        return this.request({ ...options, method: 'GET', url });
+    }
+    /**
+     * 便捷方法：POST 请求
+     */
+    async post(url, body, options) {
+        return this.request({ ...options, method: 'POST', url, body });
+    }
+    /**
+     * 便捷方法：PUT 请求
+     */
+    async put(url, body, options) {
+        return this.request({ ...options, method: 'PUT', url, body });
+    }
+    /**
+     * 便捷方法：DELETE 请求
+     */
+    async delete(url, options) {
+        return this.request({ ...options, method: 'DELETE', url });
+    }
+    /**
+     * 便捷方法：PATCH 请求
+     */
+    async patch(url, body, options) {
+        return this.request({ ...options, method: 'PATCH', url, body });
+    }
+    /**
+     * 记录响应日志
+     */
+    logResponse(options, response, duration, streamMetrics) {
+        if (!this.httpLogger) {
+            return;
+        }
+        // 计算实际重试次数
+        const retryCount = options.retries ?? this.config.request.retries;
+        this.httpLogger.logSuccess({
+            request: {
+                method: options.method,
+                url: options.url,
+                headers: options.headers,
+                body: options.body,
+                scenario: options.scenario,
+                meta: options.meta
+            },
+            response,
+            duration,
+            retryCount,
+            streamMetrics
+        });
+    }
+    /**
+     * 判断响应数据是否为流对象（Node.js Readable）
+     */
+    isStreamResponse(data) {
+        // undici 和 axios 都返回 Node.js Readable
+        return data instanceof node_stream_1.Readable;
+    }
+    /**
+     * 包装流式响应，追踪流的完整生命周期
+     */
+    /* eslint-disable max-lines-per-function */
+    wrapStreamResponse(options, response, requestStartTime, ttfb) {
+        const stream = response.data;
+        let bytesTransferred = 0;
+        // 记录首次响应日志（流开始）
+        this.logResponse(options, response, ttfb, {
+            ttfb,
+            completed: false
+        });
+        this.logger.debug('Stream response started', {
+            method: options.method,
+            url: options.url,
+            ttfb,
+            status: response.status
+        });
+        // 所有适配器都返回 Node.js Readable
+        const originalStream = stream;
+        const wrappedStream = new node_stream_1.PassThrough();
+        // 监听数据事件统计字节数
+        originalStream.on('data', (chunk) => {
+            bytesTransferred += chunk.length;
+            wrappedStream.write(chunk);
+        });
+        // 监听结束事件记录日志
+        originalStream.on('end', () => {
+            const totalDuration = Date.now() - requestStartTime;
+            wrappedStream.end();
+            // 记录流完成日志
+            this.logStreamCompleted(options, response, ttfb, totalDuration, bytesTransferred);
+        });
+        // 监听错误事件
+        originalStream.on('error', (error) => {
+            const totalDuration = Date.now() - requestStartTime;
+            this.logger.error('Stream read error', {
+                method: options.method,
+                url: options.url,
+                ttfb,
+                totalDuration,
+                bytesTransferred,
+                error: error.message
+            });
+            wrappedStream.destroy(error);
+        });
+        // 使用 pipe 连接流
+        originalStream.pipe(wrappedStream, { end: false });
+        // 返回包装后的响应
+        return {
+            ...response,
+            data: wrappedStream
+        };
+    }
+    /**
+     * 记录流完成日志
+     */
+    logStreamCompleted(options, response, ttfb, totalDuration, bytesTransferred) {
+        // 记录流完成日志
+        this.logResponse(options, response, totalDuration, {
+            ttfb,
+            completed: true,
+            totalDuration,
+            bytesTransferred
+        });
+        this.logger.debug('Stream response completed', {
+            method: options.method,
+            url: options.url,
+            ttfb,
+            totalDuration,
+            streamDuration: totalDuration - ttfb,
+            bytesTransferred,
+            throughput: bytesTransferred > 0 && totalDuration > ttfb
+                ? `${(bytesTransferred / 1024 / ((totalDuration - ttfb) / 1000)).toFixed(2)} KB/s`
+                : 'N/A'
+        });
+    }
+    /**
+     * 记录错误日志
+     */
+    logError(options, error, duration) {
+        if (!this.httpLogger) {
+            return;
+        }
+        // 计算实际重试次数
+        const retryCount = options.retries ?? this.config.request.retries;
+        const httpError = error instanceof types_1.HttpError ? error : undefined;
+        this.httpLogger.logFailed({
+            request: {
+                method: options.method,
+                url: options.url,
+                headers: options.headers,
+                body: options.body,
+                scenario: options.scenario,
+                meta: options.meta
+            },
+            error: error instanceof Error ? error : new Error(String(error)),
+            errorCode: httpError?.code || 'UNKNOWN_ERROR',
+            status: httpError?.status,
+            response: httpError?.response,
+            duration,
+            retryCount
+        });
+    }
+    /**
+     * 应用正向代理配置
+     * @param options 请求选项
+     */
+    applyForwardProxy(options) {
+        if (!this.forwardProxy || !this.forwardProxy.enabled) {
+            return;
+        }
+        const { https_proxy, http_proxy, no_proxy } = this.forwardProxy;
+        // 解析目标 URL
+        const targetUrl = new URL(options.url);
+        const hostname = targetUrl.hostname;
+        // 检查 no_proxy 规则（使用传统匹配模式）
+        const noProxyRegExps = utils_1.DomainUtils.createLegacyDomainMatchers(no_proxy ?? []);
+        if (noProxyRegExps.length > 0 && hostname) {
+            for (const noProxyRegex of noProxyRegExps) {
+                if (noProxyRegex.test(hostname)) {
+                    this.logger.debug('Skip proxy for no_proxy matched host', {
+                        hostname,
+                        pattern: noProxyRegex.source
+                    });
+                    return;
+                }
+            }
+        }
+        const protocol = targetUrl.protocol || 'http:';
+        const isHttps = /https:?/.test(protocol);
+        const proxyUrl = isHttps ? https_proxy : http_proxy;
+        if (!proxyUrl) {
+            this.logger.warn('Forward proxy enabled but proxy URL not configured', {
+                protocol
+            });
+            return;
+        }
+        // 将代理信息附加到请求元数据中，由适配器处理
+        options.meta = {
+            ...options.meta,
+            __forwardProxy: {
+                proxyUrl,
+                isHttps,
+                protocol
+            }
+        };
+        this.logger.debug('Applied forward proxy', {
+            url: options.url,
+            proxyUrl,
+            isHttps
+        });
+    }
+    /**
+     * 清空 DNS 缓存
+     */
+    clearDnsCache() {
+        this.ssrfGuard.clearDnsCache();
+        this.logger.debug('DNS cache cleared');
+    }
+    /**
+     * 获取 DNS 缓存大小
+     * @returns 缓存条目数量
+     */
+    getDnsCacheSize() {
+        return this.ssrfGuard.getDnsCacheSize();
+    }
+}
+exports.NsHttpClient = NsHttpClient;
+//# sourceMappingURL=client.js.map