@thorprovider/adapters 5.0.0 → 5.0.1

package/dist/index.mjs

@@ -106,6 +106,209 @@ 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;
@@ -320,6 +523,9 @@ async function fetchWithRetry(url, init, retryConfig) {
   }
   throw lastError;
 }
+function createFetchWithRetry(retryConfig) {
+  return (url, init) => fetchWithRetry(url, init, retryConfig);
+}
 
 // src/resilience/circuit-breaker.ts
 var CircuitBreaker = class {
@@ -1325,7 +1531,13 @@ function createBackendMetadataAdapter(config) {
     });
     return new MedusaMetadataAdapter(medusa);
   }
-  throw new Error(`Unsupported provider for metadata adapter: ${provider}. Only 'medusa' is currently supported.`);
+  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}`);
 }
 
 // src/metadata/channel-scope.ts
@@ -1520,17 +1732,11 @@ var MedusaAuthProvider = class {
   logger;
   authConfig;
   storageManager;
-  /** 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 = "") {
+  constructor(sdk, authConfig, debug = false) {
     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
@@ -1542,17 +1748,28 @@ var MedusaAuthProvider = class {
   async login(credentials) {
     this.logger.debug("login", { email: credentials.email });
     try {
-      const token = await this.sdk.auth.login("customer", "emailpass", {
+      const loginResult = await this.sdk.auth.login("customer", "emailpass", {
         email: credentials.email,
         password: credentials.password
       });
-      if (typeof token !== "string") {
-        this.logger.warn("Authentication requires additional actions", token);
-        return {
-          requiresAction: true,
-          redirectUrl: token.location
-        };
+      if (typeof loginResult !== "string") {
+        if ("verification_required" in loginResult && loginResult.verification_required) {
+          this.logger.warn("Authentication requires email verification", loginResult);
+          return {
+            requiresAction: true,
+            token: loginResult.token
+          };
+        }
+        if ("location" in loginResult) {
+          this.logger.warn("Authentication requires additional actions", loginResult);
+          return {
+            requiresAction: true,
+            redirectUrl: loginResult.location
+          };
+        }
+        throw new Error("Unexpected login result type");
       }
+      const token = loginResult;
       if (this.authConfig.method === "jwt") {
         await this.storageManager.setToken(token);
       }
@@ -1574,19 +1791,38 @@ var MedusaAuthProvider = class {
   async register(data) {
     this.logger.debug("register", { email: data.email });
     try {
-      const token = await this.sdk.auth.register("customer", "emailpass", {
+      await this.sdk.auth.register("customer", "emailpass", {
         email: data.email,
         password: data.password
       });
-      if (typeof token !== "string") {
-        throw new Error("Registration returned non-string token");
-      }
       const { customer } = await this.sdk.store.customer.create({
         email: data.email,
         first_name: data.first_name,
         last_name: data.last_name,
         phone: data.phone
       });
+      const loginResult = await this.sdk.auth.login("customer", "emailpass", {
+        email: data.email,
+        password: data.password
+      });
+      if (typeof loginResult !== "string") {
+        if ("verification_required" in loginResult && loginResult.verification_required) {
+          this.logger.warn("Registration requires email verification", loginResult);
+          return {
+            requiresAction: true,
+            token: loginResult.token
+          };
+        }
+        if ("location" in loginResult) {
+          this.logger.warn("Registration requires additional actions", loginResult);
+          return {
+            requiresAction: true,
+            redirectUrl: loginResult.location
+          };
+        }
+        throw new Error("Unexpected login result after registration");
+      }
+      const token = loginResult;
       if (this.authConfig.method === "jwt") {
         await this.storageManager.setToken(token);
       }
@@ -1806,81 +2042,6 @@ 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
@@ -2023,317 +2184,33 @@ async function getPaymentMethods(sdk, options) {
   }
 }
 
-// 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
-  // -----------------------------------------------------------------------
+// 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";
   /**
-   * Paginated list of customers linked to a sales channel.
-   *
-   * `GET /admin/thor/sales-channels/:id/customers`
+   * Medusa backend capabilities.
+   * Starts with static defaults, replaced by dynamic values from
+   * `GET /store/thor/capabilities` once the fetch completes.
    */
-  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
-  // -----------------------------------------------------------------------
+  _dynamicCapabilities = null;
+  /** Promise that resolves when capabilities fetch completes (success or failure) */
+  _capabilitiesPromise = null;
   /**
-   * Publishable API keys associated with a sales channel.
-   *
-   * `GET /admin/thor/sales-channels/:id/api-keys`
+   * Getter returns dynamic capabilities if available, otherwise static fallback.
    */
-  async getChannelApiKeys(salesChannelId) {
-    return this.request(
-      "GET",
-      `/admin/thor/sales-channels/${salesChannelId}/api-keys`
-    );
+  get capabilities() {
+    return this._dynamicCapabilities ?? MEDUSA_CAPABILITIES;
   }
-  // -----------------------------------------------------------------------
-  // 3.3 — Sales Channel: Categories
-  // -----------------------------------------------------------------------
-  /**
-   * Product categories assigned to a sales channel.
-   *
-   * `GET /admin/thor/sales-channels/:id/categories`
-   */
-  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
-  // -----------------------------------------------------------------------
-  /**
-   * Sales channels to which a category is assigned.
-   *
-   * `GET /admin/thor/categories/:id/sales-channels`
-   */
-  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;
+  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
@@ -2341,18 +2218,6 @@ var MedusaProvider = class {
    * 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;
   /**
@@ -2423,15 +2288,10 @@ 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, config.baseUrl, config.publishableKey);
+      this.auth = new MedusaAuthProvider(this.sdk, config.auth, config.debug);
       this.logger.info("Auth provider initialized");
     }
     this._capabilitiesPromise = this._fetchCapabilities();
@@ -5394,187 +5254,2794 @@ var MedusaProvider = class {
       );
     }
   }
-  /**
-   * Medusa always requires storefront configuration for multi-tenant support.
-   */
-  isStorefrontRequired() {
-    return true;
+  /**
+   * 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;
+    }
+  }
+  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);
   }
   // ============================================
-  // Thor Plugin — Storefront Configuration
+  // Cart Operations (GraphQL)
   // ============================================
-  /** 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 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 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;
+      const data = await this.graphql(GET_CART2, { cartId });
+      return data.cart ? transformCart6(data.cart, this.currencyCode) : void 0;
+    } catch {
+      return void 0;
     }
   }
-  /**
-   * 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
+  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"
       );
-      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 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
       });
-      return null;
+      cart = data.removeItemFromCart.cart;
     }
+    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);
   }
   // ============================================
-  // Thor Plugin — Admin Site Designer
+  // Checkout Operations
   // ============================================
-  /**
-   * 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
-      };
-    });
+  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"
+    );
   }
-  /**
-   * 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
-      };
+  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);
   }
-  /**
-   * 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
-      };
+  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 [];
+    try {
+      const data = await this.graphql(GET_CUSTOMER_ORDERS, {
+        pageSize: 20,
+        currentPage: 1
+      });
+      return (data.customer?.orders?.items ?? []).map((o) => transformOrder6(o, this.currencyCode));
+    } catch {
+      return [];
+    }
+  }
+  async getPaymentMethods(_options) {
+    return [];
+  }
+  // ============================================
+  // Inventory
+  // ============================================
+  async getStockLocations() {
+    return [];
+  }
+  async checkInventoryLevels() {
+    return [];
+  }
+  async validateCartStock() {
+    return { allAvailable: true, unavailableItems: [] };
+  }
+  async getFulfillmentOptions() {
+    return [];
+  }
+  // ============================================
+  // Admin Operations
+  // ============================================
+  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 };
+  }
+  // ============================================
+  // Storefront / Multi-Tenant
+  // ============================================
+  async getStorefrontContext() {
+    return {
+      id: this.storeCode,
+      name: `Magento ${this.storeCode}`,
+      platformType: "magento",
+      requiresProductScoping: true,
+      currencyCode: this.currencyCode
+    };
+  }
+  isStorefrontRequired() {
+    return true;
   }
 };
 
@@ -7609,16 +10076,6 @@ 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");
@@ -7626,14 +10083,27 @@ function createProvider(options) {
   if (!options.config) {
     throw new ConfigurationError("Provider configuration is required");
   }
-  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?`
-    );
+  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));
   }
-  return factory(options.config);
 }
 function isProviderType(provider, type) {
   return provider.name === type;
@@ -7641,6 +10111,8 @@ function isProviderType(provider, type) {
 export {
   AdminAuthService,
   AdminSessionService,
+  BIGCOMMERCE_CAPABILITIES,
+  BigCommerceProvider,
   CHANNEL_ASSIGNED_AT_KEY,
   CHANNEL_ASSIGNED_BY_KEY,
   CHANNEL_SCOPE_KEY,
@@ -7649,8 +10121,10 @@ export {
   CircuitBreakerOpenError,
   CommerceError,
   ConfigurationError,
+  MAGENTO_CAPABILITIES,
   MEDUSA_CAPABILITIES,
   MOCK_CAPABILITIES,
+  MagentoProvider,
   MedusaMetadataAdapter,
   MedusaProvider,
   MetricsService,
@@ -7658,14 +10132,21 @@ export {
   ProviderAPIError,
   ProviderNotFoundError,
   ResourceNotFoundError,
+  SHOPIFY_CAPABILITIES,
+  SPREE_CAPABILITIES,
   STELORDER_CAPABILITIES,
+  ShopifyProvider,
+  SpreeProvider,
   StelOrderProvider,
   StorefrontConfigError2 as StorefrontConfigError,
+  WOOCOMMERCE_CAPABILITIES,
+  WooCommerceProvider,
   assertEntityBelongsToChannel,
   backendCircuitBreaker,
   buildChannelScopeMetadata,
   calculateDistance,
   createBackendMetadataAdapter,
+  createFetchWithRetry,
   createLogger,
   createProvider,
   extractErrorMessage,
@@ -7676,7 +10157,6 @@ export {
   getBackendProviderId,
   getCapabilityDescription,
   getChannelScope,
-  getRegisteredProviders,
   isBackendCapabilities,
   isGlobalEntity,
   isProviderType,
@@ -7686,7 +10166,6 @@ export {
   numberToMoney,
   partitionByChannel,
   planFulfillment,
-  registerProvider,
   transformFulfillmentOption,
   transformInventoryLevel,
   transformStockLocation,