@thorprovider/adapters 4.3.0 → 5.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thorprovider/adapters",
-  "version": "4.3.0",
+  "version": "5.0.0",
   "description": "Framework-agnostic commerce adapters for Thor Commerce ecosystem - Multi-platform support with unified API",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",

package/src/backend/factory.ts

@@ -93,15 +93,5 @@ export function createBackendMetadataAdapter(
     return new MedusaMetadataAdapter(medusa);
   }
 
-  if (provider === 'shopify') {
-    // TODO: Implement Shopify metadata adapter
-    throw new Error('Shopify metadata adapter not yet implemented');
-  }
-
-  if (provider === 'woocommerce') {
-    // TODO: Implement WooCommerce metadata adapter
-    throw new Error('WooCommerce metadata adapter not yet implemented');
-  }
-
-  throw new Error(`Unsupported provider: ${provider}`);
+  throw new Error(`Unsupported provider for metadata adapter: ${provider}. Only 'medusa' is currently supported.`);
 }

package/src/factory/index.ts

@@ -1,57 +1,93 @@
 /**
- * @thorprovider/adapters v2.0
- * Provider Factory - Create commerce providers dynamically
+ * @thorprovider/adapters v5.0
+ * Provider Factory - Dynamic registry pattern
  *
- * 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
+ * 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.
+ *
+ * Built-in providers (medusa, stelorder, mock) are registered automatically.
  */
 
 import type { CommerceProvider } from '../types';
 import { MedusaProvider, type MedusaProviderConfig } from '../providers/medusa';
-import { ShopifyProvider, type ShopifyProviderConfig } from '../providers/shopify';
-import { BigCommerceProvider, type BigCommerceProviderConfig } from '../providers/bigcommerce';
-import { WooCommerceProvider, type WooCommerceProviderConfig } from '../providers/woocommerce';
-import { SpreeProvider, type SpreeProviderConfig } from '../providers/spree';
-import { MagentoProvider, type MagentoProviderConfig } from '../providers/magento';
 import { StelOrderProvider, type StelOrderProviderConfig } from '../providers/stelorder';
 import { MockProvider, type MockProviderConfig } from '../providers/mock';
 import { ProviderNotFoundError, ConfigurationError } from '../core/errors';
 import type { ProviderTypeString } from '@thorprovider/types';
 
+// ============================================
+// Registry
+// ============================================
+
+type ProviderFactory = (config: any) => CommerceProvider;
+
+const registry = new Map<string, ProviderFactory>();
+
+/**
+ * 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));
+ * ```
+ */
+export function registerProvider(type: string, factory: ProviderFactory): void {
+  registry.set(type, factory);
+}
+
 /**
- * Supported provider types (imported from @thorprovider/types L1)
- * Kept for backward compatibility; prefer ProviderTypeString from @thorprovider/types
+ * Get all registered provider type strings.
  */
-export type ProviderType = ProviderTypeString;
+export function getRegisteredProviders(): string[] {
+  return Array.from(registry.keys());
+}
+
+// ============================================
+// Built-in registrations
+// ============================================
+
+registerProvider('mock', (config) => new MockProvider(config));
+registerProvider('medusa', (config) => new MedusaProvider(config));
+registerProvider('stelorder', (config) => new StelOrderProvider(config));
+
+// ============================================
+// Types
+// ============================================
+
+/**
+ * Supported provider types
+ */
+export type ProviderType = ProviderTypeString | (string & {});
 
 /**
- * Provider configuration discriminated union
+ * Provider configuration discriminated union (built-in providers)
  */
 export type ProviderFactoryConfig =
   | { provider: 'mock'; config: MockProviderConfig }
   | { provider: 'medusa'; config: MedusaProviderConfig }
   | { 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)
  */
 export type RuntimeProviderConfig = {
-  provider: ProviderTypeString;
+  provider: string;
   config: Record<string, unknown>;
 };
 
+// ============================================
+// Factory
+// ============================================
+
 /**
- * Create a commerce provider instance
- * 
+ * Create a commerce provider instance from the registry.
+ *
  * @example
  * ```ts
  * const commerce = createProvider({
@@ -61,42 +97,28 @@ export type RuntimeProviderConfig = {
  *     publishableKey: process.env.MEDUSA_PUBLISHABLE_KEY,
  *   }
  * });
- * 
- * const products = await commerce.getProducts();
  * ```
  */
 export function createProvider(options: ProviderFactoryConfig | RuntimeProviderConfig): CommerceProvider {
   if (!options || !options.provider) {
     throw new ConfigurationError('Provider type is required');
   }
-  
+
   if (!options.config) {
     throw new ConfigurationError('Provider configuration is required');
   }
-  
-  const config = options.config as any;
-  
-  switch (options.provider) {
-    case 'mock':
-      return new MockProvider(config);
-    case 'medusa':
-      return new MedusaProvider(config);
-    case 'stelorder':
-      return new StelOrderProvider(config);
-    case 'shopify':
-      return new ShopifyProvider(config);
-    case 'bigcommerce':
-      return new BigCommerceProvider(config);
-    case 'woocommerce':
-      return new WooCommerceProvider(config);
-    case 'spree':
-      return new SpreeProvider(config);
-    case 'magento':
-      return new MagentoProvider(config);
-    
-    default:
-      throw new ProviderNotFoundError(String((options as any).provider));
+
+  const factory = registry.get(options.provider);
+
+  if (!factory) {
+    const available = getRegisteredProviders().join(', ');
+    throw new ProviderNotFoundError(
+      `Provider "${options.provider}" is not registered. Available: ${available}. ` +
+      `Did you forget to import the provider package?`
+    );
   }
+
+  return factory(options.config);
 }
 
 /**

package/src/index.ts

@@ -41,11 +41,6 @@ export {
   MOCK_CAPABILITIES,
   MEDUSA_CAPABILITIES,
   STELORDER_CAPABILITIES,
-  SHOPIFY_CAPABILITIES,
-  BIGCOMMERCE_CAPABILITIES,
-  WOOCOMMERCE_CAPABILITIES,
-  SPREE_CAPABILITIES,
-  MAGENTO_CAPABILITIES,
   isBackendCapabilities,
   getCapabilityDescription,
 } from './types/capabilities.types';
@@ -60,8 +55,11 @@ export {
   ResourceNotFoundError,
   ProviderAPIError,
   createLogger,
+  fetchWithRetry,
+  extractErrorMessage,
   type Logger,
   type LogLevel,
+  type RetryConfig,
 } from './core';
 
 // ============================================
@@ -183,6 +181,8 @@ export type {
 // ============================================
 export {
   createProvider,
+  registerProvider,
+  getRegisteredProviders,
   isProviderType,
   type ProviderType,
   type ProviderFactoryConfig,
@@ -198,14 +198,4 @@ export {
   type StelOrderProviderConfig,
   MockProvider,
   type MockProviderConfig,
-  ShopifyProvider,
-  type ShopifyProviderConfig,
-  BigCommerceProvider,
-  type BigCommerceProviderConfig,
-  WooCommerceProvider,
-  type WooCommerceProviderConfig,
-  SpreeProvider,
-  type SpreeProviderConfig,
-  MagentoProvider,
-  type MagentoProviderConfig,
 } from './providers';

package/src/providers/index.ts

@@ -1,5 +1,5 @@
 /**
- * @thorprovider/adapters v2.0
+ * @thorprovider/adapters v5.0
  * Providers index
  */
 
@@ -9,20 +9,5 @@ export type { MedusaProviderConfig } from './medusa';
 export { StelOrderProvider } from './stelorder';
 export type { StelOrderProviderConfig } from './stelorder';
 
-export { ShopifyProvider } from './shopify';
-export type { ShopifyProviderConfig } from './shopify';
-
-export { BigCommerceProvider } from './bigcommerce';
-export type { BigCommerceProviderConfig } from './bigcommerce';
-
-export { WooCommerceProvider } from './woocommerce';
-export type { WooCommerceProviderConfig } from './woocommerce';
-
-export { SpreeProvider } from './spree';
-export type { SpreeProviderConfig } from './spree';
-
-export { MagentoProvider } from './magento';
-export type { MagentoProviderConfig } from './magento';
-
 export { MockProvider } from './mock';
 export type { MockProviderConfig } from './mock';

package/src/types/capabilities.types.ts

@@ -150,256 +150,6 @@ export const STELORDER_CAPABILITIES: Readonly<BackendCapabilities> = {
   loyaltyProgram: false,
 };
 
-/**
- * Shopify backend capabilities
- * 
- * @see https://shopify.dev/docs/api/storefront
- */
-export const SHOPIFY_CAPABILITIES: Readonly<BackendCapabilities> = {
-  // Profile Management
-  updateProfile: true,
-  updateEmail: true,
-  changePasswordDirect: true,
-  changePasswordViaEmail: true,
-  deleteAccount: false,  // Requires admin API
-  
-  // Avatar
-  uploadAvatar: false,
-  avatarViaMetadata: true,
-  
-  // Custom Attributes
-  customAttributes: true,
-  
-  // Orders
-  fetchOrders: true,
-  cancelOrder: true,
-  
-  // Addresses
-  manageAddresses: true,
-  defaultAddress: true,
-  
-  // Cart/Checkout
-  applyDiscounts: true,
-  shippingCalculation: true,
-  guestCheckout: true,
-  savedPaymentMethods: true,
-  listPaymentProviders: true,
-  regionSpecificPayments: false,  // Global payment methods
-  
-  // Wishlist
-  wishlist: false,  // Requires app
-  
-  // Search
-  advancedSearch: true,
-  facetedFilters: true,
-  
-  // Reviews
-  productReviews: false,  // Requires app
-  
-  // Loyalty
-  loyaltyProgram: false,  // Requires app
-};
-
-/**
- * BigCommerce backend capabilities
- * 
- * @see https://developer.bigcommerce.com/docs/rest-storefront
- */
-export const BIGCOMMERCE_CAPABILITIES: Readonly<BackendCapabilities> = {
-  // Profile Management
-  updateProfile: true,
-  updateEmail: true,
-  changePasswordDirect: true,
-  changePasswordViaEmail: true,
-  deleteAccount: false,
-
-  // Avatar
-  uploadAvatar: false,
-  avatarViaMetadata: false,
-
-  // Custom Attributes
-  customAttributes: true,
-
-  // Orders
-  fetchOrders: true,
-  cancelOrder: false,  // Admin API only
-
-  // Addresses
-  manageAddresses: true,
-  defaultAddress: false,
-
-  // Cart/Checkout
-  applyDiscounts: true,
-  shippingCalculation: true,
-  guestCheckout: true,
-  savedPaymentMethods: true,
-  listPaymentProviders: true,
-  regionSpecificPayments: false,
-
-  // Wishlist
-  wishlist: true,  // Native support
-
-  // Search
-  advancedSearch: true,
-  facetedFilters: true,
-
-  // Reviews
-  productReviews: true,  // Native support
-
-  // Loyalty
-  loyaltyProgram: false,
-};
-
-/**
- * WooCommerce backend capabilities
- * 
- * @see https://developer.woocommerce.com/docs/apis/store-api
- */
-export const WOOCOMMERCE_CAPABILITIES: Readonly<BackendCapabilities> = {
-  // Profile Management
-  updateProfile: true,
-  updateEmail: true,
-  changePasswordDirect: false,  // WordPress handles auth
-  changePasswordViaEmail: true,
-  deleteAccount: false,
-
-  // Avatar
-  uploadAvatar: false,
-  avatarViaMetadata: false,  // Gravatar-based
-
-  // Custom Attributes
-  customAttributes: true,  // Via meta_data
-
-  // Orders
-  fetchOrders: true,
-  cancelOrder: true,
-
-  // Addresses
-  manageAddresses: true,
-  defaultAddress: false,  // Billing/shipping only
-
-  // Cart/Checkout
-  applyDiscounts: true,  // Coupon codes
-  shippingCalculation: true,
-  guestCheckout: true,
-  savedPaymentMethods: false,
-  listPaymentProviders: true,
-  regionSpecificPayments: false,
-
-  // Wishlist
-  wishlist: false,  // Requires plugin
-
-  // Search
-  advancedSearch: false,  // Basic WP search
-  facetedFilters: false,  // Requires plugin
-
-  // Reviews
-  productReviews: true,  // Native WP reviews
-
-  // Loyalty
-  loyaltyProgram: false,
-};
-
-/**
- * Spree Commerce backend capabilities
- * 
- * @see https://docs.spreecommerce.org/api-reference
- */
-export const SPREE_CAPABILITIES: Readonly<BackendCapabilities> = {
-  // Profile Management
-  updateProfile: true,
-  updateEmail: true,
-  changePasswordDirect: true,
-  changePasswordViaEmail: true,
-  deleteAccount: false,
-
-  // Avatar
-  uploadAvatar: false,
-  avatarViaMetadata: false,
-
-  // Custom Attributes
-  customAttributes: false,
-
-  // Orders
-  fetchOrders: true,
-  cancelOrder: true,
-
-  // Addresses
-  manageAddresses: true,
-  defaultAddress: true,
-
-  // Cart/Checkout
-  applyDiscounts: true,
-  shippingCalculation: true,
-  guestCheckout: true,
-  savedPaymentMethods: false,
-  listPaymentProviders: true,
-  regionSpecificPayments: false,
-
-  // Wishlist
-  wishlist: true,  // Native support
-
-  // Search
-  advancedSearch: false,
-  facetedFilters: true,  // Taxon-based filtering
-
-  // Reviews
-  productReviews: false,  // Requires extension
-
-  // Loyalty
-  loyaltyProgram: false,
-};
-
-/**
- * Adobe Commerce / Magento backend capabilities
- * 
- * @see https://developer.adobe.com/commerce/webapi/graphql/
- */
-export const MAGENTO_CAPABILITIES: Readonly<BackendCapabilities> = {
-  // Profile Management
-  updateProfile: true,
-  updateEmail: true,
-  changePasswordDirect: true,
-  changePasswordViaEmail: true,
-  deleteAccount: false,  // Admin only
-
-  // Avatar
-  uploadAvatar: false,
-  avatarViaMetadata: false,
-
-  // Custom Attributes
-  customAttributes: true,  // EAV model
-
-  // Orders
-  fetchOrders: true,
-  cancelOrder: true,
-
-  // Addresses
-  manageAddresses: true,
-  defaultAddress: true,
-
-  // Cart/Checkout
-  applyDiscounts: true,
-  shippingCalculation: true,
-  guestCheckout: true,
-  savedPaymentMethods: true,
-  listPaymentProviders: true,
-  regionSpecificPayments: true,  // Store-view scoped
-
-  // Wishlist
-  wishlist: true,  // Native support
-
-  // Search
-  advancedSearch: true,  // Elasticsearch/OpenSearch
-  facetedFilters: true,  // Layered navigation
-
-  // Reviews
-  productReviews: true,  // Native support
-
-  // Loyalty
-  loyaltyProgram: false,  // Requires extension
-};
-
 /**
  * Type guard to check if an object is a valid BackendCapabilities
  */

package/src/providers/bigcommerce/bigcommerce.ts

@@ -1,6 +0,0 @@
-/**
- * @thorprovider/adapters — BigCommerce Provider exports
- */
-export { BigCommerceProvider } from './index';
-export type { BigCommerceProviderConfig } from './index';
-export * from './transforms';