@venizia/ignis-helpers 0.2.0-2 → 0.2.0-20

package/dist/cjs/modules/logger/resolver.js.map

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

package/dist/cjs/modules/logger/winston/common/constants.d.ts

@@ -0,0 +1,8 @@
+/** Not re-exported from `common/index.ts` - keeps these off the `/winston` sub-path surface. */
+export declare const LOGGER_PREFIX: string;
+export declare const LOGGER_FORMAT: string;
+export declare const LOGGER_FILE_FREQUENCY: string;
+export declare const LOGGER_FILE_MAX_SIZE: string;
+export declare const LOGGER_FILE_MAX_FILES: string;
+export declare const LOGGER_FILE_DATE_PATTERN: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/modules/logger/winston/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/common/constants.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,eAAO,MAAM,aAAa,QAA4B,CAAC;AACvD,eAAO,MAAM,aAAa,QAA8C,CAAC;AAEzE,eAAO,MAAM,qBAAqB,QAAoD,CAAC;AACvF,eAAO,MAAM,oBAAoB,QAAqD,CAAC;AACvF,eAAO,MAAM,qBAAqB,QAAoD,CAAC;AACvF,eAAO,MAAM,wBAAwB,QAC0B,CAAC"}

package/dist/cjs/modules/logger/winston/common/constants.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOGGER_FILE_DATE_PATTERN = exports.LOGGER_FILE_MAX_FILES = exports.LOGGER_FILE_MAX_SIZE = exports.LOGGER_FILE_FREQUENCY = exports.LOGGER_FORMAT = exports.LOGGER_PREFIX = void 0;
+const constants_1 = require("../../../../common/constants");
+/** Not re-exported from `common/index.ts` - keeps these off the `/winston` sub-path surface. */
+exports.LOGGER_PREFIX = constants_1.Defaults.APPLICATION_NAME;
+exports.LOGGER_FORMAT = process.env.APP_ENV_LOGGER_FORMAT ?? 'text';
+exports.LOGGER_FILE_FREQUENCY = process.env.APP_ENV_LOGGER_FILE_FREQUENCY ?? '1h';
+exports.LOGGER_FILE_MAX_SIZE = process.env.APP_ENV_LOGGER_FILE_MAX_SIZE ?? '100m';
+exports.LOGGER_FILE_MAX_FILES = process.env.APP_ENV_LOGGER_FILE_MAX_FILES ?? '5d';
+exports.LOGGER_FILE_DATE_PATTERN = process.env.APP_ENV_LOGGER_FILE_DATE_PATTERN ?? 'YYYYMMDD_HH';
+//# sourceMappingURL=constants.js.map

package/dist/cjs/modules/logger/winston/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/common/constants.ts"],"names":[],"mappings":";;;AAAA,kDAA8C;AAE9C,gGAAgG;AACnF,QAAA,aAAa,GAAG,oBAAQ,CAAC,gBAAgB,CAAC;AAC1C,QAAA,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,MAAM,CAAC;AAE5D,QAAA,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,IAAI,CAAC;AAC1E,QAAA,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,MAAM,CAAC;AAC1E,QAAA,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,IAAI,CAAC;AAC1E,QAAA,wBAAwB,GACnC,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,aAAa,CAAC"}

package/dist/cjs/modules/logger/winston/common/types.d.ts

@@ -30,6 +30,8 @@ export interface ICustomLoggerOptions {
     format?: TLoggerFormat;
     /** Logger-level floor. Defaults to `APP_ENV_LOGGER_LEVEL`, then `debug`. */
     level?: TLogLevel;
+    /** ANSI color on the console transport in `text` mode. Defaults to `APP_ENV_LOGGER_COLOR`, then OFF outside a development `NODE_ENV`. Ignored when `formatter` is set - that override owns the whole line. */
+    colorize?: boolean;
     transports: {
         info: {
             file?: IFileTransportOptions;

package/dist/cjs/modules/logger/winston/common/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,sBAAuB,SAAQ,SAAS,CAAC,sBAAsB;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC7C,MAAM,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAE7C,0LAA0L;IAC1L,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEtD,gFAAgF;IAChF,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,CAAC,EAAE,qBAAqB,CAAC;YAC7B,KAAK,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;SACzC,CAAC;QACF,KAAK,EAAE;YACL,IAAI,CAAC,EAAE,qBAAqB,CAAC;YAC7B,KAAK,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;SACzC,CAAC;KACH,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/logger/winston/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,sBAAuB,SAAQ,SAAS,CAAC,sBAAsB;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC7C,MAAM,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAE7C,0LAA0L;IAC1L,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEtD,gFAAgF;IAChF,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,8MAA8M;IAC9M,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,CAAC,EAAE,qBAAqB,CAAC;YAC7B,KAAK,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;SACzC,CAAC;QACF,KAAK,EAAE;YACL,IAAI,CAAC,EAAE,qBAAqB,CAAC;YAC7B,KAAK,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;SACzC,CAAC;KACH,CAAC;CACH"}

package/dist/cjs/modules/logger/winston/define.d.ts

@@ -1,22 +1,12 @@
 import winston from 'winston';
-import 'winston-daily-rotate-file';
-import { ICustomLoggerOptions } from './common';
-import { TLoggerFormat } from '../common';
-export declare const defineJsonLoggerFormatter: (opts: {
-    label: string;
-}) => winston.Logform.Format;
-export declare const definePrettyLoggerFormatter: (opts: {
-    label: string;
-    colorize?: boolean;
-}) => winston.Logform.Format;
-export declare const defineLogFormatter: (opts: {
-    label: string;
-    format?: TLoggerFormat;
-}) => winston.Logform.Format;
+import { WinstonFormatFactory } from './formats';
+import { WinstonLoggerFactory } from './logger-factory';
 export declare const applicationLogFormatter: winston.Logform.Format;
-export declare const defineCustomLogger: (opts: ICustomLoggerOptions) => winston.Logger;
-/** Default transports from `APP_ENV_LOGGER_*`, resolved at CALL time. File logging is opt-in - without `APP_ENV_LOGGER_FOLDER_PATH` no rotating file is created. */
-export declare const resolveDefaultTransportOptions: () => ICustomLoggerOptions["transports"];
+export declare const defineCustomLogger: typeof WinstonLoggerFactory.defineCustomLogger;
+export declare const defineJsonLoggerFormatter: typeof WinstonFormatFactory.json;
+export declare const defineLogFormatter: typeof WinstonFormatFactory.log;
+export declare const definePrettyLoggerFormatter: typeof WinstonFormatFactory.pretty;
+export declare const resolveDefaultTransportOptions: typeof WinstonLoggerFactory.resolveDefaultTransportOptions;
 /** Module-internal only - NOT re-exported from `winston/index.ts`; the default winston backing WinstonLogger falls back to. */
 export declare const defaultWinstonLogger: winston.Logger;
 //# sourceMappingURL=define.d.ts.map

package/dist/cjs/modules/logger/winston/define.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/define.ts"],"names":[],"mappings":"AAIA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,2BAA2B,CAAC;AAGnC,OAAO,EAAE,oBAAoB,EAA0B,MAAM,UAAU,CAAC;AACxE,OAAO,EAAqC,aAAa,EAAE,MAAM,WAAW,CAAC;AA4B7E,eAAO,MAAM,yBAAyB,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,2BAEhE,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,2BAatF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,aAAa,CAAA;CAAE,2BAgBjF,CAAC;AAEF,eAAO,MAAM,uBAAuB,wBAA+C,CAAC;AAsBpF,eAAO,MAAM,kBAAkB,GAAI,MAAM,oBAAoB,mBA4F5D,CAAC;AAEF,oKAAoK;AACpK,eAAO,MAAM,8BAA8B,QAAO,oBAAoB,CAAC,YAAY,CAmBlF,CAAC;AAEF,+HAA+H;AAC/H,eAAO,MAAM,oBAAoB,gBAE/B,CAAC"}
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/define.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAAC,OAAO,CAAC,MACR,CAAC;AAC/C,eAAO,MAAM,kBAAkB,gDAA0C,CAAC;AAC1E,eAAO,MAAM,yBAAyB,kCAA4B,CAAC;AACnE,eAAO,MAAM,kBAAkB,iCAA2B,CAAC;AAC3D,eAAO,MAAM,2BAA2B,oCAA8B,CAAC;AACvE,eAAO,MAAM,8BAA8B,4DAAsD,CAAC;AAElG,+HAA+H;AAC/H,eAAO,MAAM,oBAAoB,gBAAuC,CAAC"}

package/dist/cjs/modules/logger/winston/define.js

@@ -1,178 +1,14 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultWinstonLogger = exports.resolveDefaultTransportOptions = exports.defineCustomLogger = exports.applicationLogFormatter = exports.defineLogFormatter = exports.definePrettyLoggerFormatter = exports.defineJsonLoggerFormatter = void 0;
-const constants_1 = require("../../../common/constants");
-const parse_utility_1 = require("../../../utilities/parse.utility");
-const ignis_inversion_1 = require("@venizia/ignis-inversion");
-const node_path_1 = __importDefault(require("node:path"));
-const winston_1 = __importDefault(require("winston"));
-require("winston-daily-rotate-file");
-const formatters_1 = require("./formatters");
-const transports_1 = require("./transports");
-const common_1 = require("../common");
-const LOGGER_PREFIX = constants_1.Defaults.APPLICATION_NAME;
-const LOGGER_FORMAT = process.env.APP_ENV_LOGGER_FORMAT ?? 'text';
-const LOGGER_FILE_FREQUENCY = process.env.APP_ENV_LOGGER_FILE_FREQUENCY ?? '1h';
-const LOGGER_FILE_MAX_SIZE = process.env.APP_ENV_LOGGER_FILE_MAX_SIZE ?? '100m';
-const LOGGER_FILE_MAX_FILES = process.env.APP_ENV_LOGGER_FILE_MAX_FILES ?? '5d';
-const LOGGER_FILE_DATE_PATTERN = process.env.APP_ENV_LOGGER_FILE_DATE_PATTERN ?? 'YYYYMMDD_HH';
-const f = winston_1.default.format;
-/** Per-line prep: label, timestamp, error normalization, deep splat. Final-string assembly is per-transport, so console can colorize while files/UDP get plain lines. */
-const definePrepFormatter = (opts) => {
-    return f.combine(f.label({ label: opts.label }), f.timestamp(), f.errors({ stack: true }), (0, formatters_1.deepSplat)());
-};
-const defineTextLineFormatter = () => {
-    return f.printf(({ level, message, label, timestamp }) => {
-        return `${timestamp} [${label}] ${level}: ${message}`;
-    });
-};
-const defineJsonLoggerFormatter = (opts) => {
-    return f.combine(definePrepFormatter({ label: opts.label }), f.json());
-};
-exports.defineJsonLoggerFormatter = defineJsonLoggerFormatter;
-const definePrettyLoggerFormatter = (opts) => {
-    const { label, colorize = true } = opts;
-    if (colorize) {
-        return f.combine(definePrepFormatter({ label }), f.align(), f.colorize(), defineTextLineFormatter());
-    }
-    return f.combine(definePrepFormatter({ label }), f.align(), defineTextLineFormatter());
-};
-exports.definePrettyLoggerFormatter = definePrettyLoggerFormatter;
-const defineLogFormatter = (opts) => {
-    const format = opts.format ?? LOGGER_FORMAT;
-    switch (format) {
-        case common_1.LoggerFormats.JSON: {
-            return (0, exports.defineJsonLoggerFormatter)({ label: opts.label });
-        }
-        case common_1.LoggerFormats.TEXT: {
-            return (0, exports.definePrettyLoggerFormatter)({ label: opts.label });
-        }
-        default: {
-            throw (0, ignis_inversion_1.getError)({
-                message: `[defineLogger] Invalid logger format | format: ${format} | valids: ${[...common_1.LoggerFormats.SCHEME_SET]}`,
-            });
-        }
-    }
-};
-exports.defineLogFormatter = defineLogFormatter;
-exports.applicationLogFormatter = (0, exports.defineLogFormatter)({ label: LOGGER_PREFIX });
-/** Per-transport assembly formats: colorized console, plain file. */
-const defineAssemblyFormats = (opts) => {
-    switch (opts.format) {
-        case common_1.LoggerFormats.JSON: {
-            return { console: f.json(), file: f.json() };
-        }
-        case common_1.LoggerFormats.TEXT: {
-            return {
-                console: f.combine(f.align(), f.colorize(), defineTextLineFormatter()),
-                file: f.combine(f.align(), defineTextLineFormatter()),
-            };
-        }
-        default: {
-            throw (0, ignis_inversion_1.getError)({
-                message: `[defineCustomLogger] Invalid logger format | format: ${opts.format} | valids: ${[...common_1.LoggerFormats.SCHEME_SET]}`,
-            });
-        }
-    }
-};
-const defineCustomLogger = (opts) => {
-    const { levels = {
-        error: 0,
-        emerg: 0,
-        warn: 1,
-        info: 2,
-        debug: 3,
-    }, colors = {
-        error: 'red',
-        emerg: 'red',
-        warn: 'yellow',
-        info: 'green',
-        debug: 'blue',
-    }, formatter, format = LOGGER_FORMAT, level = (0, common_1.resolveLoggerLevel)({ configured: process.env.APP_ENV_LOGGER_LEVEL }), transports: { info: infoTransportOptions, error: errorTransportOptions }, } = opts;
-    const assemblyFormats = formatter ? null : defineAssemblyFormats({ format });
-    const loggerFormat = formatter ?? definePrepFormatter({ label: LOGGER_PREFIX });
-    const consoleLogTransport = new winston_1.default.transports.Console({
-        format: assemblyFormats?.console,
-    });
-    const transports = {
-        general: [consoleLogTransport],
-        exception: [consoleLogTransport],
-    };
-    if (infoTransportOptions.file) {
-        const fileOpts = infoTransportOptions.file;
-        const transport = new winston_1.default.transports.DailyRotateFile({
-            frequency: fileOpts.frequency ?? LOGGER_FILE_FREQUENCY,
-            maxSize: fileOpts.maxSize ?? LOGGER_FILE_MAX_SIZE,
-            maxFiles: fileOpts.maxFiles ?? LOGGER_FILE_MAX_FILES,
-            datePattern: fileOpts.datePattern ?? LOGGER_FILE_DATE_PATTERN,
-            filename: node_path_1.default.join(fileOpts.folder, `/${fileOpts.prefix}-info-%DATE%.log`),
-            level: 'info',
-            format: assemblyFormats?.file,
-        });
-        transports.general.push(transport);
-    }
-    if (errorTransportOptions.file) {
-        const fileOpts = errorTransportOptions.file;
-        const transport = new winston_1.default.transports.DailyRotateFile({
-            frequency: fileOpts.frequency ?? LOGGER_FILE_FREQUENCY,
-            maxSize: fileOpts.maxSize ?? LOGGER_FILE_MAX_SIZE,
-            maxFiles: fileOpts.maxFiles ?? LOGGER_FILE_MAX_FILES,
-            datePattern: fileOpts.datePattern ?? LOGGER_FILE_DATE_PATTERN,
-            filename: node_path_1.default.join(fileOpts.folder, `/${fileOpts.prefix}-error-%DATE%.log`),
-            level: 'error',
-            format: assemblyFormats?.file,
-        });
-        transports.general.push(transport);
-        transports.exception.push(transport);
-    }
-    if (infoTransportOptions.dgram) {
-        const transport = transports_1.DgramTransport.fromPartial(infoTransportOptions.dgram);
-        if (transport) {
-            transports.general.push(transport);
-        }
-    }
-    // Deliberate asymmetry with the file pair: error.dgram registers ONLY as an exception handler - ordinary error-level lines already ship over info.dgram's transport, and adding it to general would double-send every error line.
-    if (errorTransportOptions.dgram) {
-        const transport = transports_1.DgramTransport.fromPartial(errorTransportOptions.dgram);
-        if (transport) {
-            transports.exception.push(transport);
-        }
-    }
-    winston_1.default.addColors(colors);
-    return winston_1.default.createLogger({
-        levels,
-        level,
-        format: loggerFormat,
-        exitOnError: false,
-        transports: transports.general,
-        exceptionHandlers: transports.exception,
-    });
-};
-exports.defineCustomLogger = defineCustomLogger;
-/** Default transports from `APP_ENV_LOGGER_*`, resolved at CALL time. File logging is opt-in - without `APP_ENV_LOGGER_FOLDER_PATH` no rotating file is created. */
-const resolveDefaultTransportOptions = () => {
-    const folderPath = process.env.APP_ENV_LOGGER_FOLDER_PATH;
-    const fileOptions = folderPath && folderPath.trim() !== ''
-        ? { folder: folderPath, prefix: LOGGER_PREFIX }
-        : undefined;
-    const dgramOptions = {
-        socketOptions: { type: 'udp4' },
-        host: process.env.APP_ENV_LOGGER_DGRAM_HOST,
-        port: (0, parse_utility_1.int)(process.env.APP_ENV_LOGGER_DGRAM_PORT),
-        label: process.env.APP_ENV_LOGGER_DGRAM_LABEL,
-        levels: process.env.APP_ENV_LOGGER_DGRAM_LEVELS?.split(',').map(el => el.trim()) ?? [],
-    };
-    return {
-        info: { file: fileOptions, dgram: dgramOptions },
-        error: { file: fileOptions, dgram: dgramOptions },
-    };
-};
-exports.resolveDefaultTransportOptions = resolveDefaultTransportOptions;
+exports.defaultWinstonLogger = exports.resolveDefaultTransportOptions = exports.definePrettyLoggerFormatter = exports.defineLogFormatter = exports.defineJsonLoggerFormatter = exports.defineCustomLogger = exports.applicationLogFormatter = void 0;
+const formats_1 = require("./formats");
+const logger_factory_1 = require("./logger-factory");
+exports.applicationLogFormatter = formats_1.WinstonFormatFactory.applicationLogFormatter;
+exports.defineCustomLogger = logger_factory_1.WinstonLoggerFactory.defineCustomLogger;
+exports.defineJsonLoggerFormatter = formats_1.WinstonFormatFactory.json;
+exports.defineLogFormatter = formats_1.WinstonFormatFactory.log;
+exports.definePrettyLoggerFormatter = formats_1.WinstonFormatFactory.pretty;
+exports.resolveDefaultTransportOptions = logger_factory_1.WinstonLoggerFactory.resolveDefaultTransportOptions;
 /** Module-internal only - NOT re-exported from `winston/index.ts`; the default winston backing WinstonLogger falls back to. */
-exports.defaultWinstonLogger = (0, exports.defineCustomLogger)({
-    transports: (0, exports.resolveDefaultTransportOptions)(),
-});
+exports.defaultWinstonLogger = logger_factory_1.WinstonLoggerFactory.defaultLogger();
 //# sourceMappingURL=define.js.map

package/dist/cjs/modules/logger/winston/define.js.map

@@ -1 +1 @@
-{"version":3,"file":"define.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/define.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/define.ts"],"names":[],"mappings":";;;AACA,uCAAiD;AACjD,qDAAwD;AAE3C,QAAA,uBAAuB,GAClC,8BAAoB,CAAC,uBAAuB,CAAC;AAClC,QAAA,kBAAkB,GAAG,qCAAoB,CAAC,kBAAkB,CAAC;AAC7D,QAAA,yBAAyB,GAAG,8BAAoB,CAAC,IAAI,CAAC;AACtD,QAAA,kBAAkB,GAAG,8BAAoB,CAAC,GAAG,CAAC;AAC9C,QAAA,2BAA2B,GAAG,8BAAoB,CAAC,MAAM,CAAC;AAC1D,QAAA,8BAA8B,GAAG,qCAAoB,CAAC,8BAA8B,CAAC;AAElG,+HAA+H;AAClH,QAAA,oBAAoB,GAAG,qCAAoB,CAAC,aAAa,EAAE,CAAC"}

package/dist/cjs/modules/logger/winston/formats.d.ts

@@ -0,0 +1,34 @@
+import winston from 'winston';
+import { TLoggerFormat } from '../common';
+/**
+ * Static methods never reach a sibling through `this` - the exported names in `define.ts` are
+ * unbound aliases (`WinstonFormatFactory.method`), so `this` would be `undefined` there.
+ */
+export declare class WinstonFormatFactory {
+    /** Per-line prep: label, timestamp, error normalization, deep splat. Final-string assembly is per-transport, so console can colorize while files/UDP get plain lines. */
+    static prep(opts: {
+        label: string;
+    }): winston.Logform.Format;
+    static textLine(): winston.Logform.Format;
+    static json(opts: {
+        label: string;
+    }): winston.Logform.Format;
+    static pretty(opts: {
+        label: string;
+        colorize?: boolean;
+    }): winston.Logform.Format;
+    static log(opts: {
+        label: string;
+        format?: TLoggerFormat;
+    }): winston.Logform.Format;
+    /** Per-transport assembly formats: console may colorize, a file never does - ANSI bytes in a rotated log file are noise every grep has to strip. */
+    static assembly(opts: {
+        format: TLoggerFormat;
+        colorize: boolean;
+    }): {
+        console: winston.Logform.Format;
+        file: winston.Logform.Format;
+    };
+    static readonly applicationLogFormatter: winston.Logform.Format;
+}
+//# sourceMappingURL=formats.d.ts.map

package/dist/cjs/modules/logger/winston/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/formats.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAG9B,OAAO,EAAwC,aAAa,EAAE,MAAM,WAAW,CAAC;AAIhF;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,yKAAyK;IACzK,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IASnC,MAAM,CAAC,QAAQ;IAMf,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IAInC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;IAoBzD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,aAAa,CAAA;KAAE;IAkB1D,oJAAoJ;IACpJ,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE;;;;IAqBlE,MAAM,CAAC,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAE5D;CACJ"}

package/dist/cjs/modules/logger/winston/formats.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WinstonFormatFactory = void 0;
+const ignis_inversion_1 = require("@venizia/ignis-inversion");
+const winston_1 = __importDefault(require("winston"));
+const formatters_1 = require("./formatters");
+const constants_1 = require("./common/constants");
+const common_1 = require("../common");
+const f = winston_1.default.format;
+/**
+ * Static methods never reach a sibling through `this` - the exported names in `define.ts` are
+ * unbound aliases (`WinstonFormatFactory.method`), so `this` would be `undefined` there.
+ */
+class WinstonFormatFactory {
+    /** Per-line prep: label, timestamp, error normalization, deep splat. Final-string assembly is per-transport, so console can colorize while files/UDP get plain lines. */
+    static prep(opts) {
+        return f.combine(f.label({ label: opts.label }), f.timestamp(), f.errors({ stack: true }), (0, formatters_1.deepSplat)());
+    }
+    static textLine() {
+        return f.printf(({ level, message, label, timestamp }) => {
+            return `${timestamp} [${label}] ${level}: ${message}`;
+        });
+    }
+    static json(opts) {
+        return f.combine(WinstonFormatFactory.prep({ label: opts.label }), f.json());
+    }
+    static pretty(opts) {
+        // winston has no terminal detection of its own, so "no opinion" keeps the historical default.
+        const { label, colorize = (0, common_1.resolveLoggerColorize)() ?? true } = opts;
+        if (colorize) {
+            return f.combine(WinstonFormatFactory.prep({ label }), f.align(), f.colorize(), WinstonFormatFactory.textLine());
+        }
+        return f.combine(WinstonFormatFactory.prep({ label }), f.align(), WinstonFormatFactory.textLine());
+    }
+    static log(opts) {
+        const format = opts.format ?? constants_1.LOGGER_FORMAT;
+        switch (format) {
+            case common_1.LoggerFormats.JSON: {
+                return WinstonFormatFactory.json({ label: opts.label });
+            }
+            case common_1.LoggerFormats.TEXT: {
+                return WinstonFormatFactory.pretty({ label: opts.label });
+            }
+            default: {
+                throw (0, ignis_inversion_1.getError)({
+                    message: `[defineLogger] Invalid logger format | format: ${format} | valids: ${[...common_1.LoggerFormats.SCHEME_SET]}`,
+                });
+            }
+        }
+    }
+    /** Per-transport assembly formats: console may colorize, a file never does - ANSI bytes in a rotated log file are noise every grep has to strip. */
+    static assembly(opts) {
+        switch (opts.format) {
+            case common_1.LoggerFormats.JSON: {
+                return { console: f.json(), file: f.json() };
+            }
+            case common_1.LoggerFormats.TEXT: {
+                return {
+                    console: opts.colorize
+                        ? f.combine(f.align(), f.colorize(), WinstonFormatFactory.textLine())
+                        : f.combine(f.align(), WinstonFormatFactory.textLine()),
+                    file: f.combine(f.align(), WinstonFormatFactory.textLine()),
+                };
+            }
+            default: {
+                throw (0, ignis_inversion_1.getError)({
+                    message: `[defineCustomLogger] Invalid logger format | format: ${opts.format} | valids: ${[...common_1.LoggerFormats.SCHEME_SET]}`,
+                });
+            }
+        }
+    }
+    static { this.applicationLogFormatter = WinstonFormatFactory.log({
+        label: constants_1.LOGGER_PREFIX,
+    }); }
+}
+exports.WinstonFormatFactory = WinstonFormatFactory;
+//# sourceMappingURL=formats.js.map

package/dist/cjs/modules/logger/winston/formats.js.map

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

package/dist/cjs/modules/logger/winston/logger-factory.d.ts

@@ -0,0 +1,20 @@
+import winston from 'winston';
+import 'winston-daily-rotate-file';
+import { ICustomLoggerOptions } from './common';
+/**
+ * Static methods never reach a sibling through `this` - the exported names in `define.ts` are
+ * unbound aliases (`WinstonLoggerFactory.method`), so `this` would be `undefined` there.
+ */
+export declare class WinstonLoggerFactory {
+    private static _defaultLogger?;
+    static defineCustomLogger(opts: ICustomLoggerOptions): winston.Logger;
+    /** Default transports from `APP_ENV_LOGGER_*`, resolved at CALL time. File logging is opt-in - without `APP_ENV_LOGGER_FOLDER_PATH` no rotating file is created. */
+    static resolveDefaultTransportOptions(): ICustomLoggerOptions['transports'];
+    /**
+     * Lazy and cached - a plain module-level eager instance would build a winston logger (and read
+     * env vars) at import time for every consumer of the barrel, even one that never logs through
+     * the default.
+     */
+    static defaultLogger(): winston.Logger;
+}
+//# sourceMappingURL=logger-factory.d.ts.map

package/dist/cjs/modules/logger/winston/logger-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-factory.d.ts","sourceRoot":"","sources":["../../../../../src/modules/logger/winston/logger-factory.ts"],"names":[],"mappings":"AAEA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,2BAA2B,CAAC;AAEnC,OAAO,EAAE,oBAAoB,EAA0B,MAAM,UAAU,CAAC;AAYxE;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAiB;IAE/C,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,oBAAoB;IA+FpD,oKAAoK;IACpK,MAAM,CAAC,8BAA8B,IAAI,oBAAoB,CAAC,YAAY,CAAC;IAqB3E;;;;OAIG;IACH,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC,MAAM;CAKvC"}

package/dist/cjs/modules/logger/winston/logger-factory.js

@@ -0,0 +1,123 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WinstonLoggerFactory = void 0;
+const parse_utility_1 = require("../../../utilities/parse.utility");
+const node_path_1 = __importDefault(require("node:path"));
+const winston_1 = __importDefault(require("winston"));
+require("winston-daily-rotate-file");
+const transports_1 = require("./transports");
+const constants_1 = require("./common/constants");
+const common_1 = require("../common");
+const formats_1 = require("./formats");
+/**
+ * Static methods never reach a sibling through `this` - the exported names in `define.ts` are
+ * unbound aliases (`WinstonLoggerFactory.method`), so `this` would be `undefined` there.
+ */
+class WinstonLoggerFactory {
+    static defineCustomLogger(opts) {
+        const { levels = {
+            error: 0,
+            emerg: 0,
+            warn: 1,
+            info: 2,
+            debug: 3,
+        }, colors = {
+            error: 'red',
+            emerg: 'red',
+            warn: 'yellow',
+            info: 'green',
+            debug: 'blue',
+        }, formatter, format = constants_1.LOGGER_FORMAT, level = (0, common_1.resolveLoggerLevel)({ configured: process.env.APP_ENV_LOGGER_LEVEL }), colorize = (0, common_1.resolveLoggerColorize)() ?? true, transports: { info: infoTransportOptions, error: errorTransportOptions }, } = opts;
+        const assemblyFormats = formatter ? null : formats_1.WinstonFormatFactory.assembly({ format, colorize });
+        const loggerFormat = formatter ?? formats_1.WinstonFormatFactory.prep({ label: constants_1.LOGGER_PREFIX });
+        const consoleLogTransport = new winston_1.default.transports.Console({
+            format: assemblyFormats?.console,
+        });
+        const transports = {
+            general: [consoleLogTransport],
+            exception: [consoleLogTransport],
+        };
+        if (infoTransportOptions.file) {
+            const fileOpts = infoTransportOptions.file;
+            const transport = new winston_1.default.transports.DailyRotateFile({
+                frequency: fileOpts.frequency ?? constants_1.LOGGER_FILE_FREQUENCY,
+                maxSize: fileOpts.maxSize ?? constants_1.LOGGER_FILE_MAX_SIZE,
+                maxFiles: fileOpts.maxFiles ?? constants_1.LOGGER_FILE_MAX_FILES,
+                datePattern: fileOpts.datePattern ?? constants_1.LOGGER_FILE_DATE_PATTERN,
+                filename: node_path_1.default.join(fileOpts.folder, `/${fileOpts.prefix}-info-%DATE%.log`),
+                level: 'info',
+                format: assemblyFormats?.file,
+            });
+            transports.general.push(transport);
+        }
+        if (errorTransportOptions.file) {
+            const fileOpts = errorTransportOptions.file;
+            const transport = new winston_1.default.transports.DailyRotateFile({
+                frequency: fileOpts.frequency ?? constants_1.LOGGER_FILE_FREQUENCY,
+                maxSize: fileOpts.maxSize ?? constants_1.LOGGER_FILE_MAX_SIZE,
+                maxFiles: fileOpts.maxFiles ?? constants_1.LOGGER_FILE_MAX_FILES,
+                datePattern: fileOpts.datePattern ?? constants_1.LOGGER_FILE_DATE_PATTERN,
+                filename: node_path_1.default.join(fileOpts.folder, `/${fileOpts.prefix}-error-%DATE%.log`),
+                level: 'error',
+                format: assemblyFormats?.file,
+            });
+            transports.general.push(transport);
+            transports.exception.push(transport);
+        }
+        if (infoTransportOptions.dgram) {
+            const transport = transports_1.DgramTransport.fromPartial(infoTransportOptions.dgram);
+            if (transport) {
+                transports.general.push(transport);
+            }
+        }
+        // Deliberate asymmetry with the file pair: error.dgram registers ONLY as an exception handler - ordinary error-level lines already ship over info.dgram's transport, and adding it to general would double-send every error line.
+        if (errorTransportOptions.dgram) {
+            const transport = transports_1.DgramTransport.fromPartial(errorTransportOptions.dgram);
+            if (transport) {
+                transports.exception.push(transport);
+            }
+        }
+        winston_1.default.addColors(colors);
+        return winston_1.default.createLogger({
+            levels,
+            level,
+            format: loggerFormat,
+            exitOnError: false,
+            transports: transports.general,
+            exceptionHandlers: transports.exception,
+        });
+    }
+    /** Default transports from `APP_ENV_LOGGER_*`, resolved at CALL time. File logging is opt-in - without `APP_ENV_LOGGER_FOLDER_PATH` no rotating file is created. */
+    static resolveDefaultTransportOptions() {
+        const folderPath = process.env.APP_ENV_LOGGER_FOLDER_PATH;
+        const fileOptions = folderPath && folderPath.trim() !== ''
+            ? { folder: folderPath, prefix: constants_1.LOGGER_PREFIX }
+            : undefined;
+        const dgramOptions = {
+            socketOptions: { type: 'udp4' },
+            host: process.env.APP_ENV_LOGGER_DGRAM_HOST,
+            port: (0, parse_utility_1.int)(process.env.APP_ENV_LOGGER_DGRAM_PORT),
+            label: process.env.APP_ENV_LOGGER_DGRAM_LABEL,
+            levels: process.env.APP_ENV_LOGGER_DGRAM_LEVELS?.split(',').map(el => el.trim()) ?? [],
+        };
+        return {
+            info: { file: fileOptions, dgram: dgramOptions },
+            error: { file: fileOptions, dgram: dgramOptions },
+        };
+    }
+    /**
+     * Lazy and cached - a plain module-level eager instance would build a winston logger (and read
+     * env vars) at import time for every consumer of the barrel, even one that never logs through
+     * the default.
+     */
+    static defaultLogger() {
+        return (WinstonLoggerFactory._defaultLogger ??= WinstonLoggerFactory.defineCustomLogger({
+            transports: WinstonLoggerFactory.resolveDefaultTransportOptions(),
+        }));
+    }
+}
+exports.WinstonLoggerFactory = WinstonLoggerFactory;
+//# sourceMappingURL=logger-factory.js.map

package/dist/cjs/modules/logger/winston/logger-factory.js.map

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

package/dist/cjs/modules/network/http-request/base-network-request.helper.d.ts

@@ -1,7 +1,7 @@
-import { BaseHelper } from '../../../modules/base';
+import { BaseHelper } from '../../base';
+import { TFetcherVariant } from './common';
 import { IFetchable, IRequestOptions } from './fetcher/base-fetcher';
-import { TFetcherResponse, TFetcherWorker } from './fetcher/types';
-import { TFetcherVariant } from './types';
+import { TFetcherResponse, TFetcherWorker } from './fetcher/common';
 export declare class BaseNetworkRequest<T extends TFetcherVariant> extends BaseHelper {
     protected baseUrl: string;
     protected fetcher: IFetchable<T, IRequestOptions, TFetcherResponse<T>, TFetcherWorker<T>>;

package/dist/cjs/modules/network/http-request/base-network-request.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-network-request.helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network/http-request/base-network-request.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C,qBAAa,kBAAkB,CAAC,CAAC,SAAS,eAAe,CAAE,SAAQ,UAAU;IAC3E,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;gBAE9E,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;KACjF;IAMD,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE;IAgB7C,aAAa,CAAC,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE;IAmB9D,iBAAiB;IAIjB,SAAS,IAAI,cAAc,CAAC,CAAC,CAAC;CAG/B"}
+{"version":3,"file":"base-network-request.helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network/http-request/base-network-request.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpE,qBAAa,kBAAkB,CAAC,CAAC,SAAS,eAAe,CAAE,SAAQ,UAAU;IAC3E,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;gBAE9E,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;KACjF;IAMD,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE;IAgB7C,aAAa,CAAC,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE;IAmB9D,iBAAiB;IAIjB,SAAS,IAAI,cAAc,CAAC,CAAC,CAAC;CAG/B"}