@venizia/ignis-helpers 0.2.0-8 → 0.2.0

package/dist/esm/modules/logger/pino/logger.js

@@ -1,6 +1,6 @@
 import { BaseLogger } from '../base/index.js';
 import { formatLogMessage } from '../formatting/index.js';
-import { PinoBackingLogger } from './define.js';
+import { PinoBackingLogger } from './backing.js';
 /** pino provider satisfying `ILoggerProvider`, staying pino-native: numeric levels, `msg`, epoch `time`, pid/hostname pass through unchanged. No custom-instance param on `get()` unlike `WinstonLogger.get` - advanced/test injection goes through `PinoBackingLogger.set()`. */
 export class PinoLogger extends BaseLogger {
     static { this.cache = new Map(); }

package/dist/esm/modules/logger/pino/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,kRAAkR;AAClR,MAAM,OAAO,UAAW,SAAQ,UAAU;aACzB,UAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAErD,YAAoB,KAAa;QAC/B,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,KAAa;QACtB,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6JAA6J;IACnJ,KAAK,CAAC,IAAiE;QAC/E,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YAClB,CAAC,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9D,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAEnB,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,EAAa,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAES,KAAK,CAAC,IAAuB;QACrC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,kRAAkR;AAClR,MAAM,OAAO,UAAW,SAAQ,UAAU;aACzB,UAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAErD,YAAoB,KAAa;QAC/B,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,KAAa;QACtB,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6JAA6J;IACnJ,KAAK,CAAC,IAAiE;QAC/E,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YAClB,CAAC,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9D,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAEnB,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,EAAa,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAES,KAAK,CAAC,IAAuB;QACrC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC"}

package/dist/esm/modules/logger/resolver.d.ts

@@ -24,7 +24,7 @@ export declare class LoggerResolver {
      * nothing. A guarded property read, never an import: even a dynamic `import('@venizia/ignis-helpers')`
      * behind a node check puts the root barrel in this bundle and turns `/core` impure.
      */
-    private static warnConsoleFallbackOnce;
+    static warnConsoleFallbackOnce(): void;
     static resolve(opts: {
         scopes: Array<string>;
     }): ILogger;

package/dist/esm/modules/logger/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../../src/modules/logger/resolver.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAa,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAAE,KAAK,OAAO,CAAC;AAoD3E,4JAA4J;AAC5J,qBAAa,cAAc;IACzB,2FAA2F;IAC3F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAErC;IAEF,OAAO,CAAC,MAAM,CAAC,MAAM,CAAyC;IAC9D,OAAO,CAAC,MAAM,CAAC,UAAU,CAAK;IAE9B,kNAAkN;IAClN,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI;IAKrD,MAAM,CAAC,KAAK,IAAI,IAAI;IAKpB,wGAAwG;IACxG,MAAM,CAAC,iBAAiB,IAAI,MAAM;IAIlC,kFAAkF;IAClF,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO;IAI3D;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAetC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO;IAMxD,OAAO,CAAC,MAAM,CAAC,wBAAwB,CAAS;CACjD"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../../src/modules/logger/resolver.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAa,MAAM,gBAAgB,CAAC;AAGpD,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAAE,KAAK,OAAO,CAAC;AAoD3E,4JAA4J;AAC5J,qBAAa,cAAc;IACzB,2FAA2F;IAC3F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAIrC;IAEF,OAAO,CAAC,MAAM,CAAC,MAAM,CAAyC;IAC9D,OAAO,CAAC,MAAM,CAAC,UAAU,CAAK;IAE9B,kNAAkN;IAClN,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI;IAKrD,MAAM,CAAC,KAAK,IAAI,IAAI;IAKpB,wGAAwG;IACxG,MAAM,CAAC,iBAAiB,IAAI,MAAM;IAIlC,kFAAkF;IAClF,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO;IAI3D;;;;OAIG;IACH,MAAM,CAAC,uBAAuB,IAAI,IAAI;IAetC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO;IAIxD,OAAO,CAAC,MAAM,CAAC,wBAAwB,CAAS;CACjD"}

package/dist/esm/modules/logger/resolver.js

@@ -1,5 +1,6 @@
 import { AbstractLogger } from './base/abstract.js';
 import { ConsoleLogger } from './base/console.js';
+import { loggerSlot } from './slot.js';
 /** Caches the resolved target and re-reads it only when `LoggerResolver`'s generation moves - one integer compare per call, so an instance built before `LoggerFactory` loaded upgrades the moment it does, without being reconstructed. Mutual reference with LoggerResolver is by design - hence the `no-use-before-define` disables. */
 class ResolvedLogger extends AbstractLogger {
     constructor(scopes) {
@@ -43,6 +44,8 @@ class ResolvedLogger extends AbstractLogger {
 export class LoggerResolver {
     /** Declared before `active` because static field initialisers run in declaration order. */
     static { this.consoleResolver = opts => {
+        // Warned here, on the first line actually routed to the console, not when a helper merely acquires its logger: a script that imports the barrel and installs a provider before logging must stay silent.
+        LoggerResolver.warnConsoleFallbackOnce();
         return ConsoleLogger.get({ scope: opts.scopes.filter(el => el && el.length > 0).join('-') });
     }; }
     static { this.active = this.consoleResolver; }
@@ -80,9 +83,13 @@ export class LoggerResolver {
         ConsoleLogger.get({ scope: LoggerResolver.name }).warn('Logging to the console: no logger provider is installed. Import `LoggerFactory` from `@venizia/ignis-helpers` once at startup - `@venizia/ignis` does it for you, a connectors-only or script-only import graph does not. Loggers built before that import upgrade themselves on their next call.');
     }
     static resolve(opts) {
-        this.warnConsoleFallbackOnce();
         return new ResolvedLogger(opts.scopes);
     }
     static { this.hasWarnedConsoleFallback = false; }
 }
+// Registers the real resolver with the slot `BaseHelper` reads. Importing this module - which any
+// graph carrying `LoggerFactory` does - is what upgrades every helper from the console fallback,
+// including helpers constructed before it loaded: the logger is resolved on first use, not in the
+// constructor.
+loggerSlot.resolve = opts => LoggerResolver.resolve({ scopes: opts.scopes });
 //# sourceMappingURL=resolver.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../../src/modules/logger/resolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAK/C,2UAA2U;AAC3U,MAAM,cAAe,SAAQ,cAAc;IAIzC,YAA6B,MAAqB;QAChD,KAAK,EAAE,CAAC;QADmB,WAAM,GAAN,MAAM,CAAe;QAF1C,qBAAgB,GAAG,CAAC,CAAC,CAAC;IAI9B,CAAC;IAEO,aAAa;QACnB,mEAAmE;QACnE,MAAM,UAAU,GAAG,cAAc,CAAC,iBAAiB,EAAE,CAAC;QACtD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;YACzD,mEAAmE;YACnE,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,IAAI,CAAC,gBAAgB,GAAG,UAAU,CAAC;QACrC,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,GAAG,CAAC,KAAgB,EAAE,OAAe,EAAE,GAAG,IAAe;QACvD,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,OAAO,IAAI,cAAc,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,4JAA4J;AAC5J,MAAM,OAAO,cAAc;IACzB,2FAA2F;aACnE,oBAAe,GAAoB,IAAI,CAAC,EAAE;QAChE,OAAO,aAAa,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC,CAAC;aAEa,WAAM,GAAoB,IAAI,CAAC,eAAe,CAAC;aAC/C,eAAU,GAAG,CAAC,CAAC;IAE9B,kNAAkN;IAClN,MAAM,CAAC,GAAG,CAAC,IAAmC;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,KAAK;QACV,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC;QACnC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,wGAAwG;IACxG,MAAM,CAAC,iBAAiB;QACtB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,kFAAkF;IAClF,MAAM,CAAC,UAAU,CAAC,IAA+B;QAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,uBAAuB;QACpC,IAAI,IAAI,CAAC,wBAAwB,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACzD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAC;QACrC,aAAa,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CACpD,mSAAmS,CACpS,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,IAA+B;QAC5C,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAE/B,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;aAEc,6BAAwB,GAAG,KAAK,CAAC"}
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../../src/modules/logger/resolver.ts"],"names":[],"mappings":"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"}

package/dist/esm/modules/logger/slot.d.ts

@@ -0,0 +1,23 @@
+import type { ILogger } from './common/types.js';
+export type TLoggerResolver = (opts: {
+    scopes: Array<string>;
+}) => ILogger;
+/**
+ * Where the logger module installs its resolver, and the only reference `BaseHelper` holds to it.
+ *
+ * A slot rather than an import: `BaseHelper` sits under every class in the framework, so importing
+ * the resolver put 1033 B gzipped into every browser bundle that touched any helper.
+ */
+export declare const loggerSlot: {
+    resolve?: TLoggerResolver;
+};
+/** The real logger when a resolver is installed, else one that upgrades itself the moment one is. */
+export declare const resolveHelperLogger: (opts: {
+    scopes: Array<string>;
+}) => ILogger;
+/** Pins a logger on a helper instance: later reads are a plain property read, not its getter. */
+export declare const pinHelperLogger: (opts: {
+    helper: object;
+    logger: ILogger;
+}) => void;
+//# sourceMappingURL=slot.d.ts.map

package/dist/esm/modules/logger/slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot.d.ts","sourceRoot":"","sources":["../../../../src/modules/logger/slot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,gBAAgB,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAAE,KAAK,OAAO,CAAC;AAE3E;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE;IAAE,OAAO,CAAC,EAAE,eAAe,CAAA;CAAO,CAAC;AA4H5D,qGAAqG;AACrG,eAAO,MAAM,mBAAmB,GAAI,MAAM;IAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAAE,KAAG,OAGrE,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,eAAe,GAAI,MAAM;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,KAAG,IAO3E,CAAC"}

package/dist/esm/modules/logger/slot.js

@@ -0,0 +1,119 @@
+import { LogLevels } from './common/types.js';
+/**
+ * Where the logger module installs its resolver, and the only reference `BaseHelper` holds to it.
+ *
+ * A slot rather than an import: `BaseHelper` sits under every class in the framework, so importing
+ * the resolver put 1033 B gzipped into every browser bundle that touched any helper.
+ */
+export const loggerSlot = {};
+/** Writes one line to the console; `emerg` and anything unrecognised land on `error`. */
+const writeToConsole = (opts) => {
+    const { prefix, level, message, args } = opts;
+    const line = `${prefix} ${message}`;
+    switch (level) {
+        case LogLevels.DEBUG: {
+            globalThis.console.debug(line, ...args);
+            break;
+        }
+        case LogLevels.INFO: {
+            globalThis.console.info(line, ...args);
+            break;
+        }
+        case LogLevels.WARN: {
+            globalThis.console.warn(line, ...args);
+            break;
+        }
+        default: {
+            globalThis.console.error(line, ...args);
+            break;
+        }
+    }
+};
+/** Hands a line to the level's own method, so the logger's gates apply - `debug` checks `DEBUG`. */
+const writeToLogger = (opts) => {
+    const { logger, level, message, args } = opts;
+    switch (level) {
+        case LogLevels.DEBUG: {
+            logger.debug(message, ...args);
+            break;
+        }
+        case LogLevels.INFO: {
+            logger.info(message, ...args);
+            break;
+        }
+        case LogLevels.WARN: {
+            logger.warn(message, ...args);
+            break;
+        }
+        case LogLevels.ERROR: {
+            logger.error(message, ...args);
+            break;
+        }
+        case LogLevels.EMERG: {
+            logger.emerg(message, ...args);
+            break;
+        }
+        default: {
+            logger.log(level, message, ...args);
+            break;
+        }
+    }
+};
+const NO_RESOLVER_WARNING = '[BaseHelper] Logging to the console - no logger provider is installed. Import `LoggerFactory` from `@venizia/ignis-helpers` at startup.';
+/** Global, so a process holding both the CJS and the ESM copy of this module still warns once. */
+const NO_RESOLVER_WARNED = Symbol.for('@venizia/ignis-helpers:no-logger-provider-warned');
+/** Node only: a browser has no `LoggerFactory` to import, so the advice would be noise there. */
+const warnNoResolverOnce = () => {
+    if (Reflect.get(globalThis, NO_RESOLVER_WARNED) || !globalThis.process?.versions?.node) {
+        return;
+    }
+    Reflect.set(globalThis, NO_RESOLVER_WARNED, true);
+    globalThis.console.warn(NO_RESOLVER_WARNING);
+};
+/**
+ * Writes to the console until a resolver is installed, then hands every call to the real logger - a
+ * helper that logs before the resolver module loads would otherwise stay on the console for good.
+ */
+const createDeferredLogger = (opts) => {
+    const { scopes } = opts;
+    const prefix = `[${scopes.join('-')}]`;
+    let resolved;
+    const write = (level, message, args) => {
+        const resolve = loggerSlot.resolve;
+        if (!resolved && resolve) {
+            resolved = resolve({ scopes });
+        }
+        if (resolved) {
+            writeToLogger({ logger: resolved, level, message, args });
+            return;
+        }
+        warnNoResolverOnce();
+        writeToConsole({ prefix, level, message, args });
+    };
+    return {
+        debug: (message, ...args) => write(LogLevels.DEBUG, message, args),
+        info: (message, ...args) => write(LogLevels.INFO, message, args),
+        warn: (message, ...args) => write(LogLevels.WARN, message, args),
+        error: (message, ...args) => write(LogLevels.ERROR, message, args),
+        emerg: (message, ...args) => write(LogLevels.EMERG, message, args),
+        log: (level, message, ...args) => write(level, message, args),
+        for: (methodName) => resolved
+            ? resolved.for(methodName)
+            : createDeferredLogger({ scopes: [...scopes, methodName] }),
+    };
+};
+/** The real logger when a resolver is installed, else one that upgrades itself the moment one is. */
+export const resolveHelperLogger = (opts) => {
+    const resolve = loggerSlot.resolve;
+    return resolve ? resolve({ scopes: opts.scopes }) : createDeferredLogger({ scopes: opts.scopes });
+};
+/** Pins a logger on a helper instance: later reads are a plain property read, not its getter. */
+export const pinHelperLogger = (opts) => {
+    Object.defineProperty(opts.helper, 'logger', {
+        value: opts.logger,
+        writable: true,
+        configurable: true,
+        enumerable: false,
+    });
+};
+//# sourceMappingURL=slot.js.map

package/dist/esm/modules/logger/slot.js.map

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

package/dist/esm/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/esm/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":"AAGA,gGAAgG;AAChG,eAAO,MAAM,aAAa,QAA4B,CAAC;AACvD,eAAO,MAAM,aAAa,QAAgE,CAAC;AAE3F,eAAO,MAAM,qBAAqB,QACmC,CAAC;AACtE,eAAO,MAAM,oBAAoB,QACqC,CAAC;AACvE,eAAO,MAAM,qBAAqB,QACmC,CAAC;AACtE,eAAO,MAAM,wBAAwB,QAC4C,CAAC"}

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

@@ -0,0 +1,10 @@
+import { blankToUndefined } from '../../../../utilities/parse.utility.js';
+import { Defaults } from '../../../../common/constants/index.js';
+/** Not re-exported from `common/index.ts` - keeps these off the `/winston` sub-path surface. */
+export const LOGGER_PREFIX = Defaults.APPLICATION_NAME;
+export const LOGGER_FORMAT = blankToUndefined(process.env.APP_ENV_LOGGER_FORMAT) ?? 'text';
+export const LOGGER_FILE_FREQUENCY = blankToUndefined(process.env.APP_ENV_LOGGER_FILE_FREQUENCY) ?? '1h';
+export const LOGGER_FILE_MAX_SIZE = blankToUndefined(process.env.APP_ENV_LOGGER_FILE_MAX_SIZE) ?? '100m';
+export const LOGGER_FILE_MAX_FILES = blankToUndefined(process.env.APP_ENV_LOGGER_FILE_MAX_FILES) ?? '5d';
+export const LOGGER_FILE_DATE_PATTERN = blankToUndefined(process.env.APP_ENV_LOGGER_FILE_DATE_PATTERN) ?? 'YYYYMMDD_HH';
+//# sourceMappingURL=constants.js.map

package/dist/esm/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,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,gGAAgG;AAChG,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC,gBAAgB,CAAC;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,MAAM,CAAC;AAE3F,MAAM,CAAC,MAAM,qBAAqB,GAChC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,IAAI,IAAI,CAAC;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAC/B,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,IAAI,MAAM,CAAC;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAChC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,IAAI,IAAI,CAAC;AACtE,MAAM,CAAC,MAAM,wBAAwB,GACnC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,IAAI,aAAa,CAAC"}

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

@@ -1,22 +1,12 @@
 import winston from 'winston';
-import 'winston-daily-rotate-file';
-import { ICustomLoggerOptions } from './common/index.js';
-import { TLoggerFormat } from '../common/index.js';
-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.js';
+import { WinstonLoggerFactory } from './logger-factory.js';
 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/esm/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,EAA4D,aAAa,EAAE,MAAM,WAAW,CAAC;AA4BpG,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,2BActF,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;AAwBpF,eAAO,MAAM,kBAAkB,GAAI,MAAM,oBAAoB,mBA6F5D,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/esm/modules/logger/winston/define.js

@@ -1,170 +1,11 @@
-import { Defaults } from '../../../common/constants/index.js';
-import { int } from '../../../utilities/parse.utility.js';
-import { getError } from '@venizia/ignis-inversion';
-import path from 'node:path';
-import winston from 'winston';
-import 'winston-daily-rotate-file';
-import { deepSplat } from './formatters/index.js';
-import { DgramTransport } from './transports/index.js';
-import { LoggerFormats, resolveLoggerColorize, resolveLoggerLevel } from '../common/index.js';
-const LOGGER_PREFIX = 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.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 }), deepSplat());
-};
-const defineTextLineFormatter = () => {
-    return f.printf(({ level, message, label, timestamp }) => {
-        return `${timestamp} [${label}] ${level}: ${message}`;
-    });
-};
-export const defineJsonLoggerFormatter = (opts) => {
-    return f.combine(definePrepFormatter({ label: opts.label }), f.json());
-};
-export const definePrettyLoggerFormatter = (opts) => {
-    // winston has no terminal detection of its own, so "no opinion" keeps the historical default.
-    const { label, colorize = resolveLoggerColorize() ?? true } = opts;
-    if (colorize) {
-        return f.combine(definePrepFormatter({ label }), f.align(), f.colorize(), defineTextLineFormatter());
-    }
-    return f.combine(definePrepFormatter({ label }), f.align(), defineTextLineFormatter());
-};
-export const defineLogFormatter = (opts) => {
-    const format = opts.format ?? LOGGER_FORMAT;
-    switch (format) {
-        case LoggerFormats.JSON: {
-            return defineJsonLoggerFormatter({ label: opts.label });
-        }
-        case LoggerFormats.TEXT: {
-            return definePrettyLoggerFormatter({ label: opts.label });
-        }
-        default: {
-            throw getError({
-                message: `[defineLogger] Invalid logger format | format: ${format} | valids: ${[...LoggerFormats.SCHEME_SET]}`,
-            });
-        }
-    }
-};
-export const applicationLogFormatter = defineLogFormatter({ label: LOGGER_PREFIX });
-/** 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. */
-const defineAssemblyFormats = (opts) => {
-    switch (opts.format) {
-        case LoggerFormats.JSON: {
-            return { console: f.json(), file: f.json() };
-        }
-        case LoggerFormats.TEXT: {
-            return {
-                console: opts.colorize
-                    ? f.combine(f.align(), f.colorize(), defineTextLineFormatter())
-                    : f.combine(f.align(), defineTextLineFormatter()),
-                file: f.combine(f.align(), defineTextLineFormatter()),
-            };
-        }
-        default: {
-            throw getError({
-                message: `[defineCustomLogger] Invalid logger format | format: ${opts.format} | valids: ${[...LoggerFormats.SCHEME_SET]}`,
-            });
-        }
-    }
-};
-export 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 = resolveLoggerLevel({ configured: process.env.APP_ENV_LOGGER_LEVEL }), colorize = resolveLoggerColorize() ?? true, transports: { info: infoTransportOptions, error: errorTransportOptions }, } = opts;
-    const assemblyFormats = formatter ? null : defineAssemblyFormats({ format, colorize });
-    const loggerFormat = formatter ?? definePrepFormatter({ label: LOGGER_PREFIX });
-    const consoleLogTransport = new winston.transports.Console({
-        format: assemblyFormats?.console,
-    });
-    const transports = {
-        general: [consoleLogTransport],
-        exception: [consoleLogTransport],
-    };
-    if (infoTransportOptions.file) {
-        const fileOpts = infoTransportOptions.file;
-        const transport = new winston.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: path.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.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: path.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 = 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 = DgramTransport.fromPartial(errorTransportOptions.dgram);
-        if (transport) {
-            transports.exception.push(transport);
-        }
-    }
-    winston.addColors(colors);
-    return winston.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. */
-export 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: 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 },
-    };
-};
+import { WinstonFormatFactory } from './formats.js';
+import { WinstonLoggerFactory } from './logger-factory.js';
+export const applicationLogFormatter = WinstonFormatFactory.applicationLogFormatter;
+export const defineCustomLogger = WinstonLoggerFactory.defineCustomLogger;
+export const defineJsonLoggerFormatter = WinstonFormatFactory.json;
+export const defineLogFormatter = WinstonFormatFactory.log;
+export const definePrettyLoggerFormatter = WinstonFormatFactory.pretty;
+export const resolveDefaultTransportOptions = WinstonLoggerFactory.resolveDefaultTransportOptions;
 /** Module-internal only - NOT re-exported from `winston/index.ts`; the default winston backing WinstonLogger falls back to. */
-export const defaultWinstonLogger = defineCustomLogger({
-    transports: resolveDefaultTransportOptions(),
-});
+export const defaultWinstonLogger = WinstonLoggerFactory.defaultLogger();
 //# sourceMappingURL=define.js.map

package/dist/esm/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,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,CAAC,MAAM,uBAAuB,GAClC,oBAAoB,CAAC,uBAAuB,CAAC;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,kBAAkB,CAAC;AAC1E,MAAM,CAAC,MAAM,yBAAyB,GAAG,oBAAoB,CAAC,IAAI,CAAC;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,GAAG,CAAC;AAC3D,MAAM,CAAC,MAAM,2BAA2B,GAAG,oBAAoB,CAAC,MAAM,CAAC;AACvE,MAAM,CAAC,MAAM,8BAA8B,GAAG,oBAAoB,CAAC,8BAA8B,CAAC;AAElG,+HAA+H;AAC/H,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,aAAa,EAAE,CAAC"}

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

@@ -0,0 +1,34 @@
+import winston from 'winston';
+import { TLoggerFormat } from '../common/index.js';
+/**
+ * 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/esm/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/esm/modules/logger/winston/formats.js

@@ -0,0 +1,73 @@
+import { getError } from '@venizia/ignis-inversion';
+import winston from 'winston';
+import { deepSplat } from './formatters/index.js';
+import { LOGGER_FORMAT, LOGGER_PREFIX } from './common/constants.js';
+import { LoggerFormats, resolveLoggerColorize } from '../common/index.js';
+const f = winston.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.
+ */
+export 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 }), 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 = 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 ?? LOGGER_FORMAT;
+        switch (format) {
+            case LoggerFormats.JSON: {
+                return WinstonFormatFactory.json({ label: opts.label });
+            }
+            case LoggerFormats.TEXT: {
+                return WinstonFormatFactory.pretty({ label: opts.label });
+            }
+            default: {
+                throw getError({
+                    message: `[defineLogger] Invalid logger format | format: ${format} | valids: ${[...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 LoggerFormats.JSON: {
+                return { console: f.json(), file: f.json() };
+            }
+            case 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 getError({
+                    message: `[defineCustomLogger] Invalid logger format | format: ${opts.format} | valids: ${[...LoggerFormats.SCHEME_SET]}`,
+                });
+            }
+        }
+    }
+    static { this.applicationLogFormatter = WinstonFormatFactory.log({
+        label: LOGGER_PREFIX,
+    }); }
+}
+//# sourceMappingURL=formats.js.map