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

package/lib/errors/guards.js

@@ -0,0 +1,281 @@
+"use strict";
+/**
+ * DJUST SDK Error Guards
+ * Type guards and utility functions for error handling.
+ *
+ * @module errors/guards
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSDKError = isSDKError;
+exports.isAuthError = isAuthError;
+exports.isForbiddenError = isForbiddenError;
+exports.isNetworkError = isNetworkError;
+exports.isTimeoutError = isTimeoutError;
+exports.isServerError = isServerError;
+exports.isValidationError = isValidationError;
+exports.isNotFoundError = isNotFoundError;
+exports.isRateLimitError = isRateLimitError;
+exports.isUnexpectedError = isUnexpectedError;
+exports.isRetryable = isRetryable;
+exports.getRetryDelay = getRetryDelay;
+exports.shouldReauthenticate = shouldReauthenticate;
+exports.isClientError = isClientError;
+exports.isTransientError = isTransientError;
+exports.extractStatusCode = extractStatusCode;
+exports.extractErrorCode = extractErrorCode;
+exports.getUserFriendlyMessage = getUserFriendlyMessage;
+const base_1 = require("./base");
+const codes_1 = require("./codes");
+const auth_error_1 = require("./classes/auth.error");
+const forbidden_error_1 = require("./classes/forbidden.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 validation_error_1 = require("./classes/validation.error");
+const not_found_error_1 = require("./classes/not-found.error");
+const rate_limit_error_1 = require("./classes/rate-limit.error");
+const unexpected_error_1 = require("./classes/unexpected.error");
+// ============================================================================
+// TYPE GUARDS
+// ============================================================================
+/**
+ * Checks if an error is an SDKError.
+ *
+ * @example
+ * ```typescript
+ * if (isSDKError(error)) {
+ *   console.log(error.code); // TypeScript knows it's SDKError
+ * }
+ * ```
+ */
+function isSDKError(error) {
+    return error instanceof base_1.SDKError;
+}
+/**
+ * Checks if an error is an AuthError (401).
+ */
+function isAuthError(error) {
+    return error instanceof auth_error_1.AuthError;
+}
+/**
+ * Checks if an error is a ForbiddenError (403).
+ */
+function isForbiddenError(error) {
+    return error instanceof forbidden_error_1.ForbiddenError;
+}
+/**
+ * Checks if an error is a NetworkError.
+ */
+function isNetworkError(error) {
+    return error instanceof network_error_1.NetworkError;
+}
+/**
+ * Checks if an error is a TimeoutError.
+ */
+function isTimeoutError(error) {
+    return error instanceof timeout_error_1.TimeoutError;
+}
+/**
+ * Checks if an error is a ServerError (5xx).
+ */
+function isServerError(error) {
+    return error instanceof server_error_1.ServerError;
+}
+/**
+ * Checks if an error is a ValidationError.
+ */
+function isValidationError(error) {
+    return error instanceof validation_error_1.ValidationError;
+}
+/**
+ * Checks if an error is a NotFoundError (404).
+ */
+function isNotFoundError(error) {
+    return error instanceof not_found_error_1.NotFoundError;
+}
+/**
+ * Checks if an error is a RateLimitError (429).
+ */
+function isRateLimitError(error) {
+    return error instanceof rate_limit_error_1.RateLimitError;
+}
+/**
+ * Checks if an error is an UnexpectedError.
+ */
+function isUnexpectedError(error) {
+    return error instanceof unexpected_error_1.UnexpectedError;
+}
+// ============================================================================
+// UTILITY FUNCTIONS
+// ============================================================================
+/**
+ * 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();
+ * }
+ * ```
+ */
+function isRetryable(error) {
+    if (error instanceof base_1.SDKError) {
+        return error.retriable;
+    }
+    // Network errors from fetch are typically retryable
+    if (error instanceof TypeError && error.message.includes("fetch")) {
+        return true;
+    }
+    return false;
+}
+/**
+ * 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)
+ */
+function getRetryDelay(error, attempt = 1, baseDelayMs = 1000) {
+    if (!isRetryable(error)) {
+        return undefined;
+    }
+    if (error instanceof base_1.SDKError && error.retryAfterMs) {
+        return error.retryAfterMs;
+    }
+    // Exponential backoff with jitter
+    const exponentialDelay = baseDelayMs * Math.pow(2, attempt - 1);
+    const jitter = Math.random() * 0.2 - 0.1; // ±10%
+    return Math.round(exponentialDelay * (1 + jitter));
+}
+/**
+ * Checks if an error indicates the user should re-authenticate.
+ *
+ * Returns true for:
+ * - Token expired
+ * - Token invalid
+ * - Token missing
+ */
+function shouldReauthenticate(error) {
+    if (error instanceof auth_error_1.AuthError) {
+        return error.shouldRedirectToLogin();
+    }
+    if (error instanceof base_1.SDKError) {
+        const reauthCodes = [
+            codes_1.SDKErrorCode.TOKEN_EXPIRED,
+            codes_1.SDKErrorCode.TOKEN_INVALID,
+            codes_1.SDKErrorCode.TOKEN_MISSING,
+        ];
+        return reauthCodes.includes(error.code);
+    }
+    return false;
+}
+/**
+ * Checks if an error is a client error (4xx).
+ */
+function isClientError(error) {
+    if (error instanceof base_1.SDKError) {
+        return error.httpStatus >= 400 && error.httpStatus < 500;
+    }
+    return false;
+}
+/**
+ * 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.
+ */
+function isTransientError(error) {
+    if (error instanceof server_error_1.ServerError) {
+        return error.isTransient();
+    }
+    if (error instanceof rate_limit_error_1.RateLimitError || error instanceof timeout_error_1.TimeoutError) {
+        return true;
+    }
+    if (error instanceof network_error_1.NetworkError) {
+        // Connection errors are often transient
+        return error.code !== codes_1.SDKErrorCode.DNS_ERROR;
+    }
+    return false;
+}
+/**
+ * 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();
+ * }
+ * ```
+ */
+function extractStatusCode(error) {
+    if (error instanceof base_1.SDKError) {
+        return error.httpStatus || null;
+    }
+    // Legacy format: "[API] Error 401: ..."
+    if (error instanceof Error) {
+        const match = error.message.match(/Error (\d{3}):/);
+        if (match) {
+            return parseInt(match[1], 10);
+        }
+    }
+    return null;
+}
+/**
+ * Extracts error code from an error.
+ */
+function extractErrorCode(error) {
+    if (error instanceof base_1.SDKError) {
+        return error.code;
+    }
+    return null;
+}
+/**
+ * Gets a user-friendly error message.
+ *
+ * Returns a safe message that can be shown to end users.
+ * Does not include sensitive details.
+ */
+function getUserFriendlyMessage(error) {
+    if (error instanceof base_1.SDKError) {
+        // For certain error types, provide generic messages
+        if (error instanceof server_error_1.ServerError) {
+            return "Service temporarily unavailable. Please try again later.";
+        }
+        if (error instanceof network_error_1.NetworkError) {
+            return "Unable to connect. Please check your internet connection.";
+        }
+        if (error instanceof timeout_error_1.TimeoutError) {
+            return "Request timed out. Please try again.";
+        }
+        if (error instanceof unexpected_error_1.UnexpectedError) {
+            return "An unexpected error occurred. Please try again.";
+        }
+        // For other errors, the message should be safe
+        return error.message;
+    }
+    if (error instanceof Error) {
+        // Be careful with unknown error messages
+        if (error.message.length < 100 && !error.message.includes("Error")) {
+            return error.message;
+        }
+        return "An error occurred. Please try again.";
+    }
+    return "An error occurred. Please try again.";
+}
+//# sourceMappingURL=guards.js.map

package/lib/errors/guards.js.map

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

package/lib/errors/helpers/djust-api-error.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Helpers for parsing DJUST API error response bodies.
+ *
+ * @module errors/helpers/djust-api-error
+ */
+export interface DjustApiErrorItem {
+    code?: string;
+    message?: string;
+    detail?: string;
+}
+export interface DjustApiErrorBody {
+    message?: string;
+    resource?: string;
+    id?: string;
+    errors?: DjustApiErrorItem[];
+}
+/**
+ * Parses a DJUST API error response body.
+ */
+export declare function parseDjustApiErrorBody(body: string): DjustApiErrorBody;
+/**
+ * Returns the most relevant error message from a DJUST API response body.
+ */
+export declare function extractDjustApiErrorMessage(body: string): string | undefined;
+/**
+ * Maps known DJUST error codes to a resource label for 404 responses.
+ */
+export declare function inferResourceFromDjustErrorCode(code?: string): string | undefined;
+//# sourceMappingURL=djust-api-error.d.ts.map

package/lib/errors/helpers/djust-api-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"djust-api-error.d.ts","sourceRoot":"","sources":["../../../src/errors/helpers/djust-api-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAMtE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAa5E;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAUpB"}

package/lib/errors/helpers/djust-api-error.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Helpers for parsing DJUST API error response bodies.
+ *
+ * @module errors/helpers/djust-api-error
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDjustApiErrorBody = parseDjustApiErrorBody;
+exports.extractDjustApiErrorMessage = extractDjustApiErrorMessage;
+exports.inferResourceFromDjustErrorCode = inferResourceFromDjustErrorCode;
+/**
+ * Parses a DJUST API error response body.
+ */
+function parseDjustApiErrorBody(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Returns the most relevant error message from a DJUST API response body.
+ */
+function extractDjustApiErrorMessage(body) {
+    const parsed = parseDjustApiErrorBody(body);
+    const apiError = parsed.errors?.find((error) => error.message?.trim());
+    if (apiError?.message) {
+        return apiError.message;
+    }
+    if (parsed.message?.trim()) {
+        return parsed.message;
+    }
+    return undefined;
+}
+/**
+ * Maps known DJUST error codes to a resource label for 404 responses.
+ */
+function inferResourceFromDjustErrorCode(code) {
+    if (!code)
+        return undefined;
+    const codeMap = {
+        STO0001: "Store",
+        USR0001: "User",
+        ACC0001: "Customer account",
+    };
+    return codeMap[code];
+}
+//# sourceMappingURL=djust-api-error.js.map

package/lib/errors/helpers/djust-api-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"djust-api-error.js","sourceRoot":"","sources":["../../../src/errors/helpers/djust-api-error.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAkBH,wDAMC;AAKD,kEAaC;AAKD,0EAYC;AA5CD;;GAEG;AACH,SAAgB,sBAAsB,CAAC,IAAY;IACjD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsB,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,2BAA2B,CAAC,IAAY;IACtD,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvE,IAAI,QAAQ,EAAE,OAAO,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,+BAA+B,CAC7C,IAAa;IAEb,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAE5B,MAAM,OAAO,GAA2B;QACtC,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,MAAM;QACf,OAAO,EAAE,kBAAkB;KAC5B,CAAC;IAEF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}

package/lib/errors/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * DJUST SDK Error Module
+ * Production-grade structured error handling.
+ *
+ * Architecture:
+ * - types.ts      - Type definitions
+ * - codes.ts      - Error code constants
+ * - base.ts       - SDKError base class
+ * - classes/      - Specific error types
+ * - factory.ts    - Error creation from responses
+ * - guards.ts     - Type guards and utilities
+ * - compat.ts     - Backward compatibility helpers
+ *
+ * @module errors
+ * @since 2.17.0
+ */
+export type { RequestMetadata, SDKErrorOptions, ErrorFactoryOptions, SerializedError, ClientSafeError, } from "./types";
+export { SDKErrorCode, RETRIABLE_ERROR_CODES, RETRIABLE_HTTP_STATUS_CODES, isRetriableCode, isRetriableStatus, } from "./codes";
+export type { SDKErrorCodeType } from "./codes";
+export { SDKError } from "./base";
+export { ValidationError, AuthError, ForbiddenError, NotFoundError, RateLimitError, NetworkError, TimeoutError, ServerError, UnexpectedError, } from "./classes";
+export { createErrorFromResponse, createErrorFromException } from "./factory";
+export { isSDKError, isAuthError, isForbiddenError, isNetworkError, isTimeoutError, isServerError, isValidationError, isNotFoundError, isRateLimitError, isUnexpectedError, isRetryable, getRetryDelay, shouldReauthenticate, isClientError, isTransientError, extractStatusCode, extractErrorCode, getUserFriendlyMessage, } from "./guards";
+export { toLegacyError, fromLegacyError, isLegacyError, parseLegacyError, withLegacyErrors, withStructuredErrors, isApiError, getHttpStatus, } from "./compat";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,YAAY,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,2BAA2B,EAC3B,eAAe,EACf,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAMhD,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAMlC,OAAO,EACL,eAAe,EACf,SAAS,EACT,cAAc,EACd,aAAa,EACb,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,eAAe,GAChB,MAAM,WAAW,CAAC;AAMnB,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAM9E,OAAO,EAEL,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EAGjB,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,aAAa,EACb,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,aAAa,GACd,MAAM,UAAU,CAAC"}

package/lib/errors/index.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * DJUST SDK Error Module
+ * Production-grade structured error handling.
+ *
+ * Architecture:
+ * - types.ts      - Type definitions
+ * - codes.ts      - Error code constants
+ * - base.ts       - SDKError base class
+ * - classes/      - Specific error types
+ * - factory.ts    - Error creation from responses
+ * - guards.ts     - Type guards and utilities
+ * - compat.ts     - Backward compatibility helpers
+ *
+ * @module errors
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHttpStatus = exports.isApiError = exports.withStructuredErrors = exports.withLegacyErrors = exports.parseLegacyError = exports.isLegacyError = exports.fromLegacyError = exports.toLegacyError = exports.getUserFriendlyMessage = exports.extractErrorCode = exports.extractStatusCode = exports.isTransientError = exports.isClientError = exports.shouldReauthenticate = exports.getRetryDelay = exports.isRetryable = exports.isUnexpectedError = exports.isRateLimitError = exports.isNotFoundError = exports.isValidationError = exports.isServerError = exports.isTimeoutError = exports.isNetworkError = exports.isForbiddenError = exports.isAuthError = exports.isSDKError = exports.createErrorFromException = exports.createErrorFromResponse = exports.UnexpectedError = exports.ServerError = exports.TimeoutError = exports.NetworkError = exports.RateLimitError = exports.NotFoundError = exports.ForbiddenError = exports.AuthError = exports.ValidationError = exports.SDKError = exports.isRetriableStatus = exports.isRetriableCode = exports.RETRIABLE_HTTP_STATUS_CODES = exports.RETRIABLE_ERROR_CODES = exports.SDKErrorCode = void 0;
+// ============================================================================
+// ERROR CODES
+// ============================================================================
+var codes_1 = require("./codes");
+Object.defineProperty(exports, "SDKErrorCode", { enumerable: true, get: function () { return codes_1.SDKErrorCode; } });
+Object.defineProperty(exports, "RETRIABLE_ERROR_CODES", { enumerable: true, get: function () { return codes_1.RETRIABLE_ERROR_CODES; } });
+Object.defineProperty(exports, "RETRIABLE_HTTP_STATUS_CODES", { enumerable: true, get: function () { return codes_1.RETRIABLE_HTTP_STATUS_CODES; } });
+Object.defineProperty(exports, "isRetriableCode", { enumerable: true, get: function () { return codes_1.isRetriableCode; } });
+Object.defineProperty(exports, "isRetriableStatus", { enumerable: true, get: function () { return codes_1.isRetriableStatus; } });
+// ============================================================================
+// BASE ERROR CLASS
+// ============================================================================
+var base_1 = require("./base");
+Object.defineProperty(exports, "SDKError", { enumerable: true, get: function () { return base_1.SDKError; } });
+// ============================================================================
+// ERROR CLASSES
+// ============================================================================
+var classes_1 = require("./classes");
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return classes_1.ValidationError; } });
+Object.defineProperty(exports, "AuthError", { enumerable: true, get: function () { return classes_1.AuthError; } });
+Object.defineProperty(exports, "ForbiddenError", { enumerable: true, get: function () { return classes_1.ForbiddenError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return classes_1.NotFoundError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return classes_1.RateLimitError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return classes_1.NetworkError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return classes_1.TimeoutError; } });
+Object.defineProperty(exports, "ServerError", { enumerable: true, get: function () { return classes_1.ServerError; } });
+Object.defineProperty(exports, "UnexpectedError", { enumerable: true, get: function () { return classes_1.UnexpectedError; } });
+// ============================================================================
+// FACTORY FUNCTIONS
+// ============================================================================
+var factory_1 = require("./factory");
+Object.defineProperty(exports, "createErrorFromResponse", { enumerable: true, get: function () { return factory_1.createErrorFromResponse; } });
+Object.defineProperty(exports, "createErrorFromException", { enumerable: true, get: function () { return factory_1.createErrorFromException; } });
+// ============================================================================
+// TYPE GUARDS & UTILITIES
+// ============================================================================
+var guards_1 = require("./guards");
+// Type guards
+Object.defineProperty(exports, "isSDKError", { enumerable: true, get: function () { return guards_1.isSDKError; } });
+Object.defineProperty(exports, "isAuthError", { enumerable: true, get: function () { return guards_1.isAuthError; } });
+Object.defineProperty(exports, "isForbiddenError", { enumerable: true, get: function () { return guards_1.isForbiddenError; } });
+Object.defineProperty(exports, "isNetworkError", { enumerable: true, get: function () { return guards_1.isNetworkError; } });
+Object.defineProperty(exports, "isTimeoutError", { enumerable: true, get: function () { return guards_1.isTimeoutError; } });
+Object.defineProperty(exports, "isServerError", { enumerable: true, get: function () { return guards_1.isServerError; } });
+Object.defineProperty(exports, "isValidationError", { enumerable: true, get: function () { return guards_1.isValidationError; } });
+Object.defineProperty(exports, "isNotFoundError", { enumerable: true, get: function () { return guards_1.isNotFoundError; } });
+Object.defineProperty(exports, "isRateLimitError", { enumerable: true, get: function () { return guards_1.isRateLimitError; } });
+Object.defineProperty(exports, "isUnexpectedError", { enumerable: true, get: function () { return guards_1.isUnexpectedError; } });
+// Utility functions
+Object.defineProperty(exports, "isRetryable", { enumerable: true, get: function () { return guards_1.isRetryable; } });
+Object.defineProperty(exports, "getRetryDelay", { enumerable: true, get: function () { return guards_1.getRetryDelay; } });
+Object.defineProperty(exports, "shouldReauthenticate", { enumerable: true, get: function () { return guards_1.shouldReauthenticate; } });
+Object.defineProperty(exports, "isClientError", { enumerable: true, get: function () { return guards_1.isClientError; } });
+Object.defineProperty(exports, "isTransientError", { enumerable: true, get: function () { return guards_1.isTransientError; } });
+Object.defineProperty(exports, "extractStatusCode", { enumerable: true, get: function () { return guards_1.extractStatusCode; } });
+Object.defineProperty(exports, "extractErrorCode", { enumerable: true, get: function () { return guards_1.extractErrorCode; } });
+Object.defineProperty(exports, "getUserFriendlyMessage", { enumerable: true, get: function () { return guards_1.getUserFriendlyMessage; } });
+// ============================================================================
+// BACKWARD COMPATIBILITY
+// ============================================================================
+var compat_1 = require("./compat");
+Object.defineProperty(exports, "toLegacyError", { enumerable: true, get: function () { return compat_1.toLegacyError; } });
+Object.defineProperty(exports, "fromLegacyError", { enumerable: true, get: function () { return compat_1.fromLegacyError; } });
+Object.defineProperty(exports, "isLegacyError", { enumerable: true, get: function () { return compat_1.isLegacyError; } });
+Object.defineProperty(exports, "parseLegacyError", { enumerable: true, get: function () { return compat_1.parseLegacyError; } });
+Object.defineProperty(exports, "withLegacyErrors", { enumerable: true, get: function () { return compat_1.withLegacyErrors; } });
+Object.defineProperty(exports, "withStructuredErrors", { enumerable: true, get: function () { return compat_1.withStructuredErrors; } });
+Object.defineProperty(exports, "isApiError", { enumerable: true, get: function () { return compat_1.isApiError; } });
+Object.defineProperty(exports, "getHttpStatus", { enumerable: true, get: function () { return compat_1.getHttpStatus; } });
+//# sourceMappingURL=index.js.map

package/lib/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAcH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,iCAMiB;AALf,qGAAA,YAAY,OAAA;AACZ,8GAAA,qBAAqB,OAAA;AACrB,oHAAA,2BAA2B,OAAA;AAC3B,wGAAA,eAAe,OAAA;AACf,0GAAA,iBAAiB,OAAA;AAKnB,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,+BAAkC;AAAzB,gGAAA,QAAQ,OAAA;AAEjB,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,qCAUmB;AATjB,0GAAA,eAAe,OAAA;AACf,oGAAA,SAAS,OAAA;AACT,yGAAA,cAAc,OAAA;AACd,wGAAA,aAAa,OAAA;AACb,yGAAA,cAAc,OAAA;AACd,uGAAA,YAAY,OAAA;AACZ,uGAAA,YAAY,OAAA;AACZ,sGAAA,WAAW,OAAA;AACX,0GAAA,eAAe,OAAA;AAGjB,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,qCAA8E;AAArE,kHAAA,uBAAuB,OAAA;AAAE,mHAAA,wBAAwB,OAAA;AAE1D,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,mCAsBkB;AArBhB,cAAc;AACd,oGAAA,UAAU,OAAA;AACV,qGAAA,WAAW,OAAA;AACX,0GAAA,gBAAgB,OAAA;AAChB,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AACd,uGAAA,aAAa,OAAA;AACb,2GAAA,iBAAiB,OAAA;AACjB,yGAAA,eAAe,OAAA;AACf,0GAAA,gBAAgB,OAAA;AAChB,2GAAA,iBAAiB,OAAA;AAEjB,oBAAoB;AACpB,qGAAA,WAAW,OAAA;AACX,uGAAA,aAAa,OAAA;AACb,8GAAA,oBAAoB,OAAA;AACpB,uGAAA,aAAa,OAAA;AACb,0GAAA,gBAAgB,OAAA;AAChB,2GAAA,iBAAiB,OAAA;AACjB,0GAAA,gBAAgB,OAAA;AAChB,gHAAA,sBAAsB,OAAA;AAGxB,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,mCASkB;AARhB,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AACf,uGAAA,aAAa,OAAA;AACb,0GAAA,gBAAgB,OAAA;AAChB,0GAAA,gBAAgB,OAAA;AAChB,8GAAA,oBAAoB,OAAA;AACpB,oGAAA,UAAU,OAAA;AACV,uGAAA,aAAa,OAAA"}

package/lib/errors/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * DJUST SDK Error Types
+ * Type definitions for the error system.
+ *
+ * @module errors/types
+ * @since 2.17.0
+ */
+import type { SDKErrorCodeType } from "./codes";
+/**
+ * Metadata attached to errors for debugging and observability.
+ * Contains request context without sensitive data.
+ */
+export interface RequestMetadata {
+    /** Unique request identifier for log correlation */
+    requestId?: string;
+    /** API endpoint path (e.g., "/v1/shop/carts") */
+    endpoint?: string;
+    /** HTTP method (GET, POST, etc.) */
+    method?: string;
+    /** Request duration in milliseconds */
+    durationMs?: number;
+    /** Service or provider name */
+    service?: string;
+    /** SDK method name (e.g., "updateCommercialOrderLines") */
+    sdkMethod?: string;
+    /** Retry attempt number (1-based) */
+    attempt?: number;
+    /** Query parameters (sanitized, no sensitive data) */
+    queryParams?: Record<string, unknown>;
+    /** Request body (sanitized, no sensitive data like passwords/tokens) */
+    body?: unknown;
+    /** Outbound request headers (sanitized, no secrets) */
+    headers?: Record<string, string>;
+}
+/**
+ * Options for constructing an SDKError.
+ */
+export interface SDKErrorOptions {
+    /** Stable error code for programmatic handling */
+    code: SDKErrorCodeType;
+    /** Human-readable error message */
+    message: string;
+    /** HTTP status code (0 for non-HTTP errors) */
+    httpStatus?: number;
+    /** Additional structured details (non-sensitive) */
+    details?: Record<string, unknown>;
+    /** Original error that caused this error */
+    cause?: Error;
+    /** Whether the operation can be retried */
+    retriable?: boolean;
+    /** Suggested delay before retry in milliseconds */
+    retryAfterMs?: number;
+    /** Request context metadata */
+    metadata?: RequestMetadata;
+}
+/**
+ * Options for creating errors from HTTP responses.
+ */
+export interface ErrorFactoryOptions {
+    /** HTTP response status code */
+    statusCode: number;
+    /** Response body as string */
+    body: string;
+    /** Request URL */
+    url?: string;
+    /** HTTP method */
+    method?: string;
+    /** Request duration in milliseconds */
+    durationMs?: number;
+    /** Request correlation ID */
+    requestId?: string;
+    /** SDK method name (e.g., "updateCommercialOrderLines") */
+    sdkMethod?: string;
+    /** Query parameters from the request */
+    queryParams?: Record<string, unknown>;
+    /** Request body (will be sanitized in metadata) */
+    requestBody?: unknown;
+    /** Outbound request headers (sanitized, no secrets) */
+    requestHeaders?: Record<string, string>;
+}
+/**
+ * JSON-serializable error representation for logging.
+ */
+export interface SerializedError {
+    name: string;
+    code: SDKErrorCodeType;
+    message: string;
+    httpStatus: number;
+    retriable: boolean;
+    retryAfterMs?: number;
+    details: Record<string, unknown>;
+    metadata: RequestMetadata;
+    timestamp: string;
+}
+/**
+ * Client-safe error representation (no sensitive data).
+ */
+export interface ClientSafeError {
+    code: SDKErrorCodeType;
+    message: string;
+    httpStatus: number;
+    retriable: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAMhD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,IAAI,EAAE,gBAAgB,CAAC;IAEvB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAEhB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IAEnB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IAEb,kBAAkB;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/lib/errors/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * DJUST SDK Error Types
+ * Type definitions for the error system.
+ *
+ * @module errors/types
+ * @since 2.17.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/errors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}