@thorprovider/adapters 4.1.0 → 4.2.0

package/dist/index.d.mts

@@ -225,6 +225,14 @@ 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
  *
@@ -2453,6 +2461,76 @@ declare class MagentoProvider implements CommerceProvider {
     isStorefrontRequired(): boolean;
 }
 
+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,6 +2552,9 @@ type ProviderType = ProviderTypeString;
  * Provider configuration discriminated union
  */
 type ProviderFactoryConfig = {
+    provider: 'mock';
+    config: MockProviderConfig;
+} | {
     provider: 'medusa';
     config: MedusaProviderConfig;
 } | {
@@ -2521,4 +2602,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, 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 };

package/dist/index.d.ts

@@ -225,6 +225,14 @@ 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
  *
@@ -2453,6 +2461,76 @@ declare class MagentoProvider implements CommerceProvider {
     isStorefrontRequired(): boolean;
 }
 
+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,6 +2552,9 @@ type ProviderType = ProviderTypeString;
  * Provider configuration discriminated union
  */
 type ProviderFactoryConfig = {
+    provider: 'mock';
+    config: MockProviderConfig;
+} | {
     provider: 'medusa';
     config: MedusaProviderConfig;
 } | {
@@ -2521,4 +2602,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, 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 };