@beemafrica/error-definitions 1.0.1

package/README.md

@@ -0,0 +1,72 @@
+## Error Definitions (BeemM)
+
+This package provides canonical error codes and helpers for building consistent error responses across services.
+
+## Start here
+
+- **Consumer guide**: see `CONSUMER_GUIDE.md` for real-world usage patterns (API boundaries, middleware, service-to-service errors, dependency failures, and expected response shapes).
+
+## Quick start
+
+Create/throw canonical errors in your service code:
+
+```ts
+import { createError } from "error-definitions";
+
+throw createError("API_INVALID_REQUEST_FORMAT", {
+  context: { source: "request-body" },
+  traceId,
+});
+```
+
+Normalize any unknown error at the boundary (and use `status_code` as the HTTP status):
+
+```ts
+import { toErrorResponse } from "error-definitions";
+
+const payload = toErrorResponse(err, { traceId });
+res.status(payload.status_code).json(payload);
+```
+
+## CommonJS support (`require`)
+
+This package supports both ESM and CommonJS consumers.
+
+```js
+// CommonJS
+const { createError, ServiceId } = require("error-definitions");
+```
+
+## Dependency tracking
+
+`BMErrorResponse` supports an optional `dependency` object to capture **what dependency failed** and the **raw dependency error**:
+
+- **name**: e.g. `Redis`, `Stripe`, `RabbitMQ`
+- **type**: `INTERNAL` | `EXTERNAL`
+- **original_message**: raw message from the caught error
+
+### Which code should I use?
+
+- **INFRASTRUCTURE_FAILURE**: internal tools/infrastructure dependencies (e.g. Redis, RabbitMQ)
+- **THIRD_PARTY_ERROR**: external vendors/providers (e.g. Stripe)
+
+### Helper: `handleDependencyError`
+
+Use `handleDependencyError` inside a `try/catch` to convert a raw dependency exception into a `BMErrorResponse` with the correct canonical code and populated `dependency.original_message`.
+
+Example:
+
+```ts
+import { handleDependencyError, ServiceId } from "error-definitions";
+
+try {
+  await stripe.charges.create(...);
+} catch (err) {
+  return handleDependencyError(
+    ServiceId.Payments,
+    { name: "Stripe", type: "EXTERNAL" },
+    err,
+    { trace_id }
+  );
+}
+```

package/dist/definitions.d.ts

@@ -0,0 +1,4 @@
+import type { CanonicalErrorCode, ErrorDefinition } from "./types/index.js";
+export declare const ERROR_DEFINITIONS: Readonly<Record<CanonicalErrorCode, ErrorDefinition>>;
+export declare function getErrorDefinition(code: CanonicalErrorCode): ErrorDefinition;
+//# sourceMappingURL=definitions.d.ts.map

package/dist/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE5E,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,eAAe,CAAC,CA2UnF,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,eAAe,CAE5E"}

package/dist/definitions.js

@@ -0,0 +1,327 @@
+export const ERROR_DEFINITIONS = {
+    INTERNAL_ERROR: {
+        code: "INTERNAL_ERROR",
+        httpStatus: 500,
+        retryable: false,
+        defaultMessage: "Unexpected server error.",
+    },
+    INVALID_ARGUMENT: {
+        code: "INVALID_ARGUMENT",
+        httpStatus: 400,
+        retryable: false,
+        defaultMessage: "Invalid argument.",
+    },
+    SERVICE_FAILURE: {
+        code: "SERVICE_FAILURE",
+        httpStatus: 500,
+        retryable: true,
+        defaultMessage: "Service failed to process the request.",
+    },
+    // UI Errors
+    UI_INVALID_INPUT: {
+        code: "UI_INVALID_INPUT",
+        httpStatus: 400,
+        retryable: false,
+        defaultMessage: "Input provided is invalid.",
+    },
+    UI_REQUIRED_FIELD_MISSING: {
+        code: "UI_REQUIRED_FIELD_MISSING",
+        httpStatus: 400,
+        retryable: false,
+        defaultMessage: "A required field is missing.",
+    },
+    UI_INVALID_FORMAT: {
+        code: "UI_INVALID_FORMAT",
+        httpStatus: 400,
+        retryable: false,
+        defaultMessage: "Input format is incorrect.",
+    },
+    UI_FILE_TOO_LARGE: {
+        code: "UI_FILE_TOO_LARGE",
+        httpStatus: 413,
+        retryable: false,
+        defaultMessage: "Uploaded file exceeds size limit.",
+    },
+    UI_UNSUPPORTED_FILE_TYPE: {
+        code: "UI_UNSUPPORTED_FILE_TYPE",
+        httpStatus: 415,
+        retryable: false,
+        defaultMessage: "File type is not supported.",
+    },
+    UI_STALE_STATE: {
+        code: "UI_STALE_STATE",
+        httpStatus: 409,
+        retryable: false,
+        defaultMessage: "UI state is outdated; refresh required.",
+    },
+    UI_ACTION_NOT_AVAILABLE: {
+        code: "UI_ACTION_NOT_AVAILABLE",
+        httpStatus: 403,
+        retryable: false,
+        defaultMessage: "Action is not allowed in current state.",
+    },
+    UI_DUPLICATE_SUBMISSION: {
+        code: "UI_DUPLICATE_SUBMISSION",
+        httpStatus: 409,
+        retryable: false,
+        defaultMessage: "Duplicate submission detected.",
+    },
+    UI_RENDER_ERROR: {
+        code: "UI_RENDER_ERROR",
+        httpStatus: 500,
+        retryable: false,
+        defaultMessage: "UI failed to render correctly.",
+    },
+    UI_ASSET_LOAD_FAILED: {
+        code: "UI_ASSET_LOAD_FAILED",
+        httpStatus: 500,
+        retryable: false,
+        defaultMessage: "Required asset failed to load.",
+    },
+    UI_TRANSLATION_MISSING: {
+        code: "UI_TRANSLATION_MISSING",
+        httpStatus: 500,
+        retryable: false,
+        defaultMessage: "Missing translation resource.",
+    },
+    // API Errors - Validation Errors
+    API_INVALID_PARAMETER: {
+        code: "API_INVALID_PARAMETER",
+        httpStatus: 400,
+        retryable: true,
+        defaultMessage: "Parameter value invalid.",
+    },
+    API_REQUIRED_PARAMETER_MISSING: {
+        code: "API_REQUIRED_PARAMETER_MISSING",
+        httpStatus: 400,
+        retryable: true,
+        defaultMessage: "Required parameter missing.",
+    },
+    API_INVALID_REQUEST_FORMAT: {
+        code: "API_INVALID_REQUEST_FORMAT",
+        httpStatus: 400,
+        retryable: true,
+        defaultMessage: "Request format is invalid.",
+    },
+    API_SCHEMA_VALIDATION_FAILED: {
+        code: "API_SCHEMA_VALIDATION_FAILED",
+        httpStatus: 400,
+        retryable: true,
+        defaultMessage: "Request schema validation failed.",
+    },
+    API_TOO_MANY_ITEMS: {
+        code: "API_TOO_MANY_ITEMS",
+        httpStatus: 429,
+        retryable: true,
+        defaultMessage: "Request contains too many items.",
+    },
+    API_FIELD_TOO_LONG: {
+        code: "API_FIELD_TOO_LONG",
+        httpStatus: 400,
+        retryable: true,
+        defaultMessage: "Field exceeds maximum length.",
+    },
+    API_UNSUPPORTED_VALUE: {
+        code: "API_UNSUPPORTED_VALUE",
+        httpStatus: 400,
+        retryable: true,
+        defaultMessage: "Parameter contains an unsupported value.",
+    },
+    // API Errors - Authentication Errors
+    AUTH_MISSING_CREDENTIALS: {
+        code: "AUTH_MISSING_CREDENTIALS",
+        httpStatus: 401,
+        retryable: true,
+        defaultMessage: "Required credentials missing.",
+    },
+    AUTH_INVALID_CREDENTIALS: {
+        code: "AUTH_INVALID_CREDENTIALS",
+        httpStatus: 401,
+        retryable: true,
+        defaultMessage: "Credentials invalid.",
+    },
+    AUTH_FORBIDDEN: {
+        code: "AUTH_FORBIDDEN",
+        httpStatus: 403,
+        retryable: true,
+        defaultMessage: "Access forbidden.",
+    },
+    AUTH_INSUFFICIENT_PERMISSIONS: {
+        code: "AUTH_INSUFFICIENT_PERMISSIONS",
+        httpStatus: 403,
+        retryable: true,
+        defaultMessage: "Not enough permissions.",
+    },
+    AUTH_TOKEN_EXPIRED: {
+        code: "AUTH_TOKEN_EXPIRED",
+        httpStatus: 401,
+        retryable: true,
+        defaultMessage: "Auth token expired.",
+    },
+    // API Errors - Business Logic Errors
+    DOMAIN_INCORRECT_PIN: {
+        code: "DOMAIN_INCORRECT_PIN",
+        httpStatus: 400,
+        retryable: true,
+        defaultMessage: "OTP Pin is incorrect.",
+    },
+    DOMAIN_PIN_EXPIRED: {
+        code: "DOMAIN_PIN_EXPIRED",
+        httpStatus: 400,
+        retryable: true,
+        defaultMessage: "OTP Pin expired.",
+    },
+    DOMAIN_OTP_ATTEMPTS_EXCEEDED: {
+        code: "DOMAIN_OTP_ATTEMPTS_EXCEEDED",
+        httpStatus: 429,
+        retryable: true,
+        defaultMessage: "OTP attempts exceeded.",
+    },
+    DOMAIN_DUPLICATE_PIN: {
+        code: "DOMAIN_DUPLICATE_PIN",
+        httpStatus: 409,
+        retryable: true,
+        defaultMessage: "OTP Pin already used.",
+    },
+    DOMAIN_INVALID_SCHEDULE_TIME: {
+        code: "DOMAIN_INVALID_SCHEDULE_TIME",
+        httpStatus: 400,
+        retryable: true,
+        defaultMessage: "Scheduled time invalid.",
+    },
+    DOMAIN_RESOURCE_CONFLICT: {
+        code: "DOMAIN_RESOURCE_CONFLICT",
+        httpStatus: 409,
+        retryable: true,
+        defaultMessage: "Resource conflict detected.",
+    },
+    DOMAIN_RESOURCE_NOT_FOUND: {
+        code: "DOMAIN_RESOURCE_NOT_FOUND",
+        httpStatus: 404,
+        retryable: true,
+        defaultMessage: "Resource not found.",
+    },
+    // API Errors - Dependency & Integration Errors
+    DEPENDENCY_FAILURE: {
+        code: "DEPENDENCY_FAILURE",
+        httpStatus: 502,
+        retryable: true,
+        defaultMessage: "A required downstream service is down.",
+    },
+    DEPENDENCY_TIMEOUT: {
+        code: "DEPENDENCY_TIMEOUT",
+        httpStatus: 504,
+        retryable: true,
+        defaultMessage: "Downstream service responded too slowly.",
+    },
+    INFRASTRUCTURE_FAILURE: {
+        code: "INFRASTRUCTURE_FAILURE",
+        httpStatus: 503,
+        retryable: true,
+        defaultMessage: "An internal infrastructure dependency failed.",
+    },
+    THIRD_PARTY_ERROR: {
+        code: "THIRD_PARTY_ERROR",
+        httpStatus: 502,
+        retryable: true,
+        defaultMessage: "A third-party provider returned an error.",
+    },
+    UPSTREAM_ERROR: {
+        code: "UPSTREAM_ERROR",
+        httpStatus: 502,
+        retryable: false,
+        defaultMessage: "Downstream service returned an invalid response.",
+    },
+    // API Errors - Rate Limiting Errors
+    RESOURCE_EXHAUSTED: {
+        code: "RESOURCE_EXHAUSTED",
+        httpStatus: 429,
+        retryable: true,
+        defaultMessage: "User has hit their rate limit.",
+    },
+    QUOTA_EXCEEDED: {
+        code: "QUOTA_EXCEEDED",
+        httpStatus: 403,
+        retryable: false,
+        defaultMessage: "Monthly billing limit reached.",
+    },
+    SERVER_OVERLOAD: {
+        code: "SERVER_OVERLOAD",
+        httpStatus: 503,
+        retryable: true,
+        defaultMessage: "System is too busy to handle the request; back off immediately.",
+    },
+    // API Errors - Concurrency & State Errors
+    CONCURRENCY_CONFLICT: {
+        code: "CONCURRENCY_CONFLICT",
+        httpStatus: 409,
+        retryable: true,
+        defaultMessage: "Conflict detected. Please refresh and try again.",
+    },
+    ABORTED: {
+        code: "ABORTED",
+        httpStatus: 409,
+        retryable: true,
+        defaultMessage: "Conflict detected.",
+    },
+    OUT_OF_RANGE: {
+        code: "OUT_OF_RANGE",
+        httpStatus: 400,
+        retryable: false,
+        defaultMessage: "Client navigated beyond the valid state.",
+    },
+    ALREADY_EXISTS: {
+        code: "ALREADY_EXISTS",
+        httpStatus: 409,
+        retryable: false,
+        defaultMessage: "Resource already exists.",
+    },
+    // API Errors - Network Errors
+    NETWORK_TIMEOUT: {
+        code: "NETWORK_TIMEOUT",
+        httpStatus: 408,
+        retryable: true,
+        defaultMessage: "The client started a request but did not finish sending it in time.",
+    },
+    PAYLOAD_TOO_LARGE: {
+        code: "PAYLOAD_TOO_LARGE",
+        httpStatus: 413,
+        retryable: false,
+        defaultMessage: "The request body exceeds the network limit.",
+    },
+    TOO_MANY_REQUESTS: {
+        code: "TOO_MANY_REQUESTS",
+        httpStatus: 429,
+        retryable: true,
+        defaultMessage: "Network-level rate limiter blocked the request.",
+    },
+    CLIENT_CLOSED_REQUEST: {
+        code: "CLIENT_CLOSED_REQUEST",
+        httpStatus: 499,
+        retryable: false,
+        defaultMessage: "Client cancelled the request before the server finished.",
+    },
+    // API Errors - Server-Side Infrastructure Errors
+    GATEWAY_TIMEOUT: {
+        code: "GATEWAY_TIMEOUT",
+        httpStatus: 504,
+        retryable: true,
+        defaultMessage: "API gateway timed out waiting for upstream service.",
+    },
+    BAD_GATEWAY: {
+        code: "BAD_GATEWAY",
+        httpStatus: 502,
+        retryable: true,
+        defaultMessage: "Server received an invalid response from upstream.",
+    },
+    SERVICE_UNAVAILABLE: {
+        code: "SERVICE_UNAVAILABLE",
+        httpStatus: 503,
+        retryable: true,
+        defaultMessage: "Service unavailable.",
+    },
+};
+export function getErrorDefinition(code) {
+    return ERROR_DEFINITIONS[code];
+}
+//# sourceMappingURL=definitions.js.map

package/dist/definitions.js.map

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

package/dist/factory.d.ts

@@ -0,0 +1,27 @@
+import { StandardError } from "./standard-error.js";
+import type { BMErrorResponse, CanonicalErrorCode, CanonicalError, CreateErrorOptions, ErrorContext, StandardErrorResponse, TraceId } from "./types/index.js";
+import { ServiceId } from "./types/index.js";
+export declare function createError(code: CanonicalErrorCode, options?: CreateErrorOptions): StandardError;
+export declare function getCanonicalError(code: CanonicalErrorCode): CanonicalError;
+export declare function createErrorResponse(code: CanonicalErrorCode, options?: CreateErrorOptions): StandardErrorResponse;
+export declare function wrapServiceError(serviceId: ServiceId, baseError: CanonicalError, overrides: Readonly<{
+    message: string;
+    internal_code?: number | string;
+    dependency?: BMErrorResponse["dependency"];
+    context?: ErrorContext;
+    trace_id?: TraceId;
+}>): BMErrorResponse;
+export declare function handleDependencyError(serviceId: ServiceId, dependency: Readonly<{
+    name: string;
+    type: "INTERNAL" | "EXTERNAL";
+}>, err: unknown, options?: Readonly<{
+    message?: string;
+    internal_code?: number | string;
+    context?: ErrorContext;
+    trace_id?: TraceId;
+}>): BMErrorResponse;
+export declare function toErrorResponse(err: unknown, options?: Readonly<{
+    fallbackCode?: CanonicalErrorCode;
+    traceId?: TraceId;
+}>): StandardErrorResponse;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAmB,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EACX,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,OAAO,EACP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAY7C,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,GAAE,kBAAuB,GAAG,aAAa,CAErG;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CAO1E;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,kBAAuB,GAC9B,qBAAqB,CAEvB;AAED,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,GACA,eAAe,CAYjB;AAED,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAA;CAAE,CAAC,EACrE,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAM,GACL,eAAe,CAoBjB;AAED,wBAAgB,eAAe,CAC9B,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,QAAQ,CAAC;IAAE,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAC1E,qBAAqB,CAkBvB"}

package/dist/factory.js

@@ -0,0 +1,74 @@
+import { getErrorDefinition } from "./definitions.js";
+import { StandardError, isStandardError } from "./standard-error.js";
+import { ServiceId } from "./types/index.js";
+function getOriginalMessage(err) {
+    if (err instanceof Error && typeof err.message === "string" && err.message.length > 0)
+        return err.message;
+    if (typeof err === "string" && err.length > 0)
+        return err;
+    try {
+        return JSON.stringify(err);
+    }
+    catch {
+        return "Unknown dependency error.";
+    }
+}
+export function createError(code, options = {}) {
+    return new StandardError(code, options);
+}
+export function getCanonicalError(code) {
+    const def = getErrorDefinition(code);
+    return {
+        error_code: def.code,
+        status_code: def.httpStatus,
+        retryable: def.retryable,
+    };
+}
+export function createErrorResponse(code, options = {}) {
+    return createError(code, options).toJSON();
+}
+export function wrapServiceError(serviceId, baseError, overrides) {
+    return {
+        service_id: serviceId,
+        error_code: baseError.error_code,
+        message: overrides.message,
+        code: baseError.status_code,
+        retryable: baseError.retryable,
+        ...(overrides.internal_code !== undefined ? { internal_code: overrides.internal_code } : {}),
+        ...(overrides.dependency !== undefined ? { dependency: overrides.dependency } : {}),
+        ...(overrides.context !== undefined ? { context: overrides.context } : {}),
+        ...(overrides.trace_id !== undefined ? { trace_id: overrides.trace_id } : {}),
+    };
+}
+export function handleDependencyError(serviceId, dependency, err, options = {}) {
+    const original_message = getOriginalMessage(err);
+    // INTERNAL = infrastructure (Redis/Rabbit/etc), EXTERNAL = vendor (Stripe/etc)
+    const code = dependency.type === "INTERNAL" ? "INFRASTRUCTURE_FAILURE" : "THIRD_PARTY_ERROR";
+    const canonical = getCanonicalError(code);
+    const message = options.message ??
+        (dependency.type === "INTERNAL"
+            ? `Infrastructure dependency "${dependency.name}" failed.`
+            : `Third-party provider "${dependency.name}" returned an error.`);
+    return wrapServiceError(serviceId, canonical, {
+        message,
+        dependency: { ...dependency, original_message },
+        ...(options.internal_code !== undefined ? { internal_code: options.internal_code } : {}),
+        ...(options.context !== undefined ? { context: options.context } : {}),
+        ...(options.trace_id !== undefined ? { trace_id: options.trace_id } : {}),
+    });
+}
+export function toErrorResponse(err, options) {
+    if (isStandardError(err)) {
+        return err.toJSON();
+    }
+    const fallbackCode = options?.fallbackCode ?? "INTERNAL_ERROR";
+    const def = getErrorDefinition(fallbackCode);
+    let message = def.defaultMessage;
+    let cause = err;
+    if (err instanceof Error && typeof err.message === "string" && err.message.length > 0) {
+        message = err.message;
+    }
+    const createOptions = options?.traceId !== undefined ? { message, cause, traceId: options.traceId } : { message, cause };
+    return createErrorResponse(fallbackCode, createOptions);
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { ERROR_DEFINITIONS, getErrorDefinition } from "./definitions.js";
+export { createError, createErrorResponse, getCanonicalError, handleDependencyError, toErrorResponse, wrapServiceError, } from "./factory.js";
+export { StandardError, isStandardError } from "./standard-error.js";
+export { ServiceId } from "./types/index.js";
+export type { BMErrorResponse, CanonicalErrorCode, CanonicalError, CreateErrorOptions, DependencyInfo, DependencyType, ErrorContext, ErrorDefinition, StandardErrorResponse, TraceId, } from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,YAAY,EACX,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,OAAO,GACP,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { ERROR_DEFINITIONS, getErrorDefinition } from "./definitions.js";
+export { createError, createErrorResponse, getCanonicalError, handleDependencyError, toErrorResponse, wrapServiceError, } from "./factory.js";
+export { StandardError, isStandardError } from "./standard-error.js";
+export { ServiceId } from "./types/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACN,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/standard-error.d.ts

@@ -0,0 +1,13 @@
+import type { CanonicalErrorCode, CreateErrorOptions, StandardErrorResponse } from "./types/index.js";
+export declare class StandardError extends Error {
+    readonly code: CanonicalErrorCode;
+    readonly httpStatus: number;
+    readonly retryable: boolean;
+    readonly context?: Record<string, unknown>;
+    readonly traceId?: string;
+    readonly cause?: unknown;
+    constructor(code: CanonicalErrorCode, options?: CreateErrorOptions);
+    toJSON(): StandardErrorResponse;
+}
+export declare function isStandardError(value: unknown): value is StandardError;
+//# sourceMappingURL=standard-error.d.ts.map

package/dist/standard-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-error.d.ts","sourceRoot":"","sources":["../standard-error.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEtG,qBAAa,aAAc,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,kBAAkB,CAAC;IACzC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjC,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,IAAI,EAAE,kBAAkB,EAAE,OAAO,GAAE,kBAAuB;IAkBtE,MAAM,IAAI,qBAAqB;CAYtC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}

package/dist/standard-error.js

@@ -0,0 +1,41 @@
+import { getErrorDefinition } from "./definitions.js";
+export class StandardError extends Error {
+    code;
+    httpStatus;
+    retryable;
+    context;
+    traceId;
+    cause;
+    constructor(code, options = {}) {
+        const def = getErrorDefinition(code);
+        const message = options.message ?? def.defaultMessage;
+        super(message);
+        this.name = "StandardError";
+        this.code = def.code;
+        this.httpStatus = def.httpStatus;
+        this.retryable = def.retryable;
+        if (options.context !== undefined)
+            this.context = options.context;
+        if (options.traceId !== undefined)
+            this.traceId = options.traceId;
+        if (options.cause !== undefined)
+            this.cause = options.cause;
+        // Ensure instanceof works across TS transpilation targets.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        const json = {
+            error_code: this.code,
+            message: this.message,
+            status_code: this.httpStatus,
+            retryable: this.retryable,
+            ...(this.context !== undefined ? { context: this.context } : {}),
+            ...(this.traceId !== undefined ? { trace_id: this.traceId } : {}),
+        };
+        return json;
+    }
+}
+export function isStandardError(value) {
+    return value instanceof StandardError;
+}
+//# sourceMappingURL=standard-error.js.map

package/dist/standard-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-error.js","sourceRoot":"","sources":["../standard-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,MAAM,OAAO,aAAc,SAAQ,KAAK;IACvB,IAAI,CAAqB;IACzB,UAAU,CAAS;IACnB,SAAS,CAAU;IACnB,OAAO,CAA2B;IAClC,OAAO,CAAU;IACjB,KAAK,CAAW;IAEhC,YAAmB,IAAwB,EAAE,UAA8B,EAAE;QAC5E,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC,cAAc,CAAC;QAEtD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;QAC/B,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAClE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAClE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE5D,2DAA2D;QAC3D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;IAEM,MAAM;QACZ,MAAM,IAAI,GAA0B;YACnC,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,UAAU;YAC5B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC;QAEF,OAAO,IAAI,CAAC;IACb,CAAC;CACD;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,aAAa,CAAC;AACvC,CAAC"}