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

package/lib/errors/classes/server.error.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * DJUST SDK Server Error
+ * Errors for server-side failures (5xx).
+ *
+ * @module errors/classes/server
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerError = void 0;
+const base_1 = require("../base");
+const codes_1 = require("../codes");
+/**
+ * Error thrown when the server returns a 5xx error.
+ *
+ * Server errors are typically retriable, as they often indicate
+ * temporary issues like overload or maintenance.
+ *
+ * @example
+ * ```typescript
+ * import { ServerError } from '@djust-b2b/djust-front-sdk';
+ *
+ * try {
+ *   await sdk.checkout();
+ * } catch (error) {
+ *   if (error instanceof ServerError) {
+ *     if (error.retriable) {
+ *       // Retry with exponential backoff
+ *       await retryWithBackoff(() => sdk.checkout());
+ *     } else {
+ *       // Show error page
+ *       showErrorPage('Service temporarily unavailable');
+ *     }
+ *   }
+ * }
+ * ```
+ */
+class ServerError extends base_1.SDKError {
+    constructor(message, httpStatus = 500, code = codes_1.SDKErrorCode.SERVER_ERROR, details, metadata) {
+        super({
+            code,
+            message,
+            httpStatus,
+            details,
+            retriable: true, // Server errors are typically retriable
+            metadata,
+        });
+        this.name = "ServerError";
+    }
+    /**
+     * Creates a ServerError for Internal Server Error (500).
+     */
+    static internalError(message, metadata) {
+        return new ServerError(message || "Internal server error", 500, codes_1.SDKErrorCode.INTERNAL_ERROR, {}, metadata);
+    }
+    /**
+     * Creates a ServerError for Bad Gateway (502).
+     */
+    static badGateway(metadata) {
+        return new ServerError("Bad gateway", 502, codes_1.SDKErrorCode.BAD_GATEWAY, {}, metadata);
+    }
+    /**
+     * Creates a ServerError for Service Unavailable (503).
+     */
+    static serviceUnavailable(retryAfterMs, metadata) {
+        const error = new ServerError("Service temporarily unavailable", 503, codes_1.SDKErrorCode.SERVICE_UNAVAILABLE, retryAfterMs ? { retryAfterMs } : {}, metadata);
+        if (retryAfterMs) {
+            error.retryAfterMs = retryAfterMs;
+        }
+        return error;
+    }
+    /**
+     * Creates a ServerError for Gateway Timeout (504).
+     */
+    static gatewayTimeout(metadata) {
+        return new ServerError("Gateway timeout", 504, codes_1.SDKErrorCode.GATEWAY_TIMEOUT, {}, metadata);
+    }
+    /**
+     * Creates a ServerError from HTTP 5xx response.
+     */
+    static fromResponse(statusCode, body, headers, metadata) {
+        // Try to parse body for error details
+        let parsed = {};
+        try {
+            parsed = JSON.parse(body);
+        }
+        catch {
+            // Not JSON
+        }
+        const message = parsed.message || parsed.error || getDefaultMessageForStatus(statusCode);
+        const code = mapStatusToCode(statusCode);
+        // Check for Retry-After header
+        let retryAfterMs;
+        if (headers) {
+            const retryAfter = headers.get("Retry-After");
+            if (retryAfter) {
+                const seconds = parseInt(retryAfter, 10);
+                if (!isNaN(seconds)) {
+                    retryAfterMs = seconds * 1000;
+                }
+            }
+        }
+        const error = new ServerError(message, statusCode, code, { rawBody: body.substring(0, 500) }, // Truncate large bodies
+        metadata);
+        if (retryAfterMs) {
+            error.retryAfterMs = retryAfterMs;
+        }
+        return error;
+    }
+    /**
+     * Checks if this is a transient error that will likely resolve on retry.
+     */
+    isTransient() {
+        return [502, 503, 504].includes(this.httpStatus);
+    }
+}
+exports.ServerError = ServerError;
+/**
+ * Maps HTTP status code to SDK error code.
+ */
+function mapStatusToCode(status) {
+    switch (status) {
+        case 500:
+            return codes_1.SDKErrorCode.INTERNAL_ERROR;
+        case 502:
+            return codes_1.SDKErrorCode.BAD_GATEWAY;
+        case 503:
+            return codes_1.SDKErrorCode.SERVICE_UNAVAILABLE;
+        case 504:
+            return codes_1.SDKErrorCode.GATEWAY_TIMEOUT;
+        default:
+            return codes_1.SDKErrorCode.SERVER_ERROR;
+    }
+}
+/**
+ * Gets default error message for HTTP status code.
+ */
+function getDefaultMessageForStatus(status) {
+    switch (status) {
+        case 500:
+            return "Internal server error";
+        case 501:
+            return "Not implemented";
+        case 502:
+            return "Bad gateway";
+        case 503:
+            return "Service unavailable";
+        case 504:
+            return "Gateway timeout";
+        case 505:
+            return "HTTP version not supported";
+        default:
+            return `Server error (${status})`;
+    }
+}
+//# sourceMappingURL=server.error.js.map

package/lib/errors/classes/server.error.js.map

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

package/lib/errors/classes/timeout.error.d.ts

@@ -0,0 +1,64 @@
+/**
+ * DJUST SDK Timeout Error
+ * Errors for request timeouts.
+ *
+ * @module errors/classes/timeout
+ * @since 2.17.0
+ */
+import { SDKError } from "../base";
+import type { RequestMetadata } from "../types";
+/**
+ * Error thrown when a request times out.
+ *
+ * Timeout errors are retriable, as the server may be temporarily
+ * overloaded or the network may be slow.
+ *
+ * @example
+ * ```typescript
+ * import { TimeoutError } from '@djust-b2b/djust-front-sdk';
+ *
+ * const client = createDjustClient({
+ *   baseUrl: 'https://api.djust.io',
+ *   clientId: 'xxx',
+ *   apiKey: 'yyy',
+ *   timeout: 5000, // 5 seconds
+ * });
+ *
+ * try {
+ *   await client.getProducts();
+ * } catch (error) {
+ *   if (error instanceof TimeoutError) {
+ *     console.log(`Request timed out after ${error.timeoutMs}ms`);
+ *   }
+ * }
+ * ```
+ */
+export declare class TimeoutError extends SDKError {
+    /** The timeout value that was exceeded (in milliseconds) */
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number, metadata?: RequestMetadata);
+    /**
+     * Returns the timeout value in seconds.
+     */
+    getTimeoutSeconds(): number;
+    /**
+     * Creates a TimeoutError for a client-side timeout.
+     *
+     * @param timeoutMs - The timeout value that was exceeded
+     * @param metadata - Optional request metadata
+     */
+    static clientTimeout(timeoutMs: number, metadata?: RequestMetadata): TimeoutError;
+    /**
+     * Creates a TimeoutError from a server 408 response.
+     *
+     * @param metadata - Optional request metadata
+     */
+    static serverTimeout(metadata?: RequestMetadata): TimeoutError;
+    /**
+     * Suggests a longer timeout for retry.
+     *
+     * @param multiplier - Factor to multiply the original timeout (default: 2)
+     */
+    suggestRetryTimeout(multiplier?: number): number;
+}
+//# sourceMappingURL=timeout.error.d.ts.map

package/lib/errors/classes/timeout.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.error.d.ts","sourceRoot":"","sources":["../../../src/errors/classes/timeout.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC,4DAA4D;IAC5D,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe;IAczD;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,eAAe,GACzB,YAAY;IAIf;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,YAAY;IAS9D;;;;OAIG;IACH,mBAAmB,CAAC,UAAU,GAAE,MAAU,GAAG,MAAM;CAGpD"}

package/lib/errors/classes/timeout.error.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * DJUST SDK Timeout Error
+ * Errors for request timeouts.
+ *
+ * @module errors/classes/timeout
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutError = void 0;
+const base_1 = require("../base");
+const codes_1 = require("../codes");
+/**
+ * Error thrown when a request times out.
+ *
+ * Timeout errors are retriable, as the server may be temporarily
+ * overloaded or the network may be slow.
+ *
+ * @example
+ * ```typescript
+ * import { TimeoutError } from '@djust-b2b/djust-front-sdk';
+ *
+ * const client = createDjustClient({
+ *   baseUrl: 'https://api.djust.io',
+ *   clientId: 'xxx',
+ *   apiKey: 'yyy',
+ *   timeout: 5000, // 5 seconds
+ * });
+ *
+ * try {
+ *   await client.getProducts();
+ * } catch (error) {
+ *   if (error instanceof TimeoutError) {
+ *     console.log(`Request timed out after ${error.timeoutMs}ms`);
+ *   }
+ * }
+ * ```
+ */
+class TimeoutError extends base_1.SDKError {
+    constructor(timeoutMs, metadata) {
+        super({
+            code: codes_1.SDKErrorCode.TIMEOUT,
+            message: `Request timed out after ${timeoutMs}ms`,
+            httpStatus: 0,
+            details: { timeoutMs },
+            retriable: true,
+            metadata,
+        });
+        this.name = "TimeoutError";
+        this.timeoutMs = timeoutMs;
+    }
+    /**
+     * Returns the timeout value in seconds.
+     */
+    getTimeoutSeconds() {
+        return Math.ceil(this.timeoutMs / 1000);
+    }
+    /**
+     * Creates a TimeoutError for a client-side timeout.
+     *
+     * @param timeoutMs - The timeout value that was exceeded
+     * @param metadata - Optional request metadata
+     */
+    static clientTimeout(timeoutMs, metadata) {
+        return new TimeoutError(timeoutMs, metadata);
+    }
+    /**
+     * Creates a TimeoutError from a server 408 response.
+     *
+     * @param metadata - Optional request metadata
+     */
+    static serverTimeout(metadata) {
+        // Server timeouts don't have a specific timeout value
+        // Use a placeholder
+        const error = new TimeoutError(0, metadata);
+        // Override message
+        error.message = "Server request timeout";
+        return error;
+    }
+    /**
+     * Suggests a longer timeout for retry.
+     *
+     * @param multiplier - Factor to multiply the original timeout (default: 2)
+     */
+    suggestRetryTimeout(multiplier = 2) {
+        return Math.min(this.timeoutMs * multiplier, 120000); // Max 2 minutes
+    }
+}
+exports.TimeoutError = TimeoutError;
+//# sourceMappingURL=timeout.error.js.map

package/lib/errors/classes/timeout.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.error.js","sourceRoot":"","sources":["../../../src/errors/classes/timeout.error.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,kCAAmC;AACnC,oCAAwC;AAGxC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAa,YAAa,SAAQ,eAAQ;IAIxC,YAAY,SAAiB,EAAE,QAA0B;QACvD,KAAK,CAAC;YACJ,IAAI,EAAE,oBAAY,CAAC,OAAO;YAC1B,OAAO,EAAE,2BAA2B,SAAS,IAAI;YACjD,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,EAAE,SAAS,EAAE;YACtB,SAAS,EAAE,IAAI;YACf,QAAQ;SACT,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAClB,SAAiB,EACjB,QAA0B;QAE1B,OAAO,IAAI,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,QAA0B;QAC7C,sDAAsD;QACtD,oBAAoB;QACpB,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC5C,mBAAmB;QAClB,KAAa,CAAC,OAAO,GAAG,wBAAwB,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,aAAqB,CAAC;QACxC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,gBAAgB;IACxE,CAAC;CACF;AA5DD,oCA4DC"}

package/lib/errors/classes/unexpected.error.d.ts

@@ -0,0 +1,70 @@
+/**
+ * DJUST SDK Unexpected Error
+ * Errors for unknown or unexpected failures.
+ *
+ * @module errors/classes/unexpected
+ * @since 2.17.0
+ */
+import { SDKError } from "../base";
+import type { RequestMetadata } from "../types";
+/**
+ * Error thrown when an unexpected condition occurs.
+ *
+ * This typically indicates:
+ * - A bug in the SDK
+ * - An unknown error type
+ * - An unexpected server response format
+ *
+ * These errors should be logged for investigation.
+ *
+ * @example
+ * ```typescript
+ * import { UnexpectedError } from '@djust-b2b/djust-front-sdk';
+ *
+ * try {
+ *   await sdk.doSomething();
+ * } catch (error) {
+ *   if (error instanceof UnexpectedError) {
+ *     // Log for investigation
+ *     logger.error('Unexpected SDK error', {
+ *       error: error.toJSON(),
+ *       cause: error.cause?.stack,
+ *     });
+ *
+ *     // Show generic error to user
+ *     showError('An unexpected error occurred. Please try again.');
+ *   }
+ * }
+ * ```
+ */
+export declare class UnexpectedError extends SDKError {
+    constructor(message: string, cause?: Error, metadata?: RequestMetadata);
+    /**
+     * Creates an UnexpectedError from an unknown error.
+     *
+     * @param error - The unknown error
+     * @param metadata - Optional request metadata
+     */
+    static from(error: unknown, metadata?: RequestMetadata): UnexpectedError;
+    /**
+     * Creates an UnexpectedError for an invalid response.
+     *
+     * @param reason - Why the response was invalid
+     * @param metadata - Optional request metadata
+     */
+    static invalidResponse(reason: string, metadata?: RequestMetadata): UnexpectedError;
+    /**
+     * Creates an UnexpectedError for a configuration issue.
+     *
+     * @param message - Description of the configuration issue
+     */
+    static configuration(message: string): UnexpectedError;
+    /**
+     * Creates an UnexpectedError indicating a bug.
+     *
+     * @param message - Description of the bug
+     * @param metadata - Optional context
+     */
+    static bug(message: string, metadata?: RequestMetadata): UnexpectedError;
+}
+//# sourceMappingURL=unexpected.error.d.ts.map

package/lib/errors/classes/unexpected.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unexpected.error.d.ts","sourceRoot":"","sources":["../../../src/errors/classes/unexpected.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,eAAe;IAatE;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,eAAe;IAwBxE;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,eAAe,GACzB,eAAe;IAQlB;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;IAItD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,eAAe;CAOzE"}

package/lib/errors/classes/unexpected.error.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * DJUST SDK Unexpected Error
+ * Errors for unknown or unexpected failures.
+ *
+ * @module errors/classes/unexpected
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnexpectedError = void 0;
+const base_1 = require("../base");
+const codes_1 = require("../codes");
+/**
+ * Error thrown when an unexpected condition occurs.
+ *
+ * This typically indicates:
+ * - A bug in the SDK
+ * - An unknown error type
+ * - An unexpected server response format
+ *
+ * These errors should be logged for investigation.
+ *
+ * @example
+ * ```typescript
+ * import { UnexpectedError } from '@djust-b2b/djust-front-sdk';
+ *
+ * try {
+ *   await sdk.doSomething();
+ * } catch (error) {
+ *   if (error instanceof UnexpectedError) {
+ *     // Log for investigation
+ *     logger.error('Unexpected SDK error', {
+ *       error: error.toJSON(),
+ *       cause: error.cause?.stack,
+ *     });
+ *
+ *     // Show generic error to user
+ *     showError('An unexpected error occurred. Please try again.');
+ *   }
+ * }
+ * ```
+ */
+class UnexpectedError extends base_1.SDKError {
+    constructor(message, cause, metadata) {
+        super({
+            code: codes_1.SDKErrorCode.UNEXPECTED_ERROR,
+            message,
+            httpStatus: 0,
+            cause,
+            retriable: false, // Unknown errors shouldn't be auto-retried
+            metadata,
+        });
+        this.name = "UnexpectedError";
+    }
+    /**
+     * Creates an UnexpectedError from an unknown error.
+     *
+     * @param error - The unknown error
+     * @param metadata - Optional request metadata
+     */
+    static from(error, metadata) {
+        if (error instanceof base_1.SDKError) {
+            // Already an SDK error - wrap it
+            return new UnexpectedError(`Unexpected SDK error: ${error.message}`, error, metadata);
+        }
+        if (error instanceof Error) {
+            return new UnexpectedError(error.message, error, metadata);
+        }
+        if (typeof error === "string") {
+            return new UnexpectedError(error, undefined, metadata);
+        }
+        return new UnexpectedError("An unexpected error occurred", undefined, {
+            ...metadata,
+            rawError: String(error),
+        });
+    }
+    /**
+     * Creates an UnexpectedError for an invalid response.
+     *
+     * @param reason - Why the response was invalid
+     * @param metadata - Optional request metadata
+     */
+    static invalidResponse(reason, metadata) {
+        return new UnexpectedError(`Invalid response: ${reason}`, undefined, metadata);
+    }
+    /**
+     * Creates an UnexpectedError for a configuration issue.
+     *
+     * @param message - Description of the configuration issue
+     */
+    static configuration(message) {
+        return new UnexpectedError(`Configuration error: ${message}`);
+    }
+    /**
+     * Creates an UnexpectedError indicating a bug.
+     *
+     * @param message - Description of the bug
+     * @param metadata - Optional context
+     */
+    static bug(message, metadata) {
+        return new UnexpectedError(`SDK Bug: ${message}. Please report this issue.`, undefined, metadata);
+    }
+}
+exports.UnexpectedError = UnexpectedError;
+//# sourceMappingURL=unexpected.error.js.map

package/lib/errors/classes/unexpected.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unexpected.error.js","sourceRoot":"","sources":["../../../src/errors/classes/unexpected.error.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,kCAAmC;AACnC,oCAAwC;AAGxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAa,eAAgB,SAAQ,eAAQ;IAC3C,YAAY,OAAe,EAAE,KAAa,EAAE,QAA0B;QACpE,KAAK,CAAC;YACJ,IAAI,EAAE,oBAAY,CAAC,gBAAgB;YACnC,OAAO;YACP,UAAU,EAAE,CAAC;YACb,KAAK;YACL,SAAS,EAAE,KAAK,EAAE,2CAA2C;YAC7D,QAAQ;SACT,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,KAAc,EAAE,QAA0B;QACpD,IAAI,KAAK,YAAY,eAAQ,EAAE,CAAC;YAC9B,iCAAiC;YACjC,OAAO,IAAI,eAAe,CACxB,yBAAyB,KAAK,CAAC,OAAO,EAAE,EACxC,KAAK,EACL,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,IAAI,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,IAAI,eAAe,CAAC,8BAA8B,EAAE,SAAS,EAAE;YACpE,GAAG,QAAQ;YACX,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC;SACjB,CAAC,CAAC;IACZ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CACpB,MAAc,EACd,QAA0B;QAE1B,OAAO,IAAI,eAAe,CACxB,qBAAqB,MAAM,EAAE,EAC7B,SAAS,EACT,QAAQ,CACT,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,OAAe;QAClC,OAAO,IAAI,eAAe,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,OAAe,EAAE,QAA0B;QACpD,OAAO,IAAI,eAAe,CACxB,YAAY,OAAO,6BAA6B,EAChD,SAAS,EACT,QAAQ,CACT,CAAC;IACJ,CAAC;CACF;AAnFD,0CAmFC"}

package/lib/errors/classes/validation.error.d.ts

@@ -0,0 +1,68 @@
+/**
+ * DJUST SDK Validation Error
+ * Errors related to invalid input parameters.
+ *
+ * @module errors/classes/validation
+ * @since 2.17.0
+ */
+import { SDKError } from "../base";
+import type { RequestMetadata } from "../types";
+/**
+ * Error thrown when input validation fails.
+ *
+ * This includes:
+ * - Missing required parameters
+ * - Invalid parameter values
+ * - Type mismatches
+ * - Business rule violations
+ *
+ * @example
+ * ```typescript
+ * import { ValidationError } from '@djust-b2b/djust-front-sdk';
+ *
+ * // The SDK throws this automatically
+ * await sdk.getCart({ currency: 'EUR' }); // Missing cartId
+ * // Throws: ValidationError: Required parameter 'cartId' is missing
+ *
+ * // Or create manually
+ * throw ValidationError.invalidParameter('email', 'must be a valid email address');
+ * ```
+ */
+export declare class ValidationError extends SDKError {
+    constructor(message: string, details?: Record<string, unknown>, metadata?: RequestMetadata);
+    /**
+     * Creates a ValidationError for a missing required parameter.
+     *
+     * @param param - Name of the missing parameter
+     * @param metadata - Optional request metadata
+     */
+    static missingParameter(param: string, metadata?: RequestMetadata): ValidationError;
+    /**
+     * Creates a ValidationError for an invalid parameter value.
+     *
+     * @param param - Name of the invalid parameter
+     * @param reason - Why the value is invalid
+     * @param metadata - Optional request metadata
+     */
+    static invalidParameter(param: string, reason: string, metadata?: RequestMetadata): ValidationError;
+    /**
+     * Creates a ValidationError for a type mismatch.
+     *
+     * @param param - Name of the parameter
+     * @param expected - Expected type
+     * @param actual - Actual type received
+     * @param metadata - Optional request metadata
+     */
+    static typeMismatch(param: string, expected: string, actual: string, metadata?: RequestMetadata): ValidationError;
+    /**
+     * Creates a ValidationError from API validation response.
+     *
+     * @param errors - Array of validation errors from API
+     * @param metadata - Optional request metadata
+     */
+    static fromApiResponse(errors: Array<{
+        field?: string;
+        message?: string;
+    }>, metadata?: RequestMetadata): ValidationError;
+}
+//# sourceMappingURL=validation.error.d.ts.map

package/lib/errors/classes/validation.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.error.d.ts","sourceRoot":"","sources":["../../../src/errors/classes/validation.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAEzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,CAAC,EAAE,eAAe;IAa5B;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CACrB,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,eAAe,GACzB,eAAe;IAWlB;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,eAAe,GACzB,eAAe;IAYlB;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,eAAe,GACzB,eAAe;IAalB;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EACnD,QAAQ,CAAC,EAAE,eAAe,GACzB,eAAe;CAYnB"}

package/lib/errors/classes/validation.error.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * DJUST SDK Validation Error
+ * Errors related to invalid input parameters.
+ *
+ * @module errors/classes/validation
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = void 0;
+const base_1 = require("../base");
+const codes_1 = require("../codes");
+/**
+ * Error thrown when input validation fails.
+ *
+ * This includes:
+ * - Missing required parameters
+ * - Invalid parameter values
+ * - Type mismatches
+ * - Business rule violations
+ *
+ * @example
+ * ```typescript
+ * import { ValidationError } from '@djust-b2b/djust-front-sdk';
+ *
+ * // The SDK throws this automatically
+ * await sdk.getCart({ currency: 'EUR' }); // Missing cartId
+ * // Throws: ValidationError: Required parameter 'cartId' is missing
+ *
+ * // Or create manually
+ * throw ValidationError.invalidParameter('email', 'must be a valid email address');
+ * ```
+ */
+class ValidationError extends base_1.SDKError {
+    constructor(message, details, metadata) {
+        super({
+            code: codes_1.SDKErrorCode.VALIDATION_ERROR,
+            message,
+            httpStatus: 400,
+            details,
+            retriable: false, // Validation errors are never retriable
+            metadata,
+        });
+        this.name = "ValidationError";
+    }
+    /**
+     * Creates a ValidationError for a missing required parameter.
+     *
+     * @param param - Name of the missing parameter
+     * @param metadata - Optional request metadata
+     */
+    static missingParameter(param, metadata) {
+        return new ValidationError(`Required parameter '${param}' is missing`, {
+            parameter: param,
+            code: codes_1.SDKErrorCode.MISSING_PARAMETER,
+        }, metadata);
+    }
+    /**
+     * Creates a ValidationError for an invalid parameter value.
+     *
+     * @param param - Name of the invalid parameter
+     * @param reason - Why the value is invalid
+     * @param metadata - Optional request metadata
+     */
+    static invalidParameter(param, reason, metadata) {
+        return new ValidationError(`Invalid parameter '${param}': ${reason}`, {
+            parameter: param,
+            reason,
+            code: codes_1.SDKErrorCode.INVALID_PARAMETER,
+        }, metadata);
+    }
+    /**
+     * Creates a ValidationError for a type mismatch.
+     *
+     * @param param - Name of the parameter
+     * @param expected - Expected type
+     * @param actual - Actual type received
+     * @param metadata - Optional request metadata
+     */
+    static typeMismatch(param, expected, actual, metadata) {
+        return new ValidationError(`Parameter '${param}' must be ${expected}, got ${actual}`, {
+            parameter: param,
+            expected,
+            actual,
+            code: codes_1.SDKErrorCode.INVALID_PARAMETER,
+        }, metadata);
+    }
+    /**
+     * Creates a ValidationError from API validation response.
+     *
+     * @param errors - Array of validation errors from API
+     * @param metadata - Optional request metadata
+     */
+    static fromApiResponse(errors, metadata) {
+        const messages = errors
+            .map((e) => (e.field ? `${e.field}: ${e.message}` : e.message))
+            .filter(Boolean)
+            .join("; ");
+        return new ValidationError(messages || "Validation failed", { validationErrors: errors }, metadata);
+    }
+}
+exports.ValidationError = ValidationError;
+//# sourceMappingURL=validation.error.js.map