@wireio/shared 1.0.0

package/lib/logging/context/LogContext.d.ts

@@ -0,0 +1,48 @@
+import { Appender } from "../Appender.js";
+import { Level } from "../Level.js";
+export declare class LogContext {
+    readonly appenders: Appender[];
+    /**
+     * Threshold override level
+     *
+     * @type {Level}
+     */
+    readonly thresholdLevel: Level;
+    /**
+     * If specified, only categories that match will
+     * use this context
+     *
+     * @type {RegExp}
+     */
+    readonly pattern: RegExp;
+    /**
+     * Exclusive, only use this config in context.  Defaults to `false`
+     *
+     * @type {boolean}
+     */
+    readonly exclusive: RegExp;
+    /**
+     * Use a logger context within
+     *
+     * @param {() => Promise<T>} fn
+     * @returns {Promise<T>}
+     */
+    use<T = unknown>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Creates a new logger context
+     *
+     * @param {Appender[]} appenders - additional appenders for the context
+     * @param {LoggerContextOptions} options -
+     */
+    protected constructor(appenders: Appender[], options: LoggerContextOptions);
+    /**
+     * Create a new logger context
+     *
+     * @param {Appender[]} appenders
+     * @param {LoggerContextOptions} options
+     * @returns {LogContext}
+     */
+    static with(appenders: Appender[], options?: LoggerContextOptions): LogContext;
+}
+export type LoggerContextOptions = Partial<Pick<LogContext, "pattern" | "exclusive">>;
+//# sourceMappingURL=LogContext.d.ts.map

package/lib/logging/context/LogContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogContext.d.ts","sourceRoot":"","sources":["../../../src/logging/context/LogContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AASnC,qBAAa,UAAU;IAwCnB,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE;IAvChC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAA;IAE9B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B;;;;;OAKG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC;IAIrC;;;;;OAKG;IACH,SAAS,aACE,SAAS,EAAE,QAAQ,EAAE,EAC9B,OAAO,EAAE,oBAAoB;IAU/B;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,OAAO,GAAE,oBAAyB;CAGtE;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,WAAW,CAAC,CAAC,CAAA"}

package/lib/logging/context/LogContext.js

@@ -0,0 +1,58 @@
+import { LogContextContainer } from "./LogContextContainer.js";
+export class LogContext {
+    appenders;
+    /**
+     * Threshold override level
+     *
+     * @type {Level}
+     */
+    thresholdLevel;
+    /**
+     * If specified, only categories that match will
+     * use this context
+     *
+     * @type {RegExp}
+     */
+    pattern;
+    /**
+     * Exclusive, only use this config in context.  Defaults to `false`
+     *
+     * @type {boolean}
+     */
+    exclusive;
+    /**
+     * Use a logger context within
+     *
+     * @param {() => Promise<T>} fn
+     * @returns {Promise<T>}
+     */
+    use(fn) {
+        return LogContextContainer.runInContext(this, fn);
+    }
+    /**
+     * Creates a new logger context
+     *
+     * @param {Appender[]} appenders - additional appenders for the context
+     * @param {LoggerContextOptions} options -
+     */
+    constructor(appenders, options) {
+        this.appenders = appenders;
+        Object.assign(this, {
+            exclusive: false,
+            thresholdLevel: null,
+            pattern: null,
+            ...options
+        });
+    }
+    /**
+     * Create a new logger context
+     *
+     * @param {Appender[]} appenders
+     * @param {LoggerContextOptions} options
+     * @returns {LogContext}
+     */
+    static with(appenders, options = {}) {
+        return new LogContext(appenders, options);
+    }
+}
+//# sourceMappingURL=LogContext.js.map

package/lib/logging/context/LogContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogContext.js","sourceRoot":"","sources":["../../../src/logging/context/LogContext.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAO9D,MAAM,OAAO,UAAU;IAwCV;IAvCX;;;;OAIG;IACM,cAAc,CAAO;IAE9B;;;;;OAKG;IACM,OAAO,CAAQ;IAExB;;;;OAIG;IACM,SAAS,CAAQ;IAE1B;;;;;OAKG;IACH,GAAG,CAAc,EAAoB;QACnC,OAAO,mBAAmB,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACnD,CAAC;IAED;;;;;OAKG;IACH,YACW,SAAqB,EAC9B,OAA6B;QADpB,cAAS,GAAT,SAAS,CAAY;QAG9B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YAClB,SAAS,EAAE,KAAK;YAChB,cAAc,EAAE,IAAI;YACpB,OAAO,EAAE,IAAI;YACb,GAAG,OAAO;SACX,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,SAAqB,EAAE,UAAgC,EAAE;QACnE,OAAO,IAAI,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;CACF"}

package/lib/logging/context/LogContextContainer.d.ts

@@ -0,0 +1,9 @@
+import { LogContext } from "./LogContext.js";
+import { LogContextProvider } from "./LogContextProvider.js";
+export declare namespace LogContextContainer {
+    function setProvider(provider: LogContextProvider): void;
+    function getProvider(): LogContextProvider;
+    function currentContext(): Array<LogContext>;
+    function runInContext<T = unknown>(context: LogContext, fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=LogContextContainer.d.ts.map

package/lib/logging/context/LogContextContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogContextContainer.d.ts","sourceRoot":"","sources":["../../../src/logging/context/LogContextContainer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAA6B,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAOvF,yBAAiB,mBAAmB,CAAE;IAEpC,SAAgB,WAAW,CAAC,QAAQ,EAAE,kBAAkB,QAEvD;IAED,SAAgB,WAAW,IAAG,kBAAkB,CAE/C;IAED,SAAgB,cAAc,IAAI,KAAK,CAAC,UAAU,CAAC,CAElD;IAED,SAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAG/F;CAEF"}

package/lib/logging/context/LogContextContainer.js

@@ -0,0 +1,25 @@
+import { DefaultLogContextProvider } from "./LogContextProvider.js";
+const state = {
+    provider: DefaultLogContextProvider
+};
+export var LogContextContainer;
+(function (LogContextContainer) {
+    function setProvider(provider) {
+        state.provider = provider ?? DefaultLogContextProvider;
+    }
+    LogContextContainer.setProvider = setProvider;
+    function getProvider() {
+        return state.provider ?? DefaultLogContextProvider;
+    }
+    LogContextContainer.getProvider = getProvider;
+    function currentContext() {
+        return getProvider().currentContext?.() ?? [];
+    }
+    LogContextContainer.currentContext = currentContext;
+    function runInContext(context, fn) {
+        const provider = getProvider();
+        return provider.runInContext(context, fn);
+    }
+    LogContextContainer.runInContext = runInContext;
+})(LogContextContainer || (LogContextContainer = {}));
+//# sourceMappingURL=LogContextContainer.js.map

package/lib/logging/context/LogContextContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogContextContainer.js","sourceRoot":"","sources":["../../../src/logging/context/LogContextContainer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAsB,MAAM,yBAAyB,CAAA;AAEvF,MAAM,KAAK,GAAG;IACZ,QAAQ,EAAE,yBAA+C;CAC1D,CAAA;AAGD,MAAM,KAAW,mBAAmB,CAmBnC;AAnBD,WAAiB,mBAAmB;IAElC,SAAgB,WAAW,CAAC,QAA4B;QACtD,KAAK,CAAC,QAAQ,GAAG,QAAQ,IAAI,yBAAyB,CAAA;IACxD,CAAC;IAFe,+BAAW,cAE1B,CAAA;IAED,SAAgB,WAAW;QACzB,OAAO,KAAK,CAAC,QAAQ,IAAI,yBAAyB,CAAA;IACpD,CAAC;IAFe,+BAAW,cAE1B,CAAA;IAED,SAAgB,cAAc;QAC5B,OAAO,WAAW,EAAE,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,CAAA;IAC/C,CAAC;IAFe,kCAAc,iBAE7B,CAAA;IAED,SAAgB,YAAY,CAAc,OAAmB,EAAE,EAAoB;QACjF,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;QAC9B,OAAO,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAC,EAAE,CAAC,CAAA;IAC1C,CAAC;IAHe,gCAAY,eAG3B,CAAA;AAEH,CAAC,EAnBgB,mBAAmB,KAAnB,mBAAmB,QAmBnC"}

package/lib/logging/context/LogContextProvider.d.ts

@@ -0,0 +1,24 @@
+import type { LogContext } from "./LogContext";
+export interface LogContextProvider {
+    /**
+     * Get current context stack
+     *
+     * @returns {any[]}
+     */
+    currentContext(): Array<LogContext>;
+    /**
+     * Run in context
+     *
+     * @param {LogContext} context
+     * @param {() => Promise<T>} fn
+     * @returns {Promise<T>}
+     */
+    runInContext<T = unknown>(context: LogContext, fn: () => Promise<T>): Promise<T>;
+}
+/**
+ * Dummy/Noop context provider
+ *
+ * @type {{currentContext(): Array<LogContext>, runInContext<T=unknown>(context: LogContext, fn: () => Promise<T>): Promise<T>}}
+ */
+export declare const DefaultLogContextProvider: LogContextProvider;
+//# sourceMappingURL=LogContextProvider.d.ts.map

package/lib/logging/context/LogContextProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogContextProvider.d.ts","sourceRoot":"","sources":["../../../src/logging/context/LogContextProvider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAI9C,MAAM,WAAW,kBAAkB;IAEjC;;;;OAIG;IACH,cAAc,IAAI,KAAK,CAAC,UAAU,CAAC,CAAA;IAEnC;;;;;;OAMG;IACH,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACjF;AAGD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAC,kBAWtC,CAAA"}

package/lib/logging/context/LogContextProvider.js

@@ -0,0 +1,18 @@
+// noinspection JSValidateJSDoc
+/**
+ * Dummy/Noop context provider
+ *
+ * @type {{currentContext(): Array<LogContext>, runInContext<T=unknown>(context: LogContext, fn: () => Promise<T>): Promise<T>}}
+ */
+export const DefaultLogContextProvider = {
+    currentContext() {
+        return [];
+    },
+    runInContext(context, fn) {
+        if (process.env.NODE_ENV === "development") {
+            console.warn(`Attempting to use LogContext without any installed provider`);
+        }
+        return fn();
+    }
+};
+//# sourceMappingURL=LogContextProvider.js.map

package/lib/logging/context/LogContextProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogContextProvider.js","sourceRoot":"","sources":["../../../src/logging/context/LogContextProvider.ts"],"names":[],"mappings":"AAAA,+BAA+B;AA0B/B;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAsB;IAC1D,cAAc;QACZ,OAAO,EAAE,CAAA;IACX,CAAC;IACD,YAAY,CAAc,OAAmB,EAAE,EAAoB;QACjE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAA;QAC7E,CAAC;QAED,OAAO,EAAE,EAAE,CAAA;IACb,CAAC;CACF,CAAA"}

package/lib/logging/context/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./LogContext.js";
+export * from "./LogContextProvider.js";
+export * from "./LogContextContainer.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/logging/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/logging/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,0BAA0B,CAAA"}

package/lib/logging/context/index.js

@@ -0,0 +1,4 @@
+export * from "./LogContext.js";
+export * from "./LogContextProvider.js";
+export * from "./LogContextContainer.js";
+//# sourceMappingURL=index.js.map

package/lib/logging/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logging/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,0BAA0B,CAAA"}

package/lib/logging/context/providers/node/NodeContextProvider.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=NodeContextProvider.d.ts.map

package/lib/logging/context/providers/node/NodeContextProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeContextProvider.d.ts","sourceRoot":"","sources":["../../../../../src/logging/context/providers/node/NodeContextProvider.ts"],"names":[],"mappings":"AA4CA,OAAO,EAAE,CAAA"}

package/lib/logging/context/providers/node/NodeContextProvider.js

@@ -0,0 +1,31 @@
+import { AsyncLocalStorage } from "async_hooks";
+import { uniq } from "lodash";
+import { LogContextContainer } from "../../LogContextContainer.js";
+const contextStorage = new AsyncLocalStorage();
+function currentContextStore() {
+    return contextStorage.getStore() ?? [];
+}
+class NodeContextProvider {
+    /**
+     * Get current context stack
+     *
+     * @returns {any[]}
+     */
+    currentContext() {
+        return currentContextStore() ?? [];
+    }
+    /**
+     * Run in context
+     *
+     * @param {LogContext} context
+     * @param {() => Promise<T>} fn
+     * @returns {Promise<T>}
+     */
+    runInContext(context, fn) {
+        const contexts = currentContextStore();
+        return contextStorage.run(uniq([...contexts, context]), fn);
+    }
+}
+const instance = new NodeContextProvider();
+LogContextContainer.setProvider(instance);
+//# sourceMappingURL=NodeContextProvider.js.map

package/lib/logging/context/providers/node/NodeContextProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeContextProvider.js","sourceRoot":"","sources":["../../../../../src/logging/context/providers/node/NodeContextProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAG7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAElE,MAAM,cAAc,GAAG,IAAI,iBAAiB,EAAqB,CAAA;AAEjE,SAAS,mBAAmB;IAC1B,OAAO,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAA;AACxC,CAAC;AAED,MAAM,mBAAmB;IAGvB;;;;OAIG;IACH,cAAc;QACZ,OAAO,mBAAmB,EAAE,IAAI,EAAE,CAAA;IACpC,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CACV,OAAmB,EACnB,EAAoB;QAEpB,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAA;QACtC,OAAO,cAAc,CAAC,GAAG,CAAiB,IAAI,CAAC,CAAC,GAAG,QAAQ,EAAE,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC7E,CAAC;CACF;AAED,MAAM,QAAQ,GAAG,IAAI,mBAAmB,EAAE,CAAA;AAE1C,mBAAmB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA"}

package/lib/logging/context/providers/node/index.d.ts

@@ -0,0 +1,3 @@
+import "./NodeContextProvider.js";
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/logging/context/providers/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/logging/context/providers/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,0BAA0B,CAAA;AAEjC,OAAO,EAAE,CAAA"}

package/lib/logging/context/providers/node/index.js

@@ -0,0 +1,2 @@
+import "./NodeContextProvider.js";
+//# sourceMappingURL=index.js.map

package/lib/logging/context/providers/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/logging/context/providers/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,0BAA0B,CAAA"}

package/lib/logging/examples/example-debug-appender.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=example-debug-appender.d.ts.map

package/lib/logging/examples/example-debug-appender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-debug-appender.d.ts","sourceRoot":"","sources":["../../../src/logging/examples/example-debug-appender.ts"],"names":[],"mappings":""}

package/lib/logging/examples/example-debug-appender.js

@@ -0,0 +1,14 @@
+import { getLogger } from "../getLogger.js";
+import { LevelNames } from "../Level.js";
+import { getLoggingManager } from "../LoggingManager.js";
+getLoggingManager().configure({
+    // Default appenders list is [ConsoleAppender],
+    // so the following is not needed and only
+    // remains as an example:
+    //
+    // appenders: [new ConsoleAppender()],
+    rootLevel: "trace"
+});
+const log = getLogger(__filename);
+LevelNames.forEach((name) => log[name].call(log, `example %s`, name));
+//# sourceMappingURL=example-debug-appender.js.map

package/lib/logging/examples/example-debug-appender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-debug-appender.js","sourceRoot":"","sources":["../../../src/logging/examples/example-debug-appender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAGxD,iBAAiB,EAAE,CAAC,SAAS,CAAC;IAC5B,+CAA+C;IAC/C,0CAA0C;IAC1C,yBAAyB;IACzB,EAAE;IACF,sCAAsC;IACtC,SAAS,EAAE,OAAO;CACnB,CAAC,CAAA;AAEF,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,CAAA;AAEjC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAC1B,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,CACxC,CAAA"}

package/lib/logging/examples/example-file-appender.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=example-file-appender.d.ts.map

package/lib/logging/examples/example-file-appender.d.ts.map

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

package/lib/logging/examples/example-file-appender.js

@@ -0,0 +1,16 @@
+import { FileAppender } from "../appenders/FileAppender.js";
+import { getLogger } from "../getLogger.js";
+import { getLoggingManager } from "../LoggingManager.js";
+async function run() {
+    const manager = getLoggingManager();
+    const fileAppender = new FileAppender({
+        enableRolling: true,
+        maxFiles: 4,
+        maxSize: 20480
+    });
+    manager.setAppenders(fileAppender).setRootLevel("trace");
+    const log = getLogger(__filename);
+    await fileAppender.close();
+}
+run().catch((err) => console.error(`failed`, err));
+//# sourceMappingURL=example-file-appender.js.map

package/lib/logging/examples/example-file-appender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-file-appender.js","sourceRoot":"","sources":["../../../src/logging/examples/example-file-appender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAExD,KAAK,UAAU,GAAG;IAChB,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAA;IACnC,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC;QACpC,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,KAAK;KACf,CAAC,CAAA;IACF,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;IAExD,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,CAAA;IACjC,MAAM,YAAY,CAAC,KAAK,EAAE,CAAA;AAC5B,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAA"}

package/lib/logging/getLogger.d.ts

@@ -0,0 +1,3 @@
+import type { Logger, LoggerOptions } from "./Logger";
+export declare function getLogger(category: string, options?: Partial<LoggerOptions>): Logger;
+//# sourceMappingURL=getLogger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getLogger.d.ts","sourceRoot":"","sources":["../../src/logging/getLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAGrD,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GACnC,MAAM,CAER"}

package/lib/logging/getLogger.js

@@ -0,0 +1,5 @@
+import { getLoggingManager } from "./LoggingManager.js";
+export function getLogger(category, options = {}) {
+    return getLoggingManager().getLogger(category, options);
+}
+//# sourceMappingURL=getLogger.js.map

package/lib/logging/getLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLogger.js","sourceRoot":"","sources":["../../src/logging/getLogger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,UAAU,SAAS,CACvB,QAAgB,EAChB,UAAkC,EAAE;IAEpC,OAAO,iBAAiB,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;AACzD,CAAC"}

package/lib/logging/index-node.d.ts

@@ -0,0 +1,3 @@
+export * from "./index.js";
+export * from "./appenders/FileAppender.js";
+//# sourceMappingURL=index-node.d.ts.map

package/lib/logging/index-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-node.d.ts","sourceRoot":"","sources":["../../src/logging/index-node.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,6BAA6B,CAAA"}

package/lib/logging/index-node.js

@@ -0,0 +1,3 @@
+export * from "./index.js";
+export * from "./appenders/FileAppender.js";
+//# sourceMappingURL=index-node.js.map

package/lib/logging/index-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-node.js","sourceRoot":"","sources":["../../src/logging/index-node.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,6BAA6B,CAAA"}

package/lib/logging/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./Appender.js";
+export * from "./Formatter.js";
+export * from "./Level.js";
+export * from "./LogRecord.js";
+export * from "./Logger.js";
+export * from "./LoggingManager.js";
+export * from "./appenders/index.js";
+export * from "./getLogger.js";
+export * from "./util.js";
+export * from "./context/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA"}

package/lib/logging/index.js

@@ -0,0 +1,11 @@
+export * from "./Appender.js";
+export * from "./Formatter.js";
+export * from "./Level.js";
+export * from "./LogRecord.js";
+export * from "./Logger.js";
+export * from "./LoggingManager.js";
+export * from "./appenders/index.js";
+export * from "./getLogger.js";
+export * from "./util.js";
+export * from "./context/index.js";
+//# sourceMappingURL=index.js.map

package/lib/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA"}

package/lib/logging/util.d.ts

@@ -0,0 +1,3 @@
+import { LevelKind } from "./Level.js";
+export declare function isLogLevelKind(o: any): o is LevelKind;
+//# sourceMappingURL=util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/logging/util.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAc,MAAM,YAAY,CAAA;AAElD,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,SAAS,CAErD"}

package/lib/logging/util.js

@@ -0,0 +1,6 @@
+import { isString } from "../guards/primitive.js";
+import { LevelNames } from "./Level.js";
+export function isLogLevelKind(o) {
+    return isString(o) && LevelNames.includes(o?.toLowerCase?.());
+}
+//# sourceMappingURL=util.js.map

package/lib/logging/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/logging/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACjD,OAAO,EAAa,UAAU,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,UAAU,cAAc,CAAC,CAAM;IACnC,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,WAAW,EAAE,EAAS,CAAC,CAAA;AACtE,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@wireio/shared",
+  "version": "1.0.0",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "types": "lib/index.d.ts",
+  "module": "lib/index.js",
+  "access": "public",
+  "devDependencies": {
+    "@types/lodash": "4.17.23",
+    "@types/node": "^22.15.3",
+    "typescript": "5.9.2"
+  },
+  "dependencies": {
+    "@aws-sdk/client-firehose": "3.972.0",
+    "@aws-sdk/client-sts": "3.972.0",
+    "bluebird": "3.7.2",
+    "debug": "^4.3.4",
+    "eventemitter3": "^5.0.4",
+    "lodash": "^4.17.21",
+    "prelude-ts": "^1.0.6",
+    "tracer": "^1.3.0"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "build:dev": "tsc -b tsconfig.json -w"
+  }
+}

package/src/guards/applyTypeGuardExtras.ts

@@ -0,0 +1,9 @@
+import type { TypeGuard, TypeGuardExtras } from "./types"
+
+
+export function applyTypeGuardExtras<T>(fn:TypeGuard<T>):TypeGuardExtras<T> {
+  (
+    fn as TypeGuardExtras<T>
+  ).lift = (o:any) => () => fn(o)
+  return fn as TypeGuardExtras<T>
+}

package/src/guards/array.ts

@@ -0,0 +1,5 @@
+export function isArray(
+  o: unknown
+): o is Array<typeof o extends Array<infer T> ? T : any> {
+  return Array.isArray(o)
+}

package/src/guards/assert.ts

@@ -0,0 +1,83 @@
+import { isFunction, isString } from "./primitive.js"
+
+export interface AssertOptions {
+  logErrorsToConsole: boolean
+}
+
+export const DefaultAssertOptions:AssertOptions = {
+  logErrorsToConsole: false
+}
+
+let assertOptions:AssertOptions = {...DefaultAssertOptions}
+
+export function getAssertOptions() {
+  return {...assertOptions}
+}
+
+export function setGlobalAssertOptions(options: AssertOptions) {
+  assertOptions = {...assertOptions, ...options}
+}
+
+export class AssertError extends Error {
+  
+  
+  
+  constructor(message: string,  public readonly cause?: Error) {
+    super(message)
+  }
+}
+
+
+const assertLift:AssertLift = <T>(test: (value:T) => boolean, messageProvider: string | ((value: T) => string)) => {
+  return (nextValue: T) => {
+    const ok = test(nextValue)
+    if (!ok) {
+      const message = isFunction(messageProvider) ? messageProvider(nextValue) : messageProvider ?? "no message"
+      throw new AssertError(message)
+    }
+  }
+}
+
+export type AssertLift = <T>(test: (value:T) => boolean, message: string | ((value: T) => string)) =>
+  (nextValue: T) => void | never
+
+export interface Assert {
+  (
+    test: (() => boolean) | boolean,
+    msg?: null | ((err?: Error) => Error | string) | Error | string | undefined,
+    overrideOptions?: Partial<AssertOptions>
+  ): void | never
+  
+  lift: AssertLift
+}
+
+
+export const assert: Assert = Object.assign((
+  test: (() => boolean) | boolean,
+  msg?: null | ((err?: Error) => Error | string) | Error | string | undefined,
+  overrideOptions: Partial<AssertOptions> = {}
+): void | never => {
+  const options = {...assertOptions, ...overrideOptions}
+  let result: boolean = false
+  let error: Error = undefined
+  
+  try {
+    result = isFunction(test) ? test() : test
+  } catch (err) {
+    error = err
+    if (options.logErrorsToConsole) {
+      console.error(`Assert failed: "${test}"`, err)
+    }
+  }
+  
+  if (!result || !!error) {
+    const errOut = !msg ? (error?.message ?? "unknown") :
+      isFunction(msg) ? msg(error) :
+        msg
+    throw isString(errOut) ? new AssertError(errOut, error) : errOut
+  }
+}, {
+  lift: assertLift
+})
+
+

package/src/guards/class.ts

@@ -0,0 +1,56 @@
+/**
+ * Is ES6+ class
+ *
+ * @see https://stackoverflow.com/questions/29093396/how-do-you-check-the-difference-between-an-ecmascript-6-class-and-function/49510834
+ *
+ * @param {any} value
+ * @returns {boolean}
+ */
+import type { ClassConstructor, TypeGuard } from "./types"
+
+export function isNativeClass <T = any>(value:any): value is ClassConstructor<T> {
+  return typeof value === 'function' && value.toString().indexOf('class') === 0
+}
+
+// Character positions
+const INDEX_OF_FUNCTION_NAME = 9  // "function X", X is at index 9
+const FIRST_UPPERCASE_INDEX_IN_ASCII = 65  // A is at index 65 in ASCII
+const LAST_UPPERCASE_INDEX_IN_ASCII = 90   // Z is at index 90 in ASCII
+
+/**
+ * Is Conventional Class
+ * Looks for function with capital first letter MyClass
+ * First letter is the 9th character
+ * If changed, isClass must also be updated
+ * @param {any} value
+ * @returns {boolean}
+ */
+export function isConventionalClass <T = any>(value:any): value is ClassConstructor<T> {
+  if ( typeof value !== 'function' )  return false
+  const c = value.toString().charCodeAt(INDEX_OF_FUNCTION_NAME)
+  return c >= FIRST_UPPERCASE_INDEX_IN_ASCII && c <= LAST_UPPERCASE_INDEX_IN_ASCII
+}
+
+
+export function isClass<T = any>(value: any, includeConventional: boolean = true): value is ClassConstructor<T> {
+  return isNativeClass<T>(value) || (includeConventional && isConventionalClass<T>(value))
+}
+
+
+
+
+
+export function createInstanceOfGuard<T, Ctor extends ClassConstructor<T>>(ctor: Ctor): ((o: any) => o is T) {
+  return (o: any): o is T => o instanceof ctor
+}
+
+export function instanceOf<T extends {}, Ctor extends ClassConstructor<T>>(ctor: Ctor) {
+  return createInstanceOfGuard<T,Ctor>(ctor)
+} 
+
+export function createGenericGuard<T>(tester: (val:any) => val is T):TypeGuard<T>
+export function createGenericGuard<T>(type:{new():T}, tester: (val:any) => val is T):TypeGuard<T>
+export function createGenericGuard<T>(typeOrTest: ({new():T} | ((val:any) => val is T)), tester?: (val:any) => val is T) {
+  return tester as TypeGuard<T>
+}
+