1 import { AsyncResource
} from
'node:async_hooks';
3 import Ajv
, { type JSONSchemaType
} from
'ajv';
4 import ajvFormats from
'ajv-formats';
6 import { OCPPConstants
, OCPPServiceUtils
} from
'./internal';
7 import { type ChargingStation
, ChargingStationUtils
} from
'../../charging-station';
8 import { OCPPError
} from
'../../exception';
12 IncomingRequestCommand
,
17 import { logger
} from
'../../utils';
19 const moduleName
= 'OCPPIncomingRequestService';
21 export abstract class OCPPIncomingRequestService
extends AsyncResource
{
22 private static instance
: OCPPIncomingRequestService
| null = null;
23 private readonly version
: OCPPVersion
;
24 private readonly ajv
: Ajv
;
25 protected abstract jsonSchemas
: Map
<IncomingRequestCommand
, JSONSchemaType
<JsonObject
>>;
27 protected constructor(version
: OCPPVersion
) {
29 this.version
= version
;
31 keywords
: ['javaType'],
32 multipleOfPrecision
: 2,
35 this.incomingRequestHandler
= this.incomingRequestHandler
.bind(this) as (
36 chargingStation
: ChargingStation
,
38 commandName
: IncomingRequestCommand
,
39 commandPayload
: JsonType
41 this.validateIncomingRequestPayload
= this.validateIncomingRequestPayload
.bind(this) as <
44 chargingStation
: ChargingStation
,
45 commandName
: IncomingRequestCommand
,
46 schema
: JSONSchemaType
<T
>,
51 public static getInstance
<T
extends OCPPIncomingRequestService
>(this: new () => T
): T
{
52 if (OCPPIncomingRequestService
.instance
=== null) {
53 OCPPIncomingRequestService
.instance
= new this();
55 return OCPPIncomingRequestService
.instance
as T
;
58 protected handleIncomingRequestError
<T
>(
59 chargingStation
: ChargingStation
,
60 commandName
: IncomingRequestCommand
,
62 params
: HandleErrorParams
<T
> = { throwError
: true }
65 `${chargingStation.logPrefix()} ${moduleName}.handleIncomingRequestError: Incoming request command '${commandName}' error:`,
68 if (!params
?.throwError
&& params
?.errorResponse
) {
69 return params
?.errorResponse
;
71 if (params
?.throwError
&& !params
?.errorResponse
) {
74 if (params
?.throwError
&& params
?.errorResponse
) {
75 return params
?.errorResponse
;
79 protected validateIncomingRequestPayload
<T
extends JsonType
>(
80 chargingStation
: ChargingStation
,
81 commandName
: IncomingRequestCommand
,
82 schema
: JSONSchemaType
<T
>,
85 if (chargingStation
.getPayloadSchemaValidation() === false) {
88 const validate
= this.ajv
.compile(schema
);
89 if (validate(payload
)) {
93 `${chargingStation.logPrefix()} ${moduleName}.validateIncomingRequestPayload: Command '${commandName}' incoming request PDU is invalid: %j`,
97 OCPPServiceUtils
.ajvErrorsToErrorType(validate
.errors
),
98 'Incoming request PDU is invalid',
100 JSON
.stringify(validate
.errors
, null, 2)
104 protected handleRequestClearCache(chargingStation
: ChargingStation
): ClearCacheResponse
{
105 chargingStation
.idTagsCache
.deleteIdTags(
106 ChargingStationUtils
.getIdTagsFile(chargingStation
.stationInfo
)
108 return OCPPConstants
.OCPP_RESPONSE_ACCEPTED
;
111 public abstract incomingRequestHandler(
112 chargingStation
: ChargingStation
,
114 commandName
: IncomingRequestCommand
,
115 commandPayload
: JsonType