@thorprovider/adapters 4.2.1 → 4.2.2

package/dist/index.d.mts

@@ -322,6 +322,11 @@ declare class ProviderAPIError extends CommerceError {
     readonly provider: string;
     constructor(message: string, provider: string, status?: number);
 }
+/**
+ * Extract error message from various error types
+ * Handles standard Error objects, API responses, and unknown error types
+ */
+declare function extractErrorMessage(error: unknown): string;
 
 /**
  * @thorprovider/adapters v2.0
@@ -377,6 +382,51 @@ interface RetryConfig {
      */
     retryableStatusCodes?: number[];
 }
+/**
+ * Enhanced fetch with retry logic and timeout
+ *
+ * @example
+ * ```typescript
+ * import { fetchWithRetry } from '@thorprovider/adapters/core/fetch-utils';
+ *
+ * // Basic usage with defaults (3 retries, 10s timeout)
+ * const response = await fetchWithRetry('https://api.example.com/products');
+ *
+ * // Custom configuration
+ * const response = await fetchWithRetry(
+ *   'https://api.example.com/products',
+ *   {
+ *     method: 'POST',
+ *     body: JSON.stringify({ name: 'Product' }),
+ *   },
+ *   {
+ *     maxRetries: 5,
+ *     timeoutMs: 15000, // 15 seconds
+ *     initialDelayMs: 500,
+ *   }
+ * );
+ * ```
+ */
+declare function fetchWithRetry(url: string, init?: RequestInit, retryConfig?: RetryConfig): Promise<Response>;
+/**
+ * Create a fetch function with custom retry configuration
+ * Useful for creating a configured fetch instance
+ *
+ * @example
+ * ```typescript
+ * import { createFetchWithRetry } from '@thorprovider/adapters/core/fetch-utils';
+ *
+ * // Create configured fetch
+ * const customFetch = createFetchWithRetry({
+ *   maxRetries: 5,
+ *   timeoutMs: 15000,
+ * });
+ *
+ * // Use it like regular fetch
+ * const response = await customFetch('https://api.example.com/products');
+ * ```
+ */
+declare function createFetchWithRetry(retryConfig?: RetryConfig): (url: string, init?: RequestInit) => Promise<Response>;
 
 /**
  * Circuit Breaker Pattern Implementation
@@ -2690,4 +2740,4 @@ declare function createProvider(options: ProviderFactoryConfig | RuntimeProvider
  */
 declare function isProviderType<T extends ProviderType>(provider: CommerceProvider, type: T): boolean;
 
-export { AdminAuthService, type AdminSession, AdminSessionService, BIGCOMMERCE_CAPABILITIES, type BackendMapping, type BackendMetadataAdapter, type BackendMetadataAdapterConfig, BigCommerceProvider, type BigCommerceProviderConfig, CHANNEL_ASSIGNED_AT_KEY, CHANNEL_ASSIGNED_BY_KEY, CHANNEL_SCOPE_KEY, type ChannelScopeMetadata, ChannelScopeValidationError, type ChannelScopeable, CircuitBreaker, type CircuitBreakerConfig, CircuitBreakerOpenError, type CircuitBreakerStats, type CircuitState, CommerceError, ConfigurationError, type Coordinates, type FulfillmentGroup, type FulfillmentPlan, type LogLevel, type Logger, MAGENTO_CAPABILITIES, MEDUSA_CAPABILITIES, MOCK_CAPABILITIES, MagentoProvider, type MagentoProviderConfig, MedusaMetadataAdapter, MedusaProvider, type MedusaProviderConfig, type MetricsOrderInput, type MetricsProductInput, MetricsService, MockProvider, type MockProviderConfig, type PlanFulfillmentShippingAddress, ProviderAPIError, type ProviderFactoryConfig, ProviderNotFoundError, type ProviderType, ResourceNotFoundError, SHOPIFY_CAPABILITIES, SPREE_CAPABILITIES, STELORDER_CAPABILITIES, ShopifyProvider, type ShopifyProviderConfig, SpreeProvider, type SpreeProviderConfig, StelOrderProvider, type StelOrderProviderConfig, type UICartItem, type UICartTotals, type UIDiscountCode, type UIPaymentMethod, type UIShippingMethod, WOOCOMMERCE_CAPABILITIES, WooCommerceProvider, type WooCommerceProviderConfig, assertEntityBelongsToChannel, backendCircuitBreaker, buildChannelScopeMetadata, calculateDistance, createBackendMetadataAdapter, createLogger, createProvider, filterByChannel, filterGlobalOnly, geocodeAddress, getBackendProviderId, getCapabilityDescription, getChannelScope, isBackendCapabilities, isGlobalEntity, isProviderType, isScopedToChannel, moneyToNumber, moneyToNumberSafe, numberToMoney, partitionByChannel, planFulfillment, transformFulfillmentOption, transformInventoryLevel, transformStockLocation, transformStorefrontConfig, validateAssignedBy, validateChannelId, validateChannelScopeAssignment, validateEntityId, validatePaymentId };
+export { AdminAuthService, type AdminSession, AdminSessionService, BIGCOMMERCE_CAPABILITIES, type BackendMapping, type BackendMetadataAdapter, type BackendMetadataAdapterConfig, BigCommerceProvider, type BigCommerceProviderConfig, CHANNEL_ASSIGNED_AT_KEY, CHANNEL_ASSIGNED_BY_KEY, CHANNEL_SCOPE_KEY, type ChannelScopeMetadata, ChannelScopeValidationError, type ChannelScopeable, CircuitBreaker, type CircuitBreakerConfig, CircuitBreakerOpenError, type CircuitBreakerStats, type CircuitState, CommerceError, ConfigurationError, type Coordinates, type FulfillmentGroup, type FulfillmentPlan, type LogLevel, type Logger, MAGENTO_CAPABILITIES, MEDUSA_CAPABILITIES, MOCK_CAPABILITIES, MagentoProvider, type MagentoProviderConfig, MedusaMetadataAdapter, MedusaProvider, type MedusaProviderConfig, type MetricsOrderInput, type MetricsProductInput, MetricsService, MockProvider, type MockProviderConfig, type PlanFulfillmentShippingAddress, ProviderAPIError, type ProviderFactoryConfig, ProviderNotFoundError, type ProviderType, ResourceNotFoundError, type RetryConfig, SHOPIFY_CAPABILITIES, SPREE_CAPABILITIES, STELORDER_CAPABILITIES, ShopifyProvider, type ShopifyProviderConfig, SpreeProvider, type SpreeProviderConfig, StelOrderProvider, type StelOrderProviderConfig, type UICartItem, type UICartTotals, type UIDiscountCode, type UIPaymentMethod, type UIShippingMethod, WOOCOMMERCE_CAPABILITIES, WooCommerceProvider, type WooCommerceProviderConfig, assertEntityBelongsToChannel, backendCircuitBreaker, buildChannelScopeMetadata, calculateDistance, createBackendMetadataAdapter, createFetchWithRetry, createLogger, createProvider, extractErrorMessage, fetchWithRetry, filterByChannel, filterGlobalOnly, geocodeAddress, getBackendProviderId, getCapabilityDescription, getChannelScope, isBackendCapabilities, isGlobalEntity, isProviderType, isScopedToChannel, moneyToNumber, moneyToNumberSafe, numberToMoney, partitionByChannel, planFulfillment, transformFulfillmentOption, transformInventoryLevel, transformStockLocation, transformStorefrontConfig, validateAssignedBy, validateChannelId, validateChannelScopeAssignment, validateEntityId, validatePaymentId };

package/dist/index.d.ts

@@ -322,6 +322,11 @@ declare class ProviderAPIError extends CommerceError {
     readonly provider: string;
     constructor(message: string, provider: string, status?: number);
 }
+/**
+ * Extract error message from various error types
+ * Handles standard Error objects, API responses, and unknown error types
+ */
+declare function extractErrorMessage(error: unknown): string;
 
 /**
  * @thorprovider/adapters v2.0
@@ -377,6 +382,51 @@ interface RetryConfig {
      */
     retryableStatusCodes?: number[];
 }
+/**
+ * Enhanced fetch with retry logic and timeout
+ *
+ * @example
+ * ```typescript
+ * import { fetchWithRetry } from '@thorprovider/adapters/core/fetch-utils';
+ *
+ * // Basic usage with defaults (3 retries, 10s timeout)
+ * const response = await fetchWithRetry('https://api.example.com/products');
+ *
+ * // Custom configuration
+ * const response = await fetchWithRetry(
+ *   'https://api.example.com/products',
+ *   {
+ *     method: 'POST',
+ *     body: JSON.stringify({ name: 'Product' }),
+ *   },
+ *   {
+ *     maxRetries: 5,
+ *     timeoutMs: 15000, // 15 seconds
+ *     initialDelayMs: 500,
+ *   }
+ * );
+ * ```
+ */
+declare function fetchWithRetry(url: string, init?: RequestInit, retryConfig?: RetryConfig): Promise<Response>;
+/**
+ * Create a fetch function with custom retry configuration
+ * Useful for creating a configured fetch instance
+ *
+ * @example
+ * ```typescript
+ * import { createFetchWithRetry } from '@thorprovider/adapters/core/fetch-utils';
+ *
+ * // Create configured fetch
+ * const customFetch = createFetchWithRetry({
+ *   maxRetries: 5,
+ *   timeoutMs: 15000,
+ * });
+ *
+ * // Use it like regular fetch
+ * const response = await customFetch('https://api.example.com/products');
+ * ```
+ */
+declare function createFetchWithRetry(retryConfig?: RetryConfig): (url: string, init?: RequestInit) => Promise<Response>;
 
 /**
  * Circuit Breaker Pattern Implementation
@@ -2690,4 +2740,4 @@ declare function createProvider(options: ProviderFactoryConfig | RuntimeProvider
  */
 declare function isProviderType<T extends ProviderType>(provider: CommerceProvider, type: T): boolean;
 
-export { AdminAuthService, type AdminSession, AdminSessionService, BIGCOMMERCE_CAPABILITIES, type BackendMapping, type BackendMetadataAdapter, type BackendMetadataAdapterConfig, BigCommerceProvider, type BigCommerceProviderConfig, CHANNEL_ASSIGNED_AT_KEY, CHANNEL_ASSIGNED_BY_KEY, CHANNEL_SCOPE_KEY, type ChannelScopeMetadata, ChannelScopeValidationError, type ChannelScopeable, CircuitBreaker, type CircuitBreakerConfig, CircuitBreakerOpenError, type CircuitBreakerStats, type CircuitState, CommerceError, ConfigurationError, type Coordinates, type FulfillmentGroup, type FulfillmentPlan, type LogLevel, type Logger, MAGENTO_CAPABILITIES, MEDUSA_CAPABILITIES, MOCK_CAPABILITIES, MagentoProvider, type MagentoProviderConfig, MedusaMetadataAdapter, MedusaProvider, type MedusaProviderConfig, type MetricsOrderInput, type MetricsProductInput, MetricsService, MockProvider, type MockProviderConfig, type PlanFulfillmentShippingAddress, ProviderAPIError, type ProviderFactoryConfig, ProviderNotFoundError, type ProviderType, ResourceNotFoundError, SHOPIFY_CAPABILITIES, SPREE_CAPABILITIES, STELORDER_CAPABILITIES, ShopifyProvider, type ShopifyProviderConfig, SpreeProvider, type SpreeProviderConfig, StelOrderProvider, type StelOrderProviderConfig, type UICartItem, type UICartTotals, type UIDiscountCode, type UIPaymentMethod, type UIShippingMethod, WOOCOMMERCE_CAPABILITIES, WooCommerceProvider, type WooCommerceProviderConfig, assertEntityBelongsToChannel, backendCircuitBreaker, buildChannelScopeMetadata, calculateDistance, createBackendMetadataAdapter, createLogger, createProvider, filterByChannel, filterGlobalOnly, geocodeAddress, getBackendProviderId, getCapabilityDescription, getChannelScope, isBackendCapabilities, isGlobalEntity, isProviderType, isScopedToChannel, moneyToNumber, moneyToNumberSafe, numberToMoney, partitionByChannel, planFulfillment, transformFulfillmentOption, transformInventoryLevel, transformStockLocation, transformStorefrontConfig, validateAssignedBy, validateChannelId, validateChannelScopeAssignment, validateEntityId, validatePaymentId };
+export { AdminAuthService, type AdminSession, AdminSessionService, BIGCOMMERCE_CAPABILITIES, type BackendMapping, type BackendMetadataAdapter, type BackendMetadataAdapterConfig, BigCommerceProvider, type BigCommerceProviderConfig, CHANNEL_ASSIGNED_AT_KEY, CHANNEL_ASSIGNED_BY_KEY, CHANNEL_SCOPE_KEY, type ChannelScopeMetadata, ChannelScopeValidationError, type ChannelScopeable, CircuitBreaker, type CircuitBreakerConfig, CircuitBreakerOpenError, type CircuitBreakerStats, type CircuitState, CommerceError, ConfigurationError, type Coordinates, type FulfillmentGroup, type FulfillmentPlan, type LogLevel, type Logger, MAGENTO_CAPABILITIES, MEDUSA_CAPABILITIES, MOCK_CAPABILITIES, MagentoProvider, type MagentoProviderConfig, MedusaMetadataAdapter, MedusaProvider, type MedusaProviderConfig, type MetricsOrderInput, type MetricsProductInput, MetricsService, MockProvider, type MockProviderConfig, type PlanFulfillmentShippingAddress, ProviderAPIError, type ProviderFactoryConfig, ProviderNotFoundError, type ProviderType, ResourceNotFoundError, type RetryConfig, SHOPIFY_CAPABILITIES, SPREE_CAPABILITIES, STELORDER_CAPABILITIES, ShopifyProvider, type ShopifyProviderConfig, SpreeProvider, type SpreeProviderConfig, StelOrderProvider, type StelOrderProviderConfig, type UICartItem, type UICartTotals, type UIDiscountCode, type UIPaymentMethod, type UIShippingMethod, WOOCOMMERCE_CAPABILITIES, WooCommerceProvider, type WooCommerceProviderConfig, assertEntityBelongsToChannel, backendCircuitBreaker, buildChannelScopeMetadata, calculateDistance, createBackendMetadataAdapter, createFetchWithRetry, createLogger, createProvider, extractErrorMessage, fetchWithRetry, filterByChannel, filterGlobalOnly, geocodeAddress, getBackendProviderId, getCapabilityDescription, getChannelScope, isBackendCapabilities, isGlobalEntity, isProviderType, isScopedToChannel, moneyToNumber, moneyToNumberSafe, numberToMoney, partitionByChannel, planFulfillment, transformFulfillmentOption, transformInventoryLevel, transformStockLocation, transformStorefrontConfig, validateAssignedBy, validateChannelId, validateChannelScopeAssignment, validateEntityId, validatePaymentId };

package/dist/index.js

@@ -67,8 +67,11 @@ __export(src_exports, {
   buildChannelScopeMetadata: () => buildChannelScopeMetadata,
   calculateDistance: () => calculateDistance,
   createBackendMetadataAdapter: () => createBackendMetadataAdapter,
+  createFetchWithRetry: () => createFetchWithRetry,
   createLogger: () => createLogger,
   createProvider: () => createProvider,
+  extractErrorMessage: () => extractErrorMessage,
+  fetchWithRetry: () => fetchWithRetry,
   filterByChannel: () => filterByChannel,
   filterGlobalOnly: () => filterGlobalOnly,
   geocodeAddress: () => geocodeAddress,
@@ -617,6 +620,9 @@ async function fetchWithRetry(url, init, retryConfig) {
   }
   throw lastError;
 }
+function createFetchWithRetry(retryConfig) {
+  return (url, init) => fetchWithRetry(url, init, retryConfig);
+}
 
 // src/resilience/circuit-breaker.ts
 var CircuitBreaker = class {
@@ -10208,8 +10214,11 @@ function isProviderType(provider, type) {
   buildChannelScopeMetadata,
   calculateDistance,
   createBackendMetadataAdapter,
+  createFetchWithRetry,
   createLogger,
   createProvider,
+  extractErrorMessage,
+  fetchWithRetry,
   filterByChannel,
   filterGlobalOnly,
   geocodeAddress,