@thorprovider/adapters 4.2.1 → 4.3.0

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);
-    }
-}

package/src/metadata/channel-scope.js

@@ -1,174 +0,0 @@
-"use strict";
-/**
- * Channel Scope — Backend-Agnostic Multi-Tenant Helpers
- *
- * Provides utilities for tagging, reading and filtering entity metadata by
- * sales-channel (or any future tenant key). Works with any backend that
- * exposes a writable `metadata: Record<string, unknown>` field on its
- * entities (Medusa, Shopify metafields, WooCommerce meta, etc.).
- *
- * ## Design decisions
- *
- * | Decision | Rationale |
- * |----------|-----------|
- * | Flat key (`sales_channel_id`) | Simpler queries, no prefix parsing required |
- * | Metadata, not custom fields | Zero DB migrations; works across backends |
- * | Pure functions | No side effects → easily testable; usable in any layer |
- * | `assigned_at` timestamp | Audit trail for dropshipper / admin assignment |
- *
- * @module metadata/channel-scope
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CHANNEL_ASSIGNED_BY_KEY = exports.CHANNEL_ASSIGNED_AT_KEY = exports.CHANNEL_SCOPE_KEY = void 0;
-exports.buildChannelScopeMetadata = buildChannelScopeMetadata;
-exports.getChannelScope = getChannelScope;
-exports.isScopedToChannel = isScopedToChannel;
-exports.isGlobalEntity = isGlobalEntity;
-exports.filterByChannel = filterByChannel;
-exports.filterGlobalOnly = filterGlobalOnly;
-exports.partitionByChannel = partitionByChannel;
-// ────────────────────────────────────────────────────────────────────
-// Constants
-// ────────────────────────────────────────────────────────────────────
-/**
- * Well-known metadata key used to store the owning sales-channel on any
- * entity that Medusa (or the backend) does not natively scope.
- *
- * Convention: every entity whose metadata contains this key is
- * considered "owned" by the referenced channel. Entities without it
- * are global / unscoped.
- */
-exports.CHANNEL_SCOPE_KEY = 'sales_channel_id';
-/**
- * Optional audit key — ISO-8601 timestamp of when the channel was assigned.
- */
-exports.CHANNEL_ASSIGNED_AT_KEY = 'channel_assigned_at';
-/**
- * Optional audit key — who assigned the entity to the channel.
- * Value is a free-form string (admin email, user id, "system", etc.).
- */
-exports.CHANNEL_ASSIGNED_BY_KEY = 'channel_assigned_by';
-// ────────────────────────────────────────────────────────────────────
-// Builders
-// ────────────────────────────────────────────────────────────────────
-/**
- * Build channel-scope metadata payload.
- *
- * The returned object should be **merged** into the entity's existing
- * `metadata` field when calling `updateCustomer`, `updateOrder`, etc.
- *
- * @param channelId  - Sales-channel ID (e.g. `"sc_01HXXX"`)
- * @param assignedBy - Optional identifier of who performed the assignment
- * @returns Metadata fragment ready to spread into an update payload
- *
- * @example
- * ```typescript
- * const scope = buildChannelScopeMetadata('sc_01HXXX', 'admin@store.com');
- * await commerce.updateCustomer(customerId, {
- *   metadata: { ...existingMeta, ...scope },
- * });
- * ```
- */
-function buildChannelScopeMetadata(channelId, assignedBy) {
-    var _a;
-    var payload = (_a = {},
-        _a[exports.CHANNEL_SCOPE_KEY] = channelId,
-        _a[exports.CHANNEL_ASSIGNED_AT_KEY] = new Date().toISOString(),
-        _a);
-    if (assignedBy) {
-        payload[exports.CHANNEL_ASSIGNED_BY_KEY] = assignedBy;
-    }
-    return payload;
-}
-// ────────────────────────────────────────────────────────────────────
-// Readers
-// ────────────────────────────────────────────────────────────────────
-/**
- * Read the channel-scope value from an entity's metadata.
- *
- * @returns The channel ID string, or `null` if the entity has no scope set.
- */
-function getChannelScope(entity) {
-    var _a;
-    var value = (_a = entity.metadata) === null || _a === void 0 ? void 0 : _a[exports.CHANNEL_SCOPE_KEY];
-    return typeof value === 'string' && value.length > 0 ? value : null;
-}
-/**
- * Check if an entity is scoped to a specific channel.
- *
- * @param entity    - Any entity with optional `metadata`
- * @param channelId - Channel ID to match against
- * @returns `true` if entity's metadata contains a matching scope key
- */
-function isScopedToChannel(entity, channelId) {
-    return getChannelScope(entity) === channelId;
-}
-/**
- * Check if an entity has **no** channel scope (i.e. it is "global").
- */
-function isGlobalEntity(entity) {
-    return getChannelScope(entity) === null;
-}
-// ────────────────────────────────────────────────────────────────────
-// Filters
-// ────────────────────────────────────────────────────────────────────
-/**
- * Filter an array of entities to only those belonging to a channel.
- *
- * If `channelId` is `undefined` or empty, returns the full array unfiltered.
- * This preserves backward compatibility for admin views that intentionally
- * list all entities regardless of tenant.
- *
- * @param entities  - Array of channel-scopeable entities
- * @param channelId - Optional channel ID to filter by
- * @returns Filtered (or unfiltered) array
- *
- * @example
- * ```typescript
- * const allCustomers = await commerce.getCustomers();
- * const myCustomers = filterByChannel(allCustomers, salesChannelId);
- * ```
- */
-function filterByChannel(entities, channelId) {
-    if (!channelId)
-        return entities;
-    return entities.filter(function (e) { return isScopedToChannel(e, channelId); });
-}
-/**
- * Filter an array of entities to only those that are global (unscoped).
- *
- * Useful for admin views that want to list entities not yet assigned to
- * any channel.
- */
-function filterGlobalOnly(entities) {
-    return entities.filter(isGlobalEntity);
-}
-/**
- * Partition entities into `{ scoped, global }` groups.
- *
- * @param entities  - Array of channel-scopeable entities
- * @param channelId - Channel ID to partition against
- * @returns Object with `scoped` (matching channel) and `global` (no scope) arrays
- *
- * @example
- * ```typescript
- * const { scoped, global } = partitionByChannel(customers, 'sc_123');
- * // scoped → customers assigned to sc_123
- * // global → customers not assigned to any channel
- * ```
- */
-function partitionByChannel(entities, channelId) {
-    var scoped = [];
-    var global = [];
-    for (var _i = 0, entities_1 = entities; _i < entities_1.length; _i++) {
-        var entity = entities_1[_i];
-        if (isScopedToChannel(entity, channelId)) {
-            scoped.push(entity);
-        }
-        else if (isGlobalEntity(entity)) {
-            global.push(entity);
-        }
-        // Entities scoped to a *different* channel are silently excluded.
-    }
-    return { scoped: scoped, global: global };
-}

package/src/metadata/index.js

@@ -1,31 +0,0 @@
-"use strict";
-/**
- * Metadata — Channel Scope Utilities
- *
- * Backend-agnostic helpers for multi-tenant channel scoping.
- * Used by L2 adapters to tag, validate and filter entities by sales channel.
- *
- * @module metadata
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertEntityBelongsToChannel = exports.validateChannelScopeAssignment = exports.validateAssignedBy = exports.validateEntityId = exports.validateChannelId = exports.ChannelScopeValidationError = exports.partitionByChannel = exports.filterGlobalOnly = exports.filterByChannel = exports.isGlobalEntity = exports.isScopedToChannel = exports.getChannelScope = exports.buildChannelScopeMetadata = exports.CHANNEL_ASSIGNED_BY_KEY = exports.CHANNEL_ASSIGNED_AT_KEY = exports.CHANNEL_SCOPE_KEY = void 0;
-// Builders, readers & filters
-var channel_scope_1 = require("./channel-scope");
-Object.defineProperty(exports, "CHANNEL_SCOPE_KEY", { enumerable: true, get: function () { return channel_scope_1.CHANNEL_SCOPE_KEY; } });
-Object.defineProperty(exports, "CHANNEL_ASSIGNED_AT_KEY", { enumerable: true, get: function () { return channel_scope_1.CHANNEL_ASSIGNED_AT_KEY; } });
-Object.defineProperty(exports, "CHANNEL_ASSIGNED_BY_KEY", { enumerable: true, get: function () { return channel_scope_1.CHANNEL_ASSIGNED_BY_KEY; } });
-Object.defineProperty(exports, "buildChannelScopeMetadata", { enumerable: true, get: function () { return channel_scope_1.buildChannelScopeMetadata; } });
-Object.defineProperty(exports, "getChannelScope", { enumerable: true, get: function () { return channel_scope_1.getChannelScope; } });
-Object.defineProperty(exports, "isScopedToChannel", { enumerable: true, get: function () { return channel_scope_1.isScopedToChannel; } });
-Object.defineProperty(exports, "isGlobalEntity", { enumerable: true, get: function () { return channel_scope_1.isGlobalEntity; } });
-Object.defineProperty(exports, "filterByChannel", { enumerable: true, get: function () { return channel_scope_1.filterByChannel; } });
-Object.defineProperty(exports, "filterGlobalOnly", { enumerable: true, get: function () { return channel_scope_1.filterGlobalOnly; } });
-Object.defineProperty(exports, "partitionByChannel", { enumerable: true, get: function () { return channel_scope_1.partitionByChannel; } });
-// Validation
-var channel_scope_validation_1 = require("./channel-scope-validation");
-Object.defineProperty(exports, "ChannelScopeValidationError", { enumerable: true, get: function () { return channel_scope_validation_1.ChannelScopeValidationError; } });
-Object.defineProperty(exports, "validateChannelId", { enumerable: true, get: function () { return channel_scope_validation_1.validateChannelId; } });
-Object.defineProperty(exports, "validateEntityId", { enumerable: true, get: function () { return channel_scope_validation_1.validateEntityId; } });
-Object.defineProperty(exports, "validateAssignedBy", { enumerable: true, get: function () { return channel_scope_validation_1.validateAssignedBy; } });
-Object.defineProperty(exports, "validateChannelScopeAssignment", { enumerable: true, get: function () { return channel_scope_validation_1.validateChannelScopeAssignment; } });
-Object.defineProperty(exports, "assertEntityBelongsToChannel", { enumerable: true, get: function () { return channel_scope_validation_1.assertEntityBelongsToChannel; } });