@diotobtea/sapiente-provident
v1.0.0
Published
> 👔 Fully typed minimal platform-agnostic logger
Downloads
6
Maintainers
Keywords
Readme
Tie Logger
👔 Fully typed minimal platform-agnostic logger
📦 Installation
- Using
npm
npm i @diotobtea/sapiente-provident
- Using
Yarn
yarn add @diotobtea/sapiente-provident
- Using
pnpm
pnpm add @diotobtea/sapiente-provident
Usage
Initialization
/** @file: logger.js */
import { Logger, logLevels, filter } from "@diotobtea/sapiente-provident";
export const logger = new Logger(
"app", // Root logger name
logLevels(), // Define log levels. By default are: verbose, debug, info, warn, error, fatal
// You can use custom levels by using
// logLevels("info", "warn", "error")
{
// Custom data
appVersion: "3.1"
moduleName: "root",
moduleVersion: "1.0.0"
}
);
export const child = logger.child(
// Child logger name
"auth",
// Child logger data
{ moduleName: "auth", moduleVersion: "0.3.1" }
);
const criticalLogs = [];
const unsubscribe = logger.subscribe(
// Subscribe to all logs, they go to console
(log) => console.log(...log.message.parts),
// All logs, that level is greater or equal than "warn" will be added to critical logs
// Severity is determined by index of level in levels array
// Current array is: verbose, debug, info, warn, error, fatal
// [less] <<< ^^^^ >> [greater]
filter(">=", "warn", (log) => criticalLogs.push(log))
)
process.on("SIGINT", () => {
unsubscribe();
})
Logging
/** @file: index.js */
import { child, logger } from "./logger.js";
const PORT = parseInt(process.env.PORT) || 3000;
logger.subscribe(log => console.log(log));
child.log.debug`Application initialized. Port: ${{ port: PORT }}. Environment: ${{process.env}}`;
// Level: ^^^^^
// Here goes app
Log format
({
// One of defined levels
level: "debug",
message: {
template:
"Application initialized. Port: {port}. Environment: {SHELL,COLORTERM,PWD}",
plain:
'Application initialized. Port: 3000. Environment: {"SHELL":"/bin/bash","COLORTERM":"truecolor","PWD":"/home/alexxgrib/Projects/@diotobtea/sapiente-provident"}',
parts: [
"Application initialized. Port:",
{ port: 3000 },
". Environment: ",
{
SHELL: "/bin/bash",
COLORTERM: "truecolor",
PWD: "/home/alexxgrib/Projects/@diotobtea/sapiente-provident"
}
]
},
// merge of
// - logger data
// - logger parents data
// - data passed in log message
data: {
appVersion: "3.1",
moduleName: "auth",
moduleVersion: "0.3.1",
port: 3000,
SHELL: "/bin/bash",
COLORTERM: "truecolor",
PWD: "/home/alexxgrib/Projects/@diotobtea/sapiente-provident"
},
context: {
// name of the logger
name: "auth",
// list of logger inheritance
path: ["app", "auth"]
},
// logger object
origin: child
});