@thorprovider/adapters 4.1.0 → 4.2.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 4.2.1
+
+### Patch Changes
+
+- Fix the published export map so bundlers do not resolve the `development` condition to an incomplete source graph. The package now resolves development/import/default entrypoints to built `dist` files, preventing Turbopack module-resolution failures in consumers.
+
+## 4.2.0
+
+### Minor Changes
+
+- 926be1f: Add mock-provider support across published packages and align the starter for mock-first storefront creation.
+
+### Patch Changes
+
+- Updated dependencies [926be1f]
+  - @thorprovider/types@3.2.0
+
 ## 4.1.0
 
 ### Minor Changes

package/README.md

@@ -1,3 +1,9 @@
+---
+title: "@thorprovider/adapters"
+purpose: "Explain the adapter package, its value proposition, and how to use the unified commerce provider layer"
+lastReviewed: "2026-05-01"
+---
+
 # @thorprovider/adapters v2.0
 
 **Unified commerce adapters for Thor Commerce ecosystem**
@@ -125,7 +131,9 @@ Need e-commerce backend integration?
 ### Supported Providers
 
 Currently implemented:
+- ✅ **Mock** — Fixture-backed provider for local development, previews, and backend-optional storefront bootstrapping
 - ✅ **Medusa JS** (v2) — Full implementation with multi-tenant support
+- ✅ **Stel Order** — ERP adapter (v1): catalog, categories, inventory, customers, orders, payment/delivery listing. No cart/checkout/auth (single-company ERP).
 
 Planned (Phase 2–3):
 - 🟡 **Shopify** — In progress
@@ -137,7 +145,15 @@ Planned (Phase 2–3):
 ### Provider Selection
 
 ```typescript
-// Medusa backend (currently the only supported provider)
+// Mock provider (safe default for preview / development)
+const mockCommerce = createProvider({
+  provider: 'mock',
+  config: {
+    currencyCode: 'USD',
+  }
+});
+
+// Medusa backend
 const commerce = createProvider({
   provider: 'medusa',
   config: {
@@ -147,6 +163,17 @@ const commerce = createProvider({
   }
 });
 
+// Stel Order ERP (catalog + CRM read/write, no cart/checkout)
+const stelCommerce = createProvider({
+  provider: 'stelorder',
+  config: {
+    baseUrl: 'https://your-company.stelorder.com/app',
+    apiKey: process.env.STEL_ORDER_API_KEY,
+    currencyCode: 'EUR',
+    companyName: 'My Company',
+  }
+});
+
 const products = await commerce.getProducts();
 ```
 
@@ -423,10 +450,11 @@ if (commerce.capabilities.updateEmail) {
 | Platform | Status | Documentation |
 |----------|--------|---------------|
 | **Medusa v2** | ✅ Production Ready | [Medusa Docs](https://docs.medusajs.com/) |
+| **Stel Order** | ✅ ERP Adapter (v1) | Catalog, CRM, orders — no cart/checkout/auth |
 | **Shopify** | 🚧 Planned | [Shopify API](https://shopify.dev/api/storefront) |
 | **WooCommerce** | 🗓️ Roadmap | [WooCommerce API](https://woocommerce.github.io/woocommerce-rest-api-docs/) |
 | **BigCommerce** | 🗓️ Roadmap | [BigCommerce API](https://developer.bigcommerce.com/) |
-| **Local (Mock)** | 🗓️ Roadmap | For testing |
+| **Local (Mock)** | ✅ Production Ready | For testing, previews, and backend-optional storefronts |
 
 **See**: [Providers Overview](./docs/providers-overview.md)
 
@@ -450,6 +478,11 @@ if (commerce.capabilities.updateEmail) {
 - [Add New Service](../../docs/workflows/legacy/add-adapter-service.md) - Service workflow
 - [Type Definitions](./src/types/) - Full TypeScript types
 
+### Testing
+- Unit/integration tests: `yarn workspace @thorprovider/adapters test`
+- Optional live Stel smoke test: `STEL_ORDER_SMOKE_TEST=1 STEL_ORDER_BASE_URL=... STEL_ORDER_API_KEY=... yarn workspace @thorprovider/adapters test:live`
+- Live smoke stays read-only unless `STEL_ORDER_TEST_CUSTOMER_ID` is explicitly set
+
 ---
 
 ## Examples
@@ -569,6 +602,7 @@ const products = await commerce.getProducts();
 ├── types/              # Unified types (Product, Cart, etc.)
 ├── providers/          # Provider implementations
 │   ├── medusa/         # Medusa v2 provider
+│   ├── stelorder/      # Stel Order ERP adapter
 │   └── shopify/        # (coming soon)
 ├── core/               # Core utilities (errors, logger)
 └── factory/            # Provider factory

package/dist/index.d.mts

@@ -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 } 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';
 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';
@@ -225,12 +225,27 @@ interface UIPaymentMethod {
  * @see packages/core/docs/COMMERCE_PROVIDER_ARCHITECTURE.md
  */
 
+/**
+ * Mock backend capabilities
+ *
+ * Fixture-backed provider used when a storefront has not yet been connected
+ * to a real backend. Supports the minimum commerce flows needed for layout,
+ * preview, navigation, region switching, and cart prototyping.
+ */
+declare const MOCK_CAPABILITIES: Readonly<BackendCapabilities>;
 /**
  * Medusa backend capabilities
  *
  * @see https://docs.medusajs.com/api/store
  */
 declare const MEDUSA_CAPABILITIES: Readonly<BackendCapabilities>;
+/**
+ * Stel Order backend capabilities
+ *
+ * ERP/document API with catalog, CRM, inventory visibility, and sales documents,
+ * but without cart, checkout, customer auth, or storefront-native payment flows.
+ */
+declare const STELORDER_CAPABILITIES: Readonly<BackendCapabilities>;
 /**
  * Shopify backend capabilities
  *
@@ -2453,6 +2468,154 @@ declare class MagentoProvider implements CommerceProvider {
     isStorefrontRequired(): boolean;
 }
 
+interface StelOrderProviderConfig extends ProviderConfig {
+    baseUrl: string;
+    apiKey?: string;
+    publishableKey?: string;
+    currencyCode?: string;
+    companyName?: string;
+    storefrontId?: string;
+    retry?: RetryConfig;
+}
+
+declare class StelOrderProvider implements CommerceProvider {
+    readonly name = "stelorder";
+    readonly version = "1.0.0";
+    readonly capabilities: BackendCapabilities;
+    private readonly client;
+    private readonly logger;
+    private readonly currencyCode;
+    private readonly storefrontId;
+    private readonly companyName;
+    constructor(config: StelOrderProviderConfig);
+    getProduct(handle: string, _options?: {
+        regionId?: string;
+    }): Promise<Product | undefined>;
+    getProducts(options?: GetProductsOptions): Promise<Product[]>;
+    getProductRecommendations(_productId: string): Promise<Product[]>;
+    getCategory(idOrHandle: string): Promise<ProductCategory | undefined>;
+    getCategories(options?: GetCategoriesOptions): Promise<ProductCategory[]>;
+    getCategoryProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
+    getCollection(handle: string): Promise<Collection | undefined>;
+    getCollections(options?: GetCollectionsOptions): Promise<Collection[]>;
+    getCollectionProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
+    getStockLocations(_params?: {
+        salesChannelId?: string;
+    }): Promise<StockLocation[]>;
+    checkInventoryLevels(variantId: string, _salesChannelId?: string): Promise<InventoryLevel[]>;
+    validateCartStock(_cartId: string): Promise<StockValidation>;
+    getFulfillmentOptions(_cartId: string, _salesChannelId: string): Promise<FulfillmentOption[]>;
+    createCart(_options?: {
+        regionId?: string;
+    }): 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>;
+    getRegionCountries(_regionId: string): Promise<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>;
+    getPaymentMethods(_options: PaymentMethodsOptions): Promise<PaymentMethod[]>;
+    getShippingMethods(_cartId: string): Promise<ShippingMethod[]>;
+    getCustomer(customerId: string): Promise<Customer | undefined>;
+    getCustomers(options?: GetCustomersOptions): Promise<Customer[]>;
+    updateCustomer(customerId: string, data: Partial<Omit<Customer, 'id' | 'createdAt'>>): Promise<Customer>;
+    getOrder(orderId: string): Promise<Order | undefined>;
+    getOrders(options: GetOrdersOptions): Promise<Order[]>;
+    getAdminOrders(options?: {
+        search?: string;
+        status?: string | string[];
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        orders: Order[];
+        count: number;
+    }>;
+    cancelOrder(_orderId: string): Promise<Order>;
+    createFulfillment(_orderId: string, _items?: Array<{
+        id: string;
+        quantity: number;
+    }>): Promise<void>;
+    createRefund(_orderId: string, _amount?: number, _reason?: string): Promise<void>;
+    getStorefrontContext(): Promise<StorefrontContext>;
+    isStorefrontRequired(): boolean;
+    private notSupported;
+    private wrapError;
+}
+
+interface MockProviderConfig extends ProviderConfig {
+    currencyCode?: string;
+    siteUrl?: string;
+}
+declare class MockProvider implements CommerceProvider {
+    readonly name = "mock";
+    readonly version = "1.0.0";
+    readonly capabilities: Readonly<_thorprovider_types.BackendCapabilities>;
+    readonly isMock = true;
+    private readonly currencyCode;
+    private readonly siteUrl;
+    constructor(config?: MockProviderConfig);
+    private hasVariant;
+    getProduct(handle: string, options?: {
+        regionId?: 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(options?: {
+        regionId?: string;
+    }): 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>;
+    getRegions(): Promise<Array<{
+        id: string;
+        name: string;
+        currency_code: string;
+        countries?: Array<{
+            id: string;
+            iso_2: string;
+            name: string;
+            display_name?: string;
+        }>;
+    }>>;
+    completeCheckout(cartId: string): Promise<Order>;
+    getShippingMethods(cartId: string): Promise<ShippingMethod[]>;
+    getRegionCountries(regionId: string): 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(variantId: string): Promise<InventoryLevel[]>;
+    validateCartStock(cartId: string): Promise<StockValidation>;
+    getFulfillmentOptions(cartId: string, _salesChannelId: string): Promise<FulfillmentOption[]>;
+    cancelOrder(orderId: string): Promise<Order>;
+    createFulfillment(_orderId: string, _items?: Array<{
+        id: string;
+        quantity: number;
+    }>): Promise<void>;
+    createRefund(orderId: string, _amount?: number, _reason?: string): Promise<void>;
+    getAdminOrders(): Promise<{
+        orders: Order[];
+        count: number;
+    }>;
+    getAdminRegions(): Promise<Region[]>;
+    getStorefrontContext(): Promise<StorefrontContext>;
+    isStorefrontRequired(): boolean;
+}
+
 /**
  * @thorprovider/adapters v2.0
  * Provider Factory - Create commerce providers dynamically
@@ -2474,8 +2637,14 @@ type ProviderType = ProviderTypeString;
  * Provider configuration discriminated union
  */
 type ProviderFactoryConfig = {
+    provider: 'mock';
+    config: MockProviderConfig;
+} | {
     provider: 'medusa';
     config: MedusaProviderConfig;
+} | {
+    provider: 'stelorder';
+    config: StelOrderProviderConfig;
 } | {
     provider: 'shopify';
     config: ShopifyProviderConfig;
@@ -2521,4 +2690,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, MagentoProvider, type MagentoProviderConfig, MedusaMetadataAdapter, MedusaProvider, type MedusaProviderConfig, type MetricsOrderInput, type MetricsProductInput, MetricsService, type PlanFulfillmentShippingAddress, ProviderAPIError, type ProviderFactoryConfig, ProviderNotFoundError, type ProviderType, ResourceNotFoundError, SHOPIFY_CAPABILITIES, SPREE_CAPABILITIES, ShopifyProvider, type ShopifyProviderConfig, SpreeProvider, type SpreeProviderConfig, 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, 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 };

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 } 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';
 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';
@@ -225,12 +225,27 @@ interface UIPaymentMethod {
  * @see packages/core/docs/COMMERCE_PROVIDER_ARCHITECTURE.md
  */
 
+/**
+ * Mock backend capabilities
+ *
+ * Fixture-backed provider used when a storefront has not yet been connected
+ * to a real backend. Supports the minimum commerce flows needed for layout,
+ * preview, navigation, region switching, and cart prototyping.
+ */
+declare const MOCK_CAPABILITIES: Readonly<BackendCapabilities>;
 /**
  * Medusa backend capabilities
  *
  * @see https://docs.medusajs.com/api/store
  */
 declare const MEDUSA_CAPABILITIES: Readonly<BackendCapabilities>;
+/**
+ * Stel Order backend capabilities
+ *
+ * ERP/document API with catalog, CRM, inventory visibility, and sales documents,
+ * but without cart, checkout, customer auth, or storefront-native payment flows.
+ */
+declare const STELORDER_CAPABILITIES: Readonly<BackendCapabilities>;
 /**
  * Shopify backend capabilities
  *
@@ -2453,6 +2468,154 @@ declare class MagentoProvider implements CommerceProvider {
     isStorefrontRequired(): boolean;
 }
 
+interface StelOrderProviderConfig extends ProviderConfig {
+    baseUrl: string;
+    apiKey?: string;
+    publishableKey?: string;
+    currencyCode?: string;
+    companyName?: string;
+    storefrontId?: string;
+    retry?: RetryConfig;
+}
+
+declare class StelOrderProvider implements CommerceProvider {
+    readonly name = "stelorder";
+    readonly version = "1.0.0";
+    readonly capabilities: BackendCapabilities;
+    private readonly client;
+    private readonly logger;
+    private readonly currencyCode;
+    private readonly storefrontId;
+    private readonly companyName;
+    constructor(config: StelOrderProviderConfig);
+    getProduct(handle: string, _options?: {
+        regionId?: string;
+    }): Promise<Product | undefined>;
+    getProducts(options?: GetProductsOptions): Promise<Product[]>;
+    getProductRecommendations(_productId: string): Promise<Product[]>;
+    getCategory(idOrHandle: string): Promise<ProductCategory | undefined>;
+    getCategories(options?: GetCategoriesOptions): Promise<ProductCategory[]>;
+    getCategoryProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
+    getCollection(handle: string): Promise<Collection | undefined>;
+    getCollections(options?: GetCollectionsOptions): Promise<Collection[]>;
+    getCollectionProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]>;
+    getStockLocations(_params?: {
+        salesChannelId?: string;
+    }): Promise<StockLocation[]>;
+    checkInventoryLevels(variantId: string, _salesChannelId?: string): Promise<InventoryLevel[]>;
+    validateCartStock(_cartId: string): Promise<StockValidation>;
+    getFulfillmentOptions(_cartId: string, _salesChannelId: string): Promise<FulfillmentOption[]>;
+    createCart(_options?: {
+        regionId?: string;
+    }): 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>;
+    getRegionCountries(_regionId: string): Promise<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>;
+    getPaymentMethods(_options: PaymentMethodsOptions): Promise<PaymentMethod[]>;
+    getShippingMethods(_cartId: string): Promise<ShippingMethod[]>;
+    getCustomer(customerId: string): Promise<Customer | undefined>;
+    getCustomers(options?: GetCustomersOptions): Promise<Customer[]>;
+    updateCustomer(customerId: string, data: Partial<Omit<Customer, 'id' | 'createdAt'>>): Promise<Customer>;
+    getOrder(orderId: string): Promise<Order | undefined>;
+    getOrders(options: GetOrdersOptions): Promise<Order[]>;
+    getAdminOrders(options?: {
+        search?: string;
+        status?: string | string[];
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        orders: Order[];
+        count: number;
+    }>;
+    cancelOrder(_orderId: string): Promise<Order>;
+    createFulfillment(_orderId: string, _items?: Array<{
+        id: string;
+        quantity: number;
+    }>): Promise<void>;
+    createRefund(_orderId: string, _amount?: number, _reason?: string): Promise<void>;
+    getStorefrontContext(): Promise<StorefrontContext>;
+    isStorefrontRequired(): boolean;
+    private notSupported;
+    private wrapError;
+}
+
+interface MockProviderConfig extends ProviderConfig {
+    currencyCode?: string;
+    siteUrl?: string;
+}
+declare class MockProvider implements CommerceProvider {
+    readonly name = "mock";
+    readonly version = "1.0.0";
+    readonly capabilities: Readonly<_thorprovider_types.BackendCapabilities>;
+    readonly isMock = true;
+    private readonly currencyCode;
+    private readonly siteUrl;
+    constructor(config?: MockProviderConfig);
+    private hasVariant;
+    getProduct(handle: string, options?: {
+        regionId?: 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(options?: {
+        regionId?: string;
+    }): 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>;
+    getRegions(): Promise<Array<{
+        id: string;
+        name: string;
+        currency_code: string;
+        countries?: Array<{
+            id: string;
+            iso_2: string;
+            name: string;
+            display_name?: string;
+        }>;
+    }>>;
+    completeCheckout(cartId: string): Promise<Order>;
+    getShippingMethods(cartId: string): Promise<ShippingMethod[]>;
+    getRegionCountries(regionId: string): 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(variantId: string): Promise<InventoryLevel[]>;
+    validateCartStock(cartId: string): Promise<StockValidation>;
+    getFulfillmentOptions(cartId: string, _salesChannelId: string): Promise<FulfillmentOption[]>;
+    cancelOrder(orderId: string): Promise<Order>;
+    createFulfillment(_orderId: string, _items?: Array<{
+        id: string;
+        quantity: number;
+    }>): Promise<void>;
+    createRefund(orderId: string, _amount?: number, _reason?: string): Promise<void>;
+    getAdminOrders(): Promise<{
+        orders: Order[];
+        count: number;
+    }>;
+    getAdminRegions(): Promise<Region[]>;
+    getStorefrontContext(): Promise<StorefrontContext>;
+    isStorefrontRequired(): boolean;
+}
+
 /**
  * @thorprovider/adapters v2.0
  * Provider Factory - Create commerce providers dynamically
@@ -2474,8 +2637,14 @@ type ProviderType = ProviderTypeString;
  * Provider configuration discriminated union
  */
 type ProviderFactoryConfig = {
+    provider: 'mock';
+    config: MockProviderConfig;
+} | {
     provider: 'medusa';
     config: MedusaProviderConfig;
+} | {
+    provider: 'stelorder';
+    config: StelOrderProviderConfig;
 } | {
     provider: 'shopify';
     config: ShopifyProviderConfig;
@@ -2521,4 +2690,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, MagentoProvider, type MagentoProviderConfig, MedusaMetadataAdapter, MedusaProvider, type MedusaProviderConfig, type MetricsOrderInput, type MetricsProductInput, MetricsService, type PlanFulfillmentShippingAddress, ProviderAPIError, type ProviderFactoryConfig, ProviderNotFoundError, type ProviderType, ResourceNotFoundError, SHOPIFY_CAPABILITIES, SPREE_CAPABILITIES, ShopifyProvider, type ShopifyProviderConfig, SpreeProvider, type SpreeProviderConfig, 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, 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 };