X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Futils%2FUtils.ts;h=f27f06660227643ebe516f8972ee08206334af22;hb=69bafbedae4dd101f6bf1a40091cecdb831a64b9;hp=4fb2ce7bd2e5482a431b608f777e6b05475035f9;hpb=e7aeea18e189dd087c8f951cf77a253e2818ae90;p=e-mobility-charging-stations-simulator.git diff --git a/src/utils/Utils.ts b/src/utils/Utils.ts index 4fb2ce7b..f27f0666 100644 --- a/src/utils/Utils.ts +++ b/src/utils/Utils.ts @@ -1,16 +1,24 @@ -import Configuration from './Configuration'; -import { WebSocketCloseEventStatusString } from '../types/WebSocket'; -import { WorkerProcessType } from '../types/Worker'; import crypto from 'crypto'; -import { v4 as uuid } from 'uuid'; + +import { WebSocketCloseEventStatusString } from '../types/WebSocket'; export default class Utils { + private constructor() { + // This is intentional + } + public static logPrefix(prefixString = ''): string { return new Date().toLocaleString() + prefixString; } public static generateUUID(): string { - return uuid(); + return crypto.randomUUID(); + } + + public static validateUUID(uuid: string): boolean { + return /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.test( + uuid + ); } public static async sleep(milliSeconds: number): Promise { @@ -42,42 +50,42 @@ export default class Utils { return Utils.formatDurationMilliSeconds(duration * 1000); } - public static convertToDate(value: unknown): Date { - // Check - if (!value) { - return value as Date; + public static convertToDate(value: unknown): Date | null | undefined { + if (Utils.isNullOrUndefined(value)) { + return value as null | undefined; } - // Check Type - if (!(value instanceof Date)) { - return new Date(value as string); + if (value instanceof Date) { + return value; } - return value; + if (Utils.isString(value) || typeof value === 'number') { + return new Date(value as string | number); + } + return null; } public static convertToInt(value: unknown): number { - let changedValue: number = value as number; if (!value) { return 0; } + let changedValue: number = value as number; if (Number.isSafeInteger(value)) { return value as number; } - // Check + if (typeof value === 'number') { + changedValue = Math.trunc(value); + } if (Utils.isString(value)) { - // Create Object changedValue = parseInt(value as string); } return changedValue; } public static convertToFloat(value: unknown): number { - let changedValue: number = value as number; if (!value) { return 0; } - // Check + let changedValue: number = value as number; if (Utils.isString(value)) { - // Create Object changedValue = parseFloat(value as string); } return changedValue; @@ -85,22 +93,24 @@ export default class Utils { public static convertToBoolean(value: unknown): boolean { let result = false; - // Check boolean if (value) { // Check the type if (typeof value === 'boolean') { - // Already a boolean result = value; - } else { - // Convert - result = value === 'true'; + } else if ( + Utils.isString(value) && + ((value as string).toLowerCase() === 'true' || value === '1') + ) { + result = true; + } else if (typeof value === 'number' && value === 1) { + result = true; } } return result; } - public static getRandomFloat(max: number, min = 0, negative = false): number { - if (max < min || min < 0 || max < 0) { + public static getRandomFloat(max = Number.MAX_VALUE, min = 0, negative = false): number { + if (max < min || max < 0 || min < 0) { throw new RangeError('Invalid interval'); } const randomPositiveFloat = crypto.randomBytes(4).readUInt32LE() / 0xffffffff; @@ -108,15 +118,12 @@ export default class Utils { return sign * (randomPositiveFloat * (max - min) + min); } - public static getRandomInteger(max: number, min = 0): number { - if (max < 0) { + public static getRandomInteger(max = Number.MAX_SAFE_INTEGER, min = 0): number { + if (max < min || max < 0 || min < 0) { throw new RangeError('Invalid interval'); } max = Math.floor(max); - if (min) { - if (max < min || min < 0) { - throw new RangeError('Invalid interval'); - } + if (!Utils.isNullOrUndefined(min) && min !== 0) { min = Math.ceil(min); return Math.floor(Utils.secureRandom() * (max - min + 1)) + min; } @@ -133,7 +140,7 @@ export default class Utils { return Math.trunc(numberValue * truncPower) / truncPower; } - public static getRandomFloatRounded(max: number, min = 0, scale = 2): number { + public static getRandomFloatRounded(max = Number.MAX_VALUE, min = 0, scale = 2): number { if (min) { return Utils.roundTo(Utils.getRandomFloat(max, min), scale); } @@ -161,40 +168,46 @@ export default class Utils { } public static isIterable(obj: T): boolean { - if (obj) { - return typeof obj[Symbol.iterator] === 'function'; - } - return false; + return obj ? typeof obj[Symbol.iterator] === 'function' : false; } public static isString(value: unknown): boolean { return typeof value === 'string'; } + public static isEmptyString(value: unknown): boolean { + return Utils.isString(value) && (value as string).trim().length === 0; + } + public static isUndefined(value: unknown): boolean { return typeof value === 'undefined'; } public static isNullOrUndefined(value: unknown): boolean { - // eslint-disable-next-line no-eq-null, eqeqeq - if (value == null) { - return true; - } - return false; + // eslint-disable-next-line eqeqeq, no-eq-null + return value == null ? true : false; } - public static isEmptyArray(object: unknown): boolean { - if (!object) { + public static isEmptyArray(object: unknown | unknown[]): boolean { + if (!Array.isArray(object)) { return true; } - if (Array.isArray(object) && object.length > 0) { + if (object.length > 0) { return false; } return true; } - public static isEmptyObject(obj: Record): boolean { - return !Object.keys(obj).length; + public static isEmptyObject(obj: object): boolean { + if (obj?.constructor !== Object) { + return false; + } + // Iterates over the keys of an object, if + // any exist, return false. + for (const _ in obj) { + return false; + } + return true; } public static insertAt = (str: string, subStr: string, pos: number): string => @@ -210,42 +223,6 @@ export default class Utils { return delay + randomSum; } - /** - * Convert websocket error code to human readable string message - * - * @param code websocket error code - * @returns human readable string message - */ - public static getWebSocketCloseEventStatusString(code: number): string { - if (code >= 0 && code <= 999) { - return '(Unused)'; - } else if (code >= 1016) { - if (code <= 1999) { - return '(For WebSocket standard)'; - } else if (code <= 2999) { - return '(For WebSocket extensions)'; - } else if (code <= 3999) { - return '(For libraries and frameworks)'; - } else if (code <= 4999) { - return '(For applications)'; - } - } - if (!Utils.isUndefined(WebSocketCloseEventStatusString[code])) { - return WebSocketCloseEventStatusString[code] as string; - } - return '(Unknown)'; - } - - public static workerPoolInUse(): boolean { - return [WorkerProcessType.DYNAMIC_POOL, WorkerProcessType.STATIC_POOL].includes( - Configuration.getWorkerProcess() - ); - } - - public static workerDynamicPoolInUse(): boolean { - return Configuration.getWorkerProcess() === WorkerProcessType.DYNAMIC_POOL; - } - public static async promiseWithTimeout( promise: Promise, timeoutMs: number, @@ -274,4 +251,49 @@ export default class Utils { public static secureRandom(): number { return crypto.randomBytes(4).readUInt32LE() / 0x100000000; } + + public static JSONStringifyWithMapSupport( + obj: Record | Record[], + space?: number + ): string { + return JSON.stringify( + obj, + (key, value: Record) => { + if (value instanceof Map) { + return { + dataType: 'Map', + value: [...value], + }; + } + return value; + }, + space + ); + } + + /** + * Convert websocket error code to human readable string message + * + * @param code websocket error code + * @returns human readable string message + */ + public static getWebSocketCloseEventStatusString(code: number): string { + if (code >= 0 && code <= 999) { + return '(Unused)'; + } else if (code >= 1016) { + if (code <= 1999) { + return '(For WebSocket standard)'; + } else if (code <= 2999) { + return '(For WebSocket extensions)'; + } else if (code <= 3999) { + return '(For libraries and frameworks)'; + } else if (code <= 4999) { + return '(For applications)'; + } + } + if (!Utils.isUndefined(WebSocketCloseEventStatusString[code])) { + return WebSocketCloseEventStatusString[code] as string; + } + return '(Unknown)'; + } }