From 18692801a9d84c8d35c509f7d8f096d1b8719ba6 Mon Sep 17 00:00:00 2001 From: =?utf8?q?J=C3=A9r=C3=B4me=20Benoit?= Date: Fri, 27 Feb 2026 17:39:10 +0100 Subject: [PATCH] docs(tests): add file-level JSDoc to test files Add @file and @description JSDoc comments to all 58 test files that were missing file-level documentation. Each JSDoc identifies the module under test and provides a brief description of the test coverage scope. --- tests/ChargingStationFactory.test.ts | 4 ++++ tests/charging-station/ChargingStation.test.ts | 4 ++++ tests/charging-station/ConfigurationKeyUtils.test.ts | 4 ++++ tests/charging-station/Helpers.test.ts | 4 ++++ .../ocpp/2.0/OCPP20CertificateManager.test.ts | 4 ++++ .../OCPP20IncomingRequestService-CertificateSigned.test.ts | 4 ++++ .../ocpp/2.0/OCPP20IncomingRequestService-ClearCache.test.ts | 4 ++++ .../OCPP20IncomingRequestService-DeleteCertificate.test.ts | 4 ++++ .../2.0/OCPP20IncomingRequestService-GetBaseReport.test.ts | 4 ++++ ...0IncomingRequestService-GetInstalledCertificateIds.test.ts | 4 ++++ .../2.0/OCPP20IncomingRequestService-GetVariables.test.ts | 4 ++++ .../OCPP20IncomingRequestService-InstallCertificate.test.ts | 4 ++++ .../2.0/OCPP20IncomingRequestService-RemoteStartAuth.test.ts | 4 ++++ ...PP20IncomingRequestService-RequestStartTransaction.test.ts | 4 ++++ ...CPP20IncomingRequestService-RequestStopTransaction.test.ts | 4 ++++ .../ocpp/2.0/OCPP20IncomingRequestService-Reset.test.ts | 4 ++++ .../2.0/OCPP20IncomingRequestService-SetVariables.test.ts | 4 ++++ .../ocpp/2.0/OCPP20RequestService-BootNotification.test.ts | 4 ++++ .../ocpp/2.0/OCPP20RequestService-HeartBeat.test.ts | 4 ++++ .../ocpp/2.0/OCPP20RequestService-ISO15118.test.ts | 4 ++++ .../ocpp/2.0/OCPP20RequestService-NotifyReport.test.ts | 4 ++++ .../ocpp/2.0/OCPP20RequestService-SignCertificate.test.ts | 4 ++++ .../ocpp/2.0/OCPP20RequestService-StatusNotification.test.ts | 4 ++++ .../OCPP20ServiceUtils-TransactionEvent-CableFirst.test.ts | 4 ++++ .../OCPP20ServiceUtils-TransactionEvent-IdTokenFirst.test.ts | 4 ++++ .../2.0/OCPP20ServiceUtils-TransactionEvent-Offline.test.ts | 4 ++++ .../2.0/OCPP20ServiceUtils-TransactionEvent-Periodic.test.ts | 4 ++++ .../ocpp/2.0/OCPP20ServiceUtils-TransactionEvent.test.ts | 4 ++++ tests/charging-station/ocpp/2.0/OCPP20VariableManager.test.ts | 4 ++++ tests/charging-station/ocpp/auth/OCPPAuthIntegration.test.ts | 4 ++++ .../ocpp/auth/adapters/OCPP16AuthAdapter.test.ts | 4 ++++ .../ocpp/auth/adapters/OCPP20AuthAdapter.offline.test.ts | 4 ++++ .../ocpp/auth/adapters/OCPP20AuthAdapter.test.ts | 4 ++++ .../ocpp/auth/cache/InMemoryAuthCache.test.ts | 4 ++++ .../ocpp/auth/factories/AuthComponentFactory.test.ts | 4 ++++ .../ocpp/auth/services/OCPPAuthServiceFactory.test.ts | 4 ++++ .../ocpp/auth/services/OCPPAuthServiceImpl.test.ts | 4 ++++ .../ocpp/auth/strategies/CertificateAuthStrategy.test.ts | 4 ++++ .../ocpp/auth/strategies/LocalAuthStrategy.test.ts | 4 ++++ .../ocpp/auth/strategies/RemoteAuthStrategy.test.ts | 4 ++++ tests/charging-station/ocpp/auth/types/AuthTypes.test.ts | 4 ++++ tests/charging-station/ocpp/auth/utils/AuthHelpers.test.ts | 4 ++++ tests/charging-station/ocpp/auth/utils/AuthValidators.test.ts | 4 ++++ .../charging-station/ocpp/auth/utils/ConfigValidator.test.ts | 4 ++++ tests/charging-station/ui-server/UIHttpServer.test.ts | 4 ++++ tests/charging-station/ui-server/UIServerSecurity.test.ts | 4 ++++ tests/charging-station/ui-server/UIWebSocketServer.test.ts | 4 ++++ .../ui-server/ui-services/AbstractUIService.test.ts | 4 ++++ tests/exception/BaseError.test.ts | 4 ++++ tests/exception/OCPPError.test.ts | 4 ++++ tests/types/ConfigurationData.test.ts | 4 ++++ tests/utils/AsyncLock.test.ts | 4 ++++ tests/utils/ConfigurationUtils.test.ts | 4 ++++ tests/utils/ElectricUtils.test.ts | 4 ++++ tests/utils/ErrorUtils.test.ts | 4 ++++ tests/utils/StatisticUtils.test.ts | 4 ++++ tests/utils/Utils.test.ts | 4 ++++ tests/worker/WorkerUtils.test.ts | 4 ++++ 58 files changed, 232 insertions(+) diff --git a/tests/ChargingStationFactory.test.ts b/tests/ChargingStationFactory.test.ts index a3080dd1..b3b38090 100644 --- a/tests/ChargingStationFactory.test.ts +++ b/tests/ChargingStationFactory.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for ChargingStationFactory + * @description Unit tests for charging station factory utilities and OCPP service mocking + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/charging-station/ChargingStation.test.ts b/tests/charging-station/ChargingStation.test.ts index d87fae2d..4792a72e 100644 --- a/tests/charging-station/ChargingStation.test.ts +++ b/tests/charging-station/ChargingStation.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for ChargingStation + * @description Unit tests for charging station lifecycle, state management, and connector operations + */ import { expect } from '@std/expect' import { afterEach, describe, it } from 'node:test' diff --git a/tests/charging-station/ConfigurationKeyUtils.test.ts b/tests/charging-station/ConfigurationKeyUtils.test.ts index f1572099..7c9474d8 100644 --- a/tests/charging-station/ConfigurationKeyUtils.test.ts +++ b/tests/charging-station/ConfigurationKeyUtils.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for ConfigurationKeyUtils + * @description Unit tests for OCPP configuration key management utilities + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/charging-station/Helpers.test.ts b/tests/charging-station/Helpers.test.ts index 26057bc6..f76e1c36 100644 --- a/tests/charging-station/Helpers.test.ts +++ b/tests/charging-station/Helpers.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for Helpers + * @description Unit tests for charging station helper functions and utilities + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ import { expect } from '@std/expect' diff --git a/tests/charging-station/ocpp/2.0/OCPP20CertificateManager.test.ts b/tests/charging-station/ocpp/2.0/OCPP20CertificateManager.test.ts index 2174c300..701dab7d 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20CertificateManager.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20CertificateManager.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20CertificateManager + * @description Unit tests for OCPP 2.0 certificate management and validation + */ /* eslint-disable @typescript-eslint/no-explicit-any */ import { expect } from '@std/expect' diff --git a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-CertificateSigned.test.ts b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-CertificateSigned.test.ts index 16e97431..8288297d 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-CertificateSigned.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-CertificateSigned.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20IncomingRequestService CertificateSigned + * @description Unit tests for OCPP 2.0 CertificateSigned command handling + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-ClearCache.test.ts b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-ClearCache.test.ts index 53953254..86edbab7 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-ClearCache.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-ClearCache.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20IncomingRequestService ClearCache + * @description Unit tests for OCPP 2.0 ClearCache command handling (C11) + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-DeleteCertificate.test.ts b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-DeleteCertificate.test.ts index a10d3377..2cbba94c 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-DeleteCertificate.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-DeleteCertificate.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20IncomingRequestService DeleteCertificate + * @description Unit tests for OCPP 2.0 DeleteCertificate command handling + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-GetBaseReport.test.ts b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-GetBaseReport.test.ts index 4b18e7b6..6626981d 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-GetBaseReport.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-GetBaseReport.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20IncomingRequestService GetBaseReport + * @description Unit tests for OCPP 2.0 GetBaseReport command handling (B07) + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-GetInstalledCertificateIds.test.ts b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-GetInstalledCertificateIds.test.ts index 3e0ec081..fc8e5954 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-GetInstalledCertificateIds.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-GetInstalledCertificateIds.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20IncomingRequestService GetInstalledCertificateIds + * @description Unit tests for OCPP 2.0 GetInstalledCertificateIds command handling + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-GetVariables.test.ts b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-GetVariables.test.ts index e1fa95b4..296be18b 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-GetVariables.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-GetVariables.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20IncomingRequestService GetVariables + * @description Unit tests for OCPP 2.0 GetVariables command handling (B06) + */ import { expect } from '@std/expect' import { millisecondsToSeconds } from 'date-fns' import { describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-InstallCertificate.test.ts b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-InstallCertificate.test.ts index 4877e9ae..d6e841df 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-InstallCertificate.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-InstallCertificate.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20IncomingRequestService InstallCertificate + * @description Unit tests for OCPP 2.0 InstallCertificate command handling + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-RemoteStartAuth.test.ts b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-RemoteStartAuth.test.ts index b66c93d3..bc82ba99 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-RemoteStartAuth.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-RemoteStartAuth.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20IncomingRequestService RemoteStartAuth + * @description Unit tests for OCPP 2.0 remote start pre-authorization (G03.FR.03) + */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-explicit-any */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-RequestStartTransaction.test.ts b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-RequestStartTransaction.test.ts index 4b5e808c..9caf893f 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-RequestStartTransaction.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-RequestStartTransaction.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20IncomingRequestService RequestStartTransaction + * @description Unit tests for OCPP 2.0 RequestStartTransaction command handling (F01/F02) + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-RequestStopTransaction.test.ts b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-RequestStopTransaction.test.ts index 30679cfd..b0fe70a1 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-RequestStopTransaction.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-RequestStopTransaction.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20IncomingRequestService RequestStopTransaction + * @description Unit tests for OCPP 2.0 RequestStopTransaction command handling (F03) + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-Reset.test.ts b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-Reset.test.ts index dcb233cc..4b69942e 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-Reset.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-Reset.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20IncomingRequestService Reset + * @description Unit tests for OCPP 2.0 Reset command handling (B11/B12) + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-SetVariables.test.ts b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-SetVariables.test.ts index 0f0c8bba..f739bb70 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-SetVariables.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20IncomingRequestService-SetVariables.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20IncomingRequestService SetVariables + * @description Unit tests for OCPP 2.0 SetVariables command handling + */ /* eslint-disable @typescript-eslint/no-explicit-any */ import { expect } from '@std/expect' diff --git a/tests/charging-station/ocpp/2.0/OCPP20RequestService-BootNotification.test.ts b/tests/charging-station/ocpp/2.0/OCPP20RequestService-BootNotification.test.ts index 385a4193..827c98bc 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20RequestService-BootNotification.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20RequestService-BootNotification.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20RequestService BootNotification + * @description Unit tests for OCPP 2.0 BootNotification request building (B01) + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20RequestService-HeartBeat.test.ts b/tests/charging-station/ocpp/2.0/OCPP20RequestService-HeartBeat.test.ts index d1a87c96..79e0ba2b 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20RequestService-HeartBeat.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20RequestService-HeartBeat.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20RequestService HeartBeat + * @description Unit tests for OCPP 2.0 Heartbeat request building (G02) + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20RequestService-ISO15118.test.ts b/tests/charging-station/ocpp/2.0/OCPP20RequestService-ISO15118.test.ts index b6d3d0bd..63589ef9 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20RequestService-ISO15118.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20RequestService-ISO15118.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20RequestService ISO15118 + * @description Unit tests for OCPP 2.0 ISO 15118 certificate and EV communication + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20RequestService-NotifyReport.test.ts b/tests/charging-station/ocpp/2.0/OCPP20RequestService-NotifyReport.test.ts index 5c7af8f1..6d274d5a 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20RequestService-NotifyReport.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20RequestService-NotifyReport.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20RequestService NotifyReport + * @description Unit tests for OCPP 2.0 NotifyReport request building (B07/B08) + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20RequestService-SignCertificate.test.ts b/tests/charging-station/ocpp/2.0/OCPP20RequestService-SignCertificate.test.ts index bda7d1ef..ed8c76ef 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20RequestService-SignCertificate.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20RequestService-SignCertificate.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20RequestService SignCertificate + * @description Unit tests for OCPP 2.0 SignCertificate request building + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20RequestService-StatusNotification.test.ts b/tests/charging-station/ocpp/2.0/OCPP20RequestService-StatusNotification.test.ts index 35210bfb..6ac27aa9 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20RequestService-StatusNotification.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20RequestService-StatusNotification.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20RequestService StatusNotification + * @description Unit tests for OCPP 2.0 StatusNotification request building (G01) + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-CableFirst.test.ts b/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-CableFirst.test.ts index dae0db1f..4184eaad 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-CableFirst.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-CableFirst.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20ServiceUtils TransactionEvent CableFirst + * @description Unit tests for OCPP 2.0 cable-first transaction flow (E02) + */ import { expect } from '@std/expect' import { afterEach, describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-IdTokenFirst.test.ts b/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-IdTokenFirst.test.ts index 00fa1c2a..a2eb73e1 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-IdTokenFirst.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-IdTokenFirst.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20ServiceUtils TransactionEvent IdTokenFirst + * @description Unit tests for OCPP 2.0 IdToken-first pre-authorization flow (E03) + */ import { expect } from '@std/expect' import { afterEach, describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-Offline.test.ts b/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-Offline.test.ts index e7088174..8dbdfb91 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-Offline.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-Offline.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20ServiceUtils TransactionEvent Offline + * @description Unit tests for OCPP 2.0 offline TransactionEvent queueing (E02) + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-argument */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-Periodic.test.ts b/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-Periodic.test.ts index f0713272..2404d4ce 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-Periodic.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent-Periodic.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20ServiceUtils TransactionEvent Periodic + * @description Unit tests for OCPP 2.0 periodic TransactionEvent at TxUpdatedInterval (E02) + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-argument */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent.test.ts b/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent.test.ts index 85b69984..2a121271 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20ServiceUtils-TransactionEvent.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20ServiceUtils TransactionEvent + * @description Unit tests for OCPP 2.0 TransactionEvent building and trigger reasons (E01-E04) + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ diff --git a/tests/charging-station/ocpp/2.0/OCPP20VariableManager.test.ts b/tests/charging-station/ocpp/2.0/OCPP20VariableManager.test.ts index da53b9a7..d52ac643 100644 --- a/tests/charging-station/ocpp/2.0/OCPP20VariableManager.test.ts +++ b/tests/charging-station/ocpp/2.0/OCPP20VariableManager.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20VariableManager + * @description Unit tests for OCPP 2.0 variable management and device model + */ /* eslint-disable @typescript-eslint/no-unsafe-member-access */ /* eslint-disable @typescript-eslint/no-unsafe-assignment */ /* eslint-disable @typescript-eslint/no-unsafe-call */ diff --git a/tests/charging-station/ocpp/auth/OCPPAuthIntegration.test.ts b/tests/charging-station/ocpp/auth/OCPPAuthIntegration.test.ts index 362616a7..c1340d55 100644 --- a/tests/charging-station/ocpp/auth/OCPPAuthIntegration.test.ts +++ b/tests/charging-station/ocpp/auth/OCPPAuthIntegration.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPPAuthIntegration + * @description Integration tests for OCPP authentication across versions 1.6 and 2.0 + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/adapters/OCPP16AuthAdapter.test.ts b/tests/charging-station/ocpp/auth/adapters/OCPP16AuthAdapter.test.ts index 0819b9a6..419411f7 100644 --- a/tests/charging-station/ocpp/auth/adapters/OCPP16AuthAdapter.test.ts +++ b/tests/charging-station/ocpp/auth/adapters/OCPP16AuthAdapter.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP16AuthAdapter + * @description Unit tests for OCPP 1.6 authentication adapter + */ import { expect } from '@std/expect' import { afterEach, beforeEach, describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/adapters/OCPP20AuthAdapter.offline.test.ts b/tests/charging-station/ocpp/auth/adapters/OCPP20AuthAdapter.offline.test.ts index 9a04c66e..ec0dfd6d 100644 --- a/tests/charging-station/ocpp/auth/adapters/OCPP20AuthAdapter.offline.test.ts +++ b/tests/charging-station/ocpp/auth/adapters/OCPP20AuthAdapter.offline.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20AuthAdapter Offline + * @description Unit tests for OCPP 2.0 offline authorization scenarios (G03.FR.02) + */ /** * G03.FR.02 - OCPP 2.0 Offline Authorization Tests * diff --git a/tests/charging-station/ocpp/auth/adapters/OCPP20AuthAdapter.test.ts b/tests/charging-station/ocpp/auth/adapters/OCPP20AuthAdapter.test.ts index 9c65be96..5c3b0e02 100644 --- a/tests/charging-station/ocpp/auth/adapters/OCPP20AuthAdapter.test.ts +++ b/tests/charging-station/ocpp/auth/adapters/OCPP20AuthAdapter.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPP20AuthAdapter + * @description Unit tests for OCPP 2.0 authentication adapter + */ import { expect } from '@std/expect' import { afterEach, beforeEach, describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/cache/InMemoryAuthCache.test.ts b/tests/charging-station/ocpp/auth/cache/InMemoryAuthCache.test.ts index 7402192b..75e6ad10 100644 --- a/tests/charging-station/ocpp/auth/cache/InMemoryAuthCache.test.ts +++ b/tests/charging-station/ocpp/auth/cache/InMemoryAuthCache.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for InMemoryAuthCache + * @description Unit tests for in-memory authorization cache conformance (G03.FR.01) + */ import { expect } from '@std/expect' import { afterEach, beforeEach, describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/factories/AuthComponentFactory.test.ts b/tests/charging-station/ocpp/auth/factories/AuthComponentFactory.test.ts index 99f5989b..f49e2869 100644 --- a/tests/charging-station/ocpp/auth/factories/AuthComponentFactory.test.ts +++ b/tests/charging-station/ocpp/auth/factories/AuthComponentFactory.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for AuthComponentFactory + * @description Unit tests for authentication component factory + */ /* eslint-disable @typescript-eslint/no-confusing-void-expression */ import { expect } from '@std/expect' import { afterEach, describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/services/OCPPAuthServiceFactory.test.ts b/tests/charging-station/ocpp/auth/services/OCPPAuthServiceFactory.test.ts index 4f356cb7..8efc4123 100644 --- a/tests/charging-station/ocpp/auth/services/OCPPAuthServiceFactory.test.ts +++ b/tests/charging-station/ocpp/auth/services/OCPPAuthServiceFactory.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPPAuthServiceFactory + * @description Unit tests for OCPP authentication service factory + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/services/OCPPAuthServiceImpl.test.ts b/tests/charging-station/ocpp/auth/services/OCPPAuthServiceImpl.test.ts index dc7a4e72..48b1e4e2 100644 --- a/tests/charging-station/ocpp/auth/services/OCPPAuthServiceImpl.test.ts +++ b/tests/charging-station/ocpp/auth/services/OCPPAuthServiceImpl.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPPAuthServiceImpl + * @description Unit tests for OCPP authentication service implementation + */ import { expect } from '@std/expect' import { afterEach, describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/strategies/CertificateAuthStrategy.test.ts b/tests/charging-station/ocpp/auth/strategies/CertificateAuthStrategy.test.ts index fec4c918..50ca4ddc 100644 --- a/tests/charging-station/ocpp/auth/strategies/CertificateAuthStrategy.test.ts +++ b/tests/charging-station/ocpp/auth/strategies/CertificateAuthStrategy.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for CertificateAuthStrategy + * @description Unit tests for certificate-based authentication strategy + */ import { expect } from '@std/expect' import { afterEach, beforeEach, describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/strategies/LocalAuthStrategy.test.ts b/tests/charging-station/ocpp/auth/strategies/LocalAuthStrategy.test.ts index fd2eee25..04f8c0d2 100644 --- a/tests/charging-station/ocpp/auth/strategies/LocalAuthStrategy.test.ts +++ b/tests/charging-station/ocpp/auth/strategies/LocalAuthStrategy.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for LocalAuthStrategy + * @description Unit tests for local authorization strategy (cache and local list) + */ import { expect } from '@std/expect' import { afterEach, beforeEach, describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/strategies/RemoteAuthStrategy.test.ts b/tests/charging-station/ocpp/auth/strategies/RemoteAuthStrategy.test.ts index d0492b05..b1d6002c 100644 --- a/tests/charging-station/ocpp/auth/strategies/RemoteAuthStrategy.test.ts +++ b/tests/charging-station/ocpp/auth/strategies/RemoteAuthStrategy.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for RemoteAuthStrategy + * @description Unit tests for remote (CSMS) authorization strategy + */ import { expect } from '@std/expect' import { afterEach, beforeEach, describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/types/AuthTypes.test.ts b/tests/charging-station/ocpp/auth/types/AuthTypes.test.ts index 7a25990a..b8661050 100644 --- a/tests/charging-station/ocpp/auth/types/AuthTypes.test.ts +++ b/tests/charging-station/ocpp/auth/types/AuthTypes.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for AuthTypes + * @description Unit tests for authentication type definitions and mappings + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/utils/AuthHelpers.test.ts b/tests/charging-station/ocpp/auth/utils/AuthHelpers.test.ts index 728d4104..c4d4a849 100644 --- a/tests/charging-station/ocpp/auth/utils/AuthHelpers.test.ts +++ b/tests/charging-station/ocpp/auth/utils/AuthHelpers.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for AuthHelpers + * @description Unit tests for authentication helper utilities + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/utils/AuthValidators.test.ts b/tests/charging-station/ocpp/auth/utils/AuthValidators.test.ts index 6484e61b..0b39ba03 100644 --- a/tests/charging-station/ocpp/auth/utils/AuthValidators.test.ts +++ b/tests/charging-station/ocpp/auth/utils/AuthValidators.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for AuthValidators + * @description Unit tests for authentication validation utilities + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/charging-station/ocpp/auth/utils/ConfigValidator.test.ts b/tests/charging-station/ocpp/auth/utils/ConfigValidator.test.ts index 36048f50..1dd09d88 100644 --- a/tests/charging-station/ocpp/auth/utils/ConfigValidator.test.ts +++ b/tests/charging-station/ocpp/auth/utils/ConfigValidator.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for AuthConfigValidator + * @description Unit tests for authentication configuration validation + */ // Copyright Jerome Benoit. 2021-2025. All Rights Reserved. import { expect } from '@std/expect' diff --git a/tests/charging-station/ui-server/UIHttpServer.test.ts b/tests/charging-station/ui-server/UIHttpServer.test.ts index f1f8ee73..e064b489 100644 --- a/tests/charging-station/ui-server/UIHttpServer.test.ts +++ b/tests/charging-station/ui-server/UIHttpServer.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for UIHttpServer + * @description Unit tests for HTTP-based UI server and response handling + */ // Copyright Jerome Benoit. 2024-2025. All Rights Reserved. import { expect } from '@std/expect' diff --git a/tests/charging-station/ui-server/UIServerSecurity.test.ts b/tests/charging-station/ui-server/UIServerSecurity.test.ts index 42d8d574..7cd64e6f 100644 --- a/tests/charging-station/ui-server/UIServerSecurity.test.ts +++ b/tests/charging-station/ui-server/UIServerSecurity.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for UIServerSecurity + * @description Unit tests for UI server security utilities (rate limiting, validation) + */ // Copyright Jerome Benoit. 2024-2025. All Rights Reserved. import { expect } from '@std/expect' diff --git a/tests/charging-station/ui-server/UIWebSocketServer.test.ts b/tests/charging-station/ui-server/UIWebSocketServer.test.ts index 09e8ed5c..11cfd8c9 100644 --- a/tests/charging-station/ui-server/UIWebSocketServer.test.ts +++ b/tests/charging-station/ui-server/UIWebSocketServer.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for UIWebSocketServer + * @description Unit tests for WebSocket-based UI server and response handling + */ // Copyright Jerome Benoit. 2024-2025. All Rights Reserved. import { expect } from '@std/expect' diff --git a/tests/charging-station/ui-server/ui-services/AbstractUIService.test.ts b/tests/charging-station/ui-server/ui-services/AbstractUIService.test.ts index 8fe59736..5aef755f 100644 --- a/tests/charging-station/ui-server/ui-services/AbstractUIService.test.ts +++ b/tests/charging-station/ui-server/ui-services/AbstractUIService.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for AbstractUIService + * @description Unit tests for abstract UI service base class functionality + */ // Copyright Jerome Benoit. 2024-2025. All Rights Reserved. import { expect } from '@std/expect' diff --git a/tests/exception/BaseError.test.ts b/tests/exception/BaseError.test.ts index f18aff16..1a341ac7 100644 --- a/tests/exception/BaseError.test.ts +++ b/tests/exception/BaseError.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for BaseError + * @description Unit tests for base error class functionality + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/exception/OCPPError.test.ts b/tests/exception/OCPPError.test.ts index 6ae6180d..8145b5cf 100644 --- a/tests/exception/OCPPError.test.ts +++ b/tests/exception/OCPPError.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for OCPPError + * @description Unit tests for OCPP-specific error class + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/types/ConfigurationData.test.ts b/tests/types/ConfigurationData.test.ts index 9983808e..6f6b704a 100644 --- a/tests/types/ConfigurationData.test.ts +++ b/tests/types/ConfigurationData.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for ConfigurationData + * @description Unit tests for configuration data types and enumerations + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/utils/AsyncLock.test.ts b/tests/utils/AsyncLock.test.ts index dcdd8b0a..58646289 100644 --- a/tests/utils/AsyncLock.test.ts +++ b/tests/utils/AsyncLock.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for AsyncLock + * @description Unit tests for asynchronous lock utilities + */ import { expect } from '@std/expect' import { randomInt } from 'node:crypto' import { describe, it } from 'node:test' diff --git a/tests/utils/ConfigurationUtils.test.ts b/tests/utils/ConfigurationUtils.test.ts index 73a4d087..30e6015e 100644 --- a/tests/utils/ConfigurationUtils.test.ts +++ b/tests/utils/ConfigurationUtils.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for ConfigurationUtils + * @description Unit tests for configuration utility functions + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/utils/ElectricUtils.test.ts b/tests/utils/ElectricUtils.test.ts index b8e47406..9ebf495a 100644 --- a/tests/utils/ElectricUtils.test.ts +++ b/tests/utils/ElectricUtils.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for ElectricUtils + * @description Unit tests for electrical calculations (AC/DC power, amperage) + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/utils/ErrorUtils.test.ts b/tests/utils/ErrorUtils.test.ts index 09df6a30..85682bb7 100644 --- a/tests/utils/ErrorUtils.test.ts +++ b/tests/utils/ErrorUtils.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for ErrorUtils + * @description Unit tests for error handling utilities + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/utils/StatisticUtils.test.ts b/tests/utils/StatisticUtils.test.ts index 95419fb1..d578bc9c 100644 --- a/tests/utils/StatisticUtils.test.ts +++ b/tests/utils/StatisticUtils.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for StatisticUtils + * @description Unit tests for statistical calculation utilities + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' diff --git a/tests/utils/Utils.test.ts b/tests/utils/Utils.test.ts index 1abbd5bd..4d91042f 100644 --- a/tests/utils/Utils.test.ts +++ b/tests/utils/Utils.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for Utils + * @description Unit tests for general utility functions + */ import { expect } from '@std/expect' import { hoursToMilliseconds, hoursToSeconds } from 'date-fns' import { CircularBuffer } from 'mnemonist' diff --git a/tests/worker/WorkerUtils.test.ts b/tests/worker/WorkerUtils.test.ts index b0297914..9ff80058 100644 --- a/tests/worker/WorkerUtils.test.ts +++ b/tests/worker/WorkerUtils.test.ts @@ -1,3 +1,7 @@ +/** + * @file Tests for WorkerUtils + * @description Unit tests for worker process utility functions + */ import { expect } from '@std/expect' import { describe, it } from 'node:test' -- 2.43.0