@thorprovider/adapters 4.2.1 → 4.3.0

package/src/providers/medusa/index.js

@@ -1,2485 +0,0 @@
-"use strict";
-/**
- * @thorprovider/adapters v2.0
- * Medusa Provider - Main implementation
- */
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MedusaProvider = void 0;
-var js_sdk_1 = require("@medusajs/js-sdk");
-var types_1 = require("@thorprovider/types");
-var capabilities_types_1 = require("../../types/capabilities.types");
-var logger_1 = require("../../core/logger");
-var fetch_utils_1 = require("../../core/fetch-utils");
-var errors_1 = require("../../core/errors");
-var payment_utils_1 = require("../../utils/payment-utils");
-var transforms_1 = require("./transforms");
-var auth_1 = require("./auth");
-var payment_1 = require("./payment");
-var metadata_1 = require("../../metadata");
-var MEDUSA_CART_RETRIEVE_FIELDS = '+items,+items.variant,+items.variant.product,+items.variant.product.thumbnail,+items.variant.options,+items.variant.options.option';
-/**
- * Medusa commerce provider
- *
- * Implements CommerceProvider interface for Medusa.js v2
- */
-var MedusaProvider = /** @class */ (function () {
-    function MedusaProvider(config) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
-        this.name = 'medusa';
-        this.version = '2.0.0';
-        /**
-         * Medusa backend capabilities
-         * Defines what operations Medusa supports
-         */
-        this.capabilities = capabilities_types_1.MEDUSA_CAPABILITIES;
-        /**
-         * In-memory cache for region countries
-         * Structure: Map<regionId, { countries: Country[], expiresAt: number }>
-         */
-        this.regionCountriesCache = new Map();
-        /**
-         * Cache TTL for region countries (5 minutes)
-         */
-        this.REGION_COUNTRIES_CACHE_TTL = 5 * 60 * 1000;
-        /**
-         * In-memory cache for storefront context (60 second TTL)
-         */
-        this.storefrontContextCache = null;
-        /**
-         * Cache TTL for storefront context (60 seconds)
-         */
-        this.STOREFRONT_CONTEXT_CACHE_TTL = 60 * 1000;
-        this.logger = (0, logger_1.createLogger)('MedusaProvider', config.debug);
-        this.currencyCode = (_a = config.currencyCode) !== null && _a !== void 0 ? _a : 'USD';
-        this.baseUrl = config.baseUrl;
-        this.publishableKey = config.publishableKey;
-        // Store retry configuration
-        this.retryConfig = {
-            maxRetries: (_c = (_b = config.retry) === null || _b === void 0 ? void 0 : _b.maxRetries) !== null && _c !== void 0 ? _c : 3,
-            timeoutMs: (_e = (_d = config.retry) === null || _d === void 0 ? void 0 : _d.timeoutMs) !== null && _e !== void 0 ? _e : 10000,
-            initialDelayMs: (_g = (_f = config.retry) === null || _f === void 0 ? void 0 : _f.initialDelayMs) !== null && _g !== void 0 ? _g : 300,
-            backoffMultiplier: (_j = (_h = config.retry) === null || _h === void 0 ? void 0 : _h.backoffMultiplier) !== null && _j !== void 0 ? _j : 2,
-            maxDelayMs: (_l = (_k = config.retry) === null || _k === void 0 ? void 0 : _k.maxDelayMs) !== null && _l !== void 0 ? _l : 5000,
-            retryableStatusCodes: (_o = (_m = config.retry) === null || _m === void 0 ? void 0 : _m.retryableStatusCodes) !== null && _o !== void 0 ? _o : [408, 429, 500, 502, 503, 504],
-        };
-        this.logger.info('Initializing Medusa Provider', {
-            baseUrl: config.baseUrl,
-            currencyCode: this.currencyCode,
-            hasAuth: !!config.auth,
-            retryConfig: this.retryConfig,
-        });
-        this.sdk = new js_sdk_1.default({
-            baseUrl: config.baseUrl,
-            publishableKey: config.publishableKey,
-            debug: (_p = config.debug) !== null && _p !== void 0 ? _p : false,
-            // Always use JWT mode for auth - SDK needs to send Bearer tokens
-            // Configure storage method for JWT tokens (browser only)
-            auth: config.auth
-                ? {
-                    type: 'jwt',
-                    // Use localStorage in browser, memory storage on server
-                    jwtTokenStorageMethod: typeof window !== 'undefined' ? 'local' : 'memory',
-                }
-                : undefined,
-        });
-        // Initialize auth provider if config is provided
-        if (config.auth) {
-            this.auth = new auth_1.MedusaAuthProvider(this.sdk, config.auth, config.debug);
-            this.logger.info('Auth provider initialized');
-        }
-    }
-    MedusaProvider.prototype.retrieveCartWithLineDetails = function (cartId) {
-        return __awaiter(this, void 0, void 0, function () {
-            var cart;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.sdk.store.cart.retrieve(cartId, {
-                            fields: MEDUSA_CART_RETRIEVE_FIELDS,
-                        })];
-                    case 1:
-                        cart = (_a.sent()).cart;
-                        return [2 /*return*/, cart];
-                }
-            });
-        });
-    };
-    // ============================================
-    // Product Operations
-    // ============================================
-    /**
-     * Wrapper for SDK calls with retry logic
-     * Handles network failures and temporary backend issues
-     */
-    MedusaProvider.prototype.withRetry = function (operation, operationName, context) {
-        return __awaiter(this, void 0, void 0, function () {
-            var lastError, _loop_1, this_1, attempt, state_1;
-            var _this = this;
-            var _a, _b, _c, _d;
-            return __generator(this, function (_e) {
-                switch (_e.label) {
-                    case 0:
-                        _loop_1 = function (attempt) {
-                            var timeoutPromise, result, error_1, isRetryable, shouldRetry, delay, cappedDelay_1;
-                            return __generator(this, function (_f) {
-                                switch (_f.label) {
-                                    case 0:
-                                        _f.trys.push([0, 2, , 6]);
-                                        timeoutPromise = new Promise(function (_, reject) {
-                                            setTimeout(function () {
-                                                reject(new Error("Request timeout after ".concat(_this.retryConfig.timeoutMs, "ms")));
-                                            }, _this.retryConfig.timeoutMs);
-                                        });
-                                        return [4 /*yield*/, Promise.race([operation(), timeoutPromise])];
-                                    case 1:
-                                        result = _f.sent();
-                                        if (attempt > 0) {
-                                            this_1.logger.info("".concat(operationName, " succeeded after ").concat(attempt, " retries"), context);
-                                        }
-                                        return [2 /*return*/, { value: result }];
-                                    case 2:
-                                        error_1 = _f.sent();
-                                        lastError = error_1;
-                                        isRetryable = ((_a = error_1.message) === null || _a === void 0 ? void 0 : _a.includes('fetch failed')) ||
-                                            ((_b = error_1.message) === null || _b === void 0 ? void 0 : _b.includes('timeout')) ||
-                                            ((_c = error_1.message) === null || _c === void 0 ? void 0 : _c.includes('ECONNREFUSED')) ||
-                                            ((_d = error_1.message) === null || _d === void 0 ? void 0 : _d.includes('ETIMEDOUT')) ||
-                                            (error_1.status && this_1.retryConfig.retryableStatusCodes.includes(error_1.status));
-                                        shouldRetry = attempt < this_1.retryConfig.maxRetries && isRetryable;
-                                        if (!shouldRetry) return [3 /*break*/, 4];
-                                        delay = this_1.retryConfig.initialDelayMs * Math.pow(this_1.retryConfig.backoffMultiplier, attempt);
-                                        cappedDelay_1 = Math.min(delay, this_1.retryConfig.maxDelayMs);
-                                        this_1.logger.warn("".concat(operationName, " failed, retrying..."), __assign(__assign({}, context), { attempt: attempt + 1, maxAttempts: this_1.retryConfig.maxRetries + 1, nextRetryIn: "".concat(cappedDelay_1, "ms"), error: error_1.message }));
-                                        return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, cappedDelay_1); })];
-                                    case 3:
-                                        _f.sent();
-                                        return [3 /*break*/, 5];
-                                    case 4:
-                                        this_1.logger.error("".concat(operationName, " failed after all retries"), __assign(__assign({}, context), { totalAttempts: attempt + 1, error: error_1.message }));
-                                        return [2 /*return*/, "break"];
-                                    case 5: return [3 /*break*/, 6];
-                                    case 6: return [2 /*return*/];
-                                }
-                            });
-                        };
-                        this_1 = this;
-                        attempt = 0;
-                        _e.label = 1;
-                    case 1:
-                        if (!(attempt <= this.retryConfig.maxRetries)) return [3 /*break*/, 4];
-                        return [5 /*yield**/, _loop_1(attempt)];
-                    case 2:
-                        state_1 = _e.sent();
-                        if (typeof state_1 === "object")
-                            return [2 /*return*/, state_1.value];
-                        if (state_1 === "break")
-                            return [3 /*break*/, 4];
-                        _e.label = 3;
-                    case 3:
-                        attempt++;
-                        return [3 /*break*/, 1];
-                    case 4: 
-                    // All retries exhausted
-                    throw lastError;
-                }
-            });
-        });
-    };
-    MedusaProvider.prototype.getProduct = function (handle, options) {
-        return __awaiter(this, void 0, void 0, function () {
-            var error_2;
-            var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('getProduct', { handle: handle, regionId: options === null || options === void 0 ? void 0 : options.regionId });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                var baseFields, pricingFields, fields, queryParams, salesChannelId, products, transformedProduct;
-                                return __generator(this, function (_a) {
-                                    switch (_a.label) {
-                                        case 0:
-                                            baseFields = '+variants,+variants.inventory_quantity,+options,+images,+tags';
-                                            pricingFields = ',+variants.calculated_price,+variants.prices';
-                                            fields = (options === null || options === void 0 ? void 0 : options.regionId) ? baseFields + pricingFields : baseFields;
-                                            queryParams = {
-                                                handle: handle,
-                                                limit: 1,
-                                                fields: fields,
-                                            };
-                                            // Add region_id for region-based pricing
-                                            if (options === null || options === void 0 ? void 0 : options.regionId) {
-                                                queryParams.region_id = options.regionId;
-                                            }
-                                            salesChannelId = process.env.NEXT_PUBLIC_SALES_CHANNEL_ID;
-                                            if (salesChannelId) {
-                                                queryParams.sales_channel_id = [salesChannelId];
-                                            }
-                                            return [4 /*yield*/, this.sdk.store.product.list(queryParams)];
-                                        case 1:
-                                            products = (_a.sent()).products;
-                                            if (!products || products.length === 0) {
-                                                this.logger.debug('Product not found', { handle: handle });
-                                                return [2 /*return*/, undefined];
-                                            }
-                                            transformedProduct = (0, transforms_1.transformProduct)(products[0], this.currencyCode);
-                                            return [2 /*return*/, transformedProduct];
-                                    }
-                                });
-                            }); }, 'getProduct', { handle: handle, regionId: options === null || options === void 0 ? void 0 : options.regionId })];
-                    case 2: return [2 /*return*/, _a.sent()];
-                    case 3:
-                        error_2 = _a.sent();
-                        throw new errors_1.ProviderAPIError("Failed to fetch product: ".concat(error_2.message), 'medusa', error_2.status);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    MedusaProvider.prototype.getProducts = function () {
-        return __awaiter(this, arguments, void 0, function (options) {
-            var error_3;
-            var _this = this;
-            if (options === void 0) { options = {}; }
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('getProducts', options);
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                var baseFields, pricingFields, fields, queryParams, salesChannelId, products;
-                                var _this = this;
-                                var _a;
-                                return __generator(this, function (_b) {
-                                    switch (_b.label) {
-                                        case 0:
-                                            baseFields = '+variants,+variants.inventory_quantity,+options,+images,+tags';
-                                            pricingFields = ',+variants.calculated_price,+variants.prices';
-                                            fields = options.regionId ? baseFields + pricingFields : baseFields;
-                                            queryParams = {
-                                                q: options.query,
-                                                order: options.sortKey,
-                                                limit: (_a = options.first) !== null && _a !== void 0 ? _a : 100,
-                                                offset: options.after ? parseInt(options.after, 10) : undefined,
-                                                fields: fields,
-                                            };
-                                            // Add region_id for region-based pricing
-                                            if (options.regionId) {
-                                                queryParams.region_id = options.regionId;
-                                            }
-                                            salesChannelId = process.env.NEXT_PUBLIC_SALES_CHANNEL_ID;
-                                            if (salesChannelId) {
-                                                queryParams.sales_channel_id = [salesChannelId];
-                                            }
-                                            return [4 /*yield*/, this.sdk.store.product.list(queryParams)];
-                                        case 1:
-                                            products = (_b.sent()).products;
-                                            return [2 /*return*/, products.map(function (p) { return (0, transforms_1.transformProduct)(p, _this.currencyCode); })];
-                                    }
-                                });
-                            }); }, 'getProducts', options)];
-                    case 2: return [2 /*return*/, _a.sent()];
-                    case 3:
-                        error_3 = _a.sent();
-                        // Enhanced error logging
-                        this.logger.error('getProducts error details', {
-                            message: error_3.message,
-                            status: error_3.status,
-                            type: error_3.type,
-                            code: error_3.code,
-                            stack: error_3.stack,
-                            fullError: JSON.stringify(error_3, null, 2),
-                        });
-                        throw new errors_1.ProviderAPIError("Failed to fetch products: ".concat(error_3.message || 'Unknown error'), 'medusa', error_3.status);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    MedusaProvider.prototype.getProductRecommendations = function (productId) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                this.logger.debug('getProductRecommendations', { productId: productId });
-                // Medusa doesn't have built-in recommendations yet
-                // Return empty array for now - can be extended with custom logic
-                this.logger.warn('Product recommendations not yet implemented for Medusa');
-                return [2 /*return*/, []];
-            });
-        });
-    };
-    // ============================================
-    // Collection Operations
-    // ============================================
-    MedusaProvider.prototype.getCollection = function (handle) {
-        return __awaiter(this, void 0, void 0, function () {
-            var collections, error_4;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('getCollection', { handle: handle });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.sdk.store.collection.list({
-                                handle: [handle],
-                                limit: 1,
-                            })];
-                    case 2:
-                        collections = (_a.sent()).collections;
-                        if (!collections || collections.length === 0) {
-                            this.logger.debug('Collection not found', { handle: handle });
-                            return [2 /*return*/, undefined];
-                        }
-                        return [2 /*return*/, (0, transforms_1.transformCollection)(collections[0])];
-                    case 3:
-                        error_4 = _a.sent();
-                        this.logger.error('Failed to fetch collection', { handle: handle, error: error_4.message });
-                        throw new errors_1.ProviderAPIError("Failed to fetch collection: ".concat(error_4.message), 'medusa', error_4.status);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    MedusaProvider.prototype.getCollections = function (options) {
-        return __awaiter(this, void 0, void 0, function () {
-            var limit, collections, result, q_1, error_5;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('getCollections', { options: options });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        limit = (options === null || options === void 0 ? void 0 : options.query) ? 1000 : ((options === null || options === void 0 ? void 0 : options.limit) || 100);
-                        return [4 /*yield*/, this.sdk.store.collection.list({
-                                limit: limit,
-                            })];
-                    case 2:
-                        collections = (_a.sent()).collections;
-                        result = collections.map(transforms_1.transformCollection);
-                        // Client-side search filtering (Medusa Store API lacks query param for collections)
-                        if (options === null || options === void 0 ? void 0 : options.query) {
-                            q_1 = options.query.toLowerCase();
-                            result = result.filter(function (c) {
-                                return c.title.toLowerCase().includes(q_1) ||
-                                    c.handle.toLowerCase().includes(q_1);
-                            });
-                        }
-                        return [2 /*return*/, result];
-                    case 3:
-                        error_5 = _a.sent();
-                        this.logger.error('Failed to fetch collections', { error: error_5.message });
-                        throw new errors_1.ProviderAPIError("Failed to fetch collections: ".concat(error_5.message), 'medusa', error_5.status);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    MedusaProvider.prototype.getCollectionProducts = function (handle_1) {
-        return __awaiter(this, arguments, void 0, function (handle, options) {
-            var collection, collectionQueryParams, salesChannelId, products, error_6;
-            var _this = this;
-            var _a;
-            if (options === void 0) { options = {}; }
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        this.logger.debug('getCollectionProducts', { handle: handle, options: options });
-                        _b.label = 1;
-                    case 1:
-                        _b.trys.push([1, 4, , 5]);
-                        return [4 /*yield*/, this.getCollection(handle)];
-                    case 2:
-                        collection = _b.sent();
-                        if (!collection) {
-                            throw new errors_1.ResourceNotFoundError('Collection', handle);
-                        }
-                        collectionQueryParams = {
-                            collection_id: [collection.handle], // Medusa uses handle in queries
-                            order: options.sortKey,
-                            limit: (_a = options.first) !== null && _a !== void 0 ? _a : 100,
-                            offset: options.after ? parseInt(options.after, 10) : undefined,
-                            fields: '+variants,+variants.prices,+variants.calculated_prices,+variants.inventory_quantity,+options,+images,+tags',
-                        };
-                        salesChannelId = process.env.NEXT_PUBLIC_SALES_CHANNEL_ID;
-                        if (salesChannelId) {
-                            collectionQueryParams.sales_channel_id = [salesChannelId];
-                        }
-                        return [4 /*yield*/, this.sdk.store.product.list(collectionQueryParams)];
-                    case 3:
-                        products = (_b.sent()).products;
-                        return [2 /*return*/, products.map(function (p) { return (0, transforms_1.transformProduct)(p, _this.currencyCode); })];
-                    case 4:
-                        error_6 = _b.sent();
-                        if (error_6 instanceof errors_1.ResourceNotFoundError)
-                            throw error_6;
-                        this.logger.error('Failed to fetch collection products', { handle: handle, error: error_6.message });
-                        throw new errors_1.ProviderAPIError("Failed to fetch collection products: ".concat(error_6.message), 'medusa', error_6.status);
-                    case 5: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    // ============================================
-    // Category Operations
-    // ============================================
-    MedusaProvider.prototype.getCategory = function (idOrHandle) {
-        return __awaiter(this, void 0, void 0, function () {
-            var product_categories, error_7;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('getCategory', { idOrHandle: idOrHandle });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.sdk.store.category.list({
-                                handle: [idOrHandle],
-                                limit: 1,
-                            })];
-                    case 2:
-                        product_categories = (_a.sent()).product_categories;
-                        if (!product_categories || product_categories.length === 0) {
-                            this.logger.debug('Category not found', { idOrHandle: idOrHandle });
-                            return [2 /*return*/, undefined];
-                        }
-                        return [2 /*return*/, (0, transforms_1.transformCategory)(product_categories[0])];
-                    case 3:
-                        error_7 = _a.sent();
-                        this.logger.error('Failed to fetch category', { idOrHandle: idOrHandle, error: error_7.message });
-                        throw new errors_1.ProviderAPIError("Failed to fetch category: ".concat(error_7.message), 'medusa', error_7.status);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Returns the set of product-category IDs that have at least one product
-     * available in the given sales channel.
-     *
-     * Because Medusa's store/product-categories endpoint does not accept a
-     * `sales_channel_id` filter, we derive the active category IDs by querying
-     * store/products with the sales-channel scope and collecting the category
-     * relations from the response. Pagination is handled internally so the
-     * result is always complete regardless of catalog size.
-     */
-    MedusaProvider.prototype._getActiveCategoryIds = function (salesChannelId) {
-        return __awaiter(this, void 0, void 0, function () {
-            var categoryIds, limit, offset, products, _i, _a, product, _b, _c, cat;
-            var _d;
-            return __generator(this, function (_e) {
-                switch (_e.label) {
-                    case 0:
-                        this.logger.debug('_getActiveCategoryIds', { salesChannelId: salesChannelId });
-                        categoryIds = new Set();
-                        limit = 500;
-                        offset = 0;
-                        _e.label = 1;
-                    case 1:
-                        if (!true) return [3 /*break*/, 3];
-                        return [4 /*yield*/, this.sdk.store.product.list({
-                                sales_channel_id: [salesChannelId],
-                                // Request only the category id relation to minimise payload size
-                                fields: '+categories.id',
-                                limit: limit,
-                                offset: offset,
-                            })];
-                    case 2:
-                        products = (_e.sent()).products;
-                        for (_i = 0, _a = products !== null && products !== void 0 ? products : []; _i < _a.length; _i++) {
-                            product = _a[_i];
-                            for (_b = 0, _c = (_d = product.categories) !== null && _d !== void 0 ? _d : []; _b < _c.length; _b++) {
-                                cat = _c[_b];
-                                if (cat === null || cat === void 0 ? void 0 : cat.id)
-                                    categoryIds.add(cat.id);
-                            }
-                        }
-                        if (!products || products.length < limit)
-                            return [3 /*break*/, 3];
-                        offset += limit;
-                        return [3 /*break*/, 1];
-                    case 3:
-                        this.logger.debug('_getActiveCategoryIds result', { count: categoryIds.size });
-                        return [2 /*return*/, categoryIds];
-                }
-            });
-        });
-    };
-    MedusaProvider.prototype.getCategories = function () {
-        return __awaiter(this, arguments, void 0, function (options) {
-            var customFetcher, limit, queryParams, product_categories, result, salesChannelId, activeCategoryIds_1, q_2, error_8;
-            var _a, _b, _c;
-            if (options === void 0) { options = {}; }
-            return __generator(this, function (_d) {
-                switch (_d.label) {
-                    case 0:
-                        this.logger.debug('getCategories', { options: options });
-                        customFetcher = options.customFetcher;
-                        // If custom fetcher provided, use it instead of default SDK logic
-                        if (customFetcher) {
-                            this.logger.debug('Using custom fetcher for categories');
-                            return [2 /*return*/, customFetcher(options)];
-                        }
-                        _d.label = 1;
-                    case 1:
-                        _d.trys.push([1, 5, , 6]);
-                        limit = options.query ? 1000 : ((_a = options.limit) !== null && _a !== void 0 ? _a : 100);
-                        queryParams = {
-                            limit: limit,
-                            include_descendants_tree: (_b = options.includeDescendants) !== null && _b !== void 0 ? _b : false,
-                        };
-                        if (options.parentCategoryId) {
-                            queryParams.parent_category_id = options.parentCategoryId;
-                        }
-                        return [4 /*yield*/, this.sdk.store.category.list(queryParams)];
-                    case 2:
-                        product_categories = (_d.sent()).product_categories;
-                        result = product_categories.map(transforms_1.transformCategory);
-                        salesChannelId = (_c = options.salesChannelId) !== null && _c !== void 0 ? _c : process.env.NEXT_PUBLIC_SALES_CHANNEL_ID;
-                        if (!salesChannelId) return [3 /*break*/, 4];
-                        return [4 /*yield*/, this._getActiveCategoryIds(salesChannelId)];
-                    case 3:
-                        activeCategoryIds_1 = _d.sent();
-                        result = result.filter(function (c) { return activeCategoryIds_1.has(c.id); });
-                        _d.label = 4;
-                    case 4:
-                        // Client-side search filtering
-                        if (options.query) {
-                            q_2 = options.query.toLowerCase();
-                            result = result.filter(function (c) {
-                                return c.name.toLowerCase().includes(q_2) || c.handle.toLowerCase().includes(q_2);
-                            });
-                        }
-                        return [2 /*return*/, result];
-                    case 5:
-                        error_8 = _d.sent();
-                        this.logger.error('Failed to fetch categories', { error: error_8.message });
-                        throw new errors_1.ProviderAPIError("Failed to fetch categories: ".concat(error_8.message), 'medusa', error_8.status);
-                    case 6: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    MedusaProvider.prototype.getCategoryProducts = function (handle_1) {
-        return __awaiter(this, arguments, void 0, function (handle, options) {
-            var category, categoryQueryParams, salesChannelId, products, error_9;
-            var _this = this;
-            var _a;
-            if (options === void 0) { options = {}; }
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        this.logger.debug('getCategoryProducts', { handle: handle, options: options });
-                        _b.label = 1;
-                    case 1:
-                        _b.trys.push([1, 4, , 5]);
-                        return [4 /*yield*/, this.getCategory(handle)];
-                    case 2:
-                        category = _b.sent();
-                        if (!category) {
-                            throw new errors_1.ResourceNotFoundError('Category', handle);
-                        }
-                        categoryQueryParams = {
-                            category_id: [category.id],
-                            order: options.sortKey,
-                            limit: (_a = options.first) !== null && _a !== void 0 ? _a : 100,
-                            offset: options.after ? parseInt(options.after, 10) : undefined,
-                            fields: '+variants,+variants.prices,+variants.calculated_prices,+variants.inventory_quantity,+options,+images,+tags',
-                        };
-                        salesChannelId = process.env.NEXT_PUBLIC_SALES_CHANNEL_ID;
-                        if (salesChannelId) {
-                            categoryQueryParams.sales_channel_id = [salesChannelId];
-                        }
-                        return [4 /*yield*/, this.sdk.store.product.list(categoryQueryParams)];
-                    case 3:
-                        products = (_b.sent()).products;
-                        return [2 /*return*/, products.map(function (p) { return (0, transforms_1.transformProduct)(p, _this.currencyCode); })];
-                    case 4:
-                        error_9 = _b.sent();
-                        if (error_9 instanceof errors_1.ResourceNotFoundError)
-                            throw error_9;
-                        this.logger.error('Failed to fetch category products', { handle: handle, error: error_9.message });
-                        throw new errors_1.ProviderAPIError("Failed to fetch category products: ".concat(error_9.message), 'medusa', error_9.status);
-                    case 5: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    // ============================================
-    // Cart Operations
-    // ============================================
-    MedusaProvider.prototype.createCart = function (options) {
-        return __awaiter(this, void 0, void 0, function () {
-            var createPayload, cart, error_10, errorMessage;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('createCart', { regionId: options === null || options === void 0 ? void 0 : options.regionId });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        createPayload = {};
-                        // If a regionId is provided, prefer letting Medusa resolve the currency
-                        // from the region. Do NOT set `currency_code` when `region_id` is present,
-                        // otherwise Medusa may use the provided currency and ignore the region.
-                        if (options === null || options === void 0 ? void 0 : options.regionId) {
-                            createPayload.region_id = options.regionId;
-                        }
-                        else {
-                            createPayload.currency_code = this.currencyCode.toLowerCase();
-                        }
-                        return [4 /*yield*/, this.sdk.store.cart.create(createPayload)];
-                    case 2:
-                        cart = (_a.sent()).cart;
-                        return [2 /*return*/, (0, transforms_1.transformCart)(cart)];
-                    case 3:
-                        error_10 = _a.sent();
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_10);
-                        this.logger.error('Failed to create cart', { error: errorMessage });
-                        throw new errors_1.ProviderAPIError("Failed to create cart: ".concat(errorMessage), 'medusa', (error_10 === null || error_10 === void 0 ? void 0 : error_10.status) || (error_10 === null || error_10 === void 0 ? void 0 : error_10.statusCode));
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    MedusaProvider.prototype.getCart = function (cartId) {
-        return __awaiter(this, void 0, void 0, function () {
-            var cart, error_11, status_1, errorMessage;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('getCart', { cartId: cartId });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.retrieveCartWithLineDetails(cartId)];
-                    case 2:
-                        cart = _a.sent();
-                        if (!cart) {
-                            this.logger.debug('Cart not found', { cartId: cartId });
-                            return [2 /*return*/, undefined];
-                        }
-                        return [2 /*return*/, (0, transforms_1.transformCart)(cart)];
-                    case 3:
-                        error_11 = _a.sent();
-                        status_1 = (error_11 === null || error_11 === void 0 ? void 0 : error_11.status) || (error_11 === null || error_11 === void 0 ? void 0 : error_11.statusCode);
-                        if (status_1 === 404) {
-                            this.logger.debug('Cart not found', { cartId: cartId });
-                            return [2 /*return*/, undefined];
-                        }
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_11);
-                        this.logger.error('Failed to fetch cart', { cartId: cartId, error: errorMessage });
-                        throw new errors_1.ProviderAPIError("Failed to fetch cart: ".concat(errorMessage), 'medusa', status_1);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    MedusaProvider.prototype.addToCart = function (cartId, lines) {
-        return __awaiter(this, void 0, void 0, function () {
-            var retrieveCtx, retrieveResult, backendCart_1, _loop_2, this_2, _i, lines_1, line, cart, error_12, errorMessage, errorDetails, err, status_2, userMessage;
-            var _this = this;
-            var _a, _b;
-            return __generator(this, function (_c) {
-                switch (_c.label) {
-                    case 0:
-                        this.logger.debug('addToCart', { cartId: cartId, lines: lines });
-                        _c.label = 1;
-                    case 1:
-                        _c.trys.push([1, 8, , 9]);
-                        retrieveCtx = { cartId: cartId };
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
-                                return [2 /*return*/, this.sdk.store.cart.retrieve(cartId)];
-                            }); }); }, 'retrieveCartBeforeAdd', retrieveCtx)];
-                    case 2:
-                        retrieveResult = _c.sent();
-                        console.log('retrieveResult =', JSON.stringify(retrieveResult, null, 2));
-                        backendCart_1 = retrieveResult === null || retrieveResult === void 0 ? void 0 : retrieveResult.cart;
-                        if (!backendCart_1) {
-                            this.logger.warn('Cart not found before addToCart', { cartId: cartId });
-                            throw new errors_1.ProviderAPIError('Cart not found. Please refresh and try again.', 'medusa', 404);
-                        }
-                        console.log('backendCart =', JSON.stringify(backendCart_1, null, 2));
-                        if (!backendCart_1.region_id) {
-                            this.logger.warn('Attempted to add item to cart with no region_id', { cartId: cartId });
-                            throw new errors_1.ProviderAPIError('Cart does not have a region set. Please select a region or recreate your cart and try again.', 'medusa', 400);
-                        }
-                        _loop_2 = function (line) {
-                            var variantCheckParams, salesChannelId, plist, products, foundVariant, _d, products_1, p, v, variant, hasPriceForRegion, calcCurrency, cartCurrency, prices, prices, variantErr_1, result;
-                            return __generator(this, function (_e) {
-                                switch (_e.label) {
-                                    case 0:
-                                        this_2.logger.debug('createLineItem payload', {
-                                            cartId: cartId,
-                                            variant_id: line.merchandiseId,
-                                            quantity: line.quantity,
-                                            cartRegion: backendCart_1.region_id,
-                                        });
-                                        _e.label = 1;
-                                    case 1:
-                                        _e.trys.push([1, 3, , 4]);
-                                        variantCheckParams = {
-                                            limit: 200,
-                                            fields: '+variants,+variants.calculated_price,+variants.prices,+variants.money_amounts',
-                                            region_id: backendCart_1.region_id,
-                                        };
-                                        salesChannelId = process.env.NEXT_PUBLIC_SALES_CHANNEL_ID;
-                                        if (salesChannelId) {
-                                            variantCheckParams.sales_channel_id = [salesChannelId];
-                                        }
-                                        return [4 /*yield*/, this_2.sdk.store.product.list(variantCheckParams)];
-                                    case 2:
-                                        plist = _e.sent();
-                                        products = (plist === null || plist === void 0 ? void 0 : plist.products) || [];
-                                        foundVariant = void 0;
-                                        for (_d = 0, products_1 = products; _d < products_1.length; _d++) {
-                                            p = products_1[_d];
-                                            if (Array.isArray(p.variants)) {
-                                                v = p.variants.find(function (vv) { return vv.id === line.merchandiseId; });
-                                                if (v) {
-                                                    foundVariant = v;
-                                                    break;
-                                                }
-                                            }
-                                        }
-                                        if (!foundVariant) {
-                                            this_2.logger.warn('Variant not found in product.list for pricing check', {
-                                                variantId: line.merchandiseId,
-                                                cartRegion: backendCart_1.region_id,
-                                            });
-                                            throw new errors_1.ProviderAPIError('Product or variant not found. Please refresh and try again.', 'medusa', 404);
-                                        }
-                                        console.log('Found Variant:', JSON.stringify(foundVariant, null, 2));
-                                        variant = foundVariant;
-                                        hasPriceForRegion = false;
-                                        if ((variant === null || variant === void 0 ? void 0 : variant.calculated_price) &&
-                                            ((_a = variant.calculated_price.calculated_amount) !== null && _a !== void 0 ? _a : null) !== null) {
-                                            calcCurrency = (variant.calculated_price.currency_code || '').toLowerCase();
-                                            cartCurrency = (backendCart_1.currency_code ||
-                                                this_2.currencyCode ||
-                                                '').toLowerCase();
-                                            console.log('calcCurrency =', calcCurrency);
-                                            console.log('cartCurrency =', cartCurrency);
-                                            console.log('this.currencyCode =', this_2.currencyCode);
-                                            if (!cartCurrency ||
-                                                calcCurrency === cartCurrency ||
-                                                calcCurrency === this_2.currencyCode.toLowerCase()) {
-                                                hasPriceForRegion = true;
-                                            }
-                                        }
-                                        if (!hasPriceForRegion) {
-                                            prices = (variant === null || variant === void 0 ? void 0 : variant.prices) || (variant === null || variant === void 0 ? void 0 : variant.money_amounts) || [];
-                                            hasPriceForRegion =
-                                                Array.isArray(prices) &&
-                                                    prices.some(function (p) {
-                                                        return (p.region_id === backendCart_1.region_id ||
-                                                            p.currency_code === backendCart_1.currency_code ||
-                                                            p.currency_code === _this.currencyCode ||
-                                                            p.currency === _this.currencyCode);
-                                                    });
-                                        }
-                                        if (!hasPriceForRegion) {
-                                            prices = (variant === null || variant === void 0 ? void 0 : variant.prices) || (variant === null || variant === void 0 ? void 0 : variant.money_amounts) || [];
-                                            this_2.logger.warn('Variant missing price for cart region (product.list)', {
-                                                variantId: line.merchandiseId,
-                                                cartRegion: backendCart_1.region_id,
-                                                prices: prices,
-                                            });
-                                            throw new errors_1.ProviderAPIError('This product does not have pricing configured for your selected region. Please try a different region or contact support.', 'medusa', 400);
-                                        }
-                                        return [3 /*break*/, 4];
-                                    case 3:
-                                        variantErr_1 = _e.sent();
-                                        this_2.logger.error('Variant price check failed', {
-                                            variantId: line.merchandiseId,
-                                            error: (0, errors_1.extractErrorMessage)(variantErr_1),
-                                        });
-                                        // Surface a clear error to avoid a 500 from backend when possible
-                                        throw new errors_1.ProviderAPIError('Unable to verify variant pricing before adding to cart. Please try again later.', 'medusa', 500);
-                                    case 4: return [4 /*yield*/, this_2.sdk.store.cart.createLineItem(cartId, {
-                                            variant_id: line.merchandiseId,
-                                            quantity: line.quantity,
-                                        })];
-                                    case 5:
-                                        result = _e.sent();
-                                        void result;
-                                        return [2 /*return*/];
-                                }
-                            });
-                        };
-                        this_2 = this;
-                        _i = 0, lines_1 = lines;
-                        _c.label = 3;
-                    case 3:
-                        if (!(_i < lines_1.length)) return [3 /*break*/, 6];
-                        line = lines_1[_i];
-                        return [5 /*yield**/, _loop_2(line)];
-                    case 4:
-                        _c.sent();
-                        _c.label = 5;
-                    case 5:
-                        _i++;
-                        return [3 /*break*/, 3];
-                    case 6: return [4 /*yield*/, this.retrieveCartWithLineDetails(cartId)];
-                    case 7:
-                        cart = _c.sent();
-                        return [2 /*return*/, (0, transforms_1.transformCart)(cart)];
-                    case 8:
-                        error_12 = _c.sent();
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_12);
-                        errorDetails = { cartId: cartId, lines: lines, message: errorMessage };
-                        if (typeof error_12 === 'object' && error_12 !== null) {
-                            err = error_12;
-                            if (err.status)
-                                errorDetails.status = err.status;
-                            if (err.statusCode)
-                                errorDetails.statusCode = err.statusCode;
-                            if (err.code)
-                                errorDetails.code = err.code;
-                            // If SDK exposes response body, include it for diagnostics
-                            if (err.response) {
-                                errorDetails.backendResponse = (_b = err.response.data) !== null && _b !== void 0 ? _b : err.response;
-                            }
-                            // Fallback: include entire error for logs
-                            try {
-                                errorDetails.fullError = JSON.stringify(err, Object.getOwnPropertyNames(err));
-                            }
-                            catch (e) {
-                                // ignore stringify errors
-                            }
-                        }
-                        this.logger.error('Failed to add to cart', errorDetails);
-                        status_2 = (error_12 === null || error_12 === void 0 ? void 0 : error_12.status) || (error_12 === null || error_12 === void 0 ? void 0 : error_12.statusCode);
-                        userMessage = errorMessage;
-                        if (status_2 === 500) {
-                            userMessage =
-                                'Unable to add product to cart. This product may not have pricing configured for your selected region. Please try selecting a different region or contact support.';
-                        }
-                        else if (status_2 === 404) {
-                            userMessage = 'Product or cart not found. Please refresh the page and try again.';
-                        }
-                        else if (status_2 === 400 || status_2 === 422) {
-                            userMessage = 'Invalid product configuration. This product may be unavailable.';
-                        }
-                        throw new errors_1.ProviderAPIError(userMessage, 'medusa', status_2);
-                    case 9: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    MedusaProvider.prototype.removeFromCart = function (cartId, lineIds) {
-        return __awaiter(this, void 0, void 0, function () {
-            var _i, lineIds_1, lineId, cart, error_13, errorMessage;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('removeFromCart', { cartId: cartId, lineIds: lineIds });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 7, , 8]);
-                        _i = 0, lineIds_1 = lineIds;
-                        _a.label = 2;
-                    case 2:
-                        if (!(_i < lineIds_1.length)) return [3 /*break*/, 5];
-                        lineId = lineIds_1[_i];
-                        return [4 /*yield*/, this.sdk.store.cart.deleteLineItem(cartId, lineId)];
-                    case 3:
-                        _a.sent();
-                        _a.label = 4;
-                    case 4:
-                        _i++;
-                        return [3 /*break*/, 2];
-                    case 5: return [4 /*yield*/, this.retrieveCartWithLineDetails(cartId)];
-                    case 6:
-                        cart = _a.sent();
-                        return [2 /*return*/, (0, transforms_1.transformCart)(cart)];
-                    case 7:
-                        error_13 = _a.sent();
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_13);
-                        this.logger.error('Failed to remove from cart', { cartId: cartId, lineIds: lineIds, error: errorMessage });
-                        throw new errors_1.ProviderAPIError("Failed to remove from cart: ".concat(errorMessage), 'medusa', (error_13 === null || error_13 === void 0 ? void 0 : error_13.status) || (error_13 === null || error_13 === void 0 ? void 0 : error_13.statusCode));
-                    case 8: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    MedusaProvider.prototype.updateCart = function (cartId, lines) {
-        return __awaiter(this, void 0, void 0, function () {
-            var _i, lines_2, line, cart, error_14, errorMessage;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('updateCart', { cartId: cartId, lines: lines });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 7, , 8]);
-                        _i = 0, lines_2 = lines;
-                        _a.label = 2;
-                    case 2:
-                        if (!(_i < lines_2.length)) return [3 /*break*/, 5];
-                        line = lines_2[_i];
-                        return [4 /*yield*/, this.sdk.store.cart.updateLineItem(cartId, line.id, {
-                                quantity: line.quantity,
-                            })];
-                    case 3:
-                        _a.sent();
-                        _a.label = 4;
-                    case 4:
-                        _i++;
-                        return [3 /*break*/, 2];
-                    case 5: return [4 /*yield*/, this.retrieveCartWithLineDetails(cartId)];
-                    case 6:
-                        cart = _a.sent();
-                        return [2 /*return*/, (0, transforms_1.transformCart)(cart)];
-                    case 7:
-                        error_14 = _a.sent();
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_14);
-                        this.logger.error('Failed to update cart', { cartId: cartId, error: errorMessage });
-                        throw new errors_1.ProviderAPIError("Failed to update cart: ".concat(errorMessage), 'medusa', (error_14 === null || error_14 === void 0 ? void 0 : error_14.status) || (error_14 === null || error_14 === void 0 ? void 0 : error_14.statusCode));
-                    case 8: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Get available regions from Medusa
-     * Returns region information including id, name, and currency
-     */
-    MedusaProvider.prototype.getRegions = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            var regions, error_15, errorMessage;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('getRegions');
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.sdk.store.region.list()];
-                    case 2:
-                        regions = (_a.sent()).regions;
-                        return [2 /*return*/, regions.map(function (region) { return ({
-                                id: region.id,
-                                name: region.name,
-                                currency_code: region.currency_code,
-                                countries: region.countries,
-                            }); })];
-                    case 3:
-                        error_15 = _a.sent();
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_15);
-                        this.logger.error('Failed to fetch regions', { error: errorMessage });
-                        throw new errors_1.ProviderAPIError("Failed to fetch regions: ".concat(errorMessage), 'medusa', (error_15 === null || error_15 === void 0 ? void 0 : error_15.status) || (error_15 === null || error_15 === void 0 ? void 0 : error_15.statusCode));
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    // ============================================
-    // Payment Operations
-    // ============================================
-    // ============================================
-    // Order Operations
-    // ============================================
-    /**
-     * Get all orders for a customer (storefront).
-     *
-     * Note: This retrieves orders from the storefront API (store.order.list),
-     * which returns orders only for the authenticated customer in the JWT.
-     *
-     * @param options - Order query options (supports callbacks for custom backends)
-     * @returns Array of orders for the authenticated customer
-     *
-     * @example
-     * ```typescript
-     * const orders = await provider.getOrders();
-     * console.log(`Found ${orders.length} orders`);
-     * ```
-     */
-    MedusaProvider.prototype.getOrders = function () {
-        return __awaiter(this, arguments, void 0, function (options) {
-            var customFetcher, salesChannelId, result, orders, transformed, channelId, scoped, error_16, status_3, errorMessage;
-            var _this = this;
-            var _a;
-            if (options === void 0) { options = {}; }
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        customFetcher = options.customFetcher, salesChannelId = options.salesChannelId;
-                        // If custom fetcher provided, use it instead of default SDK logic
-                        if (customFetcher) {
-                            this.logger.debug('Using custom fetcher for orders');
-                            return [2 /*return*/, customFetcher(options)];
-                        }
-                        this.logger.info('Getting orders for authenticated customer');
-                        _b.label = 1;
-                    case 1:
-                        _b.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                return __generator(this, function (_a) {
-                                    return [2 /*return*/, this.sdk.store.order.list({
-                                            // Medusa v2 JS-SDK automatically includes authorization header if JWT is present
-                                            fields: '+items,+items.variant,+items.variant.product,+shipping_address,+billing_address,+customer',
-                                        })];
-                                });
-                            }); }, 'getOrders', {})];
-                    case 2:
-                        result = _b.sent();
-                        orders = (_a = result.orders) !== null && _a !== void 0 ? _a : [];
-                        this.logger.debug("Found ".concat(orders.length, " orders for customer"));
-                        transformed = orders.map(function (order) { return (0, transforms_1.transformOrder)(order); });
-                        channelId = salesChannelId !== null && salesChannelId !== void 0 ? salesChannelId : process.env.NEXT_PUBLIC_SALES_CHANNEL_ID;
-                        if (channelId) {
-                            scoped = (0, metadata_1.filterByChannel)(transformed, channelId);
-                            this.logger.debug("Channel scoping: ".concat(scoped.length, "/").concat(transformed.length, " orders match channel ").concat(channelId));
-                            return [2 /*return*/, scoped];
-                        }
-                        return [2 /*return*/, transformed];
-                    case 3:
-                        error_16 = _b.sent();
-                        status_3 = (error_16 === null || error_16 === void 0 ? void 0 : error_16.status) || (error_16 === null || error_16 === void 0 ? void 0 : error_16.statusCode);
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_16);
-                        this.logger.error('Error getting orders', { error: errorMessage });
-                        throw new errors_1.ProviderAPIError("Failed to fetch orders: ".concat(errorMessage), 'medusa', status_3);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Get a single order by ID
-     *
-     * @param orderId - Order ID
-     * @returns Order or undefined if not found
-     *
-     * @example
-     * ```typescript
-     * const order = await provider.getOrder('order_123');
-     * if (order) {
-     *   console.log(`Order ${order.orderNumber} - ${order.status}`);
-     * }
-     * ```
-     */
-    MedusaProvider.prototype.getOrder = function (orderId) {
-        return __awaiter(this, void 0, void 0, function () {
-            var order, error_17, status_4, errorMessage;
-            var _this = this;
-            var _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        this.logger.info('Getting order', orderId);
-                        if (!orderId) {
-                            throw new errors_1.ProviderAPIError('Order ID is required', 'medusa');
-                        }
-                        _b.label = 1;
-                    case 1:
-                        _b.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                return __generator(this, function (_a) {
-                                    return [2 /*return*/, this.sdk.store.order.retrieve(orderId, {
-                                            fields: '+items,+items.variant,+items.variant.product,+shipping_address,+billing_address,+customer',
-                                        })];
-                                });
-                            }); }, 'getOrder', { orderId: orderId })];
-                    case 2:
-                        order = (_b.sent()).order;
-                        if (!order) {
-                            this.logger.debug("Order not found: ".concat(orderId));
-                            return [2 /*return*/, undefined];
-                        }
-                        this.logger.debug("Retrieved order: ".concat((_a = order.display_id) !== null && _a !== void 0 ? _a : orderId));
-                        return [2 /*return*/, (0, transforms_1.transformOrder)(order)];
-                    case 3:
-                        error_17 = _b.sent();
-                        status_4 = (error_17 === null || error_17 === void 0 ? void 0 : error_17.status) || (error_17 === null || error_17 === void 0 ? void 0 : error_17.statusCode);
-                        if (status_4 === 404) {
-                            this.logger.debug("Order not found: ".concat(orderId));
-                            return [2 /*return*/, undefined];
-                        }
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_17);
-                        this.logger.error('Failed to fetch order', { orderId: orderId, error: errorMessage });
-                        throw new errors_1.ProviderAPIError("Failed to fetch order: ".concat(errorMessage), 'medusa', status_4);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    // ============================================
-    // Customer Operations
-    // ============================================
-    /**
-     * List customers with optional filtering and pagination.
-     *
-     * Uses the Medusa admin API — requires admin-level JWT.
-     *
-     * @param options - Query options (search, sort, pagination)
-     * @returns Array of customers
-     *
-     * @example
-     * ```typescript
-     * const customers = await provider.getCustomers({ search: 'john', limit: 20, offset: 0 });
-     * ```
-     */
-    MedusaProvider.prototype.getCustomers = function () {
-        return __awaiter(this, arguments, void 0, function (options) {
-            var search, _a, limit, _b, offset, _c, sortBy, salesChannelId, customFetcher, orderMap, filters_1, result, customers, transformed, error_18, status_5, errorMessage;
-            var _this = this;
-            var _d;
-            if (options === void 0) { options = {}; }
-            return __generator(this, function (_e) {
-                switch (_e.label) {
-                    case 0:
-                        this.logger.info('Getting customers', options);
-                        search = options.search, _a = options.limit, limit = _a === void 0 ? 20 : _a, _b = options.offset, offset = _b === void 0 ? 0 : _b, _c = options.sortBy, sortBy = _c === void 0 ? 'createdAt' : _c, salesChannelId = options.salesChannelId, customFetcher = options.customFetcher;
-                        // If custom fetcher provided, use it instead of default SDK logic
-                        if (customFetcher) {
-                            this.logger.debug('Using custom fetcher for customers');
-                            return [2 /*return*/, customFetcher(options)];
-                        }
-                        orderMap = {
-                            createdAt: 'created_at',
-                            email: 'email',
-                            firstName: 'first_name',
-                        };
-                        _e.label = 1;
-                    case 1:
-                        _e.trys.push([1, 3, , 4]);
-                        filters_1 = {};
-                        if (salesChannelId) {
-                            filters_1.metadata = { sales_channel_id: salesChannelId };
-                            this.logger.debug("Filtering customers by salesChannelId: ".concat(salesChannelId));
-                        }
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                var _a;
-                                return __generator(this, function (_b) {
-                                    return [2 /*return*/, this.sdk.admin.customer.list(__assign({ q: search || undefined, limit: limit, offset: offset, order: (_a = orderMap[sortBy]) !== null && _a !== void 0 ? _a : 'created_at' }, (Object.keys(filters_1).length > 0 && { filters: filters_1 })))];
-                                });
-                            }); }, 'getCustomers', { search: search, limit: limit, offset: offset, salesChannelId: salesChannelId })];
-                    case 2:
-                        result = _e.sent();
-                        customers = (_d = result === null || result === void 0 ? void 0 : result.customers) !== null && _d !== void 0 ? _d : [];
-                        this.logger.debug("Found ".concat(customers.length, " customers"));
-                        transformed = customers.map(function (c) { return (0, transforms_1.transformCustomer)(c); });
-                        return [2 /*return*/, transformed];
-                    case 3:
-                        error_18 = _e.sent();
-                        status_5 = (error_18 === null || error_18 === void 0 ? void 0 : error_18.status) || (error_18 === null || error_18 === void 0 ? void 0 : error_18.statusCode);
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_18);
-                        this.logger.error('Error getting customers', { error: errorMessage });
-                        throw new errors_1.ProviderAPIError("Failed to fetch customers: ".concat(errorMessage), 'medusa', status_5);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Get a single customer by ID.
-     *
-     * Uses the Medusa admin API.
-     *
-     * @param customerId - Customer ID
-     * @returns Customer or undefined if not found
-     */
-    MedusaProvider.prototype.getCustomer = function (customerId) {
-        return __awaiter(this, void 0, void 0, function () {
-            var result, error_19, status_6, errorMessage;
-            var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.info('Getting customer', customerId);
-                        if (!customerId) {
-                            throw new errors_1.ProviderAPIError('Customer ID is required', 'medusa');
-                        }
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
-                                return [2 /*return*/, this.sdk.admin.customer.retrieve(customerId)];
-                            }); }); }, 'getCustomer', { customerId: customerId })];
-                    case 2:
-                        result = _a.sent();
-                        if (!(result === null || result === void 0 ? void 0 : result.customer)) {
-                            return [2 /*return*/, undefined];
-                        }
-                        return [2 /*return*/, (0, transforms_1.transformCustomer)(result.customer)];
-                    case 3:
-                        error_19 = _a.sent();
-                        status_6 = (error_19 === null || error_19 === void 0 ? void 0 : error_19.status) || (error_19 === null || error_19 === void 0 ? void 0 : error_19.statusCode);
-                        if (status_6 === 404)
-                            return [2 /*return*/, undefined];
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_19);
-                        this.logger.error('Failed to fetch customer', { customerId: customerId, error: errorMessage });
-                        throw new errors_1.ProviderAPIError("Failed to fetch customer: ".concat(errorMessage), 'medusa', status_6);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Update customer information.
-     *
-     * Uses the Medusa admin API.
-     *
-     * @param customerId - Customer ID
-     * @param data - Fields to update
-     * @returns Updated customer
-     */
-    MedusaProvider.prototype.updateCustomer = function (customerId, data) {
-        return __awaiter(this, void 0, void 0, function () {
-            var payload, result, error_20, status_7, errorMessage;
-            var _this = this;
-            var _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        this.logger.info('Updating customer', { customerId: customerId, fields: Object.keys(data) });
-                        if (!customerId) {
-                            throw new errors_1.ProviderAPIError('Customer ID is required', 'medusa');
-                        }
-                        payload = {};
-                        if (data.firstName !== undefined)
-                            payload.first_name = data.firstName;
-                        if (data.lastName !== undefined)
-                            payload.last_name = data.lastName;
-                        if (data.phone !== undefined)
-                            payload.phone = (_a = data.phone) !== null && _a !== void 0 ? _a : null;
-                        if (data.email !== undefined)
-                            payload.email = data.email;
-                        if (data.metadata !== undefined)
-                            payload.metadata = data.metadata;
-                        _b.label = 1;
-                    case 1:
-                        _b.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
-                                return [2 /*return*/, this.sdk.admin.customer.update(customerId, payload)];
-                            }); }); }, 'updateCustomer', { customerId: customerId })];
-                    case 2:
-                        result = _b.sent();
-                        return [2 /*return*/, (0, transforms_1.transformCustomer)(result.customer)];
-                    case 3:
-                        error_20 = _b.sent();
-                        status_7 = (error_20 === null || error_20 === void 0 ? void 0 : error_20.status) || (error_20 === null || error_20 === void 0 ? void 0 : error_20.statusCode);
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_20);
-                        this.logger.error('Failed to update customer', { customerId: customerId, error: errorMessage });
-                        throw new errors_1.ProviderAPIError("Failed to update customer: ".concat(errorMessage), 'medusa', status_7);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Get orders placed by a specific customer (admin view).
-     *
-     * @param customerId - Customer ID
-     * @param limit - Max number of orders (default: 10)
-     * @returns Array of orders
-     */
-    MedusaProvider.prototype.getCustomerOrders = function (customerId_1) {
-        return __awaiter(this, arguments, void 0, function (customerId, limit) {
-            var result, orders, transformed, channelId, scoped, error_21, status_8, errorMessage;
-            var _this = this;
-            var _a;
-            if (limit === void 0) { limit = 10; }
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        this.logger.info('Getting orders for customer (admin)', { customerId: customerId, limit: limit });
-                        if (!customerId) {
-                            throw new errors_1.ProviderAPIError('Customer ID is required', 'medusa');
-                        }
-                        _b.label = 1;
-                    case 1:
-                        _b.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                return __generator(this, function (_a) {
-                                    return [2 /*return*/, this.sdk.admin.order.list({
-                                            customer_id: customerId,
-                                            limit: limit,
-                                            order: '-created_at',
-                                            fields: '+items,+items.variant,+items.variant.product,+shipping_address',
-                                        })];
-                                });
-                            }); }, 'getCustomerOrders', { customerId: customerId })];
-                    case 2:
-                        result = _b.sent();
-                        orders = (_a = result === null || result === void 0 ? void 0 : result.orders) !== null && _a !== void 0 ? _a : [];
-                        this.logger.debug("Found ".concat(orders.length, " orders for customer ").concat(customerId));
-                        transformed = orders.map(function (o) { return (0, transforms_1.transformOrder)(o); });
-                        channelId = process.env.NEXT_PUBLIC_SALES_CHANNEL_ID;
-                        if (channelId) {
-                            scoped = (0, metadata_1.filterByChannel)(transformed, channelId);
-                            this.logger.debug("Channel scoping: ".concat(scoped.length, "/").concat(transformed.length, " orders match channel ").concat(channelId));
-                            return [2 /*return*/, scoped];
-                        }
-                        return [2 /*return*/, transformed];
-                    case 3:
-                        error_21 = _b.sent();
-                        status_8 = (error_21 === null || error_21 === void 0 ? void 0 : error_21.status) || (error_21 === null || error_21 === void 0 ? void 0 : error_21.statusCode);
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_21);
-                        this.logger.error('Failed to fetch customer orders', { customerId: customerId, error: errorMessage });
-                        throw new errors_1.ProviderAPIError("Failed to fetch customer orders: ".concat(errorMessage), 'medusa', status_8);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    // ============================================
-    // Channel Scope Operations (Multi-Tenant)
-    // ============================================
-    /**
-     * Assign a customer to a sales channel via metadata.
-     *
-     * This is the primary mechanism for multi-tenant isolation of entities
-     * that the backend does not natively scope to a sales channel
-     * (e.g. customers in Medusa).
-     *
-     * Writes `sales_channel_id` + audit fields into `customer.metadata`.
-     * After assignment, `getCustomers({ salesChannelId })` will include
-     * this customer in its results.
-     *
-     * @param customerId  - Customer to assign
-     * @param channelId   - Target sales channel
-     * @param assignedBy  - Optional: who triggered the assignment
-     * @returns Updated customer with new metadata
-     *
-     * @example
-     * ```typescript
-     * // Dropshipper creates customer → assign to their channel
-     * const customer = await commerce.assignCustomerToChannel(
-     *   'cus_01HXXX',
-     *   process.env.NEXT_PUBLIC_SALES_CHANNEL_ID!,
-     *   'admin@mystore.com',
-     * );
-     * ```
-     */
-    MedusaProvider.prototype.assignCustomerToChannel = function (customerId, channelId, assignedBy) {
-        return __awaiter(this, void 0, void 0, function () {
-            var existing, currentMeta, scopeMeta;
-            var _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        (0, metadata_1.validateChannelScopeAssignment)(customerId, channelId, assignedBy);
-                        this.logger.info('Assigning customer to channel', { customerId: customerId, channelId: channelId, assignedBy: assignedBy });
-                        return [4 /*yield*/, this.getCustomer(customerId)];
-                    case 1:
-                        existing = _b.sent();
-                        currentMeta = (_a = existing === null || existing === void 0 ? void 0 : existing.metadata) !== null && _a !== void 0 ? _a : {};
-                        scopeMeta = (0, metadata_1.buildChannelScopeMetadata)(channelId, assignedBy);
-                        return [2 /*return*/, this.updateCustomer(customerId, {
-                                metadata: __assign(__assign({}, currentMeta), scopeMeta),
-                            })];
-                }
-            });
-        });
-    };
-    /**
-     * Assign an order to a sales channel via metadata.
-     *
-     * Same pattern as `assignCustomerToChannel` but for orders.
-     * Useful when orders are created through flows that don't automatically
-     * link them to a channel.
-     *
-     * @param orderId    - Order to assign
-     * @param channelId  - Target sales channel
-     * @param assignedBy - Optional: who triggered the assignment
-     */
-    MedusaProvider.prototype.assignOrderToChannel = function (orderId, channelId, assignedBy) {
-        return __awaiter(this, void 0, void 0, function () {
-            var scopeMeta, error_22, status_9, errorMessage;
-            var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        (0, metadata_1.validateChannelScopeAssignment)(orderId, channelId, assignedBy);
-                        this.logger.info('Assigning order to channel', { orderId: orderId, channelId: channelId, assignedBy: assignedBy });
-                        scopeMeta = (0, metadata_1.buildChannelScopeMetadata)(channelId, assignedBy);
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                return __generator(this, function (_a) {
-                                    return [2 /*return*/, this.sdk.admin.order.update(orderId, {
-                                            metadata: scopeMeta,
-                                        })];
-                                });
-                            }); }, 'assignOrderToChannel', { orderId: orderId, channelId: channelId })];
-                    case 2:
-                        _a.sent();
-                        return [3 /*break*/, 4];
-                    case 3:
-                        error_22 = _a.sent();
-                        status_9 = (error_22 === null || error_22 === void 0 ? void 0 : error_22.status) || (error_22 === null || error_22 === void 0 ? void 0 : error_22.statusCode);
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_22);
-                        this.logger.error('Failed to assign order to channel', { orderId: orderId, channelId: channelId, error: errorMessage });
-                        throw new errors_1.ProviderAPIError("Failed to assign order to channel: ".concat(errorMessage), 'medusa', status_9);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    // ============================================
-    // Payment Operations
-    // ============================================
-    /**
-     * Get available payment methods
-     *
-     * Queries Medusa for payment providers available in a specific region.
-     * Region is determined either from options.regionId or from the cart.
-     *
-     * @param options - Payment methods query options (regionId or cartId required)
-     * @returns Array of available payment methods
-     *
-     * @example
-     * ```typescript
-     * // Get payment methods for a region
-     * const methods = await provider.getPaymentMethods({
-     *   regionId: 'reg_123',
-     *   enabledOnly: true
-     * });
-     *
-     * // Get payment methods for a cart
-     * const methods = await provider.getPaymentMethods({
-     *   cartId: 'cart_123'
-     * });
-     * ```
-     */
-    MedusaProvider.prototype.getPaymentMethods = function (options) {
-        return __awaiter(this, void 0, void 0, function () {
-            var methods, error_23;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.info('Getting payment methods', options);
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, (0, payment_1.getPaymentMethods)(this.sdk, options)];
-                    case 2:
-                        methods = _a.sent();
-                        this.logger.debug("Found ".concat(methods.length, " payment methods"));
-                        return [2 /*return*/, methods];
-                    case 3:
-                        error_23 = _a.sent();
-                        this.logger.error('Error getting payment methods', error_23);
-                        throw error_23; // Re-throw as it's already wrapped by getPaymentMethods
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    // ============================================
-    // Checkout Operations
-    // ============================================
-    /**
-     * Complete checkout and create order from cart
-     *
-     * Finalizes the checkout process and converts the cart into an order.
-     * Cart must have shipping address, shipping method, and payment session.
-     *
-     * @param cartId - Cart ID to checkout
-     * @returns Created order
-     * @throws {ProviderAPIError} If checkout fails
-     */
-    MedusaProvider.prototype.completeCheckout = function (cartId) {
-        return __awaiter(this, void 0, void 0, function () {
-            var error_24;
-            var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('completeCheckout', { cartId: cartId });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                var order;
-                                return __generator(this, function (_a) {
-                                    switch (_a.label) {
-                                        case 0: return [4 /*yield*/, this.sdk.store.cart.complete(cartId)];
-                                        case 1:
-                                            order = (_a.sent()).order;
-                                            if (!order) {
-                                                throw new errors_1.ProviderAPIError('Checkout completed but no order returned', 'medusa', 500);
-                                            }
-                                            this.logger.info('Checkout completed successfully', {
-                                                orderId: order.id,
-                                                displayId: order.display_id,
-                                            });
-                                            return [2 /*return*/, (0, transforms_1.transformOrder)(order)];
-                                    }
-                                });
-                            }); }, 'completeCheckout', { cartId: cartId })];
-                    case 2: return [2 /*return*/, _a.sent()];
-                    case 3:
-                        error_24 = _a.sent();
-                        this.logger.error('Failed to complete checkout', { cartId: cartId, error: error_24.message });
-                        throw new errors_1.ProviderAPIError("Failed to complete checkout: ".concat(error_24.message), 'medusa', error_24.status);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Get available shipping methods for cart
-     *
-     * Fetches shipping options based on cart region and shipping address.
-     *
-     * @param cartId - Cart ID
-     * @returns List of shipping methods with prices
-     * @throws {ProviderAPIError} If cart not found or region not configured
-     */
-    MedusaProvider.prototype.getShippingMethods = function (cartId) {
-        return __awaiter(this, void 0, void 0, function () {
-            var error_25;
-            var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.info('🚚 [DEBUG] getShippingMethods called', { cartId: cartId });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                var cartResponse, cart, shippingResponse, shipping_options, storeAny, baseUrl, url, response, sdkError_1, methods;
-                                var _this = this;
-                                var _a, _b;
-                                return __generator(this, function (_c) {
-                                    switch (_c.label) {
-                                        case 0:
-                                            // Get raw cart to access region
-                                            this.logger.info('🚚 [DEBUG] Step 1: Retrieving cart from Medusa...', { cartId: cartId });
-                                            return [4 /*yield*/, this.sdk.store.cart.retrieve(cartId)];
-                                        case 1:
-                                            cartResponse = (_c.sent());
-                                            cart = cartResponse.cart;
-                                            // Log raw cart response for debugging
-                                            this.logger.info('🚚 [DEBUG] Step 2: Cart retrieved from backend', {
-                                                cartId: cartId,
-                                                hasCart: !!cart,
-                                                cartKeys: cart ? Object.keys(cart) : [],
-                                                regionId: cart === null || cart === void 0 ? void 0 : cart.region_id,
-                                                currencyCode: cart === null || cart === void 0 ? void 0 : cart.currency_code,
-                                                shippingAddress: (cart === null || cart === void 0 ? void 0 : cart.shipping_address)
-                                                    ? {
-                                                        country: cart.shipping_address.country_code,
-                                                        postal: cart.shipping_address.postal_code,
-                                                    }
-                                                    : null,
-                                            });
-                                            if (!cart) {
-                                                this.logger.error('🚚 [DEBUG] ERROR: Cart not found in response', {
-                                                    cartId: cartId,
-                                                    cartResponse: cartResponse,
-                                                });
-                                                throw new errors_1.ResourceNotFoundError('Cart', cartId);
-                                            }
-                                            if (!cart.region_id) {
-                                                this.logger.error('🚚 [DEBUG] ERROR: Cart has no region_id', {
-                                                    cartId: cartId,
-                                                    cart: {
-                                                        id: cart.id,
-                                                        region_id: cart.region_id,
-                                                        region: cart.region,
-                                                        allKeys: Object.keys(cart),
-                                                    },
-                                                });
-                                                throw new errors_1.ProviderAPIError('Cart has no region assigned', 'medusa', 400);
-                                            }
-                                            // Fetch shipping options for cart
-                                            // Medusa v2 endpoint: GET /store/shipping-options?cart_id=...
-                                            this.logger.info('🚚 [DEBUG] Step 3: Fetching shipping options from Medusa...', {
-                                                cartId: cartId,
-                                                regionId: cart.region_id,
-                                                endpoint: "".concat(this.baseUrl, "store/shipping-options?cart_id=").concat(cartId),
-                                                note: 'About to fetch shipping options (SDK when available, otherwise HTTP)',
-                                            });
-                                            _c.label = 2;
-                                        case 2:
-                                            _c.trys.push([2, 8, , 9]);
-                                            storeAny = this.sdk.store;
-                                            if (!((_a = storeAny === null || storeAny === void 0 ? void 0 : storeAny.shippingOption) === null || _a === void 0 ? void 0 : _a.list)) return [3 /*break*/, 4];
-                                            return [4 /*yield*/, storeAny.shippingOption.list({
-                                                    cart_id: cartId,
-                                                })];
-                                        case 3:
-                                            shippingResponse = (_c.sent());
-                                            return [3 /*break*/, 7];
-                                        case 4:
-                                            baseUrl = this.baseUrl.endsWith('/') ? this.baseUrl : "".concat(this.baseUrl, "/");
-                                            url = new URL('store/shipping-options', baseUrl);
-                                            url.searchParams.set('cart_id', cartId);
-                                            return [4 /*yield*/, (0, fetch_utils_1.fetchWithRetry)(url.toString(), {
-                                                    method: 'GET',
-                                                    headers: {
-                                                        'x-publishable-api-key': this.publishableKey,
-                                                        'content-type': 'application/json',
-                                                    },
-                                                }, this.retryConfig)];
-                                        case 5:
-                                            response = _c.sent();
-                                            return [4 /*yield*/, response.json()];
-                                        case 6:
-                                            shippingResponse = (_c.sent());
-                                            _c.label = 7;
-                                        case 7:
-                                            shipping_options = shippingResponse.shipping_options;
-                                            return [3 /*break*/, 9];
-                                        case 8:
-                                            sdkError_1 = _c.sent();
-                                            // Log detailed error from Medusa backend
-                                            this.logger.error('🚚 [DEBUG] ERROR: Medusa SDK threw error when fetching shipping options', {
-                                                cartId: cartId,
-                                                regionId: cart.region_id,
-                                                errorType: (_b = sdkError_1 === null || sdkError_1 === void 0 ? void 0 : sdkError_1.constructor) === null || _b === void 0 ? void 0 : _b.name,
-                                                errorMessage: sdkError_1 === null || sdkError_1 === void 0 ? void 0 : sdkError_1.message,
-                                                errorStatus: sdkError_1 === null || sdkError_1 === void 0 ? void 0 : sdkError_1.status,
-                                                errorCode: sdkError_1 === null || sdkError_1 === void 0 ? void 0 : sdkError_1.code,
-                                                errorResponse: (sdkError_1 === null || sdkError_1 === void 0 ? void 0 : sdkError_1.response)
-                                                    ? JSON.stringify(sdkError_1.response, null, 2)
-                                                    : 'N/A',
-                                                errorBody: (sdkError_1 === null || sdkError_1 === void 0 ? void 0 : sdkError_1.body) ? JSON.stringify(sdkError_1.body, null, 2) : 'N/A',
-                                                fullError: JSON.stringify(sdkError_1, Object.getOwnPropertyNames(sdkError_1), 2),
-                                            });
-                                            throw sdkError_1;
-                                        case 9:
-                                            // Log raw shipping options response
-                                            this.logger.info('🚚 [DEBUG] Step 4: Shipping options received from backend', {
-                                                cartId: cartId,
-                                                totalOptions: (shipping_options === null || shipping_options === void 0 ? void 0 : shipping_options.length) || 0,
-                                                rawResponse: JSON.stringify(shippingResponse, null, 2),
-                                                firstOption: (shipping_options === null || shipping_options === void 0 ? void 0 : shipping_options[0])
-                                                    ? {
-                                                        id: shipping_options[0].id,
-                                                        name: shipping_options[0].name,
-                                                        allKeys: Object.keys(shipping_options[0]),
-                                                        price_incl_tax: shipping_options[0].price_incl_tax,
-                                                        amount: shipping_options[0].amount,
-                                                        data: shipping_options[0].data,
-                                                    }
-                                                    : null,
-                                            });
-                                            methods = shipping_options.map(function (option) {
-                                                var _a, _b, _c, _d, _e;
-                                                return ({
-                                                    id: option.id,
-                                                    name: option.name,
-                                                    price: {
-                                                        amount: ((_a = option.price_incl_tax) === null || _a === void 0 ? void 0 : _a.toString()) || ((_b = option.amount) === null || _b === void 0 ? void 0 : _b.toString()) || '0',
-                                                        currencyCode: ((_c = cart.currency_code) === null || _c === void 0 ? void 0 : _c.toUpperCase()) || _this.currencyCode,
-                                                    },
-                                                    description: (_d = option.data) === null || _d === void 0 ? void 0 : _d.description,
-                                                    estimatedDays: ((_e = option.data) === null || _e === void 0 ? void 0 : _e.estimated_days) || 'N/A',
-                                                });
-                                            });
-                                            // Log transformed methods
-                                            this.logger.info('🚚 [DEBUG] Step 5: Transformed methods for Thor types', {
-                                                cartId: cartId,
-                                                count: methods.length,
-                                                methods: JSON.stringify(methods, null, 2),
-                                            });
-                                            return [2 /*return*/, methods];
-                                    }
-                                });
-                            }); }, 'getShippingMethods', { cartId: cartId })];
-                    case 2: return [2 /*return*/, _a.sent()];
-                    case 3:
-                        error_25 = _a.sent();
-                        this.logger.error('🚚 [DEBUG] ERROR: Failed to fetch shipping methods', {
-                            cartId: cartId,
-                            errorMessage: error_25.message,
-                            errorStack: error_25.stack,
-                            errorStatus: error_25.status,
-                        });
-                        throw new errors_1.ProviderAPIError("Failed to fetch shipping methods: ".concat(error_25.message), 'medusa', error_25.status);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    // ============================================
-    // Inventory Operations (Admin-only via Proxy)
-    // ============================================
-    /**
-     * Fetch stock locations, optionally filtered by sales channel.
-     *
-     * Note: Medusa Store API does NOT expose stock locations. This requires Admin API access.
-     * Implement in L5 (starter) using a secure proxy (Server Actions).
-     */
-    MedusaProvider.prototype.getStockLocations = function (params) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                void params;
-                throw new Error('MedusaProvider.getStockLocations requires Admin API access. ' +
-                    'Call it via the B2C inventory proxy (Server Actions) instead.');
-            });
-        });
-    };
-    /**
-     * Check inventory levels for a variant across locations.
-     *
-     * Note: Admin API only. Implement in L5 (starter) proxy.
-     */
-    MedusaProvider.prototype.checkInventoryLevels = function (variantId, salesChannelId) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                void variantId;
-                void salesChannelId;
-                throw new Error('MedusaProvider.checkInventoryLevels requires Admin API access. ' +
-                    'Call it via the B2C inventory proxy (Server Actions) instead.');
-            });
-        });
-    };
-    /**
-     * Validate cart stock availability.
-     *
-     * Note: Multi-location inventory validation requires Admin API.
-     * Use L5 proxy for real validation.
-     */
-    MedusaProvider.prototype.validateCartStock = function (cartId) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                void cartId;
-                throw new Error('MedusaProvider.validateCartStock requires Admin API access. ' +
-                    'Use validateCartInventory() in the starter inventory proxy instead.');
-            });
-        });
-    };
-    /**
-     * Get fulfillment options enriched with stock location data.
-     *
-     * Note: This requires fulfillment planning + Admin inventory. Implement in L5.
-     */
-    MedusaProvider.prototype.getFulfillmentOptions = function (cartId, salesChannelId) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                void cartId;
-                void salesChannelId;
-                throw new Error('MedusaProvider.getFulfillmentOptions is not available via Store API. ' +
-                    'Implement in the starter using the fulfillment planner + admin proxy.');
-            });
-        });
-    };
-    /**
-     * Get available countries for a region
-     *
-     * Returns list of countries that can be used for shipping addresses
-     * in the specified region. Results are cached for 5 minutes.
-     *
-     * @param regionId - Region ID
-     * @returns Array of countries with codes and names
-     * @throws {ProviderAPIError} If region not found or API error
-     *
-     * @example
-     * ```typescript
-     * const countries = await medusa.getRegionCountries('reg_01KHCJQ5YXYRWWCKSTYQ4SCM8V');
-     * // [{ code: 'ES', name: 'Spain' }, { code: 'FR', name: 'France' }, ...]
-     * ```
-     */
-    MedusaProvider.prototype.getRegionCountries = function (regionId) {
-        return __awaiter(this, void 0, void 0, function () {
-            var cached, now, error_26;
-            var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.info('🌍 [DEBUG] getRegionCountries called', { regionId: regionId });
-                        cached = this.regionCountriesCache.get(regionId);
-                        now = Date.now();
-                        if (cached && cached.expiresAt > now) {
-                            this.logger.info('🌍 [DEBUG] Returning cached countries', {
-                                regionId: regionId,
-                                count: cached.countries.length,
-                                cacheAge: Math.round((now - (cached.expiresAt - this.REGION_COUNTRIES_CACHE_TTL)) / 1000) + 's',
-                            });
-                            return [2 /*return*/, cached.countries];
-                        }
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                var region, countries;
-                                var _a;
-                                return __generator(this, function (_b) {
-                                    switch (_b.label) {
-                                        case 0:
-                                            this.logger.info('🌍 [DEBUG] Fetching countries from Medusa API...', { regionId: regionId });
-                                            return [4 /*yield*/, this.sdk.store.region.retrieve(regionId, {
-                                                    fields: '+countries.iso_2,+countries.display_name,+countries.name,+countries.iso_3,+countries.num_code',
-                                                })];
-                                        case 1:
-                                            region = (_b.sent()).region;
-                                            if (!region) {
-                                                throw new errors_1.ResourceNotFoundError('Region', regionId);
-                                            }
-                                            this.logger.info('🌍 [DEBUG] Region retrieved', {
-                                                regionId: regionId,
-                                                regionName: region.name,
-                                                hasCountries: !!region.countries,
-                                                countriesCount: ((_a = region.countries) === null || _a === void 0 ? void 0 : _a.length) || 0,
-                                            });
-                                            countries = (region.countries || []).map(function (c) { return ({
-                                                code: c.iso_2.toUpperCase(), // Frontend expects uppercase for validation
-                                                name: c.display_name || c.name,
-                                                iso3: c.iso_3,
-                                                numCode: c.num_code,
-                                            }); });
-                                            // Sort by name for better UX
-                                            countries.sort(function (a, b) { return a.name.localeCompare(b.name); });
-                                            this.logger.info('🌍 [DEBUG] Countries transformed and sorted', {
-                                                regionId: regionId,
-                                                count: countries.length,
-                                                firstThree: countries.slice(0, 3).map(function (c) { return "".concat(c.code, ": ").concat(c.name); }),
-                                            });
-                                            // Cache the result
-                                            this.regionCountriesCache.set(regionId, {
-                                                countries: countries,
-                                                expiresAt: now + this.REGION_COUNTRIES_CACHE_TTL,
-                                            });
-                                            return [2 /*return*/, countries];
-                                    }
-                                });
-                            }); }, 'getRegionCountries', { regionId: regionId })];
-                    case 2: return [2 /*return*/, _a.sent()];
-                    case 3:
-                        error_26 = _a.sent();
-                        this.logger.error('🌍 [DEBUG] ERROR: Failed to fetch region countries', {
-                            regionId: regionId,
-                            errorMessage: error_26.message,
-                            errorStatus: error_26.status,
-                        });
-                        // Provide helpful error messages
-                        if (error_26.status === 404) {
-                            throw new errors_1.ResourceNotFoundError('Region', regionId);
-                        }
-                        throw new errors_1.ProviderAPIError("Failed to fetch countries for region: ".concat(error_26.message), 'medusa', error_26.status);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Add shipping method to cart
-     *
-     * Applies a shipping method to the cart and updates totals.
-     *
-     * @param cartId - Cart ID
-     * @param methodId - Shipping method ID (from getShippingMethods)
-     * @returns Updated cart with shipping
-     * @throws {ProviderAPIError} If method invalid or cart not ready
-     */
-    MedusaProvider.prototype.addShippingMethod = function (cartId, methodId) {
-        return __awaiter(this, void 0, void 0, function () {
-            var error_27;
-            var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('addShippingMethod', { cartId: cartId, methodId: methodId });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                var cart, updatedCart;
-                                return __generator(this, function (_a) {
-                                    switch (_a.label) {
-                                        case 0: return [4 /*yield*/, this.sdk.store.cart.addShippingMethod(cartId, {
-                                                option_id: methodId,
-                                            })];
-                                        case 1:
-                                            cart = (_a.sent()).cart;
-                                            this.logger.info('Shipping method added successfully', { cartId: cartId, methodId: methodId });
-                                            void cart;
-                                            return [4 /*yield*/, this.retrieveCartWithLineDetails(cartId)];
-                                        case 2:
-                                            updatedCart = _a.sent();
-                                            return [2 /*return*/, (0, transforms_1.transformCart)(updatedCart)];
-                                    }
-                                });
-                            }); }, 'addShippingMethod', { cartId: cartId, methodId: methodId })];
-                    case 2: return [2 /*return*/, _a.sent()];
-                    case 3:
-                        error_27 = _a.sent();
-                        this.logger.error('Failed to add shipping method', {
-                            cartId: cartId,
-                            methodId: methodId,
-                            error: error_27.message,
-                        });
-                        throw new errors_1.ProviderAPIError("Failed to add shipping method: ".concat(error_27.message), 'medusa', error_27.status);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Initiate payment session with provider
-     *
-     * Creates a payment session for the cart with the specified provider.
-     *
-     * @param cartId - Cart ID
-     * @param providerId - Payment provider ID (from getPaymentMethods)
-     * @throws {ProviderAPIError} If provider invalid or cart not ready
-     */
-    MedusaProvider.prototype.initiatePaymentSession = function (cartId, providerId) {
-        return __awaiter(this, void 0, void 0, function () {
-            var error_28;
-            var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.info('💳 [DEBUG] initiatePaymentSession called', { cartId: cartId, providerId: providerId });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                var rawCart, existingSessions, paymentResponse, sdkError_2;
-                                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
-                                return __generator(this, function (_m) {
-                                    switch (_m.label) {
-                                        case 0:
-                                            // Get RAW cart object from Medusa SDK (not transformed)
-                                            // CHANGE 1: Add payment_collection fields to query
-                                            this.logger.info('💳 [DEBUG] Step 1: Retrieving RAW cart from Medusa for payment session...', { cartId: cartId });
-                                            return [4 /*yield*/, this.sdk.store.cart.retrieve(cartId, {
-                                                    fields: '+shipping_methods,+shipping_address,+email,+region_id,+total,+items,+payment_collection,+payment_collection.payment_sessions,+billing_address',
-                                                })];
-                                        case 1:
-                                            rawCart = (_m.sent()).cart;
-                                            this.logger.info('💳 [DEBUG] Step 2: RAW cart retrieved, checking state...', {
-                                                cartId: rawCart.id,
-                                                hasShippingMethod: !!((_a = rawCart.shipping_methods) === null || _a === void 0 ? void 0 : _a.length),
-                                                shippingMethodIds: ((_b = rawCart.shipping_methods) === null || _b === void 0 ? void 0 : _b.map(function (sm) { return sm.id; })) || [],
-                                                hasShippingAddress: !!rawCart.shipping_address,
-                                                shippingAddressCity: ((_c = rawCart.shipping_address) === null || _c === void 0 ? void 0 : _c.city) || 'N/A',
-                                                hasEmail: !!rawCart.email,
-                                                email: rawCart.email || 'N/A',
-                                                hasBillingAddress: !!rawCart.billing_address,
-                                                hasPaymentCollection: !!rawCart.payment_collection,
-                                                existingSessionsCount: ((_e = (_d = rawCart.payment_collection) === null || _d === void 0 ? void 0 : _d.payment_sessions) === null || _e === void 0 ? void 0 : _e.length) || 0,
-                                                regionId: rawCart.region_id,
-                                                total: rawCart.total,
-                                                itemCount: ((_f = rawCart.items) === null || _f === void 0 ? void 0 : _f.length) || 0,
-                                            });
-                                            // 🛡️ VALIDATION: Cart must have items to create payment session
-                                            if (!rawCart.items || rawCart.items.length === 0) {
-                                                this.logger.error('💳 [DEBUG] ERROR: Cannot create payment session for empty cart', {
-                                                    cartId: cartId,
-                                                    itemCount: 0,
-                                                    reason: 'Cart has no items',
-                                                });
-                                                throw new errors_1.ProviderAPIError('Cannot create payment session: cart is empty. Please add items to your cart before checking out.', 'medusa', 400);
-                                            }
-                                            // 🛡️ VALIDATION: Required fields
-                                            if (!rawCart.shipping_address) {
-                                                this.logger.error('💳 [DEBUG] ERROR: Shipping address required', { cartId: cartId });
-                                                throw new errors_1.ProviderAPIError('Shipping address is required before initiating payment session', 'medusa', 400);
-                                            }
-                                            if (!((_g = rawCart.shipping_methods) === null || _g === void 0 ? void 0 : _g.length)) {
-                                                this.logger.error('💳 [DEBUG] ERROR: Shipping method required', { cartId: cartId });
-                                                throw new errors_1.ProviderAPIError('Shipping method is required before initiating payment session', 'medusa', 400);
-                                            }
-                                            if (!rawCart.email) {
-                                                this.logger.error('💳 [DEBUG] ERROR: Email required', { cartId: cartId });
-                                                throw new errors_1.ProviderAPIError('Email is required before initiating payment session', 'medusa', 400);
-                                            }
-                                            // CHANGE 2: Validate billing address and warn if missing
-                                            if (!rawCart.billing_address) {
-                                                this.logger.warn('💳 [DEBUG] WARNING: Billing address not set, payment provider may require it', {
-                                                    cartId: rawCart.id,
-                                                    shippingAddress: rawCart.shipping_address,
-                                                });
-                                            }
-                                            existingSessions = ((_h = rawCart.payment_collection) === null || _h === void 0 ? void 0 : _h.payment_sessions) || [];
-                                            if (existingSessions.length > 0) {
-                                                this.logger.info('💳 [DEBUG] Payment session already exists, skipping creation', {
-                                                    cartId: rawCart.id,
-                                                    sessionCount: existingSessions.length,
-                                                    sessionIds: existingSessions.map(function (s) { return s.id; }),
-                                                });
-                                                // Return early - session already exists
-                                                return [2 /*return*/];
-                                            }
-                                            this.logger.info('💳 [DEBUG] Step 2.5: No existing payment sessions, will create new one', {
-                                                cartId: rawCart.id,
-                                                hasPaymentCollection: !!rawCart.payment_collection,
-                                                providerId: providerId,
-                                            });
-                                            // Medusa v2 SDK: sdk.store.payment.initiatePaymentSession(cart, options)
-                                            this.logger.info('💳 [DEBUG] Step 3: Calling Medusa SDK initiatePaymentSession...', {
-                                                cartId: cartId,
-                                                providerId: providerId,
-                                                endpoint: "".concat(this.baseUrl, "store/payment-collections"),
-                                                note: 'About to call SDK method',
-                                            });
-                                            // VALIDATION: Ensure provider_id is a valid backend ID
-                                            // Prevent sending normalized types like 'card', 'wallet', 'cash_on_delivery'
-                                            this.logger.info('💳 [DEBUG] Step 2.5: Validating provider ID...', {
-                                                providerId: providerId,
-                                            });
-                                            try {
-                                                (0, payment_utils_1.validatePaymentId)(providerId);
-                                                this.logger.info('💳 [DEBUG] Provider ID validation passed', { providerId: providerId });
-                                            }
-                                            catch (validationError) {
-                                                this.logger.error('💳 [DEBUG] ERROR: Invalid provider ID detected', {
-                                                    providerId: providerId,
-                                                    error: validationError.message,
-                                                    hint: 'Use getBackendProviderId(paymentMethod) to extract correct ID',
-                                                });
-                                                throw new errors_1.ProviderAPIError(validationError.message, 'medusa', 400);
-                                            }
-                                            _m.label = 2;
-                                        case 2:
-                                            _m.trys.push([2, 4, , 5]);
-                                            return [4 /*yield*/, this.sdk.store.payment.initiatePaymentSession(rawCart, {
-                                                    provider_id: providerId,
-                                                })];
-                                        case 3:
-                                            paymentResponse = _m.sent();
-                                            this.logger.info('💳 [DEBUG] Step 4: Payment session response received', {
-                                                cartId: cartId,
-                                                providerId: providerId,
-                                                responseKeys: paymentResponse ? Object.keys(paymentResponse) : [],
-                                                response: JSON.stringify(paymentResponse, null, 2),
-                                            });
-                                            return [3 /*break*/, 5];
-                                        case 4:
-                                            sdkError_2 = _m.sent();
-                                            // CHANGE 4: Enhanced error context
-                                            this.logger.error('💳 [DEBUG] ERROR: Medusa SDK threw error when initiating payment session', {
-                                                cartId: cartId,
-                                                providerId: providerId,
-                                                errorType: (_j = sdkError_2 === null || sdkError_2 === void 0 ? void 0 : sdkError_2.constructor) === null || _j === void 0 ? void 0 : _j.name,
-                                                errorMessage: sdkError_2 === null || sdkError_2 === void 0 ? void 0 : sdkError_2.message,
-                                                errorStatus: sdkError_2 === null || sdkError_2 === void 0 ? void 0 : sdkError_2.status,
-                                                errorCode: sdkError_2 === null || sdkError_2 === void 0 ? void 0 : sdkError_2.code,
-                                                errorResponse: (sdkError_2 === null || sdkError_2 === void 0 ? void 0 : sdkError_2.response)
-                                                    ? JSON.stringify(sdkError_2.response, null, 2)
-                                                    : 'N/A',
-                                                errorBody: (sdkError_2 === null || sdkError_2 === void 0 ? void 0 : sdkError_2.body) ? JSON.stringify(sdkError_2.body, null, 2) : 'N/A',
-                                                fullError: JSON.stringify(sdkError_2, Object.getOwnPropertyNames(sdkError_2), 2),
-                                                // Include cart state in error for debugging
-                                                cartState: {
-                                                    hasShippingMethod: !!((_k = rawCart.shipping_methods) === null || _k === void 0 ? void 0 : _k.length),
-                                                    hasShippingAddress: !!rawCart.shipping_address,
-                                                    hasBillingAddress: !!rawCart.billing_address,
-                                                    hasEmail: !!rawCart.email,
-                                                    total: rawCart.total,
-                                                    itemCount: ((_l = rawCart.items) === null || _l === void 0 ? void 0 : _l.length) || 0,
-                                                },
-                                            });
-                                            throw sdkError_2;
-                                        case 5:
-                                            this.logger.info('💳 [DEBUG] Payment session initiated successfully', {
-                                                cartId: cartId,
-                                                providerId: providerId,
-                                            });
-                                            return [2 /*return*/];
-                                    }
-                                });
-                            }); }, 'initiatePaymentSession', { cartId: cartId, providerId: providerId })];
-                    case 2:
-                        _a.sent();
-                        return [3 /*break*/, 4];
-                    case 3:
-                        error_28 = _a.sent();
-                        this.logger.error('💳 [DEBUG] ERROR: Failed to initiate payment session', {
-                            cartId: cartId,
-                            providerId: providerId,
-                            errorMessage: error_28.message,
-                            errorStack: error_28.stack,
-                            errorStatus: error_28.status,
-                        });
-                        throw new errors_1.ProviderAPIError("Failed to initiate payment session: ".concat(error_28.message), 'medusa', error_28.status);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Apply discount code to cart
-     *
-     * Validates and applies a discount/promo code to the cart.
-     *
-     * @param cartId - Cart ID
-     * @param code - Discount code
-     * @returns Updated cart with discount
-     * @throws {ProviderAPIError} If code invalid or expired
-     */
-    MedusaProvider.prototype.applyDiscountCode = function (cartId, code) {
-        return __awaiter(this, void 0, void 0, function () {
-            var error_29;
-            var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('applyDiscountCode', { cartId: cartId, code: code });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                var response, error, medusaCart, updatedCart;
-                                return __generator(this, function (_a) {
-                                    switch (_a.label) {
-                                        case 0: return [4 /*yield*/, fetch("".concat(this.baseUrl, "/store/carts/").concat(cartId, "/promotions"), {
-                                                method: 'POST',
-                                                headers: {
-                                                    'Content-Type': 'application/json',
-                                                    'x-publishable-api-key': this.publishableKey || '',
-                                                },
-                                                body: JSON.stringify({
-                                                    promo_codes: [code],
-                                                }),
-                                            })];
-                                        case 1:
-                                            response = _a.sent();
-                                            if (!!response.ok) return [3 /*break*/, 3];
-                                            return [4 /*yield*/, response.json()];
-                                        case 2:
-                                            error = _a.sent();
-                                            throw new Error(error.message || 'Failed to apply discount code');
-                                        case 3: return [4 /*yield*/, response.json()];
-                                        case 4:
-                                            medusaCart = (_a.sent()).cart;
-                                            this.logger.info('Discount code applied successfully', { cartId: cartId, code: code });
-                                            void medusaCart;
-                                            return [4 /*yield*/, this.retrieveCartWithLineDetails(cartId)];
-                                        case 5:
-                                            updatedCart = _a.sent();
-                                            return [2 /*return*/, (0, transforms_1.transformCart)(updatedCart)];
-                                    }
-                                });
-                            }); }, 'applyDiscountCode', { cartId: cartId, code: code })];
-                    case 2: return [2 /*return*/, _a.sent()];
-                    case 3:
-                        error_29 = _a.sent();
-                        this.logger.error('Failed to apply discount code', { cartId: cartId, code: code, error: error_29.message });
-                        throw new errors_1.ProviderAPIError("Failed to apply discount code: ".concat(error_29.message), 'medusa', error_29.status);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Remove discount code from cart
-     *
-     * Removes a previously applied discount code.
-     *
-     * @param cartId - Cart ID
-     * @param code - Discount code to remove
-     * @returns Updated cart without discount
-     * @throws {ProviderAPIError} If cart not found
-     */
-    MedusaProvider.prototype.removeDiscountCode = function (cartId, code) {
-        return __awaiter(this, void 0, void 0, function () {
-            var error_30;
-            var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.debug('removeDiscountCode', { cartId: cartId, code: code });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.withRetry(function () { return __awaiter(_this, void 0, void 0, function () {
-                                var response, error, medusaCart, updatedCart;
-                                return __generator(this, function (_a) {
-                                    switch (_a.label) {
-                                        case 0: return [4 /*yield*/, fetch("".concat(this.baseUrl, "/store/carts/").concat(cartId, "/promotions"), {
-                                                method: 'DELETE',
-                                                headers: {
-                                                    'Content-Type': 'application/json',
-                                                    'x-publishable-api-key': this.publishableKey || '',
-                                                },
-                                                body: JSON.stringify({
-                                                    promo_codes: [code],
-                                                }),
-                                            })];
-                                        case 1:
-                                            response = _a.sent();
-                                            if (!!response.ok) return [3 /*break*/, 3];
-                                            return [4 /*yield*/, response.json()];
-                                        case 2:
-                                            error = _a.sent();
-                                            throw new Error(error.message || 'Failed to remove discount code');
-                                        case 3: return [4 /*yield*/, response.json()];
-                                        case 4:
-                                            medusaCart = (_a.sent()).cart;
-                                            this.logger.info('Discount code removed successfully', { cartId: cartId, code: code });
-                                            void medusaCart;
-                                            return [4 /*yield*/, this.retrieveCartWithLineDetails(cartId)];
-                                        case 5:
-                                            updatedCart = _a.sent();
-                                            return [2 /*return*/, (0, transforms_1.transformCart)(updatedCart)];
-                                    }
-                                });
-                            }); }, 'removeDiscountCode', { cartId: cartId, code: code })];
-                    case 2: return [2 /*return*/, _a.sent()];
-                    case 3:
-                        error_30 = _a.sent();
-                        this.logger.error('Failed to remove discount code', { cartId: cartId, code: code, error: error_30.message });
-                        throw new errors_1.ProviderAPIError("Failed to remove discount code: ".concat(error_30.message), 'medusa', error_30.status);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Update cart shipping address
-     * @param cartId - Cart ID
-     * @param address - Shipping address details
-     * @returns Updated cart
-     *
-     * **CRITICAL**: Must be called BEFORE initiatePaymentSession
-     * Medusa requires shipping_address on cart before creating payment session
-     */
-    MedusaProvider.prototype.updateShippingAddress = function (cartId, address) {
-        return __awaiter(this, void 0, void 0, function () {
-            var rawCart, error_31, errorMessage, status_10, userMessage;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.info('📫 [DEBUG] updateShippingAddress called', {
-                            cartId: cartId,
-                            email: address.email,
-                            city: address.city,
-                            countryCode: address.countryCode,
-                        });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.sdk.store.cart.update(cartId, {
-                                email: address.email,
-                                shipping_address: {
-                                    first_name: address.firstName,
-                                    last_name: address.lastName,
-                                    address_1: address.address1,
-                                    address_2: address.address2 || '',
-                                    company: address.company || '',
-                                    city: address.city,
-                                    province: address.province,
-                                    postal_code: address.postalCode,
-                                    country_code: address.countryCode.toLowerCase(), // Medusa expects lowercase
-                                    phone: address.phone,
-                                },
-                            })];
-                    case 2:
-                        rawCart = (_a.sent()).cart;
-                        this.logger.info('📫 [DEBUG] Shipping address updated successfully', {
-                            cartId: cartId,
-                            hasEmail: !!rawCart.email,
-                            hasShippingAddress: !!rawCart.shipping_address,
-                        });
-                        return [3 /*break*/, 4];
-                    case 3:
-                        error_31 = _a.sent();
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_31);
-                        status_10 = (error_31 === null || error_31 === void 0 ? void 0 : error_31.status) || (error_31 === null || error_31 === void 0 ? void 0 : error_31.statusCode);
-                        this.logger.error('Failed to update shipping address', {
-                            cartId: cartId,
-                            error: errorMessage,
-                            status: status_10,
-                        });
-                        userMessage = errorMessage;
-                        if (errorMessage.includes('is not within region')) {
-                            // Region/Country mismatch
-                            userMessage = "The selected country is not available for shipping in your current region. Please select a different country or change your region.";
-                        }
-                        else if (status_10 === 400) {
-                            userMessage = "Invalid shipping address: ".concat(errorMessage);
-                        }
-                        throw new errors_1.ProviderAPIError(userMessage, 'medusa', status_10);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    /**
-     * Update cart billing address
-     * @param cartId - Cart ID
-     * @param address - Billing address details
-     * @returns Updated cart
-     *
-     * **Usage**: Call when billing address differs from shipping address
-     * Recommended to call BEFORE initiatePaymentSession
-     */
-    MedusaProvider.prototype.updateBillingAddress = function (cartId, address) {
-        return __awaiter(this, void 0, void 0, function () {
-            var rawCart, error_32, errorMessage, status_11, userMessage;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.logger.info('📫 [DEBUG] updateBillingAddress called', {
-                            cartId: cartId,
-                            city: address.city,
-                            countryCode: address.countryCode,
-                        });
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.sdk.store.cart.update(cartId, {
-                                billing_address: {
-                                    first_name: address.firstName,
-                                    last_name: address.lastName,
-                                    address_1: address.address1,
-                                    address_2: address.address2 || '',
-                                    company: address.company || '',
-                                    city: address.city,
-                                    province: address.province,
-                                    postal_code: address.postalCode,
-                                    country_code: address.countryCode.toLowerCase(), // Medusa expects lowercase
-                                    phone: address.phone || '',
-                                },
-                            })];
-                    case 2:
-                        rawCart = (_a.sent()).cart;
-                        this.logger.info('📫 [DEBUG] Billing address updated successfully', {
-                            cartId: cartId,
-                            hasBillingAddress: !!rawCart.billing_address,
-                        });
-                        return [2 /*return*/, (0, transforms_1.transformCart)(rawCart)];
-                    case 3:
-                        error_32 = _a.sent();
-                        errorMessage = (0, errors_1.extractErrorMessage)(error_32);
-                        status_11 = (error_32 === null || error_32 === void 0 ? void 0 : error_32.status) || (error_32 === null || error_32 === void 0 ? void 0 : error_32.statusCode);
-                        this.logger.error('Failed to update billing address', {
-                            cartId: cartId,
-                            error: errorMessage,
-                            status: status_11,
-                        });
-                        userMessage = errorMessage;
-                        if (errorMessage.includes('is not within region')) {
-                            userMessage = "The billing address country is not available in your current region. Please select a different country or change your region.";
-                        }
-                        else if (status_11 === 400) {
-                            userMessage = "Invalid billing address: ".concat(errorMessage);
-                        }
-                        throw new errors_1.ProviderAPIError(userMessage, 'medusa', status_11);
-                    case 4: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    // ============================================
-    // Storefront / Multi-Tenant Operations
-    // ============================================
-    /**
-     * Get the current storefront/sales channel context.
-     *
-     * Validates that NEXT_PUBLIC_SALES_CHANNEL_ID is set and that the
-     * corresponding sales channel exists in the Medusa backend.
-     * Results are cached for 60 seconds.
-     *
-     * @returns StorefrontContext for the current storefront
-     * @throws {StorefrontConfigError} if NEXT_PUBLIC_SALES_CHANNEL_ID is missing or invalid
-     * @throws {ProviderAPIError} if the backend request fails
-     */
-    MedusaProvider.prototype.getStorefrontContext = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            var channelId, context, errorMessage;
-            var _a;
-            return __generator(this, function (_b) {
-                // Check cache first
-                if (this.storefrontContextCache &&
-                    Date.now() < this.storefrontContextCache.expiresAt) {
-                    return [2 /*return*/, this.storefrontContextCache.context];
-                }
-                channelId = process.env.NEXT_PUBLIC_SALES_CHANNEL_ID;
-                if (!channelId) {
-                    throw new types_1.StorefrontConfigError('Medusa requires NEXT_PUBLIC_SALES_CHANNEL_ID to be configured. ' +
-                        'Each storefront must be linked to a sales channel. ' +
-                        'Set this in your .env file or environment variables.', 'medusa', 'NEXT_PUBLIC_SALES_CHANNEL_ID');
-                }
-                try {
-                    context = {
-                        id: channelId,
-                        name: channelId, // Use ID as fallback name
-                        platformType: 'medusa',
-                        requiresProductScoping: true,
-                        currencyCode: this.currencyCode,
-                        metadata: {
-                            // Store channel ID for use in API requests
-                            channelId: channelId,
-                        },
-                    };
-                    // Cache for 60 seconds
-                    this.storefrontContextCache = {
-                        context: context,
-                        expiresAt: Date.now() + this.STOREFRONT_CONTEXT_CACHE_TTL,
-                    };
-                    this.logger.info('Storefront context initialized', {
-                        id: context.id,
-                        channelId: channelId,
-                    });
-                    return [2 /*return*/, context];
-                }
-                catch (error) {
-                    if (error instanceof types_1.StorefrontConfigError)
-                        throw error;
-                    errorMessage = (0, errors_1.extractErrorMessage)(error);
-                    throw new errors_1.ProviderAPIError("Failed to initialize storefront context: ".concat(errorMessage), 'medusa', (_a = error === null || error === void 0 ? void 0 : error.status) !== null && _a !== void 0 ? _a : 500);
-                }
-                return [2 /*return*/];
-            });
-        });
-    };
-    /**
-     * Medusa always requires storefront configuration for multi-tenant support.
-     */
-    MedusaProvider.prototype.isStorefrontRequired = function () {
-        return true;
-    };
-    return MedusaProvider;
-}());
-exports.MedusaProvider = MedusaProvider;