@ocpp-debugkit/toolkit 0.2.0 → 0.3.0

package/README.md

@@ -1,35 +1,257 @@
 # @ocpp-debugkit/toolkit
 
-Open-source DevTools for debugging OCPP charging sessions.
+Open-source DevTools for debugging OCPP (Open Charge Point Protocol) charging
+sessions — trace parser, failure detection, scenario evaluator, replay engine,
+report generation, React components, and CLI.
+
+## Features
+
+- **Trace Parser** — Parse OCPP 1.6 JSON traces in JSON Object, JSONL, or bare
+  array format. Safe parsing with size and event-count limits.
+- **Failure Detection** — 10 detection rules covering common failure patterns
+  (failed authorization, connector faults, station offline, heartbeat timeout,
+  meter value gaps, invalid stop reasons, status transition violations,
+  diagnostics failures, firmware update failures, unexpected starts).
+- **Scenario Evaluator** — 10 predefined scenarios with expected failure
+  outcomes for testing the analysis engine. Supports external scenario files.
+- **Replay Engine** — Deterministic, pure replay engine with step forward/back,
+  jump-to-event, and configurable playback speed. No timers or I/O.
+- **Report Generation** — Markdown and HTML report generators with session
+  overview, timeline, failures, and suggested steps.
+- **React Components** — Reusable, SSR-safe presentational components:
+  SessionTimeline, MessageInspector, FailureSummary, ReportViewer,
+  ReplayControls.
+- **CLI** — Command-line interface for inspecting traces, generating reports,
+  and running scenarios.
+- **Browser-Safe** — Core, scenarios, reporter, replay, and react modules have
+  no Node.js built-in dependencies. All trace processing can run client-side.
 
 ## Installation
 
 ```bash
 npm install @ocpp-debugkit/toolkit
+# or
+pnpm add @ocpp-debugkit/toolkit
+# or
+yarn add @ocpp-debugkit/toolkit
+```
+
+For the CLI, install globally:
+
+```bash
+npm install -g @ocpp-debugkit/toolkit
+```
+
+## Subpath Exports
+
+| Import path | Description | Browser-safe |
+|-------------|-------------|:------------:|
+| `@ocpp-debugkit/toolkit` | Root barrel — most common core functions | ✅ |
+| `@ocpp-debugkit/toolkit/core` | Data model, parser, normalizer, timeline, failure detection, validator, summarizer | ✅ |
+| `@ocpp-debugkit/toolkit/scenarios` | Predefined trace scenarios and registry | ✅ |
+| `@ocpp-debugkit/toolkit/reporter` | Markdown and HTML report generators | ✅ |
+| `@ocpp-debugkit/toolkit/replay` | Deterministic replay engine | ✅ |
+| `@ocpp-debugkit/toolkit/react` | Reusable React components (peer dep: `react`) | ✅ |
+| `@ocpp-debugkit/toolkit/cli` | Programmatic CLI entry (Node-only, has shebang) | ❌ |
+| `@ocpp-debugkit/toolkit/fixtures` | Trace fixtures for testing | ✅ |
+
+## Programmatic Usage
+
+### Core — Parse, Detect, Analyze
+
+```typescript
+import {
+  parseTrace,
+  detectFailures,
+  buildSessionTimeline,
+  summarizeSession,
+  validateMessage,
+} from '@ocpp-debugkit/toolkit/core';
+
+// Parse a trace from JSON string, JSONL, or bare array
+const { events, warnings } = parseTrace(jsonString);
+
+// Build session timeline (correlates events by transactionId)
+const sessions = buildSessionTimeline(events);
+
+// Detect failures across all sessions
+const failures = detectFailures(events, sessions);
+
+// Summarize a session
+const summary = summarizeSession(sessions[0]);
+
+// Validate a single OCPP message
+const result = validateMessage(events[0]);
+// → { valid: boolean, errors: string[] }
 ```
 
-## Usage
+### Scenarios — Predefined Test Cases
+
+```typescript
+import { scenarios, getScenario, scenarioNames } from '@ocpp-debugkit/toolkit/scenarios';
+
+// List all scenario names
+console.log(scenarioNames);
+// → ['normal-session', 'failed-auth', 'connector-fault', ...]
+
+// Get a specific scenario
+const scenario = getScenario('failed-auth');
+// → { name, description, trace, expectedFailures }
+
+// Run through the analysis engine
+const { events } = parseTrace(JSON.stringify(scenario.trace));
+const sessions = buildSessionTimeline(events);
+const failures = detectFailures(events, sessions);
+
+// Compare detected vs expected
+const detected = failures.map((f) => f.code);
+const passed = JSON.stringify(detected.sort()) === JSON.stringify(scenario.expectedFailures.sort());
+```
+
+### Reporter — Markdown and HTML Reports
+
+```typescript
+import { generateMarkdownReport, generateHtmlReport } from '@ocpp-debugkit/toolkit/reporter';
+import type { AnalysisResult } from '@ocpp-debugkit/toolkit/reporter';
+
+const analysis: AnalysisResult = {
+  events,
+  sessions,
+  failures,
+  summaries: sessions.map(summarizeSession),
+  warnings,
+};
+
+// Generate Markdown report
+const markdown = generateMarkdownReport(analysis);
+
+// Generate self-contained HTML report (inline CSS, no external deps)
+const html = generateHtmlReport(analysis);
+```
 
-### Modular imports (recommended)
+### Replay — Deterministic Event Replay
 
-```ts
-import { parseTrace, detectFailures, buildSessionTimeline } from '@ocpp-debugkit/toolkit/core';
-import { builtInScenarios, getScenario } from '@ocpp-debugkit/toolkit/scenarios';
-import { generateMarkdownReport } from '@ocpp-debugkit/toolkit/reporter';
+```typescript
 import { ReplayEngine } from '@ocpp-debugkit/toolkit/replay';
-import { SessionTimeline } from '@ocpp-debugkit/toolkit/react';
+
+const engine = new ReplayEngine(events, failures, { startIndex: 0 });
+
+// Step forward
+const next = engine.step();
+// → { event: Event, failures: Failure[], index: number } | null
+
+// Step back
+const prev = engine.stepBack();
+
+// Jump to a specific event
+const state = engine.jumpTo(5);
+
+// Check state
+engine.totalEvents;  // total event count
+engine.current;      // current index (0-based, -1 if no events)
+state.complete;      // true if all events replayed
+```
+
+### React Components — Reusable UI
+
+> **Peer dependencies:** `react` and `react-dom` (v18 or v19) must be installed
+> separately. They are optional peer deps — only required if you use
+> `@ocpp-debugkit/toolkit/react`.
+
+```typescript
+import {
+  SessionTimeline,
+  MessageInspector,
+  FailureSummary,
+  ReportViewer,
+  ReplayControls,
+} from '@ocpp-debugkit/toolkit/react';
+
+// Timeline with click-to-inspect
+<SessionTimeline
+  events={events}
+  selectedEventId={selectedId}
+  onSelectEvent={(id) => setSelectedId(id)}
+/>
+
+// Message detail panel
+<MessageInspector event={selectedEvent} />
+
+// Failure summary with severity and suggested steps
+<FailureSummary failures={failures} />
+
+// HTML report viewer (renders via srcdoc iframe — no dangerouslySetInnerHTML)
+<ReportViewer html={htmlReport} />
+
+// Replay playback controls
+<ReplayControls
+  isPlaying={isPlaying}
+  currentIndex={engine.current}
+  totalEvents={engine.totalEvents}
+  onPlay={() => setPlaying(true)}
+  onPause={() => setPlaying(false)}
+  onStep={() => engine.step()}
+  onStepBack={() => engine.stepBack()}
+  onJump={(i) => engine.jumpTo(i)}
+  speed={1}
+  onSpeedChange={(s) => setSpeed(s)}
+/>
+```
+
+### Fixtures — Synthetic Test Data
+
+```typescript
+import { fixtures, fixtureNames } from '@ocpp-debugkit/toolkit/fixtures';
+
+// Available fixtures: 'normal-session', 'failed-auth', 'connector-fault'
+const trace = fixtures.normalSession;
 ```
 
-### CLI
+## CLI
 
 ```bash
-npm install -g @ocpp-debugkit/toolkit
+# Parse and analyze a trace file
 ocpp-debugkit inspect trace.json
+ocpp-debugkit inspect trace.json --format text
+
+# Generate a report
 ocpp-debugkit report trace.json
+ocpp-debugkit report trace.json --format markdown --output report.md
+ocpp-debugkit report trace.json --format html --output report.html
+
+# List all predefined scenarios
 ocpp-debugkit scenario list
-ocpp-debugkit scenario run normal-session
+
+# Run a built-in scenario through the analysis engine
+ocpp-debugkit scenario run failed-auth
+
+# Run an external scenario file
+ocpp-debugkit scenario run --file ./my-scenario.json
 ```
 
+## Trace Formats
+
+The parser accepts three input formats:
+
+1. **JSON Object** — `{ "traceId": "...", "metadata": {...}, "events": [...] }`
+2. **JSONL** — One event per line: `{ "timestamp": "...", "message": [...] }`
+3. **Bare Array** — `[{ "timestamp": "...", "message": [...] }, ...]`
+
+Each event has a `message` field containing a raw OCPP 1.6 JSON array:
+- **Call:** `[2, "UniqueId", "Action", { ...payload }]`
+- **CallResult:** `[3, "UniqueId", { ...payload }]`
+- **CallError:** `[4, "UniqueId", "ErrorCode", "ErrorDescription", {}]`
+
+See the [trace format specification](https://github.com/ocpp-debugkit/ocpp-debugkit/blob/main/docs/trace-format-spec.md) for full details.
+
+## Links
+
+- [GitHub repository](https://github.com/ocpp-debugkit/ocpp-debugkit)
+- [Documentation](https://ocppdebugkit.com/docs)
+- [Migration guide (v0.1 → v0.2)](https://github.com/ocpp-debugkit/ocpp-debugkit/blob/main/docs/migration.md)
+- [Issue tracker](https://github.com/ocpp-debugkit/ocpp-debugkit/issues)
+- [npm package](https://www.npmjs.com/package/@ocpp-debugkit/toolkit)
+
 ## License
 
-Apache 2.0
+Apache License 2.0 — see [LICENSE](https://github.com/ocpp-debugkit/ocpp-debugkit/blob/main/LICENSE).

package/dist/cli/commands/anonymize.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `ocpp-debugkit anonymize <file>` — strip sensitive fields from a trace file.
+ *
+ * Anonymizes:
+ * - idTag → "anonymized"
+ * - chargePointSerialNumber / stationId → "station-anon"
+ * - transactionId → sequential integers
+ * - meterValue values → preserve relative scale, randomize base
+ * - Any field matching email/phone/IP patterns
+ */
+export interface AnonymizeOptions {
+    output?: string;
+}
+export declare function anonymizeCommand(file: string, options: AnonymizeOptions): Promise<void>;
+//# sourceMappingURL=anonymize.d.ts.map

package/dist/cli/commands/anonymize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anonymize.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/anonymize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmDD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C7F"}

package/dist/cli/commands/anonymize.js

@@ -0,0 +1,104 @@
+/**
+ * `ocpp-debugkit anonymize <file>` — strip sensitive fields from a trace file.
+ *
+ * Anonymizes:
+ * - idTag → "anonymized"
+ * - chargePointSerialNumber / stationId → "station-anon"
+ * - transactionId → sequential integers
+ * - meterValue values → preserve relative scale, randomize base
+ * - Any field matching email/phone/IP patterns
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { CliError } from '../utils.js';
+import { MAX_INPUT_SIZE_BYTES } from '../../core/index.js';
+// Patterns for PII detection
+const EMAIL_RE = /[\w.+-]+@[\w-]+\.[\w.-]+/g;
+const PHONE_RE = /\+?\d{10,15}[-\s]?\d{0,4}[-\s]?\d{0,4}/g;
+const IP_RE = /\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b/g;
+function anonymizeValue(value, txCounter) {
+    if (typeof value === 'string') {
+        let result = value;
+        result = result.replace(EMAIL_RE, '[redacted-email]');
+        result = result.replace(PHONE_RE, '[redacted-phone]');
+        result = result.replace(IP_RE, '[redacted-ip]');
+        return result;
+    }
+    if (typeof value === 'number') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => anonymizeValue(item, txCounter));
+    }
+    if (value !== null && typeof value === 'object') {
+        const obj = value;
+        const result = {};
+        for (const [key, val] of Object.entries(obj)) {
+            // Anonymize known sensitive fields
+            if (key === 'idTag' && typeof val === 'string') {
+                result[key] = 'anonymized';
+            }
+            else if (key === 'chargePointSerialNumber' || key === 'chargeBoxSerialNumber') {
+                result[key] = 'station-anon';
+            }
+            else if (key === 'stationId') {
+                result[key] = 'station-anon';
+            }
+            else if (key === 'transactionId' && typeof val === 'number') {
+                result[key] = txCounter.next++;
+            }
+            else if (key === 'identifier' && typeof val === 'string') {
+                result[key] = 'anonymized';
+            }
+            else {
+                result[key] = anonymizeValue(val, txCounter);
+            }
+        }
+        return result;
+    }
+    return value;
+}
+export async function anonymizeCommand(file, options) {
+    const resolved = resolve(file);
+    // Size check
+    const { statSync } = await import('node:fs');
+    let stats;
+    try {
+        stats = statSync(resolved);
+    }
+    catch {
+        throw new CliError(`File not found: ${file}`);
+    }
+    if (stats.size > MAX_INPUT_SIZE_BYTES) {
+        throw new CliError(`File size (${stats.size} bytes) exceeds maximum allowed (${MAX_INPUT_SIZE_BYTES} bytes).`);
+    }
+    let content;
+    try {
+        content = readFileSync(resolved, 'utf8');
+    }
+    catch {
+        throw new CliError(`Failed to read file: ${file}`);
+    }
+    // Parse JSON
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        throw new CliError('File is not valid JSON.');
+    }
+    // Anonymize
+    const txCounter = { next: 1 };
+    const anonymized = anonymizeValue(parsed, txCounter);
+    // Output
+    const output = JSON.stringify(anonymized, null, 2);
+    if (options.output) {
+        const outputPath = resolve(options.output);
+        writeFileSync(outputPath, output, 'utf8');
+        console.log(`Anonymized trace written to: ${options.output}`);
+    }
+    else {
+        console.log(output);
+    }
+}
+//# sourceMappingURL=anonymize.js.map

package/dist/cli/commands/anonymize.js.map

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

package/dist/cli/commands/ci.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `ocpp-debugkit ci [dir]` — run all scenarios, exit 0 if all pass, 1 if any fail.
+ *
+ * Supports `--format json` for CI tooling and `[dir]` for external scenario files.
+ */
+export interface CiOptions {
+    format: string;
+}
+export declare function ciCommand(dir: string | undefined, options: CiOptions): Promise<void>;
+//# sourceMappingURL=ci.d.ts.map

package/dist/cli/commands/ci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ci.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAUD,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CA+F1F"}

package/dist/cli/commands/ci.js

@@ -0,0 +1,96 @@
+/**
+ * `ocpp-debugkit ci [dir]` — run all scenarios, exit 0 if all pass, 1 if any fail.
+ *
+ * Supports `--format json` for CI tooling and `[dir]` for external scenario files.
+ */
+import { readFileSync, readdirSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { evaluateScenario } from '../../core/assertions.js';
+import { scenarios } from '../../scenarios/index.js';
+export async function ciCommand(dir, options) {
+    const results = [];
+    // Run built-in scenarios
+    for (const scenario of scenarios) {
+        const result = evaluateScenario(scenario);
+        results.push({
+            name: scenario.name,
+            passed: result.allPassed,
+            detectedFailures: result.detectedFailureCodes,
+            expectedFailures: scenario.expectedFailures,
+            assertionResults: result.assertions.map((a) => ({
+                type: a.assertion.type,
+                passed: a.passed,
+                message: a.message,
+            })),
+        });
+    }
+    // Run external scenarios from directory
+    if (dir) {
+        const resolvedDir = resolve(dir);
+        let files;
+        try {
+            files = readdirSync(resolvedDir).filter((f) => f.endsWith('.json'));
+        }
+        catch {
+            console.error(`Error: Cannot read directory: ${dir}`);
+            process.exitCode = 1;
+            return;
+        }
+        for (const file of files) {
+            const filePath = join(resolvedDir, file);
+            try {
+                const content = readFileSync(filePath, 'utf8');
+                const scenario = JSON.parse(content);
+                const result = evaluateScenario(scenario);
+                results.push({
+                    name: scenario.name || file,
+                    passed: result.allPassed,
+                    detectedFailures: result.detectedFailureCodes,
+                    expectedFailures: scenario.expectedFailures || [],
+                    assertionResults: result.assertions.map((a) => ({
+                        type: a.assertion.type,
+                        passed: a.passed,
+                        message: a.message,
+                    })),
+                });
+            }
+            catch {
+                console.error(`Error: Failed to parse scenario file: ${file}`);
+            }
+        }
+    }
+    const allPassed = results.every((r) => r.passed);
+    if (options.format === 'json') {
+        console.log(JSON.stringify({ results, allPassed }, null, 2));
+    }
+    else {
+        console.log('');
+        console.log('═'.repeat(60));
+        console.log('  OCPP DebugKit — CI Mode');
+        console.log('═'.repeat(60));
+        console.log('');
+        for (const result of results) {
+            const status = result.passed ? '✅ PASS' : '❌ FAIL';
+            console.log(`  ${status}  ${result.name}`);
+            if (!result.passed) {
+                if (JSON.stringify(result.detectedFailures.sort()) !==
+                    JSON.stringify(result.expectedFailures.sort())) {
+                    console.log(`         Expected: ${result.expectedFailures.join(', ') || 'none'}`);
+                    console.log(`         Detected: ${result.detectedFailures.join(', ') || 'none'}`);
+                }
+                for (const assertion of result.assertionResults) {
+                    if (!assertion.passed) {
+                        console.log(`         Assertion "${assertion.type}": ${assertion.message}`);
+                    }
+                }
+            }
+        }
+        console.log('');
+        console.log(`  Total: ${results.length} | Passed: ${results.filter((r) => r.passed).length} | Failed: ${results.filter((r) => !r.passed).length}`);
+        console.log('');
+    }
+    if (!allPassed) {
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=ci.js.map

package/dist/cli/commands/ci.js.map

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

package/dist/cli/commands/diff.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `ocpp-debugkit diff <a> <b>` — compare two trace files and output differences.
+ *
+ * Uses `diffTraces()` from the core module.
+ */
+export interface DiffOptions {
+    format: string;
+}
+export declare function diffCommand(fileA: string, fileB: string, options: DiffOptions): Promise<void>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/cli/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/diff.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAsEf"}

package/dist/cli/commands/diff.js

@@ -0,0 +1,71 @@
+/**
+ * `ocpp-debugkit diff <a> <b>` — compare two trace files and output differences.
+ *
+ * Uses `diffTraces()` from the core module.
+ */
+import { parseTrace, diffTraces, ParseError } from '../../core/index.js';
+import { CliError, readTraceFile } from '../utils.js';
+export async function diffCommand(fileA, fileB, options) {
+    const contentA = readTraceFile(fileA);
+    const contentB = readTraceFile(fileB);
+    let resultA, resultB;
+    try {
+        resultA = parseTrace(contentA);
+        resultB = parseTrace(contentB);
+    }
+    catch (e) {
+        if (e instanceof ParseError) {
+            throw new CliError(e.message);
+        }
+        throw new CliError('Failed to parse trace files.');
+    }
+    const diff = diffTraces(resultA, resultB);
+    if (options.format === 'json') {
+        console.log(JSON.stringify(diff, null, 2));
+        return;
+    }
+    // Human-readable output
+    console.log('');
+    console.log('═'.repeat(60));
+    console.log('  OCPP DebugKit — Trace Diff');
+    console.log('═'.repeat(60));
+    console.log('');
+    console.log(`  Events only in A: ${diff.onlyInA.length}`);
+    for (const event of diff.onlyInA) {
+        console.log(`    ${event.action ?? 'Unknown'} (messageId: ${event.messageId})`);
+    }
+    console.log('');
+    console.log(`  Events only in B: ${diff.onlyInB.length}`);
+    for (const event of diff.onlyInB) {
+        console.log(`    ${event.action ?? 'Unknown'} (messageId: ${event.messageId})`);
+    }
+    console.log('');
+    console.log(`  Modified events: ${diff.modified.length}`);
+    for (const mod of diff.modified) {
+        console.log(`    [${mod.field}] messageId: ${mod.messageId}`);
+        console.log(`      A: ${JSON.stringify(mod.valueA)}`);
+        console.log(`      B: ${JSON.stringify(mod.valueB)}`);
+    }
+    console.log('');
+    console.log(`  Failures only in A: ${diff.failuresOnlyInA.length}`);
+    for (const f of diff.failuresOnlyInA) {
+        console.log(`    [${f.severity}] ${f.code}: ${f.description}`);
+    }
+    console.log('');
+    console.log(`  Failures only in B: ${diff.failuresOnlyInB.length}`);
+    for (const f of diff.failuresOnlyInB) {
+        console.log(`    [${f.severity}] ${f.code}: ${f.description}`);
+    }
+    console.log('');
+    console.log('  Summary Differences:');
+    if (diff.summaryDiff.differences.length > 0) {
+        for (const d of diff.summaryDiff.differences) {
+            console.log(`    ${d}`);
+        }
+    }
+    else {
+        console.log('    No summary differences');
+    }
+    console.log('');
+}
+//# sourceMappingURL=diff.js.map

package/dist/cli/commands/diff.js.map

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

package/dist/cli/commands/report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDvF"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DvF"}

package/dist/cli/commands/report.js

@@ -2,7 +2,7 @@
  * `ocpp-debugkit report <file>` — generate a report from an OCPP trace file.
  */
 import { parseTrace, buildSessionTimeline, detectFailures, summarizeSessions, ParseError, } from '../../core/index.js';
-import { generateMarkdownReport } from '../../reporter/index.js';
+import { generateMarkdownReport, generateHtmlReport } from '../../reporter/index.js';
 import { CliError, readTraceFile } from '../utils.js';
 export async function reportCommand(file, options) {
     const content = readTraceFile(file);
@@ -34,14 +34,17 @@ export async function reportCommand(file, options) {
     const sessions = buildSessionTimeline(result.events);
     const failures = detectFailures(result.events, sessions);
     const summaries = summarizeSessions(sessions, failures);
-    const report = generateMarkdownReport({
+    const analysisResult = {
         events: result.events,
         sessions,
         failures,
         summaries,
         warnings: result.warnings,
         metadata,
-    });
+    };
+    const report = options.format === 'html'
+        ? generateHtmlReport(analysisResult)
+        : generateMarkdownReport(analysisResult);
     if (options.output) {
         const { writeFileSync } = await import('node:fs');
         writeFileSync(options.output, report, 'utf8');

package/dist/cli/commands/report.js.map

@@ -1 +1 @@
-{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,UAAU,GAEX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAOtD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,OAAsB;IACtE,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAEpC,gCAAgC;IAChC,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,UAAU,EAAE,CAAC;YAC5B,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;YACvB,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,8BAA8B,CAAC,CAAC;IACrD,CAAC;IAED,uEAAuE;IACvE,IAAI,QAQS,CAAC;IACd,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;YACjE,QAAQ,GAAI,MAAgB,CAAC,QAAQ,CAAC;QACxC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oCAAoC;IACtC,CAAC;IAED,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,sBAAsB,CAAC;QACpC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ;KACT,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,UAAU,GAEX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAOtD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,OAAsB;IACtE,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAEpC,gCAAgC;IAChC,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,UAAU,EAAE,CAAC;YAC5B,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;YACvB,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,8BAA8B,CAAC,CAAC;IACrD,CAAC;IAED,uEAAuE;IACvE,IAAI,QAQS,CAAC;IACd,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;YACjE,QAAQ,GAAI,MAAgB,CAAC,QAAQ,CAAC;QACxC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oCAAoC;IACtC,CAAC;IAED,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAExD,MAAM,cAAc,GAAG;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ;KACT,CAAC;IAEF,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,KAAK,MAAM;QACvB,CAAC,CAAC,kBAAkB,CAAC,cAAc,CAAC;QACpC,CAAC,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAE7C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}