@thorprovider/adapters 4.2.1 → 5.0.0

package/src/core/errors.js

@@ -1,161 +0,0 @@
-"use strict";
-/**
- * @thorprovider/adapters v2.0
- * Core errors
- */
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProviderAPIError = exports.ResourceNotFoundError = exports.ConfigurationError = exports.ProviderNotFoundError = exports.CommerceError = void 0;
-exports.extractErrorMessage = extractErrorMessage;
-/**
- * Base error class for commerce providers
- */
-var CommerceError = /** @class */ (function (_super) {
-    __extends(CommerceError, _super);
-    function CommerceError(message, code, status) {
-        var _this = _super.call(this, message) || this;
-        _this.code = code;
-        _this.status = status;
-        _this.name = 'CommerceError';
-        return _this;
-    }
-    return CommerceError;
-}(Error));
-exports.CommerceError = CommerceError;
-/**
- * Provider not found error
- */
-var ProviderNotFoundError = /** @class */ (function (_super) {
-    __extends(ProviderNotFoundError, _super);
-    function ProviderNotFoundError(providerName) {
-        var _this = _super.call(this, "Provider not found: ".concat(providerName), 'PROVIDER_NOT_FOUND') || this;
-        _this.name = 'ProviderNotFoundError';
-        return _this;
-    }
-    return ProviderNotFoundError;
-}(CommerceError));
-exports.ProviderNotFoundError = ProviderNotFoundError;
-/**
- * Configuration error
- */
-var ConfigurationError = /** @class */ (function (_super) {
-    __extends(ConfigurationError, _super);
-    function ConfigurationError(message) {
-        var _this = _super.call(this, message, 'CONFIGURATION_ERROR') || this;
-        _this.name = 'ConfigurationError';
-        return _this;
-    }
-    return ConfigurationError;
-}(CommerceError));
-exports.ConfigurationError = ConfigurationError;
-/**
- * Resource not found error
- */
-var ResourceNotFoundError = /** @class */ (function (_super) {
-    __extends(ResourceNotFoundError, _super);
-    function ResourceNotFoundError(resource, identifier) {
-        var _this = _super.call(this, "".concat(resource, " not found: ").concat(identifier), 'RESOURCE_NOT_FOUND', 404) || this;
-        _this.name = 'ResourceNotFoundError';
-        return _this;
-    }
-    return ResourceNotFoundError;
-}(CommerceError));
-exports.ResourceNotFoundError = ResourceNotFoundError;
-/**
- * API error from provider
- */
-var ProviderAPIError = /** @class */ (function (_super) {
-    __extends(ProviderAPIError, _super);
-    function ProviderAPIError(message, provider, status) {
-        var _this = _super.call(this, message, 'PROVIDER_API_ERROR', status) || this;
-        _this.provider = provider;
-        _this.name = 'ProviderAPIError';
-        return _this;
-    }
-    return ProviderAPIError;
-}(CommerceError));
-exports.ProviderAPIError = ProviderAPIError;
-/**
- * Extract error message from various error types
- * Handles standard Error objects, API responses, and unknown error types
- */
-function extractErrorMessage(error) {
-    var _a, _b, _c, _d, _e, _f;
-    // Standard Error object
-    if (error instanceof Error && error.message) {
-        // Don't return generic messages if there's more data
-        if (error.message !== 'An unknown error occurred.') {
-            return error.message;
-        }
-    }
-    // Object with message property
-    if (typeof error === 'object' && error !== null) {
-        var err = error;
-        // Check for response body (common in fetch errors)
-        if (err.body) {
-            if (typeof err.body === 'string')
-                return err.body;
-            if (err.body.message)
-                return String(err.body.message);
-            if ((_a = err.body.error) === null || _a === void 0 ? void 0 : _a.message)
-                return String(err.body.error.message);
-        }
-        // Check for response object
-        if (err.response) {
-            if ((_b = err.response.data) === null || _b === void 0 ? void 0 : _b.message)
-                return String(err.response.data.message);
-            if ((_c = err.response.data) === null || _c === void 0 ? void 0 : _c.error)
-                return String(err.response.data.error);
-            if (err.response.statusText)
-                return "".concat(err.response.status || '', " ").concat(err.response.statusText).trim();
-        }
-        // Check for data property
-        if ((_d = err.data) === null || _d === void 0 ? void 0 : _d.message)
-            return String(err.data.message);
-        if ((_e = err.data) === null || _e === void 0 ? void 0 : _e.error)
-            return String(err.data.error);
-        // Check for error property
-        if ((_f = err.error) === null || _f === void 0 ? void 0 : _f.message)
-            return String(err.error.message);
-        // Check for statusText with status code
-        if (err.status && err.statusText) {
-            return "HTTP ".concat(err.status, ": ").concat(err.statusText);
-        }
-        if (err.status && !err.statusText) {
-            return "HTTP ".concat(err.status, " Error");
-        }
-        // Check for message property (not generic)
-        if (err.message && err.message !== 'An unknown error occurred.') {
-            return String(err.message);
-        }
-        // Try to stringify the error object
-        try {
-            var stringified = JSON.stringify(error);
-            if (stringified !== '{}')
-                return stringified;
-        }
-        catch (_g) {
-            // Ignore JSON.stringify errors
-        }
-    }
-    // String error
-    if (typeof error === 'string') {
-        return error;
-    }
-    // Fallback
-    return 'An unknown error occurred';
-}

package/src/core/fetch-utils.js

@@ -1,240 +0,0 @@
-"use strict";
-/**
- * @thorprovider/adapters v2.0
- * Fetch Utilities - Retry logic, timeouts, and error handling
- *
- * This module provides enhanced fetch capabilities with:
- * - Automatic retries with exponential backoff
- * - Configurable timeouts
- * - Better error handling for network failures
- */
-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.fetchWithRetry = fetchWithRetry;
-exports.createFetchWithRetry = createFetchWithRetry;
-var logger_1 = require("./logger");
-var logger = (0, logger_1.createLogger)('FetchUtils');
-var DEFAULT_RETRY_CONFIG = {
-    maxRetries: 3,
-    initialDelayMs: 300,
-    backoffMultiplier: 2,
-    maxDelayMs: 5000,
-    timeoutMs: 10000, // 10 seconds
-    retryableStatusCodes: [408, 429, 500, 502, 503, 504],
-};
-/**
- * Sleep utility for delays between retries
- */
-function sleep(ms) {
-    return new Promise(function (resolve) { return setTimeout(resolve, ms); });
-}
-/**
- * Calculate delay for exponential backoff
- */
-function calculateDelay(attempt, config) {
-    var delay = config.initialDelayMs * Math.pow(config.backoffMultiplier, attempt);
-    return Math.min(delay, config.maxDelayMs);
-}
-/**
- * Check if error is retryable
- */
-function isRetryableError(error, config) {
-    var _a, _b;
-    // Network errors (fetch failed, connection refused, etc.)
-    if (error.name === 'TypeError' || ((_a = error.message) === null || _a === void 0 ? void 0 : _a.includes('fetch failed'))) {
-        return true;
-    }
-    // Timeout errors
-    if (error.name === 'AbortError' || ((_b = error.message) === null || _b === void 0 ? void 0 : _b.includes('timeout'))) {
-        return true;
-    }
-    // HTTP status codes
-    if (error.status && config.retryableStatusCodes.includes(error.status)) {
-        return true;
-    }
-    return false;
-}
-/**
- * Enhanced fetch with retry logic and timeout
- *
- * @example
- * ```typescript
- * import { fetchWithRetry } from '@thorprovider/adapters/core/fetch-utils';
- *
- * // Basic usage with defaults (3 retries, 10s timeout)
- * const response = await fetchWithRetry('https://api.example.com/products');
- *
- * // Custom configuration
- * const response = await fetchWithRetry(
- *   'https://api.example.com/products',
- *   {
- *     method: 'POST',
- *     body: JSON.stringify({ name: 'Product' }),
- *   },
- *   {
- *     maxRetries: 5,
- *     timeoutMs: 15000, // 15 seconds
- *     initialDelayMs: 500,
- *   }
- * );
- * ```
- */
-function fetchWithRetry(url, init, retryConfig) {
-    return __awaiter(this, void 0, void 0, function () {
-        var config, lastError, _loop_1, attempt, state_1;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    config = __assign(__assign({}, DEFAULT_RETRY_CONFIG), retryConfig);
-                    _loop_1 = function (attempt) {
-                        var controller_1, timeoutId, fetchOptions, response, error, error_1, shouldRetry, delay;
-                        return __generator(this, function (_b) {
-                            switch (_b.label) {
-                                case 0:
-                                    _b.trys.push([0, 2, , 6]);
-                                    controller_1 = new AbortController();
-                                    timeoutId = setTimeout(function () { return controller_1.abort(); }, config.timeoutMs);
-                                    fetchOptions = __assign(__assign({}, init), { signal: controller_1.signal });
-                                    logger.debug('Fetch attempt', {
-                                        url: url,
-                                        attempt: attempt + 1,
-                                        maxAttempts: config.maxRetries + 1,
-                                        timeout: config.timeoutMs,
-                                    });
-                                    return [4 /*yield*/, fetch(url, fetchOptions)];
-                                case 1:
-                                    response = _b.sent();
-                                    // Clear timeout
-                                    clearTimeout(timeoutId);
-                                    // Check if status code is retryable
-                                    if (!response.ok && config.retryableStatusCodes.includes(response.status)) {
-                                        error = new Error("HTTP ".concat(response.status, ": ").concat(response.statusText));
-                                        error.status = response.status;
-                                        throw error;
-                                    }
-                                    // Success!
-                                    logger.debug('Fetch successful', { url: url, attempt: attempt + 1 });
-                                    return [2 /*return*/, { value: response }];
-                                case 2:
-                                    error_1 = _b.sent();
-                                    lastError = error_1;
-                                    // Clear timeout if it exists
-                                    if (error_1.name === 'AbortError') {
-                                        lastError = new Error("Request timeout after ".concat(config.timeoutMs, "ms"));
-                                        lastError.name = 'TimeoutError';
-                                    }
-                                    shouldRetry = attempt < config.maxRetries && isRetryableError(error_1, config);
-                                    if (!shouldRetry) return [3 /*break*/, 4];
-                                    delay = calculateDelay(attempt, config);
-                                    logger.warn('Fetch failed, retrying...', {
-                                        url: url,
-                                        attempt: attempt + 1,
-                                        maxAttempts: config.maxRetries + 1,
-                                        nextRetryIn: "".concat(delay, "ms"),
-                                        error: error_1.message,
-                                    });
-                                    return [4 /*yield*/, sleep(delay)];
-                                case 3:
-                                    _b.sent();
-                                    return [3 /*break*/, 5];
-                                case 4:
-                                    logger.error('Fetch failed after all retries', {
-                                        url: url,
-                                        totalAttempts: attempt + 1,
-                                        error: error_1.message,
-                                    });
-                                    return [2 /*return*/, "break"];
-                                case 5: return [3 /*break*/, 6];
-                                case 6: return [2 /*return*/];
-                            }
-                        });
-                    };
-                    attempt = 0;
-                    _a.label = 1;
-                case 1:
-                    if (!(attempt <= config.maxRetries)) return [3 /*break*/, 4];
-                    return [5 /*yield**/, _loop_1(attempt)];
-                case 2:
-                    state_1 = _a.sent();
-                    if (typeof state_1 === "object")
-                        return [2 /*return*/, state_1.value];
-                    if (state_1 === "break")
-                        return [3 /*break*/, 4];
-                    _a.label = 3;
-                case 3:
-                    attempt++;
-                    return [3 /*break*/, 1];
-                case 4: 
-                // All retries exhausted, throw the last error
-                throw lastError;
-            }
-        });
-    });
-}
-/**
- * Create a fetch function with custom retry configuration
- * Useful for creating a configured fetch instance
- *
- * @example
- * ```typescript
- * import { createFetchWithRetry } from '@thorprovider/adapters/core/fetch-utils';
- *
- * // Create configured fetch
- * const customFetch = createFetchWithRetry({
- *   maxRetries: 5,
- *   timeoutMs: 15000,
- * });
- *
- * // Use it like regular fetch
- * const response = await customFetch('https://api.example.com/products');
- * ```
- */
-function createFetchWithRetry(retryConfig) {
-    return function (url, init) { return fetchWithRetry(url, init, retryConfig); };
-}

package/src/core/logger.js

@@ -1,63 +0,0 @@
-"use strict";
-/**
- * @thorprovider/adapters v2.0
- * Core logger utility
- */
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createLogger = createLogger;
-/**
- * Create a logger instance
- */
-function createLogger(namespace, enabled) {
-    if (enabled === void 0) { enabled = false; }
-    var log = function (level, message) {
-        var args = [];
-        for (var _i = 2; _i < arguments.length; _i++) {
-            args[_i - 2] = arguments[_i];
-        }
-        if (!enabled && level !== 'error')
-            return;
-        var timestamp = new Date().toISOString();
-        var prefix = "[".concat(timestamp, "] [@thorprovider/adapters:").concat(namespace, "] ").concat(level.toUpperCase(), ":");
-        console[level].apply(console, __spreadArray([prefix, message], args, false));
-    };
-    return {
-        debug: function (message) {
-            var args = [];
-            for (var _i = 1; _i < arguments.length; _i++) {
-                args[_i - 1] = arguments[_i];
-            }
-            return log.apply(void 0, __spreadArray(['debug', message], args, false));
-        },
-        info: function (message) {
-            var args = [];
-            for (var _i = 1; _i < arguments.length; _i++) {
-                args[_i - 1] = arguments[_i];
-            }
-            return log.apply(void 0, __spreadArray(['info', message], args, false));
-        },
-        warn: function (message) {
-            var args = [];
-            for (var _i = 1; _i < arguments.length; _i++) {
-                args[_i - 1] = arguments[_i];
-            }
-            return log.apply(void 0, __spreadArray(['warn', message], args, false));
-        },
-        error: function (message) {
-            var args = [];
-            for (var _i = 1; _i < arguments.length; _i++) {
-                args[_i - 1] = arguments[_i];
-            }
-            return log.apply(void 0, __spreadArray(['error', message], args, false));
-        },
-    };
-}

package/src/metadata/channel-scope-validation.js

@@ -1,136 +0,0 @@
-"use strict";
-/**
- * Channel Scope Validation — Pure TypeScript (no external deps)
- *
- * Validates channel-scope metadata before it is written to the backend.
- * Keeps all validation logic in L2 so that L5 starters don't duplicate checks.
- *
- * @module metadata/channel-scope-validation
- */
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChannelScopeValidationError = void 0;
-exports.validateChannelId = validateChannelId;
-exports.validateEntityId = validateEntityId;
-exports.validateAssignedBy = validateAssignedBy;
-exports.validateChannelScopeAssignment = validateChannelScopeAssignment;
-exports.assertEntityBelongsToChannel = assertEntityBelongsToChannel;
-var channel_scope_1 = require("./channel-scope");
-// ────────────────────────────────────────────────────────────────────
-// Errors
-// ────────────────────────────────────────────────────────────────────
-/**
- * Thrown when channel-scope validation fails.
- *
- * Consumers can catch this specific type to provide user-friendly feedback
- * without leaking internal details.
- */
-var ChannelScopeValidationError = /** @class */ (function (_super) {
-    __extends(ChannelScopeValidationError, _super);
-    function ChannelScopeValidationError(message, field, value) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'ChannelScopeValidationError';
-        _this.field = field;
-        _this.value = value;
-        return _this;
-    }
-    return ChannelScopeValidationError;
-}(Error));
-exports.ChannelScopeValidationError = ChannelScopeValidationError;
-// ────────────────────────────────────────────────────────────────────
-// Validation functions
-// ────────────────────────────────────────────────────────────────────
-/**
- * Validate that a channel ID is a non-empty string.
- *
- * Does **not** enforce a specific prefix (e.g. `"sc_"`) because different
- * backends use different conventions:
- * - Medusa: `"sc_01HXXX"`
- * - Shopify: `"gid://shopify/Channel/789"`
- * - WooCommerce: `"1"` (numeric string)
- *
- * @throws {ChannelScopeValidationError}
- */
-function validateChannelId(channelId) {
-    if (typeof channelId !== 'string' || channelId.trim().length === 0) {
-        throw new ChannelScopeValidationError('Channel ID must be a non-empty string', 'channelId', channelId);
-    }
-    // Sanity upper-bound for ID length (guards against payload abuse)
-    if (channelId.length > 256) {
-        throw new ChannelScopeValidationError('Channel ID exceeds maximum length (256)', 'channelId', channelId);
-    }
-}
-/**
- * Validate that an entity ID is a non-empty string.
- *
- * @throws {ChannelScopeValidationError}
- */
-function validateEntityId(entityId, label) {
-    if (label === void 0) { label = 'entityId'; }
-    if (typeof entityId !== 'string' || entityId.trim().length === 0) {
-        throw new ChannelScopeValidationError("".concat(label, " must be a non-empty string"), label, entityId);
-    }
-}
-/**
- * Validate that the `assignedBy` value (if provided) is a reasonable string.
- *
- * @throws {ChannelScopeValidationError}
- */
-function validateAssignedBy(assignedBy) {
-    if (assignedBy === undefined || assignedBy === null)
-        return;
-    if (typeof assignedBy !== 'string') {
-        throw new ChannelScopeValidationError('assignedBy must be a string', 'assignedBy', assignedBy);
-    }
-    if (assignedBy.length > 512) {
-        throw new ChannelScopeValidationError('assignedBy exceeds maximum length (512)', 'assignedBy', assignedBy);
-    }
-}
-/**
- * Full validation for a channel-scope assignment operation.
- *
- * Call before writing channel scope metadata to any entity.
- *
- * @throws {ChannelScopeValidationError} with descriptive field + value
- *
- * @example
- * ```typescript
- * validateChannelScopeAssignment('cus_123', 'sc_01HXXX', 'admin@store.com');
- * // If no error, safe to proceed
- * ```
- */
-function validateChannelScopeAssignment(entityId, channelId, assignedBy) {
-    validateEntityId(entityId, 'entityId');
-    validateChannelId(channelId);
-    validateAssignedBy(assignedBy);
-}
-/**
- * Validate that an entity is currently scoped to the expected channel.
- *
- * Useful as a guard before performing operations that should only
- * affect entities within the caller's channel (e.g. a dropshipper editing
- * a customer that must belong to their channel).
- *
- * @throws {ChannelScopeValidationError} if entity does not belong to expectedChannelId
- */
-function assertEntityBelongsToChannel(entity, expectedChannelId) {
-    var _a;
-    var actual = (_a = entity.metadata) === null || _a === void 0 ? void 0 : _a[channel_scope_1.CHANNEL_SCOPE_KEY];
-    if (actual !== expectedChannelId) {
-        throw new ChannelScopeValidationError("Entity \"".concat(entity.id, "\" does not belong to channel \"").concat(expectedChannelId, "\" (actual: \"").concat(actual !== null && actual !== void 0 ? actual : 'none', "\")"), channel_scope_1.CHANNEL_SCOPE_KEY, actual);
-    }
-}