@venizia/ignis-inversion 0.1.1-0 → 0.1.1-1

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

@@ -1,7 +1,6 @@
 import type { TError, TErrorNormalized } from './types';
 export declare class ApplicationError extends Error {
     statusCode: number;
-    messageCode: string;
     normalized: TErrorNormalized;
     extra?: Record<string, unknown>;
     constructor(opts: TError);

package/dist/cjs/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":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAexD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEpB,IAAI,EAAE,MAAM;IAmCxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM;CAG7B;AAED,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,gBAEvC,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,gBAE5D,CAAC"}
+{"version":3,"file":"app-error.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/app-error.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAwC,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAe9F,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEpB,IAAI,EAAE,MAAM;IAmCxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM;CAG7B;AAED,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,gBAAmD,CAAC;AAE5F,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,gBAE5D,CAAC"}

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

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isApplicationError = exports.getError = exports.ApplicationError = void 0;
 const omit_1 = __importDefault(require("lodash/omit"));
 const message_code_1 = require("./message-code");
-/** Keys the constructor consumes. Everything else is context and rides into `extra`. */
+/** Consumed keys. Everything else rides into `extra`. */
 const KNOWN_KEYS = [
     'error',
     'message',
@@ -21,40 +21,34 @@ const KNOWN_KEYS = [
 class ApplicationError extends Error {
     constructor(opts) {
         const { statusCode, messageArgs, cause, extra, transform } = opts;
-        // The index signature makes `'error' in opts` useless for narrowing - every key exists on both
-        // members - so read the discriminant and cast.
+        // Index signature defeats `in` narrowing - read the discriminant and cast.
         const definition = ('error' in opts ? opts.error : undefined);
-        const message = opts.message ?? definition?.message ?? '';
-        const messageCode = definition?.key ?? opts.messageCode;
+        const input = opts.message;
+        const override = typeof input === 'string' ? { text: input } : input;
+        // `?.message?.` - the optional chain has to guard BOTH: `error` reaches here from an untyped
+        // call site as anything at all, and a bare `definition?.message.text` throws on a malformed one.
+        const message = override?.text ?? definition?.message?.text ?? '';
+        const messageCode = message_code_1.MessageCode.resolve(override?.code ?? definition?.message?.code ?? opts.messageCode);
+        const args = override?.args ?? messageArgs ?? definition?.message?.args;
         super(message, cause === undefined ? undefined : { cause });
         this.statusCode = statusCode ?? definition?.statusCode ?? 400;
-        this.messageCode = message_code_1.MessageCode.resolve(messageCode);
-        const args = messageArgs ?? definition?.messageArgs;
-        // Unknown keys sweep in first, then the `messageArgs` mirror, then explicit `extra` - so an
-        // explicit value wins over one that arrived by accident.
+        // Explicit `extra` wins over swept keys.
         const merged = {
             ...(0, omit_1.default)(opts, KNOWN_KEYS),
-            ...(args ? { messageArgs: args } : {}),
             ...extra,
         };
         this.extra = Object.keys(merged).length > 0 ? merged : undefined;
+        const normalized = { text: message, code: messageCode, args: args ?? {} };
         this.normalized = transform
-            ? transform({
-                message,
-                messageCode: this.messageCode,
-                statusCode: this.statusCode,
-                extra: this.extra,
-            })
-            : { text: message, code: this.messageCode, args: args ?? {} };
+            ? transform({ message: normalized, statusCode: this.statusCode, extra: this.extra })
+            : normalized;
     }
     static getError(opts) {
         return new ApplicationError(opts);
     }
 }
 exports.ApplicationError = ApplicationError;
-const getError = (opts) => {
-    return new ApplicationError(opts);
-};
+const getError = (opts) => ApplicationError.getError(opts);
 exports.getError = getError;
 const isApplicationError = (error) => {
     return error instanceof Error && typeof error.statusCode === 'number';

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

@@ -1 +1 @@
-{"version":3,"file":"app-error.js","sourceRoot":"","sources":["../../../../src/modules/error/app-error.ts"],"names":[],"mappings":";;;;;;AAAA,uDAA+B;AAE/B,iDAA6C;AAI7C,wFAAwF;AACxF,MAAM,UAAU,GAAG;IACjB,OAAO;IACP,SAAS;IACT,aAAa;IACb,YAAY;IACZ,aAAa;IACb,OAAO;IACP,OAAO;IACP,WAAW;IACX,MAAM;CACP,CAAC;AAEF,MAAa,gBAAiB,SAAQ,KAAK;IAMzC,YAAY,IAAY;QACtB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAElE,+FAA+F;QAC/F,+CAA+C;QAC/C,MAAM,UAAU,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAiC,CAAC;QAC9F,MAAM,OAAO,GAAI,IAAI,CAAC,OAA8B,IAAI,UAAU,EAAE,OAAO,IAAI,EAAE,CAAC;QAClF,MAAM,WAAW,GAAG,UAAU,EAAE,GAAG,IAAK,IAAI,CAAC,WAAkC,CAAC;QAEhF,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAE5D,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,UAAU,EAAE,UAAU,IAAI,GAAG,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,0BAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAEpD,MAAM,IAAI,GAAG,WAAW,IAAI,UAAU,EAAE,WAAW,CAAC;QAEpD,4FAA4F;QAC5F,yDAAyD;QACzD,MAAM,MAAM,GAAG;YACb,GAAG,IAAA,cAAI,EAAC,IAAI,EAAE,UAAU,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,GAAG,KAAK;SACT,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAEjE,IAAI,CAAC,UAAU,GAAG,SAAS;YACzB,CAAC,CAAC,SAAS,CAAC;gBACR,OAAO;gBACP,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;YACJ,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AA5CD,4CA4CC;AAEM,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAoB,EAAE;IACzD,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC;AAFW,QAAA,QAAQ,YAEnB;AAEK,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"}
+{"version":3,"file":"app-error.js","sourceRoot":"","sources":["../../../../src/modules/error/app-error.ts"],"names":[],"mappings":";;;;;;AAAA,uDAA+B;AAE/B,iDAA6C;AAG7C,yDAAyD;AACzD,MAAM,UAAU,GAAG;IACjB,OAAO;IACP,SAAS;IACT,aAAa;IACb,YAAY;IACZ,aAAa;IACb,OAAO;IACP,OAAO;IACP,WAAW;IACX,MAAM;CACP,CAAC;AAEF,MAAa,gBAAiB,SAAQ,KAAK;IAKzC,YAAY,IAAY;QACtB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAElE,2EAA2E;QAC3E,MAAM,UAAU,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAgC,CAAC;QAE7F,MAAM,KAAK,GAAG,IAAI,CAAC,OAA0D,CAAC;QAC9E,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAErE,6FAA6F;QAC7F,iGAAiG;QACjG,MAAM,OAAO,GAAG,QAAQ,EAAE,IAAI,IAAI,UAAU,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QAClE,MAAM,WAAW,GAAG,0BAAW,CAAC,OAAO,CACrC,QAAQ,EAAE,IAAI,IAAI,UAAU,EAAE,OAAO,EAAE,IAAI,IAAK,IAAI,CAAC,WAAiC,CACvF,CAAC;QACF,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,WAAW,IAAI,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;QAExE,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAE5D,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,UAAU,EAAE,UAAU,IAAI,GAAG,CAAC;QAE9D,yCAAyC;QACzC,MAAM,MAAM,GAAG;YACb,GAAG,IAAA,cAAI,EAAC,IAAI,EAAE,UAAU,CAAC;YACzB,GAAG,KAAK;SACT,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAEjE,MAAM,UAAU,GAAqB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QAE5F,IAAI,CAAC,UAAU,GAAG,SAAS;YACzB,CAAC,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YACpF,CAAC,CAAC,UAAU,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AA3CD,4CA2CC;AAEM,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAoB,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAA/E,QAAA,QAAQ,YAAuE;AAErF,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/cjs/modules/error/definition.d.ts

@@ -7,37 +7,4 @@ export declare class ErrorScopes {
     static readonly INTEGRATION = "integration";
 }
 export type TErrorScope = TConstValue<typeof ErrorScopes>;
-export type TErrorDefinition = {
-    /** Dot-notated i18n key, the machine-readable identity of this failure. */
-    key: string;
-    statusCode: number;
-    message: string;
-    messageArgs?: Record<string, unknown>;
-    category?: TErrorScope;
-    description?: string;
-};
-/**
- * Augmented per-package via declaration merging, driving `messageCode` autocomplete.
- *
- * When nothing augments it - the framework compiling on its own - {@link TErrorKey} falls back to
- * `string`, so a consumer that keeps no catalog is not forced to build one.
- */
-export interface IErrorKeyRegistry {
-}
-export type TErrorKey = [keyof IErrorKeyRegistry] extends [never] ? string : Extract<keyof IErrorKeyRegistry, string>;
-/**
- * Registers a catalog's keys with {@link IErrorKeyRegistry}:
- *
- * ```ts
- * declare module '@venizia/ignis-helpers' {
- *   interface IErrorKeyRegistry extends TRegisterErrors<typeof CategoryErrors> {}
- * }
- * ```
- *
- * The `extends Record<string, TErrorDefinition>` bound is load-bearing: without it TypeScript does
- * not know every value of `T` carries a `key`, and `T[keyof T]['key']` fails to compile. It costs
- * nothing in precision - `T` is still the type of an `as const` catalog, so the indexed access
- * yields the union of literal keys rather than `string`.
- */
-export type TRegisterErrors<T extends Record<string, TErrorDefinition>> = Record<T[keyof T]['key'], true>;
 //# sourceMappingURL=definition.d.ts.map

package/dist/cjs/modules/error/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;CAC7C;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC;AAE1D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;CAAG;AAErC,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,GAC7D,MAAM,GACN,OAAO,CAAC,MAAM,iBAAiB,EAAE,MAAM,CAAC,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAAI,MAAM,CAC9E,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EACjB,IAAI,CACL,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;CAC7C;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC"}

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

@@ -1,3 +1,4 @@
+import type { TNullable } from '../../common/types';
 export declare class MessageCode {
     static readonly SEPARATOR = ".";
     static readonly SEGMENT_PATTERN: RegExp;
@@ -10,9 +11,12 @@ export declare class MessageCode {
     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;
+    /**
+     * True when `code` is well-formed. A guard for a code arriving from outside, so it takes
+     * `unknown`: one that throws on the very input it exists to screen is not a guard.
+     */
+    static isValid(code: unknown): boolean;
+    /** Normalizes an absent, empty or non-string code to {@link DEFAULT}. */
+    static resolve(code?: TNullable<string>): string;
 }
 //# sourceMappingURL=message-code.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"message-code.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/message-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,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;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAatC,yEAAyE;IACzE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM;CAKjD"}

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

@@ -29,15 +29,23 @@ class MessageCode {
         }
         return parts.join(this.SEPARATOR).toLowerCase();
     }
-    /** True when `code` is well-formed. Cheap guard for a code that arrives from outside. */
+    /**
+     * True when `code` is well-formed. A guard for a code arriving from outside, so it takes
+     * `unknown`: one that throws on the very input it exists to screen is not a guard.
+     */
     static isValid(code) {
+        if (typeof code !== 'string') {
+            return false;
+        }
         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. */
+    /** Normalizes an absent, empty or non-string code to {@link DEFAULT}. */
     static resolve(code) {
-        return code?.length ? code.toLowerCase() : this.DEFAULT.toLowerCase();
+        return typeof code === 'string' && code.length
+            ? code.toLowerCase()
+            : this.DEFAULT.toLowerCase();
     }
 }
 exports.MessageCode = MessageCode;

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

@@ -1 +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"}
+{"version":3,"file":"message-code.js","sourceRoot":"","sources":["../../../../src/modules/error/message-code.ts"],"names":[],"mappings":";;;AACA,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;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAa;QAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,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,yEAAyE;IACzE,MAAM,CAAC,OAAO,CAAC,IAAwB;QACrC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM;YAC5C,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE;YACpB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC;;AAtDH,kCAuDC"}

package/dist/cjs/modules/error/types.d.ts

@@ -1,18 +1,49 @@
-import type { TErrorDefinition, TErrorKey } from './definition';
-/** The client-facing message: `translate(normalized.code, normalized.args)`. */
+import type { TErrorScope } from './definition';
+/**
+ * The RESOLVED message a client renders: `translate(code, args)`. Every field is always present -
+ * the constructor defaults `code` to {@link MessageCode.DEFAULT} and `args` to `{}` - so no consumer
+ * has to null-check what it reads.
+ */
 export type TErrorNormalized = {
     text: string;
     code: string;
     args: Record<string, unknown>;
 };
 /**
- * Builds {@link TErrorNormalized} in place of the default. Receives a flat snapshot, never the
- * half-built instance. Its `text` may differ from `message`: `message` is what the throw site
- * wrote, `text` is what a client shows.
+ * The message a CALLER supplies. Only `text` is required; the rest is what {@link TErrorNormalized}
+ * resolves. Every other message shape below is derived from this one.
  */
+export type TErrorMessageInput = {
+    text: string;
+    code?: TErrorKey | (string & Record<never, never>);
+    args?: Record<string, unknown>;
+};
+/**
+ * A catalogued message - a `code` is the whole reason the catalog exists, so it is required here.
+ *
+ * `code` is a plain `string`, NOT {@link TErrorKey}: a catalog DECLARES the keys the registry is
+ * built from, so typing it against that registry would make `IErrorKeyRegistry` define itself.
+ */
+export type TErrorDefinitionMessage = Omit<TErrorMessageInput, 'code'> & {
+    code: string;
+};
+/** The free-form input: a bare string is the historical shape. */
+export type TErrorMessage = string | TErrorMessageInput;
+/** The catalogued form's override - every field optional, since the definition supplies the rest. */
+export type TErrorMessageOverride = string | Partial<TErrorMessageInput>;
+export type TErrorDefinition = {
+    message: TErrorDefinitionMessage;
+    statusCode: number;
+    category?: TErrorScope;
+    description?: string;
+};
+/** Augmented per-package via declaration merging, driving `messageCode` autocomplete. */
+export interface IErrorKeyRegistry {
+}
+export type TErrorKey = [keyof IErrorKeyRegistry] extends [never] ? string : Extract<keyof IErrorKeyRegistry, string>;
+/** Builds {@link TErrorNormalized} in place of the default; `message` is the default it replaces. */
 export type TErrorNormalizeTransformFn = (opts: {
-    message: string;
-    messageCode: string;
+    message: TErrorNormalized;
     statusCode: number;
     extra?: Record<string, unknown>;
 }) => TErrorNormalized;
@@ -23,16 +54,17 @@ export type TErrorNormalizeTransformFn = (opts: {
 type TErrorCommon = {
     statusCode?: number;
     messageArgs?: Record<string, unknown>;
-    /** The wrapped failure. Reaches the native `Error.cause`. */
     cause?: unknown;
-    /** Explicit context. Merges with whatever the index signature swept in. */
     extra?: Record<string, unknown>;
     transform?: TErrorNormalizeTransformFn;
 };
-/** Catalogued form. `message` and `statusCode` override the definition's defaults. */
+/**
+ * Catalogued form. `message` and `statusCode` override the definition's defaults; the object form is
+ * partial, so `{ message: { args } }` amends the args and keeps the definition's text and code.
+ */
 export type TErrorByDefinition = TErrorCommon & {
     error: TErrorDefinition;
-    message?: string;
+    message?: TErrorMessageOverride;
     [key: string]: unknown;
 };
 /**
@@ -40,10 +72,26 @@ export type TErrorByDefinition = TErrorCommon & {
  * only required field - most throw sites legitimately fall back to `MessageCode.DEFAULT`.
  */
 export type TErrorByField = TErrorCommon & {
-    message: string;
+    message: TErrorMessage;
     messageCode?: TErrorKey | (string & Record<never, never>);
+    /**
+     * Never valid here - `error` is the catalogued form's discriminant. Without this the index
+     * signature accepts `{ message, error: caughtError }`, a natural way to write "wrap this", and
+     * `error` is a CONSUMED key: the wrapped failure would vanish. Use `cause`.
+     */
+    error?: never;
     [key: string]: unknown;
 };
 export type TError = TErrorByDefinition | TErrorByField;
+/**
+ * Registers a catalog's keys with {@link IErrorKeyRegistry}:
+ *
+ * ```ts
+ * declare module '@venizia/ignis-helpers' {
+ *   interface IErrorKeyRegistry extends TRegisterErrors<typeof CategoryErrors> {}
+ * }
+ * ```
+ */
+export type TRegisterErrors<T extends Record<string, TErrorDefinition>> = Record<T[keyof T]['message']['code'], true>;
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/cjs/modules/error/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEhE,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,KAAK,gBAAgB,CAAC;AAEvB;;;GAGG;AACH,KAAK,YAAY,GAAG;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,0BAA0B,CAAC;CACxC,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG;IAC9C,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/types.ts"],"names":[],"mappings":"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"}

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

@@ -1,7 +1,6 @@
 import type { TError, TErrorNormalized } from './types';
 export declare class ApplicationError extends Error {
     statusCode: number;
-    messageCode: string;
     normalized: TErrorNormalized;
     extra?: Record<string, unknown>;
     constructor(opts: TError);

package/dist/esm/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":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAexD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEpB,IAAI,EAAE,MAAM;IAmCxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM;CAG7B;AAED,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,gBAEvC,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,gBAE5D,CAAC"}
+{"version":3,"file":"app-error.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/app-error.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAwC,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAe9F,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEpB,IAAI,EAAE,MAAM;IAmCxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM;CAG7B;AAED,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,gBAAmD,CAAC;AAE5F,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,gBAE5D,CAAC"}

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

@@ -1,6 +1,6 @@
 import omit from 'lodash/omit';
 import { MessageCode } from './message-code';
-/** Keys the constructor consumes. Everything else is context and rides into `extra`. */
+/** Consumed keys. Everything else rides into `extra`. */
 const KNOWN_KEYS = [
     'error',
     'message',
@@ -15,39 +15,33 @@ const KNOWN_KEYS = [
 export class ApplicationError extends Error {
     constructor(opts) {
         const { statusCode, messageArgs, cause, extra, transform } = opts;
-        // The index signature makes `'error' in opts` useless for narrowing - every key exists on both
-        // members - so read the discriminant and cast.
+        // Index signature defeats `in` narrowing - read the discriminant and cast.
         const definition = ('error' in opts ? opts.error : undefined);
-        const message = opts.message ?? definition?.message ?? '';
-        const messageCode = definition?.key ?? opts.messageCode;
+        const input = opts.message;
+        const override = typeof input === 'string' ? { text: input } : input;
+        // `?.message?.` - the optional chain has to guard BOTH: `error` reaches here from an untyped
+        // call site as anything at all, and a bare `definition?.message.text` throws on a malformed one.
+        const message = override?.text ?? definition?.message?.text ?? '';
+        const messageCode = MessageCode.resolve(override?.code ?? definition?.message?.code ?? opts.messageCode);
+        const args = override?.args ?? messageArgs ?? definition?.message?.args;
         super(message, cause === undefined ? undefined : { cause });
         this.statusCode = statusCode ?? definition?.statusCode ?? 400;
-        this.messageCode = MessageCode.resolve(messageCode);
-        const args = messageArgs ?? definition?.messageArgs;
-        // Unknown keys sweep in first, then the `messageArgs` mirror, then explicit `extra` - so an
-        // explicit value wins over one that arrived by accident.
+        // Explicit `extra` wins over swept keys.
         const merged = {
             ...omit(opts, KNOWN_KEYS),
-            ...(args ? { messageArgs: args } : {}),
             ...extra,
         };
         this.extra = Object.keys(merged).length > 0 ? merged : undefined;
+        const normalized = { text: message, code: messageCode, args: args ?? {} };
         this.normalized = transform
-            ? transform({
-                message,
-                messageCode: this.messageCode,
-                statusCode: this.statusCode,
-                extra: this.extra,
-            })
-            : { text: message, code: this.messageCode, args: args ?? {} };
+            ? transform({ message: normalized, statusCode: this.statusCode, extra: this.extra })
+            : normalized;
     }
     static getError(opts) {
         return new ApplicationError(opts);
     }
 }
-export const getError = (opts) => {
-    return new ApplicationError(opts);
-};
+export const getError = (opts) => ApplicationError.getError(opts);
 export const isApplicationError = (error) => {
     return error instanceof Error && typeof error.statusCode === 'number';
 };

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

@@ -1 +1 @@
-{"version":3,"file":"app-error.js","sourceRoot":"","sources":["../../../../src/modules/error/app-error.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,aAAa,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAI7C,wFAAwF;AACxF,MAAM,UAAU,GAAG;IACjB,OAAO;IACP,SAAS;IACT,aAAa;IACb,YAAY;IACZ,aAAa;IACb,OAAO;IACP,OAAO;IACP,WAAW;IACX,MAAM;CACP,CAAC;AAEF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAMzC,YAAY,IAAY;QACtB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAElE,+FAA+F;QAC/F,+CAA+C;QAC/C,MAAM,UAAU,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAiC,CAAC;QAC9F,MAAM,OAAO,GAAI,IAAI,CAAC,OAA8B,IAAI,UAAU,EAAE,OAAO,IAAI,EAAE,CAAC;QAClF,MAAM,WAAW,GAAG,UAAU,EAAE,GAAG,IAAK,IAAI,CAAC,WAAkC,CAAC;QAEhF,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAE5D,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,UAAU,EAAE,UAAU,IAAI,GAAG,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAEpD,MAAM,IAAI,GAAG,WAAW,IAAI,UAAU,EAAE,WAAW,CAAC;QAEpD,4FAA4F;QAC5F,yDAAyD;QACzD,MAAM,MAAM,GAAG;YACb,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,GAAG,KAAK;SACT,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAEjE,IAAI,CAAC,UAAU,GAAG,SAAS;YACzB,CAAC,CAAC,SAAS,CAAC;gBACR,OAAO;gBACP,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;YACJ,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAoB,EAAE;IACzD,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAA6B,EAAE;IAC9E,OAAO,KAAK,YAAY,KAAK,IAAI,OAAQ,KAAiB,CAAC,UAAU,KAAK,QAAQ,CAAC;AACrF,CAAC,CAAC"}
+{"version":3,"file":"app-error.js","sourceRoot":"","sources":["../../../../src/modules/error/app-error.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,aAAa,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,yDAAyD;AACzD,MAAM,UAAU,GAAG;IACjB,OAAO;IACP,SAAS;IACT,aAAa;IACb,YAAY;IACZ,aAAa;IACb,OAAO;IACP,OAAO;IACP,WAAW;IACX,MAAM;CACP,CAAC;AAEF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAKzC,YAAY,IAAY;QACtB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAElE,2EAA2E;QAC3E,MAAM,UAAU,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAgC,CAAC;QAE7F,MAAM,KAAK,GAAG,IAAI,CAAC,OAA0D,CAAC;QAC9E,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAErE,6FAA6F;QAC7F,iGAAiG;QACjG,MAAM,OAAO,GAAG,QAAQ,EAAE,IAAI,IAAI,UAAU,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QAClE,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,CACrC,QAAQ,EAAE,IAAI,IAAI,UAAU,EAAE,OAAO,EAAE,IAAI,IAAK,IAAI,CAAC,WAAiC,CACvF,CAAC;QACF,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,WAAW,IAAI,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;QAExE,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAE5D,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,UAAU,EAAE,UAAU,IAAI,GAAG,CAAC;QAE9D,yCAAyC;QACzC,MAAM,MAAM,GAAG;YACb,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;YACzB,GAAG,KAAK;SACT,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAEjE,MAAM,UAAU,GAAqB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QAE5F,IAAI,CAAC,UAAU,GAAG,SAAS;YACzB,CAAC,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YACpF,CAAC,CAAC,UAAU,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAoB,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAE5F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAA6B,EAAE;IAC9E,OAAO,KAAK,YAAY,KAAK,IAAI,OAAQ,KAAiB,CAAC,UAAU,KAAK,QAAQ,CAAC;AACrF,CAAC,CAAC"}

package/dist/esm/modules/error/definition.d.ts

@@ -7,37 +7,4 @@ export declare class ErrorScopes {
     static readonly INTEGRATION = "integration";
 }
 export type TErrorScope = TConstValue<typeof ErrorScopes>;
-export type TErrorDefinition = {
-    /** Dot-notated i18n key, the machine-readable identity of this failure. */
-    key: string;
-    statusCode: number;
-    message: string;
-    messageArgs?: Record<string, unknown>;
-    category?: TErrorScope;
-    description?: string;
-};
-/**
- * Augmented per-package via declaration merging, driving `messageCode` autocomplete.
- *
- * When nothing augments it - the framework compiling on its own - {@link TErrorKey} falls back to
- * `string`, so a consumer that keeps no catalog is not forced to build one.
- */
-export interface IErrorKeyRegistry {
-}
-export type TErrorKey = [keyof IErrorKeyRegistry] extends [never] ? string : Extract<keyof IErrorKeyRegistry, string>;
-/**
- * Registers a catalog's keys with {@link IErrorKeyRegistry}:
- *
- * ```ts
- * declare module '@venizia/ignis-helpers' {
- *   interface IErrorKeyRegistry extends TRegisterErrors<typeof CategoryErrors> {}
- * }
- * ```
- *
- * The `extends Record<string, TErrorDefinition>` bound is load-bearing: without it TypeScript does
- * not know every value of `T` carries a `key`, and `T[keyof T]['key']` fails to compile. It costs
- * nothing in precision - `T` is still the type of an `as const` catalog, so the indexed access
- * yields the union of literal keys rather than `string`.
- */
-export type TRegisterErrors<T extends Record<string, TErrorDefinition>> = Record<T[keyof T]['key'], true>;
 //# sourceMappingURL=definition.d.ts.map

package/dist/esm/modules/error/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;CAC7C;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC;AAE1D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;CAAG;AAErC,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,GAC7D,MAAM,GACN,OAAO,CAAC,MAAM,iBAAiB,EAAE,MAAM,CAAC,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAAI,MAAM,CAC9E,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EACjB,IAAI,CACL,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;CAC7C;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC"}

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

@@ -1,3 +1,4 @@
+import type { TNullable } from '../../common/types';
 export declare class MessageCode {
     static readonly SEPARATOR = ".";
     static readonly SEGMENT_PATTERN: RegExp;
@@ -10,9 +11,12 @@ export declare class MessageCode {
     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;
+    /**
+     * True when `code` is well-formed. A guard for a code arriving from outside, so it takes
+     * `unknown`: one that throws on the very input it exists to screen is not a guard.
+     */
+    static isValid(code: unknown): boolean;
+    /** Normalizes an absent, empty or non-string code to {@link DEFAULT}. */
+    static resolve(code?: TNullable<string>): string;
 }
 //# sourceMappingURL=message-code.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"message-code.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/message-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,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;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAatC,yEAAyE;IACzE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM;CAKjD"}

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

@@ -26,15 +26,23 @@ export class MessageCode {
         }
         return parts.join(this.SEPARATOR).toLowerCase();
     }
-    /** True when `code` is well-formed. Cheap guard for a code that arrives from outside. */
+    /**
+     * True when `code` is well-formed. A guard for a code arriving from outside, so it takes
+     * `unknown`: one that throws on the very input it exists to screen is not a guard.
+     */
     static isValid(code) {
+        if (typeof code !== 'string') {
+            return false;
+        }
         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. */
+    /** Normalizes an absent, empty or non-string code to {@link DEFAULT}. */
     static resolve(code) {
-        return code?.length ? code.toLowerCase() : this.DEFAULT.toLowerCase();
+        return typeof code === 'string' && code.length
+            ? code.toLowerCase()
+            : this.DEFAULT.toLowerCase();
     }
 }
 //# sourceMappingURL=message-code.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"message-code.js","sourceRoot":"","sources":["../../../../src/modules/error/message-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,OAAO,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,QAAQ,CAAC;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,QAAQ,CAAC;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"}
+{"version":3,"file":"message-code.js","sourceRoot":"","sources":["../../../../src/modules/error/message-code.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,OAAO,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,QAAQ,CAAC;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,QAAQ,CAAC;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;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAa;QAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,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,yEAAyE;IACzE,MAAM,CAAC,OAAO,CAAC,IAAwB;QACrC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM;YAC5C,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE;YACpB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC"}

package/dist/esm/modules/error/types.d.ts

@@ -1,18 +1,49 @@
-import type { TErrorDefinition, TErrorKey } from './definition';
-/** The client-facing message: `translate(normalized.code, normalized.args)`. */
+import type { TErrorScope } from './definition';
+/**
+ * The RESOLVED message a client renders: `translate(code, args)`. Every field is always present -
+ * the constructor defaults `code` to {@link MessageCode.DEFAULT} and `args` to `{}` - so no consumer
+ * has to null-check what it reads.
+ */
 export type TErrorNormalized = {
     text: string;
     code: string;
     args: Record<string, unknown>;
 };
 /**
- * Builds {@link TErrorNormalized} in place of the default. Receives a flat snapshot, never the
- * half-built instance. Its `text` may differ from `message`: `message` is what the throw site
- * wrote, `text` is what a client shows.
+ * The message a CALLER supplies. Only `text` is required; the rest is what {@link TErrorNormalized}
+ * resolves. Every other message shape below is derived from this one.
  */
+export type TErrorMessageInput = {
+    text: string;
+    code?: TErrorKey | (string & Record<never, never>);
+    args?: Record<string, unknown>;
+};
+/**
+ * A catalogued message - a `code` is the whole reason the catalog exists, so it is required here.
+ *
+ * `code` is a plain `string`, NOT {@link TErrorKey}: a catalog DECLARES the keys the registry is
+ * built from, so typing it against that registry would make `IErrorKeyRegistry` define itself.
+ */
+export type TErrorDefinitionMessage = Omit<TErrorMessageInput, 'code'> & {
+    code: string;
+};
+/** The free-form input: a bare string is the historical shape. */
+export type TErrorMessage = string | TErrorMessageInput;
+/** The catalogued form's override - every field optional, since the definition supplies the rest. */
+export type TErrorMessageOverride = string | Partial<TErrorMessageInput>;
+export type TErrorDefinition = {
+    message: TErrorDefinitionMessage;
+    statusCode: number;
+    category?: TErrorScope;
+    description?: string;
+};
+/** Augmented per-package via declaration merging, driving `messageCode` autocomplete. */
+export interface IErrorKeyRegistry {
+}
+export type TErrorKey = [keyof IErrorKeyRegistry] extends [never] ? string : Extract<keyof IErrorKeyRegistry, string>;
+/** Builds {@link TErrorNormalized} in place of the default; `message` is the default it replaces. */
 export type TErrorNormalizeTransformFn = (opts: {
-    message: string;
-    messageCode: string;
+    message: TErrorNormalized;
     statusCode: number;
     extra?: Record<string, unknown>;
 }) => TErrorNormalized;
@@ -23,16 +54,17 @@ export type TErrorNormalizeTransformFn = (opts: {
 type TErrorCommon = {
     statusCode?: number;
     messageArgs?: Record<string, unknown>;
-    /** The wrapped failure. Reaches the native `Error.cause`. */
     cause?: unknown;
-    /** Explicit context. Merges with whatever the index signature swept in. */
     extra?: Record<string, unknown>;
     transform?: TErrorNormalizeTransformFn;
 };
-/** Catalogued form. `message` and `statusCode` override the definition's defaults. */
+/**
+ * Catalogued form. `message` and `statusCode` override the definition's defaults; the object form is
+ * partial, so `{ message: { args } }` amends the args and keeps the definition's text and code.
+ */
 export type TErrorByDefinition = TErrorCommon & {
     error: TErrorDefinition;
-    message?: string;
+    message?: TErrorMessageOverride;
     [key: string]: unknown;
 };
 /**
@@ -40,10 +72,26 @@ export type TErrorByDefinition = TErrorCommon & {
  * only required field - most throw sites legitimately fall back to `MessageCode.DEFAULT`.
  */
 export type TErrorByField = TErrorCommon & {
-    message: string;
+    message: TErrorMessage;
     messageCode?: TErrorKey | (string & Record<never, never>);
+    /**
+     * Never valid here - `error` is the catalogued form's discriminant. Without this the index
+     * signature accepts `{ message, error: caughtError }`, a natural way to write "wrap this", and
+     * `error` is a CONSUMED key: the wrapped failure would vanish. Use `cause`.
+     */
+    error?: never;
     [key: string]: unknown;
 };
 export type TError = TErrorByDefinition | TErrorByField;
+/**
+ * Registers a catalog's keys with {@link IErrorKeyRegistry}:
+ *
+ * ```ts
+ * declare module '@venizia/ignis-helpers' {
+ *   interface IErrorKeyRegistry extends TRegisterErrors<typeof CategoryErrors> {}
+ * }
+ * ```
+ */
+export type TRegisterErrors<T extends Record<string, TErrorDefinition>> = Record<T[keyof T]['message']['code'], true>;
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/esm/modules/error/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEhE,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,KAAK,gBAAgB,CAAC;AAEvB;;;GAGG;AACH,KAAK,YAAY,GAAG;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,0BAA0B,CAAC;CACxC,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG;IAC9C,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis-inversion",
-  "version": "0.1.1-0",
+  "version": "0.1.1-1",
   "description": "Lightweight, high-performance Dependency Injection and Inversion of Control container for TypeScript (~350 lines). Features decorator-based constructor and property injection, fluent Binding API, singleton/transient scoping, namespace auto-tagging, Provider pattern, tag-based discovery, and reflect-metadata integration. Inspired by LoopBack 4 and InversifyJS but simpler. Zero framework lock-in — works standalone or with Ignis.",
   "keywords": [
     "architecture",