@venizia/ignis-helpers 0.0.9-1 → 0.1.0

package/dist/modules/cron/cron.helper.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CronHelper = void 0;
 const base_1 = require("../../modules/base");
+const promise_utility_1 = require("../../utilities/promise.utility");
 const cron_1 = require("cron");
 const isEmpty_1 = __importDefault(require("lodash/isEmpty"));
 const error_1 = require("../error");
@@ -18,25 +19,44 @@ class CronHelper extends base_1.BaseHelper {
         this.autoStart = autoStart ?? false;
         this.tz = tz;
         this.errorHandler = errorHandler;
-        this.configure();
+        this.buildInstance();
     }
     static newInstance(opts) {
         return new CronHelper(opts);
     }
-    configure() {
+    /** Builds the job. Synchronous, so the constructor still THROWS on a bad cronTime. */
+    buildInstance() {
         if (!this.cronTime || (0, isEmpty_1.default)(this.cronTime)) {
             throw error_1.ApplicationError.getError({
                 message: '[CronHelper][configure] Invalid cronTime to configure application cron!',
             });
         }
-        this.instance = cron_1.CronJob.from({
-            cronTime: this.cronTime,
-            onTick: this.onTick,
-            onComplete: this.onCompleted,
-            start: this.autoStart,
-            errorHandler: this.errorHandler,
-            timeZone: this.tz,
-        });
+        try {
+            this.instance = cron_1.CronJob.from({
+                cronTime: this.cronTime,
+                onTick: this.onTick,
+                onComplete: this.onCompleted,
+                start: this.autoStart,
+                errorHandler: this.errorHandler,
+                timeZone: this.tz,
+            });
+        }
+        catch (error) {
+            throw error_1.ApplicationError.getError({
+                message: `[CronHelper][configure] Invalid cron expression | cronTime: ${this.cronTime} | error: ${error}`,
+            });
+        }
+    }
+    /**
+     * Async because `CronJob.stop()` resolves only once an IN-FLIGHT tick has finished. Fire-and-
+     * forgetting it lets the replacement job start while the old handler is still running - the very
+     * double-fire this stop exists to prevent.
+     */
+    async configure() {
+        if (this.instance) {
+            await this.instance.stop();
+        }
+        this.buildInstance();
     }
     start() {
         if (!this.instance) {
@@ -45,11 +65,32 @@ class CronHelper extends base_1.BaseHelper {
         }
         this.instance.start();
     }
+    async stop() {
+        if (!this.instance) {
+            this.logger.for(this.stop.name).error('Invalid cron instance to stop cronjob!');
+            return;
+        }
+        await this.instance.stop();
+    }
     modifyCronTime(opts) {
         const { cronTime, shouldFireOnTick = false } = opts;
-        this.instance.setTime(new cron_1.CronTime(cronTime));
+        let nextCronTime;
+        try {
+            nextCronTime = new cron_1.CronTime(cronTime, this.tz);
+        }
+        catch (error) {
+            throw error_1.ApplicationError.getError({
+                message: `[CronHelper][modifyCronTime] Invalid cron expression | cronTime: ${cronTime} | error: ${error}`,
+            });
+        }
+        this.instance.setTime(nextCronTime);
+        this.cronTime = cronTime;
         if (shouldFireOnTick) {
-            this.instance.fireOnTick();
+            (0, promise_utility_1.voidExecution)({
+                logger: this.logger,
+                scope: this.modifyCronTime.name,
+                execution: this.instance.fireOnTick(),
+            });
         }
     }
     duplicate(opts) {

package/dist/modules/cron/cron.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"cron.helper.js","sourceRoot":"","sources":["../../../src/modules/cron/cron.helper.ts"],"names":[],"mappings":";;;;;;AAAA,yCAA4C;AAC5C,+BAAgE;AAChE,6DAAqC;AACrC,oCAA4C;AAW5C,MAAa,UAAW,SAAQ,iBAAU;IAUxC,YAAY,IAAwB;QAClC,KAAK,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAEhF,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,GAAG,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;QACpF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,KAAK,CAAC;QACpC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QAEjC,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAwB;QACzC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAA,iBAAO,EAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,MAAM,wBAAgB,CAAC,QAAQ,CAAC;gBAC9B,OAAO,EAAE,yEAAyE;aACnF,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,cAAO,CAAC,IAAI,CAAC;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,KAAK,EAAE,IAAI,CAAC,SAAS;YACrB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,QAAQ,EAAE,IAAI,CAAC,EAAE;SAClB,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC3E,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,cAAc,CAAC,IAAsD;QACnE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QAEpD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,eAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE9C,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,SAAS,CAAC,IAA0B;QAClC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAE1B,MAAM,OAAO,GAAuB;YAClC,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC;QAEF,OAAO,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AA9ED,gCA8EC"}
+{"version":3,"file":"cron.helper.js","sourceRoot":"","sources":["../../../src/modules/cron/cron.helper.ts"],"names":[],"mappings":"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"}

package/dist/modules/env/app-env.d.ts

@@ -3,11 +3,21 @@ export declare class Environment {
     static readonly LOCAL = "local";
     static readonly DEBUG = "debug";
     static readonly DEVELOPMENT = "development";
+    /** The abbreviation deployments actually write. The same environment as {@link DEVELOPMENT}. */
+    static readonly DEV = "dev";
+    static readonly SIT = "sit";
+    static readonly UAT = "uat";
     static readonly ALPHA = "alpha";
     static readonly BETA = "beta";
     static readonly STAGING = "staging";
     static readonly PRODUCTION = "production";
     static COMMON_ENVS: Set<string>;
+    /**
+     * The environments whose users are our own engineers - the only ones an error response may reach
+     * carrying a stack trace, a SQL constraint name or a raw driver message. Everything absent from
+     * this set, INCLUDING an unrecognized name, is sanitized as production.
+     */
+    static DEVELOPMENT_ENVS: Set<string>;
     static get current(): string;
     static is(opts: {
         name: string;
@@ -20,7 +30,10 @@ export declare class ApplicationEnvironment implements IApplicationEnvironment {
         prefix: string;
         envs: Record<string, string | number | undefined>;
     });
-    get<ReturnType>(key: string, defaultValue?: ReturnType): ReturnType;
+    get<ReturnType, BeforeTransformType = unknown>(key: string, opts?: {
+        defaultValue?: ReturnType;
+        transform?: (value: BeforeTransformType) => ReturnType;
+    }): ReturnType;
     set<ValueType>(key: string, value: ValueType): void;
     isDevelopment(): boolean;
     keys(): string[];

package/dist/modules/env/app-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-env.d.ts","sourceRoot":"","sources":["../../../src/modules/env/app-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAElD,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAEhC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IAEpC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAE1C,MAAM,CAAC,WAAW,cAQf;IAEH,MAAM,KAAK,OAAO,IAAI,MAAM,CAG3B;IAED,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;CAGjC;AAED,qBAAa,sBAAuB,YAAW,uBAAuB;IACpE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAA2B;gBAEhC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;KAAE;IAYvF,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,UAAU,GAAG,UAAU;IAInE,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS;IAI5C,aAAa;IAKb,IAAI;CAGL;AAED,eAAO,MAAM,sBAAsB,wBAGjC,CAAC;AAEH,eAAO,MAAM,IAAI,wBAAyB,CAAC"}
+{"version":3,"file":"app-env.d.ts","sourceRoot":"","sources":["../../../src/modules/env/app-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAElD,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAEhC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAC5C,gGAAgG;IAChG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAC5B,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAE5B,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAC5B,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAChC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IAEpC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAE1C,MAAM,CAAC,WAAW,cAWf;IAEH;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,cAA2E;IAElG,MAAM,KAAK,OAAO,IAAI,MAAM,CAO3B;IAED,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;CAGjC;AAED,qBAAa,sBAAuB,YAAW,uBAAuB;IACpE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAA2B;gBAEhC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;KAAE;IAYvF,GAAG,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,EAC3C,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;QACL,YAAY,CAAC,EAAE,UAAU,CAAC;QAC1B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,UAAU,CAAC;KACxD,GACA,UAAU;IAWb,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS;IAI5C,aAAa;IAKb,IAAI;CAGL;AAED,eAAO,MAAM,sBAAsB,wBAGjC,CAAC;AAEH,eAAO,MAAM,IAAI,wBAAyB,CAAC"}

package/dist/modules/env/app-env.js

@@ -5,6 +5,10 @@ class Environment {
     static { this.LOCAL = 'local'; }
     static { this.DEBUG = 'debug'; }
     static { this.DEVELOPMENT = 'development'; }
+    /** The abbreviation deployments actually write. The same environment as {@link DEVELOPMENT}. */
+    static { this.DEV = 'dev'; }
+    static { this.SIT = 'sit'; }
+    static { this.UAT = 'uat'; }
     static { this.ALPHA = 'alpha'; }
     static { this.BETA = 'beta'; }
     static { this.STAGING = 'staging'; }
@@ -13,14 +17,26 @@ class Environment {
         this.LOCAL,
         this.DEBUG,
         this.DEVELOPMENT,
+        this.DEV,
+        this.SIT,
+        this.UAT,
         this.ALPHA,
         this.BETA,
         this.STAGING,
         this.PRODUCTION,
     ]); }
+    /**
+     * The environments whose users are our own engineers - the only ones an error response may reach
+     * carrying a stack trace, a SQL constraint name or a raw driver message. Everything absent from
+     * this set, INCLUDING an unrecognized name, is sanitized as production.
+     */
+    static { this.DEVELOPMENT_ENVS = new Set([this.LOCAL, this.DEBUG, this.DEVELOPMENT, this.DEV, this.SIT]); }
     static get current() {
         const { NODE_ENV } = process.env;
-        return NODE_ENV || Environment.DEVELOPMENT;
+        if (!NODE_ENV) {
+            return Environment.DEVELOPMENT;
+        }
+        return NODE_ENV;
     }
     static is(opts) {
         return this.current === opts.name;
@@ -38,8 +54,13 @@ class ApplicationEnvironment {
             this.arguments[key] = opts.envs[key];
         }
     }
-    get(key, defaultValue) {
-        return this.arguments[key] ?? defaultValue;
+    get(key, opts) {
+        const rs = this.arguments[key];
+        if (!opts?.transform) {
+            return (rs ?? opts?.defaultValue);
+        }
+        const transformed = opts.transform(rs);
+        return (transformed ?? opts?.defaultValue);
     }
     set(key, value) {
         this.arguments[key] = value;

package/dist/modules/env/app-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-env.js","sourceRoot":"","sources":["../../../src/modules/env/app-env.ts"],"names":[],"mappings":";;;AAEA,MAAa,WAAW;aACN,UAAK,GAAG,OAAO,CAAC;aAChB,UAAK,GAAG,OAAO,CAAC;aAEhB,gBAAW,GAAG,aAAa,CAAC;aAE5B,UAAK,GAAG,OAAO,CAAC;aAChB,SAAI,GAAG,MAAM,CAAC;aACd,YAAO,GAAG,SAAS,CAAC;aAEpB,eAAU,GAAG,YAAY,CAAC;aAEnC,gBAAW,GAAG,IAAI,GAAG,CAAC;QAC3B,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,WAAW;QAChB,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,UAAU;KAChB,CAAC,CAAC;IAEH,MAAM,KAAK,OAAO;QAChB,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;QACjC,OAAO,QAAQ,IAAI,WAAW,CAAC,WAAW,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,IAAsB;QAC9B,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI,CAAC;IACpC,CAAC;;AA7BH,kCA8BC;AAED,MAAa,sBAAsB;IAIjC,YAAY,IAA2E;QAF/E,cAAS,GAAwB,EAAE,CAAC;QAG1C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE1B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,GAAG,CAAa,GAAW,EAAE,YAAyB;QACpD,OAAQ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAgB,IAAK,YAA2B,CAAC;IAC7E,CAAC;IAED,GAAG,CAAY,GAAW,EAAE,KAAgB;QAC1C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED,aAAa;QACX,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;QACjC,OAAO,QAAQ,KAAK,aAAa,CAAC;IACpC,CAAC;IAED,IAAI;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;CACF;AAhCD,wDAgCC;AAEY,QAAA,sBAAsB,GAAG,IAAI,sBAAsB,CAAC;IAC/D,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,SAAS;IACvD,IAAI,EAAE,OAAO,CAAC,GAAG;CAClB,CAAC,CAAC;AAEU,QAAA,IAAI,GAAG,8BAAsB,CAAC"}
+{"version":3,"file":"app-env.js","sourceRoot":"","sources":["../../../src/modules/env/app-env.ts"],"names":[],"mappings":"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"}

package/dist/modules/env/types.d.ts

@@ -1,5 +1,8 @@
 export interface IApplicationEnvironment {
-    get<ReturnType>(key: string, defaultValue?: ReturnType): ReturnType;
+    get<ReturnType, BeforeTransformType = unknown>(key: string, opts?: {
+        defaultValue?: ReturnType;
+        transform?: (value: BeforeTransformType) => ReturnType;
+    }): ReturnType;
     set<ValueType>(key: string, value: ValueType): any;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/modules/env/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/env/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IACpE,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC;CACpD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/env/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,EAC3C,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;QACL,YAAY,CAAC,EAAE,UAAU,CAAC;QAC1B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,UAAU,CAAC;KACxD,GACA,UAAU,CAAC;IACd,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC;CACpD"}

package/dist/modules/error/app-error.d.ts

@@ -1,10 +1,21 @@
 import { TError } from './types';
 export declare class ApplicationError extends Error {
     statusCode: number;
-    messageCode?: string;
+    messageCode: string;
     extra?: Record<string, unknown>;
     constructor(opts: TError);
     static getError(opts: TError): ApplicationError;
 }
 export declare const getError: (opts: TError) => ApplicationError;
+/**
+ * Recognizes an application error by SHAPE, not by class identity.
+ *
+ * `instanceof ApplicationError` is not enough: an error raised by the DI container carries
+ * inversion's class, and inversion's dual CJS/ESM build gives even that class two runtime
+ * identities. A CJS consumer and an ESM consumer therefore hold different constructors for the
+ * same source. Code that must tell "an error the framework already shaped" from "a raw failure to
+ * sanitize" - the search connectors do exactly that before wrapping anything else as a 503 - has
+ * to test the shape instead, or a real 404 arrives at the caller as a bogus 503.
+ */
+export declare const isApplicationError: (error: unknown) => error is ApplicationError;
 //# sourceMappingURL=app-error.d.ts.map

package/dist/modules/error/app-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-error.d.ts","sourceRoot":"","sources":["../../../src/modules/error/app-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEpB,IAAI,EAAE,MAAM;IASxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM;CAG7B;AAED,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,qBAEpC,CAAC"}
+{"version":3,"file":"app-error.d.ts","sourceRoot":"","sources":["../../../src/modules/error/app-error.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEpB,IAAI,EAAE,MAAM;IAUxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM;CAG7B;AAED,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,qBAEpC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,gBAE5D,CAAC"}

package/dist/modules/error/app-error.js

@@ -1,12 +1,18 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getError = exports.ApplicationError = void 0;
+exports.isApplicationError = exports.getError = exports.ApplicationError = void 0;
+const omit_1 = __importDefault(require("lodash/omit"));
+const message_code_1 = require("./message-code");
 class ApplicationError extends Error {
     constructor(opts) {
-        const { message, messageCode, statusCode = 400, name: _name, ...extra } = opts;
+        const { message, messageCode, statusCode = 400, ...rest } = opts;
         super(message);
         this.statusCode = statusCode;
-        this.messageCode = messageCode;
+        this.messageCode = message_code_1.MessageCode.resolve(messageCode);
+        const extra = (0, omit_1.default)(rest, ['name']);
         this.extra = Object.keys(extra).length > 0 ? extra : undefined;
     }
     static getError(opts) {
@@ -18,4 +24,18 @@ const getError = (opts) => {
     return new ApplicationError(opts);
 };
 exports.getError = getError;
+/**
+ * Recognizes an application error by SHAPE, not by class identity.
+ *
+ * `instanceof ApplicationError` is not enough: an error raised by the DI container carries
+ * inversion's class, and inversion's dual CJS/ESM build gives even that class two runtime
+ * identities. A CJS consumer and an ESM consumer therefore hold different constructors for the
+ * same source. Code that must tell "an error the framework already shaped" from "a raw failure to
+ * sanitize" - the search connectors do exactly that before wrapping anything else as a 503 - has
+ * to test the shape instead, or a real 404 arrives at the caller as a bogus 503.
+ */
+const isApplicationError = (error) => {
+    return error instanceof Error && typeof error.statusCode === 'number';
+};
+exports.isApplicationError = isApplicationError;
 //# sourceMappingURL=app-error.js.map

package/dist/modules/error/app-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-error.js","sourceRoot":"","sources":["../../../src/modules/error/app-error.ts"],"names":[],"mappings":";;;AAEA,MAAa,gBAAiB,SAAQ,KAAK;IAKzC,YAAY,IAAY;QACtB,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,GAAG,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QAC/E,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AAjBD,4CAiBC;AAEM,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE;IACvC,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC;AAFW,QAAA,QAAQ,YAEnB"}
+{"version":3,"file":"app-error.js","sourceRoot":"","sources":["../../../src/modules/error/app-error.ts"],"names":[],"mappings":";;;;;;AACA,uDAA+B;AAC/B,iDAA6C;AAG7C,MAAa,gBAAiB,SAAQ,KAAK;IAKzC,YAAY,IAAY;QACtB,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,GAAG,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACjE,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,0BAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,IAAA,cAAI,EAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AAlBD,4CAkBC;AAEM,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE;IACvC,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC;AAFW,QAAA,QAAQ,YAEnB;AAEF;;;;;;;;;GASG;AACI,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAA6B,EAAE;IAC9E,OAAO,KAAK,YAAY,KAAK,IAAI,OAAQ,KAAiB,CAAC,UAAU,KAAK,QAAQ,CAAC;AACrF,CAAC,CAAC;AAFW,QAAA,kBAAkB,sBAE7B"}

package/dist/modules/error/index.d.ts

@@ -1,3 +1,4 @@
 export * from './app-error';
+export * from './message-code';
 export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/modules/error/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/error/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/error/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}

package/dist/modules/error/index.js

@@ -15,5 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./app-error"), exports);
+__exportStar(require("./message-code"), exports);
 __exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/modules/error/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/error/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/error/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,iDAA+B;AAC/B,0CAAwB"}

package/dist/modules/error/message-code.d.ts

@@ -0,0 +1,18 @@
+export declare class MessageCode {
+    static readonly SEPARATOR = ".";
+    static readonly SEGMENT_PATTERN: RegExp;
+    static readonly MIN_SEGMENTS = 2;
+    static readonly DEFAULT = "core.system_error";
+    /**
+     * Builds a code from its segments. Throws on a malformed one - codes are declared at module scope,
+     * so a bad code fails the process at import instead of shipping dead into production.
+     */
+    static build(opts: {
+        parts: Array<string>;
+    }): string;
+    /** True when `code` is well-formed. Cheap guard for a code that arrives from outside. */
+    static isValid(code: string): boolean;
+    /** Normalizes an absent or empty code to {@link DEFAULT} - an empty string is not a code. */
+    static resolve(code?: string): string;
+}
+//# sourceMappingURL=message-code.d.ts.map

package/dist/modules/error/message-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-code.d.ts","sourceRoot":"","sources":["../../../src/modules/error/message-code.ts"],"names":[],"mappings":"AAEA,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,SAAS,OAAO;IAChC,MAAM,CAAC,QAAQ,CAAC,eAAe,SAA8B;IAC7D,MAAM,CAAC,QAAQ,CAAC,YAAY,KAAK;IACjC,MAAM,CAAC,QAAQ,CAAC,OAAO,uBAAuB;IAE9C;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,MAAM;IAsBpD,yFAAyF;IACzF,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASrC,6FAA6F;IAC7F,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;CAGtC"}

package/dist/modules/error/message-code.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageCode = void 0;
+const app_error_1 = require("./app-error");
+class MessageCode {
+    static { this.SEPARATOR = '.'; }
+    static { this.SEGMENT_PATTERN = /^[a-z0-9]+(_[a-z0-9]+)*$/; }
+    static { this.MIN_SEGMENTS = 2; }
+    static { this.DEFAULT = 'core.system_error'; }
+    /**
+     * Builds a code from its segments. Throws on a malformed one - codes are declared at module scope,
+     * so a bad code fails the process at import instead of shipping dead into production.
+     */
+    static build(opts) {
+        const { parts } = opts;
+        if (parts.length < this.MIN_SEGMENTS) {
+            throw (0, app_error_1.getError)({
+                messageCode: 'core.message_code.invalid_segment_count',
+                message: `[MessageCode][build] A code needs at least ${this.MIN_SEGMENTS} segments (namespace + reason) | Got: ${JSON.stringify(parts)}`,
+            });
+        }
+        for (const segment of parts) {
+            if (!this.SEGMENT_PATTERN.test(segment)) {
+                throw (0, app_error_1.getError)({
+                    messageCode: 'core.message_code.invalid_segment_format',
+                    message: `[MessageCode][build] Invalid segment '${segment}' | Expected lower snake_case (a-z, 0-9, '_') | Full: ${JSON.stringify(parts)}`,
+                });
+            }
+        }
+        return parts.join(this.SEPARATOR).toLowerCase();
+    }
+    /** True when `code` is well-formed. Cheap guard for a code that arrives from outside. */
+    static isValid(code) {
+        const segments = code.split(this.SEPARATOR);
+        return (segments.length >= this.MIN_SEGMENTS &&
+            segments.every(segment => this.SEGMENT_PATTERN.test(segment)));
+    }
+    /** Normalizes an absent or empty code to {@link DEFAULT} - an empty string is not a code. */
+    static resolve(code) {
+        return code?.length ? code.toLowerCase() : this.DEFAULT.toLowerCase();
+    }
+}
+exports.MessageCode = MessageCode;
+//# sourceMappingURL=message-code.js.map

package/dist/modules/error/message-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-code.js","sourceRoot":"","sources":["../../../src/modules/error/message-code.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AAEvC,MAAa,WAAW;aACN,cAAS,GAAG,GAAG,CAAC;aAChB,oBAAe,GAAG,0BAA0B,CAAC;aAC7C,iBAAY,GAAG,CAAC,CAAC;aACjB,YAAO,GAAG,mBAAmB,CAAC;IAE9C;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,IAA8B;QACzC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEvB,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACrC,MAAM,IAAA,oBAAQ,EAAC;gBACb,WAAW,EAAE,yCAAyC;gBACtD,OAAO,EAAE,8CAA8C,IAAI,CAAC,YAAY,yCAAyC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;aACzI,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAA,oBAAQ,EAAC;oBACb,WAAW,EAAE,0CAA0C;oBACvD,OAAO,EAAE,yCAAyC,OAAO,yDAAyD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;iBAC1I,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,CAAC;IAED,yFAAyF;IACzF,MAAM,CAAC,OAAO,CAAC,IAAY;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE5C,OAAO,CACL,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY;YACpC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAC9D,CAAC;IACJ,CAAC;IAED,6FAA6F;IAC7F,MAAM,CAAC,OAAO,CAAC,IAAa;QAC1B,OAAO,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACxE,CAAC;;AA7CH,kCA8CC"}

package/dist/modules/index.d.ts

@@ -9,7 +9,6 @@ export * from './queue';
 export * from './redis';
 export * from './socket';
 export * from './storage';
-export * from './testing';
 export * from './uid';
 export * from './worker-thread';
 //# sourceMappingURL=index.d.ts.map

package/dist/modules/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AAEvB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AAEvB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,iBAAiB,CAAC"}

package/dist/modules/index.js

@@ -25,7 +25,6 @@ __exportStar(require("./queue"), exports);
 __exportStar(require("./redis"), exports);
 __exportStar(require("./socket"), exports);
 __exportStar(require("./storage"), exports);
-__exportStar(require("./testing"), exports);
 __exportStar(require("./uid"), exports);
 __exportStar(require("./worker-thread"), exports);
 //# sourceMappingURL=index.js.map

package/dist/modules/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AAEvB,2CAAyB;AACzB,wCAAsB;AACtB,0CAAwB;AACxB,2CAAyB;AACzB,4CAA0B;AAC1B,yCAAuB;AACvB,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,4CAA0B;AAC1B,4CAA0B;AAC1B,wCAAsB;AACtB,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AAEvB,2CAAyB;AACzB,wCAAsB;AACtB,0CAAwB;AACxB,2CAAyB;AACzB,4CAA0B;AAC1B,yCAAuB;AACvB,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,4CAA0B;AAC1B,wCAAsB;AACtB,kDAAgC"}

package/dist/modules/logger/default-logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default-logger.d.ts","sourceRoot":"","sources":["../../../src/modules/logger/default-logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,2BAA2B,CAAC;AACnC,OAAO,EAAkB,sBAAsB,EAAE,MAAM,cAAc,CAAC;AActE,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAE9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAmC;IAE7D,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGzC;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,eAAO,MAAM,yBAAyB,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,2BAShE,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,2BAalE,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;AAEpF,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,SAAS,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAChD,SAAS,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAChD,eAAe,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5D,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;AAED,eAAO,MAAM,kBAAkB,GAAI,MAAM,oBAAoB,mBAyF5D,CAAC;AAWF,eAAO,MAAM,iBAAiB,gBAK5B,CAAC"}
+{"version":3,"file":"default-logger.d.ts","sourceRoot":"","sources":["../../../src/modules/logger/default-logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAI7C,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,2BAA2B,CAAC;AAEnC,OAAO,EAAkB,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAatE,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAE9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAmC;IAE7D,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGzC;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,eAAO,MAAM,yBAAyB,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,2BAShE,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,2BAalE,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;AAEpF,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,SAAS,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAChD,SAAS,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAChD,eAAe,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5D,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;AAED,eAAO,MAAM,kBAAkB,GAAI,MAAM,oBAAoB,mBAyF5D,CAAC;AAWF,eAAO,MAAM,iBAAiB,gBAK5B,CAAC"}

package/dist/modules/logger/default-logger.js

@@ -6,11 +6,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.applicationLogger = exports.defineCustomLogger = exports.applicationLogFormatter = exports.defineLogFormatter = exports.definePrettyLoggerFormatter = exports.defineJsonLoggerFormatter = exports.LoggerFormats = 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 ignis_inversion_1 = require("@venizia/ignis-inversion");
 const LOGGER_FOLDER_PATH = process.env.APP_ENV_LOGGER_FOLDER_PATH ?? './';
 const LOGGER_PREFIX = constants_1.Defaults.APPLICATION_NAME;
 const LOGGER_FORMAT = process.env.APP_ENV_LOGGER_FORMAT ?? 'text';
@@ -29,11 +30,11 @@ class LoggerFormats {
 }
 exports.LoggerFormats = LoggerFormats;
 const defineJsonLoggerFormatter = (opts) => {
-    return f.combine(f.label({ label: opts.label }), f.timestamp(), f.splat(), f.errors({ stack: true }), f.json(), f.colorize());
+    return f.combine(f.label({ label: opts.label }), f.timestamp(), (0, formatters_1.deepSplat)(), f.errors({ stack: true }), f.json(), f.colorize());
 };
 exports.defineJsonLoggerFormatter = defineJsonLoggerFormatter;
 const definePrettyLoggerFormatter = (opts) => {
-    return f.combine(f.simple(), f.label({ label: opts.label }), f.timestamp(), f.splat(), f.align(), f.colorize(), f.printf(({ level, message, label, timestamp }) => {
+    return f.combine(f.simple(), f.label({ label: opts.label }), f.timestamp(), (0, formatters_1.deepSplat)(), f.align(), f.colorize(), f.printf(({ level, message, label, timestamp }) => {
         return `${timestamp} [${label}] ${level}: ${message}`;
     }), f.errors({ stack: true }));
 };

package/dist/modules/logger/default-logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-logger.js","sourceRoot":"","sources":["../../../src/modules/logger/default-logger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"default-logger.js","sourceRoot":"","sources":["../../../src/modules/logger/default-logger.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA8C;AAE9C,6DAAgD;AAChD,8DAAoD;AACpD,0DAA6B;AAC7B,sDAA8B;AAC9B,qCAAmC;AACnC,8CAA0C;AAC1C,6CAAsE;AAEtE,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,IAAI,CAAC;AAC1E,MAAM,aAAa,GAAG,oBAAQ,CAAC,gBAAgB,CAAC;AAChD,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,MAAM,CAAC;AAElE,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,IAAI,CAAC;AAChF,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,MAAM,CAAC;AAChF,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,IAAI,CAAC;AAChF,MAAM,wBAAwB,GAAG,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,aAAa,CAAC;AAE/F,MAAM,CAAC,GAAG,iBAAO,CAAC,MAAM,CAAC;AAEzB,MAAa,aAAa;aACR,SAAI,GAAG,MAAM,CAAC;aACd,SAAI,GAAG,MAAM,CAAC;aAEd,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE7D,MAAM,CAAC,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;;AARH,sCASC;AAIM,MAAM,yBAAyB,GAAG,CAAC,IAAuB,EAAE,EAAE;IACnE,OAAO,CAAC,CAAC,OAAO,CACd,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,EAC9B,CAAC,CAAC,SAAS,EAAE,EACb,IAAA,sBAAS,GAAE,EACX,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EACzB,CAAC,CAAC,IAAI,EAAE,EACR,CAAC,CAAC,QAAQ,EAAE,CACb,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,yBAAyB,6BASpC;AAEK,MAAM,2BAA2B,GAAG,CAAC,IAAuB,EAAE,EAAE;IACrE,OAAO,CAAC,CAAC,OAAO,CACd,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,EAC9B,CAAC,CAAC,SAAS,EAAE,EACb,IAAA,sBAAS,GAAE,EACX,CAAC,CAAC,KAAK,EAAE,EACT,CAAC,CAAC,QAAQ,EAAE,EACZ,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE;QAChD,OAAO,GAAG,SAAS,KAAK,KAAK,KAAK,KAAK,KAAK,OAAO,EAAE,CAAC;IACxD,CAAC,CAAC,EACF,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAC1B,CAAC;AACJ,CAAC,CAAC;AAbW,QAAA,2BAA2B,+BAatC;AAEK,MAAM,kBAAkB,GAAG,CAAC,IAA+C,EAAE,EAAE;IACpF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAK,aAA+B,CAAC;IAE/D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;YACxB,OAAO,IAAA,iCAAyB,EAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,KAAK,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;YACxB,OAAO,IAAA,mCAA2B,EAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,IAAA,0BAAQ,EAAC;gBACb,OAAO,EAAE,kDAAkD,MAAM,cAAc,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,EAAE;aAC/G,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAhBW,QAAA,kBAAkB,sBAgB7B;AAEW,QAAA,uBAAuB,GAAG,IAAA,0BAAkB,EAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;AA2B7E,MAAM,kBAAkB,GAAG,CAAC,IAA0B,EAAE,EAAE;IAC/D,MAAM,EACJ,SAAS,GAAG;QACV,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;KACT,EACD,SAAS,GAAG;QACV,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM;KACd,EACD,eAAe,GAAG,+BAAuB,EACzC,UAAU,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,qBAAqB,EAAE,GACzE,GAAG,IAAI,CAAC;IAET,MAAM,mBAAmB,GAAG,IAAI,iBAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/E,MAAM,UAAU,GAGZ;QACF,OAAO,EAAE,CAAC,mBAAmB,CAAC;QAC9B,SAAS,EAAE,CAAC,mBAAmB,CAAC;KACjC,CAAC;IAEF,IAAI,oBAAoB,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,iBAAO,CAAC,UAAU,CAAC,eAAe,CAAC;YACvD,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,qBAAqB;YACtD,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,oBAAoB;YACjD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,qBAAqB;YACpD,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,wBAAwB;YAC7D,QAAQ,EAAE,mBAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,QAAQ,CAAC,MAAM,kBAAkB,CAAC;YAC3E,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QAEH,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,qBAAqB,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,iBAAO,CAAC,UAAU,CAAC,eAAe,CAAC;YACvD,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,qBAAqB;YACtD,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,oBAAoB;YACjD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,qBAAqB;YACpD,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,wBAAwB;YAC7D,QAAQ,EAAE,mBAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,QAAQ,CAAC,MAAM,mBAAmB,CAAC;YAC5E,KAAK,EAAE,OAAO;SACf,CAAC,CAAC;QAEH,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,oBAAoB,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,2BAAc,CAAC,WAAW,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACzE,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,IAAI,qBAAqB,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,2BAAc,CAAC,WAAW,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC1E,IAAI,SAAS,EAAE,CAAC;YACd,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,iBAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAE7B,OAAO,iBAAO,CAAC,YAAY,CAAC;QAC1B,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,eAAe;QACvB,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,UAAU,CAAC,OAAO;QAC9B,iBAAiB,EAAE,UAAU,CAAC,SAAS;KACxC,CAAC,CAAC;AACL,CAAC,CAAC;AAzFW,QAAA,kBAAkB,sBAyF7B;AAEF,MAAM,WAAW,GAAG,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AAC1E,MAAM,YAAY,GAAoC;IACpD,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IAC/B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;IAC3C,IAAI,EAAE,IAAA,mBAAG,EAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IAChD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B;IAC7C,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;CACvF,CAAC;AAEW,QAAA,iBAAiB,GAAG,IAAA,0BAAkB,EAAC;IAClD,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE;QAChD,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE;KAClD;CACF,CAAC,CAAC"}

package/dist/modules/logger/formatters/deep-splat.d.ts

@@ -0,0 +1,23 @@
+import util from 'node:util';
+import winston from 'winston';
+/**
+ * Formats a log message the way `util.format` does - except that an object passed to `%s` is
+ * inspected {@link DEFAULT_INSPECT_DEPTH} levels deep instead of Node's hard-coded 0.
+ *
+ * Node forces `depth: 0` on `%s` (see `formatWithOptionsInternal`), which no inspect option can
+ * override: `logger.error('Error: %s', error)` therefore prints `extra: [Object]` and drops the
+ * nested `cause` of every wrapped driver error. Pre-inspecting the object into a string first is the
+ * only way to widen it, and it must be done per-placeholder: doing it to ALL arguments would turn
+ * `%j` into a JSON-quoted string instead of an object.
+ */
+export declare const formatLogMessage: (opts: {
+    message: string;
+    args: Array<unknown>;
+    inspectOptions?: util.InspectOptions;
+}) => string;
+/**
+ * Drop-in replacement for `winston.format.splat()` that formats through {@link formatLogMessage}.
+ * Every transport reads `info.message`, so widening it here widens console, file and dgram at once.
+ */
+export declare const deepSplat: winston.Logform.FormatWrap;
+//# sourceMappingURL=deep-splat.d.ts.map

package/dist/modules/logger/formatters/deep-splat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-splat.d.ts","sourceRoot":"","sources":["../../../../src/modules/logger/formatters/deep-splat.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,SAAS,CAAC;AAkD9B;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACrB,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC;CACtC,KAAG,MAiBH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS,4BASpB,CAAC"}