-import { getRandomValues, randomBytes, randomInt, randomUUID } from 'node:crypto'
-import { dirname, isAbsolute, join, parse, relative, resolve } from 'node:path'
+import { getRandomValues, randomBytes, randomUUID } from 'node:crypto'
import { env, nextTick } from 'node:process'
-import { fileURLToPath } from 'node:url'
import {
formatDuration,
minutesToSeconds,
secondsToMilliseconds
} from 'date-fns'
+import type { CircularBuffer } from 'mnemonist'
+import { is } from 'rambda'
-import { Constants } from './Constants.js'
import {
- type EmptyObject,
- type ProtocolResponse,
+ type JsonType,
+ MapStringifyFormat,
type TimestampedData,
WebSocketCloseEventStatusString
} from '../types/index.js'
return `${new Date().toLocaleString()}${prefixString}`
}
-export const generateUUID = (): string => {
+export const generateUUID = (): `${string}-${string}-${string}-${string}-${string}` => {
return randomUUID()
}
-export const validateUUID = (uuid: string): boolean => {
+export const validateUUID = (
+ uuid: `${string}-${string}-${string}-${string}-${string}`
+): uuid is `${string}-${string}-${string}-${string}-${string}` => {
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)
}
if (isDate(value)) {
return value
}
- if (isString(value) || typeof value === 'number') {
+ if (typeof value === 'string' || typeof value === 'number') {
const valueToDate = new Date(value)
if (isNaN(valueToDate.getTime())) {
throw new Error(`Cannot convert to date: '${value}'`)
return Math.trunc(value)
}
let changedValue: number = value as number
- if (isString(value)) {
- changedValue = parseInt(value)
+ if (typeof value === 'string') {
+ changedValue = Number.parseInt(value)
}
if (isNaN(changedValue)) {
throw new Error(`Cannot convert to integer: '${String(value)}'`)
return 0
}
let changedValue: number = value as number
- if (isString(value)) {
- changedValue = parseFloat(value)
+ if (typeof value === 'string') {
+ changedValue = Number.parseFloat(value)
}
if (isNaN(changedValue)) {
throw new Error(`Cannot convert to float: '${String(value)}'`)
// Check the type
if (typeof value === 'boolean') {
return value
- } else if (isString(value) && (value.toLowerCase() === 'true' || value === '1')) {
+ } else if (typeof value === 'string' && (value.toLowerCase() === 'true' || value === '1')) {
result = true
} else if (typeof value === 'number' && value === 1) {
result = true
if (max < min) {
throw new RangeError('Invalid interval')
}
- if (max - min === Infinity) {
+ if (max - min === Number.POSITIVE_INFINITY) {
throw new RangeError('Invalid interval')
}
return (randomBytes(4).readUInt32LE() / 0xffffffff) * (max - min) + min
}
-export const getRandomInteger = (max = Constants.MAX_RANDOM_INTEGER, min = 0): number => {
- max = Math.floor(max)
- if (min !== 0) {
- min = Math.ceil(min)
- return Math.floor(randomInt(min, max + 1))
- }
- return Math.floor(randomInt(max + 1))
-}
-
/**
* Rounds the given number to the given scale.
* The rounding is done using the "round half away from zero" method.
)
}
-export const buildTemplateName = (templateFile: string): string => {
- if (isAbsolute(templateFile)) {
- templateFile = relative(
- resolve(join(dirname(fileURLToPath(import.meta.url)), 'assets', 'station-templates')),
- templateFile
- )
- }
- const templateFileParsedPath = parse(templateFile)
- return join(templateFileParsedPath.dir, templateFileParsedPath.name)
-}
-
-export const extractTimeSeriesValues = (timeSeries: TimestampedData[]): number[] => {
- return timeSeries.map(timeSeriesItem => timeSeriesItem.value)
+export const extractTimeSeriesValues = (timeSeries: CircularBuffer<TimestampedData>): number[] => {
+ return (timeSeries.toArray() as TimestampedData[]).map(timeSeriesItem => timeSeriesItem.value)
}
export const clone = <T>(object: T): T => {
* @internal
*/
export const isAsyncFunction = (fn: unknown): fn is (...args: unknown[]) => Promise<unknown> => {
- return typeof fn === 'function' && fn.constructor.name === 'AsyncFunction'
+ return is(Function, fn) && fn.constructor.name === 'AsyncFunction'
}
export const isObject = (value: unknown): value is object => {
- return value != null && typeof value === 'object' && !Array.isArray(value)
-}
-
-export const isEmptyObject = (object: object): object is EmptyObject => {
- if (object.constructor !== Object) {
- return false
- }
- // Iterates over the keys of an object, if
- // any exist, return false.
- // eslint-disable-next-line no-unreachable-loop
- for (const _ in object) {
- return false
- }
- return true
+ return value != null && !Array.isArray(value) && is(Object, value)
}
export const hasOwnProp = (value: unknown, property: PropertyKey): boolean => {
return env.VCAP_APPLICATION != null
}
-const isString = (value: unknown): value is string => {
- return typeof value === 'string'
-}
-
-export const isEmptyString = (value: unknown): value is '' | undefined | null => {
- return value == null || (isString(value) && value.trim().length === 0)
-}
-
export const isNotEmptyString = (value: unknown): value is string => {
- return isString(value) && value.trim().length > 0
-}
-
-export const isEmptyArray = (value: unknown): value is never[] => {
- return Array.isArray(value) && value.length === 0
+ return typeof value === 'string' && value.trim().length > 0
}
export const isNotEmptyArray = (value: unknown): value is unknown[] => {
return getRandomValues(new Uint32Array(1))[0] / 0x100000000
}
-export const JSONStringifyWithMapSupport = (
- object:
- | Record<string, unknown>
+export const JSONStringify = <
+ T extends
+ | JsonType
| Array<Record<string, unknown>>
- | Map<unknown, unknown>
- | ProtocolResponse,
- space?: string | number
-): string => {
+ | Set<Record<string, unknown>>
+ | Map<string, Record<string, unknown>>
+>(
+ object: T,
+ space?: string | number,
+ mapFormat?: MapStringifyFormat
+ ): string => {
return JSON.stringify(
object,
(_, value: Record<string, unknown>) => {
- if (value instanceof Map) {
- return {
- dataType: 'Map',
- value: [...value]
+ if (is(Map, value)) {
+ switch (mapFormat) {
+ case MapStringifyFormat.object:
+ return {
+ ...Object.fromEntries<Map<string, Record<string, unknown>>>(value.entries())
+ }
+ case MapStringifyFormat.array:
+ default:
+ return [...value]
}
+ } else if (is(Set, value)) {
+ return [...value] as JsonType[]
}
return value
},
return true
}
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export const once = <T, A extends any[], R>(
- fn: (...args: A) => R,
- context: T
-): ((...args: A) => R) => {
- let result: R
- return (...args: A) => {
- // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
- if (fn != null) {
- result = fn.apply<T, A, R>(context, args)
- ;(fn as unknown as undefined) = (context as unknown as undefined) = undefined
- }
- return result
- }
-}
-
-export const min = (...args: number[]): number =>
- args.reduce((minimum, num) => (minimum < num ? minimum : num), Infinity)
-
-export const max = (...args: number[]): number =>
- args.reduce((maximum, num) => (maximum > num ? maximum : num), -Infinity)
-
export const throwErrorInNextTick = (error: Error): void => {
nextTick(() => {
throw error