@xylabs/logger 4.13.15 → 4.13.17

package/README.md

@@ -1,63 +1,54 @@
-[![logo][]](https://xylabs.com)
-
 # @xylabs/logger
 
+[![logo][]](https://xylabs.com)
+
+[![main-build][]][main-build-link]
 [![npm-badge][]][npm-link]
 [![npm-downloads-badge][]][npm-link]
 [![jsdelivr-badge][]][jsdelivr-link]
 [![npm-license-badge][]](LICENSE)
+[![codacy-badge][]][codacy-link]
+[![codeclimate-badge][]][codeclimate-link]
+[![snyk-badge][]][snyk-link]
 [![socket-badge][]][socket-link]
 
-> XY Labs Logger Helpers
-
-## Table of Contents
-
--   [Description](#description)
--   [Install](#install)
--   [Maintainers](#maintainers)
--   [License](#license)
--   [Credits](#credits)
-
-## Description
+Version: 4.13.15
 
-Various Logger helper functions
+XYLabs Logger Library
 
-## Install
-
-Using npm:
-
-```sh
-npm i --save @xylabs/logger
-```
+## Documentation
 
-Using yarn:
+Coming Soon!
 
-```sh
-yarn add @xylabs/logger
-```
-
-## Documentation
-[Developer Reference](https://xylabs.github.io/sdk-js)
+Part of [sdk-js](https://www.npmjs.com/package/@xyo-network/sdk-js)
 
 ## Maintainers
 
 -   [Arie Trouw](https://github.com/arietrouw) ([arietrouw.com](https://arietrouw.com))
--   [Joel Carter](https://github.com/JoelBCarter)
 -   [Matt Jones](https://github.com/jonesmac)
+-   [Joel Carter](https://github.com/JoelBCarter)
 -   [Jordan Trouw](https://github.com/jordantrouw)
 
 ## License
 
-See the [LICENSE](LICENSE) file for license details
+> See the [LICENSE](LICENSE) file for license details
 
 ## Credits
 
-[Made with 🔥and ❄️ by XY Labs](https://xylabs.com)
+[Made with 🔥 and ❄️ by XYLabs](https://xylabs.com)
 
 [logo]: https://cdn.xy.company/img/brand/XYPersistentCompany_Logo_Icon_Colored.svg
 
+[main-build]: https://github.com/xylabs/sdk-js/actions/workflows/build.yml/badge.svg
+[main-build-link]: https://github.com/xylabs/sdk-js/actions/workflows/build.yml
 [npm-badge]: https://img.shields.io/npm/v/@xylabs/logger.svg
 [npm-link]: https://www.npmjs.com/package/@xylabs/logger
+[codacy-badge]: https://app.codacy.com/project/badge/Grade/c8e15e14f37741c18cfb47ac7245c698
+[codacy-link]: https://www.codacy.com/gh/xylabs/sdk-js/dashboard?utm_source=github.com&utm_medium=referral&utm_content=xylabs/sdk-js&utm_campaign=Badge_Grade
+[codeclimate-badge]: https://api.codeclimate.com/v1/badges/c5eb068f806f0b047ea7/maintainability
+[codeclimate-link]: https://codeclimate.com/github/xylabs/sdk-js/maintainability
+[snyk-badge]: https://snyk.io/test/github/xylabs/sdk-js/badge.svg?targetFile=package.json
+[snyk-link]: https://snyk.io/test/github/xylabs/sdk-js?targetFile=package.json
 
 [npm-downloads-badge]: https://img.shields.io/npm/dw/@xylabs/logger
 [npm-license-badge]: https://img.shields.io/npm/l/@xylabs/logger

package/{build → dist}/neutral/LevelLogger.d.ts

@@ -30,7 +30,6 @@ export type LogLevelValue = EnumValue<typeof LogLevel>;
  * makes it confusing to import
  */
 export type LogLevel = LogLevelValue;
-export declare const NoOpLogFunction: (..._data: unknown[]) => undefined;
 export declare class LevelLogger implements Logger {
     readonly level: LogLevelValue;
     readonly logger: Logger;

package/{build → dist}/neutral/LevelLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LevelLogger.d.ts","sourceRoot":"","sources":["../../src/LevelLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAEnC,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;AAEtD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,EAAE,WAAW,CAAA;IAClB,IAAI,EAAE,WAAW,CAAA;IACjB,GAAG,EAAE,WAAW,CAAA;IAChB,KAAK,EAAE,WAAW,CAAA;IAClB,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,eAAO,MAAM,QAAQ;;;;;;;EAOnB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,QAAQ,CAAC,CAAA;AAClD,MAAM,MAAM,YAAY,GAAG,WAAW,CAAA;AAEtC,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,QAAQ,CAAC,CAAA;AACtD;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAA;AAEpC,eAAO,MAAM,eAAe,GAAI,GAAG,OAAO,OAAO,EAAE,cAAY,CAAA;AAE/D,qBAAa,WAAY,YAAW,MAAM;IACxC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;gBACX,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,aAA6B;IAKhE,IAAI,KAAK,gBAER;IAED,IAAI,KAAK,gBAER;IAED,IAAI,IAAI,gBAEP;IAED,IAAI,GAAG,gBAEN;IAED,IAAI,KAAK,gBAER;IAED,IAAI,IAAI,gBAEP;CACF"}
+{"version":3,"file":"LevelLogger.d.ts","sourceRoot":"","sources":["../../src/LevelLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAInC,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;AAEtD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,EAAE,WAAW,CAAA;IAClB,IAAI,EAAE,WAAW,CAAA;IACjB,GAAG,EAAE,WAAW,CAAA;IAChB,KAAK,EAAE,WAAW,CAAA;IAClB,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,eAAO,MAAM,QAAQ;;;;;;;EAOnB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,QAAQ,CAAC,CAAA;AAClD,MAAM,MAAM,YAAY,GAAG,WAAW,CAAA;AAEtC,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,QAAQ,CAAC,CAAA;AACtD;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAA;AAEpC,qBAAa,WAAY,YAAW,MAAM;IACxC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;gBACX,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,aAA6B;IAKhE,IAAI,KAAK,gBAER;IAED,IAAI,KAAK,gBAER;IAED,IAAI,IAAI,gBAEP;IAED,IAAI,GAAG,gBAEN;IAED,IAAI,KAAK,gBAER;IAED,IAAI,IAAI,gBAEP;CACF"}

package/dist/neutral/NoOpLogFunction.d.ts

@@ -0,0 +1,2 @@
+export declare const NoOpLogFunction: (..._data: unknown[]) => undefined;
+//# sourceMappingURL=NoOpLogFunction.d.ts.map

package/dist/neutral/NoOpLogFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoOpLogFunction.d.ts","sourceRoot":"","sources":["../../src/NoOpLogFunction.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,GAAI,GAAG,OAAO,OAAO,EAAE,cAAY,CAAA"}

package/dist/neutral/SilentLogger.d.ts

@@ -0,0 +1,17 @@
+import type { Logger } from './LevelLogger.ts';
+/**
+ * A logger that does not log anything.
+ * This is useful when you want to disable logging
+ * like when running unit tests or in silent mode.
+ * It implements the `Logger` interface but all methods
+ * are no-op functions.
+ */
+export declare class SilentLogger implements Logger {
+    readonly debug: (..._data: unknown[]) => undefined;
+    readonly error: (..._data: unknown[]) => undefined;
+    readonly info: (..._data: unknown[]) => undefined;
+    readonly log: (..._data: unknown[]) => undefined;
+    readonly trace: (..._data: unknown[]) => undefined;
+    readonly warn: (..._data: unknown[]) => undefined;
+}
+//# sourceMappingURL=SilentLogger.d.ts.map

package/dist/neutral/SilentLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SilentLogger.d.ts","sourceRoot":"","sources":["../../src/SilentLogger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAG9C;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,MAAM;IACzC,QAAQ,CAAC,KAAK,qCAAkB;IAChC,QAAQ,CAAC,KAAK,qCAAkB;IAChC,QAAQ,CAAC,IAAI,qCAAkB;IAC/B,QAAQ,CAAC,GAAG,qCAAkB;IAC9B,QAAQ,CAAC,KAAK,qCAAkB;IAChC,QAAQ,CAAC,IAAI,qCAAkB;CAChC"}

package/dist/neutral/index.d.ts

@@ -1,67 +1,7 @@
-import { EnumValue, Enum, EnumKey } from '@xylabs/enum';
-
-type LogFunction = (...data: unknown[]) => void;
-/**
- * Interface to handle overlap between Winston &
- * `console` with as much congruency as possible.
- */
-interface Logger {
-    debug: LogFunction;
-    error: LogFunction;
-    info: LogFunction;
-    log: LogFunction;
-    trace: LogFunction;
-    warn: LogFunction;
-}
-type LogLevelKey = EnumKey<typeof LogLevel>;
-type LogVerbosity = LogLevelKey;
-type LogLevelValue = EnumValue<typeof LogLevel>;
-declare const LogLevel: Enum<{
-    error: 1;
-    warn: 2;
-    info: 3;
-    log: 4;
-    debug: 5;
-    trace: 6;
-}>;
-/**
- * @deprecated Use `LogLevelValue` instead.
- * This name conflicts with the `LogLevel` enum and
- * makes it confusing to import
- */
-type LogLevel = LogLevelValue;
-declare const NoOpLogFunction: (..._data: unknown[]) => undefined;
-declare class LevelLogger implements Logger {
-    readonly level: LogLevelValue;
-    readonly logger: Logger;
-    constructor(logger: Logger, level?: LogLevelValue);
-    get debug(): LogFunction;
-    get error(): LogFunction;
-    get info(): LogFunction;
-    get log(): LogFunction;
-    get trace(): LogFunction;
-    get warn(): LogFunction;
-}
-
-declare class ConsoleLogger extends LevelLogger {
-    constructor(level?: LogLevel);
-}
-
-declare const getFunctionName: (depth?: number) => string;
-
-declare class IdLogger implements Logger {
-    private _id?;
-    private _logger;
-    constructor(logger: Logger, id?: () => string);
-    set id(id: string);
-    debug(...data: unknown[]): void;
-    error(...data: unknown[]): void;
-    info(...data: unknown[]): void;
-    log(...data: unknown[]): void;
-    trace(...data: unknown[]): void;
-    warn(...data: unknown[]): void;
-    private prefix;
-}
-
-export { ConsoleLogger, IdLogger, LevelLogger, LogLevel, NoOpLogFunction, getFunctionName };
-export type { LogFunction, LogLevelKey, LogLevelValue, LogVerbosity, Logger };
+export * from './ConsoleLogger.ts';
+export * from './getFunctionName.ts';
+export * from './IdLogger.ts';
+export * from './LevelLogger.ts';
+export * from './NoOpLogFunction.ts';
+export * from './SilentLogger.ts';
+//# sourceMappingURL=index.d.ts.map

package/{build → dist}/neutral/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA"}

package/dist/neutral/index.mjs

@@ -1,5 +1,10 @@
 // src/LevelLogger.ts
 import { Enum } from "@xylabs/enum";
+
+// src/NoOpLogFunction.ts
+var NoOpLogFunction = (..._data) => void {};
+
+// src/LevelLogger.ts
 var LogLevel = Enum({
   error: 1,
   warn: 2,
@@ -8,7 +13,6 @@ var LogLevel = Enum({
   debug: 5,
   trace: 6
 });
-var NoOpLogFunction = (..._data) => void {};
 var LevelLogger = class {
   level;
   logger;
@@ -99,12 +103,23 @@ var IdLogger = class {
     return `[${this._id?.()}]`;
   }
 };
+
+// src/SilentLogger.ts
+var SilentLogger = class {
+  debug = NoOpLogFunction;
+  error = NoOpLogFunction;
+  info = NoOpLogFunction;
+  log = NoOpLogFunction;
+  trace = NoOpLogFunction;
+  warn = NoOpLogFunction;
+};
 export {
   ConsoleLogger,
   IdLogger,
   LevelLogger,
   LogLevel,
   NoOpLogFunction,
+  SilentLogger,
   getFunctionName
 };
 //# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/LevelLogger.ts","../../src/ConsoleLogger.ts","../../src/getFunctionName.ts","../../src/IdLogger.ts"],"sourcesContent":["import type { EnumKey, EnumValue } from '@xylabs/enum'\nimport { Enum } from '@xylabs/enum'\n\nexport type LogFunction = (...data: unknown[]) => void\n\n/**\n * Interface to handle overlap between Winston &\n * `console` with as much congruency as possible.\n */\nexport interface Logger {\n  debug: LogFunction\n  error: LogFunction\n  info: LogFunction\n  log: LogFunction\n  trace: LogFunction\n  warn: LogFunction\n}\n\nexport const LogLevel = Enum({\n  error: 1,\n  warn: 2,\n  info: 3,\n  log: 4,\n  debug: 5,\n  trace: 6,\n})\n\nexport type LogLevelKey = EnumKey<typeof LogLevel>\nexport type LogVerbosity = LogLevelKey\n\nexport type LogLevelValue = EnumValue<typeof LogLevel>\n/**\n * @deprecated Use `LogLevelValue` instead.\n * This name conflicts with the `LogLevel` enum and\n * makes it confusing to import\n */\nexport type LogLevel = LogLevelValue\n\nexport const NoOpLogFunction = (..._data: unknown[]) => void {}\n\nexport class LevelLogger implements Logger {\n  readonly level: LogLevelValue\n  readonly logger: Logger\n  constructor(logger: Logger, level: LogLevelValue = LogLevel.warn) {\n    this.level = level\n    this.logger = logger\n  }\n\n  get debug() {\n    return this.level >= LogLevel.debug ? this.logger.debug : NoOpLogFunction\n  }\n\n  get error() {\n    return this.level >= LogLevel.error ? this.logger.error : NoOpLogFunction\n  }\n\n  get info() {\n    return this.level >= LogLevel.info ? this.logger.info : NoOpLogFunction\n  }\n\n  get log() {\n    return this.level >= LogLevel.log ? this.logger.log : NoOpLogFunction\n  }\n\n  get trace() {\n    return this.level >= LogLevel.trace ? this.logger.trace : NoOpLogFunction\n  }\n\n  get warn() {\n    return this.level >= LogLevel.warn ? this.logger.warn : NoOpLogFunction\n  }\n}\n","import { LevelLogger, LogLevel } from './LevelLogger.ts'\n\nexport class ConsoleLogger extends LevelLogger {\n  constructor(level: LogLevel = LogLevel.warn) {\n    super(console, level)\n  }\n}\n","import { handleError } from '@xylabs/error'\nimport { isNumber } from '@xylabs/typeof'\n\nexport const getFunctionName = (depth = 2) => {\n  try {\n    throw new Error('Getting function name')\n  } catch (ex) {\n    return handleError(ex, (error) => {\n      let newIndex: number | undefined\n      const stackParts = error.stack?.split('\\n')[depth]?.split(' ')\n      const funcName\n        = stackParts?.find((item, index) => {\n          if (item.length > 0 && item !== 'at') {\n            // check if constructor\n            if (item === 'new') {\n              newIndex = index\n            }\n            return true\n          }\n        }) ?? '<unknown>'\n      return isNumber(newIndex) ? `${funcName} ${stackParts?.[newIndex + 1]}` : funcName\n    })\n  }\n}\n","import type { Logger } from './LevelLogger.ts'\n\nexport class IdLogger implements Logger {\n  private _id?: () => string\n  private _logger: Logger\n\n  constructor(logger: Logger, id?: () => string) {\n    this._logger = logger\n    this._id = id\n  }\n\n  set id(id: string) {\n    this._id = () => id\n  }\n\n  debug(...data: unknown[]) {\n    this._logger?.debug(this.prefix(), ...data)\n  }\n\n  error(...data: unknown[]) {\n    this._logger?.error(this.prefix(), ...data)\n  }\n\n  info(...data: unknown[]) {\n    this._logger?.info(this.prefix(), ...data)\n  }\n\n  log(...data: unknown[]) {\n    this._logger?.log(this.prefix(), ...data)\n  }\n\n  trace(...data: unknown[]) {\n    this._logger?.trace(this.prefix(), ...data)\n  }\n\n  warn(...data: unknown[]) {\n    this._logger?.warn(this.prefix(), ...data)\n  }\n\n  private prefix() {\n    return `[${this._id?.()}]`\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/LevelLogger.ts","../../src/NoOpLogFunction.ts","../../src/ConsoleLogger.ts","../../src/getFunctionName.ts","../../src/IdLogger.ts","../../src/SilentLogger.ts"],"sourcesContent":["import type { EnumKey, EnumValue } from '@xylabs/enum'\nimport { Enum } from '@xylabs/enum'\n\nimport { NoOpLogFunction } from './NoOpLogFunction.ts'\n\nexport type LogFunction = (...data: unknown[]) => void\n\n/**\n * Interface to handle overlap between Winston &\n * `console` with as much congruency as possible.\n */\nexport interface Logger {\n  debug: LogFunction\n  error: LogFunction\n  info: LogFunction\n  log: LogFunction\n  trace: LogFunction\n  warn: LogFunction\n}\n\nexport const LogLevel = Enum({\n  error: 1,\n  warn: 2,\n  info: 3,\n  log: 4,\n  debug: 5,\n  trace: 6,\n})\n\nexport type LogLevelKey = EnumKey<typeof LogLevel>\nexport type LogVerbosity = LogLevelKey\n\nexport type LogLevelValue = EnumValue<typeof LogLevel>\n/**\n * @deprecated Use `LogLevelValue` instead.\n * This name conflicts with the `LogLevel` enum and\n * makes it confusing to import\n */\nexport type LogLevel = LogLevelValue\n\nexport class LevelLogger implements Logger {\n  readonly level: LogLevelValue\n  readonly logger: Logger\n  constructor(logger: Logger, level: LogLevelValue = LogLevel.warn) {\n    this.level = level\n    this.logger = logger\n  }\n\n  get debug() {\n    return this.level >= LogLevel.debug ? this.logger.debug : NoOpLogFunction\n  }\n\n  get error() {\n    return this.level >= LogLevel.error ? this.logger.error : NoOpLogFunction\n  }\n\n  get info() {\n    return this.level >= LogLevel.info ? this.logger.info : NoOpLogFunction\n  }\n\n  get log() {\n    return this.level >= LogLevel.log ? this.logger.log : NoOpLogFunction\n  }\n\n  get trace() {\n    return this.level >= LogLevel.trace ? this.logger.trace : NoOpLogFunction\n  }\n\n  get warn() {\n    return this.level >= LogLevel.warn ? this.logger.warn : NoOpLogFunction\n  }\n}\n","export const NoOpLogFunction = (..._data: unknown[]) => void {}\n","import { LevelLogger, LogLevel } from './LevelLogger.ts'\n\nexport class ConsoleLogger extends LevelLogger {\n  constructor(level: LogLevel = LogLevel.warn) {\n    super(console, level)\n  }\n}\n","import { handleError } from '@xylabs/error'\nimport { isNumber } from '@xylabs/typeof'\n\nexport const getFunctionName = (depth = 2) => {\n  try {\n    throw new Error('Getting function name')\n  } catch (ex) {\n    return handleError(ex, (error) => {\n      let newIndex: number | undefined\n      const stackParts = error.stack?.split('\\n')[depth]?.split(' ')\n      const funcName\n        = stackParts?.find((item, index) => {\n          if (item.length > 0 && item !== 'at') {\n            // check if constructor\n            if (item === 'new') {\n              newIndex = index\n            }\n            return true\n          }\n        }) ?? '<unknown>'\n      return isNumber(newIndex) ? `${funcName} ${stackParts?.[newIndex + 1]}` : funcName\n    })\n  }\n}\n","import type { Logger } from './LevelLogger.ts'\n\nexport class IdLogger implements Logger {\n  private _id?: () => string\n  private _logger: Logger\n\n  constructor(logger: Logger, id?: () => string) {\n    this._logger = logger\n    this._id = id\n  }\n\n  set id(id: string) {\n    this._id = () => id\n  }\n\n  debug(...data: unknown[]) {\n    this._logger?.debug(this.prefix(), ...data)\n  }\n\n  error(...data: unknown[]) {\n    this._logger?.error(this.prefix(), ...data)\n  }\n\n  info(...data: unknown[]) {\n    this._logger?.info(this.prefix(), ...data)\n  }\n\n  log(...data: unknown[]) {\n    this._logger?.log(this.prefix(), ...data)\n  }\n\n  trace(...data: unknown[]) {\n    this._logger?.trace(this.prefix(), ...data)\n  }\n\n  warn(...data: unknown[]) {\n    this._logger?.warn(this.prefix(), ...data)\n  }\n\n  private prefix() {\n    return `[${this._id?.()}]`\n  }\n}\n","import type { Logger } from './LevelLogger.ts'\nimport { NoOpLogFunction } from './NoOpLogFunction.ts'\n\n/**\n * A logger that does not log anything.\n * This is useful when you want to disable logging\n * like when running unit tests or in silent mode.\n * It implements the `Logger` interface but all methods\n * are no-op functions.\n */\nexport class SilentLogger implements Logger {\n  readonly debug = NoOpLogFunction\n  readonly error = NoOpLogFunction\n  readonly info = NoOpLogFunction\n  readonly log = NoOpLogFunction\n  readonly trace = NoOpLogFunction\n  readonly warn = NoOpLogFunction\n}\n"],"mappings":"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","names":[]}

package/dist/neutral/spec/IdLogger.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IdLogger.spec.d.ts.map

package/dist/neutral/spec/IdLogger.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdLogger.spec.d.ts","sourceRoot":"","sources":["../../../src/spec/IdLogger.spec.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/logger",
-  "version": "4.13.15",
+  "version": "4.13.17",
   "description": "XYLabs Logger Library",
   "keywords": [
     "logger",
@@ -36,14 +36,14 @@
   "module": "dist/neutral/index.mjs",
   "types": "dist/neutral/index.d.ts",
   "dependencies": {
-    "@xylabs/enum": "^4.13.15",
-    "@xylabs/error": "^4.13.15",
-    "@xylabs/typeof": "^4.13.15"
+    "@xylabs/enum": "^4.13.17",
+    "@xylabs/error": "^4.13.17",
+    "@xylabs/typeof": "^4.13.17"
   },
   "devDependencies": {
-    "@types/node": "^24.0.13",
-    "@xylabs/ts-scripts-yarn3": "^7.0.0-rc.20",
-    "@xylabs/tsconfig": "^7.0.0-rc.20",
+    "@types/node": "^24.0.14",
+    "@xylabs/ts-scripts-yarn3": "^7.0.0-rc.27",
+    "@xylabs/tsconfig": "^7.0.0-rc.27",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4"
   },

package/src/LevelLogger.ts

@@ -1,6 +1,8 @@
 import type { EnumKey, EnumValue } from '@xylabs/enum'
 import { Enum } from '@xylabs/enum'
 
+import { NoOpLogFunction } from './NoOpLogFunction.ts'
+
 export type LogFunction = (...data: unknown[]) => void
 
 /**
@@ -36,8 +38,6 @@ export type LogLevelValue = EnumValue<typeof LogLevel>
  */
 export type LogLevel = LogLevelValue
 
-export const NoOpLogFunction = (..._data: unknown[]) => void {}
-
 export class LevelLogger implements Logger {
   readonly level: LogLevelValue
   readonly logger: Logger

package/src/NoOpLogFunction.ts

@@ -0,0 +1 @@
+export const NoOpLogFunction = (..._data: unknown[]) => void {}

package/src/SilentLogger.ts

@@ -0,0 +1,18 @@
+import type { Logger } from './LevelLogger.ts'
+import { NoOpLogFunction } from './NoOpLogFunction.ts'
+
+/**
+ * A logger that does not log anything.
+ * This is useful when you want to disable logging
+ * like when running unit tests or in silent mode.
+ * It implements the `Logger` interface but all methods
+ * are no-op functions.
+ */
+export class SilentLogger implements Logger {
+  readonly debug = NoOpLogFunction
+  readonly error = NoOpLogFunction
+  readonly info = NoOpLogFunction
+  readonly log = NoOpLogFunction
+  readonly trace = NoOpLogFunction
+  readonly warn = NoOpLogFunction
+}

package/src/index.ts

@@ -2,3 +2,5 @@ export * from './ConsoleLogger.ts'
 export * from './getFunctionName.ts'
 export * from './IdLogger.ts'
 export * from './LevelLogger.ts'
+export * from './NoOpLogFunction.ts'
+export * from './SilentLogger.ts'

package/build/neutral/index.d.ts

@@ -1,5 +0,0 @@
-export * from './ConsoleLogger.ts';
-export * from './getFunctionName.ts';
-export * from './IdLogger.ts';
-export * from './LevelLogger.ts';
-//# sourceMappingURL=index.d.ts.map