metalog 3.1.15 → 3.1.17

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2017-2024 Metarhia
+Copyright (c) 2017-2025 Metarhia
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -31,6 +31,6 @@ await logger.close();
 
 ## License & Contributors
 
-Copyright (c) 2017-2024 [Metarhia contributors](https://github.com/metarhia/metalog/graphs/contributors).
+Copyright (c) 2017-2025 [Metarhia contributors](https://github.com/metarhia/metalog/graphs/contributors).
 Metalog is [MIT licensed](./LICENSE).\
 Metalog is a part of [Metarhia](https://github.com/metarhia) technology stack.

package/metalog.d.ts

@@ -11,6 +11,28 @@ interface LoggerOptions {
   json?: boolean;
   toFile?: Array<string>;
   toStdout?: Array<string>;
+  crash?: string;
+}
+
+interface Console {
+  assert(assertion: unknown, ...args: unknown[]): void;
+  clear(): void;
+  count(label?: string): void;
+  countReset(label?: string): void;
+  debug(...args: unknown[]): void;
+  dir(...args: unknown[]): void;
+  trace(...args: unknown[]): void;
+  info(...args: unknown[]): void;
+  log(...args: unknown[]): void;
+  warn(...args: unknown[]): void;
+  error(...args: unknown[]): void;
+  group(...args: unknown[]): void;
+  groupCollapsed(...args: unknown[]): void;
+  groupEnd(): void;
+  table(tabularData: unknown): void;
+  time(label?: string): void;
+  timeEnd(label?: string): void;
+  timeLog(label: string, ...args: unknown[]): void;
 }
 
 export class Logger extends EventEmitter {
@@ -22,6 +44,7 @@ export class Logger extends EventEmitter {
   writeBuffer: number;
   keepDays: number;
   home: string;
+  json: boolean;
   stream: NodeJS.WritableStream;
   reopenTimer: NodeJS.Timer;
   flushTimer: NodeJS.Timer;
@@ -38,9 +61,14 @@ export class Logger extends EventEmitter {
   open(): Promise<Logger>;
   close(): Promise<void>;
   rotate(): Promise<void>;
-  write(type: string, s: string): void;
-  flush(callback: Function): void;
+  format(type: string, indent: number, ...args: unknown[]): string;
+  formatPretty(type: string, indent: number, ...args: unknown[]): string;
+  formatFile(type: string, indent: number, ...args: unknown[]): string;
+  formatJson(type: string, indent: number, ...args: unknown[]): string;
+  write(type: string, indent: number, ...args: unknown[]): void;
+  flush(callback?: (err?: Error) => void): void;
   normalizeStack(stack: string): string;
+  expandError(err: Error): unknown;
 }
 
 export function openLog(args: LoggerOptions): Promise<Logger>;

package/metalog.js

@@ -89,10 +89,10 @@ class Console {
   }
 
   assert(assertion, ...args) {
-    try {
-      console.assert(assertion, ...args);
-    } catch (err) {
-      this.#write('error', this.#groupIndent, err.stack);
+    if (!assertion) {
+      const noArgs = args.length === 0;
+      const message = noArgs ? 'Assertion failed' : util.format(...args);
+      this.#write('error', this.#groupIndent, message);
     }
   }
 
@@ -152,7 +152,7 @@ class Console {
   }
 
   groupEnd() {
-    if (this.#groupIndent.length === 0) return;
+    if (this.#groupIndent === 0) return;
     this.#groupIndent -= INDENT;
   }
 
@@ -184,13 +184,13 @@ class Console {
 }
 
 class Logger extends events.EventEmitter {
-  constructor(args) {
+  constructor(options) {
     super();
-    const { workerId = 0, createStream = fs.createWriteStream } = args;
-    const { writeInterval, writeBuffer, keepDays, home, json } = args;
-    const { toFile = LOG_TYPES, toStdout = LOG_TYPES } = args;
+    const { workerId = 0, createStream = fs.createWriteStream } = options;
+    const { writeInterval, writeBuffer, keepDays, home, json } = options;
+    const { toFile = LOG_TYPES, toStdout = LOG_TYPES, crash } = options;
     this.active = false;
-    this.path = args.path;
+    this.path = options.path;
     this.workerId = `W${workerId}`;
     this.createStream = createStream;
     this.writeInterval = writeInterval || DEFAULT_WRITE_INTERVAL;
@@ -209,6 +209,7 @@ class Logger extends events.EventEmitter {
     this.fsEnabled = toFile.length !== 0;
     this.toStdout = logTypes(toStdout);
     this.console = new Console((...args) => this.write(...args));
+    if (crash === 'flush') this.#setupCrashHandling();
     return this.open();
   }
 
@@ -386,7 +387,13 @@ class Logger extends events.EventEmitter {
       return;
     }
     if (!this.active) {
-      const err = new Error('Cannot flush log buffer: logger is not opened');
+      const err = new Error('Cannot flush log buffer: logger is not active');
+      this.emit('error', err);
+      if (callback) callback(err);
+      return;
+    }
+    if (!this.stream || this.stream.destroyed || this.stream.closed) {
+      const err = new Error('Cannot flush log buffer: stream is not available');
       this.emit('error', err);
       if (callback) callback(err);
       return;
@@ -416,8 +423,29 @@ class Logger extends events.EventEmitter {
       ...err,
     };
   }
+
+  #setupCrashHandling() {
+    const exitHandler = () => {
+      this.flush();
+    };
+    process.on('SIGTERM', exitHandler);
+    process.on('SIGINT', exitHandler);
+    process.on('SIGUSR1', exitHandler);
+    process.on('SIGUSR2', exitHandler);
+    process.on('uncaughtException', (err) => {
+      this.write('error', 0, 'Uncaught Exception:', err);
+      this.flush();
+    });
+    process.on('unhandledRejection', (reason) => {
+      this.write('error', 0, 'Unhandled Rejection:', reason);
+      this.flush();
+    });
+    process.on('exit', () => {
+      this.flush();
+    });
+  }
 }
 
-const openLog = async (args) => new Logger(args);
+const openLog = async (options) => new Logger(options);
 
 module.exports = { Logger, openLog };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metalog",
-  "version": "3.1.15",
+  "version": "3.1.17",
   "author": "Timur Shemsedinov <timur.shemsedinov@gmail.com>",
   "description": "Logger for Metarhia",
   "license": "MIT",
@@ -49,17 +49,17 @@
     "fix": "eslint . --fix && prettier --write \"**/*.js\" \"**/*.json\" \"**/*.md\" \"**/*.ts\""
   },
   "engines": {
-    "node": "18 || 20 || 21 || 22"
+    "node": ">=18"
   },
   "dependencies": {
-    "concolor": "^1.1.0",
-    "metautil": "^5.2.3"
+    "concolor": "^1.1.3",
+    "metautil": "^5.3.0"
   },
   "devDependencies": {
-    "@types/node": "^22.5.1",
-    "eslint": "^9.9.1",
-    "eslint-config-metarhia": "^9.0.4",
-    "prettier": "^3.3.3",
-    "typescript": "^5.5.4"
+    "@types/node": "^24.3.0",
+    "eslint": "^9.34.0",
+    "eslint-config-metarhia": "^9.1.3",
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.2"
   }
 }