thunderbench 1.0.5

package/dist/types/index.d.ts

@@ -0,0 +1,88 @@
+export interface RequestConfig {
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    url: string;
+    headers?: Record<string, string>;
+    body?: any;
+    query?: Record<string, any>;
+    params?: Record<string, any>;
+    formData?: Record<string, any>;
+    timeout?: number;
+}
+export interface HttpConfig {
+    baseUrl?: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+export interface ErrorHandlingConfig {
+    expectMaxResponseTime: number;
+}
+export interface ApiTestConfig {
+    name: string;
+    request: RequestConfig;
+    weight: number;
+    errorHandling?: ErrorHandlingConfig;
+}
+export interface TestGroupConfig {
+    name: string;
+    http: HttpConfig;
+    threads: number;
+    connections: number;
+    duration: number;
+    timeout?: number;
+    latency?: boolean;
+    tests: ApiTestConfig[];
+    executionMode: "parallel" | "sequential";
+    delay?: number;
+}
+export interface BenchmarkConfig {
+    name: string;
+    description?: string;
+    groups: TestGroupConfig[];
+}
+export interface RequestResult {
+    name: string;
+    success: boolean;
+    responseTime: number;
+    statusCode?: number;
+    error?: string;
+    timestamp: number;
+    requestSize?: number;
+    responseSize?: number;
+    isTimeout?: boolean;
+    isSlow?: boolean;
+}
+export interface RealTimeStats {
+    totalRequests: number;
+    successfulRequests: number;
+    failedRequests: number;
+    timeoutRequests: number;
+    slowRequests: number;
+    averageResponseTime: number;
+    minResponseTime: number;
+    maxResponseTime: number;
+    requestsPerSecond: number;
+    errorRate: number;
+    timeoutRate: number;
+    slowRate: number;
+}
+export interface DetailedStats extends RealTimeStats {
+    p50ResponseTime: number;
+    p90ResponseTime: number;
+    p95ResponseTime: number;
+    p99ResponseTime: number;
+    totalRequestSize: number;
+    totalResponseSize: number;
+}
+export interface GroupResult {
+    name: string;
+    stats: DetailedStats;
+    requests: RequestResult[];
+}
+export interface BenchmarkResult {
+    startTime: number;
+    endTime: number;
+    duration: number;
+    groups: GroupResult[];
+    overallStats: DetailedStats;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/utils/wrk-binary.d.ts

@@ -0,0 +1,41 @@
+export interface WrkBinaryInfo {
+    path: string;
+    platform: string;
+    arch: string;
+    exists: boolean;
+    version?: string;
+}
+/**
+ * 获取当前平台的标识符
+ */
+export declare function getPlatformIdentifier(): string;
+/**
+ * 获取内置 wrk 二进制文件的路径
+ */
+export declare function getBuiltinWrkPath(): string;
+/**
+ * 获取系统安装的 wrk 路径（保留作为备用选项）
+ */
+export declare function getSystemWrkPath(): Promise<string | undefined>;
+/**
+ * 验证 wrk 二进制文件是否可用
+ */
+export declare function validateWrkBinary(wrkPath: string): Promise<boolean>;
+/**
+ * 获取 wrk 版本信息
+ */
+export declare function getWrkVersion(wrkPath: string): Promise<string | undefined>;
+/**
+ * 获取最佳的 wrk 二进制文件路径
+ * 优先级：用户指定 > 内置二进制
+ */
+export declare function getBestWrkPath(userWrkPath?: string): Promise<WrkBinaryInfo>;
+/**
+ * 检查是否需要下载 wrk 二进制文件
+ */
+export declare function needsWrkDownload(): Promise<boolean>;
+/**
+ * 获取下载说明信息
+ */
+export declare function getDownloadInstructions(): string;
+//# sourceMappingURL=wrk-binary.d.ts.map

package/dist/utils/wrk-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrk-binary.d.ts","sourceRoot":"","sources":["../../src/utils/wrk-binary.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAuB9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAyD1C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAIpE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAczE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAShF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAkDjF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAGzD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAsBhD"}

package/docs/cli-usage.md

@@ -0,0 +1,245 @@
+# ThunderBench CLI 使用指南
+
+## 🚀 快速开始
+
+### 安装
+
+```bash
+npm install -g thunderbench
+```
+
+### 基本用法
+
+```bash
+thunderbench [选项] [配置文件]
+```
+
+## 📋 命令选项
+
+### 核心选项
+
+| 选项 | 简写 | 描述 | 默认值 |
+|------|------|------|--------|
+| `--config` | `-c` | 配置文件路径 | `./examples/test-config.ts` |
+| `--verbose` | `-v` | 详细输出模式 | `false` |
+| `--version` | `-V` | 显示版本信息 | - |
+| `--help` | `-h` | 显示帮助信息 | - |
+
+### 执行控制
+
+| 选项 | 描述 | 默认值 |
+|------|------|--------|
+| `--dry-run` | 仅验证配置，不执行测试 | `false` |
+| `--no-progress` | 不显示实时进度 | `false` |
+| `--no-report` | 不生成报告文件 | `false` |
+
+### 全局参数覆盖
+
+| 选项 | 描述 | 默认值 |
+|------|------|--------|
+| `--timeout <ms>` | 全局超时时间（毫秒） | `30000` |
+| `--concurrent <number>` | 全局并发数覆盖 | `10` |
+
+### 输出控制
+
+| 选项 | 描述 | 默认值 |
+|------|------|--------|
+| `--output <dir>` | 报告输出目录 | `./reports` |
+| `--cleanup-wrk` | 测试完成后清理临时文件 | `false` |
+
+### 示例和帮助
+
+| 选项 | 描述 |
+|------|------|
+| `--list-examples` | 列出可用的示例配置文件 |
+| `--create-example` | 创建示例配置文件 |
+
+## 🎯 使用示例
+
+### 1. 查看帮助和版本
+
+```bash
+# 查看帮助
+thunderbench --help
+
+# 查看版本
+thunderbench --version
+```
+
+### 2. 列出示例配置
+
+```bash
+thunderbench --list-examples
+```
+
+### 3. 创建示例配置
+
+```bash
+thunderbench --create-example
+```
+
+### 4. 配置验证（干运行）
+
+```bash
+# 验证配置文件语法
+thunderbench --config examples/simple-wrk-config.js --dry-run
+```
+
+### 5. 执行性能测试
+
+#### 基本测试
+```bash
+thunderbench --config examples/simple-wrk-config.js
+```
+
+#### 详细输出模式
+```bash
+thunderbench --config examples/simple-wrk-config.js --verbose
+```
+
+#### 自定义输出目录
+```bash
+thunderbench --config examples/simple-wrk-config.js -o ./my-reports
+```
+
+#### 全局参数覆盖
+```bash
+thunderbench --config examples/simple-wrk-config.js \
+  --timeout 5000 \
+  --concurrent 50
+```
+
+## 📊 配置文件格式
+
+### 基础结构
+
+```typescript
+const config = {
+  name: "测试配置名称",
+  description: "测试配置描述",
+  groups: [
+    {
+      name: "测试组名称",
+      http: {
+        baseUrl: "http://localhost:3000",
+        headers: { "User-Agent": "thunderbench/1.0" }
+      },
+      // wrk 核心参数
+      threads: 4,        // -t 线程数
+      connections: 100,   // -c 连接数
+      duration: 30,       // -d 测试时长(秒)
+      timeout: 5,         // --timeout 超时时间
+      latency: true,      // --latency 延迟统计
+      
+      // 执行模式
+      executionMode: "parallel", // parallel 或 sequential
+      delay: 2,                   // 组间延迟(秒)
+      
+      // 测试接口
+      tests: [
+        {
+          name: "API测试",
+          request: { 
+            method: "GET", 
+            url: "/api/test" 
+          },
+          weight: 100
+        }
+      ]
+    }
+  ]
+};
+```
+
+### wrk 参数说明
+
+| 参数 | 对应 wrk 选项 | 描述 | 示例值 |
+|------|---------------|------|--------|
+| `threads` | `-t` | 线程数 | `4` |
+| `connections` | `-c` | 连接数 | `100` |
+| `duration` | `-d` | 测试时长（秒） | `30` |
+| `timeout` | `--timeout` | 超时时间（秒） | `5` |
+| `latency` | `--latency` | 延迟统计 | `true` |
+
+## 📈 测试结果
+
+### 实时输出示例
+
+```
+执行测试组: 基础测试组 (1/1)
+并行执行模式: 同时测试所有接口
+  启动接口测试: GET 请求测试
+    wrk -t4 -c100 -d10s GET 请求测试 (权重: 100%)
+基础测试组: 100% (1/1) | 基础测试组
+实时: 0 请求 | 0.0% 成功 | 平均 0ms | 0.0 req/s
+```
+
+### 最终报告示例
+
+```
+────────────────────────────────────────────────────────────
+                ThunderBench 性能测试结果
+────────────────────────────────────────────────────────────
+总耗时: 10.13s
+总请求数: 1,443,024
+成功: 1,443,024 (100.0%)
+平均延迟: 0.71ms
+P95延迟: 14.09ms
+吞吐量: 142862.0 req/s
+延迟分布: P50: 0ms | P90: 0ms | P95: 14.09ms | P99: 0ms
+────────────────────────────────────────────────────────────
+```
+
+## 🔧 高级用法
+
+### 环境变量
+
+```bash
+# 设置详细日志
+export THUNDERBENCH_VERBOSE=true
+
+# 设置默认超时
+export THUNDERBENCH_TIMEOUT=10000
+```
+
+### 配置文件优先级
+
+1. 命令行参数（最高优先级）
+2. 环境变量
+3. 配置文件
+4. 默认值（最低优先级）
+
+## 📁 输出文件
+
+### 报告目录结构
+
+```
+reports/
+└── 2025-08-22_07-10-29/
+    ├── report.json      # JSON 格式报告
+    ├── report.md        # Markdown 格式报告
+    └── summary.txt      # 摘要报告
+```
+
+## 🚨 故障排除
+
+### 常见问题
+
+1. **权限问题**: 确保对输出目录有写权限
+2. **内存不足**: 减少并发数和连接数
+3. **网络超时**: 调整超时时间设置
+4. **配置文件错误**: 使用 `--dry-run` 验证配置
+
+### 调试模式
+
+```bash
+# 启用详细输出
+thunderbench --config config.js --verbose
+
+# 仅验证配置
+thunderbench --config config.js --dry-run
+```
+
+---
+
+💡 **提示**: 首次使用建议先运行 `--create-example` 创建示例配置，然后使用 `--dry-run` 验证配置正确性。

package/docs/requirements.md

@@ -0,0 +1,222 @@
+# JS-Benchmark 性能测试工具需求文档
+
+## 1. 项目概述
+
+### 1.1 项目目标
+创建一个声明式的接口性能测试工具，使用JavaScript配置，基于RxJS实现，提供简单易用的性能测试能力。
+
+### 1.2 技术选型
+- **运行时**: Bun
+- **语言**: TypeScript
+- **核心库**: RxJS (处理异步流和并发控制)
+- **HTTP客户端**: Axios
+- **命令行工具**: Commander.js
+
+## 2. 功能需求
+
+### 2.1 核心功能
+
+#### 2.1.1 测试配置
+- 支持JavaScript配置文件（ES模块）
+- 组级配置管理（HTTP配置、执行模式、并发数等）
+- 接口级测试配置（请求方法、URL、权重等）
+- 权重分配：0-100，总和必须=100
+
+#### 2.1.2 执行模式
+- **并行执行**: 组内所有接口同时启动
+- **串行执行**: 组内接口按顺序执行
+- 支持组间延迟配置
+- 通过数组复用实现分阶段测试
+
+#### 2.1.3 测试策略
+- **按次数测试**: 指定总请求数
+- **按时间测试**: 指定测试时长
+- 两种策略互斥，不能同时设置
+
+#### 2.1.4 并发控制
+- 组级并发控制
+- 接口级并发控制
+- Artillery风格：始终保持指定并发数进行中
+
+### 2.2 必要功能
+
+#### 2.2.1 实时监控
+- 每个请求都显示进度
+- 实时统计更新（成功率、响应时间、每秒请求数）
+- 实时错误信息显示
+
+#### 2.2.2 报告生成
+- 控制台完整报告
+- 分组统计报告
+- 性能指标分析（P50、P90、P95、P99）
+
+#### 2.2.3 错误处理
+- 超时检测（基于`expectMaxResponseTime`）
+- 响应过慢判断
+- 错误分类统计
+- **策略**: 不恢复，只记录，继续测试
+
+#### 2.2.4 配置验证
+- 运行时验证权重总和
+- 运行时验证必要参数
+- 配置错误时立即停止
+
+### 2.3 可选功能
+
+#### 2.3.1 数据收集
+- 请求大小统计
+- 响应大小统计
+- 详细错误信息记录
+
+#### 2.3.2 性能指标
+- 响应时间分布
+- 错误率分析
+- 吞吐量统计
+
+## 3. 非功能需求
+
+### 3.1 性能要求
+- 控制台输出不影响测试性能
+- 支持高并发测试（100+并发）
+- 内存使用友好，流式处理
+
+### 3.2 易用性
+- 一个命令启动：`js-benchmark config.js`
+- 默认实时监控和报告生成
+- 配置文件简单直观
+
+### 3.3 可扩展性
+- 模块化设计
+- 函数式编程风格
+- 易于添加新的执行模式
+
+## 4. 用户使用场景
+
+### 4.1 配置文件编写
+```typescript
+// simple-test.js
+export default {
+  groups: [
+    {
+      name: "用户接口",
+      http: { baseUrl: "https://api.example.com" },
+      executionMode: 'parallel',
+      concurrent: 10,
+      requests: 1000,
+      tests: [
+        { name: "登录", weight: 60, request: { method: "POST", url: "/auth/login" } },
+        { name: "注册", weight: 40, request: { method: "POST", url: "/auth/register" } }
+      ]
+    }
+  ]
+};
+```
+
+### 4.2 测试启动
+```bash
+js-benchmark simple-test.js
+```
+
+### 4.3 测试过程
+- 启动时显示配置摘要
+- 运行中实时显示进度和统计
+- 完成后显示完整报告
+
+## 5. 技术架构
+
+### 5.1 核心模块
+- **配置管理**: 配置文件加载和验证
+- **测试引擎**: RxJS流式处理，并发控制
+- **请求执行**: HTTP请求发送和结果收集
+- **统计计算**: 实时统计和指标计算
+- **进度监控**: 实时进度显示和报告生成
+
+### 5.2 数据流
+1. 配置文件 → 配置验证
+2. 配置 → 请求流生成
+3. 请求流 → 并发控制
+4. 结果流 → 实时统计
+5. 统计结果 → 进度显示和报告
+
+### 5.3 关键算法
+- **权重分配**: 两轮分配算法，处理舍入误差
+- **并发控制**: RxJS mergeMap + concatMap
+- **统计计算**: 流式统计，实时更新
+
+## 6. 输出格式
+
+### 6.1 启动信息
+```
+🚀 开始性能测试...
+📋 测试组: 1个
+🎯 总请求数: 1000个
+⚡ 并发数: 10个
+```
+
+### 6.2 实时进度
+```
+📊 进度: 1.0% (10/1000)
+📊 进度: 2.0% (20/1000)
+⚡ 成功率: 100.0%
+📈 平均响应时间: 156ms
+🚀 每秒请求数: 10.2/s
+```
+
+### 6.3 最终报告
+```
+🎉 测试完成!
+⏱️  总耗时: 125s
+📈 总请求: 1000
+✅ 成功: 985
+❌ 失败: 15
+
+📊 用户接口组
+   - 登录接口: 600次, 成功率98.3%, 平均156ms
+   - 注册接口: 400次, 成功率97.5%, 平均234ms
+
+📊 性能分析
+   - P50: 120ms
+   - P90: 280ms  
+   - P95: 450ms
+   - P99: 800ms
+```
+
+## 7. 开发优先级
+
+### 7.1 第一阶段（核心功能）
+- 基础配置管理
+- HTTP请求执行
+- 并发控制
+- 基础统计
+
+### 7.2 第二阶段（必要功能）
+- 实时监控
+- 报告生成
+- 错误处理
+- 配置验证
+
+### 7.3 第三阶段（优化完善）
+- 性能优化
+- 错误分类
+- 指标完善
+- 文档完善
+
+## 8. 验收标准
+
+### 8.1 功能验收
+- 支持并行和串行执行
+- 权重分配准确
+- 并发控制有效
+- 实时监控正常
+- 报告生成完整
+
+### 8.2 性能验收
+- 支持100+并发
+- 控制台输出不影响性能
+- 内存使用合理
+
+### 8.3 易用性验收
+- 配置文件简单
+- 一个命令启动
+- 输出信息清晰
+- 错误信息明确