@eleva-io/erp-sdk 0.1.151 → 0.1.152

package/dist/cjs/src/errors/errors.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElevaError = void 0;
+const zod_1 = require("zod");
+const catalog_1 = require("./catalog");
+const catalog_types_1 = require("./catalog_types");
+const catalog_base_1 = require("./catalog_base");
+const catalog_api_1 = require("./catalog_api");
+/**
+ * Permissive schema for parsing unknown error payloads. All fields except `code`
+ * are optional so malformed responses always produce a valid result.
+ * `errors` is the legacy name for `details` (kept for backwards compatibility).
+ */
+const errorSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    kind: zod_1.z.string().optional(),
+    status: zod_1.z.number().optional(),
+    message: zod_1.z.string().optional(),
+    details: zod_1.z.unknown().optional(),
+    /** @deprecated Use `details` instead */
+    errors: zod_1.z.unknown().optional(),
+});
+/** Pre-computed set of all valid error code strings for O(1) membership checks. */
+const KNOWN_CODES = new Set(Object.keys(catalog_1.ERROR_CODES));
+/** Pre-computed set of all valid `ErrorKind` values for O(1) membership checks. */
+const VALID_KINDS = new Set(Object.values(catalog_types_1.ErrorKind));
+/**
+ * Looks up the catalog entry for `code` and builds an `ElevaError`.
+ * Module-private — use the static factory methods on `ElevaError` instead.
+ */
+const _newElevaErrorFromCode = (code, args) => {
+    const entry = catalog_1.ERRORS_CATALOG[code];
+    return new ElevaError({
+        code,
+        kind: entry.kind,
+        status: entry.status,
+        details: args.details ?? {},
+        message: args.message || entry.message,
+        cause: args.cause,
+    });
+};
+/**
+ * Factory for codes whose `details` are entirely optional (every field is `.partial()`).
+ * Returns a function with signature `(args?: { message?, details? }) => ElevaError<C>`.
+ */
+const _optionalFactory = (code) => {
+    return (args = {}) => _newElevaErrorFromCode(code, { details: args.details ?? {}, message: args.message });
+};
+/**
+ * Factory for codes where `details` is built from a single required string argument.
+ * The argument key mirrors the `details` key (e.g. `'entity'` → `{ entity }`).
+ */
+const _namedFieldFactory = (code, key) => {
+    return (args) => _newElevaErrorFromCode(code, { details: { [key]: args[key] }, message: args.message });
+};
+/**
+ * Factory for codes where `details` is required and passed through directly.
+ * Returns a function with signature `(args: { details, message? }) => ElevaError<C>`.
+ */
+const _requiredDetailsFactory = (code) => {
+    return (args) => _newElevaErrorFromCode(code, { details: args.details, message: args.message });
+};
+/**
+ * Central error class for the Eleva ERP SDK.
+ *
+ * Extends `Error` with structured metadata: `code`, `kind`, `status`, and typed `details`.
+ *
+ * ```ts
+ * // Create
+ * throw ElevaError.notFound({ entity: 'Invoice' })
+ * throw ElevaError.conflict({ details: [{ key: 'email', value: 'a@b.com', cause: 'duplicate' }] })
+ *
+ * // Narrow
+ * if (err instanceof ElevaError && err.is(ERROR_CODES.NOT_FOUND)) {
+ *   console.log(err.details.entity) // string
+ * }
+ * ```
+ *
+ * Serialisation: `toJSON()` for logging, `toResponse()` for sanitised API output.
+ */
+class ElevaError extends Error {
+    /** Error code constant identifying the failure condition. */
+    code;
+    /** `DOMAIN` (safe to expose) or `SYSTEM` (sanitised before sending to clients). */
+    kind;
+    /** HTTP status code for this error. */
+    status;
+    /** Structured, code-specific failure context. */
+    details;
+    constructor(args) {
+        super(args.message, { cause: args.cause });
+        this.name = 'ElevaError';
+        this.code = args.code;
+        this.kind = args.kind;
+        this.status = args.status;
+        this.details = args.details;
+        // Removes the constructor frame from V8 stack traces.
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Type-guard: narrows to `ElevaError<K>` when `this.code === code`.
+     * After a positive check `this.details` is fully typed for `K`.
+     * @example
+     * if (err.is(ERROR_CODES.NOT_FOUND)) console.log(err.details.entity)
+     */
+    is(code) {
+        return this.code === code;
+    }
+    /** Full serialised representation for logging / diagnostics. */
+    toJSON() {
+        return {
+            code: this.code,
+            kind: this.kind,
+            status: this.status,
+            message: this.message,
+            details: this.details,
+        };
+    }
+    toString() {
+        return JSON.stringify(this);
+    }
+    /**
+     * Sanitised payload safe for API responses.
+     * `SYSTEM` errors replace the message with a generic string; `DOMAIN` errors include `details`.
+     */
+    toResponse() {
+        const resp = {
+            code: this.code,
+            message: this.message,
+        };
+        if (this.kind === catalog_types_1.ErrorKind.SYSTEM) {
+            resp.message = 'Houston, we have a problem';
+        }
+        else if (this.kind === catalog_types_1.ErrorKind.DOMAIN) {
+            resp.details = this.details;
+        }
+        return resp;
+    }
+    /**
+     * Parses an unknown value into `ElevaErrorArgs`. Shared by `parse()` and `RemoteElevaError.from()`.
+     *
+     * Strategy: validate against `errorSchema` → look up known codes in the catalog →
+     * fall back to `INTERNAL_SERVER_ERROR` for unrecognised codes or malformed payloads →
+     * accept legacy `errors` field as a fallback for `details`.
+     */
+    static _parsePayload(value) {
+        const result = errorSchema.safeParse(value);
+        if (!result.success) {
+            const code = catalog_1.ERROR_CODES.INTERNAL_SERVER_ERROR;
+            const entry = catalog_1.ERRORS_CATALOG[code];
+            return {
+                code,
+                kind: entry.kind,
+                status: entry.status,
+                message: `Failed to parse error payload: ${result.error.message}`,
+                details: {},
+                cause: value,
+            };
+        }
+        const code = result.data.code;
+        const isKnownCode = KNOWN_CODES.has(code);
+        const isValidKind = !!result.data.kind && VALID_KINDS.has(result.data.kind);
+        const entry = isKnownCode ? catalog_1.ERRORS_CATALOG[code] : catalog_1.ERRORS_CATALOG[catalog_1.ERROR_CODES.INTERNAL_SERVER_ERROR];
+        return {
+            code,
+            kind: isValidKind ? result.data.kind : entry.kind,
+            status: result.data.status ?? entry.status,
+            message: result.data.message ?? entry.message,
+            details: (result.data.details ?? result.data.errors ?? {}),
+        };
+    }
+    /** Deserialises an unknown value into an `ElevaError`. Unrecognised payloads become `INTERNAL_SERVER_ERROR`. */
+    static parse(value) {
+        return new ElevaError(ElevaError._parsePayload(value));
+    }
+    /** Converts a `ZodError` into a `VALIDATION` error, preserving field paths and rule codes. */
+    static fromZodError(error) {
+        const errors = error.issues.map((issue) => {
+            const path = issue.path.map(String);
+            const validation = path.join('.') || 'root';
+            return { validation, code: issue.code, message: issue.message, path };
+        });
+        return ElevaError.validation({ errors, message: error.message });
+    }
+    /** Creates a `VALIDATION` error from a pre-built array of issue descriptors. */
+    static validation(args) {
+        return _newElevaErrorFromCode(catalog_base_1.BASE_ERROR_CODES.VALIDATION, {
+            details: { errors: args.errors },
+            message: args.message,
+        });
+    }
+    /** Creates a `VALIDATION` error for a single invalid field. Convenience wrapper around `validation()`. */
+    static invalidField(args) {
+        return ElevaError.validation({ errors: [args.error], message: args.message });
+    }
+    /** HTTP 400 — request is malformed or has invalid parameters outside of validation. */
+    static badRequest = _optionalFactory(catalog_base_1.BASE_ERROR_CODES.BAD_REQUEST);
+    /** HTTP 401 — credentials are missing, expired, or invalid. Caller must re-authenticate. */
+    static authentication = _optionalFactory(catalog_base_1.BASE_ERROR_CODES.AUTHENTICATION);
+    /** HTTP 403 — authenticated but lacks the required scope or permission. */
+    static unauthorized = _optionalFactory(catalog_base_1.BASE_ERROR_CODES.UNAUTHORIZED);
+    /**
+     * HTTP 404 — no resource found for the given identifier.
+     * @param args.entity - Entity type that was not found (e.g. `"Invoice"`).
+     */
+    static notFound = _namedFieldFactory(catalog_base_1.BASE_ERROR_CODES.NOT_FOUND, 'entity');
+    /** HTTP 406 — server cannot produce a response matching the `Accept` header. */
+    static notAcceptable = _optionalFactory(catalog_base_1.BASE_ERROR_CODES.NOT_ACCEPTABLE);
+    /** HTTP 409 — operation violates a uniqueness or integrity constraint. */
+    static conflict = _requiredDetailsFactory(catalog_base_1.BASE_ERROR_CODES.CONFLICT);
+    /** HTTP 410 — resource permanently removed; retrying will never succeed. */
+    static gone = _optionalFactory(catalog_base_1.BASE_ERROR_CODES.GONE);
+    /** HTTP 422 — request is syntactically valid but semantically unprocessable. */
+    static unprocessableEntity = _optionalFactory(catalog_base_1.BASE_ERROR_CODES.UNPROCESSABLE_ENTITY);
+    /**
+     * HTTP 502 — upstream service returned an invalid response (`SYSTEM`).
+     * @param args.details.upstream - Name of the misbehaving upstream service.
+     */
+    static badGateway = _optionalFactory(catalog_base_1.BASE_ERROR_CODES.BAD_GATEWAY);
+    /** HTTP 503 — service temporarily unavailable (`SYSTEM`). Pass `retryAfter` (seconds) if known. */
+    static serviceUnavailable = _optionalFactory(catalog_base_1.BASE_ERROR_CODES.SERVICE_UNAVAILABLE);
+    /**
+     * HTTP 400 — a required field was missing from the request.
+     * @param args.field - Name of the missing field.
+     */
+    static mandatoryField = _namedFieldFactory(catalog_base_1.BASE_ERROR_CODES.MANDATORY_FIELD, 'field');
+    /**
+     * HTTP 500 — unexpected server error (`SYSTEM`).
+     * Pass the original exception as `cause` to preserve the full stack chain for logging.
+     */
+    static internal(args = {}) {
+        return _newElevaErrorFromCode(catalog_base_1.BASE_ERROR_CODES.INTERNAL_SERVER_ERROR, {
+            details: args.details ?? {},
+            message: args.message,
+            cause: args.cause,
+        });
+    }
+    /**
+     * HTTP 403 — caller is not authorised to access the given contact person.
+     * @param args.details.contactId - UUID of the blocked contact.
+     */
+    static forbiddenContact = _requiredDetailsFactory(catalog_api_1.API_ERROR_CODES.FORBIDDEN_CONTACT);
+}
+exports.ElevaError = ElevaError;
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/errors/errors.ts"],"names":[],"mappings":";;;AAAA,6BAAuB;AACvB,uCAAqF;AACrF,mDAA2C;AAC3C,iDAAiD;AACjD,+CAA+C;AAE/C;;;;GAIG;AACH,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,wCAAwC;IACxC,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAA;AAEF,mFAAmF;AACnF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAW,CAAC,CAAC,CAAA;AAErD,mFAAmF;AACnF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,yBAAS,CAAC,CAAC,CAAA;AA2BrD;;;GAGG;AACH,MAAM,sBAAsB,GAAG,CAC7B,IAAO,EACP,IAIC,EACc,EAAE;IACjB,MAAM,KAAK,GAAG,wBAAc,CAAC,IAAiB,CAAC,CAAA;IAE/C,OAAO,IAAI,UAAU,CAAC;QACpB,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO;QACtC,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAA;AACJ,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,gBAAgB,GAAG,CACvB,IAAO,EACsE,EAAE;IAC/E,OAAO,CAAC,OAAwD,EAAE,EAAiB,EAAE,CACnF,sBAAsB,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAK,EAAsB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;AAC7G,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,kBAAkB,GAAG,CACzB,IAAO,EACP,GAAM,EAC+D,EAAE;IACvE,OAAO,CAAC,IAA8C,EAAiB,EAAE,CACvE,sBAAsB,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAqB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;AAC7G,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,uBAAuB,GAAG,CAC9B,IAAO,EACoE,EAAE;IAC7E,OAAO,CAAC,IAAoD,EAAiB,EAAE,CAC7E,sBAAsB,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;AAClF,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,UAA4C,SAAQ,KAAK;IACpE,6DAA6D;IACpD,IAAI,CAAY;IAEzB,mFAAmF;IAC1E,IAAI,CAAW;IAExB,uCAAuC;IAC9B,MAAM,CAAQ;IAEvB,iDAAiD;IACxC,OAAO,CAAiB;IAEjC,YAAY,IAAuB;QACjC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;QAE1C,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAE3B,sDAAsD;QACtD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,EAAE,CAAsB,IAAgB;QACtC,OAAQ,IAAI,CAAC,IAAkB,KAAK,IAAI,CAAA;IAC1C,CAAC;IAED,gEAAgE;IAChE,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAA;IACH,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,MAAM,IAAI,GAA0B;YAClC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAA;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,yBAAS,CAAC,MAAM,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,GAAG,4BAA4B,CAAA;QAC7C,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,yBAAS,CAAC,MAAM,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC7B,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;OAMG;IACO,MAAM,CAAC,aAAa,CAAC,KAAc;QAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QAE3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,qBAAW,CAAC,qBAAqB,CAAA;YAC9C,MAAM,KAAK,GAAG,wBAAc,CAAC,IAAI,CAAC,CAAA;YAClC,OAAO;gBACL,IAAI;gBACJ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO,EAAE,kCAAkC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;gBACjE,OAAO,EAAE,EAA6B;gBACtC,KAAK,EAAE,KAAK;aACb,CAAA;QACH,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAA;QAC7B,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACzC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAiB,CAAC,CAAA;QACxF,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,wBAAc,CAAC,IAAiB,CAAC,CAAC,CAAC,CAAC,wBAAc,CAAC,qBAAW,CAAC,qBAAqB,CAAC,CAAA;QAEjH,OAAO;YACL,IAAI;YACJ,IAAI,EAAE,WAAW,CAAC,CAAC,CAAE,MAAM,CAAC,IAAI,CAAC,IAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI;YAChE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM;YAC1C,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO;YAC7C,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAA4B;SACtF,CAAA;IACH,CAAC;IAED,gHAAgH;IAChH,MAAM,CAAC,KAAK,CAAC,KAAc;QACzB,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;IACxD,CAAC;IAED,8FAA8F;IAC9F,MAAM,CAAC,YAAY,CAAI,KAAoB;QACzC,MAAM,MAAM,GAAwD,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC7F,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACnC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAA;YAC3C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAA;QACvE,CAAC,CAAC,CAAA;QAEF,OAAO,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IAClE,CAAC;IAED,gFAAgF;IAChF,MAAM,CAAC,UAAU,CAAC,IAGjB;QACC,OAAO,sBAAsB,CAAC,+BAAgB,CAAC,UAAU,EAAE;YACzD,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;YAChC,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAA;IACJ,CAAC;IAED,0GAA0G;IAC1G,MAAM,CAAC,YAAY,CAAC,IAGnB;QACC,OAAO,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;IAC/E,CAAC;IAED,uFAAuF;IACvF,MAAM,CAAU,UAAU,GAAG,gBAAgB,CAAC,+BAAgB,CAAC,WAAW,CAAC,CAAA;IAE3E,4FAA4F;IAC5F,MAAM,CAAU,cAAc,GAAG,gBAAgB,CAAC,+BAAgB,CAAC,cAAc,CAAC,CAAA;IAElF,2EAA2E;IAC3E,MAAM,CAAU,YAAY,GAAG,gBAAgB,CAAC,+BAAgB,CAAC,YAAY,CAAC,CAAA;IAE9E;;;OAGG;IACH,MAAM,CAAU,QAAQ,GAAG,kBAAkB,CAAC,+BAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IAEnF,gFAAgF;IAChF,MAAM,CAAU,aAAa,GAAG,gBAAgB,CAAC,+BAAgB,CAAC,cAAc,CAAC,CAAA;IAEjF,0EAA0E;IAC1E,MAAM,CAAU,QAAQ,GAAG,uBAAuB,CAAC,+BAAgB,CAAC,QAAQ,CAAC,CAAA;IAE7E,4EAA4E;IAC5E,MAAM,CAAU,IAAI,GAAG,gBAAgB,CAAC,+BAAgB,CAAC,IAAI,CAAC,CAAA;IAE9D,gFAAgF;IAChF,MAAM,CAAU,mBAAmB,GAAG,gBAAgB,CAAC,+BAAgB,CAAC,oBAAoB,CAAC,CAAA;IAE7F;;;OAGG;IACH,MAAM,CAAU,UAAU,GAAG,gBAAgB,CAAC,+BAAgB,CAAC,WAAW,CAAC,CAAA;IAE3E,mGAAmG;IACnG,MAAM,CAAU,kBAAkB,GAAG,gBAAgB,CAAC,+BAAgB,CAAC,mBAAmB,CAAC,CAAA;IAE3F;;;OAGG;IACH,MAAM,CAAU,cAAc,GAAG,kBAAkB,CAAC,+BAAgB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;IAE9F;;;OAGG;IACH,MAAM,CAAC,QAAQ,CACb,OAA8G,EAAE;QAEhH,OAAO,sBAAsB,CAAC,+BAAgB,CAAC,qBAAqB,EAAE;YACpE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAA;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAU,gBAAgB,GAAG,uBAAuB,CAAC,6BAAe,CAAC,iBAAiB,CAAC,CAAA;;AA5M/F,gCA6MC"}

package/dist/cjs/src/errors/errors.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.spec.d.ts.map

package/dist/cjs/src/errors/errors.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.spec.d.ts","sourceRoot":"","sources":["../../../../src/errors/errors.spec.ts"],"names":[],"mappings":""}

package/dist/cjs/src/errors/errors.spec.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const _1 = require(".");
+const validationDetails = {
+    errors: [{ validation: 'email', code: 'invalid_string', message: 'Invalid email', path: ['email'] }],
+};
+const notFoundDetails = { entity: 'User' };
+const conflictDetails = [{ key: 'email', value: 'already@taken.com', cause: 'duplicate' }];
+describe('ElevaError', () => {
+    describe('constructor', () => {
+        it('is an instance of Error and ElevaError', () => {
+            const error = _1.ElevaError.internal({});
+            expect(error).toBeInstanceOf(Error);
+            expect(error).toBeInstanceOf(_1.ElevaError);
+        });
+        it('sets name to "ElevaError"', () => {
+            const error = _1.ElevaError.internal({});
+            expect(error.name).toBe('ElevaError');
+        });
+        it('picks kind, status and default message from the catalog', () => {
+            const error = _1.ElevaError.internal({});
+            expect(error.code).toBe(_1.ERROR_CODES.INTERNAL_SERVER_ERROR);
+            expect(error.kind).toBe(_1.ErrorKind.SYSTEM);
+            expect(error.status).toBe(500);
+            expect(error.message).toBe('Internal server error');
+        });
+        it('uses a custom message when provided', () => {
+            const error = _1.ElevaError.internal({ message: 'Something blew up' });
+            expect(error.message).toBe('Something blew up');
+        });
+        it('exposes structured details (VALIDATION)', () => {
+            const error = _1.ElevaError.validation(validationDetails);
+            expect(error.details).toEqual(validationDetails);
+        });
+        it('exposes structured details (NOT_FOUND)', () => {
+            const error = _1.ElevaError.notFound(notFoundDetails);
+            expect(error.details).toEqual(notFoundDetails);
+        });
+        it('exposes structured details (CONFLICT)', () => {
+            const error = _1.ElevaError.conflict({ details: conflictDetails });
+            expect(error.details).toEqual(conflictDetails);
+        });
+        it('allows omitting details for codes with fully optional shapes', () => {
+            const error = _1.ElevaError.unauthorized({});
+            expect(error.code).toBe(_1.ERROR_CODES.UNAUTHORIZED);
+            expect(error.details).toEqual({});
+        });
+        it('forwards cause to the underlying Error', () => {
+            const cause = new Error('boom');
+            const error = _1.ElevaError.internal({ cause });
+            expect(error.cause).toBe(cause);
+        });
+        it('captures a stack trace', () => {
+            const error = _1.ElevaError.internal({});
+            expect(error.stack).toMatch(/ElevaError/);
+        });
+    });
+    describe('is()', () => {
+        it('returns true when the code matches', () => {
+            const error = _1.ElevaError.notFound(notFoundDetails);
+            expect(error.is(_1.ERROR_CODES.NOT_FOUND)).toBe(true);
+        });
+        it('returns false when the code does not match', () => {
+            const error = _1.ElevaError.notFound(notFoundDetails);
+            expect(error.is(_1.ERROR_CODES.CONFLICT)).toBe(false);
+        });
+        it('narrows details to the matching code', () => {
+            const err = _1.ElevaError.notFound(notFoundDetails);
+            const entity = err.is(_1.ERROR_CODES.NOT_FOUND) ? err.details.entity : null;
+            expect(entity).toBe('User');
+        });
+        it('returns true when a plain string matches the code', () => {
+            const error = _1.ElevaError.notFound(notFoundDetails);
+            expect(error.is('NOT_FOUND')).toBe(true);
+        });
+        it('returns false when a plain string does not match the code', () => {
+            const error = _1.ElevaError.notFound(notFoundDetails);
+            expect(error.is('CONFLICT')).toBe(false);
+        });
+        it('returns true for uncatalogued codes matched by string', () => {
+            const error = _1.ElevaError.parse({ code: 'CUSTOM_CODE', message: 'custom' });
+            expect(error.is('CUSTOM_CODE')).toBe(true);
+        });
+    });
+    describe('toJSON() / toString()', () => {
+        it('toJSON returns a plain object with all fields', () => {
+            const error = _1.ElevaError.validation(validationDetails);
+            expect(error.toJSON()).toEqual({
+                code: _1.ERROR_CODES.VALIDATION,
+                kind: _1.ErrorKind.DOMAIN,
+                status: 400,
+                message: 'Validation error',
+                details: validationDetails,
+            });
+        });
+        it('toString returns a JSON string equivalent to toJSON()', () => {
+            const error = _1.ElevaError.validation(validationDetails);
+            expect(error.toString()).toBe(JSON.stringify(error.toJSON()));
+        });
+    });
+    describe('parse()', () => {
+        it('reconstructs an ElevaError from a valid response body', () => {
+            const body = {
+                code: _1.ERROR_CODES.VALIDATION,
+                message: 'Validation error',
+                details: validationDetails,
+            };
+            const error = _1.ElevaError.parse(body);
+            expect(error).toBeInstanceOf(_1.ElevaError);
+            expect(error.code).toBe(_1.ERROR_CODES.VALIDATION);
+            expect(error.message).toBe('Validation error');
+            expect(error.details).toEqual(validationDetails);
+        });
+        it('derives kind and status from the catalog when not provided', () => {
+            const error = _1.ElevaError.parse({ code: _1.ERROR_CODES.NOT_FOUND, message: 'Not found' });
+            expect(error.kind).toBe(_1.ErrorKind.DOMAIN);
+            expect(error.status).toBe(404);
+        });
+        it('uses kind and status from the payload when provided', () => {
+            const body = { code: _1.ERROR_CODES.NOT_FOUND, kind: _1.ErrorKind.SYSTEM, status: 503, message: 'Override' };
+            const error = _1.ElevaError.parse(body);
+            expect(error.kind).toBe(_1.ErrorKind.SYSTEM);
+            expect(error.status).toBe(503);
+        });
+        it('falls back to catalog message when message is not provided', () => {
+            const error = _1.ElevaError.parse({ code: _1.ERROR_CODES.NOT_FOUND });
+            expect(error.message).toBe('Not found');
+        });
+        it('preserves uncatalogued codes and their message as-is', () => {
+            const body = { code: 'SOME_NEW_CODE', message: 'Something went wrong on the server' };
+            const error = _1.ElevaError.parse(body);
+            expect(error.code).toBe('SOME_NEW_CODE');
+            expect(error.message).toBe('Something went wrong on the server');
+        });
+        it('falls back to INTERNAL_SERVER_ERROR kind and status for uncatalogued codes', () => {
+            const body = { code: 'SOME_NEW_CODE', message: 'New error type' };
+            const error = _1.ElevaError.parse(body);
+            expect(error.kind).toBe(_1.ErrorKind.SYSTEM);
+            expect(error.status).toBe(500);
+        });
+        it('falls back to INTERNAL_SERVER_ERROR on malformed payloads', () => {
+            const body = 'not an object';
+            const error = _1.ElevaError.parse(body);
+            expect(error.code).toBe(_1.ERROR_CODES.INTERNAL_SERVER_ERROR);
+            expect(error.message).toMatch(/^Failed to parse error payload:/);
+            expect(error.cause).toBe(body);
+        });
+    });
+    describe('fromZodError()', () => {
+        const fail = (schema, value) => {
+            const result = schema.safeParse(value);
+            return result.success ? new zod_1.z.ZodError([]) : result.error;
+        };
+        it('converts a ZodError into a VALIDATION ElevaError', () => {
+            const schema = zod_1.z.object({ email: zod_1.z.string().email(), age: zod_1.z.number().int() });
+            const error = _1.ElevaError.fromZodError(fail(schema, { email: 'not-an-email', age: 1.5 }));
+            expect(error.code).toBe(_1.ERROR_CODES.VALIDATION);
+            expect(error.details.errors.length).toBeGreaterThan(0);
+            const first = error.details.errors[0];
+            expect(first.path).toEqual(expect.any(Array));
+            expect(typeof first.message).toBe('string');
+        });
+        it('uses "root" as path label when issue path is empty', () => {
+            const error = _1.ElevaError.fromZodError(fail(zod_1.z.string(), 123));
+            expect(error.details.errors[0].validation).toBe('root');
+        });
+    });
+    describe('factories', () => {
+        it('validation() accepts an errors array', () => {
+            const error = _1.ElevaError.validation({
+                errors: [
+                    { validation: 'x', code: 'c', message: 'm', path: ['x'] },
+                    { validation: 'y', code: 'c', message: 'm', path: ['y'] },
+                ],
+            });
+            expect(error.code).toBe(_1.ERROR_CODES.VALIDATION);
+            expect(error.details.errors).toHaveLength(2);
+        });
+        it('invalidField() builds a single-field validation error', () => {
+            const error = _1.ElevaError.invalidField({
+                error: { validation: 'email', code: 'invalid_string', message: 'Invalid email', path: ['email'] },
+            });
+            expect(error.code).toBe(_1.ERROR_CODES.VALIDATION);
+            expect(error.details.errors[0]).toEqual({
+                validation: 'email',
+                code: 'invalid_string',
+                message: 'Invalid email',
+                path: ['email'],
+            });
+        });
+        it('notFound() builds a NOT_FOUND error with entity', () => {
+            const error = _1.ElevaError.notFound({ entity: 'User' });
+            expect(error.code).toBe(_1.ERROR_CODES.NOT_FOUND);
+            expect(error.details).toEqual({ entity: 'User' });
+        });
+        it('conflict() builds a CONFLICT error', () => {
+            const error = _1.ElevaError.conflict({ details: conflictDetails });
+            expect(error.code).toBe(_1.ERROR_CODES.CONFLICT);
+            expect(error.details).toEqual(conflictDetails);
+        });
+        it('simple factories use catalog defaults with no args', () => {
+            expect(_1.ElevaError.badRequest().code).toBe(_1.ERROR_CODES.BAD_REQUEST);
+            expect(_1.ElevaError.authentication().code).toBe(_1.ERROR_CODES.AUTHENTICATION);
+            expect(_1.ElevaError.unauthorized().code).toBe(_1.ERROR_CODES.UNAUTHORIZED);
+            expect(_1.ElevaError.notAcceptable().code).toBe(_1.ERROR_CODES.NOT_ACCEPTABLE);
+            expect(_1.ElevaError.gone().code).toBe(_1.ERROR_CODES.GONE);
+            expect(_1.ElevaError.unprocessableEntity().code).toBe(_1.ERROR_CODES.UNPROCESSABLE_ENTITY);
+            expect(_1.ElevaError.serviceUnavailable().code).toBe(_1.ERROR_CODES.SERVICE_UNAVAILABLE);
+        });
+        it('unprocessableEntity() carries optional structured details', () => {
+            const error = _1.ElevaError.unprocessableEntity({ details: { field: 'email', reason: 'already_taken' } });
+            expect(error.code).toBe(_1.ERROR_CODES.UNPROCESSABLE_ENTITY);
+            expect(error.status).toBe(422);
+            expect(error.details).toEqual({ field: 'email', reason: 'already_taken' });
+        });
+        it('simple factories accept message and details', () => {
+            const error = _1.ElevaError.unauthorized({
+                message: 'Forbidden',
+                details: { requiredScope: 'admin', resource: 'users' },
+            });
+            expect(error.message).toBe('Forbidden');
+            expect(error.details).toEqual({ requiredScope: 'admin', resource: 'users' });
+        });
+        it('badRequest() carries optional structured details', () => {
+            const error = _1.ElevaError.badRequest({ details: { field: 'id', reason: 'required' } });
+            expect(error.code).toBe(_1.ERROR_CODES.BAD_REQUEST);
+            expect(error.details).toEqual({ field: 'id', reason: 'required' });
+        });
+        it('mandatoryField() builds a MANDATORY_FIELD error with field', () => {
+            const error = _1.ElevaError.mandatoryField({ field: 'agentId' });
+            expect(error.code).toBe(_1.ERROR_CODES.MANDATORY_FIELD);
+            expect(error.status).toBe(400);
+            expect(error.details).toEqual({ field: 'agentId' });
+        });
+        it('mandatoryField() accepts a custom message', () => {
+            const error = _1.ElevaError.mandatoryField({ field: 'permissions', message: 'permissions is required' });
+            expect(error.message).toBe('permissions is required');
+            expect(error.details).toEqual({ field: 'permissions' });
+        });
+        it('internal() propagates the cause', () => {
+            const cause = new Error('db down');
+            const error = _1.ElevaError.internal({ cause });
+            expect(error.code).toBe(_1.ERROR_CODES.INTERNAL_SERVER_ERROR);
+            expect(error.cause).toBe(cause);
+        });
+    });
+});
+//# sourceMappingURL=errors.spec.js.map

package/dist/cjs/src/errors/errors.spec.js.map

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

package/dist/cjs/src/errors/errors_remote.d.ts

@@ -0,0 +1,67 @@
+import { ElevaError, ElevaErrorArgs, ElevaErrorJSON } from './errors';
+import { ErrorCode } from './catalog';
+/**
+ * Context about the outgoing call that triggered a remote error. All fields are optional.
+ * `M` types the transport-level `metadata` (e.g. `Record<string, string>` for HTTP headers).
+ */
+export type RemoteRequest<M extends Record<string, unknown> = Record<string, unknown>> = {
+    /** Operation type or name (e.g. HTTP method, gRPC method, message type). */
+    operation?: string;
+    /** Target resource identifier (e.g. URL path, topic name, procedure). */
+    resource?: string;
+    /** Transport-level metadata sent with the call (e.g. HTTP headers, gRPC metadata). */
+    metadata?: M;
+    /** Data sent with the call (request body, message payload, etc.). */
+    payload?: unknown;
+};
+/**
+ * Context about the response received from a remote call. All fields are optional.
+ * `M` types the transport-level `metadata` (e.g. `Record<string, string>` for HTTP headers).
+ */
+export type RemoteResponse<M extends Record<string, unknown> = Record<string, unknown>> = {
+    /** Status code returned by the remote system (e.g. HTTP status, gRPC status). */
+    statusCode?: number;
+    /** Transport-level metadata received with the response (e.g. HTTP response headers). */
+    metadata?: M;
+    /** Data received from the remote system. */
+    payload?: unknown;
+};
+/** `ElevaErrorJSON` extended with the originating remote call context. */
+export type RemoteElevaErrorJSON<C extends ErrorCode = ErrorCode, ReqM extends Record<string, unknown> = Record<string, unknown>, ResM extends Record<string, unknown> = Record<string, unknown>> = ElevaErrorJSON<C> & {
+    request: RemoteRequest<ReqM>;
+    response: RemoteResponse<ResM>;
+};
+/**
+ * An `ElevaError` enriched with the context of a failed remote call.
+ * Not tied to HTTP — covers any outbound call (HTTP, gRPC, message queues, etc.)
+ * where capturing the outgoing request and incoming response aids debugging.
+ *
+ * `ReqM` / `ResM` type the transport metadata for the request and response respectively;
+ * both default to `Record<string, unknown>` for untyped usage.
+ *
+ * @example
+ * type HttpHeaders = Record<string, string>
+ * const err = RemoteElevaError.from<ErrorCode, HttpHeaders, HttpHeaders>(body, req, res)
+ * err.request.metadata?.['authorization'] // string
+ */
+export declare class RemoteElevaError<C extends ErrorCode = ErrorCode, ReqM extends Record<string, unknown> = Record<string, unknown>, ResM extends Record<string, unknown> = Record<string, unknown>> extends ElevaError<C> {
+    /** Context about the outgoing call that produced this error. */
+    readonly request: RemoteRequest<ReqM>;
+    /** Context about the response that contained or triggered the error. */
+    readonly response: RemoteResponse<ResM>;
+    constructor(args: ElevaErrorArgs<C> & {
+        request: RemoteRequest<ReqM>;
+        response: RemoteResponse<ResM>;
+    });
+    /** Full serialisation including remote call request and response context. */
+    toJSON(): RemoteElevaErrorJSON<C, ReqM, ResM>;
+    /** Narrows to `RemoteElevaError<K, ReqM, ResM>`, preserving metadata types on the narrowed type. */
+    is<K extends ErrorCode>(code: K | string): this is RemoteElevaError<K, ReqM, ResM>;
+    /**
+     * Builds a `RemoteElevaError` from a raw response payload and remote call context.
+     * Delegates payload parsing to `ElevaError._parsePayload()`; malformed payloads become `INTERNAL_SERVER_ERROR`.
+     * `cause` takes precedence over any cause inferred from the payload.
+     */
+    static from<ReqM extends Record<string, unknown> = Record<string, unknown>, ResM extends Record<string, unknown> = Record<string, unknown>>(body: unknown, request: RemoteRequest<ReqM>, response: RemoteResponse<ResM>, cause?: unknown): RemoteElevaError<ErrorCode, ReqM, ResM>;
+}
+//# sourceMappingURL=errors_remote.d.ts.map

package/dist/cjs/src/errors/errors_remote.d.ts.map

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