nlogs 1.1.3 → 2.4.1

package/README.md

@@ -1,200 +0,0 @@
-# nlogs
-
-new custom logger for Node.js
-
-## Install 
-
-```
-npm i nlogs
-```
-or:
-```
-yarn add nlogs
-```
-
-
-## Use 
-
-```js
-const logger = require('nlogs')(module, {/* config */})
-```
-```js
-const Logger = require('nlogs')
-const { NLogger }  = require('nlogs')
-
-const logger1 = Logger(/* filename */, {/* config */})
-const logger2 = new NLogger(/* filename */, {/* config */})
-```
-
----
-
-### Logger methods
-
-> Most methods repeat console methods
-
-```js
-logger.log('text')
-logger.info('text')
-logger.debug('text')
-logger.warn('text')
-logger.error('text')
-logger.time('text')
-logger.timeLog('text')
-logger.timeEnd('text')
-logger.dir({ a: 1})
-logger.table([
-    { a: 1 }
-])
-```
-
-**format messages:**
-`short time` `file segments` `label` `message`
-```
- ..22:40:33 nlogs/lib/test.js info   message
-```
-
----
-
-### Params:
-
-#### filename
-
-**String**
-
-```js
-const Logger = require('nlogs')
-
-const logger = Logger('/Users/mac/nlogs/lib/file.js')
-```
-
-**Object** or **Module**
-
-```js
-const Logger = require('nlogs')
-
-const logger = Logger({
-    filename: '/Users/mac/nlogs/lib/file.js'
-})
-```
-
-or:
-
-```js
-const logger = require('nlogs')(module)
-```
-
-**import.meta**
-
-```js
-import Logger from 'nlogs'
-
-const logger = Logger(import.meta)
-```
-
----
-
-#### config 
-
-optional argument. An object 
-> [default config](https://github.com/nerjs/nlogs/blob/master/lib/defaultConfig.js)
-
-###### Style
-> **Style** property is an Array of Strings
-> For styling, the [colors](https://github.com/Marak/colors.js#colorsjs) module is used. But you can use [your own](#formatters).
-
-|prop name|type|default|description|
-|:--:|:--:|:--:|:--|
-|***time***|**Style**|`['gray', 'bgBlack']`|style for default build time label|
-|***label***|**Style**|`['white', 'bold']`|style for default build methodName label|
-|***segments***|**[Segment](#segments)**||style for default build segments (path & moduleName) label|
-|***formatters***|**[Formatters](#formatters)**||custom formatters|
-|***enableFileLink***|**Boolean**|`true`| [terminal-link](https://github.com/sindresorhus/terminal-link#readme)|
-|***groupedEveryTime***|`'minute' | 'hour' | 'day' | null `|`'hour'`|if not NULL, each time the indicated timestamp of the log does not match the previous one, an additional message is displayed indicating the full date and time|
-|***methods***|**[Methods](#methods)**||config for each method|
-
-
-##### Formatters
-
-> formatters are Functions
-
-|prop name|arguments|default|description|
-|:--:|:--:|:--:|:--|
-|***string***|**String**, **[Styles](#style)**|[stringFormatter](https://github.com/nerjs/nlogs/blob/master/lib/stringFormatter.js)|format string labels with styles|
-|***time***|**timestamp**, **isShort: Boolean**|[timeFormatter.js](https://github.com/nerjs/nlogs/blob/master/lib/timeFormatter.js)|format time labels|
-
-##### Segments 
-
-> segments is the converted path to the file relative to the root (at the level of the nearest package.json
-
-**Example:**
-
-filename: `/Users/mac/nlogs/lib/file.js`
-package.json: `/Users/mac/nlogs-directory/package.json`
-package name: `nlogs`
-
-result: `nlogs/lib/file.js`
-
-> Each property describes a style as an array of strings.
-
-|prop name|default|description|
-|:--:|:--:|:--|
-|***first***|`['yellow', 'italic', 'dim']`|first segment (moduleName)|
-|***last***|`['cyan', 'italic']`|filename style|
-|***all***|`['grey', 'italic']`|path sections (from module dir to filename)|
-|***delimiter***|`['gray']`|separator path sections. `path.sep` from module `path`|
-
-
-##### methods
-
-> Settings for each of the [methods](#logger-methods) separately. 
-
-* log
-* info
-* debug
-* warn
-* error
-* time (*time*, *timeEnd*, *timeLog* methods)
-* dir
-* table
-
-> Some properties, in their absence, are taken from the [config](#config) 
-
-**method config**
-
-|prop name|type|description|
-|:--:|:--:|:--|
-|***show***|**Boolean**|Sets whether this method works|
-|***time***|**[Style](#style)**|style for method build time label. If not specified, use default|
-|***segments***|**[Segments](#segments)**|style for method build segments (path & moduleName) label. If not specified, use default|
-|***label***|**[Style](#style)**|style for method build methodName label. If not specified, use default|
-|***showStartTimer***|**Boolean**|Show message when invoking logger.time()? Only time method|
-|***warningPresentLabel***|**Boolean**|warning if the label exists when invoking logger.time(). Only time method|
-|***warningMissingLabel***|**Boolean**|warning if the label does not exist when invoking logger.timeEnd() and logger.timeLog(). Only time method|
-|***changePresentLabel***|**Boolean**|overwrite the label if one already exists. Only time method|
-|***diffTimeColor***|**[Style](#style)**|diff time style. Only time method|
-|***depth***|**Number**|depth param to dir method|
-
-
-### Global configs
-
-```js
-const { getConfig, setConfig } = require('nlogs')
-```
-
-### logger.time()
-
-> **logger.time(label)** returns tmeEnd Function
-
-```js
-logger.time('label')
-logger.timeLog('label')
-logger.timeEnd('label')
-```
-
-equivalent:
-
-```js
-const timeEnd = logger.time('label')
-timeEnd.log()
-timeEnd()
-```

package/dist/abstract.base.logger.d.ts

@@ -0,0 +1,46 @@
+import { ILogger } from './helpers/types';
+import { StaticLogger } from './utils/static.logger';
+import { Mod } from './utils/mod';
+import { IFormatter, IOutLogger } from './utils/types';
+import { LogReader } from './utils/log.reader';
+import { Meta } from './message/meta';
+import { AllowedList } from './utils/allowed.list';
+import { LogInfo } from './message/log.info';
+import { TraceStore } from './utils/trace.store';
+export interface IAbstractBaseLoggerOptions {
+    show?: boolean;
+    isDev?: boolean;
+    debugLevels: string[];
+    moduleDebugLevels: string[];
+    allowedLevels?: string | string[] | null;
+    hiddenDetails?: Record<string, any>;
+    strictLevelRules?: boolean;
+}
+export declare abstract class AbstractBaseLogger<O extends IAbstractBaseLoggerOptions, TD extends object> extends StaticLogger implements ILogger {
+    #private;
+    protected abstract readonly module: Mod;
+    protected abstract readonly meta: Meta;
+    protected abstract readonly categoriesAllowedList: AllowedList;
+    protected abstract readonly debugAllowedList: AllowedList;
+    protected abstract readonly formatter: IFormatter;
+    protected abstract readonly reader: LogReader;
+    protected abstract readonly outLogs: IOutLogger;
+    protected abstract readonly options: O;
+    protected abstract readonly traceStore: TraceStore<TD>;
+    log: (...msgs: any[]) => void;
+    debug: (...msgs: any[]) => void;
+    trace: (...msgs: any[]) => void;
+    info: (...msgs: any[]) => void;
+    warn: (...msgs: any[]) => void;
+    error: (...msgs: any[]) => void;
+    fatal: (...msgs: any[]) => void;
+    protected readMessages(level: string, std: string, msgs: any[]): LogInfo;
+    private get loggingRulesModule();
+    private get loggingShowCategory();
+    private get loggingShowDebug();
+    private get loggingMainRules();
+    protected preCheckLoggingRules(level: string): boolean;
+    protected postCheckLoggingRules(info: LogInfo): boolean;
+    protected logTo(level: string, std: 'out' | 'error', msgs: any[]): void;
+    protected logToOut(std: 'out' | 'error', message: string): void;
+}

package/dist/abstract.base.logger.js

@@ -0,0 +1,119 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _AbstractBaseLogger_loggingShowCategory, _AbstractBaseLogger_loggingShowDebug, _AbstractBaseLogger_loggingMainRules;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractBaseLogger = void 0;
+const static_logger_1 = require("./utils/static.logger");
+const logging_rules_1 = require("./logging.rules");
+const constants_1 = require("./constants");
+class AbstractBaseLogger extends static_logger_1.StaticLogger {
+    constructor() {
+        super(...arguments);
+        this.log = (...msgs) => {
+            this.logTo('log', 'out', msgs);
+        };
+        this.debug = (...msgs) => {
+            this.logTo('debug', 'out', msgs);
+        };
+        this.trace = (...msgs) => {
+            this.logTo('trace', 'out', msgs);
+        };
+        this.info = (...msgs) => {
+            this.logTo('info', 'out', msgs);
+        };
+        this.warn = (...msgs) => {
+            this.logTo('warn', 'error', msgs);
+        };
+        this.error = (...msgs) => {
+            this.logTo('error', 'error', msgs);
+        };
+        this.fatal = (...msgs) => {
+            this.logTo('fatal', 'error', msgs);
+        };
+        _AbstractBaseLogger_loggingShowCategory.set(this, void 0);
+        _AbstractBaseLogger_loggingShowDebug.set(this, void 0);
+        _AbstractBaseLogger_loggingMainRules.set(this, void 0);
+    }
+    readMessages(level, std, msgs) {
+        return this.reader.read(this.meta, [
+            static_logger_1.StaticLogger.level(level),
+            this.module.type === 'module' ? static_logger_1.StaticLogger.module(this.module) : static_logger_1.StaticLogger.empty(),
+            static_logger_1.StaticLogger.timestamp(new Date()),
+            static_logger_1.StaticLogger.traceId(this.traceStore.traceId),
+            static_logger_1.StaticLogger.hiddenDetails({
+                _dev: this.options.isDev,
+                _std: std,
+                _traceIds: this.traceStore.traceIds,
+            }),
+            static_logger_1.StaticLogger.details(this.traceStore.details),
+            this.options.hiddenDetails ? static_logger_1.StaticLogger.hiddenDetails(this.options.hiddenDetails) : static_logger_1.StaticLogger.empty(),
+            ...msgs,
+        ]);
+    }
+    get loggingRulesModule() {
+        return this.module.type === 'module' ? this.module.name : false;
+    }
+    get loggingShowCategory() {
+        if (__classPrivateFieldGet(this, _AbstractBaseLogger_loggingShowCategory, "f") === undefined)
+            __classPrivateFieldSet(this, _AbstractBaseLogger_loggingShowCategory, this.categoriesAllowedList.allow(this.meta.category, this.loggingRulesModule), "f");
+        return __classPrivateFieldGet(this, _AbstractBaseLogger_loggingShowCategory, "f");
+    }
+    get loggingShowDebug() {
+        if (__classPrivateFieldGet(this, _AbstractBaseLogger_loggingShowDebug, "f") === undefined)
+            __classPrivateFieldSet(this, _AbstractBaseLogger_loggingShowDebug, this.debugAllowedList.allow(this.meta.category, this.loggingRulesModule), "f");
+        return __classPrivateFieldGet(this, _AbstractBaseLogger_loggingShowDebug, "f");
+    }
+    get loggingMainRules() {
+        if (!__classPrivateFieldGet(this, _AbstractBaseLogger_loggingMainRules, "f")) {
+            __classPrivateFieldSet(this, _AbstractBaseLogger_loggingMainRules, {
+                debugLevels: this.options.debugLevels,
+                moduleDebugLevels: this.options.moduleDebugLevels,
+                allowedLevels: this.options.allowedLevels,
+                isDev: this.options.isDev,
+                isModule: !!this.loggingRulesModule,
+                showLogger: this.options.show,
+            }, "f");
+        }
+        return __classPrivateFieldGet(this, _AbstractBaseLogger_loggingMainRules, "f");
+    }
+    preCheckLoggingRules(level) {
+        if (!this.options.strictLevelRules)
+            return true;
+        return (0, logging_rules_1.loggingRules)(level, {
+            showCategory: this.loggingShowCategory,
+            showDebug: this.loggingShowDebug,
+        }, this.loggingMainRules);
+    }
+    postCheckLoggingRules(info) {
+        return (0, logging_rules_1.loggingRules)(info.meta.level, {
+            showCategory: this.loggingShowCategory,
+            showDebug: this.loggingShowDebug,
+            showLog: info.show,
+        }, this.loggingMainRules);
+    }
+    logTo(level, std, msgs) {
+        if (!this.preCheckLoggingRules(level))
+            return;
+        const info = this.readMessages(level, std === 'out' ? constants_1.STDOUT : constants_1.STDERR, msgs);
+        if (!this.postCheckLoggingRules(info))
+            return;
+        const str = this.formatter.format(info);
+        this.logToOut(std, str);
+    }
+    logToOut(std, message) {
+        this.outLogs[std](message);
+    }
+}
+exports.AbstractBaseLogger = AbstractBaseLogger;
+_AbstractBaseLogger_loggingShowCategory = new WeakMap(), _AbstractBaseLogger_loggingShowDebug = new WeakMap(), _AbstractBaseLogger_loggingMainRules = new WeakMap();
+//# sourceMappingURL=abstract.base.logger.js.map

package/dist/abstract.base.logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.base.logger.js","sourceRoot":"","sources":["../src/abstract.base.logger.ts"],"names":[],"mappings":"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"}

package/dist/base.logger.d.ts

@@ -0,0 +1,62 @@
+import { AbstractBaseLogger, IAbstractBaseLoggerOptions } from './abstract.base.logger';
+import { Meta } from './message/meta';
+import { AllowedList } from './utils/allowed.list';
+import { Cat } from './utils/category';
+import { LogReader } from './utils/log.reader';
+import { Mod } from './utils/mod';
+import { ModResolver } from './utils/mod.resolver';
+import { TraceStore, WithTraceId } from './utils/trace.store';
+import { IFormatter, IOutLogger } from './utils/types';
+import { loggerOptions } from './options';
+import { MaybePromise } from './helpers/types';
+export interface BaseTraceDetails {
+}
+export interface IBaseLoggerOptions {
+    show?: boolean;
+    index?: string;
+}
+type BaseOptions<T extends IBaseLoggerOptions> = typeof loggerOptions & IAbstractBaseLoggerOptions & Partial<T>;
+export declare class BaseLogger<T extends IBaseLoggerOptions> extends AbstractBaseLogger<BaseOptions<T>, BaseTraceDetails> {
+    protected categoriesAllowedList: AllowedList;
+    protected debugAllowedList: AllowedList;
+    protected formatter: IFormatter;
+    protected reader: LogReader;
+    protected outLogs: IOutLogger;
+    protected traceStore: TraceStore<BaseTraceDetails>;
+    readonly module: Mod;
+    readonly meta: Meta;
+    protected options: BaseOptions<T>;
+    constructor(cat?: Cat);
+    constructor(cat: Cat | null, options?: Partial<T>);
+    get staticLogger(): typeof BaseLogger;
+    show(value: boolean): void;
+    static moduleResolver: ModResolver;
+    static loggerOptions: {
+        debugLevels: string[];
+        moduleDebugLevels: string[];
+        allowedLevels: string | string[];
+        hiddenDetails: Record<string, any>;
+        isDev: boolean;
+        strictLevelRules: boolean;
+        index: string;
+        formatterType: "string" | "json" | "dark" | "light";
+        categoriesAllowedList: string;
+        debugAllowedList: string;
+        defaultProject: string;
+        defaultService: string;
+        defaultCategory: string;
+    };
+    static categoriesAllowedList: AllowedList;
+    static debugAllowedList: AllowedList;
+    static formatter: IFormatter;
+    static reader: LogReader;
+    static outLogs: IOutLogger;
+    static traceStore: TraceStore<BaseTraceDetails>;
+    static defaultMeta: Meta;
+    static setTraceDetails(traceDetails: Record<string, any>): void;
+    static mergeTraceDetails(traceDetails: Record<string, any>): void;
+    static run<R extends MaybePromise<any>>(callback: () => R): R;
+    static run<R extends MaybePromise<any>>(traceId: string, callback: () => R): R;
+    static run<R extends MaybePromise<any>, D extends WithTraceId>(details: D, callback: () => R): R;
+}
+export {};

package/dist/base.logger.js

@@ -0,0 +1,101 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseLogger = void 0;
+const abstract_base_logger_1 = require("./abstract.base.logger");
+const meta_1 = require("./message/meta");
+const allowed_list_1 = require("./utils/allowed.list");
+const category_1 = require("./utils/category");
+const log_reader_1 = require("./utils/log.reader");
+const mod_resolver_1 = require("./utils/mod.resolver");
+const trace_store_1 = require("./utils/trace.store");
+const stack_1 = require("./helpers/stack");
+const console_out_1 = require("./utils/console.out");
+const json_formatter_1 = require("./utils/json.formatter");
+const string_formatter_1 = require("./utils/string.formatter");
+const light_string_formatter_1 = require("./utils/light.string.formatter");
+const dark_string_formatter_1 = require("./utils/dark.string.formatter");
+const options_1 = require("./options");
+class BaseLogger extends abstract_base_logger_1.AbstractBaseLogger {
+    constructor(cat, options) {
+        super();
+        this.categoriesAllowedList = this.staticLogger.categoriesAllowedList;
+        this.debugAllowedList = this.staticLogger.debugAllowedList;
+        this.formatter = this.staticLogger.formatter;
+        this.reader = this.staticLogger.reader;
+        this.outLogs = this.staticLogger.outLogs;
+        this.traceStore = this.staticLogger.traceStore;
+        const pathname = (0, stack_1.getTopStackFile)(this.constructor);
+        this.module = this.staticLogger.moduleResolver.resolve(pathname);
+        const category = new category_1.Category(this.module, cat || category_1.Category.relativePath(pathname, this.module));
+        this.meta = this.staticLogger.defaultMeta.clone();
+        if (!this.meta.service)
+            this.meta.set('service', this.module.name);
+        this.meta.set('category', category.name);
+        this.meta.set('traceId', this.traceStore.traceId);
+        this.meta.set('timestamp', new Date());
+        this.options = {
+            ...this.staticLogger.loggerOptions,
+            ...(options || {}),
+        };
+        if (options?.index)
+            this.meta.set('index', options.index);
+        if (options?.show != null)
+            this.options.show = options.show;
+        ['traceStore', 'categoriesAllowedList', 'debugAllowedList', 'formatter', 'reader', 'outLogs', 'traceStore', 'options'].forEach(key => {
+            Object.defineProperty(this, key, {
+                value: this[key],
+                enumerable: false,
+                configurable: true,
+            });
+        });
+        const categoryName = this.meta.category.replace(/\s+/g, '_');
+        Object.keys(this)
+            .filter(key => typeof this[key] === 'function' && !this[key].name)
+            .forEach(key => Object.defineProperty(this[key], 'name', {
+            value: `${categoryName}~${key}`,
+        }));
+    }
+    get staticLogger() {
+        return this.constructor;
+    }
+    show(value) {
+        this.options.show = !!value;
+    }
+    static setTraceDetails(traceDetails) {
+        this.traceStore.setDetails(traceDetails);
+    }
+    static mergeTraceDetails(traceDetails) {
+        this.traceStore.mergeDetails(traceDetails);
+    }
+    static run(callBackOrDetOtrId, callback) {
+        return this.traceStore.run(callBackOrDetOtrId, callback);
+    }
+}
+exports.BaseLogger = BaseLogger;
+_a = BaseLogger;
+BaseLogger.moduleResolver = new mod_resolver_1.ModResolver();
+BaseLogger.loggerOptions = (() => {
+    const opt = { ...options_1.loggerOptions };
+    opt.hiddenDetails._app = _a.moduleResolver.app;
+    return opt;
+})();
+BaseLogger.categoriesAllowedList = new allowed_list_1.AllowedList(_a.loggerOptions.categoriesAllowedList);
+BaseLogger.debugAllowedList = new allowed_list_1.AllowedList(_a.loggerOptions.debugAllowedList);
+BaseLogger.formatter = (() => {
+    switch (_a.loggerOptions.formatterType) {
+        case 'json':
+            return new json_formatter_1.JsonFormatter();
+        case 'string':
+            return new string_formatter_1.StringFormatter();
+        case 'light':
+            return new light_string_formatter_1.LightStringFormatter();
+        case 'dark':
+            return new dark_string_formatter_1.DarkStringFormatter();
+    }
+})();
+BaseLogger.reader = new log_reader_1.LogReader(_a.formatter);
+BaseLogger.outLogs = new console_out_1.ConsoleOut(process.stdout, process.stderr);
+BaseLogger.traceStore = new trace_store_1.TraceStore();
+BaseLogger.defaultMeta = new meta_1.Meta(_a.loggerOptions.defaultProject, _a.loggerOptions.defaultService, _a.loggerOptions.defaultCategory, 'log', '', new Date());
+//# sourceMappingURL=base.logger.js.map

package/dist/base.logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.logger.js","sourceRoot":"","sources":["../src/base.logger.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,19 @@
+export declare const DEFAULT_DEBUG_LEVELS: string[];
+export declare const DEFAULT_MODULE_DEBUG_LEVELS: string[];
+export declare const DEFAULT_STRICT_LEVEL_RULES = true;
+export declare const DEFAULT_PROJECT = "main";
+export declare const DEFAULT_SERVICE = "";
+export declare const DEFAULT_CATEGORY = "default";
+export declare const PRODUCTION_FORMATTER = "json";
+export declare const DEFAULT_FORMATTER = "dark";
+export declare const DEFAULT_MAX_CACHE_TIME_MS: number;
+export declare const MIN_MAX_CACHE_TIME_MS: number;
+export declare const DEFAULT_CHECK_CACHE_TIMEOUT_MS: number;
+export declare const MIN_CHECK_CACHE_TIMEOUT_MS: number;
+export declare const DEFAULT_MAX_CACHE_SIZE = 10000;
+export declare const MIN_MAX_CACHE_SIZE = 100;
+export declare const DEFAULT_LOG_ON_START = true;
+export declare const STDOUT = "stdout";
+export declare const STDERR = "stderr";
+export declare const TIME_LOG = "timeLog";
+export declare const TIME_END = "timeEnd";

package/dist/constants.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIME_END = exports.TIME_LOG = exports.STDERR = exports.STDOUT = exports.DEFAULT_LOG_ON_START = exports.MIN_MAX_CACHE_SIZE = exports.DEFAULT_MAX_CACHE_SIZE = exports.MIN_CHECK_CACHE_TIMEOUT_MS = exports.DEFAULT_CHECK_CACHE_TIMEOUT_MS = exports.MIN_MAX_CACHE_TIME_MS = exports.DEFAULT_MAX_CACHE_TIME_MS = exports.DEFAULT_FORMATTER = exports.PRODUCTION_FORMATTER = exports.DEFAULT_CATEGORY = exports.DEFAULT_SERVICE = exports.DEFAULT_PROJECT = exports.DEFAULT_STRICT_LEVEL_RULES = exports.DEFAULT_MODULE_DEBUG_LEVELS = exports.DEFAULT_DEBUG_LEVELS = void 0;
+exports.DEFAULT_DEBUG_LEVELS = ['trace', 'debug'];
+exports.DEFAULT_MODULE_DEBUG_LEVELS = ['trace', 'debug', 'log'];
+exports.DEFAULT_STRICT_LEVEL_RULES = true;
+exports.DEFAULT_PROJECT = 'main';
+exports.DEFAULT_SERVICE = '';
+exports.DEFAULT_CATEGORY = 'default';
+exports.PRODUCTION_FORMATTER = 'json';
+exports.DEFAULT_FORMATTER = 'dark';
+exports.DEFAULT_MAX_CACHE_TIME_MS = 1000 * 60 * 60 * 24;
+exports.MIN_MAX_CACHE_TIME_MS = 1000 * 60 * 60 * 1;
+exports.DEFAULT_CHECK_CACHE_TIMEOUT_MS = 1000 * 10;
+exports.MIN_CHECK_CACHE_TIMEOUT_MS = 1000 * 1;
+exports.DEFAULT_MAX_CACHE_SIZE = 10000;
+exports.MIN_MAX_CACHE_SIZE = 100;
+exports.DEFAULT_LOG_ON_START = true;
+exports.STDOUT = 'stdout';
+exports.STDERR = 'stderr';
+exports.TIME_LOG = 'timeLog';
+exports.TIME_END = 'timeEnd';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,oBAAoB,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AACzC,QAAA,2BAA2B,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;AACvD,QAAA,0BAA0B,GAAG,IAAI,CAAA;AACjC,QAAA,eAAe,GAAG,MAAM,CAAA;AACxB,QAAA,eAAe,GAAG,EAAE,CAAA;AACpB,QAAA,gBAAgB,GAAG,SAAS,CAAA;AAC5B,QAAA,oBAAoB,GAAG,MAAM,CAAA;AAC7B,QAAA,iBAAiB,GAAG,MAAM,CAAA;AAC1B,QAAA,yBAAyB,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;AAC/C,QAAA,qBAAqB,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAC1C,QAAA,8BAA8B,GAAG,IAAI,GAAG,EAAE,CAAA;AAC1C,QAAA,0BAA0B,GAAG,IAAI,GAAG,CAAC,CAAA;AACrC,QAAA,sBAAsB,GAAG,KAAK,CAAA;AAC9B,QAAA,kBAAkB,GAAG,GAAG,CAAA;AACxB,QAAA,oBAAoB,GAAG,IAAI,CAAA;AAE3B,QAAA,MAAM,GAAG,QAAQ,CAAA;AACjB,QAAA,MAAM,GAAG,QAAQ,CAAA;AAEjB,QAAA,QAAQ,GAAG,SAAS,CAAA;AACpB,QAAA,QAAQ,GAAG,SAAS,CAAA"}

package/dist/errors/cat.nlogs.error.d.ts

@@ -0,0 +1,4 @@
+import { NlogsError } from './nlogs.error';
+export declare class CatNlogsError extends NlogsError {
+    readonly code = "CAT_NLOGS_ERR";
+}

package/dist/errors/cat.nlogs.error.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CatNlogsError = void 0;
+const nlogs_error_1 = require("./nlogs.error");
+class CatNlogsError extends nlogs_error_1.NlogsError {
+    constructor() {
+        super(...arguments);
+        this.code = 'CAT_NLOGS_ERR';
+    }
+}
+exports.CatNlogsError = CatNlogsError;
+//# sourceMappingURL=cat.nlogs.error.js.map

package/dist/errors/cat.nlogs.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cat.nlogs.error.js","sourceRoot":"","sources":["../../src/errors/cat.nlogs.error.ts"],"names":[],"mappings":";;;AAAA,+CAA0C;AAE1C,MAAa,aAAc,SAAQ,wBAAU;IAA7C;;QACW,SAAI,GAAG,eAAe,CAAA;IACjC,CAAC;CAAA;AAFD,sCAEC"}

package/dist/errors/fs.nlogs.error.d.ts

@@ -0,0 +1,4 @@
+import { NlogsError } from './nlogs.error';
+export declare class FsNlogsError extends NlogsError {
+    readonly code = "FS_NLOGS_ERR";
+}

package/dist/errors/fs.nlogs.error.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FsNlogsError = void 0;
+const nlogs_error_1 = require("./nlogs.error");
+class FsNlogsError extends nlogs_error_1.NlogsError {
+    constructor() {
+        super(...arguments);
+        this.code = 'FS_NLOGS_ERR';
+    }
+}
+exports.FsNlogsError = FsNlogsError;
+//# sourceMappingURL=fs.nlogs.error.js.map

package/dist/errors/fs.nlogs.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.nlogs.error.js","sourceRoot":"","sources":["../../src/errors/fs.nlogs.error.ts"],"names":[],"mappings":";;;AAAA,+CAA0C;AAE1C,MAAa,YAAa,SAAQ,wBAAU;IAA5C;;QACW,SAAI,GAAG,cAAc,CAAA;IAChC,CAAC;CAAA;AAFD,oCAEC"}

package/dist/errors/item.nlogs.error.d.ts

@@ -0,0 +1,4 @@
+import { NlogsError } from './nlogs.error';
+export declare class ItemNlogsError extends NlogsError {
+    readonly code: 'ITEM_NLOGS_ERR';
+}

package/dist/errors/item.nlogs.error.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ItemNlogsError = void 0;
+const nlogs_error_1 = require("./nlogs.error");
+class ItemNlogsError extends nlogs_error_1.NlogsError {
+}
+exports.ItemNlogsError = ItemNlogsError;
+//# sourceMappingURL=item.nlogs.error.js.map

package/dist/errors/item.nlogs.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item.nlogs.error.js","sourceRoot":"","sources":["../../src/errors/item.nlogs.error.ts"],"names":[],"mappings":";;;AAAA,+CAA0C;AAE1C,MAAa,cAAe,SAAQ,wBAAU;CAE7C;AAFD,wCAEC"}