@eleva-io/erp-sdk 0.1.147 → 0.1.149

package/dist/cjs/errors/catalog.d.ts

@@ -1,5 +1,7 @@
-import { API_ERROR_CODES, APIErrorDetails } from './catalog_api';
-import { BASE_ERROR_CODES, BaseErrorDetails } from './catalog_base';
+import { API_ERROR_CODES } from './catalog_api';
+import { BASE_ERROR_CODES } from './catalog_base';
+import { CatalogDetails } from './catalog_types';
+/** All valid error code constants (base + API). Use with `error.is()` and factory methods. */
 export declare const ERROR_CODES: {
     FORBIDDEN_CONTACT: API_ERROR_CODES.FORBIDDEN_CONTACT;
     VALIDATION: BASE_ERROR_CODES.VALIDATION;
@@ -13,10 +15,21 @@ export declare const ERROR_CODES: {
     UNPROCESSABLE_ENTITY: BASE_ERROR_CODES.UNPROCESSABLE_ENTITY;
     MANDATORY_FIELD: BASE_ERROR_CODES.MANDATORY_FIELD;
     INTERNAL_SERVER_ERROR: BASE_ERROR_CODES.INTERNAL_SERVER_ERROR;
+    BAD_GATEWAY: BASE_ERROR_CODES.BAD_GATEWAY;
     SERVICE_UNAVAILABLE: BASE_ERROR_CODES.SERVICE_UNAVAILABLE;
 };
+/** Union of all valid error code strings. Derived from `ERROR_CODES` to stay in sync. */
 export type ErrorCode = keyof typeof ERROR_CODES;
-export type ErrorDetails<C extends ErrorCode> = BaseErrorDetails<C extends BASE_ERROR_CODES ? C : never> | APIErrorDetails<C extends API_ERROR_CODES ? C : never>;
+/**
+ * Strongly-typed `details` payload for a given error code `C`, resolved directly
+ * from `ERRORS_CATALOG`. Adding a new catalog only requires updating `ERRORS_CATALOG`.
+ *
+ * @example
+ * type ValidationDetails = ErrorDetails<'VALIDATION'>
+ * // → { errors: Array<{ validation: string; code: string; message: string; path: string[] }> }
+ */
+export type ErrorDetails<C extends ErrorCode> = CatalogDetails<C, typeof ERRORS_CATALOG>;
+/** Merged catalog of all error codes. Single runtime lookup table for `ElevaError` construction. */
 export declare const ERRORS_CATALOG: {
     FORBIDDEN_CONTACT: {
         kind: import("./catalog_types").ErrorKind.DOMAIN;
@@ -202,6 +215,18 @@ export declare const ERRORS_CATALOG: {
         }>;
         message: string;
     };
+    BAD_GATEWAY: {
+        kind: import("./catalog_types").ErrorKind.SYSTEM;
+        status: number;
+        details: import("zod").ZodObject<{
+            upstream: import("zod").ZodOptional<import("zod").ZodString>;
+        }, "strip", import("zod").ZodTypeAny, {
+            upstream?: string | undefined;
+        }, {
+            upstream?: string | undefined;
+        }>;
+        message: string;
+    };
     SERVICE_UNAVAILABLE: {
         kind: import("./catalog_types").ErrorKind.SYSTEM;
         status: number;

package/dist/cjs/errors/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/errors/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAsB,eAAe,EAAE,MAAM,eAAe,CAAA;AACpF,OAAO,EAAE,gBAAgB,EAAuB,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAGxF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;CAGvB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,WAAW,CAAA;AAEhD,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,IACxC,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,GAAG,CAAC,GAAG,KAAK,CAAC,GACxD,eAAe,CAAC,CAAC,SAAS,eAAe,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;AAE1D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGqB,CAAA"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/errors/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAsB,MAAM,eAAe,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAuB,MAAM,gBAAgB,CAAA;AACtE,OAAO,EAAE,cAAc,EAAqB,MAAM,iBAAiB,CAAA;AAEnE,8FAA8F;AAC9F,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;CAGvB,CAAA;AAED,yFAAyF;AACzF,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,WAAW,CAAA;AAEhD;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,IAAI,cAAc,CAAC,CAAC,EAAE,OAAO,cAAc,CAAC,CAAA;AAExF,oGAAoG;AACpG,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGqB,CAAA"}

package/dist/cjs/errors/catalog.js

@@ -3,10 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ERRORS_CATALOG = exports.ERROR_CODES = void 0;
 const catalog_api_1 = require("./catalog_api");
 const catalog_base_1 = require("./catalog_base");
+/** All valid error code constants (base + API). Use with `error.is()` and factory methods. */
 exports.ERROR_CODES = {
     ...catalog_base_1.BASE_ERROR_CODES,
     ...catalog_api_1.API_ERROR_CODES,
 };
+/** Merged catalog of all error codes. Single runtime lookup table for `ElevaError` construction. */
 exports.ERRORS_CATALOG = {
     ...catalog_base_1.BASE_ERRORS_CATALOG,
     ...catalog_api_1.API_ERRORS_CATALOG,

package/dist/cjs/errors/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/errors/catalog.ts"],"names":[],"mappings":";;;AAAA,+CAAoF;AACpF,iDAAwF;AAG3E,QAAA,WAAW,GAAG;IACzB,GAAG,+BAAgB;IACnB,GAAG,6BAAe;CACnB,CAAA;AAQY,QAAA,cAAc,GAAG;IAC5B,GAAG,kCAAmB;IACtB,GAAG,gCAAkB;CACyB,CAAA"}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/errors/catalog.ts"],"names":[],"mappings":";;;AAAA,+CAAmE;AACnE,iDAAsE;AAGtE,8FAA8F;AACjF,QAAA,WAAW,GAAG;IACzB,GAAG,+BAAgB;IACnB,GAAG,6BAAe;CACnB,CAAA;AAeD,oGAAoG;AACvF,QAAA,cAAc,GAAG;IAC5B,GAAG,kCAAmB;IACtB,GAAG,gCAAkB;CACyB,CAAA"}

package/dist/cjs/errors/catalog_api.d.ts

@@ -1,13 +1,20 @@
 import { z } from 'zod';
-import { ErrorKind } from './catalog_types';
+import { CatalogDetails, ErrorKind } from './catalog_types';
+/**
+ * ERP domain-specific error codes. Add here any code that does not fit
+ * the generic HTTP categories in `BASE_ERROR_CODES`.
+ */
 export declare enum API_ERROR_CODES {
+    /** Access denied to a specific contact person (provides `contactId` in details). */
     FORBIDDEN_CONTACT = "FORBIDDEN_CONTACT"
 }
+/** Maps every `API_ERROR_CODES` member to its catalog entry. */
 export declare const API_ERRORS_CATALOG: {
     FORBIDDEN_CONTACT: {
         kind: ErrorKind.DOMAIN;
         status: number;
         details: z.ZodObject<{
+            /** UUID of the contact person the caller was denied access to. */
             contactId: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             contactId: string;
@@ -17,5 +24,11 @@ export declare const API_ERRORS_CATALOG: {
         message: string;
     };
 };
-export type APIErrorDetails<C extends API_ERROR_CODES> = z.infer<(typeof API_ERRORS_CATALOG)[C]['details']>;
+/**
+ * Strongly-typed `details` shape for a given `API_ERROR_CODES` member.
+ * @example
+ * type ForbiddenContactDetails = APIErrorDetails<API_ERROR_CODES.FORBIDDEN_CONTACT>
+ * // → { contactId: string }
+ */
+export type APIErrorDetails<C extends API_ERROR_CODES> = CatalogDetails<C, typeof API_ERRORS_CATALOG>;
 //# sourceMappingURL=catalog_api.d.ts.map

package/dist/cjs/errors/catalog_api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog_api.d.ts","sourceRoot":"","sources":["../../../src/errors/catalog_api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqB,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE9D,oBAAY,eAAe;IACzB,iBAAiB,sBAAsB;CACxC;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;CAOuB,CAAA;AAEtD,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA"}
+{"version":3,"file":"catalog_api.d.ts","sourceRoot":"","sources":["../../../src/errors/catalog_api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,cAAc,EAAqB,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE9E;;;GAGG;AACH,oBAAY,eAAe;IACzB,oFAAoF;IACpF,iBAAiB,sBAAsB;CACxC;AAED,gEAAgE;AAChE,eAAO,MAAM,kBAAkB;;;;;YAKzB,kEAAkE;;;;;;;;;CAKlB,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,eAAe,IAAI,cAAc,CAAC,CAAC,EAAE,OAAO,kBAAkB,CAAC,CAAA"}

package/dist/cjs/errors/catalog_api.js

@@ -3,15 +3,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.API_ERRORS_CATALOG = exports.API_ERROR_CODES = void 0;
 const zod_1 = require("zod");
 const catalog_types_1 = require("./catalog_types");
+/**
+ * ERP domain-specific error codes. Add here any code that does not fit
+ * the generic HTTP categories in `BASE_ERROR_CODES`.
+ */
 var API_ERROR_CODES;
 (function (API_ERROR_CODES) {
+    /** Access denied to a specific contact person (provides `contactId` in details). */
     API_ERROR_CODES["FORBIDDEN_CONTACT"] = "FORBIDDEN_CONTACT";
 })(API_ERROR_CODES || (exports.API_ERROR_CODES = API_ERROR_CODES = {}));
+/** Maps every `API_ERROR_CODES` member to its catalog entry. */
 exports.API_ERRORS_CATALOG = {
     [API_ERROR_CODES.FORBIDDEN_CONTACT]: {
         kind: catalog_types_1.ErrorKind.DOMAIN,
         status: 403,
-        details: zod_1.z.object({ contactId: zod_1.z.string() }),
+        details: zod_1.z.object({
+            /** UUID of the contact person the caller was denied access to. */
+            contactId: zod_1.z.string(),
+        }),
         message: 'You are not authorized to access this contact person',
     },
 };

package/dist/cjs/errors/catalog_api.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog_api.js","sourceRoot":"","sources":["../../../src/errors/catalog_api.ts"],"names":[],"mappings":";;;AAAA,6BAAuB;AACvB,mDAA8D;AAE9D,IAAY,eAEX;AAFD,WAAY,eAAe;IACzB,0DAAuC,CAAA;AACzC,CAAC,EAFW,eAAe,+BAAf,eAAe,QAE1B;AAEY,QAAA,kBAAkB,GAAG;IAChC,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE;QACnC,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5C,OAAO,EAAE,sDAAsD;KAChE;CACmD,CAAA"}
+{"version":3,"file":"catalog_api.js","sourceRoot":"","sources":["../../../src/errors/catalog_api.ts"],"names":[],"mappings":";;;AAAA,6BAAuB;AACvB,mDAA8E;AAE9E;;;GAGG;AACH,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,oFAAoF;IACpF,0DAAuC,CAAA;AACzC,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B;AAED,gEAAgE;AACnD,QAAA,kBAAkB,GAAG;IAChC,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE;QACnC,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YAChB,kEAAkE;YAClE,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;SACtB,CAAC;QACF,OAAO,EAAE,sDAAsD;KAChE;CACmD,CAAA"}

package/dist/cjs/errors/catalog_base.d.ts

@@ -1,26 +1,47 @@
 import { z } from 'zod';
-import { ErrorKind } from './catalog_types';
+import { CatalogDetails, ErrorKind } from './catalog_types';
+/**
+ * Generic HTTP-level error codes shared across all API domains.
+ * Domain-specific codes live in `catalog_api.ts`.
+ */
 export declare enum BASE_ERROR_CODES {
+    /** Input data failed schema or business-rule validation. */
     VALIDATION = "VALIDATION",
+    /** The request is malformed or contains invalid parameters. */
     BAD_REQUEST = "BAD_REQUEST",
+    /** Credentials are missing, expired, or invalid. */
     AUTHENTICATION = "AUTHENTICATION",
+    /** Authenticated but lacks the required permissions. */
     UNAUTHORIZED = "UNAUTHORIZED",
+    /** The requested resource does not exist. */
     NOT_FOUND = "NOT_FOUND",
+    /** Server cannot produce a response matching the `Accept` header. */
     NOT_ACCEPTABLE = "NOT_ACCEPTABLE",
+    /** Operation would violate a uniqueness or integrity constraint. */
     CONFLICT = "CONFLICT",
+    /** Resource existed but has been permanently removed (unlike 404, retrying is futile). */
     GONE = "GONE",
+    /** Request is syntactically valid but semantically unprocessable (e.g. invalid state transition). */
     UNPROCESSABLE_ENTITY = "UNPROCESSABLE_ENTITY",
+    /** A required field was omitted from the request. */
     MANDATORY_FIELD = "MANDATORY_FIELD",
+    /** Unexpected server-side error (`SYSTEM` — message sanitised before being sent to clients). */
     INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR",
+    /** Upstream gateway received an invalid response from the origin server (`SYSTEM`). */
+    BAD_GATEWAY = "BAD_GATEWAY",
+    /** Service is temporarily unavailable (`SYSTEM`). */
     SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE"
 }
+/** Maps every `BASE_ERROR_CODES` member to its HTTP status, kind, default message, and details schema. */
 export declare const BASE_ERRORS_CATALOG: {
     VALIDATION: {
         kind: ErrorKind.DOMAIN;
         status: number;
         details: z.ZodObject<{
             errors: z.ZodArray<z.ZodObject<{
+                /** Dot-separated field path (e.g. `"address.zipCode"`) or `"root"` for top-level issues. */
                 validation: z.ZodString;
+                /** Zod issue code (e.g. `"invalid_type"`, `"too_small"`). */
                 code: z.ZodString;
                 message: z.ZodString;
                 path: z.ZodArray<z.ZodString, "many">;
@@ -118,6 +139,7 @@ export declare const BASE_ERRORS_CATALOG: {
         }>;
         message: string;
     };
+    /** Each item in the array identifies one conflicting field. */
     CONFLICT: {
         kind: ErrorKind.DOMAIN;
         status: number;
@@ -187,6 +209,18 @@ export declare const BASE_ERRORS_CATALOG: {
         }>;
         message: string;
     };
+    BAD_GATEWAY: {
+        kind: ErrorKind.SYSTEM;
+        status: number;
+        details: z.ZodObject<{
+            upstream: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            upstream?: string | undefined;
+        }, {
+            upstream?: string | undefined;
+        }>;
+        message: string;
+    };
     SERVICE_UNAVAILABLE: {
         kind: ErrorKind.SYSTEM;
         status: number;
@@ -200,5 +234,11 @@ export declare const BASE_ERRORS_CATALOG: {
         message: string;
     };
 };
-export type BaseErrorDetails<C extends BASE_ERROR_CODES> = z.infer<(typeof BASE_ERRORS_CATALOG)[C]['details']>;
+/**
+ * Strongly-typed `details` shape for a given `BASE_ERROR_CODES` member.
+ * @example
+ * type ConflictDetails = BaseErrorDetails<BASE_ERROR_CODES.CONFLICT>
+ * // → Array<{ key: string; value: string; cause: string }>
+ */
+export type BaseErrorDetails<C extends BASE_ERROR_CODES> = CatalogDetails<C, typeof BASE_ERRORS_CATALOG>;
 //# sourceMappingURL=catalog_base.d.ts.map

package/dist/cjs/errors/catalog_base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog_base.d.ts","sourceRoot":"","sources":["../../../src/errors/catalog_base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqB,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE9D,oBAAY,gBAAgB;IAE1B,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;IAC7B,SAAS,cAAc;IACvB,cAAc,mBAAmB;IACjC,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,oBAAoB,yBAAyB;IAC7C,eAAe,oBAAoB;IAGnC,qBAAqB,0BAA0B;IAC/C,mBAAmB,wBAAwB;CAC5C;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkIuB,CAAA;AAEvD,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA"}
+{"version":3,"file":"catalog_base.d.ts","sourceRoot":"","sources":["../../../src/errors/catalog_base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,cAAc,EAAqB,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE9E;;;GAGG;AACH,oBAAY,gBAAgB;IAE1B,4DAA4D;IAC5D,UAAU,eAAe;IACzB,+DAA+D;IAC/D,WAAW,gBAAgB;IAC3B,oDAAoD;IACpD,cAAc,mBAAmB;IACjC,wDAAwD;IACxD,YAAY,iBAAiB;IAC7B,6CAA6C;IAC7C,SAAS,cAAc;IACvB,qEAAqE;IACrE,cAAc,mBAAmB;IACjC,oEAAoE;IACpE,QAAQ,aAAa;IACrB,0FAA0F;IAC1F,IAAI,SAAS;IACb,qGAAqG;IACrG,oBAAoB,yBAAyB;IAC7C,qDAAqD;IACrD,eAAe,oBAAoB;IAGnC,gGAAgG;IAChG,qBAAqB,0BAA0B;IAC/C,uFAAuF;IACvF,WAAW,gBAAgB;IAC3B,qDAAqD;IACrD,mBAAmB,wBAAwB;CAC5C;AAED,0GAA0G;AAC1G,eAAO,MAAM,mBAAmB;;;;;;gBAStB,4FAA4F;;gBAE5F,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqErE,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFV,CAAA;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,IAAI,cAAc,CAAC,CAAC,EAAE,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/cjs/errors/catalog_base.js

@@ -3,23 +3,42 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BASE_ERRORS_CATALOG = exports.BASE_ERROR_CODES = void 0;
 const zod_1 = require("zod");
 const catalog_types_1 = require("./catalog_types");
+/**
+ * Generic HTTP-level error codes shared across all API domains.
+ * Domain-specific codes live in `catalog_api.ts`.
+ */
 var BASE_ERROR_CODES;
 (function (BASE_ERROR_CODES) {
     // >= 400
+    /** Input data failed schema or business-rule validation. */
     BASE_ERROR_CODES["VALIDATION"] = "VALIDATION";
+    /** The request is malformed or contains invalid parameters. */
     BASE_ERROR_CODES["BAD_REQUEST"] = "BAD_REQUEST";
+    /** Credentials are missing, expired, or invalid. */
     BASE_ERROR_CODES["AUTHENTICATION"] = "AUTHENTICATION";
+    /** Authenticated but lacks the required permissions. */
     BASE_ERROR_CODES["UNAUTHORIZED"] = "UNAUTHORIZED";
+    /** The requested resource does not exist. */
     BASE_ERROR_CODES["NOT_FOUND"] = "NOT_FOUND";
+    /** Server cannot produce a response matching the `Accept` header. */
     BASE_ERROR_CODES["NOT_ACCEPTABLE"] = "NOT_ACCEPTABLE";
+    /** Operation would violate a uniqueness or integrity constraint. */
     BASE_ERROR_CODES["CONFLICT"] = "CONFLICT";
+    /** Resource existed but has been permanently removed (unlike 404, retrying is futile). */
     BASE_ERROR_CODES["GONE"] = "GONE";
+    /** Request is syntactically valid but semantically unprocessable (e.g. invalid state transition). */
     BASE_ERROR_CODES["UNPROCESSABLE_ENTITY"] = "UNPROCESSABLE_ENTITY";
+    /** A required field was omitted from the request. */
     BASE_ERROR_CODES["MANDATORY_FIELD"] = "MANDATORY_FIELD";
     // >= 500
+    /** Unexpected server-side error (`SYSTEM` — message sanitised before being sent to clients). */
     BASE_ERROR_CODES["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
+    /** Upstream gateway received an invalid response from the origin server (`SYSTEM`). */
+    BASE_ERROR_CODES["BAD_GATEWAY"] = "BAD_GATEWAY";
+    /** Service is temporarily unavailable (`SYSTEM`). */
     BASE_ERROR_CODES["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
 })(BASE_ERROR_CODES || (exports.BASE_ERROR_CODES = BASE_ERROR_CODES = {}));
+/** Maps every `BASE_ERROR_CODES` member to its HTTP status, kind, default message, and details schema. */
 exports.BASE_ERRORS_CATALOG = {
     // >= 400
     [BASE_ERROR_CODES.VALIDATION]: {
@@ -28,7 +47,9 @@ exports.BASE_ERRORS_CATALOG = {
         details: zod_1.z.object({
             errors: zod_1.z
                 .object({
+                /** Dot-separated field path (e.g. `"address.zipCode"`) or `"root"` for top-level issues. */
                 validation: zod_1.z.string(),
+                /** Zod issue code (e.g. `"invalid_type"`, `"too_small"`). */
                 code: zod_1.z.string(),
                 message: zod_1.z.string(),
                 path: zod_1.z.array(zod_1.z.string()),
@@ -53,6 +74,7 @@ exports.BASE_ERRORS_CATALOG = {
         status: 401,
         details: zod_1.z
             .object({
+            /** Why authentication failed (e.g. `"token_expired"`). */
             reason: zod_1.z.string(),
         })
             .partial(),
@@ -74,6 +96,7 @@ exports.BASE_ERRORS_CATALOG = {
         status: 404,
         details: zod_1.z
             .object({
+            /** Entity type that was not found (e.g. `"Invoice"`). */
             entity: zod_1.z.string(),
         })
             .partial(),
@@ -89,6 +112,7 @@ exports.BASE_ERRORS_CATALOG = {
             .partial(),
         message: 'Not acceptable',
     },
+    /** Each item in the array identifies one conflicting field. */
     [BASE_ERROR_CODES.CONFLICT]: {
         kind: catalog_types_1.ErrorKind.DOMAIN,
         status: 409,
@@ -106,6 +130,7 @@ exports.BASE_ERRORS_CATALOG = {
         status: 410,
         details: zod_1.z
             .object({
+            /** ISO 8601 timestamp of when the resource was removed. */
             since: zod_1.z.string(),
         })
             .partial(),
@@ -139,11 +164,23 @@ exports.BASE_ERRORS_CATALOG = {
             .partial(),
         message: 'Internal server error',
     },
+    [BASE_ERROR_CODES.BAD_GATEWAY]: {
+        kind: catalog_types_1.ErrorKind.SYSTEM,
+        status: 502,
+        details: zod_1.z
+            .object({
+            /** Name of the upstream service that returned the invalid response. */
+            upstream: zod_1.z.string(),
+        })
+            .partial(),
+        message: 'Bad gateway',
+    },
     [BASE_ERROR_CODES.SERVICE_UNAVAILABLE]: {
         kind: catalog_types_1.ErrorKind.SYSTEM,
         status: 503,
         details: zod_1.z
             .object({
+            /** Seconds the client should wait before retrying. */
             retryAfter: zod_1.z.number(),
         })
             .partial(),

package/dist/cjs/errors/catalog_base.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog_base.js","sourceRoot":"","sources":["../../../src/errors/catalog_base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"catalog_base.js","sourceRoot":"","sources":["../../../src/errors/catalog_base.ts"],"names":[],"mappings":";;;AAAA,6BAAuB;AACvB,mDAA8E;AAE9E;;;GAGG;AACH,IAAY,gBA8BX;AA9BD,WAAY,gBAAgB;IAC1B,SAAS;IACT,4DAA4D;IAC5D,6CAAyB,CAAA;IACzB,+DAA+D;IAC/D,+CAA2B,CAAA;IAC3B,oDAAoD;IACpD,qDAAiC,CAAA;IACjC,wDAAwD;IACxD,iDAA6B,CAAA;IAC7B,6CAA6C;IAC7C,2CAAuB,CAAA;IACvB,qEAAqE;IACrE,qDAAiC,CAAA;IACjC,oEAAoE;IACpE,yCAAqB,CAAA;IACrB,0FAA0F;IAC1F,iCAAa,CAAA;IACb,qGAAqG;IACrG,iEAA6C,CAAA;IAC7C,qDAAqD;IACrD,uDAAmC,CAAA;IAEnC,SAAS;IACT,gGAAgG;IAChG,mEAA+C,CAAA;IAC/C,uFAAuF;IACvF,+CAA2B,CAAA;IAC3B,qDAAqD;IACrD,+DAA2C,CAAA;AAC7C,CAAC,EA9BW,gBAAgB,gCAAhB,gBAAgB,QA8B3B;AAED,0GAA0G;AAC7F,QAAA,mBAAmB,GAAG;IACjC,SAAS;IAET,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE;QAC7B,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YAChB,MAAM,EAAE,OAAC;iBACN,MAAM,CAAC;gBACN,4FAA4F;gBAC5F,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;gBACtB,6DAA6D;gBAC7D,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;gBAChB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;gBACnB,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;aAC1B,CAAC;iBACD,KAAK,EAAE;SACX,CAAC;QACF,OAAO,EAAE,kBAAkB;KAC5B;IAED,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE;QAC9B,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC;aACP,MAAM,CAAC;YACN,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;SACnB,CAAC;aACD,OAAO,EAAE;QACZ,OAAO,EAAE,aAAa;KACvB;IAED,CAAC,gBAAgB,CAAC,cAAc,CAAC,EAAE;QACjC,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC;aACP,MAAM,CAAC;YACN,0DAA0D;YAC1D,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;SACnB,CAAC;aACD,OAAO,EAAE;QACZ,OAAO,EAAE,uBAAuB;KACjC;IAED,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE;QAC/B,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC;aACP,MAAM,CAAC;YACN,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;YACzB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;SACrB,CAAC;aACD,OAAO,EAAE;QACZ,OAAO,EAAE,mDAAmD;KAC7D;IAED,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE;QAC5B,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC;aACP,MAAM,CAAC;YACN,yDAAyD;YACzD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;SACnB,CAAC;aACD,OAAO,EAAE;QACZ,OAAO,EAAE,WAAW;KACrB;IAED,CAAC,gBAAgB,CAAC,cAAc,CAAC,EAAE;QACjC,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC;aACP,MAAM,CAAC;YACN,aAAa,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SACnC,CAAC;aACD,OAAO,EAAE;QACZ,OAAO,EAAE,gBAAgB;KAC1B;IAED,+DAA+D;IAC/D,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE;QAC3B,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC;aACP,MAAM,CAAC;YACN,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;SAClB,CAAC;aACD,KAAK,EAAE;QACV,OAAO,EAAE,UAAU;KACpB;IAED,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE;QACvB,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC;aACP,MAAM,CAAC;YACN,2DAA2D;YAC3D,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;SAClB,CAAC;aACD,OAAO,EAAE;QACZ,OAAO,EAAE,MAAM;KAChB;IAED,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,EAAE;QACvC,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC;aACP,MAAM,CAAC;YACN,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;SACnB,CAAC;aACD,OAAO,EAAE;QACZ,OAAO,EAAE,sBAAsB;KAChC;IAED,CAAC,gBAAgB,CAAC,eAAe,CAAC,EAAE;QAClC,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACxC,OAAO,EAAE,4BAA4B;KACtC;IAED,SAAS;IAET,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,EAAE;QACxC,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC;aACP,MAAM,CAAC;YACN,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;SACnB,CAAC;aACD,OAAO,EAAE;QACZ,OAAO,EAAE,uBAAuB;KACjC;IAED,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE;QAC9B,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC;aACP,MAAM,CAAC;YACN,uEAAuE;YACvE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;SACrB,CAAC;aACD,OAAO,EAAE;QACZ,OAAO,EAAE,aAAa;KACvB;IAED,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,EAAE;QACtC,IAAI,EAAE,yBAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,OAAC;aACP,MAAM,CAAC;YACN,sDAAsD;YACtD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;SACvB,CAAC;aACD,OAAO,EAAE;QACZ,OAAO,EAAE,qBAAqB;KAC/B;CACoD,CAAA"}

package/dist/cjs/errors/catalog_types.d.ts

@@ -1,12 +1,36 @@
 import { z } from 'zod';
+/**
+ * Classifies an error by origin and visibility.
+ *
+ * - `DOMAIN` – predictable business-logic error; details are safe to expose to the client.
+ * - `SYSTEM` – unexpected infrastructure error; message is sanitised before being sent.
+ */
 export declare enum ErrorKind {
     SYSTEM = "system",
     DOMAIN = "domain"
 }
+/**
+ * Source-of-truth definition for a single error code.
+ *
+ * - `kind`    – domain (safe to expose) or system (sanitised).
+ * - `status`  – HTTP status code.
+ * - `details` – Zod schema for both runtime validation and TypeScript type inference.
+ * - `message` – Default human-readable description.
+ */
 export type ErrorCatalogEntry = {
     kind: ErrorKind;
     status: number;
     details: z.ZodTypeAny;
     message: string;
 };
+/**
+ * Infers the `details` payload type for code `C` by indexing the catalog object `Cat`.
+ * Keeps per-catalog `*ErrorDetails` aliases to a single line.
+ *
+ * @example
+ * export type MyDetails<C extends MY_CODES> = CatalogDetails<C, typeof MY_CATALOG>
+ */
+export type CatalogDetails<C extends string, Cat extends Record<string, {
+    details: z.ZodTypeAny;
+}>> = C extends keyof Cat ? z.infer<Cat[C]['details']> : never;
 //# sourceMappingURL=catalog_types.d.ts.map

package/dist/cjs/errors/catalog_types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog_types.d.ts","sourceRoot":"","sources":["../../../src/errors/catalog_types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,CAAC,CAAC,UAAU,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA"}
+{"version":3,"file":"catalog_types.d.ts","sourceRoot":"","sources":["../../../src/errors/catalog_types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AACH,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,CAAC,CAAC,UAAU,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,CACxB,CAAC,SAAS,MAAM,EAChB,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,CAAC,CAAC,UAAU,CAAA;CAAE,CAAC,IACnD,CAAC,SAAS,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,CAAA"}

package/dist/cjs/errors/catalog_types.js

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ErrorKind = void 0;
+/**
+ * Classifies an error by origin and visibility.
+ *
+ * - `DOMAIN` – predictable business-logic error; details are safe to expose to the client.
+ * - `SYSTEM` – unexpected infrastructure error; message is sanitised before being sent.
+ */
 var ErrorKind;
 (function (ErrorKind) {
     ErrorKind["SYSTEM"] = "system";

package/dist/cjs/errors/catalog_types.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog_types.js","sourceRoot":"","sources":["../../../src/errors/catalog_types.ts"],"names":[],"mappings":";;;AAEA,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,8BAAiB,CAAA;IACjB,8BAAiB,CAAA;AACnB,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB"}
+{"version":3,"file":"catalog_types.js","sourceRoot":"","sources":["../../../src/errors/catalog_types.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACH,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,8BAAiB,CAAA;IACjB,8BAAiB,CAAA;AACnB,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB"}