@djust-b2b/djust-front-sdk 3.0.0-beta.9 → 3.0.0

package/lib/errors/factory.d.ts

@@ -0,0 +1,33 @@
+/**
+ * DJUST SDK Error Factory
+ * Functions for creating errors from HTTP responses and exceptions.
+ *
+ * @module errors/factory
+ * @since 2.17.0
+ */
+import { SDKError } from "./base";
+import type { ErrorFactoryOptions, RequestMetadata } from "./types";
+export declare function createErrorFromResponse(options: ErrorFactoryOptions): SDKError;
+/**
+ * Creates an SDKError from a network/fetch exception.
+ *
+ * Automatically detects error types:
+ * - AbortError → NetworkError (aborted)
+ * - Timeout errors → TimeoutError
+ * - Connection errors → NetworkError
+ * - DNS errors → NetworkError
+ * - Other → UnexpectedError
+ *
+ * @example
+ * ```typescript
+ * import { createErrorFromException } from '@djust-b2b/djust-front-sdk';
+ *
+ * try {
+ *   await fetch(url);
+ * } catch (error) {
+ *   throw createErrorFromException(error, { endpoint: url });
+ * }
+ * ```
+ */
+export declare function createErrorFromException(error: unknown, metadata?: RequestMetadata): SDKError;
+//# sourceMappingURL=factory.d.ts.map

package/lib/errors/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/errors/factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAoFpE,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,mBAAmB,GAC3B,QAAQ,CA2EV;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,eAAe,GACzB,QAAQ,CAiCV"}

package/lib/errors/factory.js

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * DJUST SDK Error Factory
+ * Functions for creating errors from HTTP responses and exceptions.
+ *
+ * @module errors/factory
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createErrorFromResponse = createErrorFromResponse;
+exports.createErrorFromException = createErrorFromException;
+const base_1 = require("./base");
+const codes_1 = require("./codes");
+const validation_error_1 = require("./classes/validation.error");
+const auth_error_1 = require("./classes/auth.error");
+const forbidden_error_1 = require("./classes/forbidden.error");
+const not_found_error_1 = require("./classes/not-found.error");
+const rate_limit_error_1 = require("./classes/rate-limit.error");
+const network_error_1 = require("./classes/network.error");
+const timeout_error_1 = require("./classes/timeout.error");
+const server_error_1 = require("./classes/server.error");
+const unexpected_error_1 = require("./classes/unexpected.error");
+/**
+ * Creates the appropriate SDKError subclass from an HTTP response.
+ *
+ * Maps HTTP status codes to specific error types:
+ * - 400 → ValidationError
+ * - 401 → AuthError
+ * - 403 → ForbiddenError
+ * - 404 → NotFoundError
+ * - 408 → TimeoutError
+ * - 429 → RateLimitError
+ * - 5xx → ServerError
+ * - Other → SDKError
+ *
+ * @example
+ * ```typescript
+ * import { createErrorFromResponse } from '@djust-b2b/djust-front-sdk';
+ *
+ * const response = await fetch(url);
+ * if (!response.ok) {
+ *   const body = await response.text();
+ *   throw createErrorFromResponse({
+ *     statusCode: response.status,
+ *     body,
+ *     url,
+ *     method: 'GET',
+ *   });
+ * }
+ * ```
+ */
+/**
+ * Sanitizes request body/params to remove sensitive data for logging.
+ * Masks passwords, tokens, and other sensitive fields.
+ */
+function sanitizeRequestData(data) {
+    if (!data || typeof data !== "object") {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return data.map((item) => sanitizeRequestData(item));
+    }
+    const sensitiveKeys = [
+        "password",
+        "token",
+        "accessToken",
+        "refreshToken",
+        "apiKey",
+        "secret",
+        "authorization",
+        "auth",
+        "credentials",
+        "creditCard",
+        "cvv",
+        "cvc",
+        "ssn",
+        "socialSecurityNumber",
+    ];
+    const sanitized = {};
+    for (const [key, value] of Object.entries(data)) {
+        const lowerKey = key.toLowerCase();
+        if (sensitiveKeys.some((sk) => lowerKey.includes(sk))) {
+            sanitized[key] = "[REDACTED]";
+        }
+        else if (typeof value === "object" && value !== null) {
+            sanitized[key] = sanitizeRequestData(value);
+        }
+        else {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+function createErrorFromResponse(options) {
+    const { statusCode, body, url, method, durationMs, requestId, sdkMethod, queryParams, requestBody, requestHeaders, } = options;
+    // Extract path from full URL for metadata (e.g., /v2/shop/... from https://api.example.com/v2/shop/...)
+    let endpoint = url;
+    if (url) {
+        try {
+            const urlObj = new URL(url);
+            endpoint = urlObj.pathname; // Path without query params (query params are stored separately)
+        }
+        catch {
+            // If URL parsing fails, try to extract path manually
+            const pathMatch = url.match(/(\/v\d+\/shop\/[^?#]*)/);
+            if (pathMatch) {
+                endpoint = pathMatch[1];
+            }
+        }
+    }
+    const metadata = {
+        endpoint,
+        method,
+        durationMs,
+        requestId,
+        sdkMethod,
+        queryParams: queryParams
+            ? sanitizeRequestData(queryParams)
+            : undefined,
+        body: requestBody ? sanitizeRequestData(requestBody) : undefined,
+        headers: requestHeaders,
+    };
+    switch (statusCode) {
+        case 400:
+            return createValidationError(body, metadata);
+        case 401:
+            return auth_error_1.AuthError.fromResponse(body, metadata);
+        case 403:
+            return forbidden_error_1.ForbiddenError.fromResponse(body, metadata);
+        case 404:
+            return not_found_error_1.NotFoundError.fromResponse(body, url, metadata);
+        case 408:
+            return timeout_error_1.TimeoutError.serverTimeout(metadata);
+        case 409:
+            return createConflictError(body, metadata);
+        case 422:
+            return createUnprocessableError(body, metadata);
+        case 429:
+            return rate_limit_error_1.RateLimitError.fromResponse(body, undefined, metadata);
+        default:
+            if (statusCode >= 500) {
+                return server_error_1.ServerError.fromResponse(statusCode, body, undefined, metadata);
+            }
+            // Other 4xx errors
+            return createGeneric4xxError(statusCode, body, metadata);
+    }
+}
+/**
+ * Creates an SDKError from a network/fetch exception.
+ *
+ * Automatically detects error types:
+ * - AbortError → NetworkError (aborted)
+ * - Timeout errors → TimeoutError
+ * - Connection errors → NetworkError
+ * - DNS errors → NetworkError
+ * - Other → UnexpectedError
+ *
+ * @example
+ * ```typescript
+ * import { createErrorFromException } from '@djust-b2b/djust-front-sdk';
+ *
+ * try {
+ *   await fetch(url);
+ * } catch (error) {
+ *   throw createErrorFromException(error, { endpoint: url });
+ * }
+ * ```
+ */
+function createErrorFromException(error, metadata) {
+    // Already an SDKError
+    if (error instanceof base_1.SDKError) {
+        return metadata ? error.withMetadata(metadata) : error;
+    }
+    // Native Error
+    if (error instanceof Error) {
+        // Abort/cancellation
+        if (error.name === "AbortError") {
+            return network_error_1.NetworkError.aborted(metadata);
+        }
+        // Check for timeout patterns
+        const message = error.message.toLowerCase();
+        if (message.includes("timeout") || message.includes("timed out")) {
+            // Try to extract timeout value
+            const match = message.match(/(\d+)\s*ms/);
+            const timeoutMs = match ? parseInt(match[1], 10) : 30000;
+            return new timeout_error_1.TimeoutError(timeoutMs, metadata);
+        }
+        // Network errors
+        if (isNetworkError(error)) {
+            return network_error_1.NetworkError.fromException(error, metadata);
+        }
+        // Generic error
+        return new unexpected_error_1.UnexpectedError(error.message, error, metadata);
+    }
+    // Unknown error type
+    return unexpected_error_1.UnexpectedError.from(error, metadata);
+}
+/**
+ * Creates a validation error from 400 response.
+ */
+function createValidationError(body, metadata) {
+    let parsed = {};
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        // Not JSON
+    }
+    // Check for structured validation errors
+    if (parsed.errors && Array.isArray(parsed.errors)) {
+        return validation_error_1.ValidationError.fromApiResponse(parsed.errors, metadata);
+    }
+    const message = parsed.message || "Validation failed";
+    return new validation_error_1.ValidationError(message, { rawBody: body }, metadata);
+}
+/**
+ * Creates an error for 409 Conflict response.
+ */
+function createConflictError(body, metadata) {
+    let parsed = {};
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        // Not JSON
+    }
+    const message = parsed.message || "Resource conflict";
+    return new base_1.SDKError({
+        code: "CONFLICT",
+        message,
+        httpStatus: 409,
+        details: { rawBody: body },
+        retriable: false,
+        metadata,
+    });
+}
+/**
+ * Creates an error for 422 Unprocessable Entity response.
+ */
+function createUnprocessableError(body, metadata) {
+    let parsed = {};
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        // Not JSON
+    }
+    const message = parsed.message || "Unprocessable entity";
+    return new validation_error_1.ValidationError(message, {
+        rawBody: body,
+        errors: parsed.errors,
+    }, metadata);
+}
+/**
+ * Creates a generic error for other 4xx responses.
+ */
+function createGeneric4xxError(statusCode, body, metadata) {
+    let parsed = {};
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        // Not JSON
+    }
+    const message = parsed.message || `HTTP Error ${statusCode}`;
+    // Use parsed code if valid, otherwise use UNEXPECTED_ERROR
+    const code = parsed.code || codes_1.SDKErrorCode.UNEXPECTED_ERROR;
+    return new base_1.SDKError({
+        code,
+        message,
+        httpStatus: statusCode,
+        details: { rawBody: body, originalStatusCode: statusCode },
+        retriable: false,
+        metadata,
+    });
+}
+/**
+ * Checks if an error is a network-related error.
+ */
+function isNetworkError(error) {
+    const message = error.message.toLowerCase();
+    const networkIndicators = [
+        "network",
+        "fetch",
+        "econnrefused",
+        "econnreset",
+        "enotfound",
+        "etimedout",
+        "socket",
+        "dns",
+        "getaddrinfo",
+        "ssl",
+        "tls",
+        "certificate",
+    ];
+    return networkIndicators.some((indicator) => message.includes(indicator));
+}
+//# sourceMappingURL=factory.js.map

package/lib/errors/factory.js.map

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

package/lib/errors/guards.d.ts

@@ -0,0 +1,142 @@
+/**
+ * DJUST SDK Error Guards
+ * Type guards and utility functions for error handling.
+ *
+ * @module errors/guards
+ * @since 2.17.0
+ */
+import { SDKError } from "./base";
+import { type SDKErrorCodeType } from "./codes";
+import { AuthError } from "./classes/auth.error";
+import { ForbiddenError } from "./classes/forbidden.error";
+import { NetworkError } from "./classes/network.error";
+import { TimeoutError } from "./classes/timeout.error";
+import { ServerError } from "./classes/server.error";
+import { ValidationError } from "./classes/validation.error";
+import { NotFoundError } from "./classes/not-found.error";
+import { RateLimitError } from "./classes/rate-limit.error";
+import { UnexpectedError } from "./classes/unexpected.error";
+/**
+ * Checks if an error is an SDKError.
+ *
+ * @example
+ * ```typescript
+ * if (isSDKError(error)) {
+ *   console.log(error.code); // TypeScript knows it's SDKError
+ * }
+ * ```
+ */
+export declare function isSDKError(error: unknown): error is SDKError;
+/**
+ * Checks if an error is an AuthError (401).
+ */
+export declare function isAuthError(error: unknown): error is AuthError;
+/**
+ * Checks if an error is a ForbiddenError (403).
+ */
+export declare function isForbiddenError(error: unknown): error is ForbiddenError;
+/**
+ * Checks if an error is a NetworkError.
+ */
+export declare function isNetworkError(error: unknown): error is NetworkError;
+/**
+ * Checks if an error is a TimeoutError.
+ */
+export declare function isTimeoutError(error: unknown): error is TimeoutError;
+/**
+ * Checks if an error is a ServerError (5xx).
+ */
+export declare function isServerError(error: unknown): error is ServerError;
+/**
+ * Checks if an error is a ValidationError.
+ */
+export declare function isValidationError(error: unknown): error is ValidationError;
+/**
+ * Checks if an error is a NotFoundError (404).
+ */
+export declare function isNotFoundError(error: unknown): error is NotFoundError;
+/**
+ * Checks if an error is a RateLimitError (429).
+ */
+export declare function isRateLimitError(error: unknown): error is RateLimitError;
+/**
+ * Checks if an error is an UnexpectedError.
+ */
+export declare function isUnexpectedError(error: unknown): error is UnexpectedError;
+/**
+ * Checks if an error is retriable.
+ *
+ * Returns true for:
+ * - Network errors
+ * - Timeout errors
+ * - Rate limit errors (after delay)
+ * - Server errors (5xx)
+ * - Any SDKError with retriable=true
+ *
+ * @example
+ * ```typescript
+ * if (isRetryable(error)) {
+ *   await sleep(1000);
+ *   return retry();
+ * }
+ * ```
+ */
+export declare function isRetryable(error: unknown): boolean;
+/**
+ * Gets the retry delay for an error (in milliseconds).
+ *
+ * For rate limit errors, returns the Retry-After value.
+ * For other retriable errors, returns a default backoff.
+ * For non-retriable errors, returns undefined.
+ *
+ * @param error - The error to check
+ * @param attempt - Current retry attempt (1-based) for backoff calculation
+ * @param baseDelayMs - Base delay for exponential backoff (default: 1000ms)
+ */
+export declare function getRetryDelay(error: unknown, attempt?: number, baseDelayMs?: number): number | undefined;
+/**
+ * Checks if an error indicates the user should re-authenticate.
+ *
+ * Returns true for:
+ * - Token expired
+ * - Token invalid
+ * - Token missing
+ */
+export declare function shouldReauthenticate(error: unknown): boolean;
+/**
+ * Checks if an error is a client error (4xx).
+ */
+export declare function isClientError(error: unknown): boolean;
+/**
+ * Checks if an error is transient (likely to resolve on retry).
+ *
+ * More conservative than isRetryable - only returns true for
+ * errors that are very likely to succeed on retry.
+ */
+export declare function isTransientError(error: unknown): boolean;
+/**
+ * Extracts HTTP status code from an error.
+ *
+ * Works with both SDKError and legacy error formats.
+ *
+ * @example
+ * ```typescript
+ * const status = extractStatusCode(error);
+ * if (status === 401) {
+ *   redirectToLogin();
+ * }
+ * ```
+ */
+export declare function extractStatusCode(error: unknown): number | null;
+/**
+ * Extracts error code from an error.
+ */
+export declare function extractErrorCode(error: unknown): SDKErrorCodeType | string | null;
+/**
+ * Gets a user-friendly error message.
+ *
+ * Returns a safe message that can be shown to end users.
+ * Does not include sensitive details.
+ */
+export declare function getUserFriendlyMessage(error: unknown): string;
+//# sourceMappingURL=guards.d.ts.map

package/lib/errors/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/errors/guards.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAgB,KAAK,gBAAgB,EAAmB,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAM7D;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,MAAU,EACnB,WAAW,GAAE,MAAa,GACzB,MAAM,GAAG,SAAS,CAapB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAe5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKrD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAexD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAc/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,GACb,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAKlC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA4B7D"}