@digiteers/uloba3-sdk 3.4.2 → 4.0.1

package/dist/lib/sdk-error.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UlobaSDKError = void 0;
+/**
+ * Custom SDK Error class that preserves HTTP status codes and backend error details
+ */
+class UlobaSDKError extends Error {
+    /**
+     * HTTP status code from the response
+     */
+    statusCode;
+    /**
+     * Error code from backend (e.g., 'UNAUTHORIZED', 'VALIDATION_ERROR')
+     */
+    code;
+    /**
+     * Original error message from backend
+     */
+    backendMessage;
+    /**
+     * Additional error details from backend
+     */
+    details;
+    /**
+     * Request metadata
+     */
+    metadata;
+    /**
+     * Original axios error (if available)
+     */
+    originalError;
+    constructor(params) {
+        super(params.message);
+        this.name = 'UlobaSDKError';
+        this.statusCode = params.statusCode;
+        this.code = params.code;
+        this.backendMessage = params.backendMessage;
+        this.details = params.details;
+        this.metadata = params.metadata;
+        this.originalError = params.originalError;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, UlobaSDKError);
+        }
+    }
+    /**
+     * Create SDK error from Axios error
+     */
+    static fromAxiosError(error) {
+        const statusCode = error.response?.status || 500;
+        const backendData = error.response?.data;
+        // Extract error information from backend response
+        const backendMessage = backendData?.error || backendData?.message;
+        const code = backendData?.details?.code;
+        const details = backendData?.details;
+        // Build user-friendly message based on status code
+        let message;
+        switch (statusCode) {
+            case 400:
+                message = backendMessage || 'Invalid request. Please check your input.';
+                break;
+            case 401:
+                message = 'Authentication required. Please log in.';
+                break;
+            case 403:
+                message = backendMessage || 'You do not have permission to perform this action.';
+                break;
+            case 404:
+                message = backendMessage || 'The requested resource was not found.';
+                break;
+            case 409:
+                message = backendMessage || 'Conflict. The resource already exists or is in an incompatible state.';
+                break;
+            case 422:
+                message = backendMessage || 'Validation error. Please check your input.';
+                break;
+            case 429:
+                message = 'Too many requests. Please try again later.';
+                break;
+            case 500:
+                message = 'Server error. Please try again later.';
+                break;
+            case 502:
+            case 503:
+            case 504:
+                message = 'Service temporarily unavailable. Please try again later.';
+                break;
+            default:
+                message = backendMessage || `Request failed with status ${statusCode}`;
+        }
+        return new UlobaSDKError({
+            message,
+            statusCode,
+            code,
+            backendMessage,
+            details,
+            metadata: {
+                url: error.config?.url,
+                method: error.config?.method?.toUpperCase(),
+                timestamp: backendData?.metadata?.timestamp || new Date().toISOString(),
+                requestId: backendData?.metadata?.requestId,
+            },
+            originalError: error,
+        });
+    }
+    /**
+     * Check if error is a specific status code
+     */
+    isStatus(code) {
+        return this.statusCode === code;
+    }
+    /**
+     * Check if error is a client error (4xx)
+     */
+    isClientError() {
+        return this.statusCode >= 400 && this.statusCode < 500;
+    }
+    /**
+     * Check if error is a server error (5xx)
+     */
+    isServerError() {
+        return this.statusCode >= 500 && this.statusCode < 600;
+    }
+    /**
+     * Check if error is an authentication error (401)
+     */
+    isAuthError() {
+        return this.statusCode === 401;
+    }
+    /**
+     * Check if error is a permission error (403)
+     */
+    isPermissionError() {
+        return this.statusCode === 403;
+    }
+    /**
+     * Check if error is a not found error (404)
+     */
+    isNotFoundError() {
+        return this.statusCode === 404;
+    }
+    /**
+     * Check if error is a validation error (400 or 422)
+     */
+    isValidationError() {
+        return this.statusCode === 400 || this.statusCode === 422;
+    }
+    /**
+     * Convert error to JSON for logging
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            statusCode: this.statusCode,
+            code: this.code,
+            backendMessage: this.backendMessage,
+            details: this.details,
+            metadata: this.metadata,
+            stack: this.stack,
+        };
+    }
+}
+exports.UlobaSDKError = UlobaSDKError;
+//# sourceMappingURL=sdk-error.js.map

package/dist/lib/sdk-error.js.map

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