k6-perf-reporter 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,54 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(code .:*)",
+      "Bash(npm run:*)",
+      "Bash(npm install:*)",
+      "Bash(npx tsx:*)",
+      "Bash(INFLUX_TOKEN='JFP9pZu3Sp134rkCZ6gT7FtSBmQRWgl8VmVhFMHTXrbkhKQ3LrvrM4FXECR7Lr8MsDGWLIsU7IJFcjL_QHwvqA==' npx tsx src/cli.ts generate --scenario storefront_main_page --start-time '2026-04-02T21:17:28.487Z' --end-time '2026-04-02T21:22:02.858Z' --format cli)",
+      "Bash(node /tmp/test-duration.js)",
+      "Bash(git add:*)",
+      "Bash(git commit -m ':*)",
+      "Bash(git push:*)",
+      "Bash(ls k6-report-*)",
+      "Bash(rm k6-report-*)",
+      "Bash(git commit:*)",
+      "Read(//tmp/**)",
+      "Bash(ls -t k6-report-*.json)",
+      "Bash(xargs cat:*)",
+      "Bash(INFLUX_TOKEN='JFP9pZu3Sp134rkCZ6gT7FtSBmQRWgl8VmVhFMHTXrbkhKQ3LrvrM4FXECR7Lr8MsDGWLIsU7IJFcjL_QHwvqA==' tsx src/cli.ts generate --scenario storefront_main_page --start-time '2026-04-02T21:17:28.487Z' --end-time '2026-04-02T21:22:02.858Z' --format csv)",
+      "Bash(INFLUX_TOKEN='JFP9pZu3Sp134rkCZ6gT7FtSBmQRWgl8VmVhFMHTXrbkhKQ3LrvrM4FXECR7Lr8MsDGWLIsU7IJFcjL_QHwvqA==' tsx src/cli.ts generate --scenario storefront_main_page --start-time '2026-04-02T21:17:28.487Z' --end-time '2026-04-02T21:22:02.858Z' -f csv)",
+      "Bash(ls -t k6-report-*.csv)",
+      "Bash(ls -t k6-report-*.html)",
+      "Bash(INFLUX_TOKEN='JFP9pZu3Sp134rkCZ6gT7FtSBmQRWgl8VmVhFMHTXrbkhKQ3LrvrM4FXECR7Lr8MsDGWLIsU7IJFcjL_QHwvqA==' npx tsx src/explore.ts)",
+      "Bash(k6-perf-reporter:*)",
+      "Bash(chmod +x .githooks/pre-commit)",
+      "Bash(git config:*)",
+      "Bash(chmod +x:*)",
+      "Bash(ls:*)",
+      "Bash(git reset:*)",
+      "Bash(grep -n 'r.scenario == \"${scenario}\"' /Users/spirohov/github/k6-reporter/src/influx.ts)",
+      "Bash(sed -i '' '/scenario: string,/d' /Users/spirohov/github/k6-reporter/src/influx.ts)",
+      "Bash(sed -i '' 's/_scenario: string,//' /Users/spirohov/github/k6-reporter/src/influx.ts)",
+      "Bash(git checkout:*)",
+      "Bash(python3 /tmp/update_influx.py)",
+      "Bash(python3 /tmp/fix_scenario.py)",
+      "Bash(grep -B 2 -A 2 'r.runId == \"\\\\${runId}\"')",
+      "Bash(python3 /tmp/fix_range.py)",
+      "Bash(bash /tmp/test_runid.sh)",
+      "Bash(grep:*)",
+      "Bash(npm test:*)",
+      "Bash(sed -i 's/IInfluxQueryClient/IInfluxDataExtractor/g' /Users/spirohov/github/k6-reporter/src/influx-data-extractor.ts)",
+      "Bash(sed -i 's/InfluxQueryClient/InfluxDataExtractor/g' /Users/spirohov/github/k6-reporter/src/influx-data-extractor.ts)",
+      "Bash(sed -i 's|from \"./influx-client.interface\"|from \"./influx-data-extractor.interface\"|g' /Users/spirohov/github/k6-reporter/src/influx-data-extractor.ts)",
+      "Bash(git status:*)",
+      "Bash(git rm:*)",
+      "Bash(clear:*)",
+      "Bash(npm list:*)",
+      "Bash(git:*)",
+      "Bash(npm audit:*)",
+      "Bash(npm publish:*)",
+      "Bash(npm login:*)"
+    ]
+  }
+}

package/.config.example.json

@@ -0,0 +1,8 @@
+{
+  "influx": {
+    "url": "http://localhost:8086",
+    "token": "${INFLUX_TOKEN}",
+    "org": "my-org",
+    "bucket": "k6"
+  }
+}

package/.config.json

@@ -0,0 +1,8 @@
+{
+  "influx": {
+    "url": "https://influx.cmn.monomarket.tech",
+    "token": "JFP9pZu3Sp134rkCZ6gT7FtSBmQRWgl8VmVhFMHTXrbkhKQ3LrvrM4FXECR7Lr8MsDGWLIsU7IJFcjL_QHwvqA==",
+    "org": "ced1cdfb28534a3e",
+    "bucket": "jmeter"
+  }
+}

package/.eslintrc.json

@@ -0,0 +1,18 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "parserOptions": {
+    "ecmaVersion": 2020,
+    "sourceType": "module"
+  },
+  "env": {
+    "node": true,
+    "es2020": true
+  },
+  "rules": {
+    "@typescript-eslint/no-explicit-any": "warn"
+  }
+}

package/.github/workflows/build.yml

@@ -0,0 +1,30 @@
+name: Build and Check
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Type check
+        run: npm run type-check
+
+      - name: Build
+        run: npm run build

package/.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run lint
+        run: npm run lint
+
+      - name: Run type check
+        run: npm run type-check
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to npm
+        run: npm publish --provenance
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/README.md

@@ -0,0 +1,449 @@
+# k6-perf-reporter
+
+A comprehensive reporting tool for k6 performance tests with InfluxDB 2 integration. Generates beautiful HTML, PDF, CSV, and JSON reports with key performance metrics.
+
+## Features
+
+- **Multiple Report Formats**: HTML, PDF, CSV, JSON, and CLI output
+- **InfluxDB 2 Integration**: Query test metrics directly from InfluxDB
+- **Key Metrics**: Response time percentiles (p50, p95, p99), throughput, error rates, and error breakdown
+- **Professional Reports**: Beautiful, interactive HTML reports with responsive design
+- **CLI Tool**: Command-line interface for automated report generation
+- **Library Support**: Use as a TypeScript/JavaScript library in your own tools
+
+## Quick Start
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Generate an HTML report
+npx tsx src/cli.ts generate \
+  --scenario api-load-test \
+  --start-time "2024-01-01T00:00:00Z" \
+  --end-time "2024-01-01T01:00:00Z" \
+  --format html
+```
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Usage
+
+### As a CLI Tool
+
+#### HTML Report
+```bash
+npx tsx src/cli.ts generate \
+  --scenario api-load-test \
+  --start-time "2024-01-01T00:00:00Z" \
+  --end-time "2024-01-01T01:00:00Z" \
+  --format html
+```
+
+Generates a beautiful, interactive HTML report with:
+- Color-coded performance metric cards
+- Responsive design that works on all devices
+- Executive summary section
+- Detailed error breakdown table
+- Professional styling with gradient headers
+
+#### PDF Report
+```bash
+npx tsx src/cli.ts generate \
+  --scenario api-load-test \
+  --start-time "2024-01-01T00:00:00Z" \
+  --end-time "2024-01-01T01:00:00Z" \
+  --format pdf
+```
+
+Creates a printable PDF version of the HTML report for archival and sharing.
+
+#### CSV Report
+```bash
+npx tsx src/cli.ts generate \
+  --scenario api-load-test \
+  --start-time "2024-01-01T00:00:00Z" \
+  --end-time "2024-01-01T01:00:00Z" \
+  --format csv
+```
+
+Exports metrics in CSV format for import into Excel, Google Sheets, or data analysis tools.
+
+Example CSV output:
+```
+k6 Performance Test Report
+Test Name,api-load-test
+Generated,2024-01-01T12:00:00Z
+
+RESPONSE TIME METRICS
+Metric,Value (ms)
+P50,125.45
+P95,385.67
+P99,892.34
+
+THROUGHPUT & REQUESTS
+Metric,Value
+Throughput (req/s),156.23
+Total Requests,10000
+Successful Requests,9950
+Failed Requests,50
+Error Rate (%),0.50
+
+ERROR BREAKDOWN
+Error Type,Count
+ConnectionError,30
+TimeoutError,15
+HTTPError500,5
+```
+
+#### JSON Report
+```bash
+npx tsx src/cli.ts generate \
+  --scenario api-load-test \
+  --start-time "2024-01-01T00:00:00Z" \
+  --end-time "2024-01-01T01:00:00Z" \
+  --format json
+```
+
+Generates machine-readable JSON for programmatic access:
+```json
+{
+  "testName": "api-load-test",
+  "generatedAt": "2024-01-01T12:00:00Z",
+  "metrics": {
+    "responseTime": {
+      "p50": 125.45,
+      "p95": 385.67,
+      "p99": 892.34
+    },
+    "throughput": {
+      "requestsPerSecond": 156.23
+    },
+    "requests": {
+      "total": 10000,
+      "successful": 9950,
+      "failed": 50,
+      "errorRate": 0.50
+    },
+    "errors": {
+      "ConnectionError": 30,
+      "TimeoutError": 15,
+      "HTTPError500": 5
+    }
+  }
+}
+```
+
+#### CLI Output
+```bash
+npx tsx src/cli.ts generate \
+  --scenario api-load-test \
+  --start-time "2024-01-01T00:00:00Z" \
+  --end-time "2024-01-01T01:00:00Z" \
+  --format cli
+```
+
+Displays a pretty-printed table in your terminal:
+```
+━━━ k6 Performance Test Report ━━━
+
+Test: api-load-test
+Generated: 1/1/2024, 12:00:00 PM
+
+📊 Response Times
+┌────────┬───────────┐
+│ Metric │ Value     │
+├────────┼───────────┤
+│ P50    │ 125.45 ms │
+│ P95    │ 385.67 ms │
+│ P99    │ 892.34 ms │
+└────────┴───────────┘
+
+⚡ Throughput & Requests
+┌──────────────────────┬──────────┐
+│ Metric               │ Value    │
+├──────────────────────┼──────────┤
+│ Throughput           │ 156.23 req/s │
+│ Total Requests       │ 10000    │
+│ Successful Requests  │ 9950     │
+│ Failed Requests      │ 50       │
+└──────────────────────┴──────────┘
+
+❌ Error Analysis
+┌────────────┬─────────┐
+│ Metric     │ Value   │
+├────────────┼─────────┤
+│ Error Rate │ 0.50 %  │
+└────────────┴─────────┘
+
+Overall Status: ✓ PASS
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### As a Library
+
+```typescript
+import {
+  InfluxQueryClient,
+  ReportGenerator,
+  CLIReporter,
+} from "k6-perf-reporter";
+
+const influxConfig = {
+  url: "http://localhost:8086",
+  token: "your-token",
+  org: "your-org",
+  bucket: "k6",
+};
+
+const influxClient = new InfluxQueryClient(influxConfig);
+const reportGenerator = new ReportGenerator(influxClient);
+
+// Generate metrics for the last hour
+const metrics = await reportGenerator.generateMetrics(
+  "api-load-test",
+  "-1h",
+  "now()"
+);
+
+// Print to CLI
+const cliReporter = new CLIReporter();
+cliReporter.printMetricsTable(metrics, "api-load-test");
+
+// Or generate formatted reports
+const htmlReport = reportGenerator.generateHTMLReport(metrics, "api-load-test");
+const jsonReport = reportGenerator.generateJSONReport(metrics, "api-load-test");
+const csvReport = reportGenerator.generateCSVReport(metrics, "api-load-test");
+
+// Save to file
+import fs from "fs";
+fs.writeFileSync("report.html", htmlReport);
+fs.writeFileSync("report.json", jsonReport);
+fs.writeFileSync("report.csv", csvReport);
+```
+
+## Metrics Included
+
+- **Response Times**: p50, p95, p99 percentiles (milliseconds)
+- **Throughput**: Requests per second
+- **Requests**: Total, successful, and failed counts
+- **Error Rate**: Percentage of failed requests
+- **Error Breakdown**: Distribution of error types with counts
+
+## Time Format Examples
+
+For InfluxDB time queries, use relative or absolute formats:
+
+```bash
+# Last hour
+--start-time "-1h" --end-time "now()"
+
+# Last 24 hours
+--start-time "-24h" --end-time "now()"
+
+# Specific date range (ISO 8601)
+--start-time "2024-01-01T00:00:00Z" --end-time "2024-01-02T00:00:00Z"
+
+# Last 30 minutes
+--start-time "-30m" --end-time "now()"
+```
+
+## Environment Variables
+
+Set these for easier usage:
+
+```bash
+export INFLUX_URL=http://localhost:8086
+export INFLUX_TOKEN=your-influx-token
+export INFLUX_ORG=your-org
+export INFLUX_BUCKET=k6
+```
+
+Then use:
+```bash
+npx tsx src/cli.ts generate \
+  --url $INFLUX_URL \
+  --token $INFLUX_TOKEN \
+  --org $INFLUX_ORG \
+  --bucket $INFLUX_BUCKET \
+  --test-name api-load-test \
+  --start-time "-1h" \
+  --end-time "now()" \
+  --format html
+```
+
+## Prerequisites
+
+- Node.js 16+
+- InfluxDB 2.x with k6 test data
+- For PDF generation: Puppeteer (included in dependencies)
+
+## InfluxDB Setup
+
+Configure your k6 tests to output to InfluxDB 2:
+
+```javascript
+import http from "k6/http";
+import { check } from "k6";
+
+export const options = {
+  vus: 10,
+  duration: "1m",
+  thresholds: {
+    http_req_duration: ["p(95)<500", "p(99)<1000"],
+    http_req_failed: ["rate<0.1"],
+  },
+};
+
+export default function () {
+  const res = http.get("http://api.example.com/users");
+  check(res, {
+    "status is 200": (r) => r.status === 200,
+    "response time < 500ms": (r) => r.timings.duration < 500,
+  });
+}
+```
+
+Run with InfluxDB output:
+```bash
+k6 run script.js \
+  -o xk6-influxdb=http://localhost:8086/testdata \
+  --tag testName=api-load-test
+```
+
+## Full Example Workflow
+
+1. **Run your k6 test with InfluxDB output:**
+```bash
+k6 run load-test.js \
+  -o xk6-influxdb=http://localhost:8086/k6db \
+  --tag testName=checkout-flow-test
+```
+
+2. **Wait for test to complete, then generate reports:**
+```bash
+# Generate HTML report
+npx tsx src/cli.ts generate \
+  --url http://localhost:8086 \
+  --token your-token \
+  --org your-org \
+  --bucket k6db \
+  --test-name checkout-flow-test \
+  --start-time "-30m" \
+  --end-time "now()" \
+  --format html \
+  --output reports/checkout-flow-test.html
+
+# Generate JSON for CI/CD integration
+npx tsx src/cli.ts generate \
+  --url http://localhost:8086 \
+  --token your-token \
+  --org your-org \
+  --bucket k6db \
+  --test-name checkout-flow-test \
+  --start-time "-30m" \
+  --end-time "now()" \
+  --format json \
+  --output reports/checkout-flow-test.json
+
+# Generate CSV for spreadsheet analysis
+npx tsx src/cli.ts generate \
+  --url http://localhost:8086 \
+  --token your-token \
+  --org your-org \
+  --bucket k6db \
+  --test-name checkout-flow-test \
+  --start-time "-30m" \
+  --end-time "now()" \
+  --format csv \
+  --output reports/checkout-flow-test.csv
+
+# Print summary to terminal
+npx tsx src/cli.ts generate \
+  --url http://localhost:8086 \
+  --token your-token \
+  --org your-org \
+  --bucket k6db \
+  --test-name checkout-flow-test \
+  --start-time "-30m" \
+  --end-time "now()" \
+  --format cli
+```
+
+3. **Integrate with CI/CD:**
+```bash
+#!/bin/bash
+# ci-report.sh
+
+TEST_NAME="production-api-test"
+START_TIME="-1h"
+END_TIME="now()"
+
+# Generate report
+npx tsx src/cli.ts generate \
+  --url $INFLUX_URL \
+  --token $INFLUX_TOKEN \
+  --org $INFLUX_ORG \
+  --bucket $INFLUX_BUCKET \
+  --scenario $TEST_NAME \
+  --start-time $START_TIME \
+  --end-time $END_TIME \
+  --format json \
+  --output test-results.json
+
+# Parse and check thresholds
+ERROR_RATE=$(jq '.metrics.requests.errorRate' test-results.json)
+if (( $(echo "$ERROR_RATE > 5.0" | bc -l) )); then
+  echo "Error rate too high: $ERROR_RATE%"
+  exit 1
+fi
+
+echo "Test passed! Error rate: $ERROR_RATE%"
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Type checking
+npm run type-check
+
+# Linting
+npm run lint
+
+# Build
+npm run build
+
+# Development mode
+npm run dev
+```
+
+## Architecture
+
+```
+src/
+├── influx.ts          # InfluxDB client and query logic
+├── reports.ts         # Report generation (HTML, CSV, JSON)
+├── cli-reporter.ts    # CLI table formatting
+├── cli.ts             # Command-line interface
+└── index.ts           # Library exports
+```
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/cli-reporter.d.ts

@@ -0,0 +1,5 @@
+import { TestMetrics } from "./influx";
+export declare class CLIReporter {
+    printMetricsTable(metrics: TestMetrics, testName: string): void;
+}
+//# sourceMappingURL=cli-reporter.d.ts.map

package/dist/cli-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-reporter.d.ts","sourceRoot":"","sources":["../src/cli-reporter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,qBAAa,WAAW;IACtB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAkEhE"}

package/dist/cli-reporter.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLIReporter = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const table_1 = require("table");
+class CLIReporter {
+    printMetricsTable(metrics, testName) {
+        console.log("\n" + chalk_1.default.bold.cyan("━━━ k6 Performance Test Report ━━━\n"));
+        console.log(chalk_1.default.bold(`Test: ${testName}`));
+        console.log(chalk_1.default.gray(`Generated: ${new Date().toLocaleString()}\n`));
+        // Response Times
+        console.log(chalk_1.default.bold.yellow("📊 Response Times"));
+        const responseTimes = [
+            ["Metric", "Value"],
+            ["P50", `${metrics.responseTimeP50.toFixed(2)} ms`],
+            ["P95", `${metrics.responseTimeP95.toFixed(2)} ms`],
+            ["P99", `${metrics.responseTimeP99.toFixed(2)} ms`],
+        ];
+        console.log((0, table_1.table)(responseTimes) + "\n");
+        // Throughput & Requests
+        console.log(chalk_1.default.bold.yellow("⚡ Throughput & Requests"));
+        const throughputData = [
+            ["Metric", "Value"],
+            ["Throughput", `${metrics.throughput.toFixed(2)} req/s`],
+            ["Total Requests", metrics.totalRequests.toString()],
+            [
+                "Successful Requests",
+                chalk_1.default.green(metrics.successfulRequests.toString()),
+            ],
+            [
+                "Failed Requests",
+                metrics.failedRequests > 0
+                    ? chalk_1.default.red(metrics.failedRequests.toString())
+                    : metrics.failedRequests.toString(),
+            ],
+        ];
+        console.log((0, table_1.table)(throughputData) + "\n");
+        // Error Rate
+        console.log(chalk_1.default.bold.yellow("❌ Error Analysis"));
+        const errorRateColor = metrics.errorRate < 1
+            ? chalk_1.default.green
+            : metrics.errorRate < 5
+                ? chalk_1.default.yellow
+                : chalk_1.default.red;
+        const errorData = [
+            ["Metric", "Value"],
+            ["Error Rate", errorRateColor(`${metrics.errorRate.toFixed(2)} %`)],
+        ];
+        console.log((0, table_1.table)(errorData) + "\n");
+        // Error Breakdown
+        if (metrics.errors.size > 0) {
+            console.log(chalk_1.default.bold.yellow("🔍 Error Breakdown"));
+            const errorBreakdown = [["Error Type", "Count"]];
+            metrics.errors.forEach((count, error) => {
+                errorBreakdown.push([error, count.toString()]);
+            });
+            console.log((0, table_1.table)(errorBreakdown) + "\n");
+        }
+        // Status
+        const status = metrics.errorRate < 5
+            ? chalk_1.default.green.bold("✓ PASS")
+            : chalk_1.default.red.bold("✗ FAIL");
+        console.log(chalk_1.default.bold(`Overall Status: ${status}`));
+        console.log(chalk_1.default.gray("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n"));
+    }
+}
+exports.CLIReporter = CLIReporter;
+//# sourceMappingURL=cli-reporter.js.map