@djust-b2b/djust-front-sdk 3.0.0-beta.2 → 3.0.0-beta.20

package/dist/errors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/errors/base.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,kDAAkD;IAClD,SAAgB,IAAI,EAAE,gBAAgB,CAAC;IAEvC,+CAA+C;IAC/C,SAAgB,UAAU,EAAE,MAAM,CAAC;IAEnC,oCAAoC;IACpC,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjD,4CAA4C;IAC5C,SAAgB,KAAK,CAAC,EAAE,KAAK,CAAC;IAE9B,2CAA2C;IAC3C,SAAgB,SAAS,EAAE,OAAO,CAAC;IAEnC,mDAAmD;IACnD,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtC,+BAA+B;IAC/B,SAAgB,QAAQ,EAAE,eAAe,CAAC;IAE1C,2CAA2C;IAC3C,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,OAAO,EAAE,eAAe;IAsBpC;;;;;;;;;;OAUG;IACH,MAAM,IAAI,eAAe;IAczB;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,IAAI,eAAe;IAS/B;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,QAAQ;IAa1D;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ;CAYxD"}

package/dist/errors/classes/auth.error.d.ts

@@ -0,0 +1,64 @@
+/**
+ * DJUST SDK Authentication Error
+ * Errors related to authentication (401).
+ *
+ * @module errors/classes/auth
+ * @since 2.17.0
+ */
+import { SDKError } from "../base";
+import { type SDKErrorCodeType } from "../codes";
+import type { RequestMetadata } from "../types";
+/**
+ * Error thrown when authentication fails (HTTP 401).
+ *
+ * This includes:
+ * - Expired access tokens
+ * - Invalid tokens
+ * - Missing authentication
+ * - Invalid credentials
+ *
+ * @example
+ * ```typescript
+ * import { AuthError, isAuthError } from '@djust-b2b/djust-front-sdk';
+ *
+ * try {
+ *   await sdk.getCart({ cartId: '123', currency: 'EUR' });
+ * } catch (error) {
+ *   if (isAuthError(error)) {
+ *     if (error.code === 'TOKEN_EXPIRED') {
+ *       // Refresh token and retry
+ *       const newToken = await refreshToken();
+ *       // ...
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class AuthError extends SDKError {
+    constructor(message: string, code?: SDKErrorCodeType, details?: Record<string, unknown>, metadata?: RequestMetadata);
+    /**
+     * Creates an AuthError for an expired token.
+     */
+    static tokenExpired(metadata?: RequestMetadata): AuthError;
+    /**
+     * Creates an AuthError for an invalid token.
+     */
+    static tokenInvalid(reason?: string, metadata?: RequestMetadata): AuthError;
+    /**
+     * Creates an AuthError for a missing token.
+     */
+    static tokenMissing(metadata?: RequestMetadata): AuthError;
+    /**
+     * Creates an AuthError for invalid credentials.
+     */
+    static invalidCredentials(metadata?: RequestMetadata): AuthError;
+    /**
+     * Creates an AuthError from HTTP 401 response.
+     */
+    static fromResponse(body: string, metadata?: RequestMetadata): AuthError;
+    /**
+     * Checks if the user should be redirected to login.
+     */
+    shouldRedirectToLogin(): boolean;
+}
+//# sourceMappingURL=auth.error.d.ts.map

package/dist/errors/classes/auth.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.error.d.ts","sourceRoot":"","sources":["../../../src/errors/classes/auth.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,SAAU,SAAQ,QAAQ;gBAEnC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,gBAA0C,EAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,CAAC,EAAE,eAAe;IAa5B;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS;IAS1D;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS;IAS3E;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS;IAS1D;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS;IAShE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS;IA8BxE;;OAEG;IACH,qBAAqB,IAAI,OAAO;CAQjC"}

package/dist/errors/classes/forbidden.error.d.ts

@@ -0,0 +1,52 @@
+/**
+ * DJUST SDK Forbidden Error
+ * Errors related to authorization (403).
+ *
+ * @module errors/classes/forbidden
+ * @since 2.17.0
+ */
+import { SDKError } from "../base";
+import { type SDKErrorCodeType } from "../codes";
+import type { RequestMetadata } from "../types";
+/**
+ * Error thrown when the user lacks permission (HTTP 403).
+ *
+ * Unlike AuthError (401), ForbiddenError means the user IS authenticated
+ * but doesn't have the required permissions for the requested action.
+ *
+ * @example
+ * ```typescript
+ * import { ForbiddenError } from '@djust-b2b/djust-front-sdk';
+ *
+ * try {
+ *   await sdk.deleteOrder({ orderId: '123' });
+ * } catch (error) {
+ *   if (error instanceof ForbiddenError) {
+ *     showNotification('You do not have permission to delete orders');
+ *   }
+ * }
+ * ```
+ */
+export declare class ForbiddenError extends SDKError {
+    constructor(message?: string, code?: SDKErrorCodeType, details?: Record<string, unknown>, metadata?: RequestMetadata);
+    /**
+     * Creates a ForbiddenError for insufficient permissions.
+     *
+     * @param resource - The resource that was denied
+     * @param action - The action that was attempted
+     * @param metadata - Optional request metadata
+     */
+    static insufficientPermissions(resource?: string, action?: string, metadata?: RequestMetadata): ForbiddenError;
+    /**
+     * Creates a ForbiddenError for account-level restrictions.
+     *
+     * @param reason - Why the account is restricted
+     * @param metadata - Optional request metadata
+     */
+    static accountRestricted(reason?: string, metadata?: RequestMetadata): ForbiddenError;
+    /**
+     * Creates a ForbiddenError from HTTP 403 response.
+     */
+    static fromResponse(body: string, metadata?: RequestMetadata): ForbiddenError;
+}
+//# sourceMappingURL=forbidden.error.d.ts.map

package/dist/errors/classes/forbidden.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forbidden.error.d.ts","sourceRoot":"","sources":["../../../src/errors/classes/forbidden.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAe,SAAQ,QAAQ;gBAExC,OAAO,GAAE,MAAwB,EACjC,IAAI,GAAE,gBAAyC,EAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,CAAC,EAAE,eAAe;IAa5B;;;;;;OAMG;IACH,MAAM,CAAC,uBAAuB,CAC5B,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,eAAe,GACzB,cAAc;IAkBjB;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CACtB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,eAAe,GACzB,cAAc;IASjB;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,eAAe,GACzB,cAAc;CAalB"}

package/dist/errors/classes/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * DJUST SDK Error Classes
+ * Re-exports all error class types.
+ *
+ * @module errors/classes
+ * @since 2.17.0
+ */
+export { ValidationError } from "./validation.error";
+export { AuthError } from "./auth.error";
+export { ForbiddenError } from "./forbidden.error";
+export { NotFoundError } from "./not-found.error";
+export { RateLimitError } from "./rate-limit.error";
+export { NetworkError } from "./network.error";
+export { TimeoutError } from "./timeout.error";
+export { ServerError } from "./server.error";
+export { UnexpectedError } from "./unexpected.error";
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/classes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/classes/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/errors/classes/network.error.d.ts

@@ -0,0 +1,63 @@
+/**
+ * DJUST SDK Network Error
+ * Errors related to network connectivity.
+ *
+ * @module errors/classes/network
+ * @since 2.17.0
+ */
+import { SDKError } from "../base";
+import { type SDKErrorCodeType } from "../codes";
+import type { RequestMetadata } from "../types";
+/**
+ * Error thrown when a network-level failure occurs.
+ *
+ * This includes:
+ * - Connection refused
+ * - DNS resolution failures
+ * - SSL/TLS errors
+ * - Request aborted
+ * - General network failures
+ *
+ * Network errors are typically retriable.
+ *
+ * @example
+ * ```typescript
+ * import { NetworkError, isNetworkError } from '@djust-b2b/djust-front-sdk';
+ *
+ * try {
+ *   await sdk.getProducts();
+ * } catch (error) {
+ *   if (isNetworkError(error)) {
+ *     if (error.retriable) {
+ *       // Retry with exponential backoff
+ *     } else {
+ *       // Show offline message
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class NetworkError extends SDKError {
+    constructor(message: string, code?: SDKErrorCodeType, cause?: Error, metadata?: RequestMetadata);
+    /**
+     * Creates a NetworkError for connection refused.
+     */
+    static connectionRefused(host?: string, cause?: Error, metadata?: RequestMetadata): NetworkError;
+    /**
+     * Creates a NetworkError for DNS resolution failure.
+     */
+    static dnsError(hostname?: string, cause?: Error, metadata?: RequestMetadata): NetworkError;
+    /**
+     * Creates a NetworkError for SSL/TLS errors.
+     */
+    static sslError(reason?: string, cause?: Error, metadata?: RequestMetadata): NetworkError;
+    /**
+     * Creates a NetworkError for an aborted request.
+     */
+    static aborted(metadata?: RequestMetadata): NetworkError;
+    /**
+     * Creates a NetworkError from a fetch exception.
+     */
+    static fromException(error: Error, metadata?: RequestMetadata): NetworkError;
+}
+//# sourceMappingURL=network.error.d.ts.map

package/dist/errors/classes/network.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.error.d.ts","sourceRoot":"","sources":["../../../src/errors/classes/network.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,YAAa,SAAQ,QAAQ;gBAEtC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,gBAA6C,EACnD,KAAK,CAAC,EAAE,KAAK,EACb,QAAQ,CAAC,EAAE,eAAe;IAc5B;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,KAAK,EACb,QAAQ,CAAC,EAAE,eAAe,GACzB,YAAY;IAYf;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,KAAK,EACb,QAAQ,CAAC,EAAE,eAAe,GACzB,YAAY;IAOf;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,EACb,QAAQ,CAAC,EAAE,eAAe,GACzB,YAAY;IAOf;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,YAAY;IASxD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,YAAY;CA0D7E"}

package/dist/errors/classes/not-found.error.d.ts

@@ -0,0 +1,58 @@
+/**
+ * DJUST SDK Not Found Error
+ * Errors for missing resources (404).
+ *
+ * @module errors/classes/not-found
+ * @since 2.17.0
+ */
+import { SDKError } from "../base";
+import type { RequestMetadata } from "../types";
+/**
+ * Error thrown when a requested resource doesn't exist (HTTP 404).
+ *
+ * @example
+ * ```typescript
+ * import { NotFoundError } from '@djust-b2b/djust-front-sdk';
+ *
+ * try {
+ *   await sdk.getCart({ cartId: 'non-existent', currency: 'EUR' });
+ * } catch (error) {
+ *   if (error instanceof NotFoundError) {
+ *     console.log(error.resource); // 'Cart'
+ *     console.log(error.resourceId); // 'non-existent'
+ *   }
+ * }
+ * ```
+ */
+export declare class NotFoundError extends SDKError {
+    /** The type of resource that was not found */
+    readonly resource: string;
+    /** The ID of the resource that was not found (if known) */
+    readonly resourceId?: string;
+    constructor(resource: string, resourceId?: string, metadata?: RequestMetadata);
+    /**
+     * Creates a NotFoundError for a cart.
+     */
+    static cart(cartId: string, metadata?: RequestMetadata): NotFoundError;
+    /**
+     * Creates a NotFoundError for a product.
+     */
+    static product(productId: string, metadata?: RequestMetadata): NotFoundError;
+    /**
+     * Creates a NotFoundError for an order.
+     */
+    static order(orderId: string, metadata?: RequestMetadata): NotFoundError;
+    /**
+     * Creates a NotFoundError for a customer account.
+     */
+    static customerAccount(accountId: string, metadata?: RequestMetadata): NotFoundError;
+    /**
+     * Creates a NotFoundError for a generic resource.
+     */
+    static resource(type: string, id?: string, metadata?: RequestMetadata): NotFoundError;
+    /**
+     * Creates a NotFoundError from HTTP 404 response.
+     */
+    static fromResponse(body: string, endpoint?: string, metadata?: RequestMetadata): NotFoundError;
+}
+//# sourceMappingURL=not-found.error.d.ts.map

package/dist/errors/classes/not-found.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found.error.d.ts","sourceRoot":"","sources":["../../../src/errors/classes/not-found.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,8CAA8C;IAC9C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAEjC,2DAA2D;IAC3D,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,eAAe;IAoB5B;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,aAAa;IAItE;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,aAAa;IAI5E;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,aAAa;IAIxE;;OAEG;IACH,MAAM,CAAC,eAAe,CACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,eAAe,GACzB,aAAa;IAIhB;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,IAAI,EAAE,MAAM,EACZ,EAAE,CAAC,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,eAAe,GACzB,aAAa;IAIhB;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,eAAe,GACzB,aAAa;CAejB"}

package/dist/errors/classes/rate-limit.error.d.ts

@@ -0,0 +1,49 @@
+/**
+ * DJUST SDK Rate Limit Error
+ * Errors for rate limiting (429).
+ *
+ * @module errors/classes/rate-limit
+ * @since 2.17.0
+ */
+import { SDKError } from "../base";
+import type { RequestMetadata } from "../types";
+/**
+ * Error thrown when rate limit is exceeded (HTTP 429).
+ *
+ * This error is retriable after a delay. Check `retryAfterMs` for
+ * the recommended wait time.
+ *
+ * @example
+ * ```typescript
+ * import { RateLimitError } from '@djust-b2b/djust-front-sdk';
+ *
+ * try {
+ *   await sdk.searchProducts({ query: 'laptop' });
+ * } catch (error) {
+ *   if (error instanceof RateLimitError) {
+ *     const waitTime = error.retryAfterMs || 60000;
+ *     console.log(`Rate limited. Retry after ${waitTime}ms`);
+ *
+ *     // Wait and retry
+ *     await sleep(waitTime);
+ *     await sdk.searchProducts({ query: 'laptop' });
+ *   }
+ * }
+ * ```
+ */
+export declare class RateLimitError extends SDKError {
+    constructor(retryAfterMs?: number, details?: Record<string, unknown>, metadata?: RequestMetadata);
+    /**
+     * Returns the recommended wait time in seconds.
+     */
+    getRetryAfterSeconds(): number;
+    /**
+     * Creates a RateLimitError from HTTP 429 response.
+     */
+    static fromResponse(body: string, headers?: Headers, metadata?: RequestMetadata): RateLimitError;
+    /**
+     * Creates a RateLimitError with a specific retry delay.
+     */
+    static withDelay(seconds: number, metadata?: RequestMetadata): RateLimitError;
+}
+//# sourceMappingURL=rate-limit.error.d.ts.map

package/dist/errors/classes/rate-limit.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.error.d.ts","sourceRoot":"","sources":["../../../src/errors/classes/rate-limit.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,cAAe,SAAQ,QAAQ;gBAExC,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,CAAC,EAAE,eAAe;IAqB5B;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,eAAe,GACzB,cAAc;IAsCjB;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,eAAe,GACzB,cAAc;CAGlB"}

package/dist/errors/classes/server.error.d.ts

@@ -0,0 +1,63 @@
+/**
+ * DJUST SDK Server Error
+ * Errors for server-side failures (5xx).
+ *
+ * @module errors/classes/server
+ * @since 2.17.0
+ */
+import { SDKError } from "../base";
+import { type SDKErrorCodeType } from "../codes";
+import type { RequestMetadata } from "../types";
+/**
+ * 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');
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class ServerError extends SDKError {
+    constructor(message: string, httpStatus?: number, code?: SDKErrorCodeType, details?: Record<string, unknown>, metadata?: RequestMetadata);
+    /**
+     * Creates a ServerError for Internal Server Error (500).
+     */
+    static internalError(message?: string, metadata?: RequestMetadata): ServerError;
+    /**
+     * Creates a ServerError for Bad Gateway (502).
+     */
+    static badGateway(metadata?: RequestMetadata): ServerError;
+    /**
+     * Creates a ServerError for Service Unavailable (503).
+     */
+    static serviceUnavailable(retryAfterMs?: number, metadata?: RequestMetadata): ServerError;
+    /**
+     * Creates a ServerError for Gateway Timeout (504).
+     */
+    static gatewayTimeout(metadata?: RequestMetadata): ServerError;
+    /**
+     * Creates a ServerError from HTTP 5xx response.
+     */
+    static fromResponse(statusCode: number, body: string, headers?: Headers, metadata?: RequestMetadata): ServerError;
+    /**
+     * Checks if this is a transient error that will likely resolve on retry.
+     */
+    isTransient(): boolean;
+}
+//# sourceMappingURL=server.error.d.ts.map

package/dist/errors/classes/server.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.error.d.ts","sourceRoot":"","sources":["../../../src/errors/classes/server.error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,WAAY,SAAQ,QAAQ;gBAErC,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAAY,EACxB,IAAI,GAAE,gBAA4C,EAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,CAAC,EAAE,eAAe;IAc5B;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,eAAe,GACzB,WAAW;IAUd;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,WAAW;IAU1D;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,eAAe,GACzB,WAAW;IAgBd;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,WAAW;IAU9D;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,eAAe,GACzB,WAAW;IAwCd;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB"}

package/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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"}