@beemafrica/error-definitions 1.0.1

package/dist/types/index.d.ts

@@ -0,0 +1,55 @@
+export type TraceId = string;
+export type ErrorContext = Record<string, unknown>;
+export type DependencyType = "INTERNAL" | "EXTERNAL";
+export type DependencyInfo = Readonly<{
+    name: string;
+    type: DependencyType;
+    original_message: string;
+}>;
+export type CanonicalErrorCode = "INTERNAL_ERROR" | "INVALID_ARGUMENT" | "SERVICE_FAILURE" | "UI_INVALID_INPUT" | "UI_REQUIRED_FIELD_MISSING" | "UI_INVALID_FORMAT" | "UI_FILE_TOO_LARGE" | "UI_UNSUPPORTED_FILE_TYPE" | "UI_STALE_STATE" | "UI_ACTION_NOT_AVAILABLE" | "UI_DUPLICATE_SUBMISSION" | "UI_RENDER_ERROR" | "UI_ASSET_LOAD_FAILED" | "UI_TRANSLATION_MISSING" | "API_INVALID_PARAMETER" | "API_REQUIRED_PARAMETER_MISSING" | "API_INVALID_REQUEST_FORMAT" | "API_SCHEMA_VALIDATION_FAILED" | "API_TOO_MANY_ITEMS" | "API_FIELD_TOO_LONG" | "API_UNSUPPORTED_VALUE" | "AUTH_MISSING_CREDENTIALS" | "AUTH_INVALID_CREDENTIALS" | "AUTH_FORBIDDEN" | "AUTH_INSUFFICIENT_PERMISSIONS" | "AUTH_TOKEN_EXPIRED" | "DOMAIN_INCORRECT_PIN" | "DOMAIN_PIN_EXPIRED" | "DOMAIN_OTP_ATTEMPTS_EXCEEDED" | "DOMAIN_DUPLICATE_PIN" | "DOMAIN_INVALID_SCHEDULE_TIME" | "DOMAIN_RESOURCE_CONFLICT" | "DOMAIN_RESOURCE_NOT_FOUND" | "DEPENDENCY_FAILURE" | "DEPENDENCY_TIMEOUT" | "INFRASTRUCTURE_FAILURE" | "THIRD_PARTY_ERROR" | "UPSTREAM_ERROR" | "RESOURCE_EXHAUSTED" | "QUOTA_EXCEEDED" | "SERVER_OVERLOAD" | "CONCURRENCY_CONFLICT" | "ABORTED" | "OUT_OF_RANGE" | "ALREADY_EXISTS" | "NETWORK_TIMEOUT" | "PAYLOAD_TOO_LARGE" | "TOO_MANY_REQUESTS" | "CLIENT_CLOSED_REQUEST" | "GATEWAY_TIMEOUT" | "BAD_GATEWAY" | "SERVICE_UNAVAILABLE";
+export type ErrorDefinition = Readonly<{
+    code: CanonicalErrorCode;
+    httpStatus: number;
+    retryable: boolean;
+    defaultMessage: string;
+}>;
+export declare enum ServiceId {
+    TwoWay = "two-way",
+    Sms = "sms",
+    Ussd = "ussd",
+    Otp = "otp",
+    Contacts = "contacts",
+    Bpay = "bpay",
+    Payments = "payments",
+    Airtime = "airtime",
+    Rewards = "rewards",
+    Booking = "booking",
+    Whatsapp = "whatsapp"
+}
+export type StandardErrorResponse = Readonly<{
+    error_code: CanonicalErrorCode;
+    message: string;
+    status_code: number;
+    retryable: boolean;
+    context?: ErrorContext;
+    trace_id?: TraceId;
+}>;
+export type CanonicalError = Readonly<Pick<StandardErrorResponse, "error_code" | "status_code" | "retryable">>;
+export interface BMErrorResponse {
+    readonly service_id: string;
+    readonly error_code: CanonicalErrorCode;
+    readonly message: string;
+    readonly code: number;
+    readonly retryable: boolean;
+    readonly internal_code?: number | string;
+    readonly dependency?: DependencyInfo;
+    readonly context?: ErrorContext;
+    readonly trace_id?: TraceId;
+}
+export type CreateErrorOptions = Readonly<{
+    message?: string;
+    context?: ErrorContext;
+    traceId?: TraceId;
+    cause?: unknown;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,15 @@
+export var ServiceId;
+(function (ServiceId) {
+    ServiceId["TwoWay"] = "two-way";
+    ServiceId["Sms"] = "sms";
+    ServiceId["Ussd"] = "ussd";
+    ServiceId["Otp"] = "otp";
+    ServiceId["Contacts"] = "contacts";
+    ServiceId["Bpay"] = "bpay";
+    ServiceId["Payments"] = "payments";
+    ServiceId["Airtime"] = "airtime";
+    ServiceId["Rewards"] = "rewards";
+    ServiceId["Booking"] = "booking";
+    ServiceId["Whatsapp"] = "whatsapp";
+})(ServiceId || (ServiceId = {}));
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAoFA,MAAM,CAAN,IAAY,SAYX;AAZD,WAAY,SAAS;IACpB,+BAAkB,CAAA;IAClB,wBAAW,CAAA;IACX,0BAAa,CAAA;IACb,wBAAW,CAAA;IACX,kCAAqB,CAAA;IACrB,0BAAa,CAAA;IACb,kCAAqB,CAAA;IACrB,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;IACnB,kCAAqB,CAAA;AACtB,CAAC,EAZW,SAAS,KAAT,SAAS,QAYpB"}

package/dist-cjs/definitions.js

@@ -0,0 +1,331 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_DEFINITIONS = void 0;
+exports.getErrorDefinition = getErrorDefinition;
+exports.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.",
+    },
+};
+function getErrorDefinition(code) {
+    return exports.ERROR_DEFINITIONS[code];
+}
+//# sourceMappingURL=definitions.js.map

package/dist-cjs/definitions.js.map

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

package/dist-cjs/factory.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createError = createError;
+exports.getCanonicalError = getCanonicalError;
+exports.createErrorResponse = createErrorResponse;
+exports.wrapServiceError = wrapServiceError;
+exports.handleDependencyError = handleDependencyError;
+exports.toErrorResponse = toErrorResponse;
+const definitions_js_1 = require("./definitions.js");
+const standard_error_js_1 = require("./standard-error.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.";
+    }
+}
+function createError(code, options = {}) {
+    return new standard_error_js_1.StandardError(code, options);
+}
+function getCanonicalError(code) {
+    const def = (0, definitions_js_1.getErrorDefinition)(code);
+    return {
+        error_code: def.code,
+        status_code: def.httpStatus,
+        retryable: def.retryable,
+    };
+}
+function createErrorResponse(code, options = {}) {
+    return createError(code, options).toJSON();
+}
+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 } : {}),
+    };
+}
+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 } : {}),
+    });
+}
+function toErrorResponse(err, options) {
+    if ((0, standard_error_js_1.isStandardError)(err)) {
+        return err.toJSON();
+    }
+    const fallbackCode = options?.fallbackCode ?? "INTERNAL_ERROR";
+    const def = (0, definitions_js_1.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-cjs/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../factory.ts"],"names":[],"mappings":";;AAuBA,kCAEC;AAED,8CAOC;AAED,kDAKC;AAED,4CAsBC;AAED,sDA8BC;AAED,0CAqBC;AAxHD,qDAAsD;AACtD,2DAAqE;AAYrE,SAAS,kBAAkB,CAAC,GAAY;IACvC,IAAI,GAAG,YAAY,KAAK,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC1G,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1D,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,2BAA2B,CAAC;IACpC,CAAC;AACF,CAAC;AAED,SAAgB,WAAW,CAAC,IAAwB,EAAE,UAA8B,EAAE;IACrF,OAAO,IAAI,iCAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,iBAAiB,CAAC,IAAwB;IACzD,MAAM,GAAG,GAAG,IAAA,mCAAkB,EAAC,IAAI,CAAC,CAAC;IACrC,OAAO;QACN,UAAU,EAAE,GAAG,CAAC,IAAI;QACpB,WAAW,EAAE,GAAG,CAAC,UAAU;QAC3B,SAAS,EAAE,GAAG,CAAC,SAAS;KACxB,CAAC;AACH,CAAC;AAED,SAAgB,mBAAmB,CAClC,IAAwB,EACxB,UAA8B,EAAE;IAEhC,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED,SAAgB,gBAAgB,CAC/B,SAAoB,EACpB,SAAyB,EACzB,SAME;IAEF,OAAO;QACN,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,GAAG,CAAC,SAAS,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,GAAG,CAAC,SAAS,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,GAAG,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAC;AACH,CAAC;AAED,SAAgB,qBAAqB,CACpC,SAAoB,EACpB,UAAqE,EACrE,GAAY,EACZ,UAKK,EAAE;IAEP,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAEjD,+EAA+E;IAC/E,MAAM,IAAI,GAAuB,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,mBAAmB,CAAC;IACjH,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE1C,MAAM,OAAO,GACZ,OAAO,CAAC,OAAO;QACf,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU;YAC9B,CAAC,CAAC,8BAA8B,UAAU,CAAC,IAAI,WAAW;YAC1D,CAAC,CAAC,yBAAyB,UAAU,CAAC,IAAI,sBAAsB,CAAC,CAAC;IAEpE,OAAO,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE;QAC7C,OAAO;QACP,UAAU,EAAE,EAAE,GAAG,UAAU,EAAE,gBAAgB,EAAE;QAC/C,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,eAAe,CAC9B,GAAY,EACZ,OAA4E;IAE5E,IAAI,IAAA,mCAAe,EAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAC/D,MAAM,GAAG,GAAG,IAAA,mCAAkB,EAAC,YAAY,CAAC,CAAC;IAE7C,IAAI,OAAO,GAAG,GAAG,CAAC,cAAc,CAAC;IACjC,IAAI,KAAK,GAAY,GAAG,CAAC;IAEzB,IAAI,GAAG,YAAY,KAAK,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvF,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,MAAM,aAAa,GAClB,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACpG,OAAO,mBAAmB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;AACzD,CAAC"}

package/dist-cjs/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceId = exports.isStandardError = exports.StandardError = exports.wrapServiceError = exports.toErrorResponse = exports.handleDependencyError = exports.getCanonicalError = exports.createErrorResponse = exports.createError = exports.getErrorDefinition = exports.ERROR_DEFINITIONS = void 0;
+var definitions_js_1 = require("./definitions.js");
+Object.defineProperty(exports, "ERROR_DEFINITIONS", { enumerable: true, get: function () { return definitions_js_1.ERROR_DEFINITIONS; } });
+Object.defineProperty(exports, "getErrorDefinition", { enumerable: true, get: function () { return definitions_js_1.getErrorDefinition; } });
+var factory_js_1 = require("./factory.js");
+Object.defineProperty(exports, "createError", { enumerable: true, get: function () { return factory_js_1.createError; } });
+Object.defineProperty(exports, "createErrorResponse", { enumerable: true, get: function () { return factory_js_1.createErrorResponse; } });
+Object.defineProperty(exports, "getCanonicalError", { enumerable: true, get: function () { return factory_js_1.getCanonicalError; } });
+Object.defineProperty(exports, "handleDependencyError", { enumerable: true, get: function () { return factory_js_1.handleDependencyError; } });
+Object.defineProperty(exports, "toErrorResponse", { enumerable: true, get: function () { return factory_js_1.toErrorResponse; } });
+Object.defineProperty(exports, "wrapServiceError", { enumerable: true, get: function () { return factory_js_1.wrapServiceError; } });
+var standard_error_js_1 = require("./standard-error.js");
+Object.defineProperty(exports, "StandardError", { enumerable: true, get: function () { return standard_error_js_1.StandardError; } });
+Object.defineProperty(exports, "isStandardError", { enumerable: true, get: function () { return standard_error_js_1.isStandardError; } });
+var index_js_1 = require("./types/index.js");
+Object.defineProperty(exports, "ServiceId", { enumerable: true, get: function () { return index_js_1.ServiceId; } });
+//# sourceMappingURL=index.js.map

package/dist-cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;AAAA,mDAAyE;AAAhE,mHAAA,iBAAiB,OAAA;AAAE,oHAAA,kBAAkB,OAAA;AAC9C,2CAOsB;AANrB,yGAAA,WAAW,OAAA;AACX,iHAAA,mBAAmB,OAAA;AACnB,+GAAA,iBAAiB,OAAA;AACjB,mHAAA,qBAAqB,OAAA;AACrB,6GAAA,eAAe,OAAA;AACf,8GAAA,gBAAgB,OAAA;AAEjB,yDAAqE;AAA5D,kHAAA,aAAa,OAAA;AAAE,oHAAA,eAAe,OAAA;AACvC,6CAA6C;AAApC,qGAAA,SAAS,OAAA"}

package/dist-cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist-cjs/standard-error.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandardError = void 0;
+exports.isStandardError = isStandardError;
+const definitions_js_1 = require("./definitions.js");
+class StandardError extends Error {
+    code;
+    httpStatus;
+    retryable;
+    context;
+    traceId;
+    cause;
+    constructor(code, options = {}) {
+        const def = (0, definitions_js_1.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;
+    }
+}
+exports.StandardError = StandardError;
+function isStandardError(value) {
+    return value instanceof StandardError;
+}
+//# sourceMappingURL=standard-error.js.map

package/dist-cjs/standard-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-error.js","sourceRoot":"","sources":["../standard-error.ts"],"names":[],"mappings":";;;AA2CA,0CAEC;AA7CD,qDAAsD;AAGtD,MAAa,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,IAAA,mCAAkB,EAAC,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;AAtCD,sCAsCC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,aAAa,CAAC;AACvC,CAAC"}

package/dist-cjs/types/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceId = void 0;
+var ServiceId;
+(function (ServiceId) {
+    ServiceId["TwoWay"] = "two-way";
+    ServiceId["Sms"] = "sms";
+    ServiceId["Ussd"] = "ussd";
+    ServiceId["Otp"] = "otp";
+    ServiceId["Contacts"] = "contacts";
+    ServiceId["Bpay"] = "bpay";
+    ServiceId["Payments"] = "payments";
+    ServiceId["Airtime"] = "airtime";
+    ServiceId["Rewards"] = "rewards";
+    ServiceId["Booking"] = "booking";
+    ServiceId["Whatsapp"] = "whatsapp";
+})(ServiceId || (exports.ServiceId = ServiceId = {}));
+//# sourceMappingURL=index.js.map

package/dist-cjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":";;;AAoFA,IAAY,SAYX;AAZD,WAAY,SAAS;IACpB,+BAAkB,CAAA;IAClB,wBAAW,CAAA;IACX,0BAAa,CAAA;IACb,wBAAW,CAAA;IACX,kCAAqB,CAAA;IACrB,0BAAa,CAAA;IACb,kCAAqB,CAAA;IACrB,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;IACnB,kCAAqB,CAAA;AACtB,CAAC,EAZW,SAAS,yBAAT,SAAS,QAYpB"}