blaze-performance-tester 1.0.6 → 1.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blaze-performance-tester",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "A high-performance, multi-threaded load testing engine built with Rust and QuickJS.",
   "type": "module",
   "main": "dist/index.js",
@@ -15,10 +15,10 @@
     "bin.js",
     "blaze.win32-x64-msvc.node"
   ],
- "scripts": {
+"scripts": {
     "prebuild": "node -e \"if (!fs.existsSync('dist')) fs.mkdirSync('dist')\"",
     "build:rust": "napi build --platform --release --js dist/index.js --dts dist/index.d.ts",
-    "build:cli": "esbuild cli.ts --bundle --platform=node --format=esm --banner:js=\"#!/usr/bin/env node\" --outfile=dist/cli.js",
+    "build:cli": "esbuild cli.ts --bundle --platform=node --format=esm --packages=external --banner:js=\"#!/usr/bin/env node\" --outfile=dist/cli.js",
     "postbuild": "node -e \"fs.copyFileSync('blaze.win32-x64-msvc.node', 'dist/blaze.win32-x64-msvc.node')\"",
     "build": "npm run build:rust && npm run build:cli && npm run postbuild"
   },

package/readme

@@ -1,3 +1,4 @@
+Markdown
 # 🔥 Blaze Performance Tester
 
 Blaze is an ultra-high-performance, multi-threaded load testing framework built with **Rust** and **QuickJS** (via `rquickjs`). It provides parallel virtual user execution by isolating JavaScript evaluation environments into dedicated native OS threads, delivering raw network speed and JMeter-style telemetry metrics with minimal footprint.
@@ -10,7 +11,7 @@ Blaze is an ultra-high-performance, multi-threaded load testing framework built
 * **Native HTTP Execution Sockets:** Exposes a global `http_get()` binding inside JavaScript that routes network calls directly through Rust's high-speed `reqwest` stack.
 * **JMeter-Style Telemetry Aggregation:** Computes live data snapshots including throughput rates, error tallies, and crucial latency percentiles ($p50$, $p90$, $p95$, $p99$).
 * **Real-Time Terminal Progress Updates:** Keeps you updated via a live terminal countdown ticker while heavy parallel workloads run.
-* **CSV Result Archiver:** Automatically records every workload run into structured `.csv` reports inside the `results/` folder for data charting.
+* **Zero-Configuration CSV Archiver:** Automatically records data into structured `.csv` reports inside a `results/` folder created dynamically wherever you invoke the command.
 
 ---
 
@@ -19,17 +20,17 @@ Blaze is an ultra-high-performance, multi-threaded load testing framework built
 ```text
 blaze-performance-tester/
 ├── dist/                  # Compiled Distribution Assets
-│   ├── cli.js             # Bundled CLI Wrapper Script
+│   ├── cli.js             # Bundled CLI Core
 │   ├── index.js           # Generated Native NAPI-RS Bridges
-│   └── index.d.ts         # TypeScript Type Structure Mappings
-├── results/               # Aggregated Report Output Artifacts
-│   └── summary_report.csv # JMeter-style CSV performance dump
+│   ├── index.d.ts         # TypeScript Type Structure Mappings
+│   └── blaze.*.node       # Compiled Native Rust Binary
 ├── src/
 │   └── lib.rs             # Multi-Threaded Rust Concurrency Core
 ├── tests/                 # Dedicated Folder for Performance Scripts
-│   └── demo-load-test.ts  # Scenario Workload Script
+│   └── test-script.ts     # Scenario Workload Script
+├── bin.js                 # Anti-Hijack Executable Gateway for Windows WSH
 ├── cli.ts                 # CLI Orchestration & Metrics Wrapper
-├── package.json           # Node Dependency Pipeline
+├── package.json           # Node Dependency & Build Script Pipeline
 └── Cargo.toml             # Rust Native Compilation Flags
 📦 Compilation & Installation
 Prerequisites
@@ -43,25 +44,27 @@ Setup & Build
 Clone the repository, download dependencies, and compile the native binary distribution bundle:
 
 Bash
-# Install node dependencies
+# Install package dependencies
 npm install
 
-# Compile the native Rust modules and bundle the TypeScript CLI wrapper
+# Compile the native Rust modules, copy binaries, and bundle the ESM CLI wrapper
 npm run build
 🏃 Run Performance Workloads
-To run a performance test script, call the core execution runner by passing your target test file, the number of parallel virtual users (VUs), and the test duration in seconds:
+Blaze can be executed globally from any terminal folder via npx without needing global system mutations.
 
-Bash
-# Usage: npx tsx cli.ts <script-path> <vus> <duration-seconds>
-npx tsx cli.ts tests/demo-load-test.ts 10 5
-Writing a Workload Script (tests/demo-load-test.ts)
-Your scripts have access to the injected, native http_get global socket binding:
+To run a test, navigate to your target project folder, create your script file, and call the runner passing the script path, the number of concurrent Virtual Users (VUs), and the test duration in seconds:
+
+DOS
+# Usage: npx blaze-performance-tester <script-path> <vus> <duration-seconds>
+npx blaze-performance-tester tests/test-script.ts 10 5
+Writing a Workload Script (tests/test-script.ts)
+Your script workloads have instant access to the injected high-speed global native socket binding:
 
 TypeScript
 // Call the high-speed native network layer directly
 const status = http_get("[https://jsonplaceholder.typicode.com/posts/1](https://jsonplaceholder.typicode.com/posts/1)");
 
-// The engine automatically registers response times and error states!
+// The native Rust engine automatically handles response times and error states!
 📊 Sample Performance Output Report
 When your test finishes running, Blaze renders a clean telemetry report right in your terminal and saves a copy to disk:
 
@@ -81,17 +84,12 @@ Plaintext
   └── Maximum:        12.40 ms
 =============================================================================
 💾 Aggregated metrics saved to: .\results\summary_report.csv
-🧙 Interactive Scaffolding Wizard (create-blaze-tester)
-We provide a companion initializer utility to quickly set up new projects with an organized workspace folder structure.
-
-To execute the setup wizard out of an empty workspace directory, run:
-
-Bash
-npm init blaze-tester
-This interactive prompt automatically:
-
-Provisions a dedicated tests/ directory.
+📂 Where are results stored?
+Blaze captures execution contexts using process.cwd(). The moment a test run completes successfully, a new directory is instantly written inside the user's active terminal directory:
 
-Injects an example boilerplate script file (demo-load-test.ts).
-
-Appends test runner shortcut hooks directly into your local package.json.
+Plaintext
+your-active-directory/
+├── tests/
+│   └── test-script.ts
+└── results/               <-- Generated Automatically
+    └── summary_report.csv <-- Contains Raw Timestamp, Latency, Status, and Success Flags