@ocpp-debugkit/toolkit 0.2.0

package/dist/core/types.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Core type definitions for OCPP DebugKit.
+ *
+ * These are the proposed canonical types from the M0.5 design phase
+ * (ADR-0003 through ADR-0006). They will be fully implemented with Zod
+ * schemas in v0.1.0 (Issue #13).
+ */
+/**
+ * Direction of an OCPP message.
+ * @see ADR-0004
+ */
+export type Direction = 'CS_TO_CSMS' | 'CSMS_TO_CS' | 'UNKNOWN';
+/**
+ * OCPP 1.6 JSON message type.
+ * - Call (2): request from one side to the other.
+ * - CallResult (3): successful response.
+ * - CallError (4): error response.
+ */
+export type MessageType = 'Call' | 'CallResult' | 'CallError';
+/**
+ * A raw OCPP 1.6 JSON message as it appears on the wire.
+ * The shape depends on the message type:
+ * - Call:        [2, UniqueId, Action, Payload]
+ * - CallResult:  [3, UniqueId, Payload]
+ * - CallError:   [4, UniqueId, ErrorCode, ErrorDescription, ErrorDetails]
+ */
+export type RawOcppMessage = [number, string, ...unknown[]];
+/**
+ * A trace event entry as it appears in a trace file (JSON Object or JSONL).
+ * This is the input shape before normalization.
+ */
+export interface TraceEventInput {
+    /** ISO 8601 string or Unix epoch (ms or s). Optional. */
+    timestamp?: string | number | null;
+    /** Direction of the message. Inferred if absent. */
+    direction?: Direction;
+    /** Raw OCPP 1.6 JSON message array. */
+    message: RawOcppMessage;
+}
+/**
+ * The canonical normalized event used internally by DebugKit.
+ * @see ADR-0003
+ */
+export interface Event {
+    /** Generated unique event ID (sequential, stable within a parse). */
+    id: string;
+    /** OCPP UniqueId from the message array. */
+    messageId: string;
+    /** Normalized timestamp in epoch milliseconds. null if missing. */
+    timestamp: number | null;
+    /** Direction of the message. */
+    direction: Direction;
+    /** OCPP message type. */
+    messageType: MessageType;
+    /** OCPP action name (e.g., "BootNotification"). Present only for Call messages. */
+    action: string | null;
+    /** OCPP payload object. */
+    payload: unknown;
+    /** Error code, present only for CallError messages. */
+    errorCode: string | null;
+    /** Error description, present only for CallError messages. */
+    errorDescription: string | null;
+    /** The original raw OCPP message array, unmodified. */
+    rawMessage: RawOcppMessage;
+}
+/**
+ * Metadata for a trace file.
+ */
+export interface TraceMetadata {
+    stationId?: string;
+    ocppVersion?: string;
+    source?: string;
+    description?: string;
+}
+/**
+ * The JSON Object trace format.
+ * @see ADR-0002, docs/trace-format-spec.md
+ */
+export interface Trace {
+    traceId?: string;
+    metadata?: TraceMetadata;
+    events: TraceEventInput[];
+}
+/**
+ * A logical charging session derived from trace events.
+ * @see ADR-0006
+ */
+export interface Session {
+    sessionId: string;
+    stationId: string;
+    connectorId: number | null;
+    transactionId: number | null;
+    startTime: number | null;
+    endTime: number | null;
+    events: Event[];
+    status: 'active' | 'completed' | 'aborted';
+}
+/**
+ * A warning produced during parsing when an individual event is malformed.
+ * @see ADR-0007
+ */
+export interface ParseWarning {
+    index: number;
+    message: string;
+    rawInput?: string;
+}
+/**
+ * Result of parsing a trace.
+ */
+export interface ParseResult {
+    events: Event[];
+    warnings: ParseWarning[];
+}
+/** Severity of a detected failure. */
+export type FailureSeverity = 'critical' | 'warning' | 'info';
+/** Failure rule codes implemented in v0.1. */
+export type FailureCode = 'FAILED_AUTHORIZATION' | 'CONNECTOR_FAULT' | 'STATION_OFFLINE_DURING_SESSION';
+/**
+ * A detected failure in a trace.
+ */
+export interface Failure {
+    /** Failure rule code. */
+    code: FailureCode;
+    /** Human-readable description. */
+    description: string;
+    /** Severity level. */
+    severity: FailureSeverity;
+    /** Event IDs associated with the failure. */
+    eventIds: string[];
+    /** Suggested next steps for resolution. */
+    suggestedSteps: string[];
+}
+/** Summary statistics for a charging session. */
+export interface SessionSummary {
+    sessionId: string;
+    stationId: string;
+    connectorId: number | null;
+    transactionId: number | null;
+    status: 'active' | 'completed' | 'aborted';
+    eventCount: number;
+    durationMs: number | null;
+    failureCount: number;
+    /** Ordered list of actions in the session. */
+    actionSequence: string[];
+}
+/** Result of validating a single OCPP message. */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/** A scenario fixture for testing the analysis engine. */
+export interface Scenario {
+    name: string;
+    description: string;
+    /** The trace data to analyze. */
+    trace: Trace;
+    /** Failure codes expected to be detected. */
+    expectedFailures: FailureCode[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/types.js

@@ -0,0 +1,9 @@
+/**
+ * Core type definitions for OCPP DebugKit.
+ *
+ * These are the proposed canonical types from the M0.5 design phase
+ * (ADR-0003 through ADR-0006). They will be fully implemented with Zod
+ * schemas in v0.1.0 (Issue #13).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/core/validator.d.ts

@@ -0,0 +1,33 @@
+/**
+ * OCPP message validator — checks structural compliance of individual messages.
+ *
+ * Validates that an OCPP 1.6 JSON message conforms to the protocol's
+ * structural requirements.
+ *
+ * @see docs/trace-format-spec.md
+ */
+import type { Event, ValidationResult } from './types.js';
+/**
+ * Validate a single OCPP message for structural compliance.
+ *
+ * Checks:
+ * - Message array has correct minimum length for its type
+ * - MessageTypeId is 2, 3, or 4
+ * - UniqueId is a non-empty string
+ * - Call messages have a string Action
+ * - CallError messages have ErrorCode and ErrorDescription
+ * - MessageType field is consistent with raw message's MessageTypeId
+ *
+ * @param event - The event to validate
+ * @param allEvents - Optional: all events in the trace (for Call/Response matching)
+ * @returns Validation result with errors array
+ */
+export declare function validateMessage(event: Event, allEvents?: Event[]): ValidationResult;
+/**
+ * Validate all events in a trace.
+ *
+ * @param events - All events in the trace
+ * @returns Map of event ID to validation result
+ */
+export declare function validateMessages(events: Event[]): Map<string, ValidationResult>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/core/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/core/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAe,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA+FvE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAcnF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAQ/E"}

package/dist/core/validator.js

@@ -0,0 +1,122 @@
+/**
+ * OCPP message validator — checks structural compliance of individual messages.
+ *
+ * Validates that an OCPP 1.6 JSON message conforms to the protocol's
+ * structural requirements.
+ *
+ * @see docs/trace-format-spec.md
+ */
+// ---------------------------------------------------------------------------
+// Validation rules
+// ---------------------------------------------------------------------------
+/**
+ * Validate the message structure based on its type.
+ *
+ * Call (2):        [2, UniqueId, Action, Payload] — 4+ elements, Action is string
+ * CallResult (3):  [3, UniqueId, Payload] — 3+ elements
+ * CallError (4):   [4, UniqueId, ErrorCode, ErrorDescription, ErrorDetails] — 5+ elements
+ */
+function validateMessageStructure(event) {
+    const errors = [];
+    const msg = event.rawMessage;
+    const msgType = event.messageType;
+    // Check minimum length
+    const minLength = msgType === 'Call' ? 4 : msgType === 'CallResult' ? 3 : 5;
+    if (msg.length < minLength) {
+        errors.push(`${msgType} message must have at least ${minLength} elements (has ${msg.length})`);
+    }
+    // Check MessageTypeId (index 0)
+    if (msg[0] !== 2 && msg[0] !== 3 && msg[0] !== 4) {
+        errors.push(`Invalid MessageTypeId: ${msg[0]} (expected 2, 3, or 4)`);
+    }
+    // Check UniqueId (index 1)
+    if (typeof msg[1] !== 'string' || msg[1] === '') {
+        errors.push('UniqueId (index 1) must be a non-empty string');
+    }
+    // Call-specific: Action (index 2) must be a string
+    if (msgType === 'Call') {
+        if (typeof msg[2] !== 'string' || msg[2] === '') {
+            errors.push('Call Action (index 2) must be a non-empty string');
+        }
+    }
+    // CallError-specific: ErrorCode and ErrorDescription
+    if (msgType === 'CallError') {
+        if (typeof msg[2] !== 'string' || msg[2] === '') {
+            errors.push('CallError ErrorCode (index 2) must be a non-empty string');
+        }
+        if (typeof msg[3] !== 'string') {
+            errors.push('CallError ErrorDescription (index 3) must be a string');
+        }
+    }
+    return errors;
+}
+/**
+ * Validate that the event's messageType matches the raw message's MessageTypeId.
+ */
+function validateTypeConsistency(event) {
+    const errors = [];
+    const expectedType = event.rawMessage[0] === 2 ? 'Call' : event.rawMessage[0] === 3 ? 'CallResult' : 'CallError';
+    if (event.messageType !== expectedType) {
+        errors.push(`MessageType mismatch: event says "${event.messageType}" but raw message has MessageTypeId ${event.rawMessage[0]} ("${expectedType}")`);
+    }
+    return errors;
+}
+/**
+ * Validate that CallResult/CallError have a matching Call.
+ * This is a soft validation — the function checks if there's a Call with
+ * the same messageId in the provided event list.
+ */
+function validateResponseHasCall(event, allEvents) {
+    const errors = [];
+    if (event.messageType === 'CallResult' || event.messageType === 'CallError') {
+        const hasCall = allEvents.some((e) => e.messageType === 'Call' && e.messageId === event.messageId);
+        if (!hasCall) {
+            errors.push(`${event.messageType} with messageId "${event.messageId}" has no matching Call`);
+        }
+    }
+    return errors;
+}
+// ---------------------------------------------------------------------------
+// validateMessage()
+// ---------------------------------------------------------------------------
+/**
+ * Validate a single OCPP message for structural compliance.
+ *
+ * Checks:
+ * - Message array has correct minimum length for its type
+ * - MessageTypeId is 2, 3, or 4
+ * - UniqueId is a non-empty string
+ * - Call messages have a string Action
+ * - CallError messages have ErrorCode and ErrorDescription
+ * - MessageType field is consistent with raw message's MessageTypeId
+ *
+ * @param event - The event to validate
+ * @param allEvents - Optional: all events in the trace (for Call/Response matching)
+ * @returns Validation result with errors array
+ */
+export function validateMessage(event, allEvents) {
+    const errors = [];
+    errors.push(...validateMessageStructure(event));
+    errors.push(...validateTypeConsistency(event));
+    if (allEvents) {
+        errors.push(...validateResponseHasCall(event, allEvents));
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Validate all events in a trace.
+ *
+ * @param events - All events in the trace
+ * @returns Map of event ID to validation result
+ */
+export function validateMessages(events) {
+    const results = new Map();
+    for (const event of events) {
+        results.set(event.id, validateMessage(event, events));
+    }
+    return results;
+}
+//# sourceMappingURL=validator.js.map

package/dist/core/validator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @ocpp-debugkit/toolkit — Open-source DevTools for debugging OCPP charging sessions.
+ *
+ * @module @ocpp-debugkit/toolkit
+ *
+ * The root barrel re-exports the most commonly used functions from the
+ * core module. For full modular consumption, use subpath exports:
+ *
+ *   import { parseTrace } from '@ocpp-debugkit/toolkit/core';
+ *   import { builtInScenarios } from '@ocpp-debugkit/toolkit/scenarios';
+ *   import { generateMarkdownReport } from '@ocpp-debugkit/toolkit/reporter';
+ *   import { ReplayEngine } from '@ocpp-debugkit/toolkit/replay';
+ *   import { SessionTimeline } from '@ocpp-debugkit/toolkit/react';
+ */
+export { parseTrace, ParseError, MAX_INPUT_SIZE_BYTES, MAX_EVENT_COUNT, type TraceFormat, } from './core/index.js';
+export { normalizeEvents, normalizeTimestamp, inferDirection, reverseDirection, classifyMessageType, extractAction, extractPayload, extractErrorCode, extractErrorDescription, } from './core/index.js';
+export { buildSessionTimeline } from './core/index.js';
+export { detectFailures } from './core/index.js';
+export { summarizeSession, summarizeSessions } from './core/index.js';
+export { validateMessage, validateMessages } from './core/index.js';
+export type { Trace, Event, Session, Failure, Scenario, SessionSummary, ValidationResult, RawOcppMessage, Direction, MessageType, FailureSeverity, FailureCode, TraceEventInput, TraceMetadata, ParseWarning, ParseResult, } from './core/index.js';
+export { directionSchema, messageTypeSchema, rawOcppMessageSchema, traceEventInputSchema, traceMetadataSchema, traceSchema, bareArraySchema, } from './core/index.js';
+export { fixtures, fixtureNames } from './core/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EACL,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGpE,YAAY,EACV,KAAK,EACL,KAAK,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,WAAW,EACX,eAAe,EACf,WAAW,EACX,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,EACX,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * @ocpp-debugkit/toolkit — Open-source DevTools for debugging OCPP charging sessions.
+ *
+ * @module @ocpp-debugkit/toolkit
+ *
+ * The root barrel re-exports the most commonly used functions from the
+ * core module. For full modular consumption, use subpath exports:
+ *
+ *   import { parseTrace } from '@ocpp-debugkit/toolkit/core';
+ *   import { builtInScenarios } from '@ocpp-debugkit/toolkit/scenarios';
+ *   import { generateMarkdownReport } from '@ocpp-debugkit/toolkit/reporter';
+ *   import { ReplayEngine } from '@ocpp-debugkit/toolkit/replay';
+ *   import { SessionTimeline } from '@ocpp-debugkit/toolkit/react';
+ */
+// Re-export the most commonly used core functions for convenience
+export { parseTrace, ParseError, MAX_INPUT_SIZE_BYTES, MAX_EVENT_COUNT, } from './core/index.js';
+export { normalizeEvents, normalizeTimestamp, inferDirection, reverseDirection, classifyMessageType, extractAction, extractPayload, extractErrorCode, extractErrorDescription, } from './core/index.js';
+export { buildSessionTimeline } from './core/index.js';
+export { detectFailures } from './core/index.js';
+export { summarizeSession, summarizeSessions } from './core/index.js';
+export { validateMessage, validateMessages } from './core/index.js';
+// Re-export schemas
+export { directionSchema, messageTypeSchema, rawOcppMessageSchema, traceEventInputSchema, traceMetadataSchema, traceSchema, bareArraySchema, } from './core/index.js';
+// Re-export fixtures
+export { fixtures, fixtureNames } from './core/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,kEAAkE;AAClE,OAAO,EACL,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,eAAe,GAEhB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAsBpE,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,EACX,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,qBAAqB;AACrB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/react/components.d.ts

@@ -0,0 +1,50 @@
+/**
+ * React component stubs for @ocpp-debugkit/toolkit/react.
+ *
+ * v0.2.0: These are stub implementations — presentational components
+ * that will be fully extracted from the Inspector in Phase 4.
+ * They are functional but minimal, using no external CSS framework.
+ */
+import type { SessionTimelineProps, MessageInspectorProps, FailureSummaryProps, ReportViewerProps, ReplayControlsProps } from './types.js';
+export declare function SessionTimeline({ events, selectedEventId, onSelectEvent }: SessionTimelineProps): {
+    readonly type: "SessionTimeline";
+    readonly props: {
+        readonly events: import("../index.js").Event[];
+        readonly selectedEventId: string | null | undefined;
+        readonly onSelectEvent: ((eventId: string) => void) | undefined;
+    };
+};
+export declare function MessageInspector({ event }: MessageInspectorProps): {
+    readonly type: "MessageInspector";
+    readonly props: {
+        readonly event: import("../index.js").Event | null;
+    };
+};
+export declare function FailureSummary({ failures }: FailureSummaryProps): {
+    readonly type: "FailureSummary";
+    readonly props: {
+        readonly failures: import("../index.js").Failure[];
+    };
+};
+export declare function ReportViewer({ html }: ReportViewerProps): {
+    readonly type: "ReportViewer";
+    readonly props: {
+        readonly html: string;
+    };
+};
+export declare function ReplayControls({ isPlaying, currentIndex, totalEvents, onPlay, onPause, onStep, onStepBack, onJump, speed, onSpeedChange, }: ReplayControlsProps): {
+    readonly type: "ReplayControls";
+    readonly props: {
+        readonly isPlaying: boolean;
+        readonly currentIndex: number;
+        readonly totalEvents: number;
+        readonly onPlay: () => void;
+        readonly onPause: () => void;
+        readonly onStep: () => void;
+        readonly onStepBack: () => void;
+        readonly onJump: (index: number) => void;
+        readonly speed: number | undefined;
+        readonly onSpeedChange: ((speed: number) => void) | undefined;
+    };
+};
+//# sourceMappingURL=components.d.ts.map

package/dist/react/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/react/components.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,EAAE,oBAAoB;;;;;;;EAK/F;AAED,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE,qBAAqB;;;;;EAKhE;AAED,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,mBAAmB;;;;;EAK/D;AAED,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,iBAAiB;;;;;EAKvD;AAED,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,YAAY,EACZ,WAAW,EACX,MAAM,EACN,OAAO,EACP,MAAM,EACN,UAAU,EACV,MAAM,EACN,KAAK,EACL,aAAa,GACd,EAAE,mBAAmB;;;;;;;;;;;;;;EAgBrB"}

package/dist/react/components.js

@@ -0,0 +1,49 @@
+/**
+ * React component stubs for @ocpp-debugkit/toolkit/react.
+ *
+ * v0.2.0: These are stub implementations — presentational components
+ * that will be fully extracted from the Inspector in Phase 4.
+ * They are functional but minimal, using no external CSS framework.
+ */
+export function SessionTimeline({ events, selectedEventId, onSelectEvent }) {
+    return {
+        type: 'SessionTimeline',
+        props: { events, selectedEventId, onSelectEvent },
+    };
+}
+export function MessageInspector({ event }) {
+    return {
+        type: 'MessageInspector',
+        props: { event },
+    };
+}
+export function FailureSummary({ failures }) {
+    return {
+        type: 'FailureSummary',
+        props: { failures },
+    };
+}
+export function ReportViewer({ html }) {
+    return {
+        type: 'ReportViewer',
+        props: { html },
+    };
+}
+export function ReplayControls({ isPlaying, currentIndex, totalEvents, onPlay, onPause, onStep, onStepBack, onJump, speed, onSpeedChange, }) {
+    return {
+        type: 'ReplayControls',
+        props: {
+            isPlaying,
+            currentIndex,
+            totalEvents,
+            onPlay,
+            onPause,
+            onStep,
+            onStepBack,
+            onJump,
+            speed,
+            onSpeedChange,
+        },
+    };
+}
+//# sourceMappingURL=components.js.map

package/dist/react/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../src/react/components.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,UAAU,eAAe,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,aAAa,EAAwB;IAC9F,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE;KACzC,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAE,KAAK,EAAyB;IAC/D,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,EAAE,KAAK,EAAE;KACR,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAE,QAAQ,EAAuB;IAC9D,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,EAAE,QAAQ,EAAE;KACX,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAE,IAAI,EAAqB;IACtD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,EAAE,IAAI,EAAE;KACP,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAC7B,SAAS,EACT,YAAY,EACZ,WAAW,EACX,MAAM,EACN,OAAO,EACP,MAAM,EACN,UAAU,EACV,MAAM,EACN,KAAK,EACL,aAAa,GACO;IACpB,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE;YACL,SAAS;YACT,YAAY;YACZ,WAAW;YACX,MAAM;YACN,OAAO;YACP,MAAM;YACN,UAAU;YACV,MAAM;YACN,KAAK;YACL,aAAa;SACd;KACO,CAAC;AACb,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Reusable React components for OCPP DebugKit.
+ *
+ * @module @ocpp-debugkit/toolkit/react
+ *
+ * These components are presentational — they accept data as props and
+ * render UI. They are SSR-safe (no window/document access at module level).
+ */
+export type { SessionTimelineProps, MessageInspectorProps, FailureSummaryProps, ReportViewerProps, ReplayControlsProps, } from './types.js';
+export { SessionTimeline, MessageInspector, FailureSummary, ReportViewer, ReplayControls, } from './components.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,10 @@
+/**
+ * Reusable React components for OCPP DebugKit.
+ *
+ * @module @ocpp-debugkit/toolkit/react
+ *
+ * These components are presentational — they accept data as props and
+ * render UI. They are SSR-safe (no window/document access at module level).
+ */
+export { SessionTimeline, MessageInspector, FailureSummary, ReportViewer, ReplayControls, } from './components.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/react/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Prop types for the React components in @ocpp-debugkit/toolkit/react.
+ */
+import type { Event, Failure, SessionSummary } from '../core/index.js';
+export interface SessionTimelineProps {
+    events: Event[];
+    selectedEventId?: string | null;
+    onSelectEvent?: (eventId: string) => void;
+}
+export interface MessageInspectorProps {
+    event: Event | null;
+}
+export interface FailureSummaryProps {
+    failures: Failure[];
+}
+export interface ReportViewerProps {
+    /** The HTML report string (from generateHtmlReport). */
+    html: string;
+}
+export interface ReplayControlsProps {
+    isPlaying: boolean;
+    currentIndex: number;
+    totalEvents: number;
+    onPlay: () => void;
+    onPause: () => void;
+    onStep: () => void;
+    onStepBack: () => void;
+    onJump: (index: number) => void;
+    speed?: number;
+    onSpeedChange?: (speed: number) => void;
+}
+export type { SessionSummary };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/react/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAGD,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/react/types.js

@@ -0,0 +1,5 @@
+/**
+ * Prop types for the React components in @ocpp-debugkit/toolkit/react.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/react/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/react/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/replay/engine.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Replay engine — replays OCPP trace events in timestamp order.
+ *
+ * @module @ocpp-debugkit/toolkit/replay
+ */
+import type { Event, Failure } from '../core/index.js';
+export interface ReplayEvent {
+    /** The normalized event. */
+    event: Event;
+    /** Failures detected at this event's position. */
+    failures: Failure[];
+    /** Zero-based index in the original event array. */
+    index: number;
+}
+export interface ReplayState {
+    /** Events replayed so far. */
+    played: ReplayEvent[];
+    /** Events remaining. */
+    remaining: Event[];
+    /** Whether the replay is complete. */
+    complete: boolean;
+}
+export interface ReplayOptions {
+    /** Playback speed multiplier (1 = real-time, 2 = 2x, etc.). Default: 1. */
+    speed?: number;
+    /** Start from this event index. Default: 0. */
+    startIndex?: number;
+}
+/**
+ * Deterministic replay engine for OCPP traces.
+ *
+ * The engine is pure — it does not use timers or I/O. The consumer
+ * calls `step()`, `stepBack()`, or `jumpTo()` to advance the replay.
+ */
+export declare class ReplayEngine {
+    private readonly events;
+    private readonly failures;
+    private currentIndex;
+    constructor(events: Event[], failures?: Failure[], options?: ReplayOptions);
+    /** Total number of events. */
+    get totalEvents(): number;
+    /** Current event index (0-based). Returns -1 if no events. */
+    get current(): number;
+    /** Step forward one event. Returns the replay event, or null if complete. */
+    step(): ReplayEvent | null;
+    /** Step backward one event. Returns the replay event, or null if at start. */
+    stepBack(): ReplayEvent | null;
+    /** Jump to a specific event index. Returns the replay event, or null if out of range. */
+    jumpTo(index: number): ReplayEvent | null;
+    /** Get the current replay state snapshot. */
+    getState(): ReplayState;
+    /** Reset the replay to the beginning. */
+    reset(): void;
+}
+//# sourceMappingURL=engine.d.ts.map