X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fcharging-station%2Fui-server%2FUIServerFactory.ts;h=cf176bdc0403d2be85890204ba7b67e06f9b6c4a;hb=HEAD;hp=a5fb5a5d627c926e9d700c9ec34bbb273acd476d;hpb=4c3c0d59f56be4d58e906e938c00390b41e0ca7f;p=e-mobility-charging-stations-simulator.git diff --git a/src/charging-station/ui-server/UIServerFactory.ts b/src/charging-station/ui-server/UIServerFactory.ts index a5fb5a5d..cf176bdc 100644 --- a/src/charging-station/ui-server/UIServerFactory.ts +++ b/src/charging-station/ui-server/UIServerFactory.ts @@ -1,34 +1,92 @@ -import chalk from 'chalk'; +import chalk from 'chalk' -import type { AbstractUIServer } from './AbstractUIServer'; -import { UIHttpServer } from './UIHttpServer'; -import { UIServerUtils } from './UIServerUtils'; -import { UIWebSocketServer } from './UIWebSocketServer'; -import { ApplicationProtocol, type UIServerConfiguration } from '../../types'; -import { Configuration } from '../../utils'; +import { BaseError } from '../../exception/index.js' +import { + ApplicationProtocol, + ApplicationProtocolVersion, + AuthenticationType, + ConfigurationSection, + type UIServerConfiguration +} from '../../types/index.js' +import { logger, logPrefix } from '../../utils/index.js' +import type { AbstractUIServer } from './AbstractUIServer.js' +import { UIHttpServer } from './UIHttpServer.js' +import { isLoopback } from './UIServerUtils.js' +import { UIWebSocketServer } from './UIWebSocketServer.js' +// eslint-disable-next-line @typescript-eslint/no-extraneous-class export class UIServerFactory { - private constructor() { + private constructor () { // This is intentional } - public static getUIServerImplementation( - uiServerConfiguration?: UIServerConfiguration - ): AbstractUIServer | null { - if (UIServerUtils.isLoopback(uiServerConfiguration.options?.host) === false) { - console.warn( - chalk.yellow( - 'Loopback address not detected in UI server configuration. This is not recommended.' - ) - ); + public static getUIServerImplementation ( + uiServerConfiguration: UIServerConfiguration + ): AbstractUIServer { + if ( + uiServerConfiguration.authentication?.enabled === true && + !Object.values(AuthenticationType).includes(uiServerConfiguration.authentication.type) + ) { + throw new BaseError( + `Unknown authentication type '${uiServerConfiguration.authentication.type}' in '${ConfigurationSection.uiServer}' configuration section` + ) } - switch (uiServerConfiguration?.type ?? Configuration.getUIServer().type) { - case ApplicationProtocol.WS: - return new UIWebSocketServer(uiServerConfiguration ?? Configuration.getUIServer()); + if ( + uiServerConfiguration.type === ApplicationProtocol.HTTP && + uiServerConfiguration.authentication?.enabled === true && + uiServerConfiguration.authentication.type === AuthenticationType.PROTOCOL_BASIC_AUTH + ) { + throw new BaseError( + `'${uiServerConfiguration.authentication.type}' authentication type with application protocol type '${uiServerConfiguration.type}' is not supported in '${ConfigurationSection.uiServer}' configuration section` + ) + } + if ( + uiServerConfiguration.authentication?.enabled !== true && + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + !isLoopback(uiServerConfiguration.options!.host!) + ) { + const logMsg = `Non loopback address in '${ConfigurationSection.uiServer}' configuration section without authentication enabled. This is not recommended` + logger.warn(`${UIServerFactory.logPrefix()} ${logMsg}`) + console.warn(chalk.yellow(logMsg)) + } + if ( + uiServerConfiguration.type === ApplicationProtocol.WS && + uiServerConfiguration.version !== ApplicationProtocolVersion.VERSION_11 + ) { + const logMsg = `Only version ${ApplicationProtocolVersion.VERSION_11} with application protocol type '${uiServerConfiguration.type}' is supported in '${ConfigurationSection.uiServer}' configuration section. Falling back to version ${ApplicationProtocolVersion.VERSION_11}` + logger.warn(`${UIServerFactory.logPrefix()} ${logMsg}`) + console.warn(chalk.yellow(logMsg)) + uiServerConfiguration.version = ApplicationProtocolVersion.VERSION_11 + } + switch (uiServerConfiguration.type) { case ApplicationProtocol.HTTP: - return new UIHttpServer(uiServerConfiguration ?? Configuration.getUIServer()); + return new UIHttpServer(uiServerConfiguration) + case ApplicationProtocol.WS: default: - return null; + if ( + !Object.values(ApplicationProtocol).includes( + uiServerConfiguration.type as ApplicationProtocol + ) + ) { + const logMsg = `Unknown application protocol type '${uiServerConfiguration.type}' in '${ + ConfigurationSection.uiServer + // eslint-disable-next-line @typescript-eslint/no-base-to-string + }' configuration section from values '${ApplicationProtocol.toString()}', defaulting to '${ + ApplicationProtocol.WS + }'` + logger.warn(`${UIServerFactory.logPrefix()} ${logMsg}`) + console.warn(logMsg) + } + return new UIWebSocketServer(uiServerConfiguration) } } + + private static readonly logPrefix = (modName?: string, methodName?: string): string => { + const logMsgPrefix = 'UI Server' + const logMsg = + modName != null && methodName != null + ? ` ${logMsgPrefix} | ${modName}.${methodName}:` + : ` ${logMsgPrefix} |` + return logPrefix(logMsg) + } }