@eleva-io/erp-sdk 0.1.155 → 0.1.156

package/dist/esm/src/errors/catalog_api.js

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import { 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 var API_ERROR_CODES;
+(function (API_ERROR_CODES) {
+    API_ERROR_CODES["FORBIDDEN_CONTACT"] = "FORBIDDEN_CONTACT";
+    API_ERROR_CODES["HORIZONTAL_BULK_MESSAGING_ATTACHMENTS_TOO_LARGE"] = "HORIZONTAL_BULK_MESSAGING_ATTACHMENTS_TOO_LARGE";
+    API_ERROR_CODES["HORIZONTAL_CLAIM_POLICY_COMMUNITY_MISMATCH"] = "HORIZONTAL_CLAIM_POLICY_COMMUNITY_MISMATCH";
+    API_ERROR_CODES["HORIZONTAL_CLAIM_CONTACT_ALREADY_LINKED"] = "HORIZONTAL_CLAIM_CONTACT_ALREADY_LINKED";
+    API_ERROR_CODES["HORIZONTAL_CLAIM_CLOSED_BEFORE_OPENED"] = "HORIZONTAL_CLAIM_CLOSED_BEFORE_OPENED";
+    API_ERROR_CODES["TICKETING_TASK_CLAIM_SUBREF_NOT_ALLOWED"] = "TICKETING_TASK_CLAIM_SUBREF_NOT_ALLOWED";
+    API_ERROR_CODES["TICKETING_TASK_CLAIM_ALREADY_ASSOCIATED"] = "TICKETING_TASK_CLAIM_ALREADY_ASSOCIATED";
+})(API_ERROR_CODES || (API_ERROR_CODES = {}));
+/** Maps every `API_ERROR_CODES` member to its catalog entry. */
+export const API_ERRORS_CATALOG = {
+    [API_ERROR_CODES.FORBIDDEN_CONTACT]: {
+        kind: ErrorKind.DOMAIN,
+        status: 403,
+        details: z.object({
+            /** UUID of the contact person the caller was denied access to. */
+            contactId: z.string(),
+        }),
+        message: 'You are not authorized to access this contact person',
+    },
+    [API_ERROR_CODES.HORIZONTAL_BULK_MESSAGING_ATTACHMENTS_TOO_LARGE]: {
+        kind: ErrorKind.DOMAIN,
+        status: 413,
+        details: z.object({
+            /** Maximum total size allowed for all attachments, in bytes. */
+            maxBytes: z.number(),
+            /** Total size of the submitted attachments, in bytes. */
+            totalBytes: z.number(),
+        }),
+        message: 'The total size of the attachments exceeds the maximum allowed',
+    },
+    [API_ERROR_CODES.HORIZONTAL_CLAIM_POLICY_COMMUNITY_MISMATCH]: {
+        kind: ErrorKind.DOMAIN,
+        status: 422,
+        details: z.object({ policyId: z.string(), communityId: z.string() }),
+        message: 'Policy does not belong to the given community',
+    },
+    [API_ERROR_CODES.HORIZONTAL_CLAIM_CONTACT_ALREADY_LINKED]: {
+        kind: ErrorKind.DOMAIN,
+        status: 409,
+        details: z.object({ claimId: z.string(), contactId: z.string() }),
+        message: 'Contact is already linked to this claim',
+    },
+    [API_ERROR_CODES.HORIZONTAL_CLAIM_CLOSED_BEFORE_OPENED]: {
+        kind: ErrorKind.DOMAIN,
+        status: 422,
+        details: z.object({ openedAt: z.string(), closedAt: z.string() }),
+        message: 'closedAt cannot be before openedAt',
+    },
+    [API_ERROR_CODES.TICKETING_TASK_CLAIM_SUBREF_NOT_ALLOWED]: {
+        kind: ErrorKind.DOMAIN,
+        status: 422,
+        details: z.object({ taskId: z.string(), refId: z.string() }),
+        message: 'Claim resources do not accept subType or subRef',
+    },
+    [API_ERROR_CODES.TICKETING_TASK_CLAIM_ALREADY_ASSOCIATED]: {
+        kind: ErrorKind.DOMAIN,
+        status: 409,
+        details: z.object({ taskId: z.string(), refId: z.string() }),
+        message: 'Task already has a claim associated',
+    },
+};
+//# sourceMappingURL=catalog_api.js.map

package/dist/esm/src/errors/catalog_api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_api.js","sourceRoot":"","sources":["../../../../src/errors/catalog_api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE9E;;;GAGG;AACH,MAAM,CAAN,IAAY,eAUX;AAVD,WAAY,eAAe;IACzB,0DAAuC,CAAA;IAEvC,sHAAmG,CAAA;IACnG,4GAAyF,CAAA;IACzF,sGAAmF,CAAA;IACnF,kGAA+E,CAAA;IAE/E,sGAAmF,CAAA;IACnF,sGAAmF,CAAA;AACrF,CAAC,EAVW,eAAe,KAAf,eAAe,QAU1B;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE;QACnC,IAAI,EAAE,SAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,kEAAkE;YAClE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;SACtB,CAAC;QACF,OAAO,EAAE,sDAAsD;KAChE;IACD,CAAC,eAAe,CAAC,+CAA+C,CAAC,EAAE;QACjE,IAAI,EAAE,SAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,gEAAgE;YAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;YACpB,yDAAyD;YACzD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;SACvB,CAAC;QACF,OAAO,EAAE,+DAA+D;KACzE;IACD,CAAC,eAAe,CAAC,0CAA0C,CAAC,EAAE;QAC5D,IAAI,EAAE,SAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACpE,OAAO,EAAE,+CAA+C;KACzD;IACD,CAAC,eAAe,CAAC,uCAAuC,CAAC,EAAE;QACzD,IAAI,EAAE,SAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACjE,OAAO,EAAE,yCAAyC;KACnD;IACD,CAAC,eAAe,CAAC,qCAAqC,CAAC,EAAE;QACvD,IAAI,EAAE,SAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACjE,OAAO,EAAE,oCAAoC;KAC9C;IACD,CAAC,eAAe,CAAC,uCAAuC,CAAC,EAAE;QACzD,IAAI,EAAE,SAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5D,OAAO,EAAE,iDAAiD;KAC3D;IACD,CAAC,eAAe,CAAC,uCAAuC,CAAC,EAAE;QACzD,IAAI,EAAE,SAAS,CAAC,MAAM;QACtB,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5D,OAAO,EAAE,qCAAqC;KAC/C;CACmD,CAAA"}

package/dist/esm/src/errors/catalog_base.d.ts

@@ -0,0 +1,244 @@
+import { z } from 'zod';
+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">;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                message: string;
+                path: string[];
+                validation: string;
+            }, {
+                code: string;
+                message: string;
+                path: string[];
+                validation: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            errors: {
+                code: string;
+                message: string;
+                path: string[];
+                validation: string;
+            }[];
+        }, {
+            errors: {
+                code: string;
+                message: string;
+                path: string[];
+                validation: string;
+            }[];
+        }>;
+        message: string;
+    };
+    BAD_REQUEST: {
+        kind: ErrorKind.DOMAIN;
+        status: number;
+        details: z.ZodObject<{
+            field: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            field?: string | undefined;
+            reason?: string | undefined;
+        }, {
+            field?: string | undefined;
+            reason?: string | undefined;
+        }>;
+        message: string;
+    };
+    AUTHENTICATION: {
+        kind: ErrorKind.DOMAIN;
+        status: number;
+        details: z.ZodObject<{
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            reason?: string | undefined;
+        }, {
+            reason?: string | undefined;
+        }>;
+        message: string;
+    };
+    UNAUTHORIZED: {
+        kind: ErrorKind.DOMAIN;
+        status: number;
+        details: z.ZodObject<{
+            requiredScope: z.ZodOptional<z.ZodString>;
+            resource: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            requiredScope?: string | undefined;
+            resource?: string | undefined;
+        }, {
+            requiredScope?: string | undefined;
+            resource?: string | undefined;
+        }>;
+        message: string;
+    };
+    NOT_FOUND: {
+        kind: ErrorKind.DOMAIN;
+        status: number;
+        details: z.ZodObject<{
+            entity: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            entity?: string | undefined;
+        }, {
+            entity?: string | undefined;
+        }>;
+        message: string;
+    };
+    NOT_ACCEPTABLE: {
+        kind: ErrorKind.DOMAIN;
+        status: number;
+        details: z.ZodObject<{
+            acceptedTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            acceptedTypes?: string[] | undefined;
+        }, {
+            acceptedTypes?: string[] | undefined;
+        }>;
+        message: string;
+    };
+    /** Each item in the array identifies one conflicting field. */
+    CONFLICT: {
+        kind: ErrorKind.DOMAIN;
+        status: number;
+        details: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodString;
+            cause: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            key: string;
+            cause: string;
+        }, {
+            value: string;
+            key: string;
+            cause: string;
+        }>, "many">;
+        message: string;
+    };
+    GONE: {
+        kind: ErrorKind.DOMAIN;
+        status: number;
+        details: z.ZodObject<{
+            since: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            since?: string | undefined;
+        }, {
+            since?: string | undefined;
+        }>;
+        message: string;
+    };
+    UNPROCESSABLE_ENTITY: {
+        kind: ErrorKind.DOMAIN;
+        status: number;
+        details: z.ZodObject<{
+            field: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            field?: string | undefined;
+            reason?: string | undefined;
+        }, {
+            field?: string | undefined;
+            reason?: string | undefined;
+        }>;
+        message: string;
+    };
+    MANDATORY_FIELD: {
+        kind: ErrorKind.DOMAIN;
+        status: number;
+        details: z.ZodObject<{
+            field: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            field: string;
+        }, {
+            field: string;
+        }>;
+        message: string;
+    };
+    INTERNAL_SERVER_ERROR: {
+        kind: ErrorKind.SYSTEM;
+        status: number;
+        details: z.ZodObject<{
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            reason?: string | undefined;
+        }, {
+            reason?: string | undefined;
+        }>;
+        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;
+        details: z.ZodObject<{
+            retryAfter: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            retryAfter?: number | undefined;
+        }, {
+            retryAfter?: number | undefined;
+        }>;
+        message: string;
+    };
+};
+/**
+ * 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/esm/src/errors/catalog_base.d.ts.map

@@ -0,0 +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,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/esm/src/errors/catalog_base.js

@@ -0,0 +1,187 @@
+import { z } from 'zod';
+import { ErrorKind } from './catalog_types';
+/**
+ * Generic HTTP-level error codes shared across all API domains.
+ * Domain-specific codes live in `catalog_api.ts`.
+ */
+export 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 || (BASE_ERROR_CODES = {}));
+/** Maps every `BASE_ERROR_CODES` member to its HTTP status, kind, default message, and details schema. */
+export const BASE_ERRORS_CATALOG = {
+    // >= 400
+    [BASE_ERROR_CODES.VALIDATION]: {
+        kind: ErrorKind.DOMAIN,
+        status: 400,
+        details: z.object({
+            errors: z
+                .object({
+                /** Dot-separated field path (e.g. `"address.zipCode"`) or `"root"` for top-level issues. */
+                validation: z.string(),
+                /** Zod issue code (e.g. `"invalid_type"`, `"too_small"`). */
+                code: z.string(),
+                message: z.string(),
+                path: z.array(z.string()),
+            })
+                .array(),
+        }),
+        message: 'Validation error',
+    },
+    [BASE_ERROR_CODES.BAD_REQUEST]: {
+        kind: ErrorKind.DOMAIN,
+        status: 400,
+        details: z
+            .object({
+            field: z.string(),
+            reason: z.string(),
+        })
+            .partial(),
+        message: 'Bad request',
+    },
+    [BASE_ERROR_CODES.AUTHENTICATION]: {
+        kind: ErrorKind.DOMAIN,
+        status: 401,
+        details: z
+            .object({
+            /** Why authentication failed (e.g. `"token_expired"`). */
+            reason: z.string(),
+        })
+            .partial(),
+        message: 'Authentication failed',
+    },
+    [BASE_ERROR_CODES.UNAUTHORIZED]: {
+        kind: ErrorKind.DOMAIN,
+        status: 403,
+        details: z
+            .object({
+            requiredScope: z.string(),
+            resource: z.string(),
+        })
+            .partial(),
+        message: 'You do not have permission to perform this action',
+    },
+    [BASE_ERROR_CODES.NOT_FOUND]: {
+        kind: ErrorKind.DOMAIN,
+        status: 404,
+        details: z
+            .object({
+            /** Entity type that was not found (e.g. `"Invoice"`). */
+            entity: z.string(),
+        })
+            .partial(),
+        message: 'Not found',
+    },
+    [BASE_ERROR_CODES.NOT_ACCEPTABLE]: {
+        kind: ErrorKind.DOMAIN,
+        status: 406,
+        details: z
+            .object({
+            acceptedTypes: z.array(z.string()),
+        })
+            .partial(),
+        message: 'Not acceptable',
+    },
+    /** Each item in the array identifies one conflicting field. */
+    [BASE_ERROR_CODES.CONFLICT]: {
+        kind: ErrorKind.DOMAIN,
+        status: 409,
+        details: z
+            .object({
+            key: z.string(),
+            value: z.string(),
+            cause: z.string(),
+        })
+            .array(),
+        message: 'Conflict',
+    },
+    [BASE_ERROR_CODES.GONE]: {
+        kind: ErrorKind.DOMAIN,
+        status: 410,
+        details: z
+            .object({
+            /** ISO 8601 timestamp of when the resource was removed. */
+            since: z.string(),
+        })
+            .partial(),
+        message: 'Gone',
+    },
+    [BASE_ERROR_CODES.UNPROCESSABLE_ENTITY]: {
+        kind: ErrorKind.DOMAIN,
+        status: 422,
+        details: z
+            .object({
+            field: z.string(),
+            reason: z.string(),
+        })
+            .partial(),
+        message: 'Unprocessable entity',
+    },
+    [BASE_ERROR_CODES.MANDATORY_FIELD]: {
+        kind: ErrorKind.DOMAIN,
+        status: 400,
+        details: z.object({ field: z.string() }),
+        message: 'Mandatory field is missing',
+    },
+    // >= 500
+    [BASE_ERROR_CODES.INTERNAL_SERVER_ERROR]: {
+        kind: ErrorKind.SYSTEM,
+        status: 500,
+        details: z
+            .object({
+            reason: z.string(),
+        })
+            .partial(),
+        message: 'Internal server error',
+    },
+    [BASE_ERROR_CODES.BAD_GATEWAY]: {
+        kind: ErrorKind.SYSTEM,
+        status: 502,
+        details: z
+            .object({
+            /** Name of the upstream service that returned the invalid response. */
+            upstream: z.string(),
+        })
+            .partial(),
+        message: 'Bad gateway',
+    },
+    [BASE_ERROR_CODES.SERVICE_UNAVAILABLE]: {
+        kind: ErrorKind.SYSTEM,
+        status: 503,
+        details: z
+            .object({
+            /** Seconds the client should wait before retrying. */
+            retryAfter: z.number(),
+        })
+            .partial(),
+        message: 'Service unavailable',
+    },
+};
+//# sourceMappingURL=catalog_base.js.map

package/dist/esm/src/errors/catalog_base.js.map

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

package/dist/esm/src/errors/catalog_types.d.ts

@@ -0,0 +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/esm/src/errors/catalog_types.d.ts.map

@@ -0,0 +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;;;;;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/esm/src/errors/catalog_types.js

@@ -0,0 +1,12 @@
+/**
+ * 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 var ErrorKind;
+(function (ErrorKind) {
+    ErrorKind["SYSTEM"] = "system";
+    ErrorKind["DOMAIN"] = "domain";
+})(ErrorKind || (ErrorKind = {}));
+//# sourceMappingURL=catalog_types.js.map

package/dist/esm/src/errors/catalog_types.js.map

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