@zetra/citrineos-base 1.8.3-fork.1

package/dist/interfaces/api/AbstractModuleApi.js

@@ -0,0 +1,333 @@
+// SPDX-FileCopyrightText: 2025 Contributors to the CitrineOS Project
+//
+// SPDX-License-Identifier: Apache-2.0
+import 'reflect-metadata';
+import { Logger } from 'tslog';
+import { HttpMethod, METADATA_DATA_ENDPOINTS, METADATA_MESSAGE_ENDPOINTS } from './index.js';
+import { ConfigStoreFactory, MessageConfirmationSchema, Namespace, OCPP1_6_Namespace, OCPPVersion, systemConfigSchema, } from '../../index.js';
+import { OCPP2_0_1_Namespace } from '../../ocpp/persistence/index.js';
+import { IMessageQuerystringSchema } from './MessageQuerystring.js';
+import { AuthorizationSecurity } from './AuthorizationSecurity.js';
+import { z } from 'zod';
+/**
+ * Abstract module api class implementation.
+ */
+export class AbstractModuleApi {
+    _server;
+    _module;
+    _logger;
+    _ocppVersion;
+    constructor(module, server, ocppVersion, logger) {
+        this._module = module;
+        this._server = server;
+        this._ocppVersion = ocppVersion;
+        this._logger = logger
+            ? logger.getSubLogger({ name: this.constructor.name })
+            : new Logger({ name: this.constructor.name });
+        this._init(this._module);
+    }
+    /**
+     * Initializes the API for the given module.
+     *
+     * @param {T} module - The module to initialize the API for.
+     */
+    _init(module) {
+        Reflect.getMetadata(METADATA_MESSAGE_ENDPOINTS, this.constructor)?.forEach((expose) => {
+            this._addMessageRoute.call(this, expose.action, expose.method, expose.bodySchema, expose.optionalQuerystrings);
+        });
+        const dataEndpointDefinitions = Reflect.getMetadata(METADATA_DATA_ENDPOINTS, this.constructor);
+        dataEndpointDefinitions?.forEach((expose) => {
+            this._addDataRoute.call(this, expose.namespace, expose.method, expose.httpMethod, expose.querySchema, expose.paramSchema, expose.headerSchema, expose.bodySchema, expose.responseSchema, expose.tags, expose.description, expose.security);
+        });
+        if (dataEndpointDefinitions && dataEndpointDefinitions.length > 0) {
+            this.registerSystemConfigRoutes(module);
+        }
+    }
+    /**
+     * Add a message route to the server.
+     *
+     * @param {CallAction} action - The action to be called.
+     * @param {Function} method - The method to be executed.
+     * @param {object} bodySchema - The schema for the route.
+     * @param {Record<string, any>} optionalQuerystrings - Optional querystrings for the route.
+     * @return {void}
+     */
+    _addMessageRoute(action, method, bodySchema, optionalQuerystrings) {
+        this._logger.debug(`Adding message route for ${action}`, this._toMessagePath(action));
+        /**
+         * Executes the handler function for the given request.
+         *
+         * @param {FastifyRequest<{ Body: OcppRequest, Querystring: IMessageQuerystring }>} request - The request object containing the body and querystring.
+         * @return {Promise<IMessageConfirmation>} The promise that resolves to the message confirmation.
+         */
+        const _handler = async (request) => {
+            const { identifier, tenantId, callbackUrl, ...extraQueries } = request.query;
+            const identifiers = Array.isArray(identifier) ? identifier : [identifier];
+            return method.call(this, identifiers, request.body, callbackUrl, tenantId, Object.keys(extraQueries).length > 0 ? extraQueries : undefined);
+        };
+        const mergedQuerySchema = {
+            ...IMessageQuerystringSchema,
+            properties: {
+                ...IMessageQuerystringSchema.properties,
+                ...(optionalQuerystrings || {}),
+            },
+        };
+        const _opts = {
+            method: HttpMethod.Post,
+            url: this._toMessagePath(action),
+            handler: _handler,
+            schema: {
+                body: bodySchema,
+                querystring: mergedQuerySchema,
+                response: {
+                    200: {
+                        $id: 'MessageConfirmationSchemaArray',
+                        type: 'array',
+                        items: MessageConfirmationSchema,
+                    },
+                },
+            },
+        };
+        if (this._module.config.util.swagger?.exposeMessage) {
+            this._server.register(async (fastifyInstance) => {
+                this.registerSchemaForOpts(fastifyInstance, _opts);
+                fastifyInstance.route(_opts);
+            });
+        }
+        else {
+            this._server.route(_opts);
+        }
+    }
+    /**
+     * Add a message route to the server.
+     *
+     * @param {OCPP2_0_1_Namespace | OCPP1_6_Namespace | Namespace} namespace - The entity type.
+     * @param {Function} method - The method to be executed.
+     * @param {HttpMethod} httpMethod - The HTTP method to be used.
+     * @param {object} querySchema - The schema for the querystring.
+     * @param {object} paramSchema - The schema for the parameters.
+     * @param {object} headerSchema - The schema for the headers.
+     * @param {object} bodySchema - The schema for the body.
+     * @param {object} responseSchema - The schema for the response.
+     * @param {string[]} tags - The tags for the route.
+     * @param {string} description - The description for the route.
+     * @param {object[]} security - The security for the route.
+     * @return {void}
+     */
+    _addDataRoute(namespace, method, httpMethod, querySchema, paramSchema, headerSchema, bodySchema, responseSchema, tags, description, security) {
+        this._logger.debug(`Adding data route for ${namespace}`, this._toDataPath(namespace), httpMethod);
+        const schema = {};
+        if (querySchema) {
+            schema['querystring'] = querySchema;
+        }
+        if (bodySchema) {
+            schema['body'] = bodySchema;
+        }
+        if (paramSchema) {
+            schema['params'] = paramSchema;
+        }
+        if (headerSchema) {
+            schema['headers'] = headerSchema;
+        }
+        if (responseSchema) {
+            schema['response'] = {
+                200: responseSchema,
+            };
+        }
+        if (tags) {
+            schema['tags'] = tags;
+        }
+        if (description) {
+            schema['description'] = description;
+        }
+        if (security) {
+            schema['security'] = security;
+        }
+        /**
+         * Handles the request and returns a Promise resolving to an object.
+         *
+         * @param {FastifyRequest<{ Body: object, Querystring: object }>} request - the request object
+         * @param {FastifyReply} reply - the reply object
+         * @return {Promise<any>} - a Promise resolving to an object
+         */
+        const _handler = async (request, reply) => method.call(this, request, reply).catch((err) => {
+            // TODO: figure out better error codes & messages
+            this._logger.error('Error in handling data route', err);
+            const statusCode = err.statusCode ? err.statusCode : 500;
+            reply.status(statusCode).send(err);
+        });
+        const _opts = {
+            method: httpMethod,
+            url: this._toDataPath(namespace),
+            schema: schema,
+            handler: _handler,
+        };
+        if (!!schema &&
+            !!schema.headers &&
+            !!schema.headers.properties &&
+            !!schema.headers.properties.Authorization) {
+            _opts['preHandler'] = this._server.auth([
+                this._server.authorization,
+            ]);
+            if (!_opts['security']) {
+                _opts.schema['security'] = [AuthorizationSecurity];
+            }
+            else {
+                _opts.schema['security'].push(AuthorizationSecurity);
+            }
+        }
+        if (this._module.config.util.swagger?.exposeData) {
+            this._server.register(async (fastifyInstance) => {
+                this.registerSchemaForOpts(fastifyInstance, _opts);
+                fastifyInstance.route(_opts);
+            });
+        }
+        else {
+            this._server.route(_opts);
+        }
+    }
+    registerSchemaForOpts = (fastifyInstance, _opts) => {
+        if (_opts.schema['querystring']) {
+            _opts.schema['querystring'] = this.registerSchema(fastifyInstance, _opts.schema['querystring']);
+        }
+        if (_opts.schema['body']) {
+            _opts.schema['body'] = this.registerSchema(fastifyInstance, _opts.schema['body'], this._ocppVersion ? `${this._ocppVersion}-` : '');
+        }
+        if (_opts.schema['params']) {
+            _opts.schema['params'] = this.registerSchema(fastifyInstance, _opts.schema['params']);
+        }
+        if (_opts.schema['headers']) {
+            _opts.schema['headers'] = this.registerSchema(fastifyInstance, _opts.schema['headers']);
+        }
+        if (_opts.schema['response']) {
+            _opts.schema['response'] = {
+                200: this.registerSchema(fastifyInstance, _opts.schema['response'][200]),
+            };
+        }
+    };
+    registerSchema = (fastifyInstance, schema, schemaIdPrefix) => {
+        let id = schema['$id'];
+        if (!id) {
+            this._logger.error('Could not register schema because no ID', schema);
+        }
+        try {
+            const schemaCopy = this.removeUnknownKeys(schema);
+            if (id && schemaIdPrefix) {
+                id = schemaIdPrefix + id;
+                schemaCopy['$id'] = id;
+                this._logger.debug(`Update schema id: ${schemaCopy['$id']}`);
+            }
+            if (schemaCopy.required &&
+                Array.isArray(schemaCopy.required) &&
+                schemaCopy.required.length === 0) {
+                delete schemaCopy.required;
+            }
+            if (schema.definitions) {
+                Object.keys(schema.definitions).forEach((key) => {
+                    const definition = schema.definitions[key];
+                    if (!definition['$id']) {
+                        definition['$id'] = key;
+                    }
+                    this.registerSchema(fastifyInstance, definition);
+                });
+            }
+            if (schemaCopy.properties) {
+                Object.keys(schemaCopy.properties).forEach((key) => {
+                    const property = schemaCopy.properties[key];
+                    if (property.$ref) {
+                        property.$ref = property.$ref.replace('#/definitions/', '');
+                    }
+                    if (property.items && property.items.$ref) {
+                        property.items.$ref = property.items.$ref.replace('#/definitions/', '');
+                    }
+                });
+            }
+            fastifyInstance.addSchema(schemaCopy);
+            this._server.addSchema(schemaCopy);
+            return {
+                $ref: `${id}`,
+            };
+        }
+        catch (e) {
+            // ignore already declared
+            if (e.code === 'FST_ERR_SCH_ALREADY_PRESENT') {
+                return {
+                    $ref: `${id}`,
+                };
+            }
+            else {
+                this._logger.error('Could not register schema', e, schema);
+            }
+            return null;
+        }
+    };
+    registerSystemConfigRoutes(module) {
+        this._addDataRoute.call(this, OCPP2_0_1_Namespace.SystemConfig, () => new Promise((resolve) => resolve(module.config)), HttpMethod.Get);
+        const systemConfigJsonSchema = z.toJSONSchema(systemConfigSchema, {
+            target: 'openapi-3.0',
+        });
+        this._addDataRoute.call(this, OCPP2_0_1_Namespace.SystemConfig, async (request) => {
+            await ConfigStoreFactory.getInstance().saveConfig(request.body);
+            module.config = request.body;
+        }, HttpMethod.Put, undefined, undefined, undefined, {
+            ...systemConfigJsonSchema,
+            $id: 'SystemConfigSchema',
+        });
+    }
+    // TODO: for performance reasons can these unknown keys be removed directly from schemas?
+    removeUnknownKeys = (schema) => {
+        // Create a deep copy of the schema
+        const schemaCopy = structuredClone(schema); // Use structuredClone for a true deep copy
+        const cleanSchema = (obj) => {
+            if (typeof obj !== 'object' || obj === null)
+                return;
+            // Remove specific unknown keys
+            for (const unknownKey of ['comment', 'javaType', 'tsEnumNames']) {
+                if (unknownKey in obj) {
+                    delete obj[unknownKey];
+                }
+            }
+            // Remove `additionalItems` if `items` is not an array
+            if ('items' in obj && !Array.isArray(obj.items) && 'additionalItems' in obj) {
+                delete obj.additionalItems;
+            }
+            // Remove `additionalProperties` if `type` is not "object"
+            if ('additionalProperties' in obj && obj.type !== 'object') {
+                delete obj.additionalProperties;
+            }
+            // Recursively process nested objects
+            for (const key in obj) {
+                if (typeof obj[key] === 'object') {
+                    cleanSchema(obj[key]);
+                }
+            }
+        };
+        // Clean the copied schema
+        cleanSchema(schemaCopy);
+        return schemaCopy;
+    };
+    /**
+     * Convert a {@link CallAction} to a normed lowercase URL path.
+     *
+     * @param {CallAction} input - The {@link CallAction} to convert to a URL path.
+     * @param {string} prefix - The module name.
+     * @returns {string} - String representation of URL path.
+     */
+    _toMessagePath(input, prefix) {
+        const endpointPrefix = prefix || '';
+        const endpointVersion = (this._ocppVersion ? this._ocppVersion : OCPPVersion.OCPP2_0_1).replace(/^ocpp/, '');
+        return `/ocpp/${endpointVersion}${!endpointPrefix.startsWith('/') ? '/' : ''}${endpointPrefix}${!endpointPrefix.endsWith('/') ? '/' : ''}${input.charAt(0).toLowerCase() + input.slice(1)}`;
+    }
+    /**
+     * Convert a namespace to a normed lowercase URL path.
+     *
+     * @param {OCPP2_0_1_Namespace | OCPP1_6_Namespace | Namespace} input - The {@link OCPP2_0_1_Namespace} or {@link OCPP1_6_Namespace} or {@link Namespace} to convert to a URL path.
+     * @param {string} prefix - The module name.
+     * @returns {string} - String representation of URL path.
+     */
+    _toDataPath(input, prefix) {
+        const endpointPrefix = prefix || '';
+        return `/data${!endpointPrefix.startsWith('/') ? '/' : ''}${endpointPrefix}${!endpointPrefix.endsWith('/') ? '/' : ''}${input.charAt(0).toLowerCase() + input.slice(1)}`;
+    }
+}
+//# sourceMappingURL=AbstractModuleApi.js.map

package/dist/interfaces/api/AbstractModuleApi.js.map

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

package/dist/interfaces/api/AsDataEndpoint.d.ts

@@ -0,0 +1,18 @@
+import { HttpMethod } from './index.js';
+import { Namespace, OCPP1_6_Namespace, OCPP2_0_1_Namespace } from '../../ocpp/persistence/index.js';
+/**
+ * Decorator for use in module API class to expose methods as REST data endpoints.
+ *
+ * @param {OCPP2_0_1_Namespace} namespace - The namespace value.
+ * @param {HttpMethod} method - The HTTP method value.
+ * @param {object} querySchema - The query schema value (optional).
+ * @param {object} bodySchema - The body schema value (optional).
+ * @param {object} paramSchema - The param schema value (optional).
+ * @param {object} headerSchema - The header schema value (optional).
+ * @param {object} responseSchema - The response schema value (optional).
+ * @param {object} tags - The tags value (optional).
+ * @param {object} security - The security value (optional).
+ * @param {string} description - The description (optional).
+ * @return {void} - No return value.
+ */
+export declare const AsDataEndpoint: (namespace: OCPP2_0_1_Namespace | OCPP1_6_Namespace | Namespace, method: HttpMethod, querySchema?: object, bodySchema?: object, paramSchema?: object, headerSchema?: object, responseSchema?: object, tags?: string | string[], security?: object[], description?: string) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;

package/dist/interfaces/api/AsDataEndpoint.js

@@ -0,0 +1,45 @@
+import { HttpMethod, METADATA_DATA_ENDPOINTS } from './index.js';
+import { Namespace, OCPP1_6_Namespace, OCPP2_0_1_Namespace } from '../../ocpp/persistence/index.js';
+/**
+ * Decorator for use in module API class to expose methods as REST data endpoints.
+ *
+ * @param {OCPP2_0_1_Namespace} namespace - The namespace value.
+ * @param {HttpMethod} method - The HTTP method value.
+ * @param {object} querySchema - The query schema value (optional).
+ * @param {object} bodySchema - The body schema value (optional).
+ * @param {object} paramSchema - The param schema value (optional).
+ * @param {object} headerSchema - The header schema value (optional).
+ * @param {object} responseSchema - The response schema value (optional).
+ * @param {object} tags - The tags value (optional).
+ * @param {object} security - The security value (optional).
+ * @param {string} description - The description (optional).
+ * @return {void} - No return value.
+ */
+export const AsDataEndpoint = function (namespace, method, querySchema, bodySchema, paramSchema, headerSchema, responseSchema, tags, security, description) {
+    return (target, propertyKey, descriptor) => {
+        if (!Reflect.hasMetadata(METADATA_DATA_ENDPOINTS, target.constructor)) {
+            Reflect.defineMetadata(METADATA_DATA_ENDPOINTS, [], target.constructor);
+        }
+        const dataEndpoints = Reflect.getMetadata(METADATA_DATA_ENDPOINTS, target.constructor);
+        let tagList = undefined;
+        if (tags) {
+            tagList = Array.isArray(tags) ? tags : [tags];
+        }
+        dataEndpoints.push({
+            method: descriptor.value,
+            methodName: propertyKey,
+            namespace: namespace,
+            httpMethod: method,
+            querySchema: querySchema,
+            bodySchema: bodySchema,
+            paramSchema: paramSchema,
+            headerSchema: headerSchema,
+            responseSchema: responseSchema,
+            tags: tagList,
+            description: description,
+            security: security,
+        });
+        Reflect.defineMetadata(METADATA_DATA_ENDPOINTS, dataEndpoints, target.constructor);
+    };
+};
+//# sourceMappingURL=AsDataEndpoint.js.map

package/dist/interfaces/api/AsDataEndpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsDataEndpoint.js","sourceRoot":"","sources":["../../../src/interfaces/api/AsDataEndpoint.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEpG;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,UAC5B,SAA8D,EAC9D,MAAkB,EAClB,WAAoB,EACpB,UAAmB,EACnB,WAAoB,EACpB,YAAqB,EACrB,cAAuB,EACvB,IAAwB,EACxB,QAAmB,EACnB,WAAoB;IAEpB,OAAO,CAAC,MAAW,EAAE,WAAmB,EAAE,UAA8B,EAAQ,EAAE;QAChF,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YACtE,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CACvC,uBAAuB,EACvB,MAAM,CAAC,WAAW,CACe,CAAC;QACpC,IAAI,OAAO,GAAyB,SAAS,CAAC;QAC9C,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QACD,aAAa,CAAC,IAAI,CAAC;YACjB,MAAM,EAAE,UAAU,CAAC,KAAK;YACxB,UAAU,EAAE,WAAW;YACvB,SAAS,EAAE,SAAS;YACpB,UAAU,EAAE,MAAM;YAClB,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,UAAU;YACtB,WAAW,EAAE,WAAW;YACxB,YAAY,EAAE,YAAY;YAC1B,cAAc,EAAE,cAAc;YAC9B,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,WAAW;YACxB,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;QACH,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACrF,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/interfaces/api/AsMessageEndpoint.d.ts

@@ -0,0 +1,10 @@
+import type { CallAction } from '../../ocpp/rpc/message.js';
+/**
+ * Decorator for use in module API class to expose methods as REST OCPP message endpoints.
+ *
+ * @param {CallAction} action - The call action.
+ * @param {object} bodySchema - The body schema.
+ * @param {Record<string, any>} optionalQuerystrings - The optional querystrings.
+ * @return {void} This function does not return anything.
+ */
+export declare const AsMessageEndpoint: (action: CallAction, bodySchema: object, optionalQuerystrings?: Record<string, any>) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;

package/dist/interfaces/api/AsMessageEndpoint.js

@@ -0,0 +1,29 @@
+// SPDX-FileCopyrightText: 2025 Contributors to the CitrineOS Project
+//
+// SPDX-License-Identifier: Apache-2.0
+import { METADATA_MESSAGE_ENDPOINTS } from './index.js';
+/**
+ * Decorator for use in module API class to expose methods as REST OCPP message endpoints.
+ *
+ * @param {CallAction} action - The call action.
+ * @param {object} bodySchema - The body schema.
+ * @param {Record<string, any>} optionalQuerystrings - The optional querystrings.
+ * @return {void} This function does not return anything.
+ */
+export const AsMessageEndpoint = function (action, bodySchema, optionalQuerystrings) {
+    return (target, propertyKey, descriptor) => {
+        if (!Reflect.hasMetadata(METADATA_MESSAGE_ENDPOINTS, target.constructor)) {
+            Reflect.defineMetadata(METADATA_MESSAGE_ENDPOINTS, new Array(), target.constructor);
+        }
+        const messageEndpoints = Reflect.getMetadata(METADATA_MESSAGE_ENDPOINTS, target.constructor);
+        messageEndpoints.push({
+            action: action,
+            method: descriptor.value,
+            methodName: propertyKey,
+            bodySchema: bodySchema,
+            optionalQuerystrings: optionalQuerystrings,
+        });
+        Reflect.defineMetadata(METADATA_MESSAGE_ENDPOINTS, messageEndpoints, target.constructor);
+    };
+};
+//# sourceMappingURL=AsMessageEndpoint.js.map

package/dist/interfaces/api/AsMessageEndpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsMessageEndpoint.js","sourceRoot":"","sources":["../../../src/interfaces/api/AsMessageEndpoint.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,sCAAsC;AAGtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAGxD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAC/B,MAAkB,EAClB,UAAkB,EAClB,oBAA0C;IAE1C,OAAO,CAAC,MAAW,EAAE,WAAmB,EAAE,UAA8B,EAAQ,EAAE;QAChF,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,0BAA0B,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YACzE,OAAO,CAAC,cAAc,CACpB,0BAA0B,EAC1B,IAAI,KAAK,EAA8B,EACvC,MAAM,CAAC,WAAW,CACnB,CAAC;QACJ,CAAC;QACD,MAAM,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAC1C,0BAA0B,EAC1B,MAAM,CAAC,WAAW,CACkB,CAAC;QACvC,gBAAgB,CAAC,IAAI,CAAC;YACpB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,UAAU,CAAC,KAAK;YACxB,UAAU,EAAE,WAAW;YACvB,UAAU,EAAE,UAAU;YACtB,oBAAoB,EAAE,oBAAoB;SAC3C,CAAC,CAAC;QACH,OAAO,CAAC,cAAc,CAAC,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3F,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/interfaces/api/AuthorizationSecurity.d.ts

@@ -0,0 +1,6 @@
+export declare const AuthorizationSecurity: {
+    authorization: never[];
+};
+export declare const AuthorizationSecurityList: {
+    authorization: never[];
+}[];

package/dist/interfaces/api/AuthorizationSecurity.js

@@ -0,0 +1,8 @@
+// SPDX-FileCopyrightText: 2025 Contributors to the CitrineOS Project
+//
+// SPDX-License-Identifier: Apache-2.0
+export const AuthorizationSecurity = {
+    authorization: [],
+};
+export const AuthorizationSecurityList = [AuthorizationSecurity];
+//# sourceMappingURL=AuthorizationSecurity.js.map

package/dist/interfaces/api/AuthorizationSecurity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthorizationSecurity.js","sourceRoot":"","sources":["../../../src/interfaces/api/AuthorizationSecurity.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,sCAAsC;AACtC,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,aAAa,EAAE,EAAE;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/interfaces/api/DataEndpointDefinition.d.ts

@@ -0,0 +1,20 @@
+import { HttpMethod } from './index.js';
+import { Namespace, OCPP1_6_Namespace, OCPP2_0_1_Namespace } from '../../index.js';
+/**
+ * Interface for usage in {@link AsDataEndpoint} decorator.
+ */
+export interface IDataEndpointDefinition {
+    method: (...args: any[]) => any;
+    methodName: string;
+    namespace: OCPP2_0_1_Namespace | OCPP1_6_Namespace | Namespace;
+    httpMethod: HttpMethod;
+    querySchema?: object;
+    bodySchema?: object;
+    paramSchema?: object;
+    headerSchema?: object;
+    responseSchema?: object;
+    description?: string;
+    tags?: string[];
+    summary?: string;
+    security?: object[];
+}

package/dist/interfaces/api/DataEndpointDefinition.js

@@ -0,0 +1,6 @@
+// SPDX-FileCopyrightText: 2025 Contributors to the CitrineOS Project
+//
+// SPDX-License-Identifier: Apache-2.0
+import { HttpMethod } from './index.js';
+import { Namespace, OCPP1_6_Namespace, OCPP2_0_1_Namespace } from '../../index.js';
+//# sourceMappingURL=DataEndpointDefinition.js.map

package/dist/interfaces/api/DataEndpointDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataEndpointDefinition.js","sourceRoot":"","sources":["../../../src/interfaces/api/DataEndpointDefinition.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,sCAAsC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/interfaces/api/ExceptionHandler.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyError, FastifyReply, FastifyRequest } from 'fastify';
+export interface ExceptionHandler {
+    handle(error: FastifyError, request: FastifyRequest, reply: FastifyReply): void;
+}

package/dist/interfaces/api/ExceptionHandler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ExceptionHandler.js.map

package/dist/interfaces/api/ExceptionHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExceptionHandler.js","sourceRoot":"","sources":["../../../src/interfaces/api/ExceptionHandler.ts"],"names":[],"mappings":""}

package/dist/interfaces/api/HttpHeader.d.ts

@@ -0,0 +1,17 @@
+export declare enum HttpHeader {
+    ContentType = "Content-Type",
+    ContentLength = "Content-Length",
+    Accept = "Accept",
+    Authorization = "Authorization",
+    CacheControl = "Cache-Control",
+    UserAgent = "User-Agent",
+    AcceptEncoding = "Accept-Encoding",
+    AcceptLanguage = "Accept-Language",
+    Connection = "Connection",
+    Host = "Host",
+    Referer = "Referer",
+    Origin = "Origin",
+    AccessControlAllowOrigin = "Access-Control-Allow-Origin",
+    ETag = "ETag",
+    IfNoneMatch = "If-None-Match"
+}

package/dist/interfaces/api/HttpHeader.js

@@ -0,0 +1,22 @@
+// SPDX-FileCopyrightText: 2025 Contributors to the CitrineOS Project
+//
+// SPDX-License-Identifier: Apache-2.0
+export var HttpHeader;
+(function (HttpHeader) {
+    HttpHeader["ContentType"] = "Content-Type";
+    HttpHeader["ContentLength"] = "Content-Length";
+    HttpHeader["Accept"] = "Accept";
+    HttpHeader["Authorization"] = "Authorization";
+    HttpHeader["CacheControl"] = "Cache-Control";
+    HttpHeader["UserAgent"] = "User-Agent";
+    HttpHeader["AcceptEncoding"] = "Accept-Encoding";
+    HttpHeader["AcceptLanguage"] = "Accept-Language";
+    HttpHeader["Connection"] = "Connection";
+    HttpHeader["Host"] = "Host";
+    HttpHeader["Referer"] = "Referer";
+    HttpHeader["Origin"] = "Origin";
+    HttpHeader["AccessControlAllowOrigin"] = "Access-Control-Allow-Origin";
+    HttpHeader["ETag"] = "ETag";
+    HttpHeader["IfNoneMatch"] = "If-None-Match";
+})(HttpHeader || (HttpHeader = {}));
+//# sourceMappingURL=HttpHeader.js.map

package/dist/interfaces/api/HttpHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpHeader.js","sourceRoot":"","sources":["../../../src/interfaces/api/HttpHeader.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,sCAAsC;AACtC,MAAM,CAAN,IAAY,UAgBX;AAhBD,WAAY,UAAU;IACpB,0CAA4B,CAAA;IAC5B,8CAAgC,CAAA;IAChC,+BAAiB,CAAA;IACjB,6CAA+B,CAAA;IAC/B,4CAA8B,CAAA;IAC9B,sCAAwB,CAAA;IACxB,gDAAkC,CAAA;IAClC,gDAAkC,CAAA;IAClC,uCAAyB,CAAA;IACzB,2BAAa,CAAA;IACb,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;IACjB,sEAAwD,CAAA;IACxD,2BAAa,CAAA;IACb,2CAA6B,CAAA;AAC/B,CAAC,EAhBW,UAAU,KAAV,UAAU,QAgBrB"}

package/dist/interfaces/api/HttpStatus.d.ts

@@ -0,0 +1,46 @@
+export declare enum HttpStatus {
+    CONTINUE = 100,
+    SWITCHING_PROTOCOLS = 101,
+    PROCESSING = 102,
+    OK = 200,
+    CREATED = 201,
+    ACCEPTED = 202,
+    NON_AUTHORITATIVE_INFORMATION = 203,
+    NO_CONTENT = 204,
+    RESET_CONTENT = 205,
+    PARTIAL_CONTENT = 206,
+    AMBIGUOUS = 300,
+    MOVED_PERMANENTLY = 301,
+    FOUND = 302,
+    SEE_OTHER = 303,
+    NOT_MODIFIED = 304,
+    TEMPORARY_REDIRECT = 307,
+    PERMANENT_REDIRECT = 308,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    PAYMENT_REQUIRED = 402,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    METHOD_NOT_ALLOWED = 405,
+    NOT_ACCEPTABLE = 406,
+    PROXY_AUTHENTICATION_REQUIRED = 407,
+    REQUEST_TIMEOUT = 408,
+    CONFLICT = 409,
+    GONE = 410,
+    LENGTH_REQUIRED = 411,
+    PRECONDITION_FAILED = 412,
+    PAYLOAD_TOO_LARGE = 413,
+    URI_TOO_LONG = 414,
+    UNSUPPORTED_MEDIA_TYPE = 415,
+    REQUESTED_RANGE_NOT_SATISFIABLE = 416,
+    EXPECTATION_FAILED = 417,
+    I_AM_A_TEAPOT = 418,
+    UNPROCESSABLE_ENTITY = 422,
+    TOO_MANY_REQUESTS = 429,
+    INTERNAL_SERVER_ERROR = 500,
+    NOT_IMPLEMENTED = 501,
+    BAD_GATEWAY = 502,
+    SERVICE_UNAVAILABLE = 503,
+    GATEWAY_TIMEOUT = 504,
+    HTTP_VERSION_NOT_SUPPORTED = 505
+}