@lodestar/utils 0.40.0-dev.266f9e2f44

package/lib/logger/index.js

@@ -0,0 +1,8 @@
+/**
+ * @module logger
+ */
+export * from "./interface.js";
+export * from "./format.js";
+export * from "./transport.js";
+export * from "./winston.js";
+//# sourceMappingURL=index.js.map

package/lib/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/lib/logger/interface.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @module logger
+ */
+/// <reference types="node" />
+import { Writable } from "node:stream";
+import { LogData } from "./json.js";
+export declare enum LogLevel {
+    error = "error",
+    warn = "warn",
+    info = "info",
+    verbose = "verbose",
+    debug = "debug",
+    silly = "silly"
+}
+export declare const logLevelNum: {
+    [K in LogLevel]: number;
+};
+export declare const LogLevels: LogLevel[];
+export declare const customColors: {
+    error: string;
+    warn: string;
+    info: string;
+    verbose: string;
+    debug: string;
+    silly: string;
+};
+export declare const defaultLogLevel = LogLevel.info;
+export declare type LogFormat = "human" | "json";
+export declare const logFormats: LogFormat[];
+export declare type EpochSlotOpts = {
+    genesisTime: number;
+    secondsPerSlot: number;
+    slotsPerEpoch: number;
+};
+export declare enum TimestampFormatCode {
+    DateRegular = 0,
+    EpochSlot = 1
+}
+export declare type TimestampFormat = {
+    format: TimestampFormatCode.DateRegular;
+} | ({
+    format: TimestampFormatCode.EpochSlot;
+} & EpochSlotOpts);
+export interface ILoggerOptions {
+    level?: LogLevel;
+    module?: string;
+    format?: LogFormat;
+    hideTimestamp?: boolean;
+    timestampFormat?: TimestampFormat;
+}
+export declare type LogHandler = (message: string, context?: LogData, error?: Error) => void;
+export interface ILogger {
+    error: LogHandler;
+    warn: LogHandler;
+    info: LogHandler;
+    important: LogHandler;
+    verbose: LogHandler;
+    debug: LogHandler;
+    silly: LogHandler;
+    stream(): Writable;
+    child(options: ILoggerOptions): ILogger;
+}
+//# sourceMappingURL=interface.d.ts.map

package/lib/logger/interface.js

@@ -0,0 +1,38 @@
+/**
+ * @module logger
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["error"] = "error";
+    LogLevel["warn"] = "warn";
+    LogLevel["info"] = "info";
+    LogLevel["verbose"] = "verbose";
+    LogLevel["debug"] = "debug";
+    LogLevel["silly"] = "silly";
+})(LogLevel || (LogLevel = {}));
+export const logLevelNum = {
+    [LogLevel.error]: 0,
+    [LogLevel.warn]: 1,
+    [LogLevel.info]: 2,
+    [LogLevel.verbose]: 3,
+    [LogLevel.debug]: 4,
+    [LogLevel.silly]: 5,
+};
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export const LogLevels = Object.values(LogLevel);
+export const customColors = {
+    error: "red",
+    warn: "yellow",
+    info: "white",
+    verbose: "green",
+    debug: "pink",
+    silly: "purple",
+};
+export const defaultLogLevel = LogLevel.info;
+export const logFormats = ["human", "json"];
+export var TimestampFormatCode;
+(function (TimestampFormatCode) {
+    TimestampFormatCode[TimestampFormatCode["DateRegular"] = 0] = "DateRegular";
+    TimestampFormatCode[TimestampFormatCode["EpochSlot"] = 1] = "EpochSlot";
+})(TimestampFormatCode || (TimestampFormatCode = {}));
+//# sourceMappingURL=interface.js.map

package/lib/logger/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/logger/interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,+BAAmB,CAAA;IACnB,2BAAe,CAAA;IACf,2BAAe,CAAA;AACjB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAED,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACnB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IAClB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IAClB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IACrB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACnB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;CACpB,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,QAAQ;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC;AAG7C,MAAM,CAAC,MAAM,UAAU,GAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAOzD,MAAM,CAAN,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC7B,2EAAW,CAAA;IACX,uEAAS,CAAA;AACX,CAAC,EAHW,mBAAmB,KAAnB,mBAAmB,QAG9B"}

package/lib/logger/json.d.ts

@@ -0,0 +1,18 @@
+declare type LogDataBasic = string | number | bigint | boolean | null | undefined;
+export declare type LogData = LogDataBasic | Record<string, LogDataBasic> | LogDataBasic[] | Record<string, LogDataBasic>[];
+/**
+ * Renders any log Context to JSON up to one level of depth.
+ *
+ * By limiting recursiveness, it renders limited content while ensuring safer logging.
+ * Consumers of the logger should ensure to send pre-formated data if they require nesting.
+ */
+export declare function logCtxToJson(arg: unknown, depth?: number, fromError?: boolean): LogData;
+/**
+ * Renders any log Context to a string up to one level of depth.
+ *
+ * By limiting recursiveness, it renders limited content while ensuring safer logging.
+ * Consumers of the logger should ensure to send pre-formated data if they require nesting.
+ */
+export declare function logCtxToString(arg: unknown, depth?: number, fromError?: boolean): string;
+export {};
+//# sourceMappingURL=json.d.ts.map

package/lib/logger/json.js

@@ -0,0 +1,115 @@
+import { toHexString } from "../bytes.js";
+import { LodestarError } from "../errors.js";
+import { mapValues } from "../objects.js";
+const MAX_DEPTH = 0;
+/**
+ * Renders any log Context to JSON up to one level of depth.
+ *
+ * By limiting recursiveness, it renders limited content while ensuring safer logging.
+ * Consumers of the logger should ensure to send pre-formated data if they require nesting.
+ */
+export function logCtxToJson(arg, depth = 0, fromError = false) {
+    switch (typeof arg) {
+        case "bigint":
+        case "symbol":
+        case "function":
+            return arg.toString();
+        case "object":
+            if (arg === null)
+                return "null";
+            if (arg instanceof Uint8Array) {
+                return toHexString(arg);
+            }
+            // For any type that may include recursiveness break early at the first level
+            // - Prevent recursive loops
+            // - Ensures Error with deep complex metadata won't leak into the logs and cause bugs
+            if (depth > MAX_DEPTH) {
+                return "[object]";
+            }
+            if (arg instanceof Error) {
+                let metadata;
+                if (arg instanceof LodestarError) {
+                    if (fromError) {
+                        return "[LodestarErrorCircular]";
+                    }
+                    else {
+                        // Allow one extra depth level for LodestarError
+                        metadata = logCtxToJson(arg.getMetadata(), depth - 1, true);
+                    }
+                }
+                else {
+                    metadata = { message: arg.message };
+                }
+                if (arg.stack)
+                    metadata.stack = arg.stack;
+                return metadata;
+            }
+            if (Array.isArray(arg)) {
+                return arg.map((item) => logCtxToJson(item, depth + 1));
+            }
+            return mapValues(arg, (item) => logCtxToJson(item, depth + 1));
+        // Already valid JSON
+        case "number":
+        case "string":
+        case "undefined":
+        case "boolean":
+            return arg;
+        default:
+            return String(arg);
+    }
+}
+/**
+ * Renders any log Context to a string up to one level of depth.
+ *
+ * By limiting recursiveness, it renders limited content while ensuring safer logging.
+ * Consumers of the logger should ensure to send pre-formated data if they require nesting.
+ */
+export function logCtxToString(arg, depth = 0, fromError = false) {
+    switch (typeof arg) {
+        case "bigint":
+        case "symbol":
+        case "function":
+            return arg.toString();
+        case "object":
+            if (arg === null)
+                return "null";
+            if (arg instanceof Uint8Array) {
+                return toHexString(arg);
+            }
+            // For any type that may include recursiveness break early at the first level
+            // - Prevent recursive loops
+            // - Ensures Error with deep complex metadata won't leak into the logs and cause bugs
+            if (depth > MAX_DEPTH) {
+                return "[object]";
+            }
+            if (arg instanceof Error) {
+                let metadata;
+                if (arg instanceof LodestarError) {
+                    if (fromError) {
+                        return "[LodestarErrorCircular]";
+                    }
+                    else {
+                        // Allow one extra depth level for LodestarError
+                        metadata = logCtxToString(arg.getMetadata(), depth - 1, true);
+                    }
+                }
+                else {
+                    metadata = arg.message;
+                }
+                return `${metadata}\n${arg.stack || ""}`;
+            }
+            if (Array.isArray(arg)) {
+                return arg.map((item) => logCtxToString(item, depth + 1)).join(", ");
+            }
+            return Object.entries(arg)
+                .map(([key, value]) => `${key}=${logCtxToString(value, depth + 1)}`)
+                .join(", ");
+        case "number":
+        case "string":
+        case "undefined":
+        case "boolean":
+        default:
+            return String(arg);
+    }
+}
+//# sourceMappingURL=json.js.map

package/lib/logger/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/logger/json.ts"],"names":[],"mappings":"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"}

package/lib/logger/transport.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="node" />
+import TransportStream from "winston-transport";
+import { LogLevel } from "./interface.js";
+export declare enum TransportType {
+    console = "console",
+    file = "file",
+    stream = "stream"
+}
+export declare type TransportOpts = {
+    type: TransportType.console;
+    level?: LogLevel;
+} | {
+    type: TransportType.file;
+    level?: LogLevel;
+    filename: string;
+    rotate?: boolean;
+    maxfiles?: number;
+} | {
+    type: TransportType.stream;
+    level?: LogLevel;
+    stream: NodeJS.WritableStream;
+};
+export declare function fromTransportOpts(transportOpts: TransportOpts): TransportStream;
+//# sourceMappingURL=transport.d.ts.map

package/lib/logger/transport.js

@@ -0,0 +1,41 @@
+import winston from "winston";
+import DailyRotateFile from "winston-daily-rotate-file";
+const { transports } = winston;
+export var TransportType;
+(function (TransportType) {
+    TransportType["console"] = "console";
+    TransportType["file"] = "file";
+    TransportType["stream"] = "stream";
+})(TransportType || (TransportType = {}));
+export function fromTransportOpts(transportOpts) {
+    switch (transportOpts.type) {
+        case TransportType.console:
+            return new transports.Console({
+                debugStdout: true,
+                level: transportOpts.level,
+                handleExceptions: true,
+            });
+        case TransportType.file:
+            return transportOpts.rotate
+                ? new DailyRotateFile({
+                    level: transportOpts.level,
+                    //insert the date pattern in filename before the file extension.
+                    filename: transportOpts.filename.replace(/\.(?=[^.]*$)|$/, "-%DATE%$&"),
+                    datePattern: "YYYY-MM-DD",
+                    handleExceptions: true,
+                    maxFiles: transportOpts.maxfiles,
+                })
+                : new transports.File({
+                    level: transportOpts.level,
+                    filename: transportOpts.filename,
+                    handleExceptions: true,
+                });
+        case TransportType.stream:
+            return new transports.Stream({
+                level: transportOpts.level,
+                stream: transportOpts.stream,
+                handleExceptions: true,
+            });
+    }
+}
+//# sourceMappingURL=transport.js.map

package/lib/logger/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/logger/transport.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,eAAe,MAAM,2BAA2B,CAAC;AAIxD,MAAM,EAAC,UAAU,EAAC,GAAG,OAAO,CAAC;AAE7B,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,8BAAa,CAAA;IACb,kCAAiB,CAAA;AACnB,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AAOD,MAAM,UAAU,iBAAiB,CAAC,aAA4B;IAC5D,QAAQ,aAAa,CAAC,IAAI,EAAE;QAC1B,KAAK,aAAa,CAAC,OAAO;YACxB,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC;gBAC5B,WAAW,EAAE,IAAI;gBACjB,KAAK,EAAE,aAAa,CAAC,KAAK;gBAC1B,gBAAgB,EAAE,IAAI;aACvB,CAAC,CAAC;QAEL,KAAK,aAAa,CAAC,IAAI;YACrB,OAAO,aAAa,CAAC,MAAM;gBACzB,CAAC,CAAC,IAAI,eAAe,CAAC;oBAClB,KAAK,EAAE,aAAa,CAAC,KAAK;oBAC1B,gEAAgE;oBAChE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,WAAW,CAAC;oBACvE,WAAW,EAAE,YAAY;oBACzB,gBAAgB,EAAE,IAAI;oBACtB,QAAQ,EAAE,aAAa,CAAC,QAAQ;iBACjC,CAAC;gBACJ,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC;oBAClB,KAAK,EAAE,aAAa,CAAC,KAAK;oBAC1B,QAAQ,EAAE,aAAa,CAAC,QAAQ;oBAChC,gBAAgB,EAAE,IAAI;iBACvB,CAAC,CAAC;QAET,KAAK,aAAa,CAAC,MAAM;YACvB,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC;gBAC3B,KAAK,EAAE,aAAa,CAAC,KAAK;gBAC1B,MAAM,EAAE,aAAa,CAAC,MAAM;gBAC5B,gBAAgB,EAAE,IAAI;aACvB,CAAC,CAAC;KACN;AACH,CAAC"}

package/lib/logger/util.d.ts

@@ -0,0 +1,6 @@
+import { EpochSlotOpts } from "./interface.js";
+/**
+ * Formats time as: `EPOCH/SLOT_INDEX SECONDS.MILISECONDS
+ */
+export declare function formatEpochSlotTime(opts: EpochSlotOpts, now?: number): string;
+//# sourceMappingURL=util.d.ts.map

package/lib/logger/util.js

@@ -0,0 +1,14 @@
+/**
+ * Formats time as: `EPOCH/SLOT_INDEX SECONDS.MILISECONDS
+ */
+export function formatEpochSlotTime(opts, now = Date.now()) {
+    const nowSec = now / 1000;
+    const secSinceGenesis = nowSec - opts.genesisTime;
+    const epoch = Math.floor(secSinceGenesis / (opts.slotsPerEpoch * opts.secondsPerSlot));
+    const epochStartSec = opts.genesisTime + epoch * opts.slotsPerEpoch * opts.secondsPerSlot;
+    const secSinceStartEpoch = nowSec - epochStartSec;
+    const slotIndex = Math.floor(secSinceStartEpoch / opts.secondsPerSlot);
+    const slotSec = secSinceStartEpoch % opts.secondsPerSlot;
+    return `Eph ${epoch}/${slotIndex} ${slotSec.toFixed(3)}`;
+}
+//# sourceMappingURL=util.js.map

package/lib/logger/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/logger/util.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAmB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACvE,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC;IAC1B,MAAM,eAAe,GAAG,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IACvF,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,GAAG,KAAK,GAAG,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC;IAC1F,MAAM,kBAAkB,GAAG,MAAM,GAAG,aAAa,CAAC;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAAC,cAAc,CAAC;IACzD,OAAO,OAAO,KAAK,IAAI,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3D,CAAC"}

package/lib/logger/winston.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @module logger
+ */
+/// <reference types="node" />
+import { Writable } from "node:stream";
+import { ILogger, ILoggerOptions } from "./interface.js";
+import { TransportOpts } from "./transport.js";
+import { LogData } from "./json.js";
+export declare class WinstonLogger implements ILogger {
+    private winston;
+    private _level;
+    private _options;
+    private _transportOptsArr;
+    constructor(options?: Partial<ILoggerOptions>, transportOptsArr?: TransportOpts[]);
+    error(message: string, context?: LogData, error?: Error): void;
+    warn(message: string, context?: LogData, error?: Error): void;
+    info(message: string, context?: LogData, error?: Error): void;
+    important(message: string, context?: LogData, error?: Error): void;
+    verbose(message: string, context?: LogData, error?: Error): void;
+    debug(message: string, context?: LogData, error?: Error): void;
+    silly(message: string, context?: LogData, error?: Error): void;
+    profile(message: string, option?: {
+        level: string;
+        message: string;
+    }): void;
+    stream(): Writable;
+    child(options: ILoggerOptions): WinstonLogger;
+    private createLogEntry;
+}
+//# sourceMappingURL=winston.d.ts.map

package/lib/logger/winston.js

@@ -0,0 +1,83 @@
+/**
+ * @module logger
+ */
+import winston from "winston";
+import chalk from "chalk";
+import { defaultLogLevel, LogLevel, logLevelNum } from "./interface.js";
+import { getFormat } from "./format.js";
+import { TransportType, fromTransportOpts } from "./transport.js";
+const { createLogger } = winston;
+const defaultTransportOpts = { type: TransportType.console };
+export class WinstonLogger {
+    constructor(options = {}, transportOptsArr = [defaultTransportOpts]) {
+        // `options.level` can override the level in the transport
+        // This is necessary for child logger opts to take effect
+        let minLevel = options === null || options === void 0 ? void 0 : options.level;
+        for (const transportOpts of transportOptsArr) {
+            transportOpts.level = getMinLevel(options === null || options === void 0 ? void 0 : options.level, transportOpts.level); // General level may override transport level
+            minLevel = getMinLevel(minLevel, transportOpts.level); // Compute the minLevel from general and all transports
+        }
+        this.winston = createLogger({
+            level: (options === null || options === void 0 ? void 0 : options.level) || defaultLogLevel,
+            defaultMeta: { module: (options === null || options === void 0 ? void 0 : options.module) || "" },
+            format: getFormat(options),
+            transports: transportOptsArr.map((transportOpts) => fromTransportOpts(transportOpts)),
+            exitOnError: false,
+        });
+        this._level = minLevel || defaultLogLevel;
+        // Store for child logger
+        this._options = options;
+        this._transportOptsArr = transportOptsArr;
+    }
+    error(message, context, error) {
+        this.createLogEntry(LogLevel.error, message, context, error);
+    }
+    warn(message, context, error) {
+        this.createLogEntry(LogLevel.warn, message, context, error);
+    }
+    info(message, context, error) {
+        this.createLogEntry(LogLevel.info, message, context, error);
+    }
+    important(message, context, error) {
+        this.createLogEntry(LogLevel.info, chalk.red(message), context, error);
+    }
+    verbose(message, context, error) {
+        this.createLogEntry(LogLevel.verbose, message, context, error);
+    }
+    debug(message, context, error) {
+        this.createLogEntry(LogLevel.debug, message, context, error);
+    }
+    silly(message, context, error) {
+        this.createLogEntry(LogLevel.silly, message, context, error);
+    }
+    profile(message, option) {
+        this.winston.profile(message, option);
+    }
+    stream() {
+        throw Error("Not implemented");
+    }
+    child(options) {
+        // Concat module tags
+        if (options.module)
+            options.module = [this._options.module, options.module].filter(Boolean).join(" ");
+        return new WinstonLogger({ ...this._options, ...options }, this._transportOptsArr);
+    }
+    createLogEntry(level, message, context, error) {
+        // don't propagate if silenced or message level is more detailed than logger level
+        if (logLevelNum[level] > logLevelNum[this._level]) {
+            return;
+        }
+        this.winston[level](message, { context, error });
+    }
+}
+/** Return the min LogLevel from multiple transports */
+function getMinLevel(...levelsArg) {
+    const levels = levelsArg.filter((level) => Boolean(level));
+    // Only if there are no levels to compute min from, consider defaultLogLevel
+    if (levels.length === 0)
+        return defaultLogLevel;
+    return levels.reduce(
+    // error: 0, warn: 1, info: 2, ...
+    (minLevel, level) => (logLevelNum[level] > logLevelNum[minLevel] ? level : minLevel));
+}
+//# sourceMappingURL=winston.js.map

package/lib/logger/winston.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"winston.js","sourceRoot":"","sources":["../../src/logger/winston.ts"],"names":[],"mappings":"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"}

package/lib/math.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module util/math
+ */
+/**
+ * Return the min number between two big numbers.
+ */
+export declare function bigIntMin(a: bigint, b: bigint): bigint;
+/**
+ * Return the max number between two big numbers.
+ */
+export declare function bigIntMax(a: bigint, b: bigint): bigint;
+export declare function intDiv(dividend: number, divisor: number): number;
+/**
+ * Calculate the largest integer k such that k**2 <= n.
+ */
+export declare function intSqrt(n: number): number;
+export declare function bigIntSqrt(n: bigint): bigint;
+/**
+ * Regenerates a random integer between min (included) and max (excluded).
+ */
+export declare function randBetween(min: number, max: number): number;
+/**
+ * Wraps randBetween and returns a bigNumber.
+ * @returns {bigint}
+ */
+export declare function randBetweenBigInt(min: number, max: number): bigint;
+//# sourceMappingURL=math.d.ts.map

package/lib/math.js

@@ -0,0 +1,53 @@
+/**
+ * @module util/math
+ */
+/**
+ * Return the min number between two big numbers.
+ */
+export function bigIntMin(a, b) {
+    return a < b ? a : b;
+}
+/**
+ * Return the max number between two big numbers.
+ */
+export function bigIntMax(a, b) {
+    return a > b ? a : b;
+}
+export function intDiv(dividend, divisor) {
+    return Math.floor(dividend / divisor);
+}
+/**
+ * Calculate the largest integer k such that k**2 <= n.
+ */
+export function intSqrt(n) {
+    let x = n;
+    let y = intDiv(x + 1, 2);
+    while (y < x) {
+        x = y;
+        y = intDiv(x + intDiv(n, x), 2);
+    }
+    return x;
+}
+export function bigIntSqrt(n) {
+    let x = n;
+    let y = (x + BigInt(1)) / BigInt(2);
+    while (y < x) {
+        x = y;
+        y = (x + n / x) / BigInt(2);
+    }
+    return x;
+}
+/**
+ * Regenerates a random integer between min (included) and max (excluded).
+ */
+export function randBetween(min, max) {
+    return Math.floor(Math.random() * (max - min)) + min;
+}
+/**
+ * Wraps randBetween and returns a bigNumber.
+ * @returns {bigint}
+ */
+export function randBetweenBigInt(min, max) {
+    return BigInt(randBetween(min, max));
+}
+//# sourceMappingURL=math.js.map

package/lib/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../src/math.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS,EAAE,CAAS;IAC5C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS,EAAE,CAAS;IAC5C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,QAAgB,EAAE,OAAe;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC,EAAE;QACZ,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;KACjC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,EAAE;QACZ,CAAC,GAAG,CAAC,CAAC;QACN,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;KAC7B;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,GAAW;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,GAAW;IACxD,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/lib/notNullish.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Type-safe helper to filter out nullist values from an array
+ * ```js
+ * const array: (string | null)[] = ['foo', null];
+ * const filteredArray: string[] = array.filter(notEmpty);
+ * ```
+ * @param value
+ */
+export declare function notNullish<TValue>(value: TValue | null | undefined): value is TValue;
+//# sourceMappingURL=notNullish.d.ts.map

package/lib/notNullish.js

@@ -0,0 +1,12 @@
+/**
+ * Type-safe helper to filter out nullist values from an array
+ * ```js
+ * const array: (string | null)[] = ['foo', null];
+ * const filteredArray: string[] = array.filter(notEmpty);
+ * ```
+ * @param value
+ */
+export function notNullish(value) {
+    return value !== null && value !== undefined;
+}
+//# sourceMappingURL=notNullish.js.map

package/lib/notNullish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notNullish.js","sourceRoot":"","sources":["../src/notNullish.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAS,KAAgC;IACjE,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC"}

package/lib/objects.d.ts

@@ -0,0 +1,16 @@
+export declare type KeyCase = "snake" | "constant" | "camel" | "param" | "header" | "pascal" | "dot" | "notransform";
+export declare function toExpectedCase(value: string, expectedCase?: KeyCase, customCasingMap?: Record<string, string>): string;
+export declare function isPlainObject(o: unknown): boolean;
+/**
+ * Creates an object with the same keys as object and values generated by running each own enumerable
+ * string keyed property of object thru iteratee.
+ *
+ * Inspired on lodash.mapValues, see https://lodash.com/docs/4.17.15#mapValues
+ */
+export declare function mapValues<T extends {
+    [K: string]: any;
+}, R>(obj: T, iteratee: (value: T[keyof T], key: keyof T) => R): {
+    [K in keyof T]: R;
+};
+export declare function objectToExpectedCase<T extends Record<string, unknown> | Record<string, unknown>[]>(obj: T, expectedCase?: "snake" | "constant" | "camel" | "param" | "header" | "pascal" | "dot" | "notransform"): T;
+//# sourceMappingURL=objects.d.ts.map