refactor(ci): cleanup GH actions
[e-mobility-charging-stations-simulator.git] / src / charging-station / ui-server / UIHttpServer.ts
index 2747738a65d1aadff3b59d654d51570bb0b8a1c1..5bcae7beff6ed84fc6d0e202437361bc7f1c3725 100644 (file)
-import { IncomingMessage, RequestListener, Server, ServerResponse } from 'http';
+import type { IncomingMessage, ServerResponse } from 'node:http'
 
-import { StatusCodes } from 'http-status-codes';
+import { StatusCodes } from 'http-status-codes'
 
-import BaseError from '../../exception/BaseError';
-import type { ServerOptions } from '../../types/ConfigurationData';
+import { BaseError } from '../../exception/index.js'
 import {
-  ProcedureName,
-  Protocol,
-  ProtocolRequest,
-  ProtocolResponse,
-  ProtocolVersion,
-  RequestPayload,
+  ApplicationProtocolVersion,
+  MapStringifyFormat,
+  type ProcedureName,
+  type Protocol,
+  type ProtocolRequest,
+  type ProtocolResponse,
+  type ProtocolVersion,
+  type RequestPayload,
   ResponseStatus,
-} from '../../types/UIProtocol';
-import Configuration from '../../utils/Configuration';
-import logger from '../../utils/Logger';
-import Utils from '../../utils/Utils';
-import { AbstractUIServer } from './AbstractUIServer';
-import UIServiceFactory from './ui-services/UIServiceFactory';
-import { UIServiceUtils } from './ui-services/UIServiceUtils';
-
-const moduleName = 'UIHttpServer';
+  type UIServerConfiguration
+} from '../../types/index.js'
+import {
+  Constants,
+  generateUUID,
+  isNotEmptyString,
+  JSONStringify,
+  logger,
+  logPrefix
+} from '../../utils/index.js'
+import { AbstractUIServer } from './AbstractUIServer.js'
+import { isProtocolAndVersionSupported } from './UIServerUtils.js'
 
-type responseHandler = { procedureName: ProcedureName; res: ServerResponse };
+const moduleName = 'UIHttpServer'
 
-export default class UIHttpServer extends AbstractUIServer {
-  private readonly responseHandlers: Map<string, responseHandler>;
+enum HttpMethods {
+  GET = 'GET',
+  PUT = 'PUT',
+  POST = 'POST',
+  PATCH = 'PATCH'
+}
 
-  public constructor(private options?: ServerOptions) {
-    super();
-    this.server = new Server(this.requestListener.bind(this) as RequestListener);
-    this.responseHandlers = new Map<string, responseHandler>();
+export class UIHttpServer extends AbstractUIServer {
+  public constructor (protected readonly uiServerConfiguration: UIServerConfiguration) {
+    super(uiServerConfiguration)
   }
 
-  public start(): void {
-    if ((this.server as Server).listening === false) {
-      (this.server as Server).listen(this.options ?? Configuration.getUIServer().options);
-    }
+  public start (): void {
+    this.httpServer.on('request', this.requestListener.bind(this))
+    this.startHttpServer()
   }
 
-  public stop(): void {
-    this.chargingStations.clear();
-    this.responseHandlers.clear();
-  }
-
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  public sendRequest(request: ProtocolRequest): void {
-    // This is intentionally left blank
+  public sendRequest (request: ProtocolRequest): void {
+    switch (this.uiServerConfiguration.version) {
+      case ApplicationProtocolVersion.VERSION_20:
+        this.httpServer.emit('request', request)
+        break
+    }
   }
 
-  public sendResponse(response: ProtocolResponse): void {
-    const [uuid, payload] = response;
-    const statusCode = this.responseStatusToStatusCode(payload.status);
-    if (this.responseHandlers.has(uuid) === true) {
-      const { res } = this.responseHandlers.get(uuid);
-      res.writeHead(statusCode, { 'Content-Type': 'application/json' });
-      res.write(JSON.stringify(payload));
-      res.end();
-      this.responseHandlers.delete(uuid);
-    } else {
+  public sendResponse (response: ProtocolResponse): void {
+    const [uuid, payload] = response
+    try {
+      if (this.hasResponseHandler(uuid)) {
+        const res = this.responseHandlers.get(uuid) as ServerResponse
+        res
+          .writeHead(this.responseStatusToStatusCode(payload.status), {
+            'Content-Type': 'application/json'
+          })
+          .end(JSONStringify(payload, undefined, MapStringifyFormat.object))
+      } else {
+        logger.error(
+          `${this.logPrefix(moduleName, 'sendResponse')} Response for unknown request id: ${uuid}`
+        )
+      }
+    } catch (error) {
       logger.error(
-        `${this.logPrefix(moduleName, 'sendResponse')} Response for unknown request id: ${uuid}`
-      );
+        `${this.logPrefix(moduleName, 'sendResponse')} Error at sending response id '${uuid}':`,
+        error
+      )
+    } finally {
+      this.responseHandlers.delete(uuid)
     }
   }
 
-  public logPrefix(modName?: string, methodName?: string, prefixSuffix?: string): string {
-    const logMsgPrefix = prefixSuffix ? `UI HTTP Server ${prefixSuffix}` : 'UI HTTP Server';
+  public logPrefix = (modName?: string, methodName?: string, prefixSuffix?: string): string => {
+    const logMsgPrefix = prefixSuffix != null ? `UI HTTP Server ${prefixSuffix}` : 'UI HTTP Server'
     const logMsg =
-      modName && methodName ? ` ${logMsgPrefix} | ${modName}.${methodName}:` : ` ${logMsgPrefix} |`;
-    return Utils.logPrefix(logMsg);
+      isNotEmptyString(modName) && isNotEmptyString(methodName)
+        ? ` ${logMsgPrefix} | ${modName}.${methodName}:`
+        : ` ${logMsgPrefix} |`
+    return logPrefix(logMsg)
   }
 
-  private requestListener(req: IncomingMessage, res: ServerResponse): void {
+  private requestListener (req: IncomingMessage, res: ServerResponse): void {
+    this.authenticate(req, err => {
+      if (err != null) {
+        res
+          .writeHead(StatusCodes.UNAUTHORIZED, {
+            'Content-Type': 'text/plain',
+            'WWW-Authenticate': 'Basic realm=users'
+          })
+          .end(`${StatusCodes.UNAUTHORIZED} Unauthorized`)
+        res.destroy()
+        req.destroy()
+      }
+    })
     // Expected request URL pathname: /ui/:version/:procedureName
     const [protocol, version, procedureName] = req.url?.split('/').slice(1) as [
       Protocol,
       ProtocolVersion,
       ProcedureName
-    ];
-    const uuid = Utils.generateUUID();
-    this.responseHandlers.set(uuid, { procedureName, res });
+    ]
+    const uuid = generateUUID()
+    this.responseHandlers.set(uuid, res)
     try {
-      if (UIServiceUtils.isProtocolAndVersionSupported(protocol, version) === false) {
-        throw new BaseError(`Unsupported UI protocol version: '/${protocol}/${version}'`);
+      const fullProtocol = `${protocol}${version}`
+      if (!isProtocolAndVersionSupported(fullProtocol)) {
+        throw new BaseError(`Unsupported UI protocol version: '${fullProtocol}'`)
       }
-      req.on('error', (error) => {
+      this.registerProtocolVersionUIService(version)
+      req.on('error', error => {
         logger.error(
           `${this.logPrefix(moduleName, 'requestListener.req.onerror')} Error on HTTP request:`,
           error
-        );
-      });
-      if (this.uiServices.has(version) === false) {
-        this.uiServices.set(version, UIServiceFactory.getUIServiceImplementation(version, this));
-      }
-      if (req.method === 'POST') {
-        const bodyBuffer = [];
+        )
+      })
+      if (req.method === HttpMethods.POST) {
+        const bodyBuffer: Uint8Array[] = []
         req
-          .on('data', (chunk) => {
-            bodyBuffer.push(chunk);
+          .on('data', (chunk: Uint8Array) => {
+            bodyBuffer.push(chunk)
           })
           .on('end', () => {
-            const body = JSON.parse(Buffer.concat(bodyBuffer).toString()) as RequestPayload;
+            let requestPayload: RequestPayload | undefined
+            try {
+              requestPayload = JSON.parse(Buffer.concat(bodyBuffer).toString()) as RequestPayload
+            } catch (error) {
+              this.sendResponse(
+                this.buildProtocolResponse(uuid, {
+                  status: ResponseStatus.FAILURE,
+                  errorMessage: (error as Error).message,
+                  errorStack: (error as Error).stack
+                })
+              )
+              return
+            }
             this.uiServices
               .get(version)
-              .requestHandler(this.buildProtocolRequest(uuid, procedureName, body ?? {}))
-              .catch(() => {
-                this.sendResponse(
-                  this.buildProtocolResponse(uuid, { status: ResponseStatus.FAILURE })
-                );
-              });
-          });
+              ?.requestHandler(this.buildProtocolRequest(uuid, procedureName, requestPayload))
+              .then((protocolResponse?: ProtocolResponse) => {
+                if (protocolResponse != null) {
+                  this.sendResponse(protocolResponse)
+                }
+              })
+              .catch(Constants.EMPTY_FUNCTION)
+          })
       } else {
-        throw new BaseError(`Unsupported HTTP method: '${req.method}'`);
+        throw new BaseError(`Unsupported HTTP method: '${req.method}'`)
       }
     } catch (error) {
       logger.error(
         `${this.logPrefix(moduleName, 'requestListener')} Handle HTTP request error:`,
         error
-      );
-      this.sendResponse(this.buildProtocolResponse(uuid, { status: ResponseStatus.FAILURE }));
+      )
+      this.sendResponse(this.buildProtocolResponse(uuid, { status: ResponseStatus.FAILURE }))
     }
   }
 
-  private responseStatusToStatusCode(status: ResponseStatus): StatusCodes {
+  private responseStatusToStatusCode (status: ResponseStatus): StatusCodes {
     switch (status) {
       case ResponseStatus.SUCCESS:
-        return StatusCodes.OK;
+        return StatusCodes.OK
       case ResponseStatus.FAILURE:
-        return StatusCodes.BAD_REQUEST;
+        return StatusCodes.BAD_REQUEST
       default:
-        return StatusCodes.INTERNAL_SERVER_ERROR;
+        return StatusCodes.INTERNAL_SERVER_ERROR
     }
   }
 }