X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fcharging-station%2Fui-server%2FUIWebSocketServer.ts;h=bf0a6c444749201fe06d2cdcc6f24b10fa09582a;hb=HEAD;hp=befb9854fa8a1a0d91e9daeff2a935eaa5634a0d;hpb=a37fc6dc8267e22b2b2d35773525980b81f014e8;p=e-mobility-charging-stations-simulator.git diff --git a/src/charging-station/ui-server/UIWebSocketServer.ts b/src/charging-station/ui-server/UIWebSocketServer.ts index befb9854..bf0a6c44 100644 --- a/src/charging-station/ui-server/UIWebSocketServer.ts +++ b/src/charging-station/ui-server/UIWebSocketServer.ts @@ -1,219 +1,247 @@ -import type { IncomingMessage } from 'node:http'; -import type { Duplex } from 'node:stream'; +import type { IncomingMessage } from 'node:http' +import type { Duplex } from 'node:stream' -import { StatusCodes } from 'http-status-codes'; -import { type RawData, WebSocket, WebSocketServer } from 'ws'; +import { StatusCodes } from 'http-status-codes' +import { type RawData, WebSocket, WebSocketServer } from 'ws' -import { AbstractUIServer } from './AbstractUIServer'; -import { UIServerUtils } from './UIServerUtils'; import { + MapStringifyFormat, type ProtocolRequest, type ProtocolResponse, type UIServerConfiguration, - WebSocketCloseEventStatusCode, -} from '../../types'; + WebSocketCloseEventStatusCode +} from '../../types/index.js' import { Constants, getWebSocketCloseEventStatusString, isNotEmptyString, - isNullOrUndefined, - logPrefix, + JSONStringify, logger, - validateUUID, -} from '../../utils'; + logPrefix, + validateUUID +} from '../../utils/index.js' +import { AbstractUIServer } from './AbstractUIServer.js' +import { + getProtocolAndVersion, + handleProtocols, + isProtocolAndVersionSupported +} from './UIServerUtils.js' -const moduleName = 'UIWebSocketServer'; +const moduleName = 'UIWebSocketServer' export class UIWebSocketServer extends AbstractUIServer { - private readonly webSocketServer: WebSocketServer; + private readonly webSocketServer: WebSocketServer - public constructor(protected readonly uiServerConfiguration: UIServerConfiguration) { - super(uiServerConfiguration); + public constructor (protected readonly uiServerConfiguration: UIServerConfiguration) { + super(uiServerConfiguration) this.webSocketServer = new WebSocketServer({ - handleProtocols: UIServerUtils.handleProtocols, - noServer: true, - }); + handleProtocols, + noServer: true + }) } - public start(): void { - // eslint-disable-next-line @typescript-eslint/no-unused-vars - this.webSocketServer.on('connection', (ws: WebSocket, req: IncomingMessage): void => { - if (UIServerUtils.isProtocolAndVersionSupported(ws.protocol) === false) { + public start (): void { + this.webSocketServer.on('connection', (ws: WebSocket, _req: IncomingMessage): void => { + if (!isProtocolAndVersionSupported(ws.protocol)) { logger.error( `${this.logPrefix( moduleName, - 'start.server.onconnection', - )} Unsupported UI protocol version: '${ws.protocol}'`, - ); - ws.close(WebSocketCloseEventStatusCode.CLOSE_PROTOCOL_ERROR); + 'start.server.onconnection' + )} Unsupported UI protocol version: '${ws.protocol}'` + ) + ws.close(WebSocketCloseEventStatusCode.CLOSE_PROTOCOL_ERROR) } - const [, version] = UIServerUtils.getProtocolAndVersion(ws.protocol); - this.registerProtocolVersionUIService(version); - ws.on('message', (rawData) => { - const request = this.validateRawDataRequest(rawData); + const [, version] = getProtocolAndVersion(ws.protocol) + this.registerProtocolVersionUIService(version) + ws.on('message', rawData => { + const request = this.validateRawDataRequest(rawData) if (request === false) { - ws.close(WebSocketCloseEventStatusCode.CLOSE_INVALID_PAYLOAD); - return; + ws.close(WebSocketCloseEventStatusCode.CLOSE_INVALID_PAYLOAD) + return } - const [requestId] = request as ProtocolRequest; - this.responseHandlers.set(requestId, ws); + const [requestId] = request + this.responseHandlers.set(requestId, ws) this.uiServices .get(version) ?.requestHandler(request) - .then((protocolResponse: ProtocolResponse | undefined) => { - if (!isNullOrUndefined(protocolResponse)) { - this.sendResponse(protocolResponse!); + .then((protocolResponse?: ProtocolResponse) => { + if (protocolResponse != null) { + this.sendResponse(protocolResponse) } }) - .catch(Constants.EMPTY_FUNCTION); - }); - ws.on('error', (error) => { - logger.error(`${this.logPrefix(moduleName, 'start.ws.onerror')} WebSocket error:`, error); - }); + .catch(Constants.EMPTY_FUNCTION) + }) + ws.on('error', error => { + logger.error(`${this.logPrefix(moduleName, 'start.ws.onerror')} WebSocket error:`, error) + }) ws.on('close', (code, reason) => { logger.debug( `${this.logPrefix( moduleName, - 'start.ws.onclose', + 'start.ws.onclose' )} WebSocket closed: '${getWebSocketCloseEventStatusString( - code, - )}' - '${reason.toString()}'`, - ); - }); - }); - // eslint-disable-next-line @typescript-eslint/no-unused-vars - this.httpServer.on('connect', (req: IncomingMessage, socket: Duplex, head: Buffer) => { - if (req.headers?.connection !== 'Upgrade' || req.headers?.upgrade !== 'websocket') { - socket.write(`HTTP/1.1 ${StatusCodes.BAD_REQUEST} Bad Request\r\n\r\n`); - socket.destroy(); + code + )}' - '${reason.toString()}'` + ) + }) + }) + this.httpServer.on('connect', (req: IncomingMessage, socket: Duplex, _head: Buffer) => { + if (req.headers.connection !== 'Upgrade' || req.headers.upgrade !== 'websocket') { + socket.write(`HTTP/1.1 ${StatusCodes.BAD_REQUEST} Bad Request\r\n\r\n`) + socket.destroy() } - }); + }) this.httpServer.on('upgrade', (req: IncomingMessage, socket: Duplex, head: Buffer): void => { - this.authenticate(req, (err) => { - if (err) { - socket.write(`HTTP/1.1 ${StatusCodes.UNAUTHORIZED} Unauthorized\r\n\r\n`); - socket.destroy(); - return; + const onSocketError = (error: Error): void => { + logger.error( + `${this.logPrefix( + moduleName, + 'start.httpServer.on.upgrade' + )} Socket error at connection upgrade event handling:`, + error + ) + } + socket.on('error', onSocketError) + this.authenticate(req, err => { + if (err != null) { + socket.write(`HTTP/1.1 ${StatusCodes.UNAUTHORIZED} Unauthorized\r\n\r\n`) + socket.destroy() + return } try { this.webSocketServer.handleUpgrade(req, socket, head, (ws: WebSocket) => { - this.webSocketServer.emit('connection', ws, req); - }); + this.webSocketServer.emit('connection', ws, req) + }) } catch (error) { logger.error( `${this.logPrefix( moduleName, - 'start.httpServer.on.upgrade', - )} Error at handling connection upgrade:`, - error, - ); + 'start.httpServer.on.upgrade' + )} Error at connection upgrade event handling:`, + error + ) } - }); - }); - this.startHttpServer(); + }) + socket.removeListener('error', onSocketError) + }) + this.startHttpServer() } - public sendRequest(request: ProtocolRequest): void { - this.broadcastToClients(JSON.stringify(request)); + public sendRequest (request: ProtocolRequest): void { + this.broadcastToClients(JSON.stringify(request)) } - public sendResponse(response: ProtocolResponse): void { - const responseId = response[0]; + public sendResponse (response: ProtocolResponse): void { + const responseId = response[0] try { if (this.hasResponseHandler(responseId)) { - const ws = this.responseHandlers.get(responseId) as WebSocket; - if (ws?.readyState === WebSocket.OPEN) { - ws.send(JSON.stringify(response)); + const ws = this.responseHandlers.get(responseId) as WebSocket + if (ws.readyState === WebSocket.OPEN) { + ws.send(JSONStringify(response, undefined, MapStringifyFormat.object)) } else { logger.error( `${this.logPrefix( moduleName, - 'sendResponse', - )} Error at sending response id '${responseId}', WebSocket is not open: ${ws?.readyState}`, - ); + 'sendResponse' + )} Error at sending response id '${responseId}', WebSocket is not open: ${ + ws.readyState + }` + ) } } else { logger.error( `${this.logPrefix( moduleName, - 'sendResponse', - )} Response for unknown request id: ${responseId}`, - ); + 'sendResponse' + )} Response for unknown request id: ${responseId}` + ) } } catch (error) { logger.error( `${this.logPrefix( moduleName, - 'sendResponse', + 'sendResponse' )} Error at sending response id '${responseId}':`, - error, - ); + error + ) } finally { - this.responseHandlers.delete(responseId); + this.responseHandlers.delete(responseId) } } public logPrefix = (modName?: string, methodName?: string, prefixSuffix?: string): string => { - const logMsgPrefix = prefixSuffix - ? `UI WebSocket Server ${prefixSuffix}` - : 'UI WebSocket Server'; + const logMsgPrefix = + prefixSuffix != null ? `UI WebSocket Server ${prefixSuffix}` : 'UI WebSocket Server' const logMsg = isNotEmptyString(modName) && isNotEmptyString(methodName) ? ` ${logMsgPrefix} | ${modName}.${methodName}:` - : ` ${logMsgPrefix} |`; - return logPrefix(logMsg); - }; + : ` ${logMsgPrefix} |` + return logPrefix(logMsg) + } - private broadcastToClients(message: string): void { + private broadcastToClients (message: string): void { for (const client of this.webSocketServer.clients) { - if (client?.readyState === WebSocket.OPEN) { - client.send(message); + if (client.readyState === WebSocket.OPEN) { + client.send(message) } } } - private validateRawDataRequest(rawData: RawData): ProtocolRequest | false { + private validateRawDataRequest (rawData: RawData): ProtocolRequest | false { // logger.debug( // `${this.logPrefix( // moduleName, - // 'validateRawDataRequest', + // 'validateRawDataRequest' // // eslint-disable-next-line @typescript-eslint/no-base-to-string - // )} Raw data received in string format: ${rawData.toString()}`, - // ); + // )} Raw data received in string format: ${rawData.toString()}` + // ) - // eslint-disable-next-line @typescript-eslint/no-base-to-string - const request = JSON.parse(rawData.toString()) as ProtocolRequest; + let request: ProtocolRequest + try { + // eslint-disable-next-line @typescript-eslint/no-base-to-string + request = JSON.parse(rawData.toString()) as ProtocolRequest + } catch (error) { + logger.error( + `${this.logPrefix( + moduleName, + 'validateRawDataRequest' + // eslint-disable-next-line @typescript-eslint/no-base-to-string + )} UI protocol request is not valid JSON: ${rawData.toString()}` + ) + return false + } - if (Array.isArray(request) === false) { + if (!Array.isArray(request)) { logger.error( `${this.logPrefix( moduleName, - 'validateRawDataRequest', + 'validateRawDataRequest' )} UI protocol request is not an array:`, - request, - ); - return false; + request + ) + return false } + // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition if (request.length !== 3) { logger.error( `${this.logPrefix(moduleName, 'validateRawDataRequest')} UI protocol request is malformed:`, - request, - ); - return false; + request + ) + return false } - if (validateUUID(request[0]) === false) { + if (!validateUUID(request[0])) { logger.error( `${this.logPrefix( moduleName, - 'validateRawDataRequest', + 'validateRawDataRequest' )} UI protocol request UUID field is invalid:`, - request, - ); - return false; + request + ) + return false } - return request; + return request } }