feat: add silent() method

.changeset/friendly-gifts-punch.md

@@ -0,0 +1,5 @@
+---
+"loglayer": minor
+---
+
+Add silent() method.

README.md

@@ -615,6 +615,7 @@ const childLog = parentLog.child()
 - `LogLayer#debug(...messages: MessageDataType[]): void`
 - `LogLayer#trace(...messages: MessageDataType[]): void`
 - `LogLayer#fatal(...messages: MessageDataType[]): void`
+- `LogLayer#silent(...messages: MessageDataType[]): void`
 
 `type MessageDataType = string | number | null | undefined`
 
@@ -623,6 +624,7 @@ to the following levels in that situation:
 
   * `trace` -> `debug`
   * `fatal` -> `error`
+  * `silent` -> (no-op)
 
 *Your logging library may or may not support passing multiple parameters. See your logging library's 
 documentation for more details.*

src/LogBuilder.ts

@@ -139,6 +139,14 @@ export class LogBuilder<ExternalLogger extends LoggerLibrary = LoggerLibrary, Er
     this.formatLog(LogLevel.fatal, messages);
   }
 
+  /**
+   * No-op method that does nothing.
+   */
+  silent(...messages: MessageDataType[]) {
+    this.structuredLogger._formatMessage(messages);
+    this.formatLog(LogLevel.silent, messages);
+  }
+
   /**
    * All logging inputs are dropped and stops sending logs to the logging library.
    */

src/LogLayer.ts

@@ -324,6 +324,14 @@ export class LogLayer<ExternalLogger extends LoggerLibrary = LoggerLibrary, Erro
     this._formatLog({ logLevel: LogLevel.fatal, params: messages });
   }
 
+  /**
+   * No-op method that does nothing.
+   */
+  silent(...messages: MessageDataType[]) {
+    this._formatMessage(messages);
+    this._formatLog({ logLevel: LogLevel.silent, params: messages });
+  }
+
   /**
    * All logging inputs are dropped and stops sending logs to the logging library.
    */
@@ -549,6 +557,11 @@ export class LogLayer<ExternalLogger extends LoggerLibrary = LoggerLibrary, Erro
           this.loggerInstance.error(...params);
         }
         break;
+      case LogLevel.silent:
+        if (this.loggerInstance.silent) {
+          this.loggerInstance.silent(...params);
+        }
+        break;
       default:
         if (consoleDebug) {
           console.log(...params);

src/MockLogBuilder.ts

@@ -18,6 +18,8 @@ export class MockLogBuilder implements ILogBuilder {
 
   fatal(...messages: MessageDataType[]): void {}
 
+  silent(...messages: MessageDataType[]): void {}
+
   enableLogging() {
     return this;
   }

src/MockLogLayer.ts

@@ -12,6 +12,7 @@ export class MockLogLayer<ErrorType = Error> implements ILogLayer<any, ErrorType
   debug(...messages: MessageDataType[]): void {}
   trace(...messages: MessageDataType[]): void {}
   fatal(...messages: MessageDataType[]): void {}
+  silent(...messages: MessageDataType[]): void {}
 
   getLoggerInstance() {}
 

src/types/common.types.ts

@@ -5,6 +5,7 @@ export enum LogLevel {
   debug = "debug",
   trace = "trace",
   fatal = "fatal",
+  silent = "silent",
 }
 
 /**

src/types/index.ts

@@ -15,6 +15,7 @@ export interface LoggerLibrary {
   trace?: (...data: any[]) => void;
   debug(...data: any[]): void;
   fatal?: (...data: any[]) => void;
+  silent?: (...data: any[]) => void;
 }
 
 export interface ILogBuilder {
@@ -60,6 +61,11 @@ export interface ILogBuilder {
    * the first parameter would be used.
    */
   fatal(...messages: MessageDataType[]): void;
+
+  /**
+   * No-op method that does nothing.
+   */
+  silent(): void;
 }
 
 export interface ILogLayer<ExternalLogger extends LoggerLibrary = LoggerLibrary, ErrorType = ErrorDataType>