refactor: cleanup string literal variables handling
[e-mobility-charging-stations-simulator.git] / src / charging-station / ui-server / AbstractUIServer.ts
index 36d00e01b5e9b7190c1e91c07aab0fefa589844f..a786fbbddc2ed43623316f297a7f5ac94503d474 100644 (file)
-import { type IncomingMessage, Server, type ServerResponse } from 'node:http';
+import { type IncomingMessage, Server, type ServerResponse } from 'node:http'
+import { createServer, type Http2Server } from 'node:http2'
 
-import type { WebSocket } from 'ws';
+import type { WebSocket } from 'ws'
 
-import type { AbstractUIService } from './ui-services/AbstractUIService';
-import { UIServiceFactory } from './ui-services/UIServiceFactory';
-import { BaseError } from '../../exception';
+import { BaseError } from '../../exception/index.js'
 import {
+  ApplicationProtocolVersion,
   AuthenticationType,
   type ChargingStationData,
+  ConfigurationSection,
   type ProcedureName,
   type ProtocolRequest,
   type ProtocolResponse,
   ProtocolVersion,
   type RequestPayload,
   type ResponsePayload,
-  type UIServerConfiguration,
-} from '../../types';
+  type UIServerConfiguration
+} from '../../types/index.js'
+import { logger } from '../../utils/index.js'
+import type { AbstractUIService } from './ui-services/AbstractUIService.js'
+import { UIServiceFactory } from './ui-services/UIServiceFactory.js'
+import { getUsernameAndPasswordFromAuthorizationToken } from './UIServerUtils.js'
+
+const moduleName = 'AbstractUIServer'
 
 export abstract class AbstractUIServer {
-  public readonly chargingStations: Map<string, ChargingStationData>;
-  protected readonly httpServer: Server;
-  protected readonly responseHandlers: Map<string, ServerResponse | WebSocket>;
-  protected readonly uiServices: Map<ProtocolVersion, AbstractUIService>;
+  public readonly chargingStations: Map<string, ChargingStationData>
+  public readonly chargingStationTemplates: Set<string>
+  protected readonly httpServer: Server | Http2Server
+  protected readonly responseHandlers: Map<
+    `${string}-${string}-${string}-${string}-${string}`,
+  ServerResponse | WebSocket
+  >
+
+  protected readonly uiServices: Map<ProtocolVersion, AbstractUIService>
 
-  public constructor(protected readonly uiServerConfiguration: UIServerConfiguration) {
-    this.chargingStations = new Map<string, ChargingStationData>();
-    this.httpServer = new Server();
-    this.responseHandlers = new Map<string, ServerResponse | WebSocket>();
-    this.uiServices = new Map<ProtocolVersion, AbstractUIService>();
+  public constructor (protected readonly uiServerConfiguration: UIServerConfiguration) {
+    this.chargingStations = new Map<string, ChargingStationData>()
+    this.chargingStationTemplates = new Set<string>()
+    switch (this.uiServerConfiguration.version) {
+      case ApplicationProtocolVersion.VERSION_11:
+        this.httpServer = new Server()
+        break
+      case ApplicationProtocolVersion.VERSION_20:
+        this.httpServer = createServer()
+        break
+      default:
+        throw new BaseError(
+          `Unsupported application protocol version ${this.uiServerConfiguration.version} in '${ConfigurationSection.uiServer}' configuration section`
+        )
+    }
+    this.responseHandlers = new Map<
+      `${string}-${string}-${string}-${string}-${string}`,
+    ServerResponse | WebSocket
+    >()
+    this.uiServices = new Map<ProtocolVersion, AbstractUIService>()
   }
 
-  public buildProtocolRequest(
-    id: string,
+  public buildProtocolRequest (
+    uuid: `${string}-${string}-${string}-${string}-${string}`,
     procedureName: ProcedureName,
     requestPayload: RequestPayload
   ): ProtocolRequest {
-    return [id, procedureName, requestPayload];
+    return [uuid, procedureName, requestPayload]
+  }
+
+  public buildProtocolResponse (
+    uuid: `${string}-${string}-${string}-${string}-${string}`,
+    responsePayload: ResponsePayload
+  ): ProtocolResponse {
+    return [uuid, responsePayload]
   }
 
-  public buildProtocolResponse(id: string, responsePayload: ResponsePayload): ProtocolResponse {
-    return [id, responsePayload];
+  public stop (): void {
+    this.stopHttpServer()
+    for (const uiService of this.uiServices.values()) {
+      uiService.stop()
+    }
+    this.clearCaches()
   }
 
-  public stop(): void {
-    this.chargingStations.clear();
+  public clearCaches (): void {
+    this.chargingStations.clear()
+    this.chargingStationTemplates.clear()
   }
 
-  public async sendInternalRequest(request: ProtocolRequest): Promise<ProtocolResponse> {
-    const protocolVersion = ProtocolVersion['0.0.1'];
-    this.registerProtocolVersionUIService(protocolVersion);
-    return this.uiServices.get(protocolVersion)?.requestHandler(request);
+  public async sendInternalRequest (request: ProtocolRequest): Promise<ProtocolResponse> {
+    const protocolVersion = ProtocolVersion['0.0.1']
+    this.registerProtocolVersionUIService(protocolVersion)
+    return await (this.uiServices
+      .get(protocolVersion)
+      ?.requestHandler(request) as Promise<ProtocolResponse>)
   }
 
-  public hasResponseHandler(uuid: string): boolean {
-    return this.responseHandlers.has(uuid);
+  public hasResponseHandler (uuid: `${string}-${string}-${string}-${string}-${string}`): boolean {
+    return this.responseHandlers.has(uuid)
   }
 
-  protected startHttpServer(): void {
-    if (this.httpServer.listening === false) {
-      this.httpServer.listen(this.uiServerConfiguration.options);
+  protected startHttpServer (): void {
+    this.httpServer.on('error', error => {
+      logger.error(
+        `${this.logPrefix(moduleName, 'start.httpServer.on.error')} HTTP server error:`,
+        error
+      )
+    })
+    if (!this.httpServer.listening) {
+      this.httpServer.listen(this.uiServerConfiguration.options)
     }
   }
 
-  protected registerProtocolVersionUIService(version: ProtocolVersion): void {
-    if (this.uiServices.has(version) === false) {
-      this.uiServices.set(version, UIServiceFactory.getUIServiceImplementation(version, this));
+  protected registerProtocolVersionUIService (version: ProtocolVersion): void {
+    if (!this.uiServices.has(version)) {
+      this.uiServices.set(version, UIServiceFactory.getUIServiceImplementation(version, this))
     }
   }
 
-  protected authenticate(req: IncomingMessage, next: (err?: Error) => void): void {
-    if (this.isBasicAuthEnabled() === true) {
-      if (this.isValidBasicAuth(req) === false) {
-        next(new BaseError('Unauthorized'));
+  protected authenticate (req: IncomingMessage, next: (err?: Error) => void): void {
+    const authorizationError = new BaseError('Unauthorized')
+    if (this.isBasicAuthEnabled()) {
+      if (!this.isValidBasicAuth(req, next)) {
+        next(authorizationError)
+      }
+      next()
+    } else if (this.isProtocolBasicAuthEnabled()) {
+      if (!this.isValidProtocolBasicAuth(req, next)) {
+        next(authorizationError)
       }
-      next();
+      next()
+    } else if (this.uiServerConfiguration.authentication?.enabled === true) {
+      next(authorizationError)
+    }
+    next()
+  }
+
+  private stopHttpServer (): void {
+    if (this.httpServer.listening) {
+      this.httpServer.close()
+      this.httpServer.removeAllListeners()
     }
-    next();
   }
 
-  private isBasicAuthEnabled(): boolean {
+  private isBasicAuthEnabled (): boolean {
     return (
       this.uiServerConfiguration.authentication?.enabled === true &&
-      this.uiServerConfiguration.authentication?.type === AuthenticationType.BASIC_AUTH
-    );
+      this.uiServerConfiguration.authentication.type === AuthenticationType.BASIC_AUTH
+    )
   }
 
-  private isValidBasicAuth(req: IncomingMessage): boolean {
-    const authorizationHeader = req.headers.authorization ?? '';
-    const authorizationToken = authorizationHeader.split(/\s+/).pop() ?? '';
-    const authentication = Buffer.from(authorizationToken, 'base64').toString();
-    const authenticationParts = authentication.split(/:/);
-    const username = authenticationParts.shift();
-    const password = authenticationParts.join(':');
+  private isProtocolBasicAuthEnabled (): boolean {
+    return (
+      this.uiServerConfiguration.authentication?.enabled === true &&
+      this.uiServerConfiguration.authentication.type === AuthenticationType.PROTOCOL_BASIC_AUTH
+    )
+  }
+
+  private isValidBasicAuth (req: IncomingMessage, next: (err?: Error) => void): boolean {
+    const [username, password] = getUsernameAndPasswordFromAuthorizationToken(
+      req.headers.authorization?.split(/\s+/).pop() ?? '',
+      next
+    )
+    return this.isValidUsernameAndPassword(username, password)
+  }
+
+  private isValidProtocolBasicAuth (req: IncomingMessage, next: (err?: Error) => void): boolean {
+    const authorizationProtocol = req.headers['sec-websocket-protocol']?.split(/,\s+/).pop()
+    const [username, password] = getUsernameAndPasswordFromAuthorizationToken(
+      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+      `${authorizationProtocol}${Array(((4 - (authorizationProtocol!.length % 4)) % 4) + 1).join(
+        '='
+      )}`
+        .split('.')
+        .pop() ?? '',
+      next
+    )
+    return this.isValidUsernameAndPassword(username, password)
+  }
+
+  private isValidUsernameAndPassword (username: string, password: string): boolean {
     return (
       this.uiServerConfiguration.authentication?.username === username &&
-      this.uiServerConfiguration.authentication?.password === password
-    );
-  }
-
-  public abstract start(): void;
-  public abstract sendRequest(request: ProtocolRequest): void;
-  public abstract sendResponse(response: ProtocolResponse): void;
-  public abstract logPrefix(
-    moduleName?: string,
-    methodName?: string,
-    prefixSuffix?: string
-  ): string;
+      this.uiServerConfiguration.authentication.password === password
+    )
+  }
+
+  public abstract start (): void
+  public abstract sendRequest (request: ProtocolRequest): void
+  public abstract sendResponse (response: ProtocolResponse): void
+  public abstract logPrefix (moduleName?: string, methodName?: string, prefixSuffix?: string): string
 }