@thorprovider/adapters 4.2.0 → 4.3.0

package/README.md

@@ -133,6 +133,7 @@ Need e-commerce backend integration?
 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
@@ -162,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();
 ```
 
@@ -438,6 +450,7 @@ 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/) |
@@ -465,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
@@ -584,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, 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';
 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';
@@ -239,6 +239,13 @@ declare const MOCK_CAPABILITIES: Readonly<BackendCapabilities>;
  * @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
  *
@@ -1361,6 +1368,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
  */
@@ -1452,6 +1606,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;
     /**
@@ -2461,6 +2627,84 @@ 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;
@@ -2557,6 +2801,9 @@ type ProviderFactoryConfig = {
 } | {
     provider: 'medusa';
     config: MedusaProviderConfig;
+} | {
+    provider: 'stelorder';
+    config: StelOrderProviderConfig;
 } | {
     provider: 'shopify';
     config: ShopifyProviderConfig;
@@ -2602,4 +2849,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, 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, 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';
 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';
@@ -239,6 +239,13 @@ declare const MOCK_CAPABILITIES: Readonly<BackendCapabilities>;
  * @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
  *
@@ -1361,6 +1368,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
  */
@@ -1452,6 +1606,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;
     /**
@@ -2461,6 +2627,84 @@ 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;
@@ -2557,6 +2801,9 @@ type ProviderFactoryConfig = {
 } | {
     provider: 'medusa';
     config: MedusaProviderConfig;
+} | {
+    provider: 'stelorder';
+    config: StelOrderProviderConfig;
 } | {
     provider: 'shopify';
     config: ShopifyProviderConfig;
@@ -2602,4 +2849,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, 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 };