@eleva-io/erp-sdk 0.1.154 → 0.1.156

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":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACvF,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,CAAC,CAAA;IACZ,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACxF,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,CAAC,CAAA;IACZ,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,0EAA0E;AAC1E,MAAM,MAAM,oBAAoB,CAC9B,CAAC,SAAS,SAAS,GAAG,SAAS,EAC/B,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAC5D,cAAc,CAAC,CAAC,CAAC,GAAG;IACtB,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,CAAA;IAC5B,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,CAAA;CAC/B,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB,CAC3B,CAAC,SAAS,SAAS,GAAG,SAAS,EAC/B,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC9D,SAAQ,UAAU,CAAC,CAAC,CAAC;IACrB,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,CAAA;IAErC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,CAAA;gBAE3B,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;QAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,CAAA;KAAE;IAOtG,6EAA6E;IAC7E,MAAM,IAAI,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC;IAQ7C,oGAAoG;IACpG,EAAE,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,IAAI,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC;IAIlF;;;;OAIG;IACH,MAAM,CAAC,IAAI,CACT,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAE9D,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,EAC5B,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,EAC9B,KAAK,CAAC,EAAE,OAAO,GACd,gBAAgB,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC;CAK3C"}

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

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoteElevaError = void 0;
+const errors_1 = require("./errors");
+/**
+ * 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
+ */
+class RemoteElevaError extends errors_1.ElevaError {
+    /** Context about the outgoing call that produced this error. */
+    request;
+    /** Context about the response that contained or triggered the error. */
+    response;
+    constructor(args) {
+        super(args);
+        this.name = 'RemoteElevaError';
+        this.request = args.request;
+        this.response = args.response;
+    }
+    /** Full serialisation including remote call request and response context. */
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            request: this.request,
+            response: this.response,
+        };
+    }
+    /** Narrows to `RemoteElevaError<K, ReqM, ResM>`, preserving metadata types on the narrowed type. */
+    is(code) {
+        return super.is(code);
+    }
+    /**
+     * 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(body, request, response, cause) {
+        const parsed = errors_1.ElevaError._parsePayload(body);
+        return new RemoteElevaError({ ...parsed, cause: cause ?? parsed.cause, request, response });
+    }
+}
+exports.RemoteElevaError = RemoteElevaError;
+//# sourceMappingURL=errors_remote.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors_remote.js","sourceRoot":"","sources":["../../../../src/errors/errors_remote.ts"],"names":[],"mappings":";;;AAAA,qCAAqE;AAyCrE;;;;;;;;;;;;GAYG;AACH,MAAa,gBAIX,SAAQ,mBAAa;IACrB,gEAAgE;IACvD,OAAO,CAAqB;IAErC,wEAAwE;IAC/D,QAAQ,CAAsB;IAEvC,YAAY,IAA0F;QACpG,KAAK,CAAC,IAAI,CAAC,CAAA;QACX,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;IAC/B,CAAC;IAED,6EAA6E;IAC7E,MAAM;QACJ,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAA;IACH,CAAC;IAED,oGAAoG;IACpG,EAAE,CAAsB,IAAgB;QACtC,OAAO,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAIT,IAAa,EACb,OAA4B,EAC5B,QAA8B,EAC9B,KAAe;QAEf,MAAM,MAAM,GAAG,mBAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;QAE7C,OAAO,IAAI,gBAAgB,CAAwB,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;IACpH,CAAC;CACF;AAlDD,4CAkDC"}

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

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

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

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

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

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const _1 = require(".");
+const errors_remote_1 = require("./errors_remote");
+const request = {
+    operation: 'GET',
+    metadata: { authorization: 'Bearer token' },
+    resource: '/api/users/1',
+    payload: undefined,
+};
+const response = {
+    statusCode: 404,
+    metadata: { 'content-type': 'application/json' },
+    payload: { code: 'NOT_FOUND', message: 'Not found', kind: 'domain', status: 404 },
+};
+const validBody = {
+    code: _1.ERROR_CODES.NOT_FOUND,
+    kind: _1.ErrorKind.DOMAIN,
+    status: 404,
+    message: 'User not found',
+    details: { entity: 'User' },
+};
+describe('RemoteElevaError', () => {
+    describe('constructor', () => {
+        it('is an instance of Error, ElevaError and RemoteElevaError', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: _1.ERROR_CODES.INTERNAL_SERVER_ERROR }, request, response);
+            expect(error).toBeInstanceOf(Error);
+            expect(error).toBeInstanceOf(_1.ElevaError);
+            expect(error).toBeInstanceOf(errors_remote_1.RemoteElevaError);
+        });
+        it('sets name to "RemoteElevaError"', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: _1.ERROR_CODES.INTERNAL_SERVER_ERROR }, request, response);
+            expect(error.name).toBe('RemoteElevaError');
+        });
+        it('exposes request and response as readonly properties', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: _1.ERROR_CODES.INTERNAL_SERVER_ERROR }, request, response);
+            expect(error.request).toBe(request);
+            expect(error.response).toBe(response);
+        });
+        it('inherits code, kind, status and message from the catalog', () => {
+            const error = errors_remote_1.RemoteElevaError.from({
+                code: _1.ERROR_CODES.NOT_FOUND,
+            }, request, response);
+            expect(error.code).toBe(_1.ERROR_CODES.NOT_FOUND);
+            expect(error.kind).toBe(_1.ErrorKind.DOMAIN);
+            expect(error.status).toBe(404);
+        });
+        it('forwards cause to the underlying Error', () => {
+            const cause = new Error('network timeout');
+            const error = errors_remote_1.RemoteElevaError.from({ code: _1.ERROR_CODES.INTERNAL_SERVER_ERROR }, request, response, cause);
+            expect(error.cause).toBe(cause);
+        });
+    });
+    describe('is()', () => {
+        it('returns true when the code matches', () => {
+            const error = errors_remote_1.RemoteElevaError.from({
+                code: _1.ERROR_CODES.NOT_FOUND,
+            }, request, response);
+            expect(error.is(_1.ERROR_CODES.NOT_FOUND)).toBe(true);
+        });
+        it('returns false when the code does not match', () => {
+            const error = errors_remote_1.RemoteElevaError.from({
+                code: _1.ERROR_CODES.NOT_FOUND,
+            }, request, response);
+            expect(error.is(_1.ERROR_CODES.CONFLICT)).toBe(false);
+        });
+        it('narrows details to the matching code', () => {
+            const err = errors_remote_1.RemoteElevaError.from({
+                code: _1.ERROR_CODES.NOT_FOUND,
+                details: { entity: 'User' },
+            }, request, response);
+            const entity = err.is(_1.ERROR_CODES.NOT_FOUND) ? err.details.entity : null;
+            expect(entity).toBe('User');
+        });
+        it('preserves request and response on the narrowed type', () => {
+            const err = errors_remote_1.RemoteElevaError.from({
+                code: _1.ERROR_CODES.NOT_FOUND,
+                details: { entity: 'User' },
+            }, request, response);
+            expect(err.is(_1.ERROR_CODES.NOT_FOUND)).toBe(true);
+            expect(err.request).toBe(request);
+            expect(err.response).toBe(response);
+            expect(err.details).toEqual({ entity: 'User' });
+        });
+        it('narrows correctly on a union-typed error', () => {
+            const err = errors_remote_1.RemoteElevaError.from(validBody, request, response);
+            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 = errors_remote_1.RemoteElevaError.from({ code: _1.ERROR_CODES.NOT_FOUND }, request, response);
+            expect(error.is('NOT_FOUND')).toBe(true);
+        });
+        it('returns false when a plain string does not match the code', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: _1.ERROR_CODES.NOT_FOUND }, request, response);
+            expect(error.is('CONFLICT')).toBe(false);
+        });
+    });
+    describe('toJSON()', () => {
+        it('includes all ElevaError fields plus request and response', () => {
+            const error = errors_remote_1.RemoteElevaError.from({
+                code: _1.ERROR_CODES.NOT_FOUND,
+                details: { entity: 'User' },
+            }, request, response);
+            const json = error.toJSON();
+            expect(json.code).toBe(_1.ERROR_CODES.NOT_FOUND);
+            expect(json.kind).toBe(_1.ErrorKind.DOMAIN);
+            expect(json.status).toBe(404);
+            expect(json.details).toEqual({ entity: 'User' });
+            expect(json.request).toBe(request);
+            expect(json.response).toBe(response);
+        });
+        it('toString serializes request and response', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: _1.ERROR_CODES.INTERNAL_SERVER_ERROR }, request, response);
+            const parsed = JSON.parse(error.toString());
+            expect(parsed.request.resource).toBe('/api/users/1');
+            expect(parsed.response.statusCode).toBe(404);
+        });
+    });
+    describe('from()', () => {
+        it('constructs a RemoteElevaError instance (not just ElevaError)', () => {
+            const error = errors_remote_1.RemoteElevaError.from(validBody, request, response);
+            expect(error).toBeInstanceOf(errors_remote_1.RemoteElevaError);
+            expect(error).toBeInstanceOf(_1.ElevaError);
+            expect(error.name).toBe('RemoteElevaError');
+        });
+        it('parses the body and sets code, message and details correctly', () => {
+            const error = errors_remote_1.RemoteElevaError.from(validBody, request, response);
+            expect(error.code).toBe(_1.ERROR_CODES.NOT_FOUND);
+            expect(error.message).toBe('User not found');
+        });
+        it('attaches request and response context', () => {
+            const error = errors_remote_1.RemoteElevaError.from(validBody, request, response);
+            expect(error.request).toBe(request);
+            expect(error.response).toBe(response);
+        });
+        it('uses the provided cause', () => {
+            const cause = new Error('axios error');
+            const error = errors_remote_1.RemoteElevaError.from(validBody, request, response, cause);
+            expect(error.cause).toBe(cause);
+        });
+        it('falls back to INTERNAL_SERVER_ERROR when body is malformed', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ unexpected: true }, request, response);
+            expect(error.code).toBe(_1.ERROR_CODES.INTERNAL_SERVER_ERROR);
+            expect(error.message).toMatch(/^Failed to parse error payload:/);
+        });
+        it('uses the raw body as cause when body is malformed and no cause is provided', () => {
+            const body = 'not a valid error';
+            const error = errors_remote_1.RemoteElevaError.from(body, request, response);
+            expect(error.cause).toBe(body);
+        });
+        it('prefers the provided cause over the parsed cause on malformed body', () => {
+            const axiosCause = new Error('axios');
+            const error = errors_remote_1.RemoteElevaError.from('bad body', request, response, axiosCause);
+            expect(error.cause).toBe(axiosCause);
+        });
+        it('toJSON() includes request and response after from()', () => {
+            const error = errors_remote_1.RemoteElevaError.from(validBody, request, response);
+            const json = error.toJSON();
+            expect(json.request).toBe(request);
+            expect(json.response).toBe(response);
+        });
+    });
+    describe('custom / vendor-specific error codes', () => {
+        it('preserves an unknown code string verbatim', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: 'RATE_LIMIT', status: 429, message: 'Too many requests', kind: 'domain' }, request, response);
+            expect(error.code).toBe('RATE_LIMIT');
+        });
+        it('is() returns true for the custom code string', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: 'RATE_LIMIT', status: 429, message: 'Too many requests', kind: 'domain' }, request, response);
+            expect(error.is('RATE_LIMIT')).toBe(true);
+        });
+        it('is() returns false for a different custom code string', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: 'RATE_LIMIT', status: 429, message: 'Too many requests', kind: 'domain' }, request, response);
+            expect(error.is('QUOTA_EXCEEDED')).toBe(false);
+        });
+        it('uses status and kind from the body when both are valid', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: 'RATE_LIMIT', status: 429, message: 'Too many requests', kind: 'domain' }, request, response);
+            expect(error.status).toBe(429);
+            expect(error.kind).toBe(_1.ErrorKind.DOMAIN);
+        });
+        it('falls back to INTERNAL_SERVER_ERROR status and kind when they are absent', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: 'UNKNOWN_VENDOR_CODE', message: 'Something broke' }, request, response);
+            expect(error.code).toBe('UNKNOWN_VENDOR_CODE');
+            expect(error.status).toBe(500);
+            expect(error.kind).toBe(_1.ErrorKind.SYSTEM);
+        });
+        it('preserves the message from the body', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: 'RATE_LIMIT', status: 429, message: 'Retry after 60 s', kind: 'domain' }, request, response);
+            expect(error.message).toBe('Retry after 60 s');
+        });
+        it('preserves details from the body', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: 'RATE_LIMIT', status: 429, kind: 'domain', details: { retryAfter: 60 } }, request, response);
+            expect(error.details.retryAfter).toBe(60);
+        });
+        it('toJSON() includes the custom code, request and response', () => {
+            const error = errors_remote_1.RemoteElevaError.from({ code: 'RATE_LIMIT', status: 429, message: 'Too many requests', kind: 'domain' }, request, response);
+            const json = error.toJSON();
+            expect(json.code).toBe('RATE_LIMIT');
+            expect(json.request).toBe(request);
+            expect(json.response).toBe(response);
+        });
+    });
+});
+//# sourceMappingURL=errors_remote.spec.js.map