@ocpp-debugkit/toolkit 0.2.0

package/dist/core/schemas.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Zod schemas for OCPP DebugKit trace input validation.
+ *
+ * These schemas validate untrusted input at the boundary (ADR-0007).
+ * They prevent prototype pollution and ensure structural correctness
+ * before any processing occurs.
+ *
+ * @see docs/trace-format-spec.md
+ * @see ADR-0002 (input trace formats)
+ * @see ADR-0003 (canonical event model)
+ * @see ADR-0007 (malformed trace handling)
+ */
+import { z } from 'zod';
+export declare const directionSchema: z.ZodEnum<{
+    CS_TO_CSMS: "CS_TO_CSMS";
+    CSMS_TO_CS: "CSMS_TO_CS";
+    UNKNOWN: "UNKNOWN";
+}>;
+export declare const messageTypeSchema: z.ZodEnum<{
+    Call: "Call";
+    CallResult: "CallResult";
+    CallError: "CallError";
+}>;
+/**
+ * Raw OCPP 1.6 JSON message array.
+ * - Call (2):        [2, UniqueId, Action, Payload]
+ * - CallResult (3):  [3, UniqueId, Payload]
+ * - CallError (4):   [4, UniqueId, ErrorCode, ErrorDescription, ErrorDetails]
+ *
+ * We validate the first two elements strictly (MessageTypeId + UniqueId)
+ * and accept arbitrary payload data.
+ */
+export declare const rawOcppMessageSchema: z.ZodTuple<[z.ZodNumber, z.ZodString], z.ZodUnknown>;
+export declare const traceEventInputSchema: z.ZodObject<{
+    timestamp: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    direction: z.ZodOptional<z.ZodEnum<{
+        CS_TO_CSMS: "CS_TO_CSMS";
+        CSMS_TO_CS: "CSMS_TO_CS";
+        UNKNOWN: "UNKNOWN";
+    }>>;
+    message: z.ZodTuple<[z.ZodNumber, z.ZodString], z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const traceMetadataSchema: z.ZodObject<{
+    stationId: z.ZodOptional<z.ZodString>;
+    ocppVersion: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const traceSchema: z.ZodObject<{
+    traceId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        stationId: z.ZodOptional<z.ZodString>;
+        ocppVersion: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    events: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        direction: z.ZodOptional<z.ZodEnum<{
+            CS_TO_CSMS: "CS_TO_CSMS";
+            CSMS_TO_CS: "CSMS_TO_CS";
+            UNKNOWN: "UNKNOWN";
+        }>>;
+        message: z.ZodTuple<[z.ZodNumber, z.ZodString], z.ZodUnknown>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const bareArraySchema: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodString], z.ZodUnknown>>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/core/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,eAAe;;;;EAAkD,CAAC;AAE/E,eAAO,MAAM,iBAAiB;;;;EAA8C,CAAC;AAE7E;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,sDAwB7B,CAAC;AAML,eAAO,MAAM,qBAAqB;;;;;;;;iBAIhC,CAAC;AAMH,eAAO,MAAM,mBAAmB;;;;;iBAK9B,CAAC;AAMH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;iBAItB,CAAC;AAMH,eAAO,MAAM,eAAe,kEAAuC,CAAC"}

package/dist/core/schemas.js

@@ -0,0 +1,81 @@
+/**
+ * Zod schemas for OCPP DebugKit trace input validation.
+ *
+ * These schemas validate untrusted input at the boundary (ADR-0007).
+ * They prevent prototype pollution and ensure structural correctness
+ * before any processing occurs.
+ *
+ * @see docs/trace-format-spec.md
+ * @see ADR-0002 (input trace formats)
+ * @see ADR-0003 (canonical event model)
+ * @see ADR-0007 (malformed trace handling)
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Primitives
+// ---------------------------------------------------------------------------
+export const directionSchema = z.enum(['CS_TO_CSMS', 'CSMS_TO_CS', 'UNKNOWN']);
+export const messageTypeSchema = z.enum(['Call', 'CallResult', 'CallError']);
+/**
+ * Raw OCPP 1.6 JSON message array.
+ * - Call (2):        [2, UniqueId, Action, Payload]
+ * - CallResult (3):  [3, UniqueId, Payload]
+ * - CallError (4):   [4, UniqueId, ErrorCode, ErrorDescription, ErrorDetails]
+ *
+ * We validate the first two elements strictly (MessageTypeId + UniqueId)
+ * and accept arbitrary payload data.
+ */
+export const rawOcppMessageSchema = z
+    .tuple([z.number(), z.string()])
+    .rest(z.unknown())
+    .refine((msg) => msg[0] === 2 || msg[0] === 3 || msg[0] === 4, {
+    message: 'MessageTypeId must be 2 (Call), 3 (CallResult), or 4 (CallError)',
+})
+    .refine((msg) => (msg[0] === 2 ? msg.length >= 4 : true), {
+    message: 'Call message must have at least 4 elements: [2, UniqueId, Action, Payload]',
+})
+    .refine((msg) => (msg[0] === 3 ? msg.length >= 3 : true), {
+    message: 'CallResult message must have at least 3 elements: [3, UniqueId, Payload]',
+})
+    .refine((msg) => (msg[0] === 4 ? msg.length >= 5 : true), {
+    message: 'CallError message must have at least 5 elements: [4, UniqueId, ErrorCode, ErrorDescription, ErrorDetails]',
+})
+    .refine((msg) => (msg[0] === 2 ? typeof msg[2] === 'string' : true), {
+    message: 'Call message Action (index 2) must be a string',
+})
+    .refine((msg) => (msg[0] === 4 ? typeof msg[2] === 'string' : true), {
+    message: 'CallError ErrorCode (index 2) must be a string',
+})
+    .refine((msg) => (msg[0] === 4 ? typeof msg[3] === 'string' : true), {
+    message: 'CallError ErrorDescription (index 3) must be a string',
+});
+// ---------------------------------------------------------------------------
+// Trace Event Input (ADR-0002, ADR-0003)
+// ---------------------------------------------------------------------------
+export const traceEventInputSchema = z.object({
+    timestamp: z.union([z.string(), z.number()]).nullable().optional(),
+    direction: directionSchema.optional(),
+    message: rawOcppMessageSchema,
+});
+// ---------------------------------------------------------------------------
+// Trace Metadata (ADR-0002)
+// ---------------------------------------------------------------------------
+export const traceMetadataSchema = z.object({
+    stationId: z.string().optional(),
+    ocppVersion: z.string().optional(),
+    source: z.string().optional(),
+    description: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// JSON Object Trace Format (ADR-0002)
+// ---------------------------------------------------------------------------
+export const traceSchema = z.object({
+    traceId: z.string().optional(),
+    metadata: traceMetadataSchema.optional(),
+    events: z.array(traceEventInputSchema).min(1, { message: 'events array must not be empty' }),
+});
+// ---------------------------------------------------------------------------
+// Bare Array Format (degenerate — array of raw OCPP messages)
+// ---------------------------------------------------------------------------
+export const bareArraySchema = z.array(rawOcppMessageSchema).min(1);
+//# sourceMappingURL=schemas.js.map

package/dist/core/schemas.js.map

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

package/dist/core/summarizer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Session summarizer — produces overview statistics for a charging session.
+ *
+ * @see ADR-0003
+ */
+import type { Session, SessionSummary } from './types.js';
+/**
+ * Summarize a charging session with overview statistics.
+ *
+ * @param session - The session to summarize
+ * @param failureCount - Number of failures detected in this session
+ * @returns Summary statistics
+ */
+export declare function summarizeSession(session: Session, failureCount?: number): SessionSummary;
+/**
+ * Summarize all sessions in a trace.
+ *
+ * @param sessions - All sessions in the trace
+ * @param failures - All detected failures
+ * @returns Array of session summaries
+ */
+export declare function summarizeSessions(sessions: Session[], failures: {
+    eventIds: string[];
+}[]): SessionSummary[];
+//# sourceMappingURL=summarizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../src/core/summarizer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,SAAI,GAAG,cAAc,CAqBnF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,GACjC,cAAc,EAAE,CAUlB"}

package/dist/core/summarizer.js

@@ -0,0 +1,47 @@
+/**
+ * Session summarizer — produces overview statistics for a charging session.
+ *
+ * @see ADR-0003
+ */
+/**
+ * Summarize a charging session with overview statistics.
+ *
+ * @param session - The session to summarize
+ * @param failureCount - Number of failures detected in this session
+ * @returns Summary statistics
+ */
+export function summarizeSession(session, failureCount = 0) {
+    const actionSequence = session.events
+        .filter((e) => e.messageType === 'Call' && e.action !== null)
+        .map((e) => e.action);
+    const durationMs = session.startTime !== null && session.endTime !== null
+        ? session.endTime - session.startTime
+        : null;
+    return {
+        sessionId: session.sessionId,
+        stationId: session.stationId,
+        connectorId: session.connectorId,
+        transactionId: session.transactionId,
+        status: session.status,
+        eventCount: session.events.length,
+        durationMs,
+        failureCount,
+        actionSequence,
+    };
+}
+/**
+ * Summarize all sessions in a trace.
+ *
+ * @param sessions - All sessions in the trace
+ * @param failures - All detected failures
+ * @returns Array of session summaries
+ */
+export function summarizeSessions(sessions, failures) {
+    return sessions.map((session) => {
+        // Count failures that belong to this session
+        const sessionEventIds = new Set(session.events.map((e) => e.id));
+        const failureCount = failures.filter((f) => f.eventIds.some((id) => sessionEventIds.has(id))).length;
+        return summarizeSession(session, failureCount);
+    });
+}
+//# sourceMappingURL=summarizer.js.map

package/dist/core/summarizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.js","sourceRoot":"","sources":["../../src/core/summarizer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,YAAY,GAAG,CAAC;IACjE,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM;SAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC;SAC5D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAgB,CAAC,CAAC;IAElC,MAAM,UAAU,GACd,OAAO,CAAC,SAAS,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;QACpD,CAAC,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,SAAS;QACrC,CAAC,CAAC,IAAI,CAAC;IAEX,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;QACjC,UAAU;QACV,YAAY;QACZ,cAAc;KACf,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAmB,EACnB,QAAkC;IAElC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,6CAA6C;QAC7C,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjE,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACzC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CACjD,CAAC,MAAM,CAAC;QAET,OAAO,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/timeline.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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
+ */
+import type { Event, Session } from './types.js';
+/**
+ * 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 declare function buildSessionTimeline(events: Event[]): Session[];
+//# sourceMappingURL=timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/core/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA4FjD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAgN/D"}

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

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