@venizia/ignis-helpers 0.2.0-8 → 0.2.0

package/dist/cjs/modules/logger/pino/{define.js → destination.js}

@@ -3,16 +3,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setPinoBackingLogger = exports.getPinoBackingLogger = exports.buildPinoOptions = exports.buildDestination = exports.resolveDestinationPlan = exports.mapMaxFilesToCount = exports.mapFrequency = exports.PinoBackingLogger = exports.PinoDestination = exports.PINO_CUSTOM_LEVELS = void 0;
+exports.buildDestination = exports.resolveDestinationPlan = exports.mapMaxFilesToCount = exports.mapFrequency = exports.PinoDestination = void 0;
 const constants_1 = require("../../../common/constants");
+const parse_utility_1 = require("../../../utilities/parse.utility");
 const module_utility_1 = require("../../../utilities/module.utility");
 const node_path_1 = __importDefault(require("node:path"));
 const pino_1 = __importDefault(require("pino"));
 const common_1 = require("../common");
-/** pino levels are ASCENDING severity (error 50 > warn 40 > info 30 > debug 20); `emerg`(70) extends above error. NORMATIVE - do not renumber without updating the spec. */
-exports.PINO_CUSTOM_LEVELS = {
-    emerg: 70,
-};
 /** Reads `APP_ENV_LOGGER_*` and turns it into a destination. Warning prefixes name the operation, not the class - the tests and the published API still call these `mapFrequency`/`mapMaxFilesToCount`. */
 class PinoDestination {
     static { this.DEFAULT_FREQUENCY = 'hourly'; }
@@ -77,7 +74,7 @@ class PinoDestination {
                 options: {
                     file: node_path_1.default.join(folderPath, constants_1.Defaults.APPLICATION_NAME),
                     frequency,
-                    size: process.env.APP_ENV_LOGGER_FILE_MAX_SIZE ?? '100m',
+                    size: (0, parse_utility_1.blankToUndefined)(process.env.APP_ENV_LOGGER_FILE_MAX_SIZE) ?? '100m',
                     limit: { count },
                     mkdir: true,
                 },
@@ -116,49 +113,8 @@ class PinoDestination {
     }
 }
 exports.PinoDestination = PinoDestination;
-/** Owns the single pino instance every scope writes through, and the transport thread behind it. */
-class PinoBackingLogger {
-    /** Pure: pino constructor options derived from env at CALL time. Public so tests can build a REAL instance against an in-memory destination, without the impure singleton. */
-    static buildOptions() {
-        return {
-            name: constants_1.Defaults.APPLICATION_NAME,
-            level: (0, common_1.resolveLoggerLevel)({ configured: process.env.APP_ENV_LOGGER_LEVEL }),
-            customLevels: exports.PINO_CUSTOM_LEVELS,
-        };
-    }
-    /** Lazy, env-driven singleton, built once and reused by every scope entirely synchronously - the very first log line already targets the real env-configured destination, no stdout bootstrap. `set()` is the only way to replace it; this getter never resets it. */
-    static get() {
-        if (!PinoBackingLogger.instance) {
-            const destination = PinoDestination.build(PinoDestination.resolvePlan());
-            PinoBackingLogger.instance = (0, pino_1.default)(PinoBackingLogger.buildOptions(), destination);
-            PinoBackingLogger.transport = destination;
-        }
-        return PinoBackingLogger.instance;
-    }
-    /** Replaces the singleton outright: an outgoing transport-backed instance (pretty/roll) is a `ThreadStream` on a live worker thread, so this flushes then `.end()`s it first rather than orphaning the worker; failures are logged via `console.error`, never swallowed. */
-    static set(opts) {
-        if (PinoBackingLogger.instance) {
-            PinoBackingLogger.instance.flush();
-            PinoBackingLogger.closeTransport();
-        }
-        PinoBackingLogger.instance = opts.instance;
-        PinoBackingLogger.transport = undefined;
-    }
-    static closeTransport() {
-        if (!PinoBackingLogger.transport) {
-            return;
-        }
-        try {
-            PinoBackingLogger.transport.end();
-        }
-        catch (error) {
-            console.error('[setPinoBackingLogger] Failed to close previous transport stream', error);
-        }
-    }
-}
-exports.PinoBackingLogger = PinoBackingLogger;
-// Published names, kept so `@venizia/ignis-helpers/pino` consumers do not have to move; the classes
-// above are the implementation and the entry point for new code.
+// Published names, kept so `@venizia/ignis-helpers/pino` consumers do not have to move; the class
+// above is the implementation and the entry point for new code.
 const mapFrequency = (value) => PinoDestination.mapFrequency(value);
 exports.mapFrequency = mapFrequency;
 const mapMaxFilesToCount = (opts) => PinoDestination.mapMaxFilesToCount(opts);
@@ -167,10 +123,4 @@ const resolveDestinationPlan = () => PinoDestination.resolvePlan();
 exports.resolveDestinationPlan = resolveDestinationPlan;
 const buildDestination = (plan) => PinoDestination.build(plan);
 exports.buildDestination = buildDestination;
-const buildPinoOptions = () => PinoBackingLogger.buildOptions();
-exports.buildPinoOptions = buildPinoOptions;
-const getPinoBackingLogger = () => PinoBackingLogger.get();
-exports.getPinoBackingLogger = getPinoBackingLogger;
-const setPinoBackingLogger = (opts) => PinoBackingLogger.set(opts);
-exports.setPinoBackingLogger = setPinoBackingLogger;
-//# sourceMappingURL=define.js.map
+//# sourceMappingURL=destination.js.map

package/dist/cjs/modules/logger/pino/destination.js.map

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

package/dist/cjs/modules/logger/pino/index.d.ts

@@ -1,5 +1,6 @@
 /** Sub-path barrel ONLY, reachable via `@venizia/ignis-helpers/pino`; never re-exported from the root barrel - `pino` is an optional peer and this folder is its only value-importer. */
+export * from './backing';
 export * from './common';
-export * from './define';
+export * from './destination';
 export * from './logger';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/modules/logger/pino/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/index.ts"],"names":[],"mappings":"AAAA,yLAAyL;AACzL,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/index.ts"],"names":[],"mappings":"AAAA,yLAAyL;AACzL,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC"}

package/dist/cjs/modules/logger/pino/index.js

@@ -15,7 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 /** Sub-path barrel ONLY, reachable via `@venizia/ignis-helpers/pino`; never re-exported from the root barrel - `pino` is an optional peer and this folder is its only value-importer. */
+__exportStar(require("./backing"), exports);
 __exportStar(require("./common"), exports);
-__exportStar(require("./define"), exports);
+__exportStar(require("./destination"), exports);
 __exportStar(require("./logger"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/modules/logger/pino/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yLAAyL;AACzL,2CAAyB;AACzB,2CAAyB;AACzB,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yLAAyL;AACzL,4CAA0B;AAC1B,2CAAyB;AACzB,gDAA8B;AAC9B,2CAAyB"}

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

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PinoLogger = void 0;
 const base_1 = require("../base");
 const formatting_1 = require("../formatting");
-const define_1 = require("./define");
+const backing_1 = require("./backing");
 /** 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()`. */
 class PinoLogger extends base_1.BaseLogger {
     static { this.cache = new Map(); }
@@ -23,7 +23,7 @@ class PinoLogger extends base_1.BaseLogger {
         const line = opts.args.length > 0
             ? (0, formatting_1.formatLogMessage)({ message: opts.message, args: opts.args })
             : opts.message;
-        const backing = define_1.PinoBackingLogger.get();
+        const backing = backing_1.PinoBackingLogger.get();
         backing[opts.level](this._formattedPrefix + line);
     }
     child(opts) {

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

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/logger.ts"],"names":[],"mappings":";;;AACA,kCAAqC;AAErC,8CAAiD;AACjD,qCAA6C;AAE7C,kRAAkR;AAClR,MAAa,UAAW,SAAQ,iBAAU;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,IAAA,6BAAgB,EAAC,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,0BAAiB,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;;AA9BH,gCA+BC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../../src/modules/logger/pino/logger.ts"],"names":[],"mappings":";;;AACA,kCAAqC;AAErC,8CAAiD;AACjD,uCAA8C;AAE9C,kRAAkR;AAClR,MAAa,UAAW,SAAQ,iBAAU;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,IAAA,6BAAgB,EAAC,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,2BAAiB,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;;AA9BH,gCA+BC"}

package/dist/cjs/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/cjs/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/cjs/modules/logger/resolver.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LoggerResolver = void 0;
 const abstract_1 = require("./base/abstract");
 const console_1 = require("./base/console");
+const slot_1 = require("./slot");
 /** 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 abstract_1.AbstractLogger {
     constructor(scopes) {
@@ -46,6 +47,8 @@ class ResolvedLogger extends abstract_1.AbstractLogger {
 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 console_1.ConsoleLogger.get({ scope: opts.scopes.filter(el => el && el.length > 0).join('-') });
     }; }
     static { this.active = this.consoleResolver; }
@@ -83,10 +86,14 @@ class LoggerResolver {
         console_1.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; }
 }
 exports.LoggerResolver = LoggerResolver;
+// 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.
+slot_1.loggerSlot.resolve = opts => LoggerResolver.resolve({ scopes: opts.scopes });
 //# sourceMappingURL=resolver.js.map

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/slot.d.ts

@@ -0,0 +1,23 @@
+import type { ILogger } from './common/types';
+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/cjs/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/cjs/modules/logger/slot.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pinHelperLogger = exports.resolveHelperLogger = exports.loggerSlot = void 0;
+const types_1 = require("./common/types");
+/**
+ * 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.
+ */
+exports.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 types_1.LogLevels.DEBUG: {
+            globalThis.console.debug(line, ...args);
+            break;
+        }
+        case types_1.LogLevels.INFO: {
+            globalThis.console.info(line, ...args);
+            break;
+        }
+        case types_1.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 types_1.LogLevels.DEBUG: {
+            logger.debug(message, ...args);
+            break;
+        }
+        case types_1.LogLevels.INFO: {
+            logger.info(message, ...args);
+            break;
+        }
+        case types_1.LogLevels.WARN: {
+            logger.warn(message, ...args);
+            break;
+        }
+        case types_1.LogLevels.ERROR: {
+            logger.error(message, ...args);
+            break;
+        }
+        case types_1.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 = exports.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(types_1.LogLevels.DEBUG, message, args),
+        info: (message, ...args) => write(types_1.LogLevels.INFO, message, args),
+        warn: (message, ...args) => write(types_1.LogLevels.WARN, message, args),
+        error: (message, ...args) => write(types_1.LogLevels.ERROR, message, args),
+        emerg: (message, ...args) => write(types_1.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. */
+const resolveHelperLogger = (opts) => {
+    const resolve = exports.loggerSlot.resolve;
+    return resolve ? resolve({ scopes: opts.scopes }) : createDeferredLogger({ scopes: opts.scopes });
+};
+exports.resolveHelperLogger = resolveHelperLogger;
+/** Pins a logger on a helper instance: later reads are a plain property read, not its getter. */
+const pinHelperLogger = (opts) => {
+    Object.defineProperty(opts.helper, 'logger', {
+        value: opts.logger,
+        writable: true,
+        configurable: true,
+        enumerable: false,
+    });
+};
+exports.pinHelperLogger = pinHelperLogger;
+//# sourceMappingURL=slot.js.map

package/dist/cjs/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/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":"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/cjs/modules/logger/winston/common/constants.js

@@ -0,0 +1,13 @@
+"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 parse_utility_1 = require("../../../../utilities/parse.utility");
+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 = (0, parse_utility_1.blankToUndefined)(process.env.APP_ENV_LOGGER_FORMAT) ?? 'text';
+exports.LOGGER_FILE_FREQUENCY = (0, parse_utility_1.blankToUndefined)(process.env.APP_ENV_LOGGER_FILE_FREQUENCY) ?? '1h';
+exports.LOGGER_FILE_MAX_SIZE = (0, parse_utility_1.blankToUndefined)(process.env.APP_ENV_LOGGER_FILE_MAX_SIZE) ?? '100m';
+exports.LOGGER_FILE_MAX_FILES = (0, parse_utility_1.blankToUndefined)(process.env.APP_ENV_LOGGER_FILE_MAX_FILES) ?? '5d';
+exports.LOGGER_FILE_DATE_PATTERN = (0, parse_utility_1.blankToUndefined)(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,6DAA6D;AAC7D,kDAA8C;AAE9C,gGAAgG;AACnF,QAAA,aAAa,GAAG,oBAAQ,CAAC,gBAAgB,CAAC;AAC1C,QAAA,aAAa,GAAG,IAAA,gCAAgB,EAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,MAAM,CAAC;AAE9E,QAAA,qBAAqB,GAChC,IAAA,gCAAgB,EAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,IAAI,IAAI,CAAC;AACzD,QAAA,oBAAoB,GAC/B,IAAA,gCAAgB,EAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,IAAI,MAAM,CAAC;AAC1D,QAAA,qBAAqB,GAChC,IAAA,gCAAgB,EAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,IAAI,IAAI,CAAC;AACzD,QAAA,wBAAwB,GACnC,IAAA,gCAAgB,EAAC,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,IAAI,aAAa,CAAC"}

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,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"}