@eleva-io/erp-sdk 0.1.152 → 0.1.153

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

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

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

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

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

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

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

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

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

@@ -1,173 +0,0 @@
-import { z } from 'zod';
-import { ErrorCode, type ErrorDetails } from './catalog';
-import { ErrorKind } from './catalog_types';
-import { BASE_ERROR_CODES } from './catalog_base';
-import { API_ERROR_CODES } from './catalog_api';
-/** Plain-object representation of an `ElevaError`, suitable for serialisation. */
-export interface ElevaErrorJSON<C extends ErrorCode = ErrorCode> {
-    code: C | string;
-    kind: ErrorKind;
-    status: number;
-    message: string;
-    details: ErrorDetails<C>;
-}
-/**
- * Slim response payload for API consumers.
- * `SYSTEM` errors omit `details`; `DOMAIN` errors include it.
- */
-export interface ElevaErrorResponse<C extends ErrorCode = ErrorCode> {
-    code: ElevaErrorJSON<C>['code'];
-    message: ElevaErrorJSON<C>['message'];
-    details?: ElevaErrorJSON<C>['details'];
-}
-/** Constructor arguments for `ElevaError`. Adds optional `cause` for error chaining. */
-export type ElevaErrorArgs<C extends ErrorCode> = ElevaErrorJSON<C> & {
-    /** The original error forwarded to `Error.cause`. */
-    cause?: unknown;
-};
-/**
- * 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.
- */
-export declare class ElevaError<C extends ErrorCode = ErrorCode> extends Error {
-    /** Error code constant identifying the failure condition. */
-    readonly code: C | string;
-    /** `DOMAIN` (safe to expose) or `SYSTEM` (sanitised before sending to clients). */
-    readonly kind: ErrorKind;
-    /** HTTP status code for this error. */
-    readonly status: number;
-    /** Structured, code-specific failure context. */
-    readonly details: ErrorDetails<C>;
-    constructor(args: ElevaErrorArgs<C>);
-    /**
-     * 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<K extends ErrorCode>(code: K | string): this is ElevaError<K>;
-    /** Full serialised representation for logging / diagnostics. */
-    toJSON(): ElevaErrorJSON<C>;
-    toString(): string;
-    /**
-     * Sanitised payload safe for API responses.
-     * `SYSTEM` errors replace the message with a generic string; `DOMAIN` errors include `details`.
-     */
-    toResponse(): ElevaErrorResponse<C>;
-    /**
-     * 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`.
-     */
-    protected static _parsePayload(value: unknown): ElevaErrorArgs<ErrorCode>;
-    /** Deserialises an unknown value into an `ElevaError`. Unrecognised payloads become `INTERNAL_SERVER_ERROR`. */
-    static parse(value: unknown): ElevaError<ErrorCode>;
-    /** Converts a `ZodError` into a `VALIDATION` error, preserving field paths and rule codes. */
-    static fromZodError<T>(error: z.ZodError<T>): ElevaError<BASE_ERROR_CODES.VALIDATION>;
-    /** Creates a `VALIDATION` error from a pre-built array of issue descriptors. */
-    static validation(args: {
-        errors: ErrorDetails<BASE_ERROR_CODES.VALIDATION>['errors'];
-        message?: string;
-    }): ElevaError<BASE_ERROR_CODES.VALIDATION>;
-    /** Creates a `VALIDATION` error for a single invalid field. Convenience wrapper around `validation()`. */
-    static invalidField(args: {
-        error: ErrorDetails<BASE_ERROR_CODES.VALIDATION>['errors'][number];
-        message?: string;
-    }): ElevaError<BASE_ERROR_CODES.VALIDATION>;
-    /** HTTP 400 — request is malformed or has invalid parameters outside of validation. */
-    static readonly badRequest: (args?: {
-        message?: string;
-        details?: any;
-    } | undefined) => ElevaError<BASE_ERROR_CODES.BAD_REQUEST>;
-    /** HTTP 401 — credentials are missing, expired, or invalid. Caller must re-authenticate. */
-    static readonly authentication: (args?: {
-        message?: string;
-        details?: any;
-    } | undefined) => ElevaError<BASE_ERROR_CODES.AUTHENTICATION>;
-    /** HTTP 403 — authenticated but lacks the required scope or permission. */
-    static readonly unauthorized: (args?: {
-        message?: string;
-        details?: any;
-    } | undefined) => ElevaError<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 readonly notFound: (args: Record<"entity", string> & {
-        message?: string;
-    }) => ElevaError<BASE_ERROR_CODES.NOT_FOUND>;
-    /** HTTP 406 — server cannot produce a response matching the `Accept` header. */
-    static readonly notAcceptable: (args?: {
-        message?: string;
-        details?: any;
-    } | undefined) => ElevaError<BASE_ERROR_CODES.NOT_ACCEPTABLE>;
-    /** HTTP 409 — operation violates a uniqueness or integrity constraint. */
-    static readonly conflict: (args: {
-        details: z.infer<Cat[C_1]["details"]>;
-        message?: string;
-    }) => ElevaError<BASE_ERROR_CODES.CONFLICT>;
-    /** HTTP 410 — resource permanently removed; retrying will never succeed. */
-    static readonly gone: (args?: {
-        message?: string;
-        details?: any;
-    } | undefined) => ElevaError<BASE_ERROR_CODES.GONE>;
-    /** HTTP 422 — request is syntactically valid but semantically unprocessable. */
-    static readonly unprocessableEntity: (args?: {
-        message?: string;
-        details?: any;
-    } | undefined) => ElevaError<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 readonly badGateway: (args?: {
-        message?: string;
-        details?: any;
-    } | undefined) => ElevaError<BASE_ERROR_CODES.BAD_GATEWAY>;
-    /** HTTP 503 — service temporarily unavailable (`SYSTEM`). Pass `retryAfter` (seconds) if known. */
-    static readonly serviceUnavailable: (args?: {
-        message?: string;
-        details?: any;
-    } | undefined) => ElevaError<BASE_ERROR_CODES.SERVICE_UNAVAILABLE>;
-    /**
-     * HTTP 400 — a required field was missing from the request.
-     * @param args.field - Name of the missing field.
-     */
-    static readonly mandatoryField: (args: Record<"field", string> & {
-        message?: string;
-    }) => ElevaError<BASE_ERROR_CODES.MANDATORY_FIELD>;
-    /**
-     * HTTP 500 — unexpected server error (`SYSTEM`).
-     * Pass the original exception as `cause` to preserve the full stack chain for logging.
-     */
-    static internal(args?: {
-        message?: string;
-        cause?: unknown;
-        details?: ErrorDetails<BASE_ERROR_CODES.INTERNAL_SERVER_ERROR>;
-    }): ElevaError<BASE_ERROR_CODES.INTERNAL_SERVER_ERROR>;
-    /**
-     * HTTP 403 — caller is not authorised to access the given contact person.
-     * @param args.details.contactId - UUID of the blocked contact.
-     */
-    static readonly forbiddenContact: (args: {
-        details: z.infer<Cat[C_1]["details"]>;
-        message?: string;
-    }) => ElevaError<API_ERROR_CODES>;
-}
-//# sourceMappingURL=errors.d.ts.map

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

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

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

@@ -1,247 +0,0 @@
-"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

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

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

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

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

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