@thorprovider/adapters 4.3.0 → 5.0.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _thorprovider_types from '@thorprovider/types';
-import { BackendCapabilities, Money, PaymentMethod, FulfillmentOption, CartItem, StockLocation, InventoryLevel, StorefrontConfig, DashboardMetrics, ProviderTypeString, GetChannelCustomersOptions, GetChannelCustomersResponse, GetChannelApiKeysResponse, GetChannelCategoriesOptions, GetChannelCategoriesResponse, GetCategorySalesChannelsResponse, AssignCategoriesToChannelsBody, AssignCategoriesToChannelsResponse, UnassignCategoriesFromChannelsBody, UnassignCategoriesFromChannelsResponse, GetCollectionSalesChannelsResponse, AssignCollectionsToChannelsBody, AssignCollectionsToChannelsResponse, UnassignCollectionsFromChannelsBody, UnassignCollectionsFromChannelsResponse, GetAdminStorefrontConfigResponse, UpdateStorefrontConfigBody, UpdateStorefrontConfigResponse, GetAdminSiteConfigResponse, UpdateSiteConfigBody, UpdateSiteConfigResponse, GetAdminSiteConfigHistoryOptions, GetAdminSiteConfigHistoryResponse, RestoreSiteConfigResponse, CommerceProvider, AuthProvider, ProviderConfig, AuthConfig, Product, GetProductsOptions, AdvancedSearchProductsOptions, SearchResultMeta, FilterConfig, Collection, GetCollectionsOptions, CollectionProductsOptions, ProductCategory, GetCategoriesOptions, Cart, CartLineInput, CartLineUpdate, GetOrdersOptions, Order, GetCustomersOptions, Customer, Address, Region, AdminProduct, PaymentMethodsOptions, StockValidation, StorefrontContext, DesignerConfig, DesignerHistoryEntry, ShippingMethod, Country } from '@thorprovider/types';
+import { BackendCapabilities, Money, PaymentMethod, FulfillmentOption, CartItem, StockLocation, InventoryLevel, StorefrontConfig, DashboardMetrics, ProviderTypeString, GetChannelCustomersOptions, GetChannelCustomersResponse, GetChannelApiKeysResponse, GetChannelCategoriesOptions, GetChannelCategoriesResponse, GetCategorySalesChannelsResponse, AssignCategoriesToChannelsBody, AssignCategoriesToChannelsResponse, UnassignCategoriesFromChannelsBody, UnassignCategoriesFromChannelsResponse, GetCollectionSalesChannelsResponse, AssignCollectionsToChannelsBody, AssignCollectionsToChannelsResponse, UnassignCollectionsFromChannelsBody, UnassignCollectionsFromChannelsResponse, GetAdminStorefrontConfigResponse, UpdateStorefrontConfigBody, UpdateStorefrontConfigResponse, GetAdminSiteConfigResponse, UpdateSiteConfigBody, UpdateSiteConfigResponse, GetAdminSiteConfigHistoryOptions, GetAdminSiteConfigHistoryResponse, RestoreSiteConfigResponse, CommerceProvider, AuthProvider, ProviderConfig, AuthConfig, Product, GetProductsOptions, AdvancedSearchProductsOptions, SearchResultMeta, FilterConfig, Collection, GetCollectionsOptions, CollectionProductsOptions, ProductCategory, GetCategoriesOptions, Cart, CartLineInput, CartLineUpdate, GetOrdersOptions, Order, GetCustomersOptions, Customer, Address, Region, AdminProduct, PaymentMethodsOptions, StockValidation, StorefrontContext, DesignerConfig, DesignerHistoryEntry, Country, ShippingMethod } from '@thorprovider/types';
 export * from '@thorprovider/types';
 export { BackendCapabilities, CommerceProvider, DesignerConfig, DesignerHistoryEntry, DesignerNavItem, DesignerThemeConfig, DesignerThemePreset, ProviderConfig, StorefrontConfig, StorefrontConfigError, StorefrontContext, StorefrontPlatformType, StorefrontSeoDefaults } from '@thorprovider/types';
 import Medusa from '@medusajs/js-sdk';
@@ -246,36 +246,6 @@ declare const MEDUSA_CAPABILITIES: Readonly<BackendCapabilities>;
  * but without cart, checkout, customer auth, or storefront-native payment flows.
  */
 declare const STELORDER_CAPABILITIES: Readonly<BackendCapabilities>;
-/**
- * Shopify backend capabilities
- *
- * @see https://shopify.dev/docs/api/storefront
- */
-declare const SHOPIFY_CAPABILITIES: Readonly<BackendCapabilities>;
-/**
- * BigCommerce backend capabilities
- *
- * @see https://developer.bigcommerce.com/docs/rest-storefront
- */
-declare const BIGCOMMERCE_CAPABILITIES: Readonly<BackendCapabilities>;
-/**
- * WooCommerce backend capabilities
- *
- * @see https://developer.woocommerce.com/docs/apis/store-api
- */
-declare const WOOCOMMERCE_CAPABILITIES: Readonly<BackendCapabilities>;
-/**
- * Spree Commerce backend capabilities
- *
- * @see https://docs.spreecommerce.org/api-reference
- */
-declare const SPREE_CAPABILITIES: Readonly<BackendCapabilities>;
-/**
- * Adobe Commerce / Magento backend capabilities
- *
- * @see https://developer.adobe.com/commerce/webapi/graphql/
- */
-declare const MAGENTO_CAPABILITIES: Readonly<BackendCapabilities>;
 /**
  * Type guard to check if an object is a valid BackendCapabilities
  */
@@ -322,6 +292,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 +352,32 @@ 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>;
 
 /**
  * Circuit Breaker Pattern Implementation
@@ -2303,330 +2304,6 @@ declare class MedusaProvider implements CommerceProvider {
     }>;
 }
 
-/**
- * Shopify provider configuration
- */
-interface ShopifyProviderConfig extends ProviderConfig {
-    /** Store domain (e.g., 'your-store.myshopify.com') */
-    storeDomain: string;
-    /** Public Storefront API access token */
-    publicAccessToken: string;
-    /** Private Storefront API access token (server-side only) */
-    privateAccessToken?: string;
-    /** API version (default: '2026-04') */
-    apiVersion?: string;
-}
-/**
- * Shopify commerce provider
- *
- * Implements CommerceProvider for Shopify Storefront API.
- * Uses raw fetch + GraphQL queries (no SDK dependency to stay L2-pure).
- */
-declare class ShopifyProvider implements CommerceProvider {
-    readonly name = "shopify";
-    readonly version = "1.0.0";
-    readonly capabilities: BackendCapabilities;
-    private logger;
-    private storeDomain;
-    private apiVersion;
-    private endpoint;
-    private headers;
-    constructor(config: ShopifyProviderConfig);
-    private query;
-    getProduct(handle: string): Promise<Product | undefined>;
-    getProducts(options?: GetProductsOptions): Promise<Product[]>;
-    getProductRecommendations(productId: string): Promise<Product[]>;
-    getCollection(handle: string): Promise<Collection | undefined>;
-    getCollections(options?: GetCollectionsOptions): Promise<Collection[]>;
-    getCollectionProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
-    getCategory(): Promise<ProductCategory | undefined>;
-    getCategories(): Promise<ProductCategory[]>;
-    getCategoryProducts(): Promise<Product[]>;
-    createCart(): Promise<Cart>;
-    getCart(cartId: string): Promise<Cart | undefined>;
-    addToCart(cartId: string, lines: CartLineInput[]): Promise<Cart>;
-    removeFromCart(cartId: string, lineIds: string[]): Promise<Cart>;
-    updateCart(cartId: string, lines: CartLineUpdate[]): Promise<Cart>;
-    completeCheckout(_cartId: string): Promise<Order>;
-    getShippingMethods(_cartId: string): Promise<ShippingMethod[]>;
-    getRegionCountries(): Promise<_thorprovider_types.Country[]>;
-    addShippingMethod(_cartId: string, _methodId: string): Promise<Cart>;
-    initiatePaymentSession(_cartId: string, _providerId: string): Promise<void>;
-    applyDiscountCode(cartId: string, code: string): Promise<Cart>;
-    removeDiscountCode(cartId: string, _code: string): Promise<Cart>;
-    getOrders(options: GetOrdersOptions): Promise<Order[]>;
-    getPaymentMethods(_options: PaymentMethodsOptions): Promise<PaymentMethod[]>;
-    getStockLocations(): Promise<StockLocation[]>;
-    checkInventoryLevels(): Promise<InventoryLevel[]>;
-    validateCartStock(): Promise<StockValidation>;
-    getFulfillmentOptions(): Promise<FulfillmentOption[]>;
-    cancelOrder(_orderId: string): Promise<Order>;
-    createFulfillment(_orderId: string): Promise<void>;
-    createRefund(_orderId: string): Promise<void>;
-    getAdminOrders(): Promise<{
-        orders: Order[];
-        count: number;
-    }>;
-    getStorefrontContext(): Promise<StorefrontContext>;
-    isStorefrontRequired(): boolean;
-}
-
-/**
- * BigCommerce provider configuration
- */
-interface BigCommerceProviderConfig extends ProviderConfig {
-    /** BigCommerce store hash */
-    storeHash: string;
-    /** Storefront API token (JWT) */
-    storefrontApiToken: string;
-    /** Storefront API URL (usually https://store-{hash}.mybigcommerce.com) */
-    storefrontApiUrl: string;
-    /** Channel ID */
-    channelId: string;
-    /** Default currency code (default: 'USD') */
-    currencyCode?: string;
-}
-declare class BigCommerceProvider implements CommerceProvider {
-    readonly name = "bigcommerce";
-    readonly version = "1.0.0";
-    readonly capabilities: BackendCapabilities;
-    private logger;
-    private storefrontApiUrl;
-    private storeHash;
-    private channelId;
-    private currencyCode;
-    private headers;
-    constructor(config: BigCommerceProviderConfig);
-    private fetchApi;
-    getProduct(handle: string): Promise<Product | undefined>;
-    getProducts(options?: GetProductsOptions): Promise<Product[]>;
-    getProductRecommendations(_productId: string): Promise<Product[]>;
-    getCollection(handle: string): Promise<Collection | undefined>;
-    getCollections(options?: GetCollectionsOptions): Promise<Collection[]>;
-    getCollectionProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
-    getCategory(idOrHandle: string): Promise<ProductCategory | undefined>;
-    getCategories(options?: GetCategoriesOptions): Promise<ProductCategory[]>;
-    getCategoryProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
-    createCart(): Promise<Cart>;
-    getCart(cartId: string): Promise<Cart | undefined>;
-    addToCart(cartId: string, lines: CartLineInput[]): Promise<Cart>;
-    removeFromCart(cartId: string, lineIds: string[]): Promise<Cart>;
-    updateCart(cartId: string, lines: CartLineUpdate[]): Promise<Cart>;
-    completeCheckout(_cartId: string): Promise<Order>;
-    getShippingMethods(_cartId: string): Promise<ShippingMethod[]>;
-    getRegionCountries(): Promise<_thorprovider_types.Country[]>;
-    addShippingMethod(_cartId: string, _methodId: string): Promise<Cart>;
-    initiatePaymentSession(_cartId: string, _providerId: string): Promise<void>;
-    applyDiscountCode(cartId: string, code: string): Promise<Cart>;
-    removeDiscountCode(cartId: string, code: string): Promise<Cart>;
-    getOrders(_options: GetOrdersOptions): Promise<Order[]>;
-    getPaymentMethods(_options: PaymentMethodsOptions): Promise<PaymentMethod[]>;
-    getStockLocations(): Promise<StockLocation[]>;
-    checkInventoryLevels(): Promise<InventoryLevel[]>;
-    validateCartStock(): Promise<StockValidation>;
-    getFulfillmentOptions(): Promise<FulfillmentOption[]>;
-    cancelOrder(_orderId: string): Promise<Order>;
-    createFulfillment(_orderId: string): Promise<void>;
-    createRefund(_orderId: string): Promise<void>;
-    getAdminOrders(): Promise<{
-        orders: Order[];
-        count: number;
-    }>;
-    getStorefrontContext(): Promise<StorefrontContext>;
-    isStorefrontRequired(): boolean;
-}
-
-/**
- * WooCommerce provider configuration
- */
-interface WooCommerceProviderConfig extends ProviderConfig {
-    /** WordPress site URL (e.g., 'https://mystore.com') */
-    url: string;
-    /** WooCommerce REST API consumer key (for authenticated operations) */
-    consumerKey?: string;
-    /** WooCommerce REST API consumer secret (for authenticated operations) */
-    consumerSecret?: string;
-    /** Default currency code (default: 'USD') */
-    currencyCode?: string;
-}
-declare class WooCommerceProvider implements CommerceProvider {
-    readonly name = "woocommerce";
-    readonly version = "1.0.0";
-    readonly capabilities: BackendCapabilities;
-    private logger;
-    private baseUrl;
-    private storeApiBase;
-    private restApiBase;
-    private currencyCode;
-    private authHeader?;
-    constructor(config: WooCommerceProviderConfig);
-    private storeApiFetch;
-    private restApiFetch;
-    getProduct(handle: string): Promise<Product | undefined>;
-    getProducts(options?: GetProductsOptions): Promise<Product[]>;
-    getProductRecommendations(_productId: string): Promise<Product[]>;
-    getCollection(handle: string): Promise<Collection | undefined>;
-    getCollections(options?: GetCollectionsOptions): Promise<Collection[]>;
-    getCollectionProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
-    getCategory(idOrHandle: string): Promise<ProductCategory | undefined>;
-    getCategories(options?: GetCategoriesOptions): Promise<ProductCategory[]>;
-    getCategoryProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
-    createCart(): Promise<Cart>;
-    getCart(_cartId: string): Promise<Cart | undefined>;
-    addToCart(_cartId: string, lines: CartLineInput[]): Promise<Cart>;
-    removeFromCart(_cartId: string, lineIds: string[]): Promise<Cart>;
-    updateCart(_cartId: string, lines: CartLineUpdate[]): Promise<Cart>;
-    completeCheckout(_cartId: string): Promise<Order>;
-    getShippingMethods(_cartId: string): Promise<ShippingMethod[]>;
-    getRegionCountries(): Promise<_thorprovider_types.Country[]>;
-    addShippingMethod(_cartId: string, methodId: string): Promise<Cart>;
-    initiatePaymentSession(_cartId: string, _providerId: string): Promise<void>;
-    applyDiscountCode(_cartId: string, code: string): Promise<Cart>;
-    removeDiscountCode(_cartId: string, code: string): Promise<Cart>;
-    getOrders(_options: GetOrdersOptions): Promise<Order[]>;
-    getPaymentMethods(_options: PaymentMethodsOptions): Promise<PaymentMethod[]>;
-    getStockLocations(): Promise<StockLocation[]>;
-    checkInventoryLevels(): Promise<InventoryLevel[]>;
-    validateCartStock(): Promise<StockValidation>;
-    getFulfillmentOptions(): Promise<FulfillmentOption[]>;
-    cancelOrder(_orderId: string): Promise<Order>;
-    createFulfillment(_orderId: string): Promise<void>;
-    createRefund(_orderId: string): Promise<void>;
-    getAdminOrders(): Promise<{
-        orders: Order[];
-        count: number;
-    }>;
-    getStorefrontContext(): Promise<StorefrontContext>;
-    isStorefrontRequired(): boolean;
-}
-
-/**
- * Spree provider configuration
- */
-interface SpreeProviderConfig extends ProviderConfig {
-    /** Spree store base URL (e.g., 'https://myspreestore.com') */
-    baseUrl: string;
-    /** Bearer token for authenticated operations (customer or OAuth) */
-    bearerToken?: string;
-    /** Default currency code (default: 'USD') */
-    currencyCode?: string;
-}
-declare class SpreeProvider implements CommerceProvider {
-    readonly name = "spree";
-    readonly version = "1.0.0";
-    readonly capabilities: BackendCapabilities;
-    private logger;
-    private baseUrl;
-    private apiBase;
-    private currencyCode;
-    private bearerToken?;
-    private orderToken?;
-    constructor(config: SpreeProviderConfig);
-    private apiFetch;
-    getProduct(handle: string): Promise<Product | undefined>;
-    getProducts(options?: GetProductsOptions): Promise<Product[]>;
-    getProductRecommendations(_productId: string): Promise<Product[]>;
-    getCollection(handle: string): Promise<Collection | undefined>;
-    getCollections(options?: GetCollectionsOptions): Promise<Collection[]>;
-    getCollectionProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
-    getCategory(handle: string): Promise<ProductCategory | undefined>;
-    getCategories(options?: GetCategoriesOptions): Promise<ProductCategory[]>;
-    getCategoryProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
-    createCart(): Promise<Cart>;
-    getCart(_cartId: string): Promise<Cart | undefined>;
-    addToCart(_cartId: string, lines: CartLineInput[]): Promise<Cart>;
-    removeFromCart(_cartId: string, lineIds: string[]): Promise<Cart>;
-    updateCart(_cartId: string, lines: CartLineUpdate[]): Promise<Cart>;
-    completeCheckout(_cartId: string): Promise<Order>;
-    getShippingMethods(_cartId: string): Promise<ShippingMethod[]>;
-    getRegionCountries(): Promise<_thorprovider_types.Country[]>;
-    addShippingMethod(_cartId: string, methodId: string): Promise<Cart>;
-    initiatePaymentSession(_cartId: string, _providerId: string): Promise<void>;
-    applyDiscountCode(_cartId: string, code: string): Promise<Cart>;
-    removeDiscountCode(_cartId: string, code: string): Promise<Cart>;
-    getOrders(_options: GetOrdersOptions): Promise<Order[]>;
-    getPaymentMethods(_options: PaymentMethodsOptions): Promise<PaymentMethod[]>;
-    getStockLocations(): Promise<StockLocation[]>;
-    checkInventoryLevels(): Promise<InventoryLevel[]>;
-    validateCartStock(): Promise<StockValidation>;
-    getFulfillmentOptions(): Promise<FulfillmentOption[]>;
-    cancelOrder(_orderId: string): Promise<Order>;
-    createFulfillment(_orderId: string): Promise<void>;
-    createRefund(_orderId: string): Promise<void>;
-    getAdminOrders(): Promise<{
-        orders: Order[];
-        count: number;
-    }>;
-    getStorefrontContext(): Promise<StorefrontContext>;
-    isStorefrontRequired(): boolean;
-}
-
-/**
- * Magento provider configuration
- */
-interface MagentoProviderConfig extends ProviderConfig {
-    /** Magento base URL (e.g., 'https://mymagento.com') */
-    baseUrl: string;
-    /** Store code for multi-tenant (default: 'default') */
-    storeCode?: string;
-    /** Customer bearer token (for authenticated operations) */
-    customerToken?: string;
-    /** Integration access token (for admin-level operations) */
-    accessToken?: string;
-    /** Default currency code (default: 'USD') */
-    currencyCode?: string;
-}
-declare class MagentoProvider implements CommerceProvider {
-    readonly name = "magento";
-    readonly version = "1.0.0";
-    readonly capabilities: BackendCapabilities;
-    private logger;
-    private baseUrl;
-    private storeCode;
-    private currencyCode;
-    private graphqlEndpoint;
-    private customerToken?;
-    private accessToken?;
-    constructor(config: MagentoProviderConfig);
-    private graphql;
-    getProduct(handle: string): Promise<Product | undefined>;
-    getProducts(options?: GetProductsOptions): Promise<Product[]>;
-    getProductRecommendations(_productId: string): Promise<Product[]>;
-    getCollection(handle: string): Promise<Collection | undefined>;
-    getCollections(options?: GetCollectionsOptions): Promise<Collection[]>;
-    getCollectionProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
-    getCategory(handle: string): Promise<ProductCategory | undefined>;
-    getCategories(options?: GetCategoriesOptions): Promise<ProductCategory[]>;
-    getCategoryProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
-    createCart(): Promise<Cart>;
-    getCart(cartId: string): Promise<Cart | undefined>;
-    addToCart(cartId: string, lines: CartLineInput[]): Promise<Cart>;
-    removeFromCart(cartId: string, lineIds: string[]): Promise<Cart>;
-    updateCart(cartId: string, lines: CartLineUpdate[]): Promise<Cart>;
-    completeCheckout(_cartId: string): Promise<Order>;
-    getShippingMethods(_cartId: string): Promise<ShippingMethod[]>;
-    getRegionCountries(): Promise<_thorprovider_types.Country[]>;
-    addShippingMethod(_cartId: string, _methodId: string): Promise<Cart>;
-    initiatePaymentSession(_cartId: string, _providerId: string): Promise<void>;
-    applyDiscountCode(cartId: string, code: string): Promise<Cart>;
-    removeDiscountCode(cartId: string, _code: string): Promise<Cart>;
-    getOrders(_options: GetOrdersOptions): Promise<Order[]>;
-    getPaymentMethods(_options: PaymentMethodsOptions): Promise<PaymentMethod[]>;
-    getStockLocations(): Promise<StockLocation[]>;
-    checkInventoryLevels(): Promise<InventoryLevel[]>;
-    validateCartStock(): Promise<StockValidation>;
-    getFulfillmentOptions(): Promise<FulfillmentOption[]>;
-    cancelOrder(_orderId: string): Promise<Order>;
-    createFulfillment(_orderId: string): Promise<void>;
-    createRefund(_orderId: string): Promise<void>;
-    getAdminOrders(): Promise<{
-        orders: Order[];
-        count: number;
-    }>;
-    getStorefrontContext(): Promise<StorefrontContext>;
-    isStorefrontRequired(): boolean;
-}
-
 interface StelOrderProviderConfig extends ProviderConfig {
     baseUrl: string;
     apiKey?: string;
@@ -2776,24 +2453,40 @@ declare class MockProvider implements CommerceProvider {
 }
 
 /**
- * @thorprovider/adapters v2.0
- * Provider Factory - Create commerce providers dynamically
+ * @thorprovider/adapters v5.0
+ * Provider Factory - Dynamic registry pattern
+ *
+ * Providers register themselves at import time via `registerProvider()`.
+ * The factory no longer statically imports every backend — only the ones
+ * the consumer explicitly imports will be available.
  *
- * This factory is bound to SupportedProviderType from @thorprovider/types (L1).
- * When adding a new provider:
- * 1. Update SupportedProviderType enum in packages/types/src/provider.ts
- * 2. Add new discriminated union case here
- * 3. Create packages/adapters/src/providers/[platform]/
- * 4. Implement CommerceProvider interface
+ * Built-in providers (medusa, stelorder, mock) are registered automatically.
  */
 
+type ProviderFactory = (config: any) => CommerceProvider;
 /**
- * Supported provider types (imported from @thorprovider/types L1)
- * Kept for backward compatibility; prefer ProviderTypeString from @thorprovider/types
+ * Register a provider factory for a given type string.
+ * Call this to make a provider available to `createProvider()`.
+ *
+ * @example
+ * ```ts
+ * import { registerProvider } from '@thorprovider/adapters';
+ * import { MyProvider } from './my-provider';
+ *
+ * registerProvider('my-provider', (config) => new MyProvider(config));
+ * ```
+ */
+declare function registerProvider(type: string, factory: ProviderFactory): void;
+/**
+ * Get all registered provider type strings.
  */
-type ProviderType = ProviderTypeString;
+declare function getRegisteredProviders(): string[];
 /**
- * Provider configuration discriminated union
+ * Supported provider types
+ */
+type ProviderType = ProviderTypeString | (string & {});
+/**
+ * Provider configuration discriminated union (built-in providers)
  */
 type ProviderFactoryConfig = {
     provider: 'mock';
@@ -2805,30 +2498,18 @@ type ProviderFactoryConfig = {
     provider: 'stelorder';
     config: StelOrderProviderConfig;
 } | {
-    provider: 'shopify';
-    config: ShopifyProviderConfig;
-} | {
-    provider: 'bigcommerce';
-    config: BigCommerceProviderConfig;
-} | {
-    provider: 'woocommerce';
-    config: WooCommerceProviderConfig;
-} | {
-    provider: 'spree';
-    config: SpreeProviderConfig;
-} | {
-    provider: 'magento';
-    config: MagentoProviderConfig;
+    provider: string;
+    config: Record<string, unknown>;
 };
 /**
- * Runtime provider configuration (accepts any ProviderTypeString from env vars)
+ * Runtime provider configuration (accepts any registered provider string)
  */
 type RuntimeProviderConfig = {
-    provider: ProviderTypeString;
+    provider: string;
     config: Record<string, unknown>;
 };
 /**
- * Create a commerce provider instance
+ * Create a commerce provider instance from the registry.
  *
  * @example
  * ```ts
@@ -2839,8 +2520,6 @@ type RuntimeProviderConfig = {
  *     publishableKey: process.env.MEDUSA_PUBLISHABLE_KEY,
  *   }
  * });
- *
- * const products = await commerce.getProducts();
  * ```
  */
 declare function createProvider(options: ProviderFactoryConfig | RuntimeProviderConfig): CommerceProvider;
@@ -2849,4 +2528,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, type BackendMapping, type BackendMetadataAdapter, type BackendMetadataAdapterConfig, 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, MEDUSA_CAPABILITIES, MOCK_CAPABILITIES, MedusaMetadataAdapter, MedusaProvider, type MedusaProviderConfig, type MetricsOrderInput, type MetricsProductInput, MetricsService, MockProvider, type MockProviderConfig, type PlanFulfillmentShippingAddress, ProviderAPIError, type ProviderFactoryConfig, ProviderNotFoundError, type ProviderType, ResourceNotFoundError, type RetryConfig, STELORDER_CAPABILITIES, StelOrderProvider, type StelOrderProviderConfig, type UICartItem, type UICartTotals, type UIDiscountCode, type UIPaymentMethod, type UIShippingMethod, assertEntityBelongsToChannel, backendCircuitBreaker, buildChannelScopeMetadata, calculateDistance, createBackendMetadataAdapter, createLogger, createProvider, extractErrorMessage, fetchWithRetry, filterByChannel, filterGlobalOnly, geocodeAddress, getBackendProviderId, getCapabilityDescription, getChannelScope, getRegisteredProviders, isBackendCapabilities, isGlobalEntity, isProviderType, isScopedToChannel, moneyToNumber, moneyToNumberSafe, numberToMoney, partitionByChannel, planFulfillment, registerProvider, transformFulfillmentOption, transformInventoryLevel, transformStockLocation, transformStorefrontConfig, validateAssignedBy, validateChannelId, validateChannelScopeAssignment, validateEntityId, validatePaymentId };