@ocpp-debugkit/core 0.1.0

package/dist/timeline.js

@@ -0,0 +1,318 @@
+/**
+ * Session timeline builder — correlates events into logical charging sessions.
+ *
+ * Session correlation strategy (ADR-0006):
+ * 1. Primary: transactionId (from StartTransaction response / StopTransaction)
+ * 2. Secondary: connectorId + stationId grouping
+ * 3. Events without a transaction are grouped by stationId + connectorId
+ *
+ * @see ADR-0006
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extract transactionId from an event's payload.
+ * - StartTransaction response (CallResult): { transactionId, idTagInfo }
+ * - StopTransaction request (Call): { transactionId, ... }
+ * - MeterValues request (Call): { transactionId, ... }
+ */
+function extractTransactionId(event) {
+    if (event.messageType === 'Call') {
+        if (event.action === 'StartTransaction') {
+            // StartTransaction request doesn't have transactionId — the response does.
+            return null;
+        }
+        if (event.action === 'StopTransaction' || event.action === 'MeterValues') {
+            const payload = event.payload;
+            if (typeof payload?.transactionId === 'number') {
+                return payload.transactionId;
+            }
+        }
+    }
+    if (event.messageType === 'CallResult') {
+        const payload = event.payload;
+        if (typeof payload?.transactionId === 'number') {
+            return payload.transactionId;
+        }
+    }
+    return null;
+}
+/**
+ * Extract connectorId from an event's payload.
+ * Present in StatusNotification, StartTransaction, MeterValues.
+ */
+function extractConnectorId(event) {
+    if (event.messageType !== 'Call' || event.payload === null) {
+        return null;
+    }
+    const payload = event.payload;
+    if (typeof payload?.connectorId === 'number') {
+        return payload.connectorId;
+    }
+    return null;
+}
+/**
+ * Extract stationId from BootNotification payload.
+ */
+function extractStationId(events) {
+    for (const event of events) {
+        if (event.messageType === 'Call' && event.action === 'BootNotification') {
+            const payload = event.payload;
+            if (typeof payload?.chargePointSerialNumber === 'string') {
+                return payload.chargePointSerialNumber;
+            }
+        }
+    }
+    return 'unknown';
+}
+/**
+ * Determine if an event indicates a connector fault status.
+ */
+function isFaultedStatus(event) {
+    if (event.messageType !== 'Call' || event.action !== 'StatusNotification') {
+        return false;
+    }
+    const payload = event.payload;
+    return payload?.status === 'Faulted';
+}
+/**
+ * Determine if an event indicates the connector is unavailable/offline.
+ */
+function isUnavailableStatus(event) {
+    if (event.messageType !== 'Call' || event.action !== 'StatusNotification') {
+        return false;
+    }
+    const payload = event.payload;
+    return payload?.status === 'Unavailable' || payload?.status === 'Offline';
+}
+// ---------------------------------------------------------------------------
+// buildSessionTimeline()
+// ---------------------------------------------------------------------------
+/**
+ * Build session timelines from normalized events.
+ *
+ * Correlates events into logical charging sessions by:
+ * 1. Matching StartTransaction responses to find transactionIds
+ * 2. Grouping StopTransaction and MeterValues events by transactionId
+ * 3. Grouping StatusNotification events by connectorId + stationId
+ * 4. Events without a transaction are assigned to a "no-session" group
+ *
+ * Sessions are ordered by their first event's timestamp.
+ *
+ * @see ADR-0006
+ */
+export function buildSessionTimeline(events) {
+    if (events.length === 0) {
+        return [];
+    }
+    const stationId = extractStationId(events);
+    // Step 1: Build a map of messageId → transactionId from StartTransaction responses.
+    // The StartTransaction Call (msg-005) gets a response (CallResult) with transactionId.
+    // We match by messageId.
+    const messageIdToTransactionId = new Map();
+    for (const event of events) {
+        if (event.messageType === 'CallResult') {
+            const txId = extractTransactionId(event);
+            if (txId !== null) {
+                messageIdToTransactionId.set(event.messageId, txId);
+            }
+        }
+    }
+    // Step 2: Build a map of messageId → transactionId for StopTransaction/MeterValues Calls.
+    // These Calls contain the transactionId in their payload directly.
+    const callMessageIdToTransactionId = new Map();
+    for (const event of events) {
+        if (event.messageType === 'Call') {
+            const txId = extractTransactionId(event);
+            if (txId !== null) {
+                callMessageIdToTransactionId.set(event.messageId, txId);
+            }
+        }
+    }
+    // Step 3: Group events into sessions.
+    // A session is identified by a transactionId.
+    // Events are assigned to a session if:
+    // - They contain that transactionId in their payload (StopTransaction, MeterValues)
+    // - They are a StartTransaction Call/CallResult with a matched messageId
+    // - They are StatusNotification events for the same connectorId around the same time
+    // First, find all StartTransaction Call messages and their corresponding response transactionIds
+    const startTxCalls = [];
+    for (const event of events) {
+        if (event.messageType === 'Call' && event.action === 'StartTransaction') {
+            const txId = messageIdToTransactionId.get(event.messageId) ?? null;
+            const responseEvent = events.find((e) => e.messageId === event.messageId && e.messageType === 'CallResult') ??
+                null;
+            startTxCalls.push({ callEvent: event, responseEvent, transactionId: txId });
+        }
+    }
+    // If no transactions found, return a single session with all events
+    if (startTxCalls.length === 0) {
+        return [createSession('session-0', stationId, events)];
+    }
+    // Build a map of messageId → transactionId for ALL Call messages that have
+    // a transactionId (StopTransaction, MeterValues). Their CallResult responses
+    // inherit this transactionId.
+    const callMessageIdToTxId = new Map();
+    for (const event of events) {
+        if (event.messageType === 'Call') {
+            const txId = extractTransactionId(event);
+            if (txId !== null) {
+                callMessageIdToTxId.set(event.messageId, txId);
+            }
+            // StartTransaction Call — get txId from the response
+            if (event.action === 'StartTransaction') {
+                const respTxId = messageIdToTransactionId.get(event.messageId);
+                if (respTxId !== undefined) {
+                    callMessageIdToTxId.set(event.messageId, respTxId);
+                }
+            }
+        }
+    }
+    // Group events by transactionId
+    const sessionEventsMap = new Map();
+    for (const event of events) {
+        let txId = null;
+        if (event.messageType === 'Call') {
+            // Call: check if this messageId has a known transactionId
+            txId = callMessageIdToTxId.get(event.messageId) ?? null;
+            if (txId === null) {
+                // Try extracting from payload directly
+                txId = extractTransactionId(event);
+            }
+        }
+        else if (event.messageType === 'CallResult') {
+            // CallResult: check if the matching Call has a transactionId
+            txId = callMessageIdToTxId.get(event.messageId) ?? null;
+            // Also check if transactionId is directly in the response payload
+            if (txId === null) {
+                txId = extractTransactionId(event);
+            }
+        }
+        if (txId !== null) {
+            const group = sessionEventsMap.get(txId) ?? [];
+            group.push(event);
+            sessionEventsMap.set(txId, group);
+        }
+        else {
+            // Events without a transaction — assign to null group (will be distributed)
+            const group = sessionEventsMap.get(null) ?? [];
+            group.push(event);
+            sessionEventsMap.set(null, group);
+        }
+    }
+    // Distribute null-group events to sessions by connectorId and time proximity
+    const nullEvents = sessionEventsMap.get(null) ?? [];
+    sessionEventsMap.delete(null);
+    const usedNullEventIds = new Set();
+    // Build sessions
+    const sessions = [];
+    let sessionIndex = 0;
+    for (const [txId, txEvents] of sessionEventsMap) {
+        // Find connectorId from the StartTransaction Call
+        const startTxCall = txEvents.find((e) => e.messageType === 'Call' && e.action === 'StartTransaction');
+        const connectorId = startTxCall ? extractConnectorId(startTxCall) : null;
+        // Include null-group events that belong to this session's connector
+        // and time range, or that are responses to Calls already in the session.
+        const txMessageIds = new Set(txEvents.map((e) => e.messageId));
+        const sessionStart = txEvents[0]?.timestamp ?? null;
+        const sessionEnd = txEvents[txEvents.length - 1]?.timestamp ?? null;
+        const relatedNullEvents = nullEvents.filter((e) => {
+            // Skip already-used events
+            if (usedNullEventIds.has(e.id))
+                return false;
+            // Include CallResult/CallError that match a Call already in the session
+            if (e.messageType !== 'Call' && txMessageIds.has(e.messageId)) {
+                return true;
+            }
+            const eventConnectorId = extractConnectorId(e);
+            // Include events with matching connectorId within time range
+            if (eventConnectorId !== null && connectorId !== null && eventConnectorId === connectorId) {
+                if (sessionStart !== null && sessionEnd !== null && e.timestamp !== null) {
+                    return e.timestamp >= sessionStart && e.timestamp <= sessionEnd + 60000; // 1 min grace
+                }
+                return true; // No timestamps — include
+            }
+            // Include BootNotification events at the start
+            if (e.action === 'BootNotification' || e.action === 'Heartbeat') {
+                // Only include if this is the first session
+                return sessionIndex === 0;
+            }
+            // Include events without connectorId (like Authorize) within time range
+            // (extending before session start to include pre-session events like Authorize)
+            if (eventConnectorId === null &&
+                e.messageType === 'Call' &&
+                e.action !== 'BootNotification' &&
+                e.action !== 'Heartbeat') {
+                if (sessionStart !== null && sessionEnd !== null && e.timestamp !== null) {
+                    // Include if within 5 minutes before session start through 1 min after end
+                    return e.timestamp >= sessionStart - 300000 && e.timestamp <= sessionEnd + 60000;
+                }
+            }
+            return false;
+        });
+        // Mark these null events as used so they aren't included in other sessions
+        for (const e of relatedNullEvents) {
+            usedNullEventIds.add(e.id);
+        }
+        const allEvents = [...txEvents, ...relatedNullEvents].sort((a, b) => {
+            // Sort by original event order (ID is sequential)
+            return a.id.localeCompare(b.id);
+        });
+        sessions.push(createSession(`session-${sessionIndex}`, stationId, allEvents, connectorId, txId));
+        sessionIndex++;
+    }
+    // Sort sessions by start time
+    sessions.sort((a, b) => {
+        if (a.startTime === null)
+            return 1;
+        if (b.startTime === null)
+            return -1;
+        return a.startTime - b.startTime;
+    });
+    // Renumber sessions
+    sessions.forEach((s, i) => {
+        s.sessionId = `session-${i}`;
+    });
+    return sessions;
+}
+// ---------------------------------------------------------------------------
+// createSession helper
+// ---------------------------------------------------------------------------
+function createSession(sessionId, stationId, events, connectorId = null, transactionId = null) {
+    const timestamps = events.map((e) => e.timestamp).filter((t) => t !== null);
+    const startTime = timestamps.length > 0 ? Math.min(...timestamps) : null;
+    const endTime = timestamps.length > 0 ? Math.max(...timestamps) : null;
+    // Determine session status
+    let status = 'active';
+    const hasStop = events.some((e) => e.messageType === 'Call' && e.action === 'StopTransaction');
+    const hasFaulted = events.some(isFaultedStatus);
+    const hasUnavailable = events.some(isUnavailableStatus);
+    if (hasStop) {
+        status = 'completed';
+    }
+    else if (hasFaulted || hasUnavailable) {
+        status = 'aborted';
+    }
+    // If we didn't get a transactionId from parameter, try to extract it
+    if (transactionId === null) {
+        for (const event of events) {
+            const txId = extractTransactionId(event);
+            if (txId !== null) {
+                transactionId = txId;
+                break;
+            }
+        }
+    }
+    return {
+        sessionId,
+        stationId,
+        connectorId,
+        transactionId,
+        startTime,
+        endTime,
+        events,
+        status,
+    };
+}
+//# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

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

package/dist/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/types.d.ts.map

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

package/dist/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/types.js.map

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

package/dist/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/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/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/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