@niceties/logger 1.0.4 → 1.1.2

package/README.md

@@ -12,12 +12,6 @@ Experimental logger/reporter for async tasks.
 
 # Installation
 
-```
-yarn add @niceties/logger
-```
-
-or
-
 ```
 npm install --save @niceties/logger
 ```
@@ -47,11 +41,11 @@ try {
 Logger factory:
 
 ```typescript
-function createLogger<ErrorContext = Error>(...args: [] | [string | Identity] | [string, Identity]): ((message: string, loglevel?: LogLevel, context?: ErrorContext | undefined) => void) & {
-    start(message: string, loglevel?: LogLevel | undefined): void;
-    update(message: string, loglevel?: LogLevel | undefined): void;
-    finish(message: string, loglevel?: LogLevel | undefined): void;
-    withAppender(appender: Appender<ErrorContext>): ((message: string, loglevel?: LogLevel, context?: ErrorContext | undefined) => void) & any;
+function createLogger<ErrorContext = Error>(...args: [] | [string | Identity | undefined] | [string, Identity]): ((message: string, loglevel?: LogLevel, context?: ErrorContext | undefined) => void) & {
+    start(message: string, loglevel?: LogLevel | undefined, context?: ErrorContext | undefined): void;
+    update(message: string, loglevel?: LogLevel | undefined, context?: ErrorContext | undefined): void;
+    finish(message: string, loglevel?: LogLevel | undefined, context?: ErrorContext | undefined): void;
+    appender(appender?: Appender<ErrorContext> | undefined): (message: LogMessage<ErrorContext>) => void;
 };
 ```
 
@@ -91,36 +85,36 @@ try {
 ```
 
 ```typescript
-start(message: string, loglevel?: LogLevel | undefined): void;
+start(message: string, loglevel?: LogLevel | undefined, context?: ErrorContext | undefined): void;
 ```
 
 Emits start event inside a logger. If loglevel provided it will be remembered and used as default loglevel in subsequent events in the same logger instance. Default loglevel (if argument is not provided) is `info`.
 
 ```typescript
-update(message: string, loglevel?: LogLevel | undefined): void;
+update(message: string, loglevel?: LogLevel | undefined, context?: ErrorContext | undefined): void;
 ```
 
 Emits update event. Can be used to inform user that we are doing something else in the same async task. loglevel used to redefine default loglevel.
 
 ```typescript
-finish(message: string, loglevel?: LogLevel | undefined): void;
+finish(message: string, loglevel?: LogLevel | undefined, context?: ErrorContext | undefined): void;
 ```
 
 Emits finish event. Can be used to inform user that task finished. loglevel is optional and equals initial loglevel if omitted.
 
 ```typescript
-const log = createLogger()
-                .withAppender(someFancyAppender);
+const logger = createLogger();
+logger.appender(someFancyAppender);
 ```
 
-Adds new appender for the specific inctance of logger. It is not mandatory to use the return value because no new instance of logger created and appender added to the existing instance.
+Sets different appender for the specific instance of the logger.
 
 ```typescript
-const log = createLogger()
-                .withFilter(predicate);
+const logger = createLogger();
+const appender = logger.appender();
 ```
 
-Install filter on previosly installed appenders. It is not mandatory to use the return value because no new instance of logger created and filter added to the existing instance.
+Returns current appender for the specific instance of the logger.
 
 ## Log levels
 
@@ -226,20 +220,28 @@ Default subpackage `'@niceties/logger'` exports types, `createLogger()` factory
 
 Subpackage `'@niceties/logger/default-formatting'` exports formatting constants that is part of default configuration of the console appender.
 
-Subpackage `'@niceties/logger/core'` exports `createLogger()` factory and `appender()`, `combineAppenders()`, `filterMessages()` functions.
+Subpackage `'@niceties/logger/core'` exports `createLogger()` factory.
 
-Subpackage `'@niceties/logger/simple'` exports `createLogger()` factory and `appender()`, `combineAppenders()`, `filterMessages()` function.
+Subpackage `'@niceties/logger/simple'` exports `createLogger()` factory.
 
 Subpackage `'@niceties/logger/console-appender'` exports `createConsoleAppender()` factory.
 
 Subpackage `'@niceties/logger/format-utils'` exports `createFormatter()` and `terminalSupportsUnicode()` functions.
 
+Subpackage `'@niceties/logger/global-appender'` exports `appender()` and `globalAppender`.
+
+Subpackage `'@niceties/logger/appender-utils'` exports `combineAppenders()` and `filterMessages()`.
+
 `simple` (default), `core` and `console-appender` exists as umd packages as well but probably require some effort to consume them.
 
 # Prior art
 
 - [loglevel](https://github.com/pimterry/loglevel)
+- [winston](https://github.com/winstonjs/winston)
+- [node-bunyan](https://github.com/trentm/node-bunyan)
+- [log4js](https://github.com/log4js-node/log4js-node)
+- [pino](https://github.com/pinojs/pino)
 
 # License
 
-[MIT](./LICENSE)
+[MIT](./LICENSE)

package/appender-utils/package.json

@@ -0,0 +1,3 @@
+{
+    "types": "../dist/appender-utils.d.ts"
+}

package/dist/appender-utils.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const filterMessages = (predicate, appender, api) => {
+    return Object.assign(function (logMessage) {
+        if (predicate(logMessage)) {
+            appender(logMessage);
+        }
+    }, api);
+};
+const combineAppenders = (...appenders) => {
+    return (message) => {
+        for (const appender of appenders) {
+            try {
+                appender(message);
+            }
+            catch (e) { /* eat the error */ }
+        }
+    };
+};
+
+exports.combineAppenders = combineAppenders;
+exports.filterMessages = filterMessages;

package/dist/appender-utils.d.ts

@@ -1,3 +1,3 @@
 import { Appender, LogMessage } from './types';
-export declare function filterMessages<ErrorContext = Error>(predicate: (logMessage: LogMessage<ErrorContext>) => boolean, appender: Appender<ErrorContext>): Appender<ErrorContext>;
-export declare function combineAppenders<ErrorContext = Error>(...appenders: Appender<ErrorContext>[]): Appender<ErrorContext>;
+export declare const filterMessages: <ErrorContext = Error, Api extends object = object>(predicate: (logMessage: LogMessage<ErrorContext>) => boolean, appender: Appender<ErrorContext>, api?: Api | undefined) => Appender<ErrorContext> & Api;
+export declare const combineAppenders: <ErrorContext = Error>(...appenders: Appender<ErrorContext>[]) => Appender<ErrorContext>;

package/dist/appender-utils.mjs

@@ -0,0 +1,19 @@
+const filterMessages = (predicate, appender, api) => {
+    return Object.assign(function (logMessage) {
+        if (predicate(logMessage)) {
+            appender(logMessage);
+        }
+    }, api);
+};
+const combineAppenders = (...appenders) => {
+    return (message) => {
+        for (const appender of appenders) {
+            try {
+                appender(message);
+            }
+            catch (e) { /* eat the error */ }
+        }
+    };
+};
+
+export { combineAppenders, filterMessages };

package/dist/appender-utils.umd.js

@@ -0,0 +1,2 @@
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).nicetiesLoggerAppenderUtils={})}(this,(function(e){"use strict";e.combineAppenders=(...e)=>t=>{for(const o of e)try{o(t)}catch(e){}},e.filterMessages=(e,t,o)=>Object.assign((function(o){e(o)&&t(o)}),o),Object.defineProperty(e,"__esModule",{value:!0})}));
+//# sourceMappingURL=appender-utils.umd.js.map

package/dist/appender-utils.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appender-utils.umd.js","sources":["../src/appender-utils.ts"],"sourcesContent":["import { Appender, LogMessage } from './types';\n\nexport const filterMessages = <ErrorContext = Error, Api extends object = object>(predicate: (logMessage: LogMessage<ErrorContext>) => boolean, appender: Appender<ErrorContext>, api?: Api): Appender<ErrorContext> & Api => {\n    return Object.assign(function(logMessage: LogMessage<ErrorContext>) {\n        if (predicate(logMessage)) {\n            appender(logMessage);\n        }\n    }, api);\n};\n\nexport const combineAppenders = <ErrorContext = Error>(...appenders: Appender<ErrorContext>[]): Appender<ErrorContext> => {\n    return (message: LogMessage<ErrorContext>) => {\n        for(const appender of appenders) {\n            try {\n                appender(message);\n            } catch(e) { /* eat the error */ }\n        }\n    };\n};\n"],"names":["appenders","message","appender","e","predicate","api","Object","assign","logMessage"],"mappings":"sRAUgC,IAA0BA,IAC9CC,IACJ,IAAI,MAAMC,KAAYF,EAClB,IACIE,EAASD,GACX,MAAME,uBAbU,CAAoDC,EAA8DF,EAAkCG,IACvKC,OAAOC,QAAO,SAASC,GACtBJ,EAAUI,IACVN,EAASM,KAEdH"}

package/dist/console-appender.cjs

@@ -2,10 +2,10 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-function createConsoleAppender(formatter) {
-    return function consoleAppender({ loglevel, action, message }) {
-        console.log(formatter(message, loglevel, action === 2 /* finish */));
+const createConsoleAppender = (formatter) => {
+    return (message) => {
+        console.log(formatter(message, message.action === 2 /* finish */));
     };
-}
+};
 
 exports.createConsoleAppender = createConsoleAppender;

package/dist/console-appender.d.ts

@@ -1,2 +1,2 @@
 import { Formatter, LogMessage } from './types';
-export declare function createConsoleAppender(formatter: Formatter): ({ loglevel, action, message }: LogMessage) => void;
+export declare const createConsoleAppender: (formatter: Formatter) => (message: LogMessage) => void;

package/dist/console-appender.mjs

@@ -1,7 +1,7 @@
-function createConsoleAppender(formatter) {
-    return function consoleAppender({ loglevel, action, message }) {
-        console.log(formatter(message, loglevel, action === 2 /* finish */));
+const createConsoleAppender = (formatter) => {
+    return (message) => {
+        console.log(formatter(message, message.action === 2 /* finish */));
     };
-}
+};
 
 export { createConsoleAppender };

package/dist/console-appender.umd.js

@@ -1,2 +1,2 @@
-!function(e,o){"object"==typeof exports&&"undefined"!=typeof module?o(exports):"function"==typeof define&&define.amd?define(["exports"],o):o((e="undefined"!=typeof globalThis?globalThis:e||self).nicetiesLoggerConsoleAppender={})}(this,(function(e){"use strict";e.createConsoleAppender=function(e){return function({loglevel:o,action:n,message:t}){console.log(e(t,o,2===n))}},Object.defineProperty(e,"__esModule",{value:!0})}));
+!function(e,o){"object"==typeof exports&&"undefined"!=typeof module?o(exports):"function"==typeof define&&define.amd?define(["exports"],o):o((e="undefined"!=typeof globalThis?globalThis:e||self).nicetiesLoggerConsoleAppender={})}(this,(function(e){"use strict";e.createConsoleAppender=e=>o=>{console.log(e(o,2===o.action))},Object.defineProperty(e,"__esModule",{value:!0})}));
 //# sourceMappingURL=console-appender.umd.js.map

package/dist/console-appender.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"console-appender.umd.js","sources":["../src/console-appender.ts"],"sourcesContent":["import { Action, Formatter, LogMessage } from './types';\n\nexport function createConsoleAppender(formatter: Formatter) {\n    return function consoleAppender({loglevel, action, message}: LogMessage) {\n        console.log(formatter(message, loglevel, action === Action.finish));\n    };\n}\n"],"names":["formatter","loglevel","action","message","console","log"],"mappings":"sSAEsCA,GAClC,OAAO,UAAyBC,SAACA,EAAQC,OAAEA,EAAMC,QAAEA,IAC/CC,QAAQC,IAAIL,EAAUG,EAASF,MAAUC"}
+{"version":3,"file":"console-appender.umd.js","sources":["../src/console-appender.ts"],"sourcesContent":["import { Action, Formatter, LogMessage } from './types';\n\nexport const createConsoleAppender = (formatter: Formatter) => {\n    return (message: LogMessage) => {\n        console.log(formatter(message, message.action === Action.finish));\n    };\n};\n"],"names":["formatter","message","console","log","action"],"mappings":"6RAEsCA,GAC1BC,IACJC,QAAQC,IAAIH,EAAUC,MAASA,EAAQG"}

package/dist/core.cjs

@@ -5,36 +5,63 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var globalAppender = require('./global-appender.cjs');
 
 let globalInputId = 0;
-function createLogger(...args) {
+const getOptions = (options) => {
+    var _a, _b;
+    let parentId, tag;
+    if (options.length === 1) {
+        if (typeof options[0] === 'string') {
+            tag = options[0];
+        }
+        else {
+            parentId = (_a = options[0]) === null || _a === void 0 ? void 0 : _a.id;
+        }
+    }
+    else if (options.length === 2) {
+        tag = options[0];
+        parentId = (_b = options[1]) === null || _b === void 0 ? void 0 : _b.id;
+    }
+    return { parentId, tag };
+};
+const createLogger = (...args) => {
     let initialLogLevel = 1 /* info */;
+    let myAppender = (message) => { globalAppender.globalAppender && globalAppender.globalAppender(message); };
     const inputId = globalInputId++;
     const { tag, parentId } = getOptions(args);
-    let myAppender = (message) => { globalAppender.globalAppender && globalAppender.globalAppender(message); };
-    const loggerInstance = Object.assign(function log(message, loglevel = 1 /* info */, context) {
+    const append = (message, action, loglevel, context) => {
+        myAppender && myAppender({
+            action,
+            inputId,
+            message,
+            loglevel,
+            tag,
+            parentId,
+            ref,
+            context
+        });
+    };
+    const loggerInstance = Object.assign((message, loglevel = 1 /* info */, context) => {
         append(message, 3 /* log */, loglevel, context);
     }, {
         // Fine to be started multiple times
-        start(message, loglevel) {
+        start(message, loglevel, context) {
             if (loglevel !== undefined) {
                 initialLogLevel = loglevel;
             }
-            append(message, 0 /* start */, initialLogLevel);
+            append(message, 0 /* start */, initialLogLevel, context);
         },
         // Fine to be updated multiple times
-        update(message, loglevel) {
-            append(message, 1 /* update */, loglevel !== null && loglevel !== void 0 ? loglevel : initialLogLevel);
+        update(message, loglevel, context) {
+            append(message, 1 /* update */, loglevel !== null && loglevel !== void 0 ? loglevel : initialLogLevel, context);
         },
         // Fine to be finished multiple times
-        finish(message, loglevel) {
-            append(message, 2 /* finish */, loglevel !== null && loglevel !== void 0 ? loglevel : initialLogLevel);
-        },
-        withFilter(predicate) {
-            myAppender = globalAppender.filterMessages(predicate, myAppender);
-            return loggerInstance;
+        finish(message, loglevel, context) {
+            append(message, 2 /* finish */, loglevel !== null && loglevel !== void 0 ? loglevel : initialLogLevel, context);
         },
-        withAppender(appender) {
-            myAppender = globalAppender.combineAppenders(myAppender, appender);
-            return loggerInstance;
+        appender(appender) {
+            if (appender !== undefined) {
+                myAppender = appender;
+            }
+            return myAppender;
         }
     });
     Object.defineProperty(loggerInstance, 'id', {
@@ -43,38 +70,6 @@ function createLogger(...args) {
     });
     const ref = new WeakRef(loggerInstance);
     return loggerInstance;
-    function append(message, action, loglevel, context) {
-        myAppender({
-            action,
-            inputId,
-            message,
-            loglevel,
-            tag,
-            parentId,
-            ref,
-            context
-        });
-    }
-}
-function getOptions(options) {
-    var _a, _b;
-    let parentId, tag;
-    if (options.length === 1) {
-        if (typeof options[0] === 'string') {
-            tag = options[0];
-        }
-        else {
-            parentId = (_a = options[0]) === null || _a === void 0 ? void 0 : _a.id;
-        }
-    }
-    else if (options.length === 2) {
-        tag = options[0];
-        parentId = (_b = options[1]) === null || _b === void 0 ? void 0 : _b.id;
-    }
-    return { parentId, tag };
-}
+};
 
-exports.appender = globalAppender.appender;
-exports.combineAppenders = globalAppender.combineAppenders;
-exports.filterMessages = globalAppender.filterMessages;
 exports.createLogger = createLogger;

package/dist/core.d.ts

@@ -1,11 +1,7 @@
-import { combineAppenders, filterMessages } from './appender-utils';
-import { appender } from './details/global-appender';
 import { Appender, LogLevel, LogMessage, Identity } from './types';
-export declare function createLogger<ErrorContext = Error>(...args: [] | [string | Identity | undefined] | [string, Identity]): ((message: string, loglevel?: LogLevel, context?: ErrorContext | undefined) => void) & {
-    start(message: string, loglevel?: LogLevel | undefined): void;
-    update(message: string, loglevel?: LogLevel | undefined): void;
-    finish(message: string, loglevel?: LogLevel | undefined): void;
-    withFilter(predicate: (logMessage: LogMessage<ErrorContext>) => boolean): ((message: string, loglevel?: LogLevel, context?: ErrorContext | undefined) => void) & any;
-    withAppender(appender: Appender<ErrorContext>): ((message: string, loglevel?: LogLevel, context?: ErrorContext | undefined) => void) & any;
+export declare const createLogger: <ErrorContext = Error>(...args: [] | [string | Identity | undefined] | [string, Identity]) => ((message: string, loglevel?: LogLevel, context?: ErrorContext | undefined) => void) & {
+    start(message: string, loglevel?: LogLevel | undefined, context?: ErrorContext | undefined): void;
+    update(message: string, loglevel?: LogLevel | undefined, context?: ErrorContext | undefined): void;
+    finish(message: string, loglevel?: LogLevel | undefined, context?: ErrorContext | undefined): void;
+    appender(appender?: Appender<ErrorContext> | undefined): (message: LogMessage<ErrorContext>) => void;
 };
-export { appender, combineAppenders, filterMessages };

package/dist/core.mjs

@@ -1,37 +1,63 @@
-import { g as globalAppender, f as filterMessages, c as combineAppenders } from './global-appender.mjs';
-export { a as appender, c as combineAppenders, f as filterMessages } from './global-appender.mjs';
+import { globalAppender } from './global-appender.mjs';
 
 let globalInputId = 0;
-function createLogger(...args) {
+const getOptions = (options) => {
+    var _a, _b;
+    let parentId, tag;
+    if (options.length === 1) {
+        if (typeof options[0] === 'string') {
+            tag = options[0];
+        }
+        else {
+            parentId = (_a = options[0]) === null || _a === void 0 ? void 0 : _a.id;
+        }
+    }
+    else if (options.length === 2) {
+        tag = options[0];
+        parentId = (_b = options[1]) === null || _b === void 0 ? void 0 : _b.id;
+    }
+    return { parentId, tag };
+};
+const createLogger = (...args) => {
     let initialLogLevel = 1 /* info */;
+    let myAppender = (message) => { globalAppender && globalAppender(message); };
     const inputId = globalInputId++;
     const { tag, parentId } = getOptions(args);
-    let myAppender = (message) => { globalAppender && globalAppender(message); };
-    const loggerInstance = Object.assign(function log(message, loglevel = 1 /* info */, context) {
+    const append = (message, action, loglevel, context) => {
+        myAppender && myAppender({
+            action,
+            inputId,
+            message,
+            loglevel,
+            tag,
+            parentId,
+            ref,
+            context
+        });
+    };
+    const loggerInstance = Object.assign((message, loglevel = 1 /* info */, context) => {
         append(message, 3 /* log */, loglevel, context);
     }, {
         // Fine to be started multiple times
-        start(message, loglevel) {
+        start(message, loglevel, context) {
             if (loglevel !== undefined) {
                 initialLogLevel = loglevel;
             }
-            append(message, 0 /* start */, initialLogLevel);
+            append(message, 0 /* start */, initialLogLevel, context);
         },
         // Fine to be updated multiple times
-        update(message, loglevel) {
-            append(message, 1 /* update */, loglevel !== null && loglevel !== void 0 ? loglevel : initialLogLevel);
+        update(message, loglevel, context) {
+            append(message, 1 /* update */, loglevel !== null && loglevel !== void 0 ? loglevel : initialLogLevel, context);
         },
         // Fine to be finished multiple times
-        finish(message, loglevel) {
-            append(message, 2 /* finish */, loglevel !== null && loglevel !== void 0 ? loglevel : initialLogLevel);
-        },
-        withFilter(predicate) {
-            myAppender = filterMessages(predicate, myAppender);
-            return loggerInstance;
+        finish(message, loglevel, context) {
+            append(message, 2 /* finish */, loglevel !== null && loglevel !== void 0 ? loglevel : initialLogLevel, context);
         },
-        withAppender(appender) {
-            myAppender = combineAppenders(myAppender, appender);
-            return loggerInstance;
+        appender(appender) {
+            if (appender !== undefined) {
+                myAppender = appender;
+            }
+            return myAppender;
         }
     });
     Object.defineProperty(loggerInstance, 'id', {
@@ -40,35 +66,6 @@ function createLogger(...args) {
     });
     const ref = new WeakRef(loggerInstance);
     return loggerInstance;
-    function append(message, action, loglevel, context) {
-        myAppender({
-            action,
-            inputId,
-            message,
-            loglevel,
-            tag,
-            parentId,
-            ref,
-            context
-        });
-    }
-}
-function getOptions(options) {
-    var _a, _b;
-    let parentId, tag;
-    if (options.length === 1) {
-        if (typeof options[0] === 'string') {
-            tag = options[0];
-        }
-        else {
-            parentId = (_a = options[0]) === null || _a === void 0 ? void 0 : _a.id;
-        }
-    }
-    else if (options.length === 2) {
-        tag = options[0];
-        parentId = (_b = options[1]) === null || _b === void 0 ? void 0 : _b.id;
-    }
-    return { parentId, tag };
-}
+};
 
 export { createLogger };

package/dist/core.umd.js

@@ -1,2 +1,2 @@
-!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).nicetiesLoggerCore={})}(this,(function(t){"use strict";function e(t,e){return function(n){t(n)&&e(n)}}function n(...t){return e=>{for(const n of t)try{n(e)}catch(t){}}}let o;let i=0;t.appender=function(t){return void 0!==t&&(o=t),o},t.combineAppenders=n,t.createLogger=function(...t){let u=1;const f=i++,{tag:l,parentId:r}=function(t){var e,n;let o,i;1===t.length?"string"==typeof t[0]?i=t[0]:o=null===(e=t[0])||void 0===e?void 0:e.id:2===t.length&&(i=t[0],o=null===(n=t[1])||void 0===n?void 0:n.id);return{parentId:o,tag:i}}(t);let c=t=>{o&&o(t)};const d=Object.assign((function(t,e=1,n){a(t,3,e,n)}),{start(t,e){void 0!==e&&(u=e),a(t,0,u)},update(t,e){a(t,1,null!=e?e:u)},finish(t,e){a(t,2,null!=e?e:u)},withFilter:t=>(c=e(t,c),d),withAppender:t=>(c=n(c,t),d)});Object.defineProperty(d,"id",{value:f,writable:!1});const s=new WeakRef(d);return d;function a(t,e,n,o){c({action:e,inputId:f,message:t,loglevel:n,tag:l,parentId:r,ref:s,context:o})}},t.filterMessages=e,Object.defineProperty(t,"__esModule",{value:!0})}));
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("./global-appender")):"function"==typeof define&&define.amd?define(["exports","./global-appender"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).nicetiesLoggerCore={},e.nicetiesLoggerGlobalAppender)}(this,(function(e,t){"use strict";let n=0;e.createLogger=(...e)=>{let o=1,l=e=>{t.globalAppender&&t.globalAppender(e)};const i=n++,{tag:d,parentId:a}=(e=>{var t,n;let o,l;return 1===e.length?"string"==typeof e[0]?l=e[0]:o=null===(t=e[0])||void 0===t?void 0:t.id:2===e.length&&(l=e[0],o=null===(n=e[1])||void 0===n?void 0:n.id),{parentId:o,tag:l}})(e),r=(e,t,n,o)=>{l&&l({action:t,inputId:i,message:e,loglevel:n,tag:d,parentId:a,ref:u,context:o})},p=Object.assign(((e,t=1,n)=>{r(e,3,t,n)}),{start(e,t,n){void 0!==t&&(o=t),r(e,0,o,n)},update(e,t,n){r(e,1,null!=t?t:o,n)},finish(e,t,n){r(e,2,null!=t?t:o,n)},appender:e=>(void 0!==e&&(l=e),l)});Object.defineProperty(p,"id",{value:i,writable:!1});const u=new WeakRef(p);return p},Object.defineProperty(e,"__esModule",{value:!0})}));
 //# sourceMappingURL=core.umd.js.map

package/dist/core.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.umd.js","sources":["../src/appender-utils.ts","../src/details/global-appender.ts","../src/core.ts"],"sourcesContent":["import { Appender, LogMessage } from './types';\n\nexport function filterMessages<ErrorContext = Error>(predicate: (logMessage: LogMessage<ErrorContext>) => boolean, appender: Appender<ErrorContext> ): Appender<ErrorContext> {\n    return function(logMessage: LogMessage<ErrorContext>) {\n        if (predicate(logMessage)) {\n            appender(logMessage);\n        }\n    };\n}\n\nexport function combineAppenders<ErrorContext = Error>(...appenders: Appender<ErrorContext>[]): Appender<ErrorContext> {\n    return (message: LogMessage<ErrorContext>) => {\n        for(const appender of appenders) {\n            try {\n                appender(message);\n            } catch(e) { /* eat the error */ }\n        }\n    };\n}","import { Appender } from '../types';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport let globalAppender: Appender<any>;\n\nexport function appender<ErrorContext = Error>(appender?: Appender<ErrorContext>) {\n    if (appender !== undefined) {\n        globalAppender = appender;\n    }\n    return globalAppender;\n}\n","import { combineAppenders, filterMessages } from './appender-utils';\nimport { globalAppender, appender } from './details/global-appender';\nimport { Action, Appender, LogLevel, LogMessage, Identity } from './types';\n\nlet globalInputId = 0;\n\nexport function createLogger<ErrorContext = Error>(...args: [] | [string | Identity | undefined] | [string, Identity]) {\n    let initialLogLevel: number = LogLevel.info;\n    \n    const inputId = globalInputId++;\n    \n    const { tag, parentId } = getOptions(args);\n    \n    let myAppender = (message: LogMessage<ErrorContext>) => { globalAppender && globalAppender(message); };\n\n    const loggerInstance = Object.assign(\n        function log(message: string, loglevel: LogLevel = LogLevel.info, context?: ErrorContext) {\n            append(message, Action.log, loglevel, context);\n        }, {\n            // Fine to be started multiple times\n            start(message: string, loglevel?: LogLevel) {\n                if (loglevel !== undefined) {\n                    initialLogLevel = loglevel;\n                }\n                append(message, Action.start, initialLogLevel);\n            },\n            // Fine to be updated multiple times\n            update(message: string, loglevel?: LogLevel) {\n                append(message, Action.update, loglevel ?? initialLogLevel);\n            },\n            // Fine to be finished multiple times\n            finish(message: string, loglevel?: LogLevel) {\n                append(message, Action.finish, loglevel ?? initialLogLevel);\n            },\n            withFilter(predicate: (logMessage: LogMessage<ErrorContext>) => boolean) {\n                myAppender = filterMessages(predicate, myAppender);\n                return loggerInstance;\n            },\n            withAppender(appender: Appender<ErrorContext>) {\n                myAppender = combineAppenders(myAppender, appender);\n                return loggerInstance;\n            }\n        }\n    );\n\n    Object.defineProperty(loggerInstance, 'id', {\n        value: inputId,\n        writable: false\n    });\n\n    const ref = new WeakRef(loggerInstance);\n\n    return loggerInstance;\n\n    function append(message: string, action: Action, loglevel: LogLevel, context?: ErrorContext) {\n        myAppender({\n            action,\n            inputId,\n            message,\n            loglevel,\n            tag,\n            parentId,\n            ref,\n            context\n        } as LogMessage<ErrorContext>);\n    }\n}\n\nfunction getOptions(options: [] | [string | Identity | undefined] | [string, Identity]): { tag?: string, parentId?: number } {\n    let parentId, tag;\n    if (options.length === 1) {\n        if (typeof options[0] === 'string') {\n            tag = options[0];\n        } else {\n            parentId = options[0]?.id;\n        }\n    } else if (options.length === 2) {\n        tag = options[0];\n        parentId = options[1]?.id;\n    }\n    return { parentId, tag };\n}\n\nexport { appender, combineAppenders, filterMessages };"],"names":["filterMessages","predicate","appender","logMessage","combineAppenders","appenders","message","e","globalAppender","globalInputId","undefined","args","initialLogLevel","inputId","tag","parentId","options","length","id","getOptions","myAppender","loggerInstance","Object","assign","loglevel","context","append","start","update","finish","withFilter","withAppender","defineProperty","value","writable","ref","WeakRef","action"],"mappings":"mQAEgBA,EAAqCC,EAA8DC,GAC/G,OAAO,SAASC,GACRF,EAAUE,IACVD,EAASC,aAKLC,KAA0CC,GACtD,OAAQC,IACJ,IAAI,MAAMJ,KAAYG,EAClB,IACIH,EAASI,GACX,MAAMC,MCZb,IAAIC,ECCX,IAAIC,EAAgB,sBDC2BP,GAI3C,YAHiBQ,IAAbR,IACAM,EAAiBN,GAEdM,mDCH2CG,GAClD,IAAIC,IAEJ,MAAMC,EAAUJ,KAEVK,IAAEA,EAAGC,SAAEA,GAyDjB,SAAoBC,WAChB,IAAID,EAAUD,EACS,IAAnBE,EAAQC,OACkB,iBAAfD,EAAQ,GACfF,EAAME,EAAQ,GAEdD,YAAWC,EAAQ,yBAAIE,GAED,IAAnBF,EAAQC,SACfH,EAAME,EAAQ,GACdD,YAAWC,EAAQ,yBAAIE,IAE3B,MAAO,CAAEH,SAAAA,EAAUD,IAAAA,GArEOK,CAAWR,GAErC,IAAIS,EAAcd,IAAwCE,GAAkBA,EAAeF,IAE3F,MAAMe,EAAiBC,OAAOC,QAC1B,SAAajB,EAAiBkB,IAAoCC,GAC9DC,EAAOpB,IAAqBkB,EAAUC,KACvC,CAECE,MAAMrB,EAAiBkB,QACFd,IAAbc,IACAZ,EAAkBY,GAEtBE,EAAOpB,IAAuBM,IAGlCgB,OAAOtB,EAAiBkB,GACpBE,EAAOpB,IAAwBkB,MAAAA,EAAAA,EAAYZ,IAG/CiB,OAAOvB,EAAiBkB,GACpBE,EAAOpB,IAAwBkB,MAAAA,EAAAA,EAAYZ,IAE/CkB,WAAW7B,IACPmB,EAAapB,EAAeC,EAAWmB,GAChCC,GAEXU,aAAa7B,IACTkB,EAAahB,EAAiBgB,EAAYlB,GACnCmB,KAKnBC,OAAOU,eAAeX,EAAgB,KAAM,CACxCY,MAAOpB,EACPqB,UAAU,IAGd,MAAMC,EAAM,IAAIC,QAAQf,GAExB,OAAOA,EAEP,SAASK,EAAOpB,EAAiB+B,EAAgBb,EAAoBC,GACjEL,EAAW,CACPiB,OAAAA,EACAxB,QAAAA,EACAP,QAAAA,EACAkB,SAAAA,EACAV,IAAAA,EACAC,SAAAA,EACAoB,IAAAA,EACAV,QAAAA"}
+{"version":3,"file":"core.umd.js","sources":["../src/core.ts"],"sourcesContent":["import { globalAppender } from './global-appender';\nimport { Action, Appender, LogLevel, LogMessage, Identity } from './types';\n\nlet globalInputId = 0;\n\nconst getOptions = (options: [] | [string | Identity | undefined] | [string, Identity]): { tag?: string, parentId?: number } => {\n    let parentId, tag;\n    if (options.length === 1) {\n        if (typeof options[0] === 'string') {\n            tag = options[0];\n        } else {\n            parentId = options[0]?.id;\n        }\n    } else if (options.length === 2) {\n        tag = options[0];\n        parentId = options[1]?.id;\n    }\n    return { parentId, tag };\n};\n\nexport const createLogger = <ErrorContext = Error>(...args: [] | [string | Identity | undefined] | [string, Identity]) => {\n    let initialLogLevel: number = LogLevel.info;\n\n    let myAppender = (message: LogMessage<ErrorContext>) => { globalAppender && globalAppender(message); };\n    \n    const inputId = globalInputId++;\n    \n    const { tag, parentId } = getOptions(args);\n    \n    const append = (message: string, action: Action, loglevel: LogLevel, context?: ErrorContext) => {\n        myAppender && myAppender({\n            action,\n            inputId,\n            message,\n            loglevel,\n            tag,\n            parentId,\n            ref,\n            context\n        } as LogMessage<ErrorContext>);\n    };\n\n    const loggerInstance = Object.assign(\n        (message: string, loglevel: LogLevel = LogLevel.info, context?: ErrorContext) => {\n            append(message, Action.log, loglevel, context);\n        }, {\n            // Fine to be started multiple times\n            start(message: string, loglevel?: LogLevel, context?: ErrorContext) {\n                if (loglevel !== undefined) {\n                    initialLogLevel = loglevel;\n                }\n                append(message, Action.start, initialLogLevel, context);\n            },\n            // Fine to be updated multiple times\n            update(message: string, loglevel?: LogLevel, context?: ErrorContext) {\n                append(message, Action.update, loglevel ?? initialLogLevel, context);\n            },\n            // Fine to be finished multiple times\n            finish(message: string, loglevel?: LogLevel, context?: ErrorContext) {\n                append(message, Action.finish, loglevel ?? initialLogLevel, context);\n            },\n            appender(appender?: Appender<ErrorContext>) {\n                if (appender !== undefined) {\n                    myAppender = appender;\n                }\n                return myAppender;\n            }\n        }\n    );\n\n    Object.defineProperty(loggerInstance, 'id', {\n        value: inputId,\n        writable: false\n    });\n\n    const ref = new WeakRef(loggerInstance);\n\n    return loggerInstance;\n};\n"],"names":["globalInputId","args","initialLogLevel","myAppender","message","globalAppender","inputId","tag","parentId","options","length","id","getOptions","append","action","loglevel","context","ref","loggerInstance","Object","assign","start","undefined","update","finish","appender","defineProperty","value","writable","WeakRef"],"mappings":"4UAGA,IAAIA,EAAgB,iBAiBQ,IAA0BC,KAClD,IAAIC,IAEAC,EAAcC,IAAwCC,kBAAkBA,iBAAeD,IAE3F,MAAME,EAAUN,KAEVO,IAAEA,EAAGC,SAAEA,GAtBE,CAACC,YAChB,IAAID,EAAUD,EAWd,OAVuB,IAAnBE,EAAQC,OACkB,iBAAfD,EAAQ,GACfF,EAAME,EAAQ,GAEdD,YAAWC,EAAQ,yBAAIE,GAED,IAAnBF,EAAQC,SACfH,EAAME,EAAQ,GACdD,YAAWC,EAAQ,yBAAIE,IAEpB,CAAEH,SAAAA,EAAUD,IAAAA,IAUOK,CAAWX,GAE/BY,EAAS,CAACT,EAAiBU,EAAgBC,EAAoBC,KACjEb,GAAcA,EAAW,CACrBW,OAAAA,EACAR,QAAAA,EACAF,QAAAA,EACAW,SAAAA,EACAR,IAAAA,EACAC,SAAAA,EACAS,IAAAA,EACAD,QAAAA,KAIFE,EAAiBC,OAAOC,QAC1B,CAAChB,EAAiBW,IAAoCC,KAClDH,EAAOT,IAAqBW,EAAUC,KACvC,CAECK,MAAMjB,EAAiBW,EAAqBC,QACvBM,IAAbP,IACAb,EAAkBa,GAEtBF,EAAOT,IAAuBF,EAAiBc,IAGnDO,OAAOnB,EAAiBW,EAAqBC,GACzCH,EAAOT,IAAwBW,MAAAA,EAAAA,EAAYb,EAAiBc,IAGhEQ,OAAOpB,EAAiBW,EAAqBC,GACzCH,EAAOT,IAAwBW,MAAAA,EAAAA,EAAYb,EAAiBc,IAEhES,SAASA,SACYH,IAAbG,IACAtB,EAAasB,GAEVtB,KAKnBgB,OAAOO,eAAeR,EAAgB,KAAM,CACxCS,MAAOrB,EACPsB,UAAU,IAGd,MAAMX,EAAM,IAAIY,QAAQX,GAExB,OAAOA"}

package/dist/default-formatting.cjs

@@ -8,12 +8,16 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 
 var kleur__default = /*#__PURE__*/_interopDefaultLegacy(kleur);
 
-const { green, red, yellow } = kleur__default["default"];
+const { green, red, yellow, blue } = kleur__default["default"];
 const unicodePrefixes = [`${green('✓')}`, `${green('✓')}`, '⚠', '✕'];
 const asciiPrefixes = [`${green('+')}`, `${green('+')}`, '!', 'x'];
 // eslint-disable-next-line no-sparse-arrays
-const colors = [, , yellow, red];
+const colors = [, , yellow, red];
+const tagFactory = (tag) => {
+    return '[' + blue(tag) + ']';
+};
 
 exports.asciiPrefixes = asciiPrefixes;
 exports.colors = colors;
+exports.tagFactory = tagFactory;
 exports.unicodePrefixes = unicodePrefixes;

package/dist/default-formatting.d.ts

@@ -2,3 +2,4 @@ import { ColorFormatters, Prefixes } from './types';
 export declare const unicodePrefixes: Prefixes;
 export declare const asciiPrefixes: Prefixes;
 export declare const colors: ColorFormatters;
+export declare const tagFactory: (tag: string) => string;

package/dist/default-formatting.mjs

@@ -1,9 +1,12 @@
 import kleur from 'kleur';
 
-const { green, red, yellow } = kleur;
+const { green, red, yellow, blue } = kleur;
 const unicodePrefixes = [`${green('✓')}`, `${green('✓')}`, '⚠', '✕'];
 const asciiPrefixes = [`${green('+')}`, `${green('+')}`, '!', 'x'];
 // eslint-disable-next-line no-sparse-arrays
-const colors = [, , yellow, red];
+const colors = [, , yellow, red];
+const tagFactory = (tag) => {
+    return '[' + blue(tag) + ']';
+};
 
-export { asciiPrefixes, colors, unicodePrefixes };
+export { asciiPrefixes, colors, tagFactory, unicodePrefixes };

package/dist/format-utils.cjs

@@ -2,22 +2,22 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-function createFormatter(colors, prefixes) {
-    return function formatMessage(message, loglevel, usePrefix, identation = 0) {
+const createFormatter = (colors, prefixes, tagFactory) => {
+    return ({ loglevel, message, context, action, tag }, usePrefix, identation = 0) => {
         const prefix = usePrefix === true ? (`${prefixes[loglevel]} `) : (typeof usePrefix === 'string' ? (`${usePrefix} `) : '');
         const color = colors[loglevel];
-        const text = `${prefix}${message}`;
+        const text = `${prefix}${loglevel === 0 /* verbose */ && action === 3 /* log */ && tag !== undefined ? tagFactory(tag) + ' ' : ''}${message}${context != null ? ' ' + context : ''}`;
         return `${' '.repeat(identation)}${color ? color(text) : text}`;
     };
-}
+};
 // from dreidels/utils
-function terminalSupportsUnicode() {
+const terminalSupportsUnicode = () => {
     // The default command prompt and powershell in Windows do not support Unicode characters.
     // However, the VSCode integrated terminal and the Windows Terminal both do.
     return process.platform !== 'win32'
         || process.env.TERM_PROGRAM === 'vscode'
         || !!process.env.WT_SESSION;
-}
+};
 
 exports.createFormatter = createFormatter;
 exports.terminalSupportsUnicode = terminalSupportsUnicode;

package/dist/format-utils.d.ts

@@ -1,3 +1,3 @@
-import { ColorFormatters, LogLevel, Prefixes } from './types';
-export declare function createFormatter(colors: ColorFormatters, prefixes: Prefixes): (message: string, loglevel: LogLevel, usePrefix?: string | boolean | undefined, identation?: number) => string;
-export declare function terminalSupportsUnicode(): boolean;
+import { ColorFormatters, LogMessage, Prefixes } from './types';
+export declare const createFormatter: (colors: ColorFormatters, prefixes: Prefixes, tagFactory: (tag: string) => string) => ({ loglevel, message, context, action, tag }: LogMessage, usePrefix?: string | boolean | undefined, identation?: number) => string;
+export declare const terminalSupportsUnicode: () => boolean;

package/dist/format-utils.mjs

@@ -1,18 +1,18 @@
-function createFormatter(colors, prefixes) {
-    return function formatMessage(message, loglevel, usePrefix, identation = 0) {
+const createFormatter = (colors, prefixes, tagFactory) => {
+    return ({ loglevel, message, context, action, tag }, usePrefix, identation = 0) => {
         const prefix = usePrefix === true ? (`${prefixes[loglevel]} `) : (typeof usePrefix === 'string' ? (`${usePrefix} `) : '');
         const color = colors[loglevel];
-        const text = `${prefix}${message}`;
+        const text = `${prefix}${loglevel === 0 /* verbose */ && action === 3 /* log */ && tag !== undefined ? tagFactory(tag) + ' ' : ''}${message}${context != null ? ' ' + context : ''}`;
         return `${' '.repeat(identation)}${color ? color(text) : text}`;
     };
-}
+};
 // from dreidels/utils
-function terminalSupportsUnicode() {
+const terminalSupportsUnicode = () => {
     // The default command prompt and powershell in Windows do not support Unicode characters.
     // However, the VSCode integrated terminal and the Windows Terminal both do.
     return process.platform !== 'win32'
         || process.env.TERM_PROGRAM === 'vscode'
         || !!process.env.WT_SESSION;
-}
+};
 
 export { createFormatter, terminalSupportsUnicode };

package/dist/global-appender.cjs

@@ -1,32 +1,14 @@
 'use strict';
 
-function filterMessages(predicate, appender) {
-    return function (logMessage) {
-        if (predicate(logMessage)) {
-            appender(logMessage);
-        }
-    };
-}
-function combineAppenders(...appenders) {
-    return (message) => {
-        for (const appender of appenders) {
-            try {
-                appender(message);
-            }
-            catch (e) { /* eat the error */ }
-        }
-    };
-}
+Object.defineProperty(exports, '__esModule', { value: true });
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 exports.globalAppender = void 0;
-function appender(appender) {
+const appender = (appender) => {
     if (appender !== undefined) {
         exports.globalAppender = appender;
     }
     return exports.globalAppender;
-}
+};
 
 exports.appender = appender;
-exports.combineAppenders = combineAppenders;
-exports.filterMessages = filterMessages;

package/dist/global-appender.d.ts

@@ -0,0 +1,3 @@
+import { Appender } from './types';
+export declare let globalAppender: Appender<any>;
+export declare const appender: <ErrorContext = Error>(appender?: Appender<ErrorContext> | undefined) => Appender<any>;

package/dist/global-appender.mjs

@@ -1,28 +1,10 @@
-function filterMessages(predicate, appender) {
-    return function (logMessage) {
-        if (predicate(logMessage)) {
-            appender(logMessage);
-        }
-    };
-}
-function combineAppenders(...appenders) {
-    return (message) => {
-        for (const appender of appenders) {
-            try {
-                appender(message);
-            }
-            catch (e) { /* eat the error */ }
-        }
-    };
-}
-
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 let globalAppender;
-function appender(appender) {
+const appender = (appender) => {
     if (appender !== undefined) {
         globalAppender = appender;
     }
     return globalAppender;
-}
+};
 
-export { appender as a, combineAppenders as c, filterMessages as f, globalAppender as g };
+export { appender, globalAppender };

package/dist/global-appender.umd.js

@@ -0,0 +1,2 @@
+!function(e,o){"object"==typeof exports&&"undefined"!=typeof module?o(exports):"function"==typeof define&&define.amd?define(["exports"],o):o((e="undefined"!=typeof globalThis?globalThis:e||self).nicetiesLoggerGlobalAppender={})}(this,(function(e){"use strict";e.globalAppender=void 0;e.appender=o=>(void 0!==o&&(e.globalAppender=o),e.globalAppender),Object.defineProperty(e,"__esModule",{value:!0})}));
+//# sourceMappingURL=global-appender.umd.js.map

package/dist/global-appender.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-appender.umd.js","sources":["../src/global-appender.ts"],"sourcesContent":["import { Appender } from './types';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport let globalAppender: Appender<any>;\n\nexport const appender = <ErrorContext = Error>(appender?: Appender<ErrorContext>) => {\n    if (appender !== undefined) {\n        globalAppender = appender;\n    }\n    return globalAppender;\n};\n"],"names":["appender","undefined","globalAppender"],"mappings":"uSAK+CA,SAC1BC,IAAbD,IACAE,iBAAiBF,GAEdE"}

package/dist/index.cjs

@@ -6,14 +6,16 @@ var core = require('./core.cjs');
 var globalAppender = require('./global-appender.cjs');
 
 if (!globalAppender.appender()) {
-    const { asciiPrefixes, colors, unicodePrefixes } = require('./default-formatting.cjs');
+    const { asciiPrefixes, colors, unicodePrefixes, tagFactory } = require('./default-formatting.cjs');
     const { createConsoleAppender } = require('./console-appender.cjs');
     const { createFormatter, terminalSupportsUnicode } = require('./format-utils.cjs');
-    const formatter = createFormatter(colors, terminalSupportsUnicode() ? unicodePrefixes : asciiPrefixes);
-    globalAppender.appender(globalAppender.filterMessages((message) => message.loglevel > 0 /* verbose */, createConsoleAppender(formatter)));
+    const { filterMessages } = require('./appender-utils.cjs');
+    const formatter = createFormatter(colors, terminalSupportsUnicode() ? unicodePrefixes : asciiPrefixes, tagFactory);
+    let minLogLevel = 1 /* info */;
+    globalAppender.appender(filterMessages((message) => message.loglevel >= minLogLevel, createConsoleAppender(formatter), // eslint-disable-line indent
+    { setMinLevel(logLevel) { minLogLevel = logLevel; } } // eslint-disable-line indent
+    ));
 }
 
 exports.createLogger = core.createLogger;
 exports.appender = globalAppender.appender;
-exports.combineAppenders = globalAppender.combineAppenders;
-exports.filterMessages = globalAppender.filterMessages;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { createLogger, filterMessages, combineAppenders } from './core';
-import { appender } from './details/global-appender';
+import { createLogger } from './core';
+import { appender } from './global-appender';
 export * from './types';
-export { createLogger, appender, filterMessages, combineAppenders };
+export { createLogger, appender };

package/dist/index.mjs

@@ -1,13 +1,17 @@
 export { createLogger } from './core.mjs';
-import { a as appender, f as filterMessages } from './global-appender.mjs';
-export { a as appender, c as combineAppenders, f as filterMessages } from './global-appender.mjs';
+import { appender } from './global-appender.mjs';
+export { appender } from './global-appender.mjs';
 
 if (!appender()) {
-    const [{ asciiPrefixes, colors, unicodePrefixes }, { createConsoleAppender }, { createFormatter, terminalSupportsUnicode }] = await Promise.all([
+    const [{ asciiPrefixes, colors, unicodePrefixes, tagFactory }, { createConsoleAppender }, { createFormatter, terminalSupportsUnicode }, { filterMessages }] = await Promise.all([
         import('./default-formatting.mjs'),
         import('./console-appender.mjs'),
-        import('./format-utils.mjs')
+        import('./format-utils.mjs'),
+        import('./appender-utils.mjs')
     ]);
-    const formatter = createFormatter(colors, terminalSupportsUnicode() ? unicodePrefixes : asciiPrefixes);
-    appender(filterMessages((message) => message.loglevel > 0 /* verbose */, createConsoleAppender(formatter)));
+    const formatter = createFormatter(colors, terminalSupportsUnicode() ? unicodePrefixes : asciiPrefixes, tagFactory);
+    let minLogLevel = 1 /* info */;
+    appender(filterMessages((message) => message.loglevel >= minLogLevel, createConsoleAppender(formatter), // eslint-disable-line indent
+    { setMinLevel(logLevel) { minLogLevel = logLevel; } } // eslint-disable-line indent
+    ));
 }

package/dist/simple.cjs

@@ -4,10 +4,10 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var globalAppender = require('./global-appender.cjs');
 
-function createLogger(tag) {
+const createLogger = (tag) => {
     let myAppender = (message) => { globalAppender.globalAppender && globalAppender.globalAppender(message); };
     const loggerInstance = Object.assign(function log(message, loglevel = 1 /* info */, context) {
-        myAppender({
+        myAppender && myAppender({
             action: 3 /* log */,
             message,
             loglevel,
@@ -15,19 +15,14 @@ function createLogger(tag) {
             context
         });
     }, {
-        withFilter(predicate) {
-            myAppender = globalAppender.filterMessages(predicate, myAppender);
-            return loggerInstance;
-        },
-        withAppender(appender) {
-            myAppender = globalAppender.combineAppenders(myAppender, appender);
-            return loggerInstance;
+        appender(appender) {
+            if (appender !== undefined) {
+                myAppender = appender;
+            }
+            return myAppender;
         }
     });
     return loggerInstance;
-}
+};
 
-exports.appender = globalAppender.appender;
-exports.combineAppenders = globalAppender.combineAppenders;
-exports.filterMessages = globalAppender.filterMessages;
 exports.createLogger = createLogger;

package/dist/simple.d.ts

@@ -1,8 +1,4 @@
-import { combineAppenders, filterMessages } from './appender-utils';
-import { appender } from './details/global-appender';
 import { Appender, LogLevel, LogMessage } from './types';
-export declare function createLogger<ErrorContext = Error>(tag?: string): ((message: string, loglevel?: LogLevel, context?: ErrorContext | undefined) => void) & {
-    withFilter(predicate: (logMessage: LogMessage<ErrorContext>) => boolean): ((message: string, loglevel?: LogLevel, context?: ErrorContext | undefined) => void) & any;
-    withAppender(appender: Appender<ErrorContext>): ((message: string, loglevel?: LogLevel, context?: ErrorContext | undefined) => void) & any;
+export declare const createLogger: <ErrorContext = Error>(tag?: string | undefined) => ((message: string, loglevel?: LogLevel, context?: ErrorContext | undefined) => void) & {
+    appender(appender?: Appender<ErrorContext> | undefined): (message: LogMessage<ErrorContext>) => void;
 };
-export { appender, combineAppenders, filterMessages };

package/dist/simple.mjs

@@ -1,10 +1,9 @@
-import { f as filterMessages, c as combineAppenders, g as globalAppender } from './global-appender.mjs';
-export { a as appender, c as combineAppenders, f as filterMessages } from './global-appender.mjs';
+import { globalAppender } from './global-appender.mjs';
 
-function createLogger(tag) {
+const createLogger = (tag) => {
     let myAppender = (message) => { globalAppender && globalAppender(message); };
     const loggerInstance = Object.assign(function log(message, loglevel = 1 /* info */, context) {
-        myAppender({
+        myAppender && myAppender({
             action: 3 /* log */,
             message,
             loglevel,
@@ -12,16 +11,14 @@ function createLogger(tag) {
             context
         });
     }, {
-        withFilter(predicate) {
-            myAppender = filterMessages(predicate, myAppender);
-            return loggerInstance;
-        },
-        withAppender(appender) {
-            myAppender = combineAppenders(myAppender, appender);
-            return loggerInstance;
+        appender(appender) {
+            if (appender !== undefined) {
+                myAppender = appender;
+            }
+            return myAppender;
         }
     });
     return loggerInstance;
-}
+};
 
 export { createLogger };

package/dist/simple.umd.js

@@ -1,2 +1,2 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).nicetiesLoggerSimple={})}(this,(function(e){"use strict";function t(e,t){return function(n){e(n)&&t(n)}}function n(...e){return t=>{for(const n of e)try{n(t)}catch(e){}}}let o;e.appender=function(e){return void 0!==e&&(o=e),o},e.combineAppenders=n,e.createLogger=function(e){let i=e=>{o&&o(e)};const f=Object.assign((function(t,n=1,o){i({action:3,message:t,loglevel:n,tag:e,context:o})}),{withFilter:e=>(i=t(e,i),f),withAppender:e=>(i=n(i,e),f)});return f},e.filterMessages=t,Object.defineProperty(e,"__esModule",{value:!0})}));
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("./global-appender")):"function"==typeof define&&define.amd?define(["exports","./global-appender"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).nicetiesLoggerSimple={},e.nicetiesLoggerGlobalAppender)}(this,(function(e,t){"use strict";e.createLogger=e=>{let o=e=>{t.globalAppender&&t.globalAppender(e)};return Object.assign((function(t,n=1,i){o&&o({action:3,message:t,loglevel:n,tag:e,context:i})}),{appender:e=>(void 0!==e&&(o=e),o)})},Object.defineProperty(e,"__esModule",{value:!0})}));
 //# sourceMappingURL=simple.umd.js.map

package/dist/simple.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"simple.umd.js","sources":["../src/appender-utils.ts","../src/details/global-appender.ts","../src/simple.ts"],"sourcesContent":["import { Appender, LogMessage } from './types';\n\nexport function filterMessages<ErrorContext = Error>(predicate: (logMessage: LogMessage<ErrorContext>) => boolean, appender: Appender<ErrorContext> ): Appender<ErrorContext> {\n    return function(logMessage: LogMessage<ErrorContext>) {\n        if (predicate(logMessage)) {\n            appender(logMessage);\n        }\n    };\n}\n\nexport function combineAppenders<ErrorContext = Error>(...appenders: Appender<ErrorContext>[]): Appender<ErrorContext> {\n    return (message: LogMessage<ErrorContext>) => {\n        for(const appender of appenders) {\n            try {\n                appender(message);\n            } catch(e) { /* eat the error */ }\n        }\n    };\n}","import { Appender } from '../types';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport let globalAppender: Appender<any>;\n\nexport function appender<ErrorContext = Error>(appender?: Appender<ErrorContext>) {\n    if (appender !== undefined) {\n        globalAppender = appender;\n    }\n    return globalAppender;\n}\n","import { combineAppenders, filterMessages } from './appender-utils';\nimport { globalAppender, appender } from './details/global-appender';\nimport { Action, Appender, LogLevel, LogMessage } from './types';\n\nexport function createLogger<ErrorContext = Error>(tag?: string) {\n    let myAppender = (message: LogMessage<ErrorContext>) => { globalAppender && globalAppender(message); };\n\n    const loggerInstance = Object.assign(\n        function log(message: string, loglevel: LogLevel = LogLevel.info, context?: ErrorContext) {\n            myAppender({\n                action: Action.log,\n                message,\n                loglevel,\n                tag,\n                context\n            } as LogMessage<ErrorContext>);\n        }, {\n            withFilter(predicate: (logMessage: LogMessage<ErrorContext>) => boolean) {\n                myAppender = filterMessages(predicate, myAppender);\n                return loggerInstance;\n            },\n            withAppender(appender: Appender<ErrorContext>) {\n                myAppender = combineAppenders(myAppender, appender);\n                return loggerInstance;\n            }\n        }\n    );\n\n    return loggerInstance;\n}\n\nexport { appender, combineAppenders, filterMessages };"],"names":["filterMessages","predicate","appender","logMessage","combineAppenders","appenders","message","e","globalAppender","undefined","tag","myAppender","loggerInstance","Object","assign","loglevel","context","action","withFilter","withAppender"],"mappings":"qQAEgBA,EAAqCC,EAA8DC,GAC/G,OAAO,SAASC,GACRF,EAAUE,IACVD,EAASC,aAKLC,KAA0CC,GACtD,OAAQC,IACJ,IAAI,MAAMJ,KAAYG,EAClB,IACIH,EAASI,GACX,MAAMC,MCZb,IAAIC,sBAEoCN,GAI3C,YAHiBO,IAAbP,IACAM,EAAiBN,GAEdM,gDCLwCE,GAC/C,IAAIC,EAAcL,IAAwCE,GAAkBA,EAAeF,IAE3F,MAAMM,EAAiBC,OAAOC,QAC1B,SAAaR,EAAiBS,IAAoCC,GAC9DL,EAAW,CACPM,SACAX,QAAAA,EACAS,SAAAA,EACAL,IAAAA,EACAM,QAAAA,MAEL,CACCE,WAAWjB,IACPU,EAAaX,EAAeC,EAAWU,GAChCC,GAEXO,aAAajB,IACTS,EAAaP,EAAiBO,EAAYT,GACnCU,KAKnB,OAAOA"}
+{"version":3,"file":"simple.umd.js","sources":["../src/simple.ts"],"sourcesContent":["import { globalAppender } from './global-appender';\nimport { Action, Appender, LogLevel, LogMessage } from './types';\n\nexport const createLogger = <ErrorContext = Error>(tag?: string) => {\n    let myAppender = (message: LogMessage<ErrorContext>) => { globalAppender && globalAppender(message); };\n\n    const loggerInstance = Object.assign(\n        function log(message: string, loglevel: LogLevel = LogLevel.info, context?: ErrorContext) {\n            myAppender && myAppender({\n                action: Action.log,\n                message,\n                loglevel,\n                tag,\n                context\n            } as LogMessage<ErrorContext>);\n        }, {\n            appender(appender?: Appender<ErrorContext>) {\n                if (appender !== undefined) {\n                    myAppender = appender;\n                }\n                return myAppender;\n            }\n        }\n    );\n\n    return loggerInstance;\n};\n"],"names":["tag","myAppender","message","globalAppender","Object","assign","loglevel","context","action","appender","undefined"],"mappings":"6VAGmDA,IAC/C,IAAIC,EAAcC,IAAwCC,kBAAkBA,iBAAeD,IAqB3F,OAnBuBE,OAAOC,QAC1B,SAAaH,EAAiBI,IAAoCC,GAC9DN,GAAcA,EAAW,CACrBO,SACAN,QAAAA,EACAI,SAAAA,EACAN,IAAAA,EACAO,QAAAA,MAEL,CACCE,SAASA,SACYC,IAAbD,IACAR,EAAaQ,GAEVR"}

package/dist/types.d.ts

@@ -18,6 +18,7 @@ export declare type LogMessage<ErrorContext = Error> = {
     tag?: string;
     parentId?: number;
     ref: WeakRef<never>;
+    context?: ErrorContext;
 } | {
     inputId?: number;
     loglevel: LogLevel;
@@ -38,4 +39,13 @@ export declare type Prefixes = {
 export declare type ColorFormatters = {
     [index in LogLevel]: (((text: string) => string) | undefined);
 };
-export declare type Formatter = (message: string, loglevel: LogLevel, usePrefix?: string | boolean, identation?: number) => string;
+export declare type Formatter<ErrorContext = Error> = (message: LogMessage<ErrorContext>, usePrefix?: string | boolean, identation?: number) => string;
+export declare type Logger<ErrorContext = Error> = ((message: string, loglevel?: LogLevel, context?: ErrorContext | undefined) => void) & {
+    start(message: string, loglevel?: LogLevel | undefined, context?: ErrorContext | undefined): void;
+    update(message: string, loglevel?: LogLevel | undefined, context?: ErrorContext | undefined): void;
+    finish(message: string, loglevel?: LogLevel | undefined, context?: ErrorContext | undefined): void;
+    appender(appender?: Appender<ErrorContext>): (message: LogMessage<ErrorContext>) => void;
+};
+export declare type MinLogLevelApi = {
+    setMinLevel(logLevel: LogLevel): void;
+};

package/global-appender/package.json

@@ -0,0 +1,3 @@
+{
+    "types": "../dist/global-appender.d.ts"
+}

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.4",
+  "version": "1.1.2",
   "license": "MIT",
   "name": "@niceties/logger",
   "author": "Konstantin Shutkin",
@@ -29,6 +29,14 @@
     "./format-utils": {
       "require": "./dist/format-utils.cjs",
       "default": "./dist/format-utils.mjs"
+    },
+    "./global-appender": {
+      "require": "./dist/global-appender.cjs",
+      "default": "./dist/global-appender.mjs"
+    },
+    "./appender-utils": {
+      "require": "./dist/appender-utils.cjs",
+      "default": "./dist/appender-utils.mjs"
     }
   },
   "main": "./dist/index.cjs",
@@ -40,6 +48,8 @@
     "default-formatting",
     "core",
     "console-appender",
+    "global-appender",
+    "appender-utils",
     "format-utils",
     "types",
     "simple"
@@ -55,6 +65,8 @@
     "url": "https://github.com/kshutkin/niceties/issues"
   },
   "homepage": "https://github.com/kshutkin/niceties/blob/main/logger/README.md",
+  "readme": "REAMDE.md",
+  "description": "Experimental logger/reporter for async tasks.",
   "scripts": {
     "build": "rimraf ./dist && rollup -c",
     "dev": "rimraf ./dist && rollup -c -w",
@@ -70,23 +82,25 @@
     "@semantic-release/git": "10.0.1",
     "@semantic-release/npm": "8.0.2",
     "@semantic-release/release-notes-generator": "10.0.2",
-    "@types/jest": "27.0.2",
-    "@typescript-eslint/eslint-plugin": "5.3.0",
-    "@typescript-eslint/parser": "5.3.0",
+    "@types/jest": "27.0.3",
+    "@types/node": "17.0.5",
+    "@typescript-eslint/eslint-plugin": "5.8.1",
+    "@typescript-eslint/parser": "5.8.1",
     "conventional-changelog-angular": "5.0.13",
-    "eslint": "8.1.0",
-    "jest": "27.3.1",
+    "eslint": "8.5.0",
+    "jest": "27.4.5",
     "lodash": "4.17.21",
     "rimraf": "3.0.2",
-    "rollup": "2.60.1",
+    "rollup": "2.62.0",
     "rollup-plugin-preprocess": "0.0.4",
     "rollup-plugin-terser": "7.0.2",
     "rollup-plugin-typescript2": "0.31.1",
     "semantic-release": "18.0.0",
     "semantic-release-monorepo": "7.0.5",
-    "ts-jest": "27.0.7",
+    "ts-jest": "27.1.2",
     "tslib": "2.3.1",
-    "typescript": "4.4.x"
+    "typescript": "4.5.x",
+    "pkgbld": "1.2.0"
   },
   "dependencies": {
     "kleur": "^4.1.4"

package/dist/details/global-appender.d.ts

@@ -1,3 +0,0 @@
-import { Appender } from '../types';
-export declare let globalAppender: Appender<any>;
-export declare function appender<ErrorContext = Error>(appender?: Appender<ErrorContext>): Appender<any>;