@ocpp-debugkit/toolkit 0.2.1 → 0.3.1

package/dist/core/diff.js

@@ -0,0 +1,199 @@
+/**
+ * Trace diffing — compare two parsed traces and surface differences.
+ *
+ * Matches events by `messageId` (OCPP UniqueId), then compares:
+ * - timestamp, direction, action, payload (deep equality), errorCode
+ * - detected failures (by code)
+ * - session summaries (human-readable difference strings)
+ *
+ * Pure function — no I/O, no side effects. Browser-safe (no Node built-ins).
+ *
+ * @module @ocpp-debugkit/toolkit/core
+ */
+import { detectFailures } from './detection.js';
+import { buildSessionTimeline } from './timeline.js';
+import { summarizeSessions } from './summarizer.js';
+// ---------------------------------------------------------------------------
+// Deep equality check (limited — not a general-purpose deep-equal)
+// ---------------------------------------------------------------------------
+/**
+ * Checks deep equality of two values. Handles primitives, arrays, and plain
+ * objects. Does not handle Maps, Sets, Dates, or other complex types —
+ * OCPP payloads are JSON-serializable data.
+ */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((item, i) => deepEqual(item, b[i]));
+    }
+    if (typeof a === 'object' && typeof b === 'object') {
+        const objA = a;
+        const objB = b;
+        const keysA = Object.keys(objA);
+        const keysB = Object.keys(objB);
+        if (keysA.length !== keysB.length)
+            return false;
+        return keysA.every((key) => deepEqual(objA[key], objB[key]));
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Diff implementation
+// ---------------------------------------------------------------------------
+/**
+ * Compare two parsed traces and return a structured diff.
+ *
+ * @param a - Parse result of trace A
+ * @param b - Parse result of trace B
+ * @returns A {@link TraceDiff} describing all differences
+ *
+ * @example
+ * ```typescript
+ * const resultA = parseTrace(traceAJson);
+ * const resultB = parseTrace(traceBJson);
+ * const diff = diffTraces(resultA, resultB);
+ *
+ * if (diff.onlyInA.length > 0) {
+ *   console.log(`${diff.onlyInA.length} events only in trace A`);
+ * }
+ * ```
+ */
+export function diffTraces(a, b) {
+    const messageIdsA = new Set(a.events.map((e) => e.messageId));
+    const messageIdsB = new Set(b.events.map((e) => e.messageId));
+    const onlyInA = a.events.filter((e) => !messageIdsB.has(e.messageId));
+    const onlyInB = b.events.filter((e) => !messageIdsA.has(e.messageId));
+    // Modified events (present in both but with differences)
+    // Build maps for comparison — store arrays of events per messageId
+    const mapA = new Map();
+    const mapB = new Map();
+    for (const event of a.events) {
+        if (!messageIdsB.has(event.messageId))
+            continue;
+        const existing = mapA.get(event.messageId);
+        if (existing) {
+            existing.push(event);
+        }
+        else {
+            mapA.set(event.messageId, [event]);
+        }
+    }
+    for (const event of b.events) {
+        if (!messageIdsA.has(event.messageId))
+            continue;
+        const existing = mapB.get(event.messageId);
+        if (existing) {
+            existing.push(event);
+        }
+        else {
+            mapB.set(event.messageId, [event]);
+        }
+    }
+    const modified = [];
+    for (const [messageId, eventsA] of mapA) {
+        const eventsB = mapB.get(messageId);
+        if (!eventsB)
+            continue;
+        // Compare events at each position within the same messageId
+        const maxLen = Math.max(eventsA.length, eventsB.length);
+        for (let i = 0; i < maxLen; i++) {
+            const eventA = eventsA[i];
+            const eventB = eventsB[i];
+            if (!eventA || !eventB)
+                continue;
+            if (eventA.timestamp !== eventB.timestamp) {
+                modified.push({
+                    messageId,
+                    field: 'timestamp',
+                    valueA: eventA.timestamp,
+                    valueB: eventB.timestamp,
+                });
+            }
+            if (eventA.direction !== eventB.direction) {
+                modified.push({
+                    messageId,
+                    field: 'direction',
+                    valueA: eventA.direction,
+                    valueB: eventB.direction,
+                });
+            }
+            if (eventA.action !== eventB.action) {
+                modified.push({ messageId, field: 'action', valueA: eventA.action, valueB: eventB.action });
+            }
+            if (!deepEqual(eventA.payload, eventB.payload)) {
+                modified.push({
+                    messageId,
+                    field: 'payload',
+                    valueA: eventA.payload,
+                    valueB: eventB.payload,
+                });
+            }
+            if (eventA.errorCode !== eventB.errorCode) {
+                modified.push({
+                    messageId,
+                    field: 'errorCode',
+                    valueA: eventA.errorCode,
+                    valueB: eventB.errorCode,
+                });
+            }
+        }
+    }
+    // --- Failure diffing ---
+    const sessionsA = buildSessionTimeline(a.events);
+    const sessionsB = buildSessionTimeline(b.events);
+    const failuresA = detectFailures(a.events, sessionsA);
+    const failuresB = detectFailures(b.events, sessionsB);
+    const failureCodesA = new Set(failuresA.map((f) => f.code));
+    const failureCodesB = new Set(failuresB.map((f) => f.code));
+    const failuresOnlyInA = failuresA.filter((f) => !failureCodesB.has(f.code));
+    const failuresOnlyInB = failuresB.filter((f) => !failureCodesA.has(f.code));
+    // --- Summary diffing ---
+    const summariesA = summarizeSessions(sessionsA, failuresA);
+    const summariesB = summarizeSessions(sessionsB, failuresB);
+    const summaryA = summariesA.length > 0 ? summariesA[0] : null;
+    const summaryB = summariesB.length > 0 ? summariesB[0] : null;
+    const differences = [];
+    if (summaryA && summaryB) {
+        if (summaryA.eventCount !== summaryB.eventCount) {
+            differences.push(`Event count: A=${summaryA.eventCount}, B=${summaryB.eventCount}`);
+        }
+        if (summaryA.failureCount !== summaryB.failureCount) {
+            differences.push(`Failure count: A=${summaryA.failureCount}, B=${summaryB.failureCount}`);
+        }
+        if (summaryA.status !== summaryB.status) {
+            differences.push(`Session status: A="${summaryA.status}", B="${summaryB.status}"`);
+        }
+        if (summaryA.durationMs !== summaryB.durationMs) {
+            differences.push(`Duration: A=${summaryA.durationMs}ms, B=${summaryB.durationMs}ms`);
+        }
+        if (summaryA.transactionId !== summaryB.transactionId) {
+            differences.push(`Transaction ID: A=${summaryA.transactionId}, B=${summaryB.transactionId}`);
+        }
+    }
+    else if (summaryA && !summaryB) {
+        differences.push('Trace A has sessions but trace B does not');
+    }
+    else if (!summaryA && summaryB) {
+        differences.push('Trace B has sessions but trace A does not');
+    }
+    return {
+        onlyInA,
+        onlyInB,
+        modified,
+        failuresOnlyInA,
+        failuresOnlyInB,
+        summaryDiff: {
+            a: summaryA,
+            b: summaryB,
+            differences,
+        },
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/core/diff.js.map

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

package/dist/core/index.d.ts

@@ -10,5 +10,9 @@ export { buildSessionTimeline } from './timeline.js';
 export { detectFailures } from './detection.js';
 export { summarizeSession, summarizeSessions } from './summarizer.js';
 export { validateMessage, validateMessages } from './validator.js';
+export { diffTraces } from './diff.js';
+export type { TraceDiff, EventDiff, SummaryDiff } from './diff.js';
+export { runAssertion, runAssertions, evaluateScenario } from './assertions.js';
+export type { AssertionContext } from './assertions.js';
 export * from './fixtures/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5F,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGtE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGnE,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5F,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGtE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGnE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAChF,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,cAAc,qBAAqB,CAAC"}

package/dist/core/index.js

@@ -17,6 +17,10 @@ export { detectFailures } from './detection.js';
 export { summarizeSession, summarizeSessions } from './summarizer.js';
 // Validator
 export { validateMessage, validateMessages } from './validator.js';
+// Diff
+export { diffTraces } from './diff.js';
+// Assertions
+export { runAssertion, runAssertions, evaluateScenario } from './assertions.js';
 // Fixtures
 export * from './fixtures/index.js';
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,gBAAgB;AAChB,cAAc,cAAc,CAAC;AAE7B,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5F,aAAa;AACb,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,WAAW;AACX,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,WAAW;AACX,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,gBAAgB;AAChB,cAAc,cAAc,CAAC;AAE7B,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5F,aAAa;AACb,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,WAAW;AACX,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO;AACP,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGhF,WAAW;AACX,cAAc,qBAAqB,CAAC"}

package/dist/core/types.d.ts

@@ -113,8 +113,8 @@ export interface ParseResult {
 }
 /** Severity of a detected failure. */
 export type FailureSeverity = 'critical' | 'warning' | 'info';
-/** Failure rule codes. v0.1 codes + v0.2 additions. */
-export type FailureCode = 'FAILED_AUTHORIZATION' | 'CONNECTOR_FAULT' | 'STATION_OFFLINE_DURING_SESSION' | 'TIMEOUT_NO_HEARTBEAT' | 'METER_VALUE_GAP' | 'INVALID_STOP_REASON' | 'UNEXPECTED_START' | 'STATUS_TRANSITION_VIOLATION' | 'DIAGNOSTICS_FAILURE' | 'FIRMWARE_UPDATE_FAILURE';
+/** Failure rule codes. v0.1 codes + v0.2 + v0.3 additions. */
+export type FailureCode = 'FAILED_AUTHORIZATION' | 'CONNECTOR_FAULT' | 'STATION_OFFLINE_DURING_SESSION' | 'TIMEOUT_NO_HEARTBEAT' | 'METER_VALUE_GAP' | 'INVALID_STOP_REASON' | 'UNEXPECTED_START' | 'STATUS_TRANSITION_VIOLATION' | 'DIAGNOSTICS_FAILURE' | 'FIRMWARE_UPDATE_FAILURE' | 'SUSPICIOUS_SESSION_DURATION' | 'SLOW_RESPONSE' | 'HEARTBEAT_INTERVAL_VIOLATION' | 'METER_VALUE_ANOMALY' | 'UNRESPONSIVE_CSMS' | 'REPEATED_BOOT_NOTIFICATION';
 /**
  * A detected failure in a trace.
  */
@@ -156,5 +156,80 @@ export interface Scenario {
     trace: Trace;
     /** Failure codes expected to be detected. */
     expectedFailures: FailureCode[];
+    /** Optional rich assertions (v0.3). When present, evaluated alongside expectedFailures. */
+    assertions?: ScenarioAssertion[];
+}
+/** A declarative assertion for scenario evaluation. */
+export type ScenarioAssertion = {
+    type: 'event_order';
+    params: {
+        actions: string[];
+    };
+} | {
+    type: 'event_count';
+    params: {
+        min?: number;
+        max?: number;
+        action?: string;
+    };
+} | {
+    type: 'payload_field';
+    params: {
+        action: string;
+        field: string;
+        equals?: unknown;
+        contains?: unknown;
+    };
+} | {
+    type: 'timing';
+    params: {
+        actionA: string;
+        actionB: string;
+        maxGapMs?: number;
+        minGapMs?: number;
+    };
+} | {
+    type: 'session_state';
+    params: {
+        expected: 'active' | 'completed' | 'aborted';
+    };
+} | {
+    type: 'failure_severity';
+    params: {
+        code: FailureCode;
+        severity: FailureSeverity;
+    };
+} | {
+    type: 'no_failures';
+    params: Record<string, never>;
+} | {
+    type: 'failure_count';
+    params: {
+        min?: number;
+        max?: number;
+        code?: FailureCode;
+    };
+};
+/** Result of evaluating a single assertion. */
+export interface AssertionResult {
+    /** The assertion that was evaluated. */
+    assertion: ScenarioAssertion;
+    /** Whether the assertion passed. */
+    passed: boolean;
+    /** Human-readable description of the result. */
+    message: string;
+}
+/** Result of evaluating all assertions for a scenario. */
+export interface ScenarioEvalResult {
+    /** Results for each assertion. */
+    assertions: AssertionResult[];
+    /** Whether all assertions passed. */
+    allPassed: boolean;
+    /** Detected failures. */
+    failures: Failure[];
+    /** Detected failure codes. */
+    detectedFailureCodes: FailureCode[];
+    /** Whether expectedFailures matches detectedFailures. */
+    expectedFailuresPassed: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/index.d.ts

@@ -18,7 +18,9 @@ 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 { diffTraces } from './core/index.js';
+export { runAssertions, evaluateScenario } from './core/index.js';
+export type { Trace, Event, Session, Failure, Scenario, SessionSummary, ValidationResult, RawOcppMessage, Direction, MessageType, FailureSeverity, FailureCode, TraceEventInput, TraceMetadata, ParseWarning, ParseResult, TraceDiff, EventDiff, SummaryDiff, ScenarioAssertion, AssertionResult, ScenarioEvalResult, } 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

@@ -1 +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"}
+{"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;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGlE,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,EACX,SAAS,EACT,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,kBAAkB,GACnB,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

@@ -19,6 +19,8 @@ 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 { diffTraces } from './core/index.js';
+export { runAssertions, evaluateScenario } from './core/index.js';
 // Re-export schemas
 export { directionSchema, messageTypeSchema, rawOcppMessageSchema, traceEventInputSchema, traceMetadataSchema, traceSchema, bareArraySchema, } from './core/index.js';
 // Re-export fixtures

package/dist/index.js.map

@@ -1 +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"}
+{"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;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AA4BlE,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/scenarios/__scenarios__/heartbeat-irregular.d.ts

@@ -0,0 +1,51 @@
+declare const _default: {
+    name: string;
+    description: string;
+    trace: {
+        traceId: string;
+        metadata: {
+            stationId: string;
+            ocppVersion: string;
+            source: string;
+            description: string;
+        };
+        events: ({
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                chargePointVendor: string;
+                chargePointModel: string;
+                chargePointSerialNumber: string;
+                firmwareVersion: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                currentTime: string;
+                interval: number;
+                status: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: {}[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                currentTime: string;
+            })[];
+        })[];
+    };
+    expectedFailures: string[];
+    assertions: {
+        type: string;
+        params: {
+            min: number;
+            action: string;
+        };
+    }[];
+};
+export default _default;
+//# sourceMappingURL=heartbeat-irregular.d.ts.map

package/dist/scenarios/__scenarios__/heartbeat-irregular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-irregular.d.ts","sourceRoot":"","sources":["../../../src/scenarios/__scenarios__/heartbeat-irregular.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAgFE"}

package/dist/scenarios/__scenarios__/heartbeat-irregular.js

@@ -0,0 +1,81 @@
+export default {
+    name: 'heartbeat-irregular',
+    description: 'Heartbeats sent at irregular intervals — 300s expected, but 600s gap observed. Expects HEARTBEAT_INTERVAL_VIOLATION failure. Uses event_count assertion for heartbeats.',
+    trace: {
+        traceId: 'scenario-heartbeat-irregular',
+        metadata: {
+            stationId: 'CS-SYNTHETIC-014',
+            ocppVersion: '1.6',
+            source: 'synthetic-scenario',
+            description: 'Heartbeats sent at irregular intervals — 300s expected, 600s gap observed.',
+        },
+        events: [
+            {
+                timestamp: '2024-01-15T12:00:00.000Z',
+                direction: 'CS_TO_CSMS',
+                message: [
+                    2,
+                    'msg-001',
+                    'BootNotification',
+                    {
+                        chargePointVendor: 'SyntheticVendor',
+                        chargePointModel: 'SM-100',
+                        chargePointSerialNumber: 'CS-SYNTHETIC-014',
+                        firmwareVersion: '1.0.0',
+                    },
+                ],
+            },
+            {
+                timestamp: '2024-01-15T12:00:00.500Z',
+                direction: 'CSMS_TO_CS',
+                message: [
+                    3,
+                    'msg-001',
+                    {
+                        currentTime: '2024-01-15T12:00:00.500Z',
+                        interval: 300,
+                        status: 'Accepted',
+                    },
+                ],
+            },
+            {
+                timestamp: '2024-01-15T12:05:00.000Z',
+                direction: 'CS_TO_CSMS',
+                message: [2, 'msg-hb-1', 'Heartbeat', {}],
+            },
+            {
+                timestamp: '2024-01-15T12:05:00.500Z',
+                direction: 'CSMS_TO_CS',
+                message: [3, 'msg-hb-1', { currentTime: '2024-01-15T12:05:00.500Z' }],
+            },
+            {
+                timestamp: '2024-01-15T12:15:00.000Z',
+                direction: 'CS_TO_CSMS',
+                message: [2, 'msg-hb-2', 'Heartbeat', {}],
+            },
+            {
+                timestamp: '2024-01-15T12:15:00.500Z',
+                direction: 'CSMS_TO_CS',
+                message: [3, 'msg-hb-2', { currentTime: '2024-01-15T12:15:00.500Z' }],
+            },
+            {
+                timestamp: '2024-01-15T12:25:00.000Z',
+                direction: 'CS_TO_CSMS',
+                message: [2, 'msg-hb-3', 'Heartbeat', {}],
+            },
+            {
+                timestamp: '2024-01-15T12:25:00.500Z',
+                direction: 'CSMS_TO_CS',
+                message: [3, 'msg-hb-3', { currentTime: '2024-01-15T12:25:00.500Z' }],
+            },
+        ],
+    },
+    expectedFailures: ['HEARTBEAT_INTERVAL_VIOLATION'],
+    assertions: [
+        {
+            type: 'event_count',
+            params: { min: 3, action: 'Heartbeat' },
+        },
+    ],
+};
+//# sourceMappingURL=heartbeat-irregular.js.map

package/dist/scenarios/__scenarios__/heartbeat-irregular.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-irregular.js","sourceRoot":"","sources":["../../../src/scenarios/__scenarios__/heartbeat-irregular.ts"],"names":[],"mappings":"AAAA,eAAe;IACb,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,yKAAyK;IAC3K,KAAK,EAAE;QACL,OAAO,EAAE,8BAA8B;QACvC,QAAQ,EAAE;YACR,SAAS,EAAE,kBAAkB;YAC7B,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,oBAAoB;YAC5B,WAAW,EAAE,4EAA4E;SAC1F;QACD,MAAM,EAAE;YACN;gBACE,SAAS,EAAE,0BAA0B;gBACrC,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE;oBACP,CAAC;oBACD,SAAS;oBACT,kBAAkB;oBAClB;wBACE,iBAAiB,EAAE,iBAAiB;wBACpC,gBAAgB,EAAE,QAAQ;wBAC1B,uBAAuB,EAAE,kBAAkB;wBAC3C,eAAe,EAAE,OAAO;qBACzB;iBACF;aACF;YACD;gBACE,SAAS,EAAE,0BAA0B;gBACrC,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE;oBACP,CAAC;oBACD,SAAS;oBACT;wBACE,WAAW,EAAE,0BAA0B;wBACvC,QAAQ,EAAE,GAAG;wBACb,MAAM,EAAE,UAAU;qBACnB;iBACF;aACF;YACD;gBACE,SAAS,EAAE,0BAA0B;gBACrC,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,CAAC;aAC1C;YACD;gBACE,SAAS,EAAE,0BAA0B;gBACrC,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;aACtE;YACD;gBACE,SAAS,EAAE,0BAA0B;gBACrC,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,CAAC;aAC1C;YACD;gBACE,SAAS,EAAE,0BAA0B;gBACrC,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;aACtE;YACD;gBACE,SAAS,EAAE,0BAA0B;gBACrC,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,CAAC;aAC1C;YACD;gBACE,SAAS,EAAE,0BAA0B;gBACrC,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;aACtE;SACF;KACF;IACD,gBAAgB,EAAE,CAAC,8BAA8B,CAAC;IAClD,UAAU,EAAE;QACV;YACE,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE;SACxC;KACF;CACF,CAAC"}

package/dist/scenarios/__scenarios__/meter-anomaly.d.ts

@@ -0,0 +1,115 @@
+declare const _default: {
+    name: string;
+    description: string;
+    trace: {
+        traceId: string;
+        metadata: {
+            stationId: string;
+            ocppVersion: string;
+            source: string;
+            description: string;
+        };
+        events: ({
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                chargePointVendor: string;
+                chargePointModel: string;
+                chargePointSerialNumber: string;
+                firmwareVersion: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                currentTime: string;
+                interval: number;
+                status: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                idTag: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                idTagInfo: {
+                    status: string;
+                };
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                connectorId: number;
+                idTag: string;
+                meterStart: number;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                idTagInfo: {
+                    status: string;
+                };
+                transactionId: number;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                connectorId: number;
+                transactionId: number;
+                meterValue: {
+                    sampledValue: {
+                        value: string;
+                    }[];
+                }[];
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: {}[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                currentTime: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                transactionId: number;
+                idTag: string;
+                meterStop: number;
+                reason: string;
+            })[];
+        })[];
+    };
+    expectedFailures: string[];
+    assertions: ({
+        type: string;
+        params: {
+            action: string;
+            field: string;
+            equals: number;
+            min?: undefined;
+            max?: undefined;
+        };
+    } | {
+        type: string;
+        params: {
+            min: number;
+            max: number;
+            action: string;
+            field?: undefined;
+            equals?: undefined;
+        };
+    })[];
+};
+export default _default;
+//# sourceMappingURL=meter-anomaly.d.ts.map

package/dist/scenarios/__scenarios__/meter-anomaly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter-anomaly.d.ts","sourceRoot":"","sources":["../../../src/scenarios/__scenarios__/meter-anomaly.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAwJE"}