@thorprovider/adapters 4.2.1 → 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, 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
@@ -1368,6 +1369,153 @@ declare function validateChannelScopeAssignment(entityId: string, channelId: str
  */
 declare function assertEntityBelongsToChannel(entity: ChannelScopeable, expectedChannelId: string): void;
 
+/**
+ * @fileoverview Medusa Multi-Tenant Admin Client
+ * @module @thorprovider/adapters/providers/medusa/admin
+ *
+ * Wrapper methods for all `/admin/thor/` endpoints defined in the Thor Commerce
+ * multi-tenant API contract.  Requires an admin API key (`adminConfig.apiKey`)
+ * to be provided when creating the Medusa provider.
+ *
+ * Every method performs a raw `fetch` against the Medusa backend using the
+ * admin API key (`x-medusa-access-token`) — the Medusa JS-SDK's admin client
+ * does not expose these custom Thor plugin routes, so we use direct HTTP calls.
+ *
+ * Endpoint reference: `multitenant-api-contract.md`
+ */
+
+/**
+ * Configuration required to instantiate the admin client.
+ */
+interface MedusaAdminClientConfig {
+    /** Medusa backend base URL */
+    baseUrl: string;
+    /** Secret admin API key (x-medusa-access-token) */
+    apiKey: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * HTTP client for Thor Commerce multi-tenant admin endpoints (`/admin/thor/`).
+ *
+ * All methods throw `ProviderAPIError` on non-2xx responses.
+ *
+ * @example
+ * ```typescript
+ * const admin = new MedusaAdminClient({
+ *   baseUrl: process.env.MEDUSA_BACKEND_URL!,
+ *   apiKey: process.env.MEDUSA_ADMIN_API_KEY!,
+ * });
+ *
+ * const { customers } = await admin.getChannelCustomers('sc_01JXXXXX');
+ * ```
+ */
+declare class MedusaAdminClient {
+    private baseUrl;
+    private apiKey;
+    private logger;
+    constructor(config: MedusaAdminClientConfig);
+    private request;
+    /**
+     * Paginated list of customers linked to a sales channel.
+     *
+     * `GET /admin/thor/sales-channels/:id/customers`
+     */
+    getChannelCustomers(salesChannelId: string, options?: GetChannelCustomersOptions): Promise<GetChannelCustomersResponse>;
+    /**
+     * Publishable API keys associated with a sales channel.
+     *
+     * `GET /admin/thor/sales-channels/:id/api-keys`
+     */
+    getChannelApiKeys(salesChannelId: string): Promise<GetChannelApiKeysResponse>;
+    /**
+     * Product categories assigned to a sales channel.
+     *
+     * `GET /admin/thor/sales-channels/:id/categories`
+     */
+    getChannelCategories(salesChannelId: string, options?: GetChannelCategoriesOptions): Promise<GetChannelCategoriesResponse>;
+    /**
+     * Sales channels to which a category is assigned.
+     *
+     * `GET /admin/thor/categories/:id/sales-channels`
+     */
+    getCategorySalesChannels(categoryId: string): Promise<GetCategorySalesChannelsResponse>;
+    /**
+     * Assign a category to one or more sales channels (idempotent).
+     *
+     * `POST /admin/thor/categories/:id/sales-channels`
+     */
+    assignCategoryToChannels(categoryId: string, body: AssignCategoriesToChannelsBody): Promise<AssignCategoriesToChannelsResponse>;
+    /**
+     * Remove category assignment from one or more sales channels (idempotent).
+     *
+     * `DELETE /admin/thor/categories/:id/sales-channels`
+     */
+    unassignCategoryFromChannels(categoryId: string, body: UnassignCategoriesFromChannelsBody): Promise<UnassignCategoriesFromChannelsResponse>;
+    /**
+     * Sales channels to which a collection is assigned.
+     *
+     * `GET /admin/thor/collections/:id/sales-channels`
+     */
+    getCollectionSalesChannels(collectionId: string): Promise<GetCollectionSalesChannelsResponse>;
+    /**
+     * Assign a collection to one or more sales channels (idempotent).
+     *
+     * `POST /admin/thor/collections/:id/sales-channels`
+     */
+    assignCollectionToChannels(collectionId: string, body: AssignCollectionsToChannelsBody): Promise<AssignCollectionsToChannelsResponse>;
+    /**
+     * Remove collection assignment from one or more sales channels (idempotent).
+     *
+     * `DELETE /admin/thor/collections/:id/sales-channels`
+     */
+    unassignCollectionFromChannels(collectionId: string, body: UnassignCollectionsFromChannelsBody): Promise<UnassignCollectionsFromChannelsResponse>;
+    /**
+     * Read the visual storefront configuration for a channel.
+     * `:id` is the `sales_channel_id`.
+     *
+     * `GET /admin/thor/storefront-config/:id`
+     */
+    getStorefrontConfig(salesChannelId: string): Promise<GetAdminStorefrontConfigResponse>;
+    /**
+     * Update the visual storefront configuration for a channel.
+     * Triggers the `storefront_config.updated` event → ISR webhook.
+     *
+     * `PUT /admin/thor/storefront-config/:id`
+     */
+    updateStorefrontConfig(salesChannelId: string, body: UpdateStorefrontConfigBody): Promise<UpdateStorefrontConfigResponse>;
+    /**
+     * Read the active Site Designer configuration for a channel, including the
+     * last 10 history entries.
+     *
+     * `GET /admin/thor/site-config/:sales_channel_id`
+     */
+    getSiteConfig(salesChannelId: string): Promise<GetAdminSiteConfigResponse>;
+    /**
+     * Update the Site Designer configuration for a channel.
+     * Creates a new history entry on every PUT.
+     *
+     * `PUT /admin/thor/site-config/:sales_channel_id`
+     */
+    updateSiteConfig(salesChannelId: string, body: UpdateSiteConfigBody): Promise<UpdateSiteConfigResponse>;
+    /**
+     * Full paginated history of Site Designer versions for a channel.
+     * Entries are immutable — they are never deleted.
+     *
+     * `GET /admin/thor/site-config/:sales_channel_id/history`
+     */
+    getSiteConfigHistory(salesChannelId: string, options?: GetAdminSiteConfigHistoryOptions): Promise<GetAdminSiteConfigHistoryResponse>;
+    /**
+     * Restore a previous Site Designer version.
+     * Internally runs the update workflow with the stored config of the target
+     * version — this creates a **new** history entry and does NOT mutate past
+     * entries.
+     *
+     * `POST /admin/thor/site-config/:sales_channel_id/restore/:version`
+     */
+    restoreSiteConfig(salesChannelId: string, version: string): Promise<RestoreSiteConfigResponse>;
+}
+
 /**
  * Medusa provider configuration
  */
@@ -1459,6 +1607,18 @@ declare class MedusaProvider implements CommerceProvider {
      * Only created when adminConfig.apiKey is provided.
      */
     private sdkAdmin?;
+    /**
+     * Admin client for Thor multi-tenant endpoints (`/admin/thor/`).
+     * Available when `adminConfig.apiKey` is provided.
+     *
+     * @example
+     * ```typescript
+     * const { customers } = await commerce.admin.getChannelCustomers('sc_01JXXXXX');
+     * const { api_keys } = await commerce.admin.getChannelApiKeys('sc_01JXXXXX');
+     * await commerce.admin.updateStorefrontConfig('sc_01JXXXXX', { theme_accent_color: '#EF4444', ... });
+     * ```
+     */
+    readonly admin?: MedusaAdminClient;
     /** Cached distinct product status values — rarely changes, cached for process lifetime */
     private _cachedProductStatuses;
     /**
@@ -2144,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;
@@ -2617,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;
+/**
+ * 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;
 /**
- * Supported provider types (imported from @thorprovider/types L1)
- * Kept for backward compatibility; prefer ProviderTypeString from @thorprovider/types
+ * 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';
@@ -2646,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
@@ -2680,8 +2520,6 @@ type RuntimeProviderConfig = {
  *     publishableKey: process.env.MEDUSA_PUBLISHABLE_KEY,
  *   }
  * });
- *
- * const products = await commerce.getProducts();
  * ```
  */
 declare function createProvider(options: ProviderFactoryConfig | RuntimeProviderConfig): CommerceProvider;
@@ -2690,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 };