@longvansoftware/storefront-js-client 3.0.5 → 3.0.7

package/dist/src/types/common.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Common types used across the SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SortOrder = exports.Gender = exports.Status = void 0;
+/**
+ * Status enum
+ */
+var Status;
+(function (Status) {
+    Status["ACTIVE"] = "ACTIVE";
+    Status["INACTIVE"] = "INACTIVE";
+    Status["PENDING"] = "PENDING";
+    Status["DRAFT"] = "DRAFT";
+    Status["PUBLISHED"] = "PUBLISHED";
+    Status["ARCHIVED"] = "ARCHIVED";
+})(Status || (exports.Status = Status = {}));
+/**
+ * Gender enum
+ */
+var Gender;
+(function (Gender) {
+    Gender["MALE"] = "MALE";
+    Gender["FEMALE"] = "FEMALE";
+    Gender["OTHER"] = "OTHER";
+})(Gender || (exports.Gender = Gender = {}));
+/**
+ * Sort order enum
+ */
+var SortOrder;
+(function (SortOrder) {
+    SortOrder["ASC"] = "ASC";
+    SortOrder["DESC"] = "DESC";
+})(SortOrder || (exports.SortOrder = SortOrder = {}));

package/dist/src/utils/errorHandler.d.ts

@@ -0,0 +1,64 @@
+import { SDKError } from '../lib/serviceSDK';
+/**
+ * Error types for better categorization
+ */
+export declare enum ErrorType {
+    GRAPHQL_ERROR = "GRAPHQL_ERROR",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    REST_API_ERROR = "REST_API_ERROR",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    AUTHENTICATION_ERROR = "AUTHENTICATION_ERROR",
+    AUTHORIZATION_ERROR = "AUTHORIZATION_ERROR",
+    NOT_FOUND_ERROR = "NOT_FOUND_ERROR",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * Error severity levels
+ */
+export declare enum ErrorSeverity {
+    LOW = "LOW",
+    MEDIUM = "MEDIUM",
+    HIGH = "HIGH",
+    CRITICAL = "CRITICAL"
+}
+/**
+ * Enhanced SDK Error with additional metadata
+ */
+export declare class EnhancedSDKError extends SDKError {
+    readonly severity: ErrorSeverity;
+    readonly timestamp: Date;
+    readonly context?: Record<string, any>;
+    readonly retryable: boolean;
+    constructor(message: string, type: ErrorType, originalError?: any, severity?: ErrorSeverity, context?: Record<string, any>, retryable?: boolean);
+}
+/**
+ * Error handler utility class
+ */
+export declare class ErrorHandler {
+    /**
+     * Create a standardized error from various error sources
+     */
+    static createError(error: any, context?: Record<string, any>): EnhancedSDKError;
+    /**
+     * Determine error severity based on error characteristics
+     */
+    private static determineSeverity;
+    /**
+     * Determine if an error is retryable
+     */
+    private static isRetryable;
+    /**
+     * Log error with appropriate level
+     */
+    static logError(error: EnhancedSDKError, operation?: string): void;
+    /**
+     * Check if error should trigger retry logic
+     */
+    static shouldRetry(error: EnhancedSDKError, attemptCount: number, maxRetries?: number): boolean;
+}
+/**
+ * Retry utility with exponential backoff
+ */
+export declare class RetryManager {
+    static withExponentialBackoff<T>(operation: () => Promise<T>, maxRetries?: number, baseDelay?: number): Promise<T>;
+}

package/dist/src/utils/errorHandler.js

@@ -0,0 +1,197 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryManager = exports.ErrorHandler = exports.EnhancedSDKError = exports.ErrorSeverity = exports.ErrorType = void 0;
+const serviceSDK_1 = require("../lib/serviceSDK");
+/**
+ * Error types for better categorization
+ */
+var ErrorType;
+(function (ErrorType) {
+    ErrorType["GRAPHQL_ERROR"] = "GRAPHQL_ERROR";
+    ErrorType["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorType["REST_API_ERROR"] = "REST_API_ERROR";
+    ErrorType["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    ErrorType["AUTHENTICATION_ERROR"] = "AUTHENTICATION_ERROR";
+    ErrorType["AUTHORIZATION_ERROR"] = "AUTHORIZATION_ERROR";
+    ErrorType["NOT_FOUND_ERROR"] = "NOT_FOUND_ERROR";
+    ErrorType["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+})(ErrorType || (exports.ErrorType = ErrorType = {}));
+/**
+ * Error severity levels
+ */
+var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["LOW"] = "LOW";
+    ErrorSeverity["MEDIUM"] = "MEDIUM";
+    ErrorSeverity["HIGH"] = "HIGH";
+    ErrorSeverity["CRITICAL"] = "CRITICAL";
+})(ErrorSeverity || (exports.ErrorSeverity = ErrorSeverity = {}));
+/**
+ * Enhanced SDK Error with additional metadata
+ */
+class EnhancedSDKError extends serviceSDK_1.SDKError {
+    constructor(message, type, originalError, severity = ErrorSeverity.MEDIUM, context, retryable = false) {
+        super(message, type, originalError);
+        this.severity = severity;
+        this.timestamp = new Date();
+        this.context = context;
+        this.retryable = retryable;
+    }
+}
+exports.EnhancedSDKError = EnhancedSDKError;
+/**
+ * Error handler utility class
+ */
+class ErrorHandler {
+    /**
+     * Create a standardized error from various error sources
+     */
+    static createError(error, context) {
+        var _a;
+        // Handle GraphQL errors
+        if (error.graphQLErrors && error.graphQLErrors.length > 0) {
+            const message = error.graphQLErrors.map((err) => err.message).join(', ');
+            return new EnhancedSDKError(message, ErrorType.GRAPHQL_ERROR, error, this.determineSeverity(error), context, this.isRetryable(error));
+        }
+        // Handle network errors
+        if (error.networkError) {
+            return new EnhancedSDKError(`Network Error: ${error.networkError.message}`, ErrorType.NETWORK_ERROR, error, ErrorSeverity.HIGH, context, true // Network errors are usually retryable
+            );
+        }
+        // Handle Axios errors (REST API)
+        if (error.response) {
+            const status = error.response.status;
+            let errorType = ErrorType.REST_API_ERROR;
+            let severity = ErrorSeverity.MEDIUM;
+            let retryable = false;
+            // Categorize by HTTP status code
+            if (status === 401) {
+                errorType = ErrorType.AUTHENTICATION_ERROR;
+                severity = ErrorSeverity.HIGH;
+            }
+            else if (status === 403) {
+                errorType = ErrorType.AUTHORIZATION_ERROR;
+                severity = ErrorSeverity.HIGH;
+            }
+            else if (status === 404) {
+                errorType = ErrorType.NOT_FOUND_ERROR;
+                severity = ErrorSeverity.LOW;
+            }
+            else if (status >= 500) {
+                severity = ErrorSeverity.HIGH;
+                retryable = true;
+            }
+            else if (status === 429) {
+                retryable = true;
+            }
+            return new EnhancedSDKError(`API Error (${status}): ${((_a = error.response.data) === null || _a === void 0 ? void 0 : _a.message) || error.message}`, errorType, error, severity, Object.assign(Object.assign({}, context), { statusCode: status }), retryable);
+        }
+        // Handle validation errors
+        if (error.name === 'ValidationError') {
+            return new EnhancedSDKError(error.message, ErrorType.VALIDATION_ERROR, error, ErrorSeverity.LOW, context, false);
+        }
+        // Default unknown error
+        return new EnhancedSDKError(error.message || 'An unknown error occurred', ErrorType.UNKNOWN_ERROR, error, ErrorSeverity.MEDIUM, context, false);
+    }
+    /**
+     * Determine error severity based on error characteristics
+     */
+    static determineSeverity(error) {
+        var _a;
+        if (error.networkError)
+            return ErrorSeverity.HIGH;
+        if ((_a = error.graphQLErrors) === null || _a === void 0 ? void 0 : _a.some((e) => { var _a; return ((_a = e.extensions) === null || _a === void 0 ? void 0 : _a.code) === 'INTERNAL_ERROR'; })) {
+            return ErrorSeverity.CRITICAL;
+        }
+        return ErrorSeverity.MEDIUM;
+    }
+    /**
+     * Determine if an error is retryable
+     */
+    static isRetryable(error) {
+        var _a;
+        // Network errors are usually retryable
+        if (error.networkError)
+            return true;
+        // Some GraphQL errors are retryable
+        if ((_a = error.graphQLErrors) === null || _a === void 0 ? void 0 : _a.some((e) => {
+            var _a, _b;
+            return ((_a = e.extensions) === null || _a === void 0 ? void 0 : _a.code) === 'TIMEOUT' ||
+                ((_b = e.extensions) === null || _b === void 0 ? void 0 : _b.code) === 'RATE_LIMITED';
+        })) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Log error with appropriate level
+     */
+    static logError(error, operation) {
+        const logData = {
+            operation,
+            type: error.type,
+            severity: error.severity,
+            message: error.message,
+            timestamp: error.timestamp,
+            context: error.context,
+            retryable: error.retryable
+        };
+        switch (error.severity) {
+            case ErrorSeverity.CRITICAL:
+                console.error('🚨 CRITICAL ERROR:', logData);
+                break;
+            case ErrorSeverity.HIGH:
+                console.error('❌ HIGH SEVERITY ERROR:', logData);
+                break;
+            case ErrorSeverity.MEDIUM:
+                console.warn('⚠️ MEDIUM SEVERITY ERROR:', logData);
+                break;
+            case ErrorSeverity.LOW:
+                console.info('ℹ️ LOW SEVERITY ERROR:', logData);
+                break;
+        }
+    }
+    /**
+     * Check if error should trigger retry logic
+     */
+    static shouldRetry(error, attemptCount, maxRetries = 3) {
+        return error.retryable && attemptCount < maxRetries;
+    }
+}
+exports.ErrorHandler = ErrorHandler;
+/**
+ * Retry utility with exponential backoff
+ */
+class RetryManager {
+    static withExponentialBackoff(operation_1) {
+        return __awaiter(this, arguments, void 0, function* (operation, maxRetries = 3, baseDelay = 1000) {
+            let lastError;
+            for (let attempt = 0; attempt <= maxRetries; attempt++) {
+                try {
+                    return yield operation();
+                }
+                catch (error) {
+                    lastError = error;
+                    const enhancedError = ErrorHandler.createError(error);
+                    if (attempt === maxRetries || !ErrorHandler.shouldRetry(enhancedError, attempt, maxRetries)) {
+                        throw enhancedError;
+                    }
+                    // Exponential backoff with jitter
+                    const delay = baseDelay * Math.pow(2, attempt) + Math.random() * 1000;
+                    yield new Promise(resolve => setTimeout(resolve, delay));
+                }
+            }
+            throw ErrorHandler.createError(lastError);
+        });
+    }
+}
+exports.RetryManager = RetryManager;

package/package.json

@@ -1,44 +1,43 @@
-{
-  "name": "@longvansoftware/storefront-js-client",
-  "version": "3.0.5",
-  "main": "dist/src/index.js",
-  "types": "dist/src/index.d.ts",
-  "files": [
-    "dist/**/*.d.ts",
-    "dist/**/*.js"
-  ],
-  "directories": {
-    "test": "jest"
-  },
-  "scripts": {
-    "test": "jest",
-    "build": "tsc",
-    "publish": "npm run build && npm publish"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "dependencies": {
-    "@apollo/client": "3.9.11",
-    "apollo-boost": "^0.4.9",
-    "axios": "^1.6.8",
-    "cross-fetch": "^4.0.0",
-    "crypto-js": "^4.2.0",
-    "graphql": "^15.8.0",
-    "graphql-request": "^6.1.0",
-    "graphql-tag": "^2.12.6",
-    "react": "^18.2.0",
-    "ts-node": "^10.9.2"
-  },
-  "devDependencies": {
-    "@types/axios": "^0.14.0",
-    "@types/crypto-js": "^4.2.2",
-    "@types/jest": "^29.5.12",
-    "@types/node": "^20.12.7",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.2",
-    "typescript": "^5.4.5"
-  },
-  "description": "",
-  "packageManager": "yarn@4.7.0+sha512.5a0afa1d4c1d844b3447ee3319633797bcd6385d9a44be07993ae52ff4facabccafb4af5dcd1c2f9a94ac113e5e9ff56f6130431905884414229e284e37bb7c9"
-}
+{
+  "name": "@longvansoftware/storefront-js-client",
+  "version": "3.0.7",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "files": [
+    "dist/**/*.d.ts",
+    "dist/**/*.js"
+  ],
+  "directories": {
+    "test": "jest"
+  },
+  "scripts": {
+    "test": "jest",
+    "build": "tsc",
+    "publish": "npm run build && npm publish"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@apollo/client": "3.9.11",
+    "apollo-boost": "^0.4.9",
+    "axios": "^1.6.8",
+    "cross-fetch": "^4.0.0",
+    "crypto-js": "^4.2.0",
+    "graphql": "^15.8.0",
+    "graphql-request": "^6.1.0",
+    "graphql-tag": "^2.12.6",
+    "react": "^18.2.0",
+    "ts-node": "^10.9.2"
+  },
+  "devDependencies": {
+    "@types/axios": "^0.14.0",
+    "@types/crypto-js": "^4.2.2",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.12.7",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.4.5"
+  },
+  "description": ""
+}