@thorprovider/adapters 4.2.1 → 5.0.0

package/dist/index.js

@@ -32,8 +32,6 @@ var src_exports = {};
 __export(src_exports, {
   AdminAuthService: () => AdminAuthService,
   AdminSessionService: () => AdminSessionService,
-  BIGCOMMERCE_CAPABILITIES: () => BIGCOMMERCE_CAPABILITIES,
-  BigCommerceProvider: () => BigCommerceProvider,
   CHANNEL_ASSIGNED_AT_KEY: () => CHANNEL_ASSIGNED_AT_KEY,
   CHANNEL_ASSIGNED_BY_KEY: () => CHANNEL_ASSIGNED_BY_KEY,
   CHANNEL_SCOPE_KEY: () => CHANNEL_SCOPE_KEY,
@@ -42,10 +40,8 @@ __export(src_exports, {
   CircuitBreakerOpenError: () => CircuitBreakerOpenError,
   CommerceError: () => CommerceError,
   ConfigurationError: () => ConfigurationError,
-  MAGENTO_CAPABILITIES: () => MAGENTO_CAPABILITIES,
   MEDUSA_CAPABILITIES: () => MEDUSA_CAPABILITIES,
   MOCK_CAPABILITIES: () => MOCK_CAPABILITIES,
-  MagentoProvider: () => MagentoProvider,
   MedusaMetadataAdapter: () => MedusaMetadataAdapter,
   MedusaProvider: () => MedusaProvider,
   MetricsService: () => MetricsService,
@@ -53,15 +49,9 @@ __export(src_exports, {
   ProviderAPIError: () => ProviderAPIError,
   ProviderNotFoundError: () => ProviderNotFoundError,
   ResourceNotFoundError: () => ResourceNotFoundError,
-  SHOPIFY_CAPABILITIES: () => SHOPIFY_CAPABILITIES,
-  SPREE_CAPABILITIES: () => SPREE_CAPABILITIES,
   STELORDER_CAPABILITIES: () => STELORDER_CAPABILITIES,
-  ShopifyProvider: () => ShopifyProvider,
-  SpreeProvider: () => SpreeProvider,
   StelOrderProvider: () => StelOrderProvider,
   StorefrontConfigError: () => import_types2.StorefrontConfigError,
-  WOOCOMMERCE_CAPABILITIES: () => WOOCOMMERCE_CAPABILITIES,
-  WooCommerceProvider: () => WooCommerceProvider,
   assertEntityBelongsToChannel: () => assertEntityBelongsToChannel,
   backendCircuitBreaker: () => backendCircuitBreaker,
   buildChannelScopeMetadata: () => buildChannelScopeMetadata,
@@ -69,12 +59,15 @@ __export(src_exports, {
   createBackendMetadataAdapter: () => createBackendMetadataAdapter,
   createLogger: () => createLogger,
   createProvider: () => createProvider,
+  extractErrorMessage: () => extractErrorMessage,
+  fetchWithRetry: () => fetchWithRetry,
   filterByChannel: () => filterByChannel,
   filterGlobalOnly: () => filterGlobalOnly,
   geocodeAddress: () => geocodeAddress,
   getBackendProviderId: () => getBackendProviderId,
   getCapabilityDescription: () => getCapabilityDescription,
   getChannelScope: () => getChannelScope,
+  getRegisteredProviders: () => getRegisteredProviders,
   isBackendCapabilities: () => isBackendCapabilities,
   isGlobalEntity: () => isGlobalEntity,
   isProviderType: () => isProviderType,
@@ -84,6 +77,7 @@ __export(src_exports, {
   numberToMoney: () => numberToMoney,
   partitionByChannel: () => partitionByChannel,
   planFulfillment: () => planFulfillment,
+  registerProvider: () => registerProvider,
   transformFulfillmentOption: () => transformFulfillmentOption,
   transformInventoryLevel: () => transformInventoryLevel,
   transformStockLocation: () => transformStockLocation,
@@ -200,209 +194,6 @@ var STELORDER_CAPABILITIES = {
   // Loyalty
   loyaltyProgram: false
 };
-var SHOPIFY_CAPABILITIES = {
-  // 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
-};
-var BIGCOMMERCE_CAPABILITIES = {
-  // 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
-};
-var WOOCOMMERCE_CAPABILITIES = {
-  // 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
-};
-var SPREE_CAPABILITIES = {
-  // 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
-};
-var MAGENTO_CAPABILITIES = {
-  // 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
-};
 function isBackendCapabilities(obj) {
   if (typeof obj !== "object" || obj === null) return false;
   const capabilities = obj;
@@ -1622,13 +1413,7 @@ function createBackendMetadataAdapter(config) {
     });
     return new MedusaMetadataAdapter(medusa);
   }
-  if (provider === "shopify") {
-    throw new Error("Shopify metadata adapter not yet implemented");
-  }
-  if (provider === "woocommerce") {
-    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.`);
 }
 
 // src/metadata/channel-scope.ts
@@ -1823,11 +1608,17 @@ var MedusaAuthProvider = class {
   logger;
   authConfig;
   storageManager;
-  constructor(sdk, authConfig, debug = false) {
+  /** Medusa backend base URL — needed for raw fetch calls */
+  baseUrl;
+  /** Publishable API key — sent as x-publishable-api-key on store calls */
+  publishableKey;
+  constructor(sdk, authConfig, debug = false, baseUrl = "", publishableKey = "") {
     this.sdk = sdk;
     this.authConfig = authConfig;
     this.logger = createLogger("MedusaAuthProvider", debug);
     this.storageManager = new AuthStorageManager(authConfig);
+    this.baseUrl = baseUrl;
+    this.publishableKey = publishableKey;
     this.logger.info("Medusa Auth Provider initialized", {
       method: authConfig.method,
       storage: authConfig.storage
@@ -2103,6 +1894,81 @@ var MedusaAuthProvider = class {
       void 0
     );
   }
+  // ========================================
+  // Multi-Tenant — Channel Link
+  // ========================================
+  /**
+   * Link the currently authenticated customer to the storefront's sales channel.
+   *
+   * Must be called immediately after a successful `login()` so the customer
+   * appears in the admin panel of the correct storefront channel.
+   *
+   * Implements `POST /store/thor/customers/me/channels`.
+   * Idempotent — returns `{ linked: false, reason: 'already_linked' }` when
+   * the link already exists.
+   *
+   * @throws {ProviderAPIError} When not authenticated (401) or channel cannot
+   *   be resolved from the publishable key (400).
+   */
+  async linkCustomerToChannel() {
+    this.logger.debug("linkCustomerToChannel");
+    if (!this.baseUrl || !this.publishableKey) {
+      throw new ProviderAPIError(
+        "linkCustomerToChannel requires baseUrl and publishableKey to be set on the auth provider.",
+        "CONFIGURATION_ERROR",
+        void 0
+      );
+    }
+    const token = await this.storageManager.getToken();
+    const headers = {
+      "x-publishable-api-key": this.publishableKey,
+      "Content-Type": "application/json"
+    };
+    if (token) {
+      headers["Authorization"] = `Bearer ${token}`;
+    }
+    try {
+      const url = `${this.baseUrl}/store/thor/customers/me/channels`;
+      const response = await fetch(url, {
+        method: "POST",
+        headers
+      });
+      if (response.status === 401) {
+        throw new ProviderAPIError(
+          "linkCustomerToChannel: not authenticated. Call login() first.",
+          "NOT_AUTHENTICATED",
+          401
+        );
+      }
+      if (response.status === 400) {
+        const body = await response.json().catch(() => ({}));
+        throw new ProviderAPIError(
+          `linkCustomerToChannel: could not resolve sales channel from publishable key. ${body?.message ?? ""}`.trim(),
+          "CHANNEL_RESOLUTION_FAILED",
+          400
+        );
+      }
+      if (!response.ok) {
+        const body = await response.json().catch(() => ({}));
+        throw new ProviderAPIError(
+          `linkCustomerToChannel failed with status ${response.status}: ${body?.message ?? "Unknown error"}`,
+          "LINK_CHANNEL_FAILED",
+          response.status
+        );
+      }
+      const data = await response.json();
+      this.logger.info("Customer linked to channel", { linked: data.linked, reason: data.reason });
+      return data;
+    } catch (error) {
+      if (error instanceof ProviderAPIError) throw error;
+      this.logger.error("linkCustomerToChannel failed", error);
+      throw new ProviderAPIError(
+        `linkCustomerToChannel failed: ${error.message}`,
+        "LINK_CHANNEL_FAILED",
+        error
+      );
+    }
+  }
 };
 
 // src/providers/medusa/payment.ts
@@ -2245,48 +2111,344 @@ async function getPaymentMethods(sdk, options) {
   }
 }
 
-// src/providers/medusa/index.ts
-var MEDUSA_CART_RETRIEVE_FIELDS = "+items,+items.variant,+items.variant.product,+items.variant.product.thumbnail,+items.variant.options,+items.variant.options.option";
-var MedusaProvider = class {
-  name = "medusa";
-  version = "2.0.0";
+// src/providers/medusa/admin.ts
+var MedusaAdminClient = class {
+  baseUrl;
+  apiKey;
+  logger;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+    this.logger = createLogger("MedusaAdminClient", config.debug);
+  }
+  // -----------------------------------------------------------------------
+  // Private — HTTP helper
+  // -----------------------------------------------------------------------
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    this.logger.debug(`[admin] ${method} ${path}`);
+    const headers = {
+      "x-medusa-access-token": this.apiKey,
+      "Content-Type": "application/json"
+    };
+    const init = {
+      method,
+      headers,
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    };
+    let response;
+    try {
+      response = await fetch(url, init);
+    } catch (networkError) {
+      throw new ProviderAPIError(
+        `[admin] Network error on ${method} ${path}: ${networkError.message}`,
+        "NETWORK_ERROR",
+        networkError
+      );
+    }
+    if (!response.ok) {
+      let message = `HTTP ${response.status}`;
+      try {
+        const json = await response.json();
+        message = json?.message ?? message;
+      } catch {
+      }
+      throw new ProviderAPIError(
+        `[admin] ${method} ${path} failed: ${message}`,
+        `ADMIN_API_${response.status}`,
+        response.status
+      );
+    }
+    return response.json();
+  }
+  // -----------------------------------------------------------------------
+  // 3.1 — Sales Channel: Customers
+  // -----------------------------------------------------------------------
   /**
-   * Medusa backend capabilities.
-   * Starts with static defaults, replaced by dynamic values from
-   * `GET /store/thor/capabilities` once the fetch completes.
+   * Paginated list of customers linked to a sales channel.
+   *
+   * `GET /admin/thor/sales-channels/:id/customers`
    */
-  _dynamicCapabilities = null;
-  /** Promise that resolves when capabilities fetch completes (success or failure) */
-  _capabilitiesPromise = null;
+  async getChannelCustomers(salesChannelId, options = {}) {
+    const { limit = 20, offset = 0 } = options;
+    return this.request(
+      "GET",
+      `/admin/thor/sales-channels/${salesChannelId}/customers?limit=${limit}&offset=${offset}`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.2 — Sales Channel: API Keys
+  // -----------------------------------------------------------------------
   /**
-   * Getter returns dynamic capabilities if available, otherwise static fallback.
+   * Publishable API keys associated with a sales channel.
+   *
+   * `GET /admin/thor/sales-channels/:id/api-keys`
    */
-  get capabilities() {
-    return this._dynamicCapabilities ?? MEDUSA_CAPABILITIES;
+  async getChannelApiKeys(salesChannelId) {
+    return this.request(
+      "GET",
+      `/admin/thor/sales-channels/${salesChannelId}/api-keys`
+    );
   }
-  sdk;
-  logger;
-  currencyCode;
-  retryConfig;
-  baseUrl;
-  publishableKey;
-  /** Secret API key for admin operations (if configured). */
-  adminApiKey;
+  // -----------------------------------------------------------------------
+  // 3.3 — Sales Channel: Categories
+  // -----------------------------------------------------------------------
   /**
-   * Dedicated SDK instance for admin calls.
-   * Separate from `this.sdk` to prevent the admin API key from being overwritten
-   * by customer JWT tokens set during storefront authentication.
-   * Only created when adminConfig.apiKey is provided.
+   * Product categories assigned to a sales channel.
+   *
+   * `GET /admin/thor/sales-channels/:id/categories`
    */
-  sdkAdmin;
-  /** Cached distinct product status values — rarely changes, cached for process lifetime */
-  _cachedProductStatuses = null;
+  async getChannelCategories(salesChannelId, options = {}) {
+    const { limit = 20, offset = 0, include_descendants = false } = options;
+    const qs = new URLSearchParams({
+      limit: String(limit),
+      offset: String(offset),
+      include_descendants: String(include_descendants)
+    });
+    return this.request(
+      "GET",
+      `/admin/thor/sales-channels/${salesChannelId}/categories?${qs}`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.4 — Category: Sales Channels
+  // -----------------------------------------------------------------------
   /**
-   * In-memory cache for region countries
-   * Structure: Map<regionId, { countries: Country[], expiresAt: number }>
+   * Sales channels to which a category is assigned.
+   *
+   * `GET /admin/thor/categories/:id/sales-channels`
    */
-  regionCountriesCache = /* @__PURE__ */ new Map();
-  /**
+  async getCategorySalesChannels(categoryId) {
+    return this.request(
+      "GET",
+      `/admin/thor/categories/${categoryId}/sales-channels`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.5 — Category: Assign to Sales Channels
+  // -----------------------------------------------------------------------
+  /**
+   * Assign a category to one or more sales channels (idempotent).
+   *
+   * `POST /admin/thor/categories/:id/sales-channels`
+   */
+  async assignCategoryToChannels(categoryId, body) {
+    return this.request(
+      "POST",
+      `/admin/thor/categories/${categoryId}/sales-channels`,
+      body
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.6 — Category: Unassign from Sales Channels
+  // -----------------------------------------------------------------------
+  /**
+   * Remove category assignment from one or more sales channels (idempotent).
+   *
+   * `DELETE /admin/thor/categories/:id/sales-channels`
+   */
+  async unassignCategoryFromChannels(categoryId, body) {
+    return this.request(
+      "DELETE",
+      `/admin/thor/categories/${categoryId}/sales-channels`,
+      body
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.7 — Collection: Sales Channels
+  // -----------------------------------------------------------------------
+  /**
+   * Sales channels to which a collection is assigned.
+   *
+   * `GET /admin/thor/collections/:id/sales-channels`
+   */
+  async getCollectionSalesChannels(collectionId) {
+    return this.request(
+      "GET",
+      `/admin/thor/collections/${collectionId}/sales-channels`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.8 — Collection: Assign to Sales Channels
+  // -----------------------------------------------------------------------
+  /**
+   * Assign a collection to one or more sales channels (idempotent).
+   *
+   * `POST /admin/thor/collections/:id/sales-channels`
+   */
+  async assignCollectionToChannels(collectionId, body) {
+    return this.request(
+      "POST",
+      `/admin/thor/collections/${collectionId}/sales-channels`,
+      body
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.9 — Collection: Unassign from Sales Channels
+  // -----------------------------------------------------------------------
+  /**
+   * Remove collection assignment from one or more sales channels (idempotent).
+   *
+   * `DELETE /admin/thor/collections/:id/sales-channels`
+   */
+  async unassignCollectionFromChannels(collectionId, body) {
+    return this.request(
+      "DELETE",
+      `/admin/thor/collections/${collectionId}/sales-channels`,
+      body
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.10 — Storefront Config: Read
+  // -----------------------------------------------------------------------
+  /**
+   * Read the visual storefront configuration for a channel.
+   * `:id` is the `sales_channel_id`.
+   *
+   * `GET /admin/thor/storefront-config/:id`
+   */
+  async getStorefrontConfig(salesChannelId) {
+    return this.request(
+      "GET",
+      `/admin/thor/storefront-config/${salesChannelId}`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.11 — Storefront Config: Update
+  // -----------------------------------------------------------------------
+  /**
+   * Update the visual storefront configuration for a channel.
+   * Triggers the `storefront_config.updated` event → ISR webhook.
+   *
+   * `PUT /admin/thor/storefront-config/:id`
+   */
+  async updateStorefrontConfig(salesChannelId, body) {
+    return this.request(
+      "PUT",
+      `/admin/thor/storefront-config/${salesChannelId}`,
+      body
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.12 — Site Designer Config: Read
+  // -----------------------------------------------------------------------
+  /**
+   * Read the active Site Designer configuration for a channel, including the
+   * last 10 history entries.
+   *
+   * `GET /admin/thor/site-config/:sales_channel_id`
+   */
+  async getSiteConfig(salesChannelId) {
+    return this.request(
+      "GET",
+      `/admin/thor/site-config/${salesChannelId}`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.13 — Site Designer Config: Update
+  // -----------------------------------------------------------------------
+  /**
+   * Update the Site Designer configuration for a channel.
+   * Creates a new history entry on every PUT.
+   *
+   * `PUT /admin/thor/site-config/:sales_channel_id`
+   */
+  async updateSiteConfig(salesChannelId, body) {
+    return this.request(
+      "PUT",
+      `/admin/thor/site-config/${salesChannelId}`,
+      body
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.14 — Site Designer Config: History
+  // -----------------------------------------------------------------------
+  /**
+   * 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`
+   */
+  async getSiteConfigHistory(salesChannelId, options = {}) {
+    const { limit = 20, offset = 0 } = options;
+    return this.request(
+      "GET",
+      `/admin/thor/site-config/${salesChannelId}/history?limit=${limit}&offset=${offset}`
+    );
+  }
+  // -----------------------------------------------------------------------
+  // 3.15 — Site Designer Config: Restore
+  // -----------------------------------------------------------------------
+  /**
+   * 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`
+   */
+  async restoreSiteConfig(salesChannelId, version) {
+    return this.request(
+      "POST",
+      `/admin/thor/site-config/${salesChannelId}/restore/${encodeURIComponent(version)}`
+    );
+  }
+};
+
+// src/providers/medusa/index.ts
+var MEDUSA_CART_RETRIEVE_FIELDS = "+items,+items.variant,+items.variant.product,+items.variant.product.thumbnail,+items.variant.options,+items.variant.options.option";
+var MedusaProvider = class {
+  name = "medusa";
+  version = "2.0.0";
+  /**
+   * Medusa backend capabilities.
+   * Starts with static defaults, replaced by dynamic values from
+   * `GET /store/thor/capabilities` once the fetch completes.
+   */
+  _dynamicCapabilities = null;
+  /** Promise that resolves when capabilities fetch completes (success or failure) */
+  _capabilitiesPromise = null;
+  /**
+   * Getter returns dynamic capabilities if available, otherwise static fallback.
+   */
+  get capabilities() {
+    return this._dynamicCapabilities ?? MEDUSA_CAPABILITIES;
+  }
+  sdk;
+  logger;
+  currencyCode;
+  retryConfig;
+  baseUrl;
+  publishableKey;
+  /** Secret API key for admin operations (if configured). */
+  adminApiKey;
+  /**
+   * Dedicated SDK instance for admin calls.
+   * Separate from `this.sdk` to prevent the admin API key from being overwritten
+   * by customer JWT tokens set during storefront authentication.
+   * Only created when adminConfig.apiKey is provided.
+   */
+  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', ... });
+   * ```
+   */
+  admin;
+  /** Cached distinct product status values — rarely changes, cached for process lifetime */
+  _cachedProductStatuses = null;
+  /**
+   * In-memory cache for region countries
+   * Structure: Map<regionId, { countries: Country[], expiresAt: number }>
+   */
+  regionCountriesCache = /* @__PURE__ */ new Map();
+  /**
    * Cache TTL for region countries (5 minutes)
    */
   REGION_COUNTRIES_CACHE_TTL = 5 * 60 * 1e3;
@@ -2349,10 +2511,15 @@ var MedusaProvider = class {
         debug: config.debug ?? false
         // No publishableKey or auth config: this instance is admin-only, no JWT needed
       });
+      this.admin = new MedusaAdminClient({
+        baseUrl: config.baseUrl,
+        apiKey: config.adminConfig.apiKey,
+        debug: config.debug
+      });
       this.logger.info("[Admin Auth] Dedicated admin SDK instance created with API key");
     }
     if (config.auth) {
-      this.auth = new MedusaAuthProvider(this.sdk, config.auth, config.debug);
+      this.auth = new MedusaAuthProvider(this.sdk, config.auth, config.debug, config.baseUrl, config.publishableKey);
       this.logger.info("Auth provider initialized");
     }
     this._capabilitiesPromise = this._fetchCapabilities();
@@ -5308,2801 +5475,194 @@ var MedusaProvider = class {
     } catch (error) {
       if (error instanceof import_types.StorefrontConfigError) throw error;
       const errorMessage = extractErrorMessage(error);
-      throw new ProviderAPIError(
-        `Failed to initialize storefront context: ${errorMessage}`,
-        "medusa",
-        error?.status ?? 500
-      );
-    }
-  }
-  /**
-   * Medusa always requires storefront configuration for multi-tenant support.
-   */
-  isStorefrontRequired() {
-    return true;
-  }
-  // ============================================
-  // Thor Plugin — Storefront Configuration
-  // ============================================
-  /** In-memory cache for storefront config (60s TTL) */
-  _storefrontConfigCache = null;
-  /** In-memory cache for designer config (60s TTL) */
-  _designerConfigCache = null;
-  /** Cache TTL for Thor plugin configs (60 seconds) */
-  THOR_CONFIG_CACHE_TTL = 60 * 1e3;
-  /**
-   * Get per-channel storefront configuration from Thor Commerce plugin.
-   * Calls `GET /store/thor/config`.
-   *
-   * @returns StorefrontConfig or null if plugin is not installed / config not set
-   */
-  async getStorefrontConfig() {
-    if (this._storefrontConfigCache && Date.now() < this._storefrontConfigCache.expiresAt) {
-      return this._storefrontConfigCache.config;
-    }
-    try {
-      const url = `${this.baseUrl}/store/thor/config`;
-      const response = await fetchWithRetry(
-        url,
-        {
-          method: "GET",
-          headers: {
-            "x-publishable-api-key": this.publishableKey,
-            "Content-Type": "application/json"
-          }
-        },
-        this.retryConfig
-      );
-      if (response.status === 404) {
-        this._storefrontConfigCache = { config: null, expiresAt: Date.now() + this.THOR_CONFIG_CACHE_TTL };
-        return null;
-      }
-      if (!response.ok) {
-        this.logger.warn("[StorefrontConfig] Non-OK response", { status: response.status });
-        return null;
-      }
-      const data = await response.json();
-      const config = transformStorefrontConfig(data.storefront_config ?? data);
-      this._storefrontConfigCache = { config, expiresAt: Date.now() + this.THOR_CONFIG_CACHE_TTL };
-      this.logger.debug("[StorefrontConfig] Loaded from backend", { id: config.id });
-      return config;
-    } catch (error) {
-      this.logger.warn("[StorefrontConfig] Failed to fetch", {
-        error: error instanceof Error ? error.message : String(error)
-      });
-      return null;
-    }
-  }
-  /**
-   * Get active Site Designer configuration from Thor Commerce plugin.
-   * Calls `GET /store/thor/site-config`.
-   *
-   * @returns Versioned DesignerConfig or null if plugin is not installed / config not set
-   */
-  async getDesignerConfig() {
-    if (this._designerConfigCache && Date.now() < this._designerConfigCache.expiresAt) {
-      return this._designerConfigCache.result;
-    }
-    try {
-      const url = `${this.baseUrl}/store/thor/site-config`;
-      const response = await fetchWithRetry(
-        url,
-        {
-          method: "GET",
-          headers: {
-            "x-publishable-api-key": this.publishableKey,
-            "Content-Type": "application/json"
-          }
-        },
-        this.retryConfig
-      );
-      if (response.status === 404) {
-        this._designerConfigCache = { result: null, expiresAt: Date.now() + this.THOR_CONFIG_CACHE_TTL };
-        return null;
-      }
-      if (!response.ok) {
-        this.logger.warn("[DesignerConfig] Non-OK response", { status: response.status });
-        return null;
-      }
-      const data = await response.json();
-      const result = {
-        version: data.version ?? "",
-        config: data.config
-      };
-      this._designerConfigCache = { result, expiresAt: Date.now() + this.THOR_CONFIG_CACHE_TTL };
-      this.logger.debug("[DesignerConfig] Loaded from backend", { version: result.version });
-      return result;
-    } catch (error) {
-      this.logger.warn("[DesignerConfig] Failed to fetch", {
-        error: error instanceof Error ? error.message : String(error)
-      });
-      return null;
-    }
-  }
-  // ============================================
-  // Thor Plugin — Admin Site Designer
-  // ============================================
-  /**
-   * Get admin Site Designer config + history for a sales channel.
-   * Calls `GET /admin/thor/site-config/:salesChannelId`.
-   */
-  async getAdminDesignerConfig(salesChannelId) {
-    return this.makeAdminRequest(async () => {
-      const path = `/admin/thor/site-config/${encodeURIComponent(salesChannelId)}`;
-      let data;
-      try {
-        data = await this.sdk.client.fetch(path, { method: "GET" });
-      } catch (error) {
-        if (error?.status === 404) return null;
-        throw new ProviderAPIError(
-          `Failed to fetch admin designer config: ${error?.message ?? error?.status}`,
-          "medusa",
-          error?.status
-        );
-      }
-      return {
-        version: data.version ?? "",
-        config: data.config,
-        history: data.history
-      };
-    });
-  }
-  /**
-   * Update the Site Designer config for a sales channel.
-   * Calls `PUT /admin/thor/site-config/:salesChannelId`.
-   */
-  async updateAdminDesignerConfig(salesChannelId, config) {
-    return this.makeAdminRequest(async () => {
-      const path = `/admin/thor/site-config/${encodeURIComponent(salesChannelId)}`;
-      let data;
-      try {
-        data = await this.sdk.client.fetch(path, {
-          method: "PUT",
-          body: JSON.stringify({ config }),
-          headers: { "Content-Type": "application/json" }
-        });
-      } catch (error) {
-        throw new ProviderAPIError(
-          `Failed to update admin designer config: ${error?.message ?? error?.status}`,
-          "medusa",
-          error?.status
-        );
-      }
-      return {
-        version: data.version ?? "",
-        config: data.config
-      };
-    });
-  }
-  /**
-   * Restore a previous Site Designer config version.
-   * Calls `POST /admin/thor/site-config/:salesChannelId/restore/:version`.
-   */
-  async restoreAdminDesignerConfig(salesChannelId, version) {
-    return this.makeAdminRequest(async () => {
-      const path = `/admin/thor/site-config/${encodeURIComponent(salesChannelId)}/restore/${encodeURIComponent(version)}`;
-      let data;
-      try {
-        data = await this.sdk.client.fetch(path, { method: "POST" });
-      } catch (error) {
-        throw new ProviderAPIError(
-          `Failed to restore admin designer config: ${error?.message ?? error?.status}`,
-          "medusa",
-          error?.status
-        );
-      }
-      return {
-        version: data.version ?? "",
-        config: data.config
-      };
-    });
-  }
-};
-
-// src/providers/shopify/transforms.ts
-function transformMoney2(shopifyMoney) {
-  return {
-    amount: shopifyMoney?.amount ?? "0.00",
-    currencyCode: shopifyMoney?.currencyCode?.toUpperCase() ?? "USD"
-  };
-}
-function transformImage2(shopifyImage) {
-  return {
-    url: shopifyImage?.url ?? "",
-    altText: shopifyImage?.altText ?? "",
-    width: shopifyImage?.width ?? 800,
-    height: shopifyImage?.height ?? 800
-  };
-}
-function transformVariant(raw) {
-  return {
-    id: raw.id,
-    title: raw.title ?? "",
-    availableForSale: raw.availableForSale ?? true,
-    price: transformMoney2(raw.price),
-    compareAtPrice: raw.compareAtPrice ? transformMoney2(raw.compareAtPrice) : void 0,
-    selectedOptions: (raw.selectedOptions ?? []).map((opt) => ({
-      name: opt.name,
-      value: opt.value
-    })),
-    image: raw.image ? transformImage2(raw.image) : void 0
-  };
-}
-function transformOption(raw) {
-  return {
-    id: raw.id,
-    name: raw.name,
-    values: raw.values ?? []
-  };
-}
-function transformProduct2(raw) {
-  const images = (raw.images?.edges ?? []).map((edge) => transformImage2(edge.node));
-  const variants = (raw.variants?.edges ?? []).map((edge) => transformVariant(edge.node));
-  return {
-    id: raw.id,
-    handle: raw.handle,
-    title: raw.title,
-    description: raw.description ?? "",
-    descriptionHtml: raw.descriptionHtml ?? "",
-    availableForSale: raw.availableForSale ?? true,
-    featuredImage: raw.featuredImage ? transformImage2(raw.featuredImage) : images[0] ?? { url: "", altText: "", width: 800, height: 800 },
-    images,
-    options: (raw.options ?? []).map(transformOption),
-    variants,
-    priceRange: {
-      minVariantPrice: transformMoney2(raw.priceRange?.minVariantPrice),
-      maxVariantPrice: transformMoney2(raw.priceRange?.maxVariantPrice)
-    },
-    seo: {
-      title: raw.seo?.title ?? raw.title ?? "",
-      description: raw.seo?.description ?? raw.description ?? ""
-    },
-    tags: raw.tags ?? [],
-    createdAt: raw.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
-    updatedAt: raw.updatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
-    vendor: raw.vendor,
-    productType: raw.productType
-  };
-}
-function transformCollection2(raw) {
-  return {
-    id: raw.id ?? "",
-    handle: raw.handle,
-    title: raw.title,
-    description: raw.description ?? "",
-    seo: {
-      title: raw.seo?.title ?? raw.title ?? "",
-      description: raw.seo?.description ?? raw.description ?? ""
-    },
-    updatedAt: raw.updatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
-    path: `/collections/${raw.handle}`
-  };
-}
-function transformCartItem2(raw) {
-  const merchandise = raw.merchandise ?? {};
-  const product = merchandise.product ?? {};
-  return {
-    id: raw.id,
-    quantity: raw.quantity ?? 1,
-    cost: {
-      totalAmount: transformMoney2(raw.cost?.totalAmount)
-    },
-    merchandise: {
-      id: merchandise.id ?? "",
-      title: merchandise.title ?? "",
-      selectedOptions: (merchandise.selectedOptions ?? []).map((opt) => ({
-        name: opt.name,
-        value: opt.value
-      })),
-      product: {
-        id: product.id ?? "",
-        handle: product.handle ?? "",
-        title: product.title ?? "",
-        featuredImage: product.featuredImage ? transformImage2(product.featuredImage) : { url: "", altText: "", width: 800, height: 800 }
-      }
-    }
-  };
-}
-function transformCart2(raw) {
-  const lines = (raw.lines?.edges ?? []).map((edge) => transformCartItem2(edge.node));
-  return {
-    id: raw.id,
-    checkoutUrl: raw.checkoutUrl ?? "",
-    totalQuantity: raw.totalQuantity ?? 0,
-    cost: {
-      subtotalAmount: transformMoney2(raw.cost?.subtotalAmount),
-      totalAmount: transformMoney2(raw.cost?.totalAmount),
-      totalTaxAmount: raw.cost?.totalTaxAmount ? transformMoney2(raw.cost.totalTaxAmount) : void 0
-    },
-    lines
-  };
-}
-
-// src/providers/shopify/queries.ts
-var PRODUCT_FRAGMENT = `
-  fragment ProductFields on Product {
-    id
-    title
-    handle
-    description
-    descriptionHtml
-    vendor
-    productType
-    tags
-    availableForSale
-    createdAt
-    updatedAt
-    seo {
-      title
-      description
-    }
-    featuredImage {
-      url
-      altText
-      width
-      height
-    }
-    images(first: 10) {
-      edges {
-        node {
-          url
-          altText
-          width
-          height
-        }
-      }
-    }
-    priceRange {
-      minVariantPrice {
-        amount
-        currencyCode
-      }
-      maxVariantPrice {
-        amount
-        currencyCode
-      }
-    }
-    options {
-      id
-      name
-      values
-    }
-    variants(first: 100) {
-      edges {
-        node {
-          id
-          title
-          availableForSale
-          price {
-            amount
-            currencyCode
-          }
-          compareAtPrice {
-            amount
-            currencyCode
-          }
-          selectedOptions {
-            name
-            value
-          }
-          image {
-            url
-            altText
-            width
-            height
-          }
-        }
-      }
-    }
-  }
-`;
-var GET_PRODUCT_BY_HANDLE = `
-  query GetProductByHandle($handle: String!) {
-    product(handle: $handle) {
-      ...ProductFields
-    }
-  }
-  ${PRODUCT_FRAGMENT}
-`;
-var GET_PRODUCTS = `
-  query GetProducts($first: Int!, $query: String, $sortKey: ProductSortKeys, $reverse: Boolean, $after: String) {
-    products(first: $first, query: $query, sortKey: $sortKey, reverse: $reverse, after: $after) {
-      edges {
-        node {
-          ...ProductFields
-        }
-        cursor
-      }
-      pageInfo {
-        hasNextPage
-        hasPreviousPage
-      }
-    }
-  }
-  ${PRODUCT_FRAGMENT}
-`;
-var GET_PRODUCT_RECOMMENDATIONS = `
-  query GetProductRecommendations($productId: ID!) {
-    productRecommendations(productId: $productId) {
-      ...ProductFields
-    }
-  }
-  ${PRODUCT_FRAGMENT}
-`;
-var COLLECTION_FRAGMENT = `
-  fragment CollectionFields on Collection {
-    id
-    title
-    handle
-    description
-    image {
-      url
-      altText
-      width
-      height
-    }
-    seo {
-      title
-      description
-    }
-    updatedAt
-  }
-`;
-var GET_COLLECTION_BY_HANDLE = `
-  query GetCollectionByHandle($handle: String!) {
-    collection(handle: $handle) {
-      ...CollectionFields
-    }
-  }
-  ${COLLECTION_FRAGMENT}
-`;
-var GET_COLLECTIONS = `
-  query GetCollections($first: Int!) {
-    collections(first: $first) {
-      edges {
-        node {
-          ...CollectionFields
-        }
-      }
-    }
-  }
-  ${COLLECTION_FRAGMENT}
-`;
-var GET_COLLECTION_PRODUCTS = `
-  query GetCollectionProducts($handle: String!, $first: Int!, $sortKey: ProductCollectionSortKeys, $reverse: Boolean, $after: String) {
-    collection(handle: $handle) {
-      products(first: $first, sortKey: $sortKey, reverse: $reverse, after: $after) {
-        edges {
-          node {
-            ...ProductFields
-          }
-          cursor
-        }
-        pageInfo {
-          hasNextPage
-        }
-      }
-    }
-  }
-  ${PRODUCT_FRAGMENT}
-`;
-var CART_FRAGMENT = `
-  fragment CartFields on Cart {
-    id
-    checkoutUrl
-    totalQuantity
-    cost {
-      subtotalAmount {
-        amount
-        currencyCode
-      }
-      totalAmount {
-        amount
-        currencyCode
-      }
-      totalTaxAmount {
-        amount
-        currencyCode
-      }
-    }
-    lines(first: 100) {
-      edges {
-        node {
-          id
-          quantity
-          cost {
-            totalAmount {
-              amount
-              currencyCode
-            }
-          }
-          merchandise {
-            ... on ProductVariant {
-              id
-              title
-              selectedOptions {
-                name
-                value
-              }
-              product {
-                id
-                handle
-                title
-                featuredImage {
-                  url
-                  altText
-                  width
-                  height
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-`;
-var GET_CART = `
-  query GetCart($cartId: ID!) {
-    cart(id: $cartId) {
-      ...CartFields
-    }
-  }
-  ${CART_FRAGMENT}
-`;
-
-// src/providers/shopify/mutations.ts
-var CART_CREATE = `
-  mutation CartCreate($input: CartInput!) {
-    cartCreate(input: $input) {
-      cart {
-        ...CartFields
-      }
-      userErrors {
-        field
-        message
-        code
-      }
-    }
-  }
-  ${CART_FRAGMENT}
-`;
-var CART_LINES_ADD = `
-  mutation CartLinesAdd($cartId: ID!, $lines: [CartLineInput!]!) {
-    cartLinesAdd(cartId: $cartId, lines: $lines) {
-      cart {
-        ...CartFields
-      }
-      userErrors {
-        field
-        message
-        code
-      }
-    }
-  }
-  ${CART_FRAGMENT}
-`;
-var CART_LINES_UPDATE = `
-  mutation CartLinesUpdate($cartId: ID!, $lines: [CartLineUpdateInput!]!) {
-    cartLinesUpdate(cartId: $cartId, lines: $lines) {
-      cart {
-        ...CartFields
-      }
-      userErrors {
-        field
-        message
-        code
-      }
-    }
-  }
-  ${CART_FRAGMENT}
-`;
-var CART_LINES_REMOVE = `
-  mutation CartLinesRemove($cartId: ID!, $lineIds: [ID!]!) {
-    cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {
-      cart {
-        ...CartFields
-      }
-      userErrors {
-        field
-        message
-        code
-      }
-    }
-  }
-  ${CART_FRAGMENT}
-`;
-var CART_DISCOUNT_CODES_UPDATE = `
-  mutation CartDiscountCodesUpdate($cartId: ID!, $discountCodes: [String!]!) {
-    cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {
-      cart {
-        ...CartFields
-      }
-      userErrors {
-        field
-        message
-        code
-      }
-    }
-  }
-  ${CART_FRAGMENT}
-`;
-
-// src/providers/shopify/index.ts
-var ShopifyProvider = class {
-  name = "shopify";
-  version = "1.0.0";
-  capabilities = SHOPIFY_CAPABILITIES;
-  logger;
-  storeDomain;
-  apiVersion;
-  endpoint;
-  headers;
-  constructor(config) {
-    this.logger = createLogger("ShopifyProvider", config.debug);
-    this.storeDomain = config.storeDomain.replace(/^https?:\/\//, "").replace(/\/$/, "");
-    this.apiVersion = config.apiVersion ?? "2026-04";
-    this.endpoint = `https://${this.storeDomain}/api/${this.apiVersion}/graphql.json`;
-    this.headers = {
-      "Content-Type": "application/json",
-      ...config.privateAccessToken ? { "Shopify-Storefront-Private-Token": config.privateAccessToken } : { "X-Shopify-Storefront-Access-Token": config.publicAccessToken }
-    };
-    this.logger.info("Initializing Shopify Provider", {
-      storeDomain: this.storeDomain,
-      apiVersion: this.apiVersion,
-      authType: config.privateAccessToken ? "private" : "public"
-    });
-  }
-  // ============================================
-  // GraphQL Client
-  // ============================================
-  async query(gql, variables) {
-    const response = await fetch(this.endpoint, {
-      method: "POST",
-      headers: this.headers,
-      body: JSON.stringify({ query: gql, variables })
-    });
-    if (!response.ok) {
-      throw new ProviderAPIError(
-        `Shopify API error: ${response.status} ${response.statusText}`,
-        "SHOPIFY_API_ERROR",
-        response.status
-      );
-    }
-    const json = await response.json();
-    if (json.errors?.length) {
-      const message = json.errors.map((e) => e.message).join("; ");
-      throw new ProviderAPIError(`Shopify GraphQL error: ${message}`, "SHOPIFY_GRAPHQL_ERROR");
-    }
-    return json.data;
-  }
-  // ============================================
-  // Product Operations
-  // ============================================
-  async getProduct(handle) {
-    const data = await this.query(GET_PRODUCT_BY_HANDLE, { handle });
-    return data.product ? transformProduct2(data.product) : void 0;
-  }
-  async getProducts(options) {
-    const first = options?.first ?? 20;
-    const sortKeyMap = {
-      "title-asc": "TITLE",
-      "title-desc": "TITLE",
-      "price-asc": "PRICE",
-      "price-desc": "PRICE",
-      "best-selling": "BEST_SELLING",
-      "created-desc": "CREATED_AT",
-      "relevance": "RELEVANCE"
-    };
-    const sortKey = options?.sortKey ? sortKeyMap[options.sortKey] ?? "RELEVANCE" : "RELEVANCE";
-    const reverse = options?.sortKey?.endsWith("-desc") ?? false;
-    const data = await this.query(GET_PRODUCTS, {
-      first,
-      query: options?.query,
-      sortKey,
-      reverse
-    });
-    return data.products.edges.map((edge) => transformProduct2(edge.node));
-  }
-  async getProductRecommendations(productId) {
-    const data = await this.query(GET_PRODUCT_RECOMMENDATIONS, {
-      productId
-    });
-    return (data.productRecommendations ?? []).map(transformProduct2);
-  }
-  // ============================================
-  // Collection Operations
-  // ============================================
-  async getCollection(handle) {
-    const data = await this.query(GET_COLLECTION_BY_HANDLE, { handle });
-    return data.collection ? transformCollection2(data.collection) : void 0;
-  }
-  async getCollections(options) {
-    const data = await this.query(GET_COLLECTIONS, {
-      first: options?.limit ?? 50
-    });
-    return data.collections.edges.map((edge) => transformCollection2(edge.node));
-  }
-  async getCollectionProducts(handle, options) {
-    const data = await this.query(
-      GET_COLLECTION_PRODUCTS,
-      {
-        handle,
-        first: options?.first ?? 20,
-        sortKey: options?.sortKey === "price-asc" || options?.sortKey === "price-desc" ? "PRICE" : "BEST_SELLING",
-        reverse: options?.sortKey?.endsWith("-desc") ?? false
-      }
-    );
-    return (data.collection?.products?.edges ?? []).map((edge) => transformProduct2(edge.node));
-  }
-  // ============================================
-  // Category Operations (Shopify does not have native categories)
-  // ============================================
-  async getCategory() {
-    this.logger.warn("Shopify does not support native categories. Use collections instead.");
-    return void 0;
-  }
-  async getCategories() {
-    return [];
-  }
-  async getCategoryProducts() {
-    return [];
-  }
-  // ============================================
-  // Cart Operations
-  // ============================================
-  async createCart() {
-    const data = await this.query(CART_CREATE, {
-      input: {}
-    });
-    if (data.cartCreate.userErrors?.length) {
-      throw new ProviderAPIError(
-        `Cart creation failed: ${data.cartCreate.userErrors.map((e) => e.message).join("; ")}`,
-        "SHOPIFY_CART_ERROR"
-      );
-    }
-    return transformCart2(data.cartCreate.cart);
-  }
-  async getCart(cartId) {
-    const data = await this.query(GET_CART, { cartId });
-    return data.cart ? transformCart2(data.cart) : void 0;
-  }
-  async addToCart(cartId, lines) {
-    const data = await this.query(CART_LINES_ADD, {
-      cartId,
-      lines: lines.map((l) => ({ merchandiseId: l.merchandiseId, quantity: l.quantity }))
-    });
-    if (data.cartLinesAdd.userErrors?.length) {
-      throw new ProviderAPIError(
-        `Add to cart failed: ${data.cartLinesAdd.userErrors.map((e) => e.message).join("; ")}`,
-        "SHOPIFY_CART_ERROR"
-      );
-    }
-    return transformCart2(data.cartLinesAdd.cart);
-  }
-  async removeFromCart(cartId, lineIds) {
-    const data = await this.query(CART_LINES_REMOVE, {
-      cartId,
-      lineIds
-    });
-    if (data.cartLinesRemove.userErrors?.length) {
-      throw new ProviderAPIError(
-        `Remove from cart failed: ${data.cartLinesRemove.userErrors.map((e) => e.message).join("; ")}`,
-        "SHOPIFY_CART_ERROR"
-      );
-    }
-    return transformCart2(data.cartLinesRemove.cart);
-  }
-  async updateCart(cartId, lines) {
-    const data = await this.query(CART_LINES_UPDATE, {
-      cartId,
-      lines: lines.map((l) => ({ id: l.id, quantity: l.quantity }))
-    });
-    if (data.cartLinesUpdate.userErrors?.length) {
-      throw new ProviderAPIError(
-        `Update cart failed: ${data.cartLinesUpdate.userErrors.map((e) => e.message).join("; ")}`,
-        "SHOPIFY_CART_ERROR"
-      );
-    }
-    return transformCart2(data.cartLinesUpdate.cart);
-  }
-  // ============================================
-  // Checkout Operations
-  // ============================================
-  async completeCheckout(_cartId) {
-    throw new ProviderAPIError(
-      "Shopify uses hosted checkout. Redirect the buyer to cart.checkoutUrl instead of calling completeCheckout().",
-      "SHOPIFY_HOSTED_CHECKOUT"
-    );
-  }
-  async getShippingMethods(_cartId) {
-    return [];
-  }
-  async getRegionCountries() {
-    return [];
-  }
-  async addShippingMethod(_cartId, _methodId) {
-    throw new ProviderAPIError(
-      "Shopify handles shipping selection in hosted checkout.",
-      "SHOPIFY_HOSTED_CHECKOUT"
-    );
-  }
-  async initiatePaymentSession(_cartId, _providerId) {
-    throw new ProviderAPIError(
-      "Shopify handles payment in hosted checkout.",
-      "SHOPIFY_HOSTED_CHECKOUT"
-    );
-  }
-  async applyDiscountCode(cartId, code) {
-    const currentCart = await this.getCart(cartId);
-    const existingCodes = [];
-    existingCodes.push(code);
-    const data = await this.query(
-      CART_DISCOUNT_CODES_UPDATE,
-      { cartId, discountCodes: existingCodes }
-    );
-    if (data.cartDiscountCodesUpdate.userErrors?.length) {
-      throw new ProviderAPIError(
-        `Discount code failed: ${data.cartDiscountCodesUpdate.userErrors.map((e) => e.message).join("; ")}`,
-        "SHOPIFY_DISCOUNT_ERROR"
-      );
-    }
-    return transformCart2(data.cartDiscountCodesUpdate.cart);
-  }
-  async removeDiscountCode(cartId, _code) {
-    const data = await this.query(
-      CART_DISCOUNT_CODES_UPDATE,
-      { cartId, discountCodes: [] }
-    );
-    return transformCart2(data.cartDiscountCodesUpdate.cart);
-  }
-  // ============================================
-  // Customer Operations
-  // ============================================
-  async getOrders(options) {
-    this.logger.warn("Shopify orders require Customer Account API (planned upgrade path).");
-    return [];
-  }
-  // ============================================
-  // Payment Operations
-  // ============================================
-  async getPaymentMethods(_options) {
-    return [];
-  }
-  // ============================================
-  // Inventory Operations (not available via Storefront API)
-  // ============================================
-  async getStockLocations() {
-    return [];
-  }
-  async checkInventoryLevels() {
-    return [];
-  }
-  async validateCartStock() {
-    return { allAvailable: true, unavailableItems: [] };
-  }
-  async getFulfillmentOptions() {
-    return [];
-  }
-  // ============================================
-  // Admin Operations (not available via Storefront API)
-  // ============================================
-  async cancelOrder(_orderId) {
-    throw new ProviderAPIError(
-      "Order cancellation requires Shopify Admin API (not available in Storefront API).",
-      "SHOPIFY_ADMIN_REQUIRED"
-    );
-  }
-  async createFulfillment(_orderId) {
-    throw new ProviderAPIError(
-      "Fulfillment requires Shopify Admin API.",
-      "SHOPIFY_ADMIN_REQUIRED"
-    );
-  }
-  async createRefund(_orderId) {
-    throw new ProviderAPIError(
-      "Refunds require Shopify Admin API.",
-      "SHOPIFY_ADMIN_REQUIRED"
-    );
-  }
-  async getAdminOrders() {
-    return { orders: [], count: 0 };
-  }
-  // ============================================
-  // Storefront / Multi-Tenant
-  // ============================================
-  async getStorefrontContext() {
-    return {
-      id: this.storeDomain,
-      name: this.storeDomain,
-      platformType: "shopify",
-      requiresProductScoping: false,
-      currencyCode: "USD"
-    };
-  }
-  isStorefrontRequired() {
-    return false;
-  }
-};
-
-// src/providers/bigcommerce/transforms.ts
-function transformMoney3(amount, currencyCode = "USD") {
-  const numAmount = typeof amount === "string" ? parseFloat(amount) : amount ?? 0;
-  return {
-    amount: numAmount.toFixed(2),
-    currencyCode: currencyCode.toUpperCase()
-  };
-}
-function transformImage3(url, alt = "") {
-  return { url, altText: alt, width: 800, height: 800 };
-}
-function transformProduct3(raw, currencyCode = "USD") {
-  const images = (raw.images ?? []).map(
-    (img) => transformImage3(img.url_standard ?? img.url_thumbnail ?? "", img.description ?? "")
-  );
-  const variants = (raw.variants ?? []).map((v) => ({
-    id: String(v.id),
-    title: v.option_display_name ?? `Variant ${v.id}`,
-    availableForSale: v.purchasing_disabled !== true,
-    price: transformMoney3(v.price ?? raw.price, currencyCode),
-    compareAtPrice: v.sale_price ? transformMoney3(v.sale_price, currencyCode) : void 0,
-    selectedOptions: (v.option_values ?? []).map((ov) => ({
-      name: ov.option_display_name ?? "",
-      value: ov.label ?? ""
-    }))
-  }));
-  const options = (raw.options ?? []).map((opt) => ({
-    id: String(opt.id),
-    name: opt.display_name ?? "",
-    values: (opt.option_values ?? []).map((val) => val.label ?? "")
-  }));
-  const price = raw.price ?? raw.calculated_price?.as_entered ?? 0;
-  return {
-    id: String(raw.id),
-    handle: raw.custom_url?.url?.replace(/^\//, "").replace(/\/$/, "") ?? String(raw.id),
-    title: raw.name ?? "",
-    description: raw.plain_text_description ?? raw.description ?? "",
-    descriptionHtml: raw.description ?? "",
-    availableForSale: raw.availability === "available" || raw.is_visible !== false,
-    featuredImage: images[0] ?? { url: "", altText: "", width: 800, height: 800 },
-    images,
-    options,
-    variants,
-    priceRange: {
-      minVariantPrice: transformMoney3(price, currencyCode),
-      maxVariantPrice: transformMoney3(price, currencyCode)
-    },
-    seo: {
-      title: raw.page_title ?? raw.name ?? "",
-      description: raw.meta_description ?? ""
-    },
-    tags: [],
-    createdAt: raw.date_created ?? (/* @__PURE__ */ new Date()).toISOString(),
-    updatedAt: raw.date_modified ?? (/* @__PURE__ */ new Date()).toISOString()
-  };
-}
-function transformCollection3(raw) {
-  return {
-    id: String(raw.id ?? ""),
-    handle: raw.custom_url?.url?.replace(/^\//, "").replace(/\/$/, "") ?? String(raw.id),
-    title: raw.name ?? "",
-    description: raw.description ?? "",
-    seo: {
-      title: raw.page_title ?? raw.name ?? "",
-      description: raw.meta_description ?? ""
-    },
-    updatedAt: raw.date_modified ?? (/* @__PURE__ */ new Date()).toISOString(),
-    path: `/collections/${raw.custom_url?.url?.replace(/^\//, "").replace(/\/$/, "") ?? raw.id}`
-  };
-}
-function transformCart3(raw, currencyCode = "USD") {
-  const lineItems = Object.values(raw.line_items ?? {}).flat();
-  const lines = lineItems.map((item) => ({
-    id: item.id,
-    quantity: item.quantity ?? 1,
-    cost: {
-      totalAmount: transformMoney3(item.extended_sale_price ?? item.sale_price ?? 0, currencyCode)
-    },
-    merchandise: {
-      id: String(item.variant_id ?? item.product_id),
-      title: item.name ?? "",
-      selectedOptions: (item.options ?? []).map((opt) => ({
-        name: opt.name ?? "",
-        value: opt.value ?? ""
-      })),
-      product: {
-        id: String(item.product_id),
-        handle: String(item.product_id),
-        title: item.name ?? "",
-        featuredImage: item.image_url ? transformImage3(item.image_url) : { url: "", altText: "", width: 800, height: 800 }
-      }
-    }
-  }));
-  return {
-    id: raw.id,
-    checkoutUrl: raw.redirect_urls?.checkout_url ?? "",
-    totalQuantity: lines.reduce((sum, l) => sum + l.quantity, 0),
-    cost: {
-      subtotalAmount: transformMoney3(raw.base_amount ?? 0, currencyCode),
-      totalAmount: transformMoney3(raw.cart_amount ?? 0, currencyCode)
-    },
-    lines
-  };
-}
-
-// src/providers/bigcommerce/index.ts
-var BigCommerceProvider = class {
-  name = "bigcommerce";
-  version = "1.0.0";
-  capabilities = BIGCOMMERCE_CAPABILITIES;
-  logger;
-  storefrontApiUrl;
-  storeHash;
-  channelId;
-  currencyCode;
-  headers;
-  constructor(config) {
-    this.logger = createLogger("BigCommerceProvider", config.debug);
-    this.storefrontApiUrl = config.storefrontApiUrl.replace(/\/$/, "");
-    this.storeHash = config.storeHash;
-    this.channelId = config.channelId;
-    this.currencyCode = config.currencyCode ?? "USD";
-    this.headers = {
-      "Content-Type": "application/json",
-      "Authorization": `Bearer ${config.storefrontApiToken}`
-    };
-    this.logger.info("Initializing BigCommerce Provider", { storeHash: this.storeHash, channelId: this.channelId });
-  }
-  async fetchApi(path, init) {
-    const url = `${this.storefrontApiUrl}${path}`;
-    const response = await fetch(url, {
-      ...init,
-      headers: { ...this.headers, ...init?.headers }
-    });
-    if (!response.ok) {
-      throw new ProviderAPIError(
-        `BigCommerce API error: ${response.status} ${response.statusText}`,
-        "BIGCOMMERCE_API_ERROR",
-        response.status
-      );
-    }
-    return response.json();
-  }
-  // ============================================
-  // Product Operations
-  // ============================================
-  async getProduct(handle) {
-    try {
-      const data = await this.fetchApi(`/api/storefront/products?include=variants,options,images&keyword=${encodeURIComponent(handle)}`);
-      const product = data.data?.[0];
-      return product ? transformProduct3(product, this.currencyCode) : void 0;
-    } catch {
-      return void 0;
-    }
-  }
-  async getProducts(options) {
-    const limit = options?.first ?? 20;
-    let path = `/api/storefront/products?include=variants,options,images&limit=${limit}`;
-    if (options?.query) path += `&keyword=${encodeURIComponent(options.query)}`;
-    const data = await this.fetchApi(path);
-    return (data.data ?? []).map((p) => transformProduct3(p, this.currencyCode));
-  }
-  async getProductRecommendations(_productId) {
-    return [];
-  }
-  // ============================================
-  // Collection Operations (BigCommerce Categories)
-  // ============================================
-  async getCollection(handle) {
-    try {
-      const data = await this.fetchApi(`/api/storefront/categories?url=/${handle}/`);
-      const cat = data.data?.[0];
-      return cat ? transformCollection3(cat) : void 0;
-    } catch {
-      return void 0;
-    }
-  }
-  async getCollections(options) {
-    const limit = options?.limit ?? 50;
-    const data = await this.fetchApi(`/api/storefront/categories?limit=${limit}`);
-    return (data.data ?? []).map(transformCollection3);
-  }
-  async getCollectionProducts(handle, options) {
-    const limit = options?.first ?? 20;
-    const data = await this.fetchApi(
-      `/api/storefront/products?include=variants,options,images&categories:in=${handle}&limit=${limit}`
-    );
-    return (data.data ?? []).map((p) => transformProduct3(p, this.currencyCode));
-  }
-  // ============================================
-  // Category Operations
-  // ============================================
-  async getCategory(idOrHandle) {
-    return this.getCollection(idOrHandle);
-  }
-  async getCategories(options) {
-    return this.getCollections(options);
-  }
-  async getCategoryProducts(handle, options) {
-    return this.getCollectionProducts(handle, options);
-  }
-  // ============================================
-  // Cart Operations
-  // ============================================
-  async createCart() {
-    const data = await this.fetchApi("/api/storefront/carts", {
-      method: "POST",
-      body: JSON.stringify({ line_items: [] })
-    });
-    return transformCart3(data.data ?? data, this.currencyCode);
-  }
-  async getCart(cartId) {
-    try {
-      const data = await this.fetchApi(`/api/storefront/carts/${cartId}?include=line_items.physical_items.options`);
-      return transformCart3(data.data ?? data, this.currencyCode);
-    } catch {
-      return void 0;
-    }
-  }
-  async addToCart(cartId, lines) {
-    const lineItems = lines.map((l) => ({
-      product_id: parseInt(l.merchandiseId, 10),
-      quantity: l.quantity
-    }));
-    const data = await this.fetchApi(`/api/storefront/carts/${cartId}/items`, {
-      method: "POST",
-      body: JSON.stringify({ line_items: lineItems })
-    });
-    return transformCart3(data.data ?? data, this.currencyCode);
-  }
-  async removeFromCart(cartId, lineIds) {
-    for (const lineId of lineIds) {
-      await this.fetchApi(`/api/storefront/carts/${cartId}/items/${lineId}`, { method: "DELETE" });
-    }
-    const cart = await this.getCart(cartId);
-    if (!cart) throw new ProviderAPIError("Cart not found after removal", "BIGCOMMERCE_CART_ERROR");
-    return cart;
-  }
-  async updateCart(cartId, lines) {
-    for (const line of lines) {
-      await this.fetchApi(`/api/storefront/carts/${cartId}/items/${line.id}`, {
-        method: "PUT",
-        body: JSON.stringify({ line_item: { quantity: line.quantity } })
-      });
-    }
-    const cart = await this.getCart(cartId);
-    if (!cart) throw new ProviderAPIError("Cart not found after update", "BIGCOMMERCE_CART_ERROR");
-    return cart;
-  }
-  // ============================================
-  // Checkout Operations (Hosted)
-  // ============================================
-  async completeCheckout(_cartId) {
-    throw new ProviderAPIError(
-      "BigCommerce uses Embedded Checkout. Redirect the buyer to cart.checkoutUrl.",
-      "BIGCOMMERCE_HOSTED_CHECKOUT"
-    );
-  }
-  async getShippingMethods(_cartId) {
-    return [];
-  }
-  async getRegionCountries() {
-    return [];
-  }
-  async addShippingMethod(_cartId, _methodId) {
-    throw new ProviderAPIError("BigCommerce handles shipping in Embedded Checkout.", "BIGCOMMERCE_HOSTED_CHECKOUT");
-  }
-  async initiatePaymentSession(_cartId, _providerId) {
-    throw new ProviderAPIError("BigCommerce handles payment in Embedded Checkout.", "BIGCOMMERCE_HOSTED_CHECKOUT");
-  }
-  async applyDiscountCode(cartId, code) {
-    const data = await this.fetchApi(`/api/storefront/carts/${cartId}/coupons`, {
-      method: "POST",
-      body: JSON.stringify({ coupon_code: code })
-    });
-    return transformCart3(data.data ?? data, this.currencyCode);
-  }
-  async removeDiscountCode(cartId, code) {
-    await this.fetchApi(`/api/storefront/carts/${cartId}/coupons/${encodeURIComponent(code)}`, { method: "DELETE" });
-    const cart = await this.getCart(cartId);
-    if (!cart) throw new ProviderAPIError("Cart not found after coupon removal", "BIGCOMMERCE_CART_ERROR");
-    return cart;
-  }
-  // ============================================
-  // Customer, Order, Payment, Inventory, Admin
-  // ============================================
-  async getOrders(_options) {
-    return [];
-  }
-  async getPaymentMethods(_options) {
-    return [];
-  }
-  async getStockLocations() {
-    return [];
-  }
-  async checkInventoryLevels() {
-    return [];
-  }
-  async validateCartStock() {
-    return { allAvailable: true, unavailableItems: [] };
-  }
-  async getFulfillmentOptions() {
-    return [];
-  }
-  async cancelOrder(_orderId) {
-    throw new ProviderAPIError("Order cancellation requires BigCommerce Management API.", "BIGCOMMERCE_ADMIN_REQUIRED");
-  }
-  async createFulfillment(_orderId) {
-    throw new ProviderAPIError("Fulfillment requires BigCommerce Management API.", "BIGCOMMERCE_ADMIN_REQUIRED");
-  }
-  async createRefund(_orderId) {
-    throw new ProviderAPIError("Refunds require BigCommerce Management API.", "BIGCOMMERCE_ADMIN_REQUIRED");
-  }
-  async getAdminOrders() {
-    return { orders: [], count: 0 };
-  }
-  async getStorefrontContext() {
-    return {
-      id: this.channelId,
-      name: `BigCommerce Store ${this.storeHash}`,
-      platformType: "bigcommerce",
-      requiresProductScoping: false,
-      currencyCode: this.currencyCode
-    };
-  }
-  isStorefrontRequired() {
-    return false;
-  }
-};
-
-// src/providers/woocommerce/transforms.ts
-function transformMoney4(amount, currencyCode = "USD") {
-  const numAmount = typeof amount === "string" ? parseFloat(amount) : amount ?? 0;
-  return {
-    amount: isNaN(numAmount) ? "0.00" : numAmount.toFixed(2),
-    currencyCode: currencyCode.toUpperCase()
-  };
-}
-function transformImage4(url, alt = "") {
-  return { url, altText: alt, width: 800, height: 800 };
-}
-function transformProduct4(raw, currencyCode = "USD") {
-  const images = (raw.images ?? []).map(
-    (img) => transformImage4(img.src ?? "", img.alt ?? img.name ?? "")
-  );
-  const variants = (raw.variations ?? []).map((v) => ({
-    id: String(v.id),
-    title: v.name ?? "",
-    availableForSale: v.in_stock !== false,
-    price: transformMoney4(v.prices?.price ?? v.price, currencyCode),
-    compareAtPrice: v.prices?.regular_price ? transformMoney4(v.prices.regular_price, currencyCode) : void 0,
-    selectedOptions: (v.attributes ?? []).map((attr) => ({
-      name: attr.name ?? "",
-      value: attr.value ?? ""
-    }))
-  }));
-  const options = (raw.attributes ?? []).filter((attr) => attr.variation === true || attr.has_options === true).map((attr) => ({
-    id: String(attr.id),
-    name: attr.name ?? "",
-    values: (attr.terms ?? attr.options ?? []).map(
-      (t) => typeof t === "string" ? t : t.name ?? t.value ?? ""
-    )
-  }));
-  const priceMinor = raw.prices?.price ?? "0";
-  const priceDecimalPlaces = raw.prices?.currency_minor_unit ?? 2;
-  const priceMajor = parseInt(priceMinor, 10) / Math.pow(10, priceDecimalPlaces);
-  return {
-    id: String(raw.id),
-    handle: raw.slug ?? String(raw.id),
-    title: raw.name ?? "",
-    description: raw.short_description ?? raw.description ?? "",
-    descriptionHtml: raw.description ?? "",
-    availableForSale: raw.is_purchasable !== false && raw.is_in_stock !== false,
-    featuredImage: images[0] ?? { url: "", altText: "", width: 800, height: 800 },
-    images,
-    options,
-    variants,
-    priceRange: {
-      minVariantPrice: transformMoney4(priceMajor, currencyCode),
-      maxVariantPrice: transformMoney4(priceMajor, currencyCode)
-    },
-    seo: {
-      title: raw.name ?? "",
-      description: raw.short_description?.replace(/<[^>]*>/g, "") ?? ""
-    },
-    tags: [],
-    createdAt: raw.date_created ?? (/* @__PURE__ */ new Date()).toISOString(),
-    updatedAt: raw.date_modified ?? (/* @__PURE__ */ new Date()).toISOString()
-  };
-}
-function transformCollection4(raw) {
-  return {
-    id: String(raw.id ?? ""),
-    handle: raw.slug ?? String(raw.id),
-    title: raw.name ?? "",
-    description: raw.description ?? "",
-    seo: {
-      title: raw.name ?? "",
-      description: raw.description?.replace(/<[^>]*>/g, "") ?? ""
-    },
-    updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    path: `/collections/${raw.slug ?? raw.id}`
-  };
-}
-function transformCart4(raw, currencyCode = "USD") {
-  const lines = (raw.items ?? []).map((item) => {
-    const minorUnit2 = item.prices?.currency_minor_unit ?? 2;
-    const divisor2 = Math.pow(10, minorUnit2);
-    const lineTotal = parseInt(item.totals?.line_total ?? "0", 10) / divisor2;
-    return {
-      id: item.key ?? String(item.id),
-      quantity: item.quantity ?? 1,
-      cost: {
-        totalAmount: transformMoney4(lineTotal, currencyCode)
-      },
-      merchandise: {
-        id: String(item.id),
-        title: item.name ?? "",
-        selectedOptions: (item.variation ?? []).map((v) => ({
-          name: v.attribute ?? "",
-          value: v.value ?? ""
-        })),
-        product: {
-          id: String(item.id),
-          handle: item.slug ?? String(item.id),
-          title: item.name ?? "",
-          featuredImage: item.images?.[0] ? transformImage4(item.images[0].src, item.images[0].alt ?? "") : { url: "", altText: "", width: 800, height: 800 }
-        }
-      }
-    };
-  });
-  const minorUnit = raw.totals?.currency_minor_unit ?? 2;
-  const divisor = Math.pow(10, minorUnit);
-  const subtotal = parseInt(raw.totals?.total_items ?? "0", 10) / divisor;
-  const total = parseInt(raw.totals?.total_price ?? "0", 10) / divisor;
-  return {
-    id: raw.cart_key ?? void 0,
-    checkoutUrl: "",
-    // WooCommerce handles checkout via its own /checkout page
-    totalQuantity: raw.items_count ?? lines.reduce((sum, l) => sum + l.quantity, 0),
-    cost: {
-      subtotalAmount: transformMoney4(subtotal, currencyCode),
-      totalAmount: transformMoney4(total, currencyCode)
-    },
-    lines
-  };
-}
-function transformWooAddress(raw) {
-  return {
-    id: void 0,
-    firstName: raw.first_name ?? "",
-    lastName: raw.last_name ?? "",
-    address1: raw.address_1 ?? "",
-    address2: raw.address_2 ?? "",
-    city: raw.city ?? "",
-    province: raw.state ?? "",
-    countryCode: raw.country ?? "",
-    postalCode: raw.postcode ?? "",
-    phone: raw.phone ?? "",
-    company: raw.company ?? ""
-  };
-}
-function transformOrder4(raw, currencyCode = "USD") {
-  const items = (raw.line_items ?? []).map((item) => ({
-    id: String(item.id),
-    title: item.name ?? "",
-    quantity: item.quantity ?? 1,
-    price: transformMoney4(item.price ?? 0, currencyCode),
-    total: transformMoney4(item.total ?? 0, currencyCode),
-    productId: String(item.product_id),
-    variantId: item.variation_id ? String(item.variation_id) : void 0
-  }));
-  const statusMap = {
-    pending: "pending",
-    processing: "processing",
-    "on-hold": "pending",
-    completed: "completed",
-    cancelled: "cancelled",
-    refunded: "refunded",
-    failed: "cancelled"
-  };
-  const paymentMap = {
-    pending: "pending",
-    processing: "authorized",
-    completed: "paid",
-    refunded: "refunded"
-  };
-  return {
-    id: String(raw.id),
-    orderNumber: String(raw.number ?? raw.id),
-    email: raw.billing?.email ?? "",
-    status: statusMap[raw.status] ?? "pending",
-    paymentStatus: paymentMap[raw.status] ?? "pending",
-    fulfillmentStatus: raw.status === "completed" ? "fulfilled" : "unfulfilled",
-    items,
-    total: transformMoney4(raw.total ?? 0, currencyCode),
-    subtotal: transformMoney4(raw.subtotal ?? 0, currencyCode),
-    tax: transformMoney4(raw.total_tax ?? 0, currencyCode),
-    shipping: transformMoney4(raw.shipping_total ?? 0, currencyCode),
-    shippingAddress: raw.shipping ? transformWooAddress(raw.shipping) : void 0,
-    billingAddress: raw.billing ? transformWooAddress(raw.billing) : void 0,
-    createdAt: raw.date_created ?? (/* @__PURE__ */ new Date()).toISOString(),
-    updatedAt: raw.date_modified ?? (/* @__PURE__ */ new Date()).toISOString()
-  };
-}
-
-// src/providers/woocommerce/index.ts
-var WooCommerceProvider = class {
-  name = "woocommerce";
-  version = "1.0.0";
-  capabilities = WOOCOMMERCE_CAPABILITIES;
-  logger;
-  baseUrl;
-  storeApiBase;
-  restApiBase;
-  currencyCode;
-  authHeader;
-  constructor(config) {
-    this.logger = createLogger("WooCommerceProvider", config.debug);
-    this.baseUrl = config.url.replace(/\/$/, "");
-    this.storeApiBase = `${this.baseUrl}/wp-json/wc/store/v1`;
-    this.restApiBase = `${this.baseUrl}/wp-json/wc/v3`;
-    this.currencyCode = config.currencyCode ?? "USD";
-    if (config.consumerKey && config.consumerSecret) {
-      this.authHeader = "Basic " + btoa(`${config.consumerKey}:${config.consumerSecret}`);
-    }
-    this.logger.info("Initializing WooCommerce Provider", { baseUrl: this.baseUrl });
-  }
-  async storeApiFetch(path, init) {
-    const response = await fetch(`${this.storeApiBase}${path}`, {
-      ...init,
-      headers: { "Content-Type": "application/json", ...init?.headers }
-    });
-    if (!response.ok) {
-      throw new ProviderAPIError(`WooCommerce Store API error: ${response.status}`, "WOOCOMMERCE_API_ERROR", response.status);
-    }
-    return response.json();
-  }
-  async restApiFetch(path, init) {
-    if (!this.authHeader) {
-      throw new ProviderAPIError("WooCommerce REST API requires consumer key/secret.", "WOOCOMMERCE_AUTH_REQUIRED");
-    }
-    const response = await fetch(`${this.restApiBase}${path}`, {
-      ...init,
-      headers: { "Content-Type": "application/json", "Authorization": this.authHeader, ...init?.headers }
-    });
-    if (!response.ok) {
-      throw new ProviderAPIError(`WooCommerce REST API error: ${response.status}`, "WOOCOMMERCE_API_ERROR", response.status);
-    }
-    return response.json();
-  }
-  // ============================================
-  // Product Operations (Store API)
-  // ============================================
-  async getProduct(handle) {
-    try {
-      const products = await this.storeApiFetch(`/products?slug=${encodeURIComponent(handle)}`);
-      return products[0] ? transformProduct4(products[0], this.currencyCode) : void 0;
-    } catch {
-      return void 0;
-    }
-  }
-  async getProducts(options) {
-    let path = `/products?per_page=${options?.first ?? 20}`;
-    if (options?.query) path += `&search=${encodeURIComponent(options.query)}`;
-    if (options?.sortKey) {
-      const [orderby, order] = options.sortKey.includes("-desc") ? [options.sortKey.replace("-desc", ""), "desc"] : [options.sortKey.replace("-asc", ""), "asc"];
-      path += `&orderby=${orderby}&order=${order}`;
-    }
-    const products = await this.storeApiFetch(path);
-    return products.map((p) => transformProduct4(p, this.currencyCode));
-  }
-  async getProductRecommendations(_productId) {
-    return [];
-  }
-  // ============================================
-  // Collection/Category Operations (Store API)
-  // ============================================
-  async getCollection(handle) {
-    try {
-      const cats = await this.storeApiFetch(`/products/categories?slug=${encodeURIComponent(handle)}`);
-      return cats[0] ? transformCollection4(cats[0]) : void 0;
-    } catch {
-      return void 0;
-    }
-  }
-  async getCollections(options) {
-    const cats = await this.storeApiFetch(`/products/categories?per_page=${options?.limit ?? 50}`);
-    return cats.map(transformCollection4);
-  }
-  async getCollectionProducts(handle, options) {
-    const products = await this.storeApiFetch(
-      `/products?category=${encodeURIComponent(handle)}&per_page=${options?.first ?? 20}`
-    );
-    return products.map((p) => transformProduct4(p, this.currencyCode));
-  }
-  async getCategory(idOrHandle) {
-    return this.getCollection(idOrHandle);
-  }
-  async getCategories(options) {
-    return this.getCollections(options);
-  }
-  async getCategoryProducts(handle, options) {
-    return this.getCollectionProducts(handle, options);
-  }
-  // ============================================
-  // Cart Operations (Store API)
-  // ============================================
-  async createCart() {
-    const cart = await this.storeApiFetch("/cart");
-    return transformCart4(cart, this.currencyCode);
-  }
-  async getCart(_cartId) {
-    try {
-      const cart = await this.storeApiFetch("/cart");
-      return transformCart4(cart, this.currencyCode);
-    } catch {
-      return void 0;
-    }
-  }
-  async addToCart(_cartId, lines) {
-    for (const line of lines) {
-      await this.storeApiFetch("/cart/add-item", {
-        method: "POST",
-        body: JSON.stringify({ id: parseInt(line.merchandiseId, 10), quantity: line.quantity })
-      });
-    }
-    const cart = await this.storeApiFetch("/cart");
-    return transformCart4(cart, this.currencyCode);
-  }
-  async removeFromCart(_cartId, lineIds) {
-    for (const key of lineIds) {
-      await this.storeApiFetch("/cart/remove-item", {
-        method: "POST",
-        body: JSON.stringify({ key })
-      });
-    }
-    const cart = await this.storeApiFetch("/cart");
-    return transformCart4(cart, this.currencyCode);
-  }
-  async updateCart(_cartId, lines) {
-    for (const line of lines) {
-      await this.storeApiFetch("/cart/update-item", {
-        method: "POST",
-        body: JSON.stringify({ key: line.id, quantity: line.quantity })
-      });
-    }
-    const cart = await this.storeApiFetch("/cart");
-    return transformCart4(cart, this.currencyCode);
-  }
-  // ============================================
-  // Checkout Operations (Store API)
-  // ============================================
-  async completeCheckout(_cartId) {
-    const result = await this.storeApiFetch("/checkout", { method: "POST", body: JSON.stringify({}) });
-    return transformOrder4(result, this.currencyCode);
-  }
-  async getShippingMethods(_cartId) {
-    return [];
-  }
-  async getRegionCountries() {
-    return [];
-  }
-  async addShippingMethod(_cartId, methodId) {
-    await this.storeApiFetch("/cart/select-shipping-rate", {
-      method: "POST",
-      body: JSON.stringify({ rate_id: methodId })
-    });
-    const cart = await this.storeApiFetch("/cart");
-    return transformCart4(cart, this.currencyCode);
-  }
-  async initiatePaymentSession(_cartId, _providerId) {
-  }
-  async applyDiscountCode(_cartId, code) {
-    await this.storeApiFetch("/cart/apply-coupon", {
-      method: "POST",
-      body: JSON.stringify({ code })
-    });
-    const cart = await this.storeApiFetch("/cart");
-    return transformCart4(cart, this.currencyCode);
-  }
-  async removeDiscountCode(_cartId, code) {
-    await this.storeApiFetch("/cart/remove-coupon", {
-      method: "POST",
-      body: JSON.stringify({ code })
-    });
-    const cart = await this.storeApiFetch("/cart");
-    return transformCart4(cart, this.currencyCode);
-  }
-  // ============================================
-  // Customer, Order, Payment, Inventory, Admin
-  // ============================================
-  async getOrders(_options) {
-    return [];
-  }
-  async getPaymentMethods(_options) {
-    return [];
-  }
-  async getStockLocations() {
-    return [];
-  }
-  async checkInventoryLevels() {
-    return [];
-  }
-  async validateCartStock() {
-    return { allAvailable: true, unavailableItems: [] };
-  }
-  async getFulfillmentOptions() {
-    return [];
-  }
-  async cancelOrder(_orderId) {
-    throw new ProviderAPIError("Order cancellation requires WooCommerce REST API v3.", "WOOCOMMERCE_AUTH_REQUIRED");
-  }
-  async createFulfillment(_orderId) {
-    throw new ProviderAPIError("Fulfillment requires WooCommerce REST API v3.", "WOOCOMMERCE_AUTH_REQUIRED");
-  }
-  async createRefund(_orderId) {
-    throw new ProviderAPIError("Refunds require WooCommerce REST API v3.", "WOOCOMMERCE_AUTH_REQUIRED");
-  }
-  async getAdminOrders() {
-    return { orders: [], count: 0 };
-  }
-  async getStorefrontContext() {
-    return {
-      id: this.baseUrl,
-      name: `WooCommerce ${this.baseUrl}`,
-      platformType: "woocommerce",
-      requiresProductScoping: false,
-      currencyCode: this.currencyCode
-    };
-  }
-  isStorefrontRequired() {
-    return false;
-  }
-};
-
-// src/providers/spree/transforms.ts
-function toMoney(amount, currencyCode) {
-  const num = typeof amount === "string" ? parseFloat(amount) || 0 : amount;
-  return { amount: num.toFixed(2), currencyCode };
-}
-function transformProduct5(data, included = [], currencyCode = "USD") {
-  const attrs = data.attributes ?? data;
-  const id = String(data.id ?? "");
-  const images = [];
-  const imageRels = data.relationships?.images?.data ?? [];
-  for (const imgRef of imageRels) {
-    const imgIncluded = included.find((i) => i.type === "image" && String(i.id) === String(imgRef.id));
-    if (imgIncluded) {
-      images.push({
-        url: imgIncluded.attributes?.original_url ?? imgIncluded.attributes?.styles?.[0]?.url ?? "",
-        altText: imgIncluded.attributes?.alt ?? attrs.name ?? "",
-        width: void 0,
-        height: void 0
-      });
-    }
-  }
-  if (images.length === 0 && Array.isArray(attrs.images)) {
-    for (const img of attrs.images) {
-      images.push({
-        url: img.original_url ?? img.url ?? "",
-        altText: img.alt ?? attrs.name ?? "",
-        width: void 0,
-        height: void 0
-      });
-    }
-  }
-  const variants = [];
-  const variantRels = data.relationships?.variants?.data ?? [];
-  for (const varRef of variantRels) {
-    const varIncluded = included.find((i) => i.type === "variant" && String(i.id) === String(varRef.id));
-    if (varIncluded) {
-      const vAttrs = varIncluded.attributes ?? {};
-      variants.push({
-        id: String(varIncluded.id),
-        title: vAttrs.name ?? vAttrs.sku ?? `Variant ${varIncluded.id}`,
-        availableForSale: vAttrs.in_stock !== false && vAttrs.purchasable !== false,
-        price: toMoney(vAttrs.price ?? vAttrs.display_price ?? "0", currencyCode),
-        compareAtPrice: vAttrs.compare_at_price ? toMoney(vAttrs.compare_at_price, currencyCode) : void 0,
-        selectedOptions: (vAttrs.option_values ?? []).map((ov) => ({
-          name: ov.option_type_name ?? "Option",
-          value: ov.name ?? ov.presentation ?? ""
-        }))
-      });
-    }
-  }
-  if (variants.length === 0) {
-    variants.push({
-      id: attrs.default_variant_id ? String(attrs.default_variant_id) : id,
-      title: "Default",
-      availableForSale: attrs.in_stock !== false && attrs.purchasable !== false,
-      price: toMoney(attrs.price ?? attrs.display_price ?? "0", currencyCode),
-      compareAtPrice: attrs.compare_at_price ? toMoney(attrs.compare_at_price, currencyCode) : void 0,
-      selectedOptions: []
-    });
-  }
-  const options = (attrs.option_types ?? []).map((ot) => ({
-    id: String(ot.id ?? ot.name ?? ""),
-    name: ot.presentation ?? ot.name ?? "",
-    values: (ot.option_values ?? []).map((ov) => ov.presentation ?? ov.name ?? "")
-  }));
-  return {
-    id,
-    handle: attrs.slug ?? id,
-    title: attrs.name ?? "",
-    description: attrs.description ?? "",
-    descriptionHtml: attrs.description ?? "",
-    availableForSale: attrs.in_stock !== false && attrs.purchasable !== false,
-    priceRange: {
-      minVariantPrice: variants.reduce(
-        (min, v) => v.price.amount < min.amount ? v.price : min,
-        variants[0]?.price ?? toMoney("0", currencyCode)
-      ),
-      maxVariantPrice: variants.reduce(
-        (max, v) => v.price.amount > max.amount ? v.price : max,
-        variants[0]?.price ?? toMoney("0", currencyCode)
-      )
-    },
-    variants,
-    options,
-    images,
-    featuredImage: images[0] ?? { url: "", altText: attrs.name ?? "" },
-    tags: [],
-    seo: {
-      title: attrs.meta_title ?? attrs.name ?? "",
-      description: attrs.meta_description ?? ""
-    },
-    updatedAt: attrs.updated_at ?? (/* @__PURE__ */ new Date()).toISOString(),
-    createdAt: attrs.created_at ?? (/* @__PURE__ */ new Date()).toISOString()
-  };
-}
-function transformCollection5(data) {
-  const attrs = data.attributes ?? data;
-  return {
-    id: String(data.id ?? ""),
-    handle: attrs.permalink ?? attrs.slug ?? String(data.id ?? ""),
-    title: attrs.name ?? "",
-    description: attrs.description ?? "",
-    seo: {
-      title: attrs.meta_title ?? attrs.name ?? "",
-      description: attrs.meta_description ?? ""
-    },
-    updatedAt: attrs.updated_at ?? (/* @__PURE__ */ new Date()).toISOString(),
-    path: `/collections/${attrs.permalink ?? attrs.slug ?? data.id}`
-  };
-}
-function transformCart5(data, currencyCode = "USD") {
-  const attrs = data.attributes ?? data;
-  const items = (attrs.line_items ?? data.included?.filter((i) => i.type === "line_item") ?? []).map(
-    (item) => {
-      const itemAttrs = item.attributes ?? item;
-      return {
-        id: String(item.id ?? itemAttrs.id ?? ""),
-        quantity: itemAttrs.quantity ?? 1,
-        cost: {
-          totalAmount: toMoney(itemAttrs.total ?? itemAttrs.display_total ?? "0", currencyCode)
-        },
-        merchandise: {
-          id: String(itemAttrs.variant_id ?? item.id ?? ""),
-          title: itemAttrs.name ?? "",
-          selectedOptions: [],
-          product: {
-            id: String(itemAttrs.product_id ?? ""),
-            handle: itemAttrs.slug ?? "",
-            title: itemAttrs.name ?? "",
-            featuredImage: { url: itemAttrs.image_url ?? "", altText: itemAttrs.name ?? "" }
-          }
-        }
-      };
-    }
-  );
-  return {
-    id: String(data.id ?? attrs.token ?? ""),
-    checkoutUrl: "",
-    totalQuantity: items.reduce((sum, i) => sum + i.quantity, 0),
-    cost: {
-      subtotalAmount: toMoney(attrs.item_total ?? attrs.display_item_total ?? "0", currencyCode),
-      totalAmount: toMoney(attrs.total ?? attrs.display_total ?? "0", currencyCode),
-      totalTaxAmount: toMoney(attrs.tax_total ?? attrs.display_tax_total ?? "0", currencyCode)
-    },
-    lines: items
-  };
-}
-function transformAddress2(addr) {
-  return {
-    id: String(addr.id ?? ""),
-    firstName: addr.first_name ?? addr.firstname ?? "",
-    lastName: addr.last_name ?? addr.lastname ?? "",
-    company: addr.company ?? "",
-    address1: addr.address1 ?? "",
-    address2: addr.address2 ?? "",
-    city: addr.city ?? "",
-    province: addr.state_name ?? addr.state ?? "",
-    postalCode: addr.zipcode ?? addr.zip ?? "",
-    countryCode: addr.country_iso ?? addr.country_code ?? "",
-    phone: addr.phone ?? ""
-  };
-}
-function transformOrder5(data, currencyCode = "USD") {
-  const attrs = data.attributes ?? data;
-  const items = (attrs.line_items ?? []).map((item) => ({
-    id: String(item.id ?? ""),
-    title: item.name ?? "",
-    quantity: item.quantity ?? 1,
-    price: toMoney(item.price ?? "0", currencyCode),
-    total: toMoney(item.total ?? "0", currencyCode),
-    productId: String(item.product_id ?? ""),
-    variantId: String(item.variant_id ?? "")
-  }));
-  return {
-    id: String(data.id ?? attrs.number ?? ""),
-    orderNumber: attrs.number ?? String(data.id ?? ""),
-    email: attrs.email ?? "",
-    status: attrs.state === "complete" ? "completed" : attrs.state === "canceled" ? "cancelled" : "pending",
-    paymentStatus: attrs.payment_state === "paid" ? "paid" : attrs.payment_state === "balance_due" ? "pending" : "pending",
-    fulfillmentStatus: attrs.shipment_state === "shipped" ? "fulfilled" : attrs.shipment_state === "partial" ? "partially_fulfilled" : "unfulfilled",
-    items,
-    total: toMoney(attrs.total ?? "0", currencyCode),
-    subtotal: toMoney(attrs.item_total ?? "0", currencyCode),
-    tax: toMoney(attrs.tax_total ?? "0", currencyCode),
-    shipping: toMoney(attrs.ship_total ?? "0", currencyCode),
-    shippingAddress: attrs.ship_address ? transformAddress2(attrs.ship_address) : void 0,
-    billingAddress: attrs.bill_address ? transformAddress2(attrs.bill_address) : void 0,
-    createdAt: attrs.created_at ?? (/* @__PURE__ */ new Date()).toISOString(),
-    updatedAt: attrs.updated_at ?? (/* @__PURE__ */ new Date()).toISOString()
-  };
-}
-
-// src/providers/spree/index.ts
-var SpreeProvider = class {
-  name = "spree";
-  version = "1.0.0";
-  capabilities = SPREE_CAPABILITIES;
-  logger;
-  baseUrl;
-  apiBase;
-  currencyCode;
-  bearerToken;
-  orderToken;
-  // guest cart token
-  constructor(config) {
-    this.logger = createLogger("SpreeProvider", config.debug);
-    this.baseUrl = config.baseUrl.replace(/\/$/, "");
-    this.apiBase = `${this.baseUrl}/api/v2/storefront`;
-    this.currencyCode = config.currencyCode ?? "USD";
-    this.bearerToken = config.bearerToken;
-    this.logger.info("Initializing Spree Provider", { baseUrl: this.baseUrl });
-  }
-  async apiFetch(path, init) {
-    const headers = {
-      "Content-Type": "application/vnd.api+json",
-      "Accept": "application/vnd.api+json",
-      ...init?.headers ?? {}
-    };
-    if (this.bearerToken) {
-      headers["Authorization"] = `Bearer ${this.bearerToken}`;
-    }
-    if (this.orderToken) {
-      headers["X-Spree-Order-Token"] = this.orderToken;
-    }
-    const response = await fetch(`${this.apiBase}${path}`, {
-      ...init,
-      headers
-    });
-    if (!response.ok) {
-      throw new ProviderAPIError(
-        `Spree API error: ${response.status}`,
-        "SPREE_API_ERROR",
-        response.status
-      );
-    }
-    return response.json();
-  }
-  // ============================================
-  // Product Operations
-  // ============================================
-  async getProduct(handle) {
-    try {
-      const { data, included } = await this.apiFetch(
-        `/products/${encodeURIComponent(handle)}?include=images,variants,option_types`
-      );
-      return transformProduct5(data, included ?? [], this.currencyCode);
-    } catch {
-      return void 0;
-    }
-  }
-  async getProducts(options) {
-    let path = `/products?include=images,variants&per_page=${options?.first ?? 20}`;
-    if (options?.query) path += `&filter[name]=${encodeURIComponent(options.query)}`;
-    if (options?.sortKey) {
-      const sortMap = {
-        "price-asc": "price",
-        "price-desc": "-price",
-        "title-asc": "name",
-        "title-desc": "-name",
-        "created-desc": "-created_at"
-      };
-      if (sortMap[options.sortKey]) path += `&sort=${sortMap[options.sortKey]}`;
-    }
-    const { data, included } = await this.apiFetch(path);
-    return (Array.isArray(data) ? data : []).map((p) => transformProduct5(p, included ?? [], this.currencyCode));
-  }
-  async getProductRecommendations(_productId) {
-    return [];
-  }
-  // ============================================
-  // Collection/Taxon Operations
-  // ============================================
-  async getCollection(handle) {
-    try {
-      const { data } = await this.apiFetch(`/taxons/${encodeURIComponent(handle)}`);
-      return transformCollection5(data);
-    } catch {
-      return void 0;
-    }
-  }
-  async getCollections(options) {
-    const { data } = await this.apiFetch(`/taxons?per_page=${options?.limit ?? 50}`);
-    return (Array.isArray(data) ? data : []).map(transformCollection5);
-  }
-  async getCollectionProducts(handle, options) {
-    const { data, included } = await this.apiFetch(
-      `/products?include=images,variants&filter[taxons]=${encodeURIComponent(handle)}&per_page=${options?.first ?? 20}`
-    );
-    return (Array.isArray(data) ? data : []).map((p) => transformProduct5(p, included ?? [], this.currencyCode));
-  }
-  async getCategory(handle) {
-    return this.getCollection(handle);
-  }
-  async getCategories(options) {
-    return this.getCollections(options);
-  }
-  async getCategoryProducts(handle, options) {
-    return this.getCollectionProducts(handle, options);
-  }
-  // ============================================
-  // Cart Operations
-  // ============================================
-  async createCart() {
-    const { data } = await this.apiFetch("/cart", {
-      method: "POST",
-      body: JSON.stringify({})
-    });
-    if (data.attributes?.token) {
-      this.orderToken = data.attributes.token;
-    }
-    return transformCart5(data, this.currencyCode);
-  }
-  async getCart(_cartId) {
-    try {
-      const { data } = await this.apiFetch("/cart?include=line_items");
-      return transformCart5(data, this.currencyCode);
-    } catch {
-      return void 0;
-    }
-  }
-  async addToCart(_cartId, lines) {
-    for (const line of lines) {
-      await this.apiFetch("/cart/add_item", {
-        method: "POST",
-        body: JSON.stringify({ variant_id: line.merchandiseId, quantity: line.quantity })
-      });
-    }
-    const { data } = await this.apiFetch("/cart?include=line_items");
-    return transformCart5(data, this.currencyCode);
-  }
-  async removeFromCart(_cartId, lineIds) {
-    for (const id of lineIds) {
-      await this.apiFetch(`/cart/remove_line_item/${id}`, { method: "DELETE" });
-    }
-    const { data } = await this.apiFetch("/cart?include=line_items");
-    return transformCart5(data, this.currencyCode);
-  }
-  async updateCart(_cartId, lines) {
-    for (const line of lines) {
-      await this.apiFetch(`/cart/set_quantity`, {
-        method: "PATCH",
-        body: JSON.stringify({ line_item_id: line.id, quantity: line.quantity })
-      });
-    }
-    const { data } = await this.apiFetch("/cart?include=line_items");
-    return transformCart5(data, this.currencyCode);
-  }
-  // ============================================
-  // Checkout Operations
-  // ============================================
-  async completeCheckout(_cartId) {
-    const { data } = await this.apiFetch("/checkout/complete", { method: "PATCH" });
-    return transformOrder5(data, this.currencyCode);
-  }
-  async getShippingMethods(_cartId) {
-    try {
-      const { data } = await this.apiFetch("/checkout/shipping_rates");
-      return (Array.isArray(data) ? data : []).map((rate) => ({
-        id: String(rate.id),
-        name: rate.attributes?.name ?? rate.name ?? "",
-        price: { amount: String(parseFloat(rate.attributes?.final_price ?? rate.attributes?.cost ?? "0").toFixed(2)), currencyCode: this.currencyCode }
-      }));
-    } catch {
-      return [];
-    }
-  }
-  async getRegionCountries() {
-    return [];
-  }
-  async addShippingMethod(_cartId, methodId) {
-    await this.apiFetch("/checkout", {
-      method: "PATCH",
-      body: JSON.stringify({ order: { shipments_attributes: [{ selected_shipping_rate_id: methodId }] } })
-    });
-    const { data } = await this.apiFetch("/cart?include=line_items");
-    return transformCart5(data, this.currencyCode);
-  }
-  async initiatePaymentSession(_cartId, _providerId) {
-  }
-  async applyDiscountCode(_cartId, code) {
-    await this.apiFetch("/cart/apply_coupon_code", {
-      method: "PATCH",
-      body: JSON.stringify({ coupon_code: code })
-    });
-    const { data } = await this.apiFetch("/cart?include=line_items");
-    return transformCart5(data, this.currencyCode);
-  }
-  async removeDiscountCode(_cartId, code) {
-    await this.apiFetch(`/cart/remove_coupon_code/${encodeURIComponent(code)}`, { method: "DELETE" });
-    const { data } = await this.apiFetch("/cart?include=line_items");
-    return transformCart5(data, this.currencyCode);
-  }
-  // ============================================
-  // Customer, Order, Payment, Inventory, Admin
-  // ============================================
-  async getOrders(_options) {
-    try {
-      const { data } = await this.apiFetch("/account/orders");
-      return (Array.isArray(data) ? data : []).map((o) => transformOrder5(o, this.currencyCode));
-    } catch {
-      return [];
-    }
-  }
-  async getPaymentMethods(_options) {
-    try {
-      const { data } = await this.apiFetch("/checkout/payment_methods");
-      return (Array.isArray(data) ? data : []).map((pm) => ({
-        id: String(pm.id),
-        name: pm.attributes?.name ?? "",
-        type: "other",
-        isEnabled: true,
-        requiresSetup: false
-      }));
-    } catch {
-      return [];
-    }
-  }
-  async getStockLocations() {
-    return [];
-  }
-  async checkInventoryLevels() {
-    return [];
-  }
-  async validateCartStock() {
-    return { allAvailable: true, unavailableItems: [] };
-  }
-  async getFulfillmentOptions() {
-    return [];
-  }
-  async cancelOrder(_orderId) {
-    throw new ProviderAPIError("Order cancellation requires Spree Admin API.", "SPREE_ADMIN_REQUIRED");
-  }
-  async createFulfillment(_orderId) {
-    throw new ProviderAPIError("Fulfillment requires Spree Admin API.", "SPREE_ADMIN_REQUIRED");
-  }
-  async createRefund(_orderId) {
-    throw new ProviderAPIError("Refunds require Spree Admin API.", "SPREE_ADMIN_REQUIRED");
-  }
-  async getAdminOrders() {
-    return { orders: [], count: 0 };
-  }
-  async getStorefrontContext() {
-    return {
-      id: this.baseUrl,
-      name: `Spree ${this.baseUrl}`,
-      platformType: "spree",
-      requiresProductScoping: true,
-      currencyCode: this.currencyCode
-    };
-  }
-  isStorefrontRequired() {
-    return true;
-  }
-};
-
-// src/providers/magento/transforms.ts
-function toMoney2(value, currencyCode) {
-  return { amount: (value ?? 0).toFixed(2), currencyCode };
-}
-function extractPrice(priceRange, currencyCode) {
-  const minPrice = priceRange?.minimum_price?.regular_price?.value ?? priceRange?.minimum_price?.final_price?.value ?? 0;
-  const maxPrice = priceRange?.maximum_price?.regular_price?.value ?? priceRange?.maximum_price?.final_price?.value ?? minPrice;
-  const currency = priceRange?.minimum_price?.regular_price?.currency ?? currencyCode;
-  return {
-    min: toMoney2(minPrice, currency),
-    max: toMoney2(maxPrice, currency)
-  };
-}
-function transformProduct6(data, currencyCode = "USD") {
-  const id = String(data.id ?? data.uid ?? "");
-  const { min, max } = extractPrice(data.price_range, currencyCode);
-  const images = (data.media_gallery ?? data.media_gallery_entries ?? []).map((img) => ({
-    url: img.url ?? (img.file ? `${img.file}` : ""),
-    altText: img.label ?? data.name ?? "",
-    width: void 0,
-    height: void 0
-  }));
-  if (images.length === 0 && data.small_image?.url) {
-    images.push({ url: data.small_image.url, altText: data.small_image.label ?? data.name ?? "" });
-  }
-  if (images.length === 0 && data.image?.url) {
-    images.push({ url: data.image.url, altText: data.image.label ?? data.name ?? "" });
-  }
-  const variants = [];
-  if (data.variants && Array.isArray(data.variants)) {
-    for (const v of data.variants) {
-      const product = v.product ?? {};
-      const vPrice = product.price_range?.minimum_price?.final_price ?? {};
-      variants.push({
-        id: String(product.id ?? product.uid ?? product.sku ?? ""),
-        title: product.name ?? product.sku ?? "",
-        availableForSale: product.stock_status === "IN_STOCK",
-        price: toMoney2(vPrice.value ?? min.amount, vPrice.currency ?? currencyCode),
-        compareAtPrice: void 0,
-        selectedOptions: (v.attributes ?? []).map((attr) => ({
-          name: attr.label ?? "",
-          value: attr.value_index != null ? String(attr.value_index) : ""
-        }))
-      });
-    }
-  }
-  if (variants.length === 0) {
-    variants.push({
-      id: data.sku ?? id,
-      title: data.name ?? "",
-      availableForSale: data.stock_status === "IN_STOCK",
-      price: min,
-      compareAtPrice: void 0,
-      selectedOptions: []
-    });
-  }
-  const options = (data.configurable_options ?? []).map((opt) => ({
-    id: String(opt.attribute_id ?? opt.attribute_code ?? ""),
-    name: opt.label ?? opt.attribute_code ?? "",
-    values: (opt.values ?? []).map((v) => v.label ?? v.store_label ?? String(v.value_index ?? ""))
-  }));
-  return {
-    id,
-    handle: data.url_key ?? data.sku ?? id,
-    title: data.name ?? "",
-    description: data.short_description?.html ?? data.description?.html ?? "",
-    descriptionHtml: data.description?.html ?? "",
-    availableForSale: data.stock_status === "IN_STOCK",
-    priceRange: { minVariantPrice: min, maxVariantPrice: max },
-    variants,
-    options,
-    images,
-    featuredImage: images[0] ?? { url: "", altText: data.name ?? "" },
-    tags: [],
-    seo: {
-      title: data.meta_title ?? data.name ?? "",
-      description: data.meta_description ?? ""
-    },
-    updatedAt: data.updated_at ?? (/* @__PURE__ */ new Date()).toISOString(),
-    createdAt: data.created_at ?? (/* @__PURE__ */ new Date()).toISOString()
-  };
-}
-function transformCollection6(data) {
-  return {
-    id: String(data.id ?? data.uid ?? ""),
-    handle: data.url_key ?? data.url_path ?? String(data.id ?? data.uid ?? ""),
-    title: data.name ?? "",
-    description: data.description ?? "",
-    seo: {
-      title: data.meta_title ?? data.name ?? "",
-      description: data.meta_description ?? ""
-    },
-    updatedAt: data.updated_at ?? (/* @__PURE__ */ new Date()).toISOString(),
-    path: `/collections/${data.url_key ?? data.url_path ?? data.id}`
-  };
-}
-function transformCart6(data, currencyCode = "USD") {
-  const items = (data.items ?? []).map((item) => {
-    const product = item.product ?? {};
-    const priceVal = item.prices?.price?.value ?? product.price_range?.minimum_price?.final_price?.value ?? 0;
-    const totalVal2 = item.prices?.row_total?.value ?? priceVal * (item.quantity ?? 1);
-    return {
-      id: String(item.id ?? item.uid ?? ""),
-      quantity: item.quantity ?? 1,
-      cost: {
-        totalAmount: toMoney2(totalVal2, item.prices?.price?.currency ?? currencyCode)
-      },
-      merchandise: {
-        id: String(product.sku ?? item.id ?? ""),
-        title: product.name ?? item.product?.name ?? "",
-        selectedOptions: (item.configurable_options ?? []).map((opt) => ({
-          name: opt.option_label ?? "",
-          value: opt.value_label ?? ""
-        })),
-        product: {
-          id: String(product.id ?? product.uid ?? ""),
-          handle: product.url_key ?? "",
-          title: product.name ?? "",
-          featuredImage: {
-            url: product.small_image?.url ?? product.thumbnail?.url ?? "",
-            altText: product.name ?? ""
-          }
-        }
-      }
-    };
-  });
-  const totalVal = data.prices?.grand_total?.value ?? 0;
-  const subtotalVal = data.prices?.subtotal_excluding_tax?.value ?? data.prices?.subtotal_including_tax?.value ?? totalVal;
-  const taxVal = (data.prices?.applied_taxes ?? []).reduce((sum, t) => sum + (t.amount?.value ?? 0), 0);
-  return {
-    id: String(data.id ?? ""),
-    checkoutUrl: "",
-    totalQuantity: items.reduce((sum, i) => sum + i.quantity, 0),
-    cost: {
-      subtotalAmount: toMoney2(subtotalVal, data.prices?.grand_total?.currency ?? currencyCode),
-      totalAmount: toMoney2(totalVal, data.prices?.grand_total?.currency ?? currencyCode),
-      totalTaxAmount: toMoney2(taxVal, currencyCode)
-    },
-    lines: items
-  };
-}
-function transformAddress3(addr) {
-  return {
-    id: String(addr.id ?? ""),
-    firstName: addr.firstname ?? "",
-    lastName: addr.lastname ?? "",
-    company: addr.company ?? "",
-    address1: Array.isArray(addr.street) ? addr.street[0] ?? "" : addr.street ?? "",
-    address2: Array.isArray(addr.street) ? addr.street[1] ?? "" : "",
-    city: addr.city ?? "",
-    province: addr.region?.region ?? "",
-    postalCode: addr.postcode ?? "",
-    countryCode: addr.country_code ?? addr.country_id ?? "",
-    phone: addr.telephone ?? ""
-  };
-}
-function transformOrder6(data, currencyCode = "USD") {
-  const items = (data.items ?? []).map((item) => ({
-    id: String(item.id ?? ""),
-    title: item.product_name ?? "",
-    quantity: item.quantity_ordered ?? item.quantity ?? 1,
-    price: toMoney2(item.product_sale_price?.value ?? item.price ?? 0, currencyCode),
-    total: toMoney2((item.product_sale_price?.value ?? item.price ?? 0) * (item.quantity_ordered ?? item.quantity ?? 1), currencyCode),
-    sku: item.product_sku ?? item.sku,
-    productId: String(item.product_id ?? "")
-  }));
-  return {
-    id: String(data.id ?? data.order_number ?? ""),
-    orderNumber: data.order_number ?? data.number ?? String(data.id ?? ""),
-    email: data.email ?? "",
-    status: data.status === "complete" ? "completed" : data.status === "canceled" ? "cancelled" : data.status === "closed" ? "refunded" : "pending",
-    paymentStatus: data.payment_status === "paid" ? "paid" : "pending",
-    fulfillmentStatus: data.shipment_status === "shipped" ? "fulfilled" : "unfulfilled",
-    items,
-    total: toMoney2(data.total?.grand_total?.value ?? data.grand_total ?? 0, currencyCode),
-    subtotal: toMoney2(data.total?.subtotal?.value ?? data.subtotal ?? 0, currencyCode),
-    tax: toMoney2(data.total?.total_tax?.value ?? data.tax_amount ?? 0, currencyCode),
-    shipping: toMoney2(data.total?.total_shipping?.value ?? data.shipping_amount ?? 0, currencyCode),
-    shippingAddress: data.shipping_address ? transformAddress3(data.shipping_address) : void 0,
-    billingAddress: data.billing_address ? transformAddress3(data.billing_address) : void 0,
-    createdAt: data.order_date ?? data.created_at ?? (/* @__PURE__ */ new Date()).toISOString(),
-    updatedAt: data.updated_at ?? data.order_date ?? (/* @__PURE__ */ new Date()).toISOString()
-  };
-}
-
-// src/providers/magento/queries.ts
-var PRODUCT_FIELDS = `
-  id
-  uid
-  sku
-  name
-  url_key
-  stock_status
-  short_description { html }
-  description { html }
-  meta_title
-  meta_description
-  created_at
-  updated_at
-  price_range {
-    minimum_price {
-      regular_price { value currency }
-      final_price { value currency }
-    }
-    maximum_price {
-      regular_price { value currency }
-      final_price { value currency }
-    }
-  }
-  small_image { url label }
-  image { url label }
-  media_gallery {
-    url
-    label
-  }
-  ... on ConfigurableProduct {
-    configurable_options {
-      attribute_code
-      attribute_id
-      label
-      values {
-        label
-        value_index
-      }
-    }
-    variants {
-      product {
-        id uid sku name
-        stock_status
-        price_range {
-          minimum_price {
-            final_price { value currency }
-          }
-        }
-        small_image { url label }
-      }
-      attributes {
-        label
-        value_index
-      }
-    }
-  }
-`;
-var GET_PRODUCTS2 = `
-  query GetProducts($search: String, $pageSize: Int, $currentPage: Int, $sort: ProductAttributeSortInput) {
-    products(search: $search, pageSize: $pageSize, currentPage: $currentPage, sort: $sort) {
-      items { ${PRODUCT_FIELDS} }
-      total_count
-    }
-  }
-`;
-var GET_PRODUCT_BY_URL_KEY = `
-  query GetProductByUrlKey($urlKey: String!) {
-    products(filter: { url_key: { eq: $urlKey } }, pageSize: 1) {
-      items { ${PRODUCT_FIELDS} }
-    }
-  }
-`;
-var GET_CATEGORIES = `
-  query GetCategories($pageSize: Int) {
-    categories(pageSize: $pageSize) {
-      items {
-        id uid name url_key url_path description meta_title meta_description
-      }
-    }
-  }
-`;
-var GET_CATEGORY_BY_URL_KEY = `
-  query GetCategoryByUrlKey($urlKey: String!) {
-    categories(filters: { url_key: { eq: $urlKey } }, pageSize: 1) {
-      items {
-        id uid name url_key url_path description meta_title meta_description
-      }
-    }
-  }
-`;
-var GET_CATEGORY_PRODUCTS = `
-  query GetCategoryProducts($urlKey: String!, $pageSize: Int) {
-    products(filter: { category_url_key: { eq: $urlKey } }, pageSize: $pageSize) {
-      items { ${PRODUCT_FIELDS} }
-      total_count
-    }
-  }
-`;
-var GET_CART2 = `
-  query GetCart($cartId: String!) {
-    cart(cart_id: $cartId) {
-      id
-      items {
-        id uid quantity
-        product {
-          id uid sku name url_key
-          small_image { url }
-          thumbnail { url }
-          price_range {
-            minimum_price {
-              final_price { value currency }
-            }
-          }
-        }
-        prices {
-          price { value currency }
-          row_total { value currency }
-        }
-        ... on ConfigurableCartItem {
-          configurable_options {
-            option_label
-            value_label
-          }
-        }
-      }
-      prices {
-        grand_total { value currency }
-        subtotal_excluding_tax { value currency }
-        subtotal_including_tax { value currency }
-        applied_taxes {
-          amount { value currency }
-          label
-        }
-      }
-    }
-  }
-`;
-var CREATE_EMPTY_CART = `
-  mutation CreateEmptyCart {
-    createEmptyCart
-  }
-`;
-var ADD_TO_CART = `
-  mutation AddToCart($cartId: String!, $cartItems: [CartItemInput!]!) {
-    addProductsToCart(cartId: $cartId, cartItems: $cartItems) {
-      cart {
-        id
-        items { id uid quantity product { sku name } prices { price { value currency } row_total { value currency } } }
-        prices { grand_total { value currency } subtotal_excluding_tax { value currency } }
-      }
-      user_errors { code message }
-    }
-  }
-`;
-var REMOVE_FROM_CART = `
-  mutation RemoveFromCart($cartId: String!, $cartItemUid: ID!) {
-    removeItemFromCart(input: { cart_id: $cartId, cart_item_uid: $cartItemUid }) {
-      cart {
-        id
-        items { id uid quantity product { sku name } prices { price { value currency } row_total { value currency } } }
-        prices { grand_total { value currency } subtotal_excluding_tax { value currency } }
-      }
-    }
-  }
-`;
-var UPDATE_CART_ITEMS = `
-  mutation UpdateCartItems($cartId: String!, $cartItems: [CartItemUpdateInput!]!) {
-    updateCartItems(input: { cart_id: $cartId, cart_items: $cartItems }) {
-      cart {
-        id
-        items { id uid quantity product { sku name } prices { price { value currency } row_total { value currency } } }
-        prices { grand_total { value currency } subtotal_excluding_tax { value currency } }
-      }
-    }
-  }
-`;
-var APPLY_COUPON = `
-  mutation ApplyCoupon($cartId: String!, $couponCode: String!) {
-    applyCouponToCart(input: { cart_id: $cartId, coupon_code: $couponCode }) {
-      cart {
-        id
-        prices { grand_total { value currency } subtotal_excluding_tax { value currency } }
-      }
-    }
-  }
-`;
-var REMOVE_COUPON = `
-  mutation RemoveCoupon($cartId: String!) {
-    removeCouponFromCart(input: { cart_id: $cartId }) {
-      cart {
-        id
-        prices { grand_total { value currency } subtotal_excluding_tax { value currency } }
-      }
-    }
-  }
-`;
-var GET_CUSTOMER_ORDERS = `
-  query GetCustomerOrders($pageSize: Int, $currentPage: Int) {
-    customer {
-      orders(pageSize: $pageSize, currentPage: $currentPage) {
-        items {
-          id order_number order_date status
-          total {
-            grand_total { value currency }
-            subtotal { value currency }
-            total_tax { value currency }
-            total_shipping { value currency }
-          }
-          items {
-            id product_name product_sku
-            quantity_ordered
-            product_sale_price { value currency }
-          }
-          shipping_address {
-            firstname lastname street city
-            region postcode country_code telephone
-          }
-          billing_address {
-            firstname lastname street city
-            region postcode country_code telephone
-          }
-        }
-        total_count
-      }
-    }
-  }
-`;
-
-// src/providers/magento/index.ts
-var MagentoProvider = class {
-  name = "magento";
-  version = "1.0.0";
-  capabilities = MAGENTO_CAPABILITIES;
-  logger;
-  baseUrl;
-  storeCode;
-  currencyCode;
-  graphqlEndpoint;
-  customerToken;
-  accessToken;
-  constructor(config) {
-    this.logger = createLogger("MagentoProvider", config.debug);
-    this.baseUrl = config.baseUrl.replace(/\/$/, "");
-    this.storeCode = config.storeCode ?? "default";
-    this.currencyCode = config.currencyCode ?? "USD";
-    this.graphqlEndpoint = `${this.baseUrl}/graphql`;
-    this.customerToken = config.customerToken;
-    this.accessToken = config.accessToken;
-    this.logger.info("Initializing Magento Provider", {
-      baseUrl: this.baseUrl,
-      storeCode: this.storeCode
-    });
-  }
-  async graphql(query, variables) {
-    const headers = {
-      "Content-Type": "application/json",
-      "Store": this.storeCode
-    };
-    if (this.customerToken) {
-      headers["Authorization"] = `Bearer ${this.customerToken}`;
-    }
-    const response = await fetch(this.graphqlEndpoint, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({ query, variables })
-    });
-    if (!response.ok) {
-      throw new ProviderAPIError(
-        `Magento GraphQL error: ${response.status}`,
-        "MAGENTO_API_ERROR",
-        response.status
-      );
-    }
-    const json = await response.json();
-    if (json.errors?.length) {
-      const message = json.errors.map((e) => e.message).join("; ");
-      throw new ProviderAPIError(`Magento GraphQL error: ${message}`, "MAGENTO_GRAPHQL_ERROR");
-    }
-    return json.data;
-  }
-  // ============================================
-  // Product Operations (GraphQL)
-  // ============================================
-  async getProduct(handle) {
-    try {
-      const data = await this.graphql(GET_PRODUCT_BY_URL_KEY, { urlKey: handle });
-      return data.products.items[0] ? transformProduct6(data.products.items[0], this.currencyCode) : void 0;
-    } catch {
-      return void 0;
-    }
-  }
-  async getProducts(options) {
-    const variables = {
-      pageSize: options?.first ?? 20,
-      currentPage: 1
-    };
-    if (options?.query) variables.search = options.query;
-    if (options?.sortKey) {
-      const sortMap = {
-        "price-asc": { price: "ASC" },
-        "price-desc": { price: "DESC" },
-        "title-asc": { name: "ASC" },
-        "title-desc": { name: "DESC" },
-        "created-desc": { created_at: "DESC" },
-        "relevance": { relevance: "DESC" }
-      };
-      variables.sort = sortMap[options.sortKey] ?? { relevance: "DESC" };
-    }
-    const data = await this.graphql(GET_PRODUCTS2, variables);
-    return (data.products?.items ?? []).map((p) => transformProduct6(p, this.currencyCode));
-  }
-  async getProductRecommendations(_productId) {
-    return [];
-  }
-  // ============================================
-  // Collection/Category Operations (GraphQL)
-  // ============================================
-  async getCollection(handle) {
-    try {
-      const data = await this.graphql(GET_CATEGORY_BY_URL_KEY, { urlKey: handle });
-      return data.categories.items[0] ? transformCollection6(data.categories.items[0]) : void 0;
-    } catch {
-      return void 0;
+      throw new ProviderAPIError(
+        `Failed to initialize storefront context: ${errorMessage}`,
+        "medusa",
+        error?.status ?? 500
+      );
     }
   }
-  async getCollections(options) {
-    const data = await this.graphql(GET_CATEGORIES, {
-      pageSize: options?.limit ?? 50
-    });
-    return (data.categories?.items ?? []).map(transformCollection6);
-  }
-  async getCollectionProducts(handle, options) {
-    const data = await this.graphql(GET_CATEGORY_PRODUCTS, {
-      urlKey: handle,
-      pageSize: options?.first ?? 20
-    });
-    return (data.products?.items ?? []).map((p) => transformProduct6(p, this.currencyCode));
-  }
-  async getCategory(handle) {
-    return this.getCollection(handle);
-  }
-  async getCategories(options) {
-    return this.getCollections(options);
-  }
-  async getCategoryProducts(handle, options) {
-    return this.getCollectionProducts(handle, options);
+  /**
+   * Medusa always requires storefront configuration for multi-tenant support.
+   */
+  isStorefrontRequired() {
+    return true;
   }
   // ============================================
-  // Cart Operations (GraphQL)
+  // Thor Plugin — Storefront Configuration
   // ============================================
-  async createCart() {
-    const data = await this.graphql(CREATE_EMPTY_CART);
-    const cartId = data.createEmptyCart;
-    const cartData = await this.graphql(GET_CART2, { cartId });
-    return transformCart6(cartData.cart ?? { id: cartId, items: [], prices: {} }, this.currencyCode);
-  }
-  async getCart(cartId) {
-    try {
-      const data = await this.graphql(GET_CART2, { cartId });
-      return data.cart ? transformCart6(data.cart, this.currencyCode) : void 0;
-    } catch {
-      return void 0;
+  /** In-memory cache for storefront config (60s TTL) */
+  _storefrontConfigCache = null;
+  /** In-memory cache for designer config (60s TTL) */
+  _designerConfigCache = null;
+  /** Cache TTL for Thor plugin configs (60 seconds) */
+  THOR_CONFIG_CACHE_TTL = 60 * 1e3;
+  /**
+   * Get per-channel storefront configuration from Thor Commerce plugin.
+   * Calls `GET /store/thor/config`.
+   *
+   * @returns StorefrontConfig or null if plugin is not installed / config not set
+   */
+  async getStorefrontConfig() {
+    if (this._storefrontConfigCache && Date.now() < this._storefrontConfigCache.expiresAt) {
+      return this._storefrontConfigCache.config;
     }
-  }
-  async addToCart(cartId, lines) {
-    const cartItems = lines.map((l) => ({
-      sku: l.merchandiseId,
-      quantity: l.quantity
-    }));
-    const data = await this.graphql(ADD_TO_CART, {
-      cartId,
-      cartItems
-    });
-    if (data.addProductsToCart.user_errors?.length) {
-      throw new ProviderAPIError(
-        `Add to cart failed: ${data.addProductsToCart.user_errors.map((e) => e.message).join("; ")}`,
-        "MAGENTO_CART_ERROR"
+    try {
+      const url = `${this.baseUrl}/store/thor/config`;
+      const response = await fetchWithRetry(
+        url,
+        {
+          method: "GET",
+          headers: {
+            "x-publishable-api-key": this.publishableKey,
+            "Content-Type": "application/json"
+          }
+        },
+        this.retryConfig
       );
-    }
-    return transformCart6(data.addProductsToCart.cart, this.currencyCode);
-  }
-  async removeFromCart(cartId, lineIds) {
-    let cart;
-    for (const itemUid of lineIds) {
-      const data = await this.graphql(REMOVE_FROM_CART, {
-        cartId,
-        cartItemUid: itemUid
+      if (response.status === 404) {
+        this._storefrontConfigCache = { config: null, expiresAt: Date.now() + this.THOR_CONFIG_CACHE_TTL };
+        return null;
+      }
+      if (!response.ok) {
+        this.logger.warn("[StorefrontConfig] Non-OK response", { status: response.status });
+        return null;
+      }
+      const data = await response.json();
+      const config = transformStorefrontConfig(data.storefront_config ?? data);
+      this._storefrontConfigCache = { config, expiresAt: Date.now() + this.THOR_CONFIG_CACHE_TTL };
+      this.logger.debug("[StorefrontConfig] Loaded from backend", { id: config.id });
+      return config;
+    } catch (error) {
+      this.logger.warn("[StorefrontConfig] Failed to fetch", {
+        error: error instanceof Error ? error.message : String(error)
       });
-      cart = data.removeItemFromCart.cart;
+      return null;
     }
-    return transformCart6(cart ?? { id: cartId, items: [], prices: {} }, this.currencyCode);
-  }
-  async updateCart(cartId, lines) {
-    const cartItems = lines.map((l) => ({
-      cart_item_uid: l.id,
-      quantity: l.quantity
-    }));
-    const data = await this.graphql(UPDATE_CART_ITEMS, {
-      cartId,
-      cartItems
-    });
-    return transformCart6(data.updateCartItems.cart, this.currencyCode);
-  }
-  // ============================================
-  // Checkout Operations
-  // ============================================
-  async completeCheckout(_cartId) {
-    throw new ProviderAPIError(
-      "Magento checkout requires multi-step process (set addresses, shipping, payment, place order). Use the Magento checkout flow.",
-      "MAGENTO_CHECKOUT_MULTI_STEP"
-    );
-  }
-  async getShippingMethods(_cartId) {
-    return [];
-  }
-  async getRegionCountries() {
-    return [];
   }
-  async addShippingMethod(_cartId, _methodId) {
-    throw new ProviderAPIError(
-      "Magento shipping selection requires set-shipping-methods mutation.",
-      "MAGENTO_CHECKOUT_MULTI_STEP"
-    );
-  }
-  async initiatePaymentSession(_cartId, _providerId) {
-  }
-  async applyDiscountCode(cartId, code) {
-    const data = await this.graphql(APPLY_COUPON, {
-      cartId,
-      couponCode: code
-    });
-    return transformCart6(data.applyCouponToCart.cart, this.currencyCode);
-  }
-  async removeDiscountCode(cartId, _code) {
-    const data = await this.graphql(REMOVE_COUPON, {
-      cartId
-    });
-    return transformCart6(data.removeCouponFromCart.cart, this.currencyCode);
-  }
-  // ============================================
-  // Customer & Orders (GraphQL — requires customerToken)
-  // ============================================
-  async getOrders(_options) {
-    if (!this.customerToken) return [];
+  /**
+   * Get active Site Designer configuration from Thor Commerce plugin.
+   * Calls `GET /store/thor/site-config`.
+   *
+   * @returns Versioned DesignerConfig or null if plugin is not installed / config not set
+   */
+  async getDesignerConfig() {
+    if (this._designerConfigCache && Date.now() < this._designerConfigCache.expiresAt) {
+      return this._designerConfigCache.result;
+    }
     try {
-      const data = await this.graphql(GET_CUSTOMER_ORDERS, {
-        pageSize: 20,
-        currentPage: 1
+      const url = `${this.baseUrl}/store/thor/site-config`;
+      const response = await fetchWithRetry(
+        url,
+        {
+          method: "GET",
+          headers: {
+            "x-publishable-api-key": this.publishableKey,
+            "Content-Type": "application/json"
+          }
+        },
+        this.retryConfig
+      );
+      if (response.status === 404) {
+        this._designerConfigCache = { result: null, expiresAt: Date.now() + this.THOR_CONFIG_CACHE_TTL };
+        return null;
+      }
+      if (!response.ok) {
+        this.logger.warn("[DesignerConfig] Non-OK response", { status: response.status });
+        return null;
+      }
+      const data = await response.json();
+      const result = {
+        version: data.version ?? "",
+        config: data.config
+      };
+      this._designerConfigCache = { result, expiresAt: Date.now() + this.THOR_CONFIG_CACHE_TTL };
+      this.logger.debug("[DesignerConfig] Loaded from backend", { version: result.version });
+      return result;
+    } catch (error) {
+      this.logger.warn("[DesignerConfig] Failed to fetch", {
+        error: error instanceof Error ? error.message : String(error)
       });
-      return (data.customer?.orders?.items ?? []).map((o) => transformOrder6(o, this.currencyCode));
-    } catch {
-      return [];
+      return null;
     }
   }
-  async getPaymentMethods(_options) {
-    return [];
-  }
-  // ============================================
-  // Inventory
-  // ============================================
-  async getStockLocations() {
-    return [];
-  }
-  async checkInventoryLevels() {
-    return [];
-  }
-  async validateCartStock() {
-    return { allAvailable: true, unavailableItems: [] };
-  }
-  async getFulfillmentOptions() {
-    return [];
-  }
   // ============================================
-  // Admin Operations
+  // Thor Plugin — Admin Site Designer
   // ============================================
-  async cancelOrder(_orderId) {
-    throw new ProviderAPIError("Order cancellation requires Magento Admin API.", "MAGENTO_ADMIN_REQUIRED");
-  }
-  async createFulfillment(_orderId) {
-    throw new ProviderAPIError("Fulfillment requires Magento Admin API.", "MAGENTO_ADMIN_REQUIRED");
-  }
-  async createRefund(_orderId) {
-    throw new ProviderAPIError("Refunds require Magento Admin API.", "MAGENTO_ADMIN_REQUIRED");
-  }
-  async getAdminOrders() {
-    return { orders: [], count: 0 };
+  /**
+   * Get admin Site Designer config + history for a sales channel.
+   * Calls `GET /admin/thor/site-config/:salesChannelId`.
+   */
+  async getAdminDesignerConfig(salesChannelId) {
+    return this.makeAdminRequest(async () => {
+      const path = `/admin/thor/site-config/${encodeURIComponent(salesChannelId)}`;
+      let data;
+      try {
+        data = await this.sdk.client.fetch(path, { method: "GET" });
+      } catch (error) {
+        if (error?.status === 404) return null;
+        throw new ProviderAPIError(
+          `Failed to fetch admin designer config: ${error?.message ?? error?.status}`,
+          "medusa",
+          error?.status
+        );
+      }
+      return {
+        version: data.version ?? "",
+        config: data.config,
+        history: data.history
+      };
+    });
   }
-  // ============================================
-  // Storefront / Multi-Tenant
-  // ============================================
-  async getStorefrontContext() {
-    return {
-      id: this.storeCode,
-      name: `Magento ${this.storeCode}`,
-      platformType: "magento",
-      requiresProductScoping: true,
-      currencyCode: this.currencyCode
-    };
+  /**
+   * Update the Site Designer config for a sales channel.
+   * Calls `PUT /admin/thor/site-config/:salesChannelId`.
+   */
+  async updateAdminDesignerConfig(salesChannelId, config) {
+    return this.makeAdminRequest(async () => {
+      const path = `/admin/thor/site-config/${encodeURIComponent(salesChannelId)}`;
+      let data;
+      try {
+        data = await this.sdk.client.fetch(path, {
+          method: "PUT",
+          body: JSON.stringify({ config }),
+          headers: { "Content-Type": "application/json" }
+        });
+      } catch (error) {
+        throw new ProviderAPIError(
+          `Failed to update admin designer config: ${error?.message ?? error?.status}`,
+          "medusa",
+          error?.status
+        );
+      }
+      return {
+        version: data.version ?? "",
+        config: data.config
+      };
+    });
   }
-  isStorefrontRequired() {
-    return true;
+  /**
+   * Restore a previous Site Designer config version.
+   * Calls `POST /admin/thor/site-config/:salesChannelId/restore/:version`.
+   */
+  async restoreAdminDesignerConfig(salesChannelId, version) {
+    return this.makeAdminRequest(async () => {
+      const path = `/admin/thor/site-config/${encodeURIComponent(salesChannelId)}/restore/${encodeURIComponent(version)}`;
+      let data;
+      try {
+        data = await this.sdk.client.fetch(path, { method: "POST" });
+      } catch (error) {
+        throw new ProviderAPIError(
+          `Failed to restore admin designer config: ${error?.message ?? error?.status}`,
+          "medusa",
+          error?.status
+        );
+      }
+      return {
+        version: data.version ?? "",
+        config: data.config
+      };
+    });
   }
 };
 
@@ -10137,6 +7697,16 @@ var MockProvider = class {
 };
 
 // src/factory/index.ts
+var registry = /* @__PURE__ */ new Map();
+function registerProvider(type, factory) {
+  registry.set(type, factory);
+}
+function getRegisteredProviders() {
+  return Array.from(registry.keys());
+}
+registerProvider("mock", (config) => new MockProvider(config));
+registerProvider("medusa", (config) => new MedusaProvider(config));
+registerProvider("stelorder", (config) => new StelOrderProvider(config));
 function createProvider(options) {
   if (!options || !options.provider) {
     throw new ConfigurationError("Provider type is required");
@@ -10144,27 +7714,14 @@ function createProvider(options) {
   if (!options.config) {
     throw new ConfigurationError("Provider configuration is required");
   }
-  const config = options.config;
-  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.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);
 }
 function isProviderType(provider, type) {
   return provider.name === type;
@@ -10173,8 +7730,6 @@ function isProviderType(provider, type) {
 0 && (module.exports = {
   AdminAuthService,
   AdminSessionService,
-  BIGCOMMERCE_CAPABILITIES,
-  BigCommerceProvider,
   CHANNEL_ASSIGNED_AT_KEY,
   CHANNEL_ASSIGNED_BY_KEY,
   CHANNEL_SCOPE_KEY,
@@ -10183,10 +7738,8 @@ function isProviderType(provider, type) {
   CircuitBreakerOpenError,
   CommerceError,
   ConfigurationError,
-  MAGENTO_CAPABILITIES,
   MEDUSA_CAPABILITIES,
   MOCK_CAPABILITIES,
-  MagentoProvider,
   MedusaMetadataAdapter,
   MedusaProvider,
   MetricsService,
@@ -10194,15 +7747,9 @@ function isProviderType(provider, type) {
   ProviderAPIError,
   ProviderNotFoundError,
   ResourceNotFoundError,
-  SHOPIFY_CAPABILITIES,
-  SPREE_CAPABILITIES,
   STELORDER_CAPABILITIES,
-  ShopifyProvider,
-  SpreeProvider,
   StelOrderProvider,
   StorefrontConfigError,
-  WOOCOMMERCE_CAPABILITIES,
-  WooCommerceProvider,
   assertEntityBelongsToChannel,
   backendCircuitBreaker,
   buildChannelScopeMetadata,
@@ -10210,12 +7757,15 @@ function isProviderType(provider, type) {
   createBackendMetadataAdapter,
   createLogger,
   createProvider,
+  extractErrorMessage,
+  fetchWithRetry,
   filterByChannel,
   filterGlobalOnly,
   geocodeAddress,
   getBackendProviderId,
   getCapabilityDescription,
   getChannelScope,
+  getRegisteredProviders,
   isBackendCapabilities,
   isGlobalEntity,
   isProviderType,
@@ -10225,6 +7775,7 @@ function isProviderType(provider, type) {
   numberToMoney,
   partitionByChannel,
   planFulfillment,
+  registerProvider,
   transformFulfillmentOption,
   transformInventoryLevel,
   transformStockLocation,