@ocpp-debugkit/core 0.1.0

package/dist/detection.js

@@ -0,0 +1,226 @@
+/**
+ * Failure detection — analyzes events and sessions for known failure patterns.
+ *
+ * Three detection rules in v0.1:
+ * 1. FAILED_AUTHORIZATION — Authorize response with idTagInfo.status = "Invalid"
+ * 2. CONNECTOR_FAULT — StatusNotification with status = "Faulted" during active session
+ * 3. STATION_OFFLINE_DURING_SESSION — session has StartTransaction but no StopTransaction,
+ *    or connector transitions to Unavailable/Offline during an active transaction
+ *
+ * @see ADR-0003
+ */
+// ---------------------------------------------------------------------------
+// Suggested steps per failure code
+// ---------------------------------------------------------------------------
+const SUGGESTED_STEPS = {
+    FAILED_AUTHORIZATION: [
+        'Verify the idTag is valid and not expired',
+        'Check the CSMS local authorization list',
+        'Ensure the idTag is not blocked or deactivated',
+        'Review the Authorize response payload for rejection reason',
+    ],
+    CONNECTOR_FAULT: [
+        'Inspect the physical connector for damage or debris',
+        'Check the connector lock mechanism',
+        'Review the errorCode field for specific fault type',
+        'Check station logs for hardware diagnostics',
+        'Contact hardware vendor if fault persists',
+    ],
+    STATION_OFFLINE_DURING_SESSION: [
+        'Check the network connection between station and CSMS',
+        'Verify the station has not lost power',
+        'Review the WebSocket connection stability',
+        'Check if the station firmware has a known stability issue',
+        'Investigate if maintenance was performed on the station',
+    ],
+};
+const SEVERITY = {
+    FAILED_AUTHORIZATION: 'warning',
+    CONNECTOR_FAULT: 'critical',
+    STATION_OFFLINE_DURING_SESSION: 'critical',
+};
+// ---------------------------------------------------------------------------
+// Payload extraction helpers
+// ---------------------------------------------------------------------------
+/** Extract idTagInfo.status from an Authorize CallResult. */
+function getAuthorizeStatus(event) {
+    if (event.messageType !== 'CallResult')
+        return null;
+    const payload = event.payload;
+    if (typeof payload?.idTagInfo?.status === 'string') {
+        return payload.idTagInfo.status;
+    }
+    return null;
+}
+/** Extract status from a StatusNotification Call. */
+function getStatusNotificationStatus(event) {
+    if (event.messageType !== 'Call' || event.action !== 'StatusNotification')
+        return null;
+    const payload = event.payload;
+    if (typeof payload?.status === 'string') {
+        return payload.status;
+    }
+    return null;
+}
+/** Extract errorCode from a StatusNotification Call. */
+function getStatusNotificationErrorCode(event) {
+    if (event.messageType !== 'Call' || event.action !== 'StatusNotification')
+        return null;
+    const payload = event.payload;
+    if (typeof payload?.errorCode === 'string') {
+        return payload.errorCode;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Detection rules
+// ---------------------------------------------------------------------------
+/**
+ * Rule 1: FAILED_AUTHORIZATION
+ * Detects Authorize responses where idTagInfo.status is "Invalid".
+ */
+function detectFailedAuthorization(events) {
+    const failures = [];
+    for (const event of events) {
+        // Look for Authorize CallResult responses
+        if (event.messageType !== 'CallResult')
+            continue;
+        // Check if the matching Call was an Authorize
+        // We match by messageId — find the Call with the same messageId
+        const matchingCall = events.find((e) => e.messageType === 'Call' && e.action === 'Authorize' && e.messageId === event.messageId);
+        if (!matchingCall)
+            continue;
+        const status = getAuthorizeStatus(event);
+        if (status === 'Invalid') {
+            failures.push({
+                code: 'FAILED_AUTHORIZATION',
+                description: `Authorization rejected: idTag returned "Invalid" status (messageId: ${event.messageId})`,
+                severity: SEVERITY.FAILED_AUTHORIZATION,
+                eventIds: [matchingCall.id, event.id],
+                suggestedSteps: SUGGESTED_STEPS.FAILED_AUTHORIZATION,
+            });
+        }
+    }
+    return failures;
+}
+/**
+ * Rule 2: CONNECTOR_FAULT
+ * Detects StatusNotification with status = "Faulted" during an active session.
+ * A "during active session" means there's a StartTransaction before the fault
+ * and either no StopTransaction yet, or the fault occurs before the StopTransaction.
+ */
+function detectConnectorFault(events) {
+    const failures = [];
+    // Find all StartTransaction Call events
+    const startTxIndices = events
+        .filter((e) => e.messageType === 'Call' && e.action === 'StartTransaction')
+        .map((e) => events.indexOf(e));
+    for (const startIndex of startTxIndices) {
+        const startEvent = events[startIndex];
+        if (!startEvent)
+            continue;
+        // Find the corresponding StopTransaction (after this StartTransaction)
+        let stopIndex = -1;
+        for (let i = startIndex + 1; i < events.length; i++) {
+            const ev = events[i];
+            if (ev && ev.messageType === 'Call' && ev.action === 'StopTransaction') {
+                stopIndex = i;
+                break;
+            }
+        }
+        // Look for Faulted StatusNotification between StartTransaction and StopTransaction
+        // (or until the end of events if no StopTransaction)
+        const searchEnd = stopIndex > -1 ? stopIndex : events.length;
+        for (let i = startIndex; i < searchEnd; i++) {
+            const event = events[i];
+            if (!event)
+                continue;
+            const status = getStatusNotificationStatus(event);
+            if (status === 'Faulted') {
+                const errorCode = getStatusNotificationErrorCode(event);
+                failures.push({
+                    code: 'CONNECTOR_FAULT',
+                    description: `Connector fault detected during active session: status "Faulted"${errorCode ? `, errorCode "${errorCode}"` : ''} (messageId: ${event.messageId})`,
+                    severity: SEVERITY.CONNECTOR_FAULT,
+                    eventIds: [startEvent.id, event.id],
+                    suggestedSteps: SUGGESTED_STEPS.CONNECTOR_FAULT,
+                });
+                break; // Only report one fault per session
+            }
+        }
+    }
+    return failures;
+}
+/**
+ * Rule 3: STATION_OFFLINE_DURING_SESSION
+ * Detects sessions where:
+ * - There's a StartTransaction but no StopTransaction (session never completed)
+ * - OR the connector transitions to Unavailable/Offline during an active transaction
+ */
+function detectStationOfflineDuringSession(_events, sessions) {
+    const failures = [];
+    for (const session of sessions) {
+        if (session.transactionId === null)
+            continue;
+        const hasStart = session.events.some((e) => e.messageType === 'Call' && e.action === 'StartTransaction');
+        const hasStop = session.events.some((e) => e.messageType === 'Call' && e.action === 'StopTransaction');
+        if (hasStart && !hasStop) {
+            // Session never completed — station went offline or stopped communicating
+            failures.push({
+                code: 'STATION_OFFLINE_DURING_SESSION',
+                description: `Session ${session.sessionId} (transaction ${session.transactionId}) has a StartTransaction but no StopTransaction — station may have gone offline during an active session`,
+                severity: SEVERITY.STATION_OFFLINE_DURING_SESSION,
+                eventIds: session.events
+                    .filter((e) => e.messageType === 'Call' && e.action === 'StartTransaction')
+                    .map((e) => e.id),
+                suggestedSteps: SUGGESTED_STEPS.STATION_OFFLINE_DURING_SESSION,
+            });
+            continue;
+        }
+        // Check for Unavailable/Offline status during the session
+        if (hasStart && hasStop) {
+            const startIndex = session.events.findIndex((e) => e.messageType === 'Call' && e.action === 'StartTransaction');
+            const stopIndex = session.events.findIndex((e) => e.messageType === 'Call' && e.action === 'StopTransaction');
+            for (let i = startIndex; i <= stopIndex; i++) {
+                const event = session.events[i];
+                if (!event)
+                    continue;
+                const status = getStatusNotificationStatus(event);
+                if (status === 'Unavailable' || status === 'Offline') {
+                    failures.push({
+                        code: 'STATION_OFFLINE_DURING_SESSION',
+                        description: `Station reported "${status}" status during active session ${session.sessionId} (transaction ${session.transactionId})`,
+                        severity: SEVERITY.STATION_OFFLINE_DURING_SESSION,
+                        eventIds: [event.id],
+                        suggestedSteps: SUGGESTED_STEPS.STATION_OFFLINE_DURING_SESSION,
+                    });
+                    break;
+                }
+            }
+        }
+    }
+    return failures;
+}
+// ---------------------------------------------------------------------------
+// detectFailures()
+// ---------------------------------------------------------------------------
+/**
+ * Detect failures in a trace by analyzing events and sessions.
+ *
+ * @param events - All normalized events from the trace
+ * @param sessions - Sessions derived from the events
+ * @returns Array of detected failures
+ *
+ * @see ADR-0003
+ */
+export function detectFailures(events, sessions) {
+    const failures = [];
+    // Rule 1: Failed authorization
+    failures.push(...detectFailedAuthorization(events));
+    // Rule 2: Connector fault during active session
+    failures.push(...detectConnectorFault(events));
+    // Rule 3: Station offline during session
+    failures.push(...detectStationOfflineDuringSession(events, sessions));
+    return failures;
+}
+//# sourceMappingURL=detection.js.map

package/dist/detection.js.map

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

package/dist/fixtures/index.d.ts

@@ -0,0 +1,298 @@
+/**
+ * Synthetic trace fixtures for testing and development.
+ *
+ * All fixtures are fully synthetic — no real station identifiers, transaction
+ * IDs, idTag values, or personal data.
+ *
+ * @see docs/trace-format-spec.md
+ */
+import normalSession from '../__fixtures__/normal-session.js';
+import failedAuth from '../__fixtures__/failed-auth.js';
+import connectorFault from '../__fixtures__/connector-fault.js';
+export { normalSession, failedAuth, connectorFault };
+export declare const fixtures: {
+    readonly normalSession: {
+        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 | {
+                connectorId: number;
+                status: string;
+                errorCode: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: {}[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                idTag: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                idTagInfo: {
+                    status: string;
+                    expiryDate: string;
+                    parentIdTag: string;
+                };
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                connectorId: number;
+                idTag: string;
+                meterStart: number;
+                timestamp: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                transactionId: number;
+                idTagInfo: {
+                    status: string;
+                };
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                connectorId: number;
+                transactionId: number;
+                meterValue: {
+                    timestamp: string;
+                    sampledValue: {
+                        value: string;
+                        measurand: string;
+                        unit: string;
+                    }[];
+                }[];
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                transactionId: number;
+                idTag: string;
+                meterStop: number;
+                timestamp: string;
+                reason: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                idTagInfo: {
+                    status: string;
+                };
+            })[];
+        })[];
+    };
+    readonly failedAuth: {
+        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 | {
+                connectorId: number;
+                status: string;
+                errorCode: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: {}[];
+        } | {
+            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;
+                status: string;
+                errorCode: string;
+                info: string;
+            })[];
+        })[];
+    };
+    readonly connectorFault: {
+        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 | {
+                connectorId: number;
+                status: string;
+                errorCode: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: {}[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                idTag: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                idTagInfo: {
+                    status: string;
+                    expiryDate: string;
+                };
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                connectorId: number;
+                idTag: string;
+                meterStart: number;
+                timestamp: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                transactionId: number;
+                idTagInfo: {
+                    status: string;
+                };
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                connectorId: number;
+                transactionId: number;
+                meterValue: {
+                    timestamp: string;
+                    sampledValue: {
+                        value: string;
+                        measurand: string;
+                        unit: string;
+                    }[];
+                }[];
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                connectorId: number;
+                status: string;
+                errorCode: string;
+                info: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                transactionId: number;
+                idTag: string;
+                meterStop: number;
+                timestamp: string;
+                reason: string;
+            })[];
+        } | {
+            timestamp: string;
+            direction: string;
+            message: (string | number | {
+                idTagInfo: {
+                    status: string;
+                };
+            })[];
+        })[];
+    };
+};
+export declare const fixtureNames: readonly ["normal-session", "failed-auth", "connector-fault"];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fixtures/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,aAAa,MAAM,mCAAmC,CAAC;AAC9D,OAAO,UAAU,MAAM,gCAAgC,CAAC;AACxD,OAAO,cAAc,MAAM,oCAAoC,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AAErD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIX,CAAC;AAEX,eAAO,MAAM,YAAY,+DAAgE,CAAC"}

package/dist/fixtures/index.js

@@ -0,0 +1,19 @@
+/**
+ * Synthetic trace fixtures for testing and development.
+ *
+ * All fixtures are fully synthetic — no real station identifiers, transaction
+ * IDs, idTag values, or personal data.
+ *
+ * @see docs/trace-format-spec.md
+ */
+import normalSession from '../__fixtures__/normal-session.js';
+import failedAuth from '../__fixtures__/failed-auth.js';
+import connectorFault from '../__fixtures__/connector-fault.js';
+export { normalSession, failedAuth, connectorFault };
+export const fixtures = {
+    normalSession,
+    failedAuth,
+    connectorFault,
+};
+export const fixtureNames = ['normal-session', 'failed-auth', 'connector-fault'];
+//# sourceMappingURL=index.js.map

package/dist/fixtures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fixtures/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,aAAa,MAAM,mCAAmC,CAAC;AAC9D,OAAO,UAAU,MAAM,gCAAgC,CAAC;AACxD,OAAO,cAAc,MAAM,oCAAoC,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AAErD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,aAAa;IACb,UAAU;IACV,cAAc;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,CAAU,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Barrel export for the @ocpp-debugkit/core package.
+ */
+export * from './types.js';
+export * from './schemas.js';
+export { parseTrace, ParseError, MAX_INPUT_SIZE_BYTES, MAX_EVENT_COUNT } from './parser.js';
+export type { TraceFormat } from './parser.js';
+export { normalizeEvents, normalizeTimestamp, inferDirection, reverseDirection, classifyMessageType, extractAction, extractPayload, extractErrorCode, extractErrorDescription, } from './normalizer.js';
+export { buildSessionTimeline } from './timeline.js';
+export { detectFailures } from './detection.js';
+export { summarizeSession, summarizeSessions } from './summarizer.js';
+export { validateMessage, validateMessages } from './validator.js';
+export * from './fixtures/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;;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"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * Barrel export for the @ocpp-debugkit/core package.
+ */
+// Types
+export * from './types.js';
+// Schemas (Zod)
+export * from './schemas.js';
+// Parser
+export { parseTrace, ParseError, MAX_INPUT_SIZE_BYTES, MAX_EVENT_COUNT } from './parser.js';
+// Normalizer
+export { normalizeEvents, normalizeTimestamp, inferDirection, reverseDirection, classifyMessageType, extractAction, extractPayload, extractErrorCode, extractErrorDescription, } from './normalizer.js';
+// Timeline
+export { buildSessionTimeline } from './timeline.js';
+// Detection
+export { detectFailures } from './detection.js';
+// Summarizer
+export { summarizeSession, summarizeSessions } from './summarizer.js';
+// Validator
+export { validateMessage, validateMessages } from './validator.js';
+// Fixtures
+export * from './fixtures/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;;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"}