@niceties/logger 1.0.4 → 1.1.0

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,14 +220,18 @@ 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

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 });
+
+function filterMessages(predicate, appender, api) {
+    return Object.assign(function (logMessage) {
+        if (predicate(logMessage)) {
+            appender(logMessage);
+        }
+    }, api);
+}
+function 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 filterMessages<ErrorContext = Error, Api extends object = object>(predicate: (logMessage: LogMessage<ErrorContext>) => boolean, appender: Appender<ErrorContext>, api?: Api): Appender<ErrorContext> & Api;
 export declare function combineAppenders<ErrorContext = Error>(...appenders: Appender<ErrorContext>[]): Appender<ErrorContext>;

package/dist/appender-utils.mjs

@@ -0,0 +1,19 @@
+function filterMessages(predicate, appender, api) {
+    return Object.assign(function (logMessage) {
+        if (predicate(logMessage)) {
+            appender(logMessage);
+        }
+    }, api);
+}
+function 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=function(...e){return t=>{for(const n of e)try{n(t)}catch(e){}}},e.filterMessages=function(e,t,n){return Object.assign((function(n){e(n)&&t(n)}),n)},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 function 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 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}"],"names":["appenders","message","appender","e","predicate","api","Object","assign","logMessage"],"mappings":"kSAU0DA,GACtD,OAAQC,IACJ,IAAI,MAAMC,KAAYF,EAClB,IACIE,EAASD,GACX,MAAME,iCAb8DC,EAA8DF,EAAkCG,GAC9K,OAAOC,OAAOC,QAAO,SAASC,GACtBJ,EAAUI,IACVN,EAASM,KAEdH"}

package/dist/console-appender.cjs

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

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 function createConsoleAppender(formatter: Formatter): (message: LogMessage) => void;

package/dist/console-appender.mjs

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

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,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports):"function"==typeof define&&define.amd?define(["exports"],n):n((e="undefined"!=typeof globalThis?globalThis:e||self).nicetiesLoggerConsoleAppender={})}(this,(function(e){"use strict";e.createConsoleAppender=function(e){return function(n){console.log(e(n,2===n.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 function createConsoleAppender(formatter: Formatter) {\n    return function consoleAppender(message: LogMessage) {\n        console.log(formatter(message, message.action === Action.finish));\n    };\n}\n"],"names":["formatter","message","console","log","action"],"mappings":"sSAEsCA,GAClC,OAAO,SAAyBC,GAC5BC,QAAQC,IAAIH,EAAUC,MAASA,EAAQG"}

package/dist/core.cjs

@@ -14,27 +14,25 @@ function createLogger(...args) {
         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);
+        finish(message, loglevel, context) {
+            append(message, 2 /* finish */, loglevel !== null && loglevel !== void 0 ? loglevel : initialLogLevel, 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;
         }
     });
     Object.defineProperty(loggerInstance, 'id', {
@@ -44,7 +42,7 @@ function createLogger(...args) {
     const ref = new WeakRef(loggerInstance);
     return loggerInstance;
     function append(message, action, loglevel, context) {
-        myAppender({
+        myAppender && myAppender({
             action,
             inputId,
             message,
@@ -74,7 +72,4 @@ function getOptions(options) {
     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;
+    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,5 +1,4 @@
-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) {
@@ -11,27 +10,25 @@ function createLogger(...args) {
         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);
+        finish(message, loglevel, context) {
+            append(message, 2 /* finish */, loglevel !== null && loglevel !== void 0 ? loglevel : initialLogLevel, 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;
         }
     });
     Object.defineProperty(loggerInstance, 'id', {
@@ -41,7 +38,7 @@ function createLogger(...args) {
     const ref = new WeakRef(loggerInstance);
     return loggerInstance;
     function append(message, action, loglevel, context) {
-        myAppender({
+        myAppender && myAppender({
             action,
             inputId,
             message,

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=function(...e){let o=1;const i=n++,{tag:l,parentId:d}=function(e){var t,n;let o,i;1===e.length?"string"==typeof e[0]?i=e[0]:o=null===(t=e[0])||void 0===t?void 0:t.id:2===e.length&&(i=e[0],o=null===(n=e[1])||void 0===n?void 0:n.id);return{parentId:o,tag:i}}(e);let u=e=>{t.globalAppender&&t.globalAppender(e)};const a=Object.assign((function(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&&(u=e),u)});Object.defineProperty(a,"id",{value:i,writable:!1});const f=new WeakRef(a);return a;function r(e,t,n,o){u&&u({action:t,inputId:i,message:e,loglevel:n,tag:l,parentId:d,ref:f,context:o})}},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\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, 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    function 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\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}"],"names":["globalInputId","args","initialLogLevel","inputId","tag","parentId","options","length","id","getOptions","myAppender","message","globalAppender","loggerInstance","Object","assign","loglevel","context","append","start","undefined","update","finish","appender","defineProperty","value","writable","ref","WeakRef","action"],"mappings":"4UAGA,IAAIA,EAAgB,6BAEkCC,GAClD,IAAIC,IAEJ,MAAMC,EAAUH,KAEVI,IAAEA,EAAGC,SAAEA,GAuDjB,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,GAnEOK,CAAWR,GAErC,IAAIS,EAAcC,IAAwCC,kBAAkBA,iBAAeD,IAE3F,MAAME,EAAiBC,OAAOC,QAC1B,SAAaJ,EAAiBK,IAAoCC,GAC9DC,EAAOP,IAAqBK,EAAUC,KACvC,CAECE,MAAMR,EAAiBK,EAAqBC,QACvBG,IAAbJ,IACAd,EAAkBc,GAEtBE,EAAOP,IAAuBT,EAAiBe,IAGnDI,OAAOV,EAAiBK,EAAqBC,GACzCC,EAAOP,IAAwBK,MAAAA,EAAAA,EAAYd,EAAiBe,IAGhEK,OAAOX,EAAiBK,EAAqBC,GACzCC,EAAOP,IAAwBK,MAAAA,EAAAA,EAAYd,EAAiBe,IAEhEM,SAASA,SACYH,IAAbG,IACAb,EAAaa,GAEVb,KAKnBI,OAAOU,eAAeX,EAAgB,KAAM,CACxCY,MAAOtB,EACPuB,UAAU,IAGd,MAAMC,EAAM,IAAIC,QAAQf,GAExB,OAAOA,EAEP,SAASK,EAAOP,EAAiBkB,EAAgBb,EAAoBC,GACjEP,GAAcA,EAAW,CACrBmB,OAAAA,EACA1B,QAAAA,EACAQ,QAAAA,EACAK,SAAAA,EACAZ,IAAAA,EACAC,SAAAA,EACAsB,IAAAA,EACAV,QAAAA"}

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];
+function 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 function 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];
+function tagFactory(tag) {
+    return '[' + blue(tag) + ']';
+}
 
-export { asciiPrefixes, colors, unicodePrefixes };
+export { asciiPrefixes, colors, tagFactory, unicodePrefixes };

package/dist/format-utils.cjs

@@ -2,11 +2,11 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-function createFormatter(colors, prefixes) {
-    return function formatMessage(message, loglevel, usePrefix, identation = 0) {
+function createFormatter(colors, prefixes, tagFactory) {
+    return function formatMessage({ 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}`;
     };
 }

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

package/dist/format-utils.mjs

@@ -1,8 +1,8 @@
-function createFormatter(colors, prefixes) {
-    return function formatMessage(message, loglevel, usePrefix, identation = 0) {
+function createFormatter(colors, prefixes, tagFactory) {
+    return function formatMessage({ 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}`;
     };
 }

package/dist/global-appender.cjs

@@ -1,22 +1,6 @@
 '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;
@@ -28,5 +12,3 @@ function appender(appender) {
 }
 
 exports.appender = appender;
-exports.combineAppenders = combineAppenders;
-exports.filterMessages = filterMessages;

package/dist/{details/global-appender.d.ts → global-appender.d.ts}

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

package/dist/global-appender.mjs

@@ -1,21 +1,3 @@
-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) {
@@ -25,4 +7,4 @@ function appender(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=function(o){return 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 function appender<ErrorContext = Error>(appender?: Appender<ErrorContext>) {\n    if (appender !== undefined) {\n        globalAppender = appender;\n    }\n    return globalAppender;\n}\n"],"names":["appender","undefined","globalAppender"],"mappings":"gTAK+CA,GAI3C,YAHiBC,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

@@ -7,7 +7,7 @@ var globalAppender = require('./global-appender.cjs');
 function 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;
+    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) {
     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,13 +11,11 @@ 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;

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=function(e){let n=e=>{t.globalAppender&&t.globalAppender(e)};return Object.assign((function(t,o=1,i){n&&n({action:3,message:t,loglevel:o,tag:e,context:i})}),{appender:e=>(void 0!==e&&(n=e),n)})},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 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 && 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":"sWAGmDA,GAC/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> = (...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>): (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.0",
   "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,7 @@
     "url": "https://github.com/kshutkin/niceties/issues"
   },
   "homepage": "https://github.com/kshutkin/niceties/blob/main/logger/README.md",
+  "readme": "REAMDE.md",
   "scripts": {
     "build": "rimraf ./dist && rollup -c",
     "dev": "rimraf ./dist && rollup -c -w",
@@ -70,23 +81,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.1.1"
   },
   "dependencies": {
     "kleur": "^4.1.4"