@wireio/shared 1.0.0

package/lib/logging/Formatter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Formatter.js.map

package/lib/logging/Formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Formatter.js","sourceRoot":"","sources":["../../src/logging/Formatter.ts"],"names":[],"mappings":""}

package/lib/logging/InternalLogger.d.ts

@@ -0,0 +1,2 @@
+export declare function getInternalLogger(category?: string): Console;
+//# sourceMappingURL=InternalLogger.d.ts.map

package/lib/logging/InternalLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternalLogger.d.ts","sourceRoot":"","sources":["../../src/logging/InternalLogger.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,MAAwB,WAGnE"}

package/lib/logging/InternalLogger.js

@@ -0,0 +1,6 @@
+const GLOBAL_CATEGORY = "GLOBAL";
+export function getInternalLogger(category = GLOBAL_CATEGORY) {
+    category = category.split("/").pop().replace(/\.[a-z]+$/, "") ?? GLOBAL_CATEGORY;
+    return console;
+}
+//# sourceMappingURL=InternalLogger.js.map

package/lib/logging/InternalLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternalLogger.js","sourceRoot":"","sources":["../../src/logging/InternalLogger.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,QAAQ,CAAA;AAEhC,MAAM,UAAU,iBAAiB,CAAC,WAAmB,eAAe;IAClE,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAC,EAAE,CAAC,IAAI,eAAe,CAAA;IAC/E,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/lib/logging/Level.d.ts

@@ -0,0 +1,14 @@
+export declare enum Level {
+    trace = "trace",
+    debug = "debug",
+    info = "info",
+    warn = "warn",
+    error = "error",
+    fatal = "fatal"
+}
+export type LevelName = `${Level}`;
+export type LevelKind = LevelName | Level;
+export declare const LevelNames: Array<LevelName>;
+export declare const LevelThresholds: Record<LevelKind, number>;
+export type LevelEnableFnName = `is${Capitalize<LevelName>}Enabled`;
+//# sourceMappingURL=Level.d.ts.map

package/lib/logging/Level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Level.d.ts","sourceRoot":"","sources":["../../src/logging/Level.ts"],"names":[],"mappings":"AAEA,oBAAY,KAAK;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED,MAAM,MAAM,SAAS,GAAG,GAAG,KAAK,EAAE,CAAA;AAClC,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,KAAK,CAAA;AAEzC,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,SAAS,CAA8B,CAAA;AACtE,eAAO,MAAM,eAAe,EAEvB,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;AAC9B,MAAM,MAAM,iBAAiB,GAAG,KAAK,UAAU,CAAC,SAAS,CAAC,SAAS,CAAA"}

package/lib/logging/Level.js

@@ -0,0 +1,13 @@
+import { fromPairs, uniq } from "lodash";
+export var Level;
+(function (Level) {
+    Level["trace"] = "trace";
+    Level["debug"] = "debug";
+    Level["info"] = "info";
+    Level["warn"] = "warn";
+    Level["error"] = "error";
+    Level["fatal"] = "fatal";
+})(Level || (Level = {}));
+export const LevelNames = uniq(Object.values(Level));
+export const LevelThresholds = fromPairs(LevelNames.map((level, i) => [level, i]));
+//# sourceMappingURL=Level.js.map

package/lib/logging/Level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Level.js","sourceRoot":"","sources":["../../src/logging/Level.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAExC,MAAM,CAAN,IAAY,KAOX;AAPD,WAAY,KAAK;IACf,wBAAe,CAAA;IACf,wBAAe,CAAA;IACf,sBAAa,CAAA;IACb,sBAAa,CAAA;IACb,wBAAe,CAAA;IACf,wBAAe,CAAA;AACjB,CAAC,EAPW,KAAK,KAAL,KAAK,QAOhB;AAKD,MAAM,CAAC,MAAM,UAAU,GAAqB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CACtC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CACZ,CAAA"}

package/lib/logging/LogRecord.d.ts

@@ -0,0 +1,16 @@
+import type { LevelKind } from "./Level";
+export interface LogRecord<Data = any> {
+    timestamp: number;
+    category: string;
+    level: LevelKind;
+    message: string;
+    args?: any[];
+    data?: Data;
+    tags?: string[];
+    url?: string;
+    env?: string;
+    event?: string;
+    errorMessage?: string;
+    errorStack?: string;
+}
+//# sourceMappingURL=LogRecord.d.ts.map

package/lib/logging/LogRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogRecord.d.ts","sourceRoot":"","sources":["../../src/logging/LogRecord.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAS,SAAS,EAAa,MAAM,SAAS,CAAA;AAE1D,MAAM,WAAW,SAAS,CAAC,IAAI,GAAG,GAAG;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,SAAS,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;IACZ,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/lib/logging/LogRecord.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=LogRecord.js.map

package/lib/logging/LogRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogRecord.js","sourceRoot":"","sources":["../../src/logging/LogRecord.ts"],"names":[],"mappings":""}

package/lib/logging/Logger.d.ts

@@ -0,0 +1,77 @@
+import { LevelKind } from "./Level.js";
+import type { LoggingManager } from "./LoggingManager.js";
+import type { LogRecord } from "./LogRecord.js";
+export interface LoggerOptions {
+    categoryInterpolator: CategoryInterpolator;
+}
+export type CategoryInterpolator = (inCategory: string, options?: LoggerOptions) => string;
+export declare const filenameCategoryInterpolator: CategoryInterpolator;
+export declare const defaultLoggerOptions: LoggerOptions;
+export declare function toLogRecord(logger: Logger, levelOrRecord: LevelKind | LogRecord, args: any[]): {
+    timestamp: number;
+    category: string;
+    level: LevelKind;
+    message: string;
+    args?: any[];
+    data?: any;
+    tags?: string[];
+    url?: string;
+    env?: string;
+    event?: string;
+    errorMessage?: string;
+    errorStack?: string;
+};
+export interface LoggerState {
+    overrideLevel?: LevelKind;
+}
+export declare class Logger {
+    readonly manager: LoggingManager;
+    readonly category: string;
+    readonly options: LoggerOptions;
+    readonly state: LoggerState;
+    get overrideLevel(): LevelKind;
+    get overrideThreshold(): number;
+    setOverrideLevel(inOverrideLevel: LevelKind): this;
+    /**
+     * Base logging function
+     *
+     * @param record
+     */
+    log(record: LogRecord): void;
+    log(level: LevelKind, message: string, ...args: any[]): void;
+    /**
+     * Factory for the log
+     * level functions
+     *
+     * @param {LevelKind} level
+     * @returns {(message: string, ...args: any[]) => void}
+     * @private
+     */
+    private createLevelLogger;
+    /**
+     * Factory for is<Level>Enabled
+     *
+     * @param {LevelKind} level
+     * @returns {() => boolean}
+     * @private
+     */
+    private createLevelEnabled;
+    readonly trace: (message: string, ...args: any[]) => void;
+    readonly debug: (message: string, ...args: any[]) => void;
+    readonly info: (message: string, ...args: any[]) => void;
+    readonly warn: (message: string, ...args: any[]) => void;
+    readonly error: (message: string, ...args: any[]) => void;
+    readonly fatal: (message: string, ...args: any[]) => void;
+    readonly isTraceEnabled: () => boolean;
+    readonly isDebugEnabled: () => boolean;
+    readonly isInfoEnabled: () => boolean;
+    readonly isWarnEnabled: () => boolean;
+    readonly isErrorEnabled: () => boolean;
+    readonly isFatalEnabled: () => boolean;
+    assert(test: boolean | (() => boolean), message: string, ...args: any[]): void;
+    assertFatal(test: boolean | (() => boolean), message: string, exitCode?: number): void;
+    constructor(manager: LoggingManager, category: string, options: LoggerOptions);
+    static hydrateOptions(options?: Partial<LoggerOptions>): LoggerOptions;
+    static interoplateCategory(category: string, options: LoggerOptions): string;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/lib/logging/Logger.d.ts.map

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

package/lib/logging/Logger.js

@@ -0,0 +1,158 @@
+import { assert, getValue, isString, isDefined, isFunction, isNumber } from "../guards/index.js";
+import { Option } from "prelude-ts";
+import { pick } from "lodash";
+import { LevelThresholds } from "./Level.js";
+import { isLogLevelKind } from "./util.js";
+export const filenameCategoryInterpolator = (filename) => {
+    const allParts = filename.replaceAll("\\", "/").split("/");
+    const rootIndex = Math.max(...["src", "lib"].map((name) => allParts.indexOf(name)));
+    const parts = rootIndex === -1 ? [allParts.pop()] : allParts.slice(rootIndex + 1);
+    const category = Option.of(parts.join(":"))
+        .flatMap((cat) => Option.of(cat.lastIndexOf(".")).map((index) => index === -1 ? cat : cat.slice(0, index)))
+        .getOrElse("unknown");
+    return category;
+};
+export const defaultLoggerOptions = {
+    categoryInterpolator: filenameCategoryInterpolator
+};
+export function toLogRecord(logger, levelOrRecord, args) {
+    const errRecord = Option.ofNullable(args.find((arg) => (isString(arg?.message) && !!arg.stack) || arg instanceof Error)).match({
+        Some: (err) => ({
+            errorMessage: getValue(() => err.message),
+            errorStack: getValue(() => err.stack)
+        }),
+        None: () => ({})
+    });
+    const recordBase = isString(levelOrRecord)
+        ? {
+            ...pick(logger, ["category"]),
+            timestamp: Date.now(),
+            message: args[0],
+            level: levelOrRecord,
+            args: args.slice(1)
+        }
+        : levelOrRecord;
+    return {
+        ...recordBase,
+        ...errRecord,
+        timestamp: isNumber(recordBase.timestamp) && recordBase.timestamp > 0 ? recordBase.timestamp : Date.now(),
+    };
+}
+export class Logger {
+    manager;
+    category;
+    options;
+    state = {
+        overrideLevel: null
+    };
+    get overrideLevel() {
+        return Option.ofNullable(this.state.overrideLevel)
+            .filter(isLogLevelKind) //Predicate.of<LevelKind>(isString).and(isLogLevelKind))
+            .getOrNull();
+    }
+    get overrideThreshold() {
+        return Option.ofNullable(this.overrideLevel)
+            .map((level) => LevelThresholds[level])
+            .getOrNull();
+    }
+    setOverrideLevel(inOverrideLevel) {
+        const overrideLevel = (!inOverrideLevel ? null : inOverrideLevel.toLocaleLowerCase());
+        assert(!isDefined(overrideLevel) || isLogLevelKind(overrideLevel), `Invalid override level, must be a log level, all lower case`);
+        Object.assign(this.state, {
+            overrideLevel
+        });
+        return this;
+    }
+    log(levelOrRecord, ...args) {
+        const record = toLogRecord(this, levelOrRecord, args);
+        this.manager.fire(record);
+    }
+    /**
+     * Factory for the log
+     * level functions
+     *
+     * @param {LevelKind} level
+     * @returns {(message: string, ...args: any[]) => void}
+     * @private
+     */
+    createLevelLogger(level) {
+        const isEnabled = this.createLevelEnabled(level);
+        return (message, ...args) => {
+            if (isEnabled()) {
+                this.log(level, message, ...args);
+            }
+        };
+    }
+    /**
+     * Factory for is<Level>Enabled
+     *
+     * @param {LevelKind} level
+     * @returns {() => boolean}
+     * @private
+     */
+    createLevelEnabled(level) {
+        return () => {
+            const { rootThreshold } = this.manager;
+            const globalOverrideThreshold = this.manager.determineThresholdOverride(this.category);
+            const categoryThresholds = [
+                globalOverrideThreshold,
+                rootThreshold,
+                this.overrideThreshold
+            ].filter(isNumber);
+            const categoryThreshold = Math.min(...categoryThresholds);
+            const recordThreshold = LevelThresholds[level];
+            return recordThreshold >= categoryThreshold;
+        };
+    }
+    trace = this.createLevelLogger("trace");
+    debug = this.createLevelLogger("debug");
+    info = this.createLevelLogger("info");
+    warn = this.createLevelLogger("warn");
+    error = this.createLevelLogger("error");
+    fatal = this.createLevelLogger("fatal");
+    isTraceEnabled = this.createLevelEnabled("trace");
+    isDebugEnabled = this.createLevelEnabled("debug");
+    isInfoEnabled = this.createLevelEnabled("info");
+    isWarnEnabled = this.createLevelEnabled("warn");
+    isErrorEnabled = this.createLevelEnabled("error");
+    isFatalEnabled = this.createLevelEnabled("fatal");
+    assert(test, message, ...args) {
+        const isTruthy = isFunction(test) ? test() : test;
+        if (isTruthy) {
+            return;
+        }
+        this.error(message, ...args);
+    }
+    assertFatal(test, message, exitCode = 1) {
+        const isTruthy = isFunction(test) ? test() : test;
+        if (isTruthy) {
+            return;
+        }
+        this.fatal("FATAL ASSERTION: ", message);
+        if (typeof process !== "undefined") {
+            process.exit(exitCode);
+        }
+        else {
+            console.error("FATAL ASSERTION: `process` is not defined, probably in a web browser");
+        }
+    }
+    constructor(manager, category, options) {
+        this.manager = manager;
+        this.category = category;
+        this.options = options;
+    }
+    static hydrateOptions(options = {}) {
+        return {
+            ...defaultLoggerOptions,
+            ...options
+        };
+    }
+    static interoplateCategory(category, options) {
+        options = {
+            ...defaultLoggerOptions,
+            ...options
+        };
+        return options.categoryInterpolator(category, options);
+    }
+}
+//# sourceMappingURL=Logger.js.map

package/lib/logging/Logger.js.map

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

package/lib/logging/LoggingManager.d.ts

@@ -0,0 +1,128 @@
+import type { Appender } from "./Appender.js";
+import { LevelKind } from "./Level.js";
+import { Logger, LoggerOptions } from "./Logger.js";
+import type { LogRecord } from "./LogRecord.js";
+import { LogContext } from "./context/index.js";
+export type CategoryMatch = RegExp | string;
+export type ThresholdOverride = [match: CategoryMatch, level: LevelKind];
+export interface LoggingManagerState<Record extends LogRecord> {
+    rootLevel: LevelKind;
+    appenders: Array<Appender<Record>>;
+    thresholdOverrides: Array<ThresholdOverride>;
+}
+export type LoggingManagerOptions<Record extends LogRecord> = Partial<LoggingManagerState<Record>>;
+export declare const kEnvThresholdOverrides: ThresholdOverride[];
+/**
+ * Logging manager
+ */
+export declare class LoggingManager<Record extends LogRecord = any> {
+    private readonly loggers;
+    private readonly state;
+    get rootLevel(): LevelKind;
+    set rootLevel(newRootLevel: LevelKind);
+    get rootThreshold(): number;
+    /**
+     * Get the current handler
+     *
+     * @returns {Appender<Record>}
+     */
+    get appenders(): Array<Appender<Record>>;
+    /**
+     * Global threshold overrides
+     */
+    get thresholdOverrides(): ThresholdOverride[];
+    /**
+     * Update the overrides
+     *
+     * @param newOverrides
+     */
+    set thresholdOverrides(newOverrides: ThresholdOverride[]);
+    /**
+     * Set global appenders
+     *
+     * @param {Array<Appender<Record>>} newAppenders
+     */
+    setAppenders(...newAppenders: Array<Appender<Record> | Appender<Record>[]>): this;
+    /**
+     * Add one or more appenders to existing appender set
+     *
+     * @param {Appender<Record> | Appender<Record>[]} newAppenders
+     * @returns {this<Record>}
+     */
+    addAppenders(...newAppenders: Array<Appender<Record> | Appender<Record>[]>): this;
+    /**
+     * Clear threshold overrides
+     *
+     * @returns {this<Record>}
+     */
+    clearThresholdOverrides(): this;
+    setThresholdOverrides(...overrides: Array<ThresholdOverride>): this;
+    addThresholdOverrides(...overrides: Array<ThresholdOverride>): this;
+    /**
+     * Get applicable current contexts
+     *
+     * @param {string} category
+     * @returns {LogContext[]}
+     */
+    getApplicableCurrentContexts(category: string): LogContext[];
+    /**
+     * Check for any matching threshold overrides
+     *
+     * @param category
+     */
+    determineThresholdOverride(category: string): number;
+    /**
+     * Set the root logging level
+     *
+     * @param {LevelKind} newLevel
+     * @returns {this<Record>}
+     */
+    setRootLevel(newLevel: LevelKind): this;
+    /**
+     * Fire a log event, eventually
+     * invert this by making `Logger` an
+     * `EventEmitter3` and having the `LoggingManager`
+     * subscribe to `record` event
+     *
+     * @param {LogRecord<Record>} record
+     * @internal
+     */
+    fire(record: LogRecord<Record>): void;
+    /**
+     * Get a logger from cache, if the category
+     * does not have an existing logger, then create one.
+     *
+     * @param {string} categoryOrFilename
+     * @param {Partial<LoggerOptions>} inOptions
+     * @returns {Logger}
+     */
+    getLogger(categoryOrFilename: string, inOptions?: Partial<LoggerOptions>): Logger;
+    /**
+     * Configure the logging manager,
+     * this function is additive, so simply calling
+     * `configure` with a single option `rootLevel`,
+     * will not affect other options like `appenders`   *
+     *
+     * @param {LoggingManagerOptions<any>} options
+     * @returns {this<Record>}
+     */
+    configure(options: LoggingManagerOptions<any>): this;
+    private constructor();
+    /**
+     * Singleton instance
+     *
+     * @type {LoggingManager}
+     * @private
+     */
+    private static manager;
+    /**
+     * Get logging manager and optionally provided
+     * configuration options
+     *
+     * @param {LoggingManagerOptions<Record>} options
+     * @returns {LoggingManager<Record>}
+     */
+    static get<Record extends LogRecord = any>(options?: LoggingManagerOptions<Record>): LoggingManager<Record>;
+}
+export declare function getLoggingManager(): LoggingManager;
+//# sourceMappingURL=LoggingManager.d.ts.map

package/lib/logging/LoggingManager.d.ts.map

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