@thorprovider/types 5.7.9 → 5.7.10

package/dist/index.js

@@ -3,6 +3,10 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -15,5 +19,139 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 
 // src/index.ts
 var src_exports = {};
+__export(src_exports, {
+  PROVIDER_METADATA: () => PROVIDER_METADATA,
+  StorefrontConfigError: () => StorefrontConfigError,
+  SupportedProviderType: () => SupportedProviderType,
+  getProviderMetadata: () => getProviderMetadata,
+  isSupportedProviderType: () => isSupportedProviderType
+});
 module.exports = __toCommonJS(src_exports);
+
+// src/provider.ts
+var SupportedProviderType = /* @__PURE__ */ ((SupportedProviderType2) => {
+  SupportedProviderType2["Mock"] = "mock";
+  SupportedProviderType2["Medusa"] = "medusa";
+  SupportedProviderType2["StelOrder"] = "stelorder";
+  SupportedProviderType2["Shopify"] = "shopify";
+  SupportedProviderType2["BigCommerce"] = "bigcommerce";
+  SupportedProviderType2["WooCommerce"] = "woocommerce";
+  SupportedProviderType2["Spree"] = "spree";
+  SupportedProviderType2["Magento"] = "magento";
+  return SupportedProviderType2;
+})(SupportedProviderType || {});
+var PROVIDER_METADATA = {
+  mock: {
+    name: "Mock",
+    description: "Fixture-backed runtime provider for layout/design mode without a real backend",
+    requiresStorefront: false,
+    requiredEnvVars: [],
+    maxRetries: 0
+  },
+  medusa: {
+    name: "Medusa JS",
+    description: "Medusa v2 commerce engine",
+    requiresStorefront: true,
+    requiredEnvVars: [
+      "NEXT_PUBLIC_COMMERCE_API_URL",
+      "NEXT_PUBLIC_COMMERCE_API_KEY",
+      "NEXT_PUBLIC_SALES_CHANNEL_ID"
+    ],
+    maxRetries: 3
+  },
+  stelorder: {
+    name: "Stel Order",
+    description: "Stel Order ERP and sales document API",
+    requiresStorefront: false,
+    requiredEnvVars: [
+      "NEXT_PUBLIC_COMMERCE_API_URL",
+      "NEXT_PUBLIC_COMMERCE_API_KEY"
+    ],
+    maxRetries: 2
+  },
+  shopify: {
+    name: "Shopify",
+    description: "Shopify Storefront API (GraphQL)",
+    requiresStorefront: false,
+    requiredEnvVars: [
+      "NEXT_PUBLIC_SHOPIFY_STORE_DOMAIN",
+      "NEXT_PUBLIC_SHOPIFY_STOREFRONT_TOKEN"
+    ],
+    maxRetries: 3
+  },
+  bigcommerce: {
+    name: "BigCommerce",
+    description: "BigCommerce REST Storefront API",
+    requiresStorefront: false,
+    requiredEnvVars: [
+      "BIGCOMMERCE_STORE_HASH",
+      "BIGCOMMERCE_STOREFRONT_API_TOKEN",
+      "BIGCOMMERCE_CHANNEL_ID"
+    ],
+    maxRetries: 3
+  },
+  woocommerce: {
+    name: "WooCommerce",
+    description: "WooCommerce Store API + REST API v3",
+    requiresStorefront: false,
+    requiredEnvVars: [
+      "WOOCOMMERCE_URL",
+      "WOOCOMMERCE_CONSUMER_KEY",
+      "WOOCOMMERCE_CONSUMER_SECRET"
+    ],
+    maxRetries: 3
+  },
+  spree: {
+    name: "Spree Commerce",
+    description: "Spree API v2 Storefront (JSON:API)",
+    requiresStorefront: false,
+    requiredEnvVars: [
+      "SPREE_API_URL"
+    ],
+    maxRetries: 3
+  },
+  magento: {
+    name: "Adobe Commerce (Magento)",
+    description: "Adobe Commerce GraphQL + REST API",
+    requiresStorefront: true,
+    requiredEnvVars: [
+      "MAGENTO_URL",
+      "MAGENTO_STORE_CODE"
+    ],
+    maxRetries: 3
+  }
+};
+function isSupportedProviderType(value) {
+  return typeof value === "string" && Object.values(SupportedProviderType).includes(value);
+}
+function getProviderMetadata(type) {
+  if (!isSupportedProviderType(type)) {
+    throw new Error(
+      `Unsupported provider: ${type}. Supported: ${Object.values(
+        SupportedProviderType
+      ).join(", ")}`
+    );
+  }
+  return PROVIDER_METADATA[type];
+}
+
+// src/storefront.ts
+var StorefrontConfigError = class extends Error {
+  platformType;
+  requiredEnvVar;
+  constructor(message, platformType, requiredEnvVar) {
+    super(message);
+    this.name = "StorefrontConfigError";
+    this.platformType = platformType;
+    this.requiredEnvVar = requiredEnvVar;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PROVIDER_METADATA,
+  StorefrontConfigError,
+  SupportedProviderType,
+  getProviderMetadata,
+  isSupportedProviderType
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @thorprovider/types v1.0\n * Shared TypeScript types for Thor Commerce ecosystem\n * \n * Pure type definitions with zero runtime dependencies.\n * Foundation for type-safe commerce operations following SOLID principles.\n */\n\n// ============================================\n// Common Types\n// ============================================\nexport type {\n  Money,\n  Image,\n  SEO,\n  Connection,\n  Edge,\n  PaginationOptions,\n  SortOptions,\n  Country,\n} from './common';\n\n// ============================================\n// Commerce Contracts (single-store context + guest shapes)\n// ============================================\nexport type {\n  StoreContext,\n  ShopperIdentity,\n  CartSession,\n  OrderReceipt,\n} from './commerce';\n\nexport type {\n  AuthorConfig,\n  BrandConfig,\n  ModulesConfig,\n  NavigationItem,\n  SiteConfig,\n  SocialConfig,\n} from './site-config';\n\nexport type { SiteConfigLabels } from './site-config-labels';\n\n// ============================================\n// Unified Query Types\n// ============================================\nexport type {\n  QuerySortDirection,\n  QueryEntityInput,\n  QueryEntitiesInput,\n  QueryMeta,\n  QueryErrors,\n  QueryResponse,\n} from './query';\n\n// ============================================\n// Catalog Query & Facet Support Types\n// ============================================\nexport type {\n  CatalogSortKey,\n  CatalogQuery,\n  CatalogAppliedFilters,\n  CatalogFacetId,\n  CatalogFacetDemonstrationSource,\n  FacetSupport,\n  CatalogResults,\n  CatalogQueryFailureCode,\n  CatalogQueryFailureRepair,\n  CatalogQueryFailure,\n  CatalogQueryOutcome,\n} from './catalog';\n\n// ============================================\n// Product Types\n// ============================================\nexport type {\n  Product,\n  ProductOption,\n  ProductVariant,\n  SelectedOption,\n  PriceRange,\n  GetProductsOptions,\n  ActiveFilter,\n  SortOption,\n  FilterSection,\n  FilterOption,\n  ProductPreview,\n  Review,\n  CompareProduct,\n  AdminProductVariant,\n  AdminProduct,\n  AdvancedSearchProductsOptions,\n  SearchResultMeta,\n  FilterConfig,\n} from './product';\n\n// ============================================\n// Cart Types\n// ============================================\nexport type {\n  Cart,\n  CartItem,\n  CartProduct,\n  CartCost,\n  CartLineInput,\n  CartLineUpdate,\n  ShippingMethod,\n  DiscountCode,\n} from './cart';\n\n// ============================================\n// Inventory & Fulfillment Types\n// ============================================\nexport type {\n  StockLocation,\n  InventoryLevel,\n  FulfillmentSet,\n  FulfillmentOption,\n  StockStatus,\n  StockValidation,\n} from './stock-location';\n\n// ============================================\n// Collection Types\n// ============================================\nexport type {\n  Collection,\n  CollectionProductsOptions,\n  GetCollectionsOptions,\n} from './collection';\n\n// ============================================\n// Category Types\n// ============================================\nexport type {\n  ProductCategory,\n  GetCategoriesOptions,\n  GetCategoriesCallback,\n} from './category';\n\n// ============================================\n// Customer Types\n// ============================================\nexport type {\n  Customer,\n  Address,\n  GetCustomersOptions,\n  GetCustomersCallback,\n} from './customer';\n\n// ============================================\n// Region Types\n// ============================================\nexport type {\n  Region,\n} from './region';\n\n// ============================================\n// Order Types\n// ============================================\nexport type {\n  Order,\n  OrderItem,\n  OrderStatus,\n  PaymentStatus,\n  FulfillmentStatus,\n  GetOrdersOptions,\n  GetOrdersCallback,\n} from './order';\n\n// ============================================\n// Provider Types (L1 - type-only)\n// Runtime provider registry lives in @thorprovider/adapters\n// ============================================\nexport type { ProviderTypeString } from './provider';\n\n// ============================================\n// Storefront Types\n// ============================================\nexport type {\n  StorefrontContext,\n  StorefrontPlatformType,\n} from './storefront';\n\n// ============================================\n// Storefront Configuration Types\n// ============================================\nexport type {\n  StorefrontConfig,\n  StorefrontSeoDefaults,\n} from './storefront-config';\n\n// ============================================\n// Designer Configuration Types\n// ============================================\nexport type {\n  DesignerConfig,\n  DesignerThemeConfig,\n  DesignerThemePreset,\n  DesignerNavItem,\n  DesignerHistoryEntry,\n} from './designer-config';\n\n// ============================================\n// Auth Types\n// ============================================\nexport type {\n  AuthProvider,\n  AuthConfig,\n  AuthMethod,\n  AuthStorage,\n  LoginCredentials,\n  RegisterData,\n  AuthResponse,\n  UpdateCustomerData,\n  CreateAddressData,\n  PasswordResetRequest,\n  PasswordResetConfirm,\n  TokenVerifyState,\n  TokenVerifyResult,\n  RecoveryConfirmResult,\n  SalesChannelType,\n  InterestCategory,\n  RequestedProfile,\n  SubmitApplicationSalesChannel,\n  SubmitApplicationBody,\n  SubmitApplicationCreated,\n  SubmitApplicationConflictApplication,\n  SubmitApplicationResponse,\n  SubmitApplicationResult,\n} from './auth';\n\n// ============================================\n// Payment Types\n// ============================================\nexport type {\n  PaymentMethod,\n  PaymentMethodType,\n  PaymentMethodFeatures,\n  PaymentMethodsOptions,\n  CachedPaymentMethods,\n} from './payment';\n\n// ============================================\n// Commerce Provider Interface\n// ============================================\nexport type {\n  CommerceProvider,\n  BackendCapabilities,\n  ProviderConfig,\n} from './commerce-provider';\n\n// ============================================\n// Admin Types\n// ============================================\nexport type {\n  AdminUser,\n  AuditLog,\n  DashboardConfig,\n  DashboardMetrics,\n  SalesMetrics,\n  OrdersMetrics,\n  ProductsMetrics,\n  ChartDataPoint,\n  DashboardMetricsAdapter,\n  DashboardOrdersAdapter,\n  DashboardProductsAdapter,\n  AuditLogAdapter,\n  SiteConfigMetadata,\n  ConfigHistoryEntry,\n  // Multi-tenant admin types\n  AdminChannelCustomer,\n  GetChannelCustomersResponse,\n  GetChannelCustomersOptions,\n  AdminApiKey,\n  GetChannelApiKeysResponse,\n  AdminChannelCategory,\n  GetChannelCategoriesResponse,\n  GetChannelCategoriesOptions,\n  AdminSalesChannelRef,\n  GetCategorySalesChannelsResponse,\n  AssignCategoriesToChannelsBody,\n  AssignCategoriesToChannelsResponse,\n  UnassignCategoriesFromChannelsBody,\n  UnassignCategoriesFromChannelsResponse,\n  GetCollectionSalesChannelsResponse,\n  AssignCollectionsToChannelsBody,\n  AssignCollectionsToChannelsResponse,\n  UnassignCollectionsFromChannelsBody,\n  UnassignCollectionsFromChannelsResponse,\n  AdminStorefrontSeoDefaults,\n  AdminStorefrontConfig,\n  GetAdminStorefrontConfigResponse,\n  UpdateStorefrontConfigBody,\n  UpdateStorefrontConfigResponse,\n  AdminSiteConfigHistoryEntry,\n  AdminSiteConfig,\n  GetAdminSiteConfigResponse,\n  UpdateSiteConfigBody,\n  UpdateSiteConfigResponse,\n  AdminSiteConfigHistoryEntryFull,\n  GetAdminSiteConfigHistoryResponse,\n  GetAdminSiteConfigHistoryOptions,\n  RestoreSiteConfigResponse,\n  LinkCustomerToChannelResponse,\n  // Dropshipping types\n  DropshipperAccountRef,\n  DropshipperCostTier,\n  DropshipperSaleTier,\n  OnboardDropshipperBody,\n  OnboardDropshipperResponse,\n  DropshipperVariant,\n  DropshipperProduct,\n  DropshipperProductImage,\n  DropshipperProductAttachment,\n  DropshipperProductPrivateMedia,\n  GetDropshipperProductsOptions,\n  GetDropshipperProductsResponse,\n  ValidateCheckoutItemsRequest,\n  ValidatedCheckoutItem,\n  ValidateCheckoutItemsResponse,\n  UpdateDropshipperProductStatusBody,\n  UpdateDropshipperProductStatusResponse,\n   DropshipperPriceTier,\n   DropshipperPriceItem,\n   UpdateDropshipperPricesBody,\n   UpdateDropshipperPricesResponse,\n  DropshipperOrderCustomer,\n  DropshipperOrder,\n  GetDropshipperOrdersOptions,\n  GetDropshipperOrdersResponse,\n  DropshipperShippingOption,\n  DropshipperShippingGroupOption,\n  DropshipperShippingGroup,\n  ShippingGroupInput,\n  GetDropshipperShippingOptionsBody,\n  GetDropshipperShippingOptionsResponse,\n  DropshipperOrderShippingAddress,\n  DropshipperOrderItem,\n  DropshipperOrderTotals,\n  DropshipperOrderTimelineEvent,\n  DropshipperOrderDetail,\n  GetDropshipperOrderDetailResponse,\n  CreateOrderItem,\n  CreateDropshipperOrderBody,\n  CreateDropshipperOrderResponse,\n  ExtendedCreateDropshipperOrderBody,\n  ExtendedCreateDropshipperOrderResponse,\n  SetPaymentCollectorBody,\n  SetPaymentCollectorResponse,\n  SetPaymentMethodBody,\n  SetPaymentMethodResponse,\n  DropshipperCategory,\n  GetDropshipperCategoriesOptions,\n  GetDropshipperCategoriesResponse,\n  CreateDropshipperCategoryBody,\n  UpdateDropshipperCategoryBody,\n  DeleteDropshipperCategoryResponse,\n  ProviderCategory,\n  GetProviderCategoriesResponse,\n  GetCategoryMappingsOptions,\n  CategoryMapping,\n  GetCategoryMappingsResponse,\n  CreateCategoryMappingBody,\n  CreateCategoryMappingResponse,\n  DeleteCategoryMappingResponse,\n  DropshipperCustomer,\n  DropshipperCustomerStats,\n  DropshipperCustomerFinancial,\n  DropshipperCustomerAddress,\n  DropshipperCustomerDetail,\n  GetDropshipperCustomersOptions,\n  GetDropshipperCustomersResponse,\n  GetDropshipperCustomerDetailResponse,\n  CreateDropshipperCustomerBody,\n  CreateDropshipperCustomerResponse,\n  UpdateDropshipperCustomerBody,\n  UpdateDropshipperCustomerResponse,\n  DropshipperBalance,\n  DropshipperPendingOrders,\n  DropshipperPaymentMethodConfig,\n  DropshipperAccount,\n  GetDropshipperAccountResponse,\n  DropshipperPayableOrder,\n  GetDropshipperPayableResponse,\n  DropshipperReceivableOrder,\n  GetDropshipperReceivableResponse,\n  SettlementRecord,\n  GetSettlementsOptions,\n  GetSettlementsResponse,\n  GetSettlementDetailResponse,\n  CreateSettlementBody,\n  CreateSettlementResponse,\n  ConfirmSettlementBody,\n  CancelSettlementBody,\n  UpdateSettlementStatusResponse,\n  AdminDropshipperAccount,\n  AdminDropshipperBalance,\n  GetAdminDropshipperAccountsResponse,\n  GetAdminAccountBalanceResponse,\n  GetAdminPriceListsResponse,\n  GetUserChannelResponse,\n  DropshipperPromotion,\n  GetDropshipperPromotionsOptions,\n  GetDropshipperPromotionsResponse,\n  PromotionRule,\n  CreateDropshipperPromotionBody,\n  UpdateDropshipperPromotionBody,\n   DeleteDropshipperPromotionResponse,\n   GetDashboardStatsOptions,\n   DashboardPeriodMetrics,\n   DashboardChanges,\n   DashboardTopProduct,\n   DashboardStats,\n   GetDashboardStatsResponse,\n   GetStorefrontDropshipperCategoriesResponse,\n   OrderNote,\n   CreateOrderNoteBody,\n   GetOrderNotesResponse,\n   CreateOrderNoteResponse,\n   DeleteOrderNoteResponse,\n   // Order cancel and edits\n   CancelDropshipperOrderResponse,\n   CreateOrderEditBody,\n   CreateOrderEditResponse,\n   AddOrderEditItemBody,\n   AddOrderEditItemResponse,\n   ConfirmOrderEditResponse,\n    // Draft Orders\n    DropshipperDraftOrderItem,\n    DropshipperDraftOrder,\n    GetDropshipperDraftOrdersOptions,\n    GetDropshipperDraftOrdersResponse,\n    CreateDropshipperDraftOrderBody,\n    CreateDropshipperDraftOrderResponse,\n    GetDropshipperDraftOrderDetailResponse,\n    UpdateDropshipperDraftOrderBody,\n    UpdateDropshipperDraftOrderResponse,\n    ConvertDropshipperDraftOrderBody,\n    ConvertDropshipperDraftOrderResponse,\n    DeleteDropshipperDraftOrderResponse,\n    // Dropshipper addresses (channel-scoped)\n    DropshipperAddressBody,\n    DropshipperAddressResponse,\n    GetDropshipperAddressesResponse,\n     // Financial Endpoints — Group A\n     SettlementStatus,\n     GetDropshipperAccountBalanceResponse,\n     GetDropshipperAccountOrdersOptions,\n     GetDropshipperAccountOrdersResponse,\n     GetAdminDropshipperAccountOrdersResponse,\n     GetAdminDropshipperAccountSettlementsOptions,\n     GetAdminDropshipperAccountSettlementsResponse,\n     ResolveGuaranteeBody,\n     ResolveGuaranteeResponse,\n     CreateCompensacionBody,\n     CreateCompensacionResponse,\n     CreateAjusteBody,\n     CreateAjusteResponse,\n     // Financial Endpoints — Group B\n     CreateCobroBody,\n     CreateCobroResponse,\n     CreatePagoBody,\n     CreatePagoResponse,\n     CreateReversoBody,\n     CreateReversoResponse,\n     ConfirmMovementBody,\n     ConfirmMovementResponse,\n     CancelMovementBody,\n     CancelMovementResponse,\n     GetFinancialAnalysisResponse,\n     RegisterPaymentBody,\n     RegisterPaymentResponse,\n       // Dashboard Capabilities\n       DropshipperDashboardCapabilities,\n       // AI Assistant Chat\n       ChatMessage,\n       ChatRequest,\n       ChatIntent,\n       ChatSource,\n       ChatSourceVariant,\n       ChatResponse,\n       ChatAssistantHealthResponse,\n       // Geo-reference\n       GeoCountry,\n       GeoProvince,\n       GeoCity,\n       GetGeoCountriesResponse,\n       GetGeoProvincesResponse,\n       GetGeoCitiesResponse,\n       // Product Attributes\n         DropshipperProductAttribute,\n          DropshipperProductAttributeValue,\n           GetProductAttributesResponse,\n          DropshipperAttributeDefinition,\n           DropshipperAttributeDefinitionValue,\n            GetDropshipperAttributesResponse,\n        DropshipperProductOption,\n        DropshipperProductOptionValue,\n        // Dropshipper Profile\n        DropshipperProfile,\n        GetMyProfileResponse,\n         // Cost Price Changes Detection\n         CostPriceChangesCheckResponse,\n         CostPriceChangeItem,\n         CostPriceChangesResponse,\n         AcknowledgeCostPriceChangesResponse,\n         // Notifications\n         NotificationData,\n         PriceUpdatedNotificationData,\n         ProductAssignedNotificationData,\n         StockChangeNotificationData,\n         ManualAdminNotificationData,\n         RawNotification,\n         GetNotificationsOptions,\n         GetNotificationsResponse,\n         // Notification preferences\n         DropshipperNotificationEventType,\n         DropshipperNotificationPreference,\n         UpdateNotificationPreferencesBody,\n         GetNotificationPreferencesResponse,\n        } from './admin';\n\n// ============================================\n// Dropshipper Business Policy Types\n// ============================================\nexport type {\n  GetBusinessPolicyResponse,\n  UpdateBusinessPolicyBody,\n  UpdateBusinessPolicyResponse,\n} from './dropshipper-business-policy';\n\n// ============================================\n// Header Configuration Types\n// ============================================\nexport type {\n  IconConfig,\n  NavigationCalloutItem,\n  NavigationLinkItem,\n  DynamicSource,\n  HeaderLinkItem,\n  AccountMenuItem,\n  AccountDropdownConfig,\n  SearchBarConfig,\n  HeaderNavigationConfig,\n} from './header-config';\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/provider.ts","../src/storefront.ts"],"sourcesContent":["/**\n * @thorprovider/types v1.0\n * Shared TypeScript types for Thor Commerce ecosystem\n * \n * Pure type definitions with zero runtime dependencies.\n * Foundation for type-safe commerce operations following SOLID principles.\n */\n\n// ============================================\n// Common Types\n// ============================================\nexport type {\n  Money,\n  Image,\n  SEO,\n  Connection,\n  Edge,\n  PaginationOptions,\n  SortOptions,\n  Country,\n} from './common';\n\nexport type {\n  AuthorConfig,\n  BrandConfig,\n  ModulesConfig,\n  NavigationItem,\n  SiteConfig,\n  SocialConfig,\n} from './site-config';\n\nexport type { SiteConfigLabels } from './site-config-labels';\n\n// ============================================\n// Unified Query Types\n// ============================================\nexport type {\n  QuerySortDirection,\n  QueryEntityInput,\n  QueryEntitiesInput,\n  QueryMeta,\n  QueryErrors,\n  QueryResponse,\n} from './query';\n\n// ============================================\n// Product Types\n// ============================================\nexport type {\n  Product,\n  ProductOption,\n  ProductVariant,\n  SelectedOption,\n  PriceRange,\n  GetProductsOptions,\n  ActiveFilter,\n  SortOption,\n  FilterSection,\n  FilterOption,\n  ProductPreview,\n  Review,\n  CompareProduct,\n  AdminProductVariant,\n  AdminProduct,\n  AdvancedSearchProductsOptions,\n  SearchResultMeta,\n  FilterConfig,\n} from './product';\n\n// ============================================\n// Cart Types\n// ============================================\nexport type {\n  Cart,\n  CartItem,\n  CartProduct,\n  CartCost,\n  CartLineInput,\n  CartLineUpdate,\n  ShippingMethod,\n  DiscountCode,\n} from './cart';\n\n// ============================================\n// Inventory & Fulfillment Types\n// ============================================\nexport type {\n  StockLocation,\n  InventoryLevel,\n  FulfillmentSet,\n  FulfillmentOption,\n  StockStatus,\n  StockValidation,\n} from './stock-location';\n\n// ============================================\n// Collection Types\n// ============================================\nexport type {\n  Collection,\n  CollectionProductsOptions,\n  GetCollectionsOptions,\n} from './collection';\n\n// ============================================\n// Category Types\n// ============================================\nexport type {\n  ProductCategory,\n  GetCategoriesOptions,\n  GetCategoriesCallback,\n} from './category';\n\n// ============================================\n// Customer Types\n// ============================================\nexport type {\n  Customer,\n  Address,\n  GetCustomersOptions,\n  GetCustomersCallback,\n} from './customer';\n\n// ============================================\n// Region Types\n// ============================================\nexport type {\n  Region,\n} from './region';\n\n// ============================================\n// Order Types\n// ============================================\nexport type {\n  Order,\n  OrderItem,\n  OrderStatus,\n  PaymentStatus,\n  FulfillmentStatus,\n  GetOrdersOptions,\n  GetOrdersCallback,\n} from './order';\n\n// ============================================\n// Provider Types (L1 - Source of Truth)\n// ============================================\nexport { SupportedProviderType, type ProviderTypeString } from './provider';\n\nexport {\n  isSupportedProviderType,\n  getProviderMetadata,\n  PROVIDER_METADATA,\n} from './provider';\n\n// ============================================\n// Storefront Types\n// ============================================\nexport type {\n  StorefrontContext,\n  StorefrontPlatformType,\n} from './storefront';\n\nexport {\n  StorefrontConfigError,\n} from './storefront';\n\n// ============================================\n// Storefront Configuration Types\n// ============================================\nexport type {\n  StorefrontConfig,\n  StorefrontSeoDefaults,\n} from './storefront-config';\n\n// ============================================\n// Designer Configuration Types\n// ============================================\nexport type {\n  DesignerConfig,\n  DesignerThemeConfig,\n  DesignerThemePreset,\n  DesignerNavItem,\n  DesignerHistoryEntry,\n} from './designer-config';\n\n// ============================================\n// Auth Types\n// ============================================\nexport type {\n  AuthProvider,\n  AuthConfig,\n  AuthMethod,\n  AuthStorage,\n  LoginCredentials,\n  RegisterData,\n  AuthResponse,\n  UpdateCustomerData,\n  CreateAddressData,\n  PasswordResetRequest,\n  PasswordResetConfirm,\n  TokenVerifyState,\n  TokenVerifyResult,\n  RecoveryConfirmResult,\n  SalesChannelType,\n  InterestCategory,\n  RequestedProfile,\n  SubmitApplicationSalesChannel,\n  SubmitApplicationBody,\n  SubmitApplicationCreated,\n  SubmitApplicationConflictApplication,\n  SubmitApplicationResponse,\n  SubmitApplicationResult,\n} from './auth';\n\n// ============================================\n// Payment Types\n// ============================================\nexport type {\n  PaymentMethod,\n  PaymentMethodType,\n  PaymentMethodFeatures,\n  PaymentMethodsOptions,\n  CachedPaymentMethods,\n} from './payment';\n\n// ============================================\n// Commerce Provider Interface\n// ============================================\nexport type {\n  CommerceProvider,\n  BackendCapabilities,\n  ProviderConfig,\n} from './commerce-provider';\n\n// ============================================\n// Admin Types\n// ============================================\nexport type {\n  AdminUser,\n  AuditLog,\n  DashboardConfig,\n  DashboardMetrics,\n  SalesMetrics,\n  OrdersMetrics,\n  ProductsMetrics,\n  ChartDataPoint,\n  DashboardMetricsAdapter,\n  DashboardOrdersAdapter,\n  DashboardProductsAdapter,\n  AuditLogAdapter,\n  SiteConfigMetadata,\n  ConfigHistoryEntry,\n  // Multi-tenant admin types\n  AdminChannelCustomer,\n  GetChannelCustomersResponse,\n  GetChannelCustomersOptions,\n  AdminApiKey,\n  GetChannelApiKeysResponse,\n  AdminChannelCategory,\n  GetChannelCategoriesResponse,\n  GetChannelCategoriesOptions,\n  AdminSalesChannelRef,\n  GetCategorySalesChannelsResponse,\n  AssignCategoriesToChannelsBody,\n  AssignCategoriesToChannelsResponse,\n  UnassignCategoriesFromChannelsBody,\n  UnassignCategoriesFromChannelsResponse,\n  GetCollectionSalesChannelsResponse,\n  AssignCollectionsToChannelsBody,\n  AssignCollectionsToChannelsResponse,\n  UnassignCollectionsFromChannelsBody,\n  UnassignCollectionsFromChannelsResponse,\n  AdminStorefrontSeoDefaults,\n  AdminStorefrontConfig,\n  GetAdminStorefrontConfigResponse,\n  UpdateStorefrontConfigBody,\n  UpdateStorefrontConfigResponse,\n  AdminSiteConfigHistoryEntry,\n  AdminSiteConfig,\n  GetAdminSiteConfigResponse,\n  UpdateSiteConfigBody,\n  UpdateSiteConfigResponse,\n  AdminSiteConfigHistoryEntryFull,\n  GetAdminSiteConfigHistoryResponse,\n  GetAdminSiteConfigHistoryOptions,\n  RestoreSiteConfigResponse,\n  LinkCustomerToChannelResponse,\n  // Dropshipping types\n  DropshipperAccountRef,\n  DropshipperCostTier,\n  DropshipperSaleTier,\n  OnboardDropshipperBody,\n  OnboardDropshipperResponse,\n  DropshipperVariant,\n  DropshipperProduct,\n  DropshipperProductImage,\n  DropshipperProductAttachment,\n  DropshipperProductPrivateMedia,\n  GetDropshipperProductsOptions,\n  GetDropshipperProductsResponse,\n  ValidateCheckoutItemsRequest,\n  ValidatedCheckoutItem,\n  ValidateCheckoutItemsResponse,\n  UpdateDropshipperProductStatusBody,\n  UpdateDropshipperProductStatusResponse,\n   DropshipperPriceTier,\n   DropshipperPriceItem,\n   UpdateDropshipperPricesBody,\n   UpdateDropshipperPricesResponse,\n  DropshipperOrderCustomer,\n  DropshipperOrder,\n  GetDropshipperOrdersOptions,\n  GetDropshipperOrdersResponse,\n  DropshipperShippingOption,\n  DropshipperShippingGroupOption,\n  DropshipperShippingGroup,\n  ShippingGroupInput,\n  GetDropshipperShippingOptionsBody,\n  GetDropshipperShippingOptionsResponse,\n  DropshipperOrderShippingAddress,\n  DropshipperOrderItem,\n  DropshipperOrderTotals,\n  DropshipperOrderTimelineEvent,\n  DropshipperOrderDetail,\n  GetDropshipperOrderDetailResponse,\n  CreateOrderItem,\n  CreateDropshipperOrderBody,\n  CreateDropshipperOrderResponse,\n  ExtendedCreateDropshipperOrderBody,\n  ExtendedCreateDropshipperOrderResponse,\n  SetPaymentCollectorBody,\n  SetPaymentCollectorResponse,\n  SetPaymentMethodBody,\n  SetPaymentMethodResponse,\n  ValidateGiftCardBody,\n  ValidateGiftCardResponse,\n  DropshipperCategory,\n  GetDropshipperCategoriesOptions,\n  GetDropshipperCategoriesResponse,\n  CreateDropshipperCategoryBody,\n  UpdateDropshipperCategoryBody,\n  DeleteDropshipperCategoryResponse,\n  ProviderCategory,\n  GetProviderCategoriesResponse,\n  GetCategoryMappingsOptions,\n  CategoryMapping,\n  GetCategoryMappingsResponse,\n  CreateCategoryMappingBody,\n  CreateCategoryMappingResponse,\n  DeleteCategoryMappingResponse,\n  DropshipperCustomer,\n  DropshipperCustomerStats,\n  DropshipperCustomerFinancial,\n  DropshipperCustomerAddress,\n  DropshipperCustomerDetail,\n  GetDropshipperCustomersOptions,\n  GetDropshipperCustomersResponse,\n  GetDropshipperCustomerDetailResponse,\n  CreateDropshipperCustomerBody,\n  CreateDropshipperCustomerResponse,\n  UpdateDropshipperCustomerBody,\n  UpdateDropshipperCustomerResponse,\n  DropshipperBalance,\n  DropshipperPendingOrders,\n  DropshipperPaymentMethodConfig,\n  DropshipperAccount,\n  GetDropshipperAccountResponse,\n  DropshipperPayableOrder,\n  GetDropshipperPayableResponse,\n  DropshipperReceivableOrder,\n  GetDropshipperReceivableResponse,\n  SettlementRecord,\n  GetSettlementsOptions,\n  GetSettlementsResponse,\n  GetSettlementDetailResponse,\n  CreateSettlementBody,\n  CreateSettlementResponse,\n  ConfirmSettlementBody,\n  CancelSettlementBody,\n  UpdateSettlementStatusResponse,\n  AdminDropshipperAccount,\n  AdminDropshipperBalance,\n  GetAdminDropshipperAccountsResponse,\n  GetAdminAccountBalanceResponse,\n  GetAdminPriceListsResponse,\n  GetUserChannelResponse,\n  DropshipperPromotion,\n  GetDropshipperPromotionsOptions,\n  GetDropshipperPromotionsResponse,\n  PromotionRule,\n  CreateDropshipperPromotionBody,\n  UpdateDropshipperPromotionBody,\n   DeleteDropshipperPromotionResponse,\n   GetDashboardStatsOptions,\n   DashboardPeriodMetrics,\n   DashboardChanges,\n   DashboardTopProduct,\n   DashboardStats,\n   GetDashboardStatsResponse,\n   GetStorefrontDropshipperCategoriesResponse,\n   OrderNote,\n   CreateOrderNoteBody,\n   GetOrderNotesResponse,\n   CreateOrderNoteResponse,\n   DeleteOrderNoteResponse,\n   // Order cancel and edits\n   CancelDropshipperOrderResponse,\n   CreateOrderEditBody,\n   CreateOrderEditResponse,\n   AddOrderEditItemBody,\n   AddOrderEditItemResponse,\n   ConfirmOrderEditResponse,\n    // Draft Orders\n    DropshipperDraftOrderItem,\n    DropshipperDraftOrder,\n    GetDropshipperDraftOrdersOptions,\n    GetDropshipperDraftOrdersResponse,\n    CreateDropshipperDraftOrderBody,\n    CreateDropshipperDraftOrderResponse,\n    GetDropshipperDraftOrderDetailResponse,\n    UpdateDropshipperDraftOrderBody,\n    UpdateDropshipperDraftOrderResponse,\n    ConvertDropshipperDraftOrderBody,\n    ConvertDropshipperDraftOrderResponse,\n    DeleteDropshipperDraftOrderResponse,\n    // Order totals preview\n    PreviewDropshipperOrderItem,\n    PreviewDropshipperOrderTotalsBody,\n    PreviewDropshipperOrderTotalsResponse,\n    // Dropshipper addresses (channel-scoped)\n    DropshipperAddressBody,\n    DropshipperAddressResponse,\n    GetDropshipperAddressesResponse,\n     // Financial Endpoints — Group A\n     SettlementStatus,\n     GetDropshipperAccountBalanceResponse,\n     GetDropshipperAccountOrdersOptions,\n     GetDropshipperAccountOrdersResponse,\n     GetAdminDropshipperAccountOrdersResponse,\n     GetAdminDropshipperAccountSettlementsOptions,\n     GetAdminDropshipperAccountSettlementsResponse,\n     ResolveGuaranteeBody,\n     ResolveGuaranteeResponse,\n     CreateCompensacionBody,\n     CreateCompensacionResponse,\n     CreateAjusteBody,\n     CreateAjusteResponse,\n     // Financial Endpoints — Group B\n     CreateCobroBody,\n     CreateCobroResponse,\n     CreatePagoBody,\n     CreatePagoResponse,\n     CreateReversoBody,\n     CreateReversoResponse,\n     ConfirmMovementBody,\n     ConfirmMovementResponse,\n     CancelMovementBody,\n     CancelMovementResponse,\n     GetFinancialAnalysisResponse,\n     RegisterPaymentBody,\n     RegisterPaymentResponse,\n       // Dashboard Capabilities\n       DropshipperDashboardCapabilities,\n       // AI Assistant Chat\n       ChatMessage,\n       ChatRequest,\n       ChatIntent,\n       ChatSource,\n       ChatSourceVariant,\n       ChatResponse,\n       ChatAssistantHealthResponse,\n       // Geo-reference\n       GeoCountry,\n       GeoProvince,\n       GeoCity,\n       GetGeoCountriesResponse,\n       GetGeoProvincesResponse,\n       GetGeoCitiesResponse,\n       // Product Attributes\n         DropshipperProductAttribute,\n          DropshipperProductAttributeValue,\n           GetProductAttributesResponse,\n          DropshipperAttributeDefinition,\n           DropshipperAttributeDefinitionValue,\n            GetDropshipperAttributesResponse,\n        DropshipperProductOption,\n        DropshipperProductOptionValue,\n        // Dropshipper Profile\n        DropshipperProfile,\n        GetMyProfileResponse,\n         // Cost Price Changes Detection\n         CostPriceChangesCheckResponse,\n         CostPriceChangeItem,\n         CostPriceChangesResponse,\n         AcknowledgeCostPriceChangesResponse,\n         // Notifications\n         NotificationData,\n         PriceUpdatedNotificationData,\n         ProductAssignedNotificationData,\n         StockChangeNotificationData,\n         ManualAdminNotificationData,\n         RawNotification,\n         GetNotificationsOptions,\n         GetNotificationsResponse,\n         // Notification preferences\n         DropshipperNotificationEventType,\n         DropshipperNotificationPreference,\n         UpdateNotificationPreferencesBody,\n         GetNotificationPreferencesResponse,\n        } from './admin';\n\n// ============================================\n// Dropshipper Business Policy Types\n// ============================================\nexport type {\n  GetBusinessPolicyResponse,\n  UpdateBusinessPolicyBody,\n  UpdateBusinessPolicyResponse,\n} from './dropshipper-business-policy';\n\n// ============================================\n// Header Configuration Types\n// ============================================\nexport type {\n  IconConfig,\n  NavigationCalloutItem,\n  NavigationLinkItem,\n  DynamicSource,\n  HeaderLinkItem,\n  AccountMenuItem,\n  AccountDropdownConfig,\n  SearchBarConfig,\n  HeaderNavigationConfig,\n} from './header-config';\n","/**\n * @thorprovider/types — Supported Providers\n *\n * Centralized list of all supported commerce providers.\n * This is the single source of truth for provider types across the monorepo.\n *\n * @remarks\n * - L1 (Foundation): Defines the contract\n * - L2 (@thorprovider/adapters) imports from here to build the factory\n * - L5 (Starters) uses the factory which is bound to this enum\n *\n * When adding a new provider (e.g., Stel Order):\n * 1. Add to SupportedProviderType enum below\n * 2. Update @thorprovider/adapters factory/index.ts with discriminated union\n * 3. Create packages/adapters/src/providers/shopify/\n * 4. Implement CommerceProvider interface\n * 5. Update StorefrontPlatformType in storefront.ts\n */\n\n/**\n * All supported commerce platform providers.\n * `mock` is the backend-optional runtime provider used for layout/design mode.\n * `medusa` is fully implemented for real backend usage; others are placeholders for future expansion.\n *\n * @remarks Implementation status:\n * - ✅ mock: Fixture-backed provider for backend-optional storefronts\n * - ✅ medusa: Fully implemented\n * - 🟡 stelorder: In progress (ERP adapter v1)\n * - 🟡 shopify: Planned (Phase 2)\n * - 🟡 bigcommerce: Planned (Phase 2)\n * - 🟡 woocommerce: Planned (Phase 3)\n * - 🟡 spree: Planned (Phase 3)\n * - 🟡 magento: Planned (Phase 3)\n */\nexport enum SupportedProviderType {\n  Mock = 'mock',\n  Medusa = 'medusa',\n  StelOrder = 'stelorder',\n  Shopify = 'shopify',\n  BigCommerce = 'bigcommerce',\n  WooCommerce = 'woocommerce',\n  Spree = 'spree',\n  Magento = 'magento',\n}\n\n/**\n * Union type of all supported provider string values.\n * Use this for type annotations when a provider type is expected.\n *\n * @example\n * ```typescript\n * function getProviderName(type: ProviderTypeString): string {\n *   // type is 'medusa'\n * }\n * ```\n */\nexport type ProviderTypeString = 'mock' | 'medusa' | 'stelorder' | 'shopify' | 'bigcommerce' | 'woocommerce' | 'spree' | 'magento';\n\n/**\n * Metadata about each provider.\n * Useful for UI, error messages, validation, and documentation.\n *\n * @internal\n */\nexport const PROVIDER_METADATA: Record<\n  ProviderTypeString,\n  {\n    name: string;\n    description: string;\n    requiresStorefront: boolean;\n    requiredEnvVars: string[];\n    maxRetries: number;\n  }\n> = {\n  mock: {\n    name: 'Mock',\n    description: 'Fixture-backed runtime provider for layout/design mode without a real backend',\n    requiresStorefront: false,\n    requiredEnvVars: [],\n    maxRetries: 0,\n  },\n  medusa: {\n    name: 'Medusa JS',\n    description: 'Medusa v2 commerce engine',\n    requiresStorefront: true,\n    requiredEnvVars: [\n      'NEXT_PUBLIC_COMMERCE_API_URL',\n      'NEXT_PUBLIC_COMMERCE_API_KEY',\n      'NEXT_PUBLIC_SALES_CHANNEL_ID',\n    ],\n    maxRetries: 3,\n  },\n  stelorder: {\n    name: 'Stel Order',\n    description: 'Stel Order ERP and sales document API',\n    requiresStorefront: false,\n    requiredEnvVars: [\n      'NEXT_PUBLIC_COMMERCE_API_URL',\n      'NEXT_PUBLIC_COMMERCE_API_KEY',\n    ],\n    maxRetries: 2,\n  },\n  shopify: {\n    name: 'Shopify',\n    description: 'Shopify Storefront API (GraphQL)',\n    requiresStorefront: false,\n    requiredEnvVars: [\n      'NEXT_PUBLIC_SHOPIFY_STORE_DOMAIN',\n      'NEXT_PUBLIC_SHOPIFY_STOREFRONT_TOKEN',\n    ],\n    maxRetries: 3,\n  },\n  bigcommerce: {\n    name: 'BigCommerce',\n    description: 'BigCommerce REST Storefront API',\n    requiresStorefront: false,\n    requiredEnvVars: [\n      'BIGCOMMERCE_STORE_HASH',\n      'BIGCOMMERCE_STOREFRONT_API_TOKEN',\n      'BIGCOMMERCE_CHANNEL_ID',\n    ],\n    maxRetries: 3,\n  },\n  woocommerce: {\n    name: 'WooCommerce',\n    description: 'WooCommerce Store API + REST API v3',\n    requiresStorefront: false,\n    requiredEnvVars: [\n      'WOOCOMMERCE_URL',\n      'WOOCOMMERCE_CONSUMER_KEY',\n      'WOOCOMMERCE_CONSUMER_SECRET',\n    ],\n    maxRetries: 3,\n  },\n  spree: {\n    name: 'Spree Commerce',\n    description: 'Spree API v2 Storefront (JSON:API)',\n    requiresStorefront: false,\n    requiredEnvVars: [\n      'SPREE_API_URL',\n    ],\n    maxRetries: 3,\n  },\n  magento: {\n    name: 'Adobe Commerce (Magento)',\n    description: 'Adobe Commerce GraphQL + REST API',\n    requiresStorefront: true,\n    requiredEnvVars: [\n      'MAGENTO_URL',\n      'MAGENTO_STORE_CODE',\n    ],\n    maxRetries: 3,\n  },\n};\n\n/**\n * Check if a string is a valid provider type.\n *\n * @example\n * ```typescript\n * if (isSupportedProviderType(process.env.COMMERCE_PROVIDER)) {\n *   // type is narrowed to ProviderTypeString\n * }\n * ```\n */\nexport function isSupportedProviderType(\n  value: unknown\n): value is ProviderTypeString {\n  return (\n    typeof value === 'string' &&\n    Object.values(SupportedProviderType).includes(value as SupportedProviderType)\n  );\n}\n\n/**\n * Get metadata for a provider type.\n * Useful for validation, error messages, and logging.\n *\n * @example\n * ```typescript\n * const meta = getProviderMetadata('medusa');\n * console.log(`Using ${meta.name} with max ${meta.maxRetries} retries`);\n * ```\n */\nexport function getProviderMetadata(\n  type: ProviderTypeString\n): (typeof PROVIDER_METADATA)[ProviderTypeString] {\n  if (!isSupportedProviderType(type)) {\n    throw new Error(\n      `Unsupported provider: ${type}. Supported: ${Object.values(\n        SupportedProviderType\n      ).join(', ')}`\n    );\n  }\n  return PROVIDER_METADATA[type];\n}\n","/**\n * @thorprovider/types — Storefront Context\n *\n * Platform-agnostic representation of a \"sales channel\" or equivalent.\n * Abstracts differences between Medusa sales_channel, Shopify publications,\n * BigCommerce channels, WooCommerce sites, Spree stores, and Magento store views.\n *\n * @remarks\n * - Required for all multi-tenant deployments\n * - Returned by `CommerceProvider.getStorefrontContext()`\n * - MUST be validated on startup; errors should NOT be silently ignored\n */\n\n/**\n * Supported commerce platform types for storefront identification.\n *\n * @remarks\n * Keep this type in sync with SupportedProviderType from provider.ts.\n * When adding a new provider, update both packages/types/src/provider.ts\n * and this type.\n *\n * Currently supported:\n * - ✅ 'mock': Backend-optional layout/design mode using fixture data\n * - ✅ 'medusa': Fully implemented\n * - 🟡 'stelorder': ERP adapter v1\n *\n * Planned (not yet implemented):\n * - 🟡 'shopify': Phase 2\n * - 🟡 'bigcommerce': Phase 2\n * - 🟡 'woocommerce': Phase 3\n * - 🟡 'spree': Phase 3\n * - 🟡 'magento': Phase 3\n */\nexport type StorefrontPlatformType = 'mock' | 'medusa' | 'stelorder' | 'shopify' | 'bigcommerce' | 'woocommerce' | 'spree' | 'magento';\n\n/**\n * StorefrontContext\n *\n * Platform-agnostic representation of a \"sales channel\" or equivalent.\n *\n * @example\n * ```typescript\n * const ctx: StorefrontContext = {\n *   id: 'sc_01J...',\n *   name: 'B2C Storefront',\n *   platformType: 'medusa',\n *   requiresProductScoping: true,\n *   currencyCode: 'USD',\n * };\n * ```\n */\nexport interface StorefrontContext {\n  /**\n   * Unique identifier for this storefront across the system.\n   * Examples: \"sc_123\" (Medusa), \"gid://shopify/Channel/789\" (Shopify), \"1\" (WooCommerce)\n   */\n  id: string;\n\n  /**\n   * Human-readable name for logging and debugging.\n   */\n  name: string;\n\n  /**\n   * Platform this storefront belongs to.\n   */\n  platformType: StorefrontPlatformType;\n\n  /**\n   * Whether products must be explicitly linked/published to this storefront.\n   *\n   * @remarks\n   * - Medusa: true (products must be linked to sales channel)\n * - Shopify: false (products visible by default unless unlisted)\n * - Stel Order: false (single-company ERP model, no native channel scoping)\n * - WooCommerce: false (no scoping concept)\n * - BigCommerce: false (products visible by default unless delisted)\n * - Spree: true (products must be assigned per store)\n * - Magento: true (products must be assigned per website)\n   */\n  requiresProductScoping: boolean;\n\n  /**\n   * Primary currency code for this storefront.\n   * Examples: \"USD\", \"EUR\", \"GBP\"\n   */\n  currencyCode: string;\n\n  /**\n   * Optional region or locale code.\n   * Examples: \"US\", \"EU\", \"en-US\", \"es-ES\"\n   */\n  locale?: string;\n\n  /**\n   * Optional: Store/Channel metadata from platform.\n   * @internal\n   */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Storefront validation error.\n * Thrown when storefront configuration is invalid or missing.\n *\n * @example\n * ```typescript\n * throw new StorefrontConfigError(\n *   'Medusa requires NEXT_PUBLIC_SALES_CHANNEL_ID',\n *   'medusa',\n *   'NEXT_PUBLIC_SALES_CHANNEL_ID',\n * );\n * ```\n */\nexport class StorefrontConfigError extends Error {\n  public readonly platformType: string;\n  public readonly requiredEnvVar?: string;\n\n  constructor(\n    message: string,\n    platformType: string,\n    requiredEnvVar?: string,\n  ) {\n    super(message);\n    this.name = 'StorefrontConfigError';\n    this.platformType = platformType;\n    this.requiredEnvVar = requiredEnvVar;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACkCO,IAAK,wBAAL,kBAAKA,2BAAL;AACL,EAAAA,uBAAA,UAAO;AACP,EAAAA,uBAAA,YAAS;AACT,EAAAA,uBAAA,eAAY;AACZ,EAAAA,uBAAA,aAAU;AACV,EAAAA,uBAAA,iBAAc;AACd,EAAAA,uBAAA,iBAAc;AACd,EAAAA,uBAAA,WAAQ;AACR,EAAAA,uBAAA,aAAU;AARA,SAAAA;AAAA,GAAA;AA8BL,IAAM,oBAST;AAAA,EACF,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB,CAAC;AAAA,IAClB,YAAY;AAAA,EACd;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,WAAW;AAAA,IACT,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,OAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AACF;AAYO,SAAS,wBACd,OAC6B;AAC7B,SACE,OAAO,UAAU,YACjB,OAAO,OAAO,qBAAqB,EAAE,SAAS,KAA8B;AAEhF;AAYO,SAAS,oBACd,MACgD;AAChD,MAAI,CAAC,wBAAwB,IAAI,GAAG;AAClC,UAAM,IAAI;AAAA,MACR,yBAAyB,IAAI,gBAAgB,OAAO;AAAA,QAClD;AAAA,MACF,EAAE,KAAK,IAAI,CAAC;AAAA,IACd;AAAA,EACF;AACA,SAAO,kBAAkB,IAAI;AAC/B;;;ACjFO,IAAM,wBAAN,cAAoC,MAAM;AAAA,EAC/B;AAAA,EACA;AAAA,EAEhB,YACE,SACA,cACA,gBACA;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,eAAe;AACpB,SAAK,iBAAiB;AAAA,EACxB;AACF;","names":["SupportedProviderType"]}

package/dist/index.mjs

@@ -1 +1,126 @@
+// src/provider.ts
+var SupportedProviderType = /* @__PURE__ */ ((SupportedProviderType2) => {
+  SupportedProviderType2["Mock"] = "mock";
+  SupportedProviderType2["Medusa"] = "medusa";
+  SupportedProviderType2["StelOrder"] = "stelorder";
+  SupportedProviderType2["Shopify"] = "shopify";
+  SupportedProviderType2["BigCommerce"] = "bigcommerce";
+  SupportedProviderType2["WooCommerce"] = "woocommerce";
+  SupportedProviderType2["Spree"] = "spree";
+  SupportedProviderType2["Magento"] = "magento";
+  return SupportedProviderType2;
+})(SupportedProviderType || {});
+var PROVIDER_METADATA = {
+  mock: {
+    name: "Mock",
+    description: "Fixture-backed runtime provider for layout/design mode without a real backend",
+    requiresStorefront: false,
+    requiredEnvVars: [],
+    maxRetries: 0
+  },
+  medusa: {
+    name: "Medusa JS",
+    description: "Medusa v2 commerce engine",
+    requiresStorefront: true,
+    requiredEnvVars: [
+      "NEXT_PUBLIC_COMMERCE_API_URL",
+      "NEXT_PUBLIC_COMMERCE_API_KEY",
+      "NEXT_PUBLIC_SALES_CHANNEL_ID"
+    ],
+    maxRetries: 3
+  },
+  stelorder: {
+    name: "Stel Order",
+    description: "Stel Order ERP and sales document API",
+    requiresStorefront: false,
+    requiredEnvVars: [
+      "NEXT_PUBLIC_COMMERCE_API_URL",
+      "NEXT_PUBLIC_COMMERCE_API_KEY"
+    ],
+    maxRetries: 2
+  },
+  shopify: {
+    name: "Shopify",
+    description: "Shopify Storefront API (GraphQL)",
+    requiresStorefront: false,
+    requiredEnvVars: [
+      "NEXT_PUBLIC_SHOPIFY_STORE_DOMAIN",
+      "NEXT_PUBLIC_SHOPIFY_STOREFRONT_TOKEN"
+    ],
+    maxRetries: 3
+  },
+  bigcommerce: {
+    name: "BigCommerce",
+    description: "BigCommerce REST Storefront API",
+    requiresStorefront: false,
+    requiredEnvVars: [
+      "BIGCOMMERCE_STORE_HASH",
+      "BIGCOMMERCE_STOREFRONT_API_TOKEN",
+      "BIGCOMMERCE_CHANNEL_ID"
+    ],
+    maxRetries: 3
+  },
+  woocommerce: {
+    name: "WooCommerce",
+    description: "WooCommerce Store API + REST API v3",
+    requiresStorefront: false,
+    requiredEnvVars: [
+      "WOOCOMMERCE_URL",
+      "WOOCOMMERCE_CONSUMER_KEY",
+      "WOOCOMMERCE_CONSUMER_SECRET"
+    ],
+    maxRetries: 3
+  },
+  spree: {
+    name: "Spree Commerce",
+    description: "Spree API v2 Storefront (JSON:API)",
+    requiresStorefront: false,
+    requiredEnvVars: [
+      "SPREE_API_URL"
+    ],
+    maxRetries: 3
+  },
+  magento: {
+    name: "Adobe Commerce (Magento)",
+    description: "Adobe Commerce GraphQL + REST API",
+    requiresStorefront: true,
+    requiredEnvVars: [
+      "MAGENTO_URL",
+      "MAGENTO_STORE_CODE"
+    ],
+    maxRetries: 3
+  }
+};
+function isSupportedProviderType(value) {
+  return typeof value === "string" && Object.values(SupportedProviderType).includes(value);
+}
+function getProviderMetadata(type) {
+  if (!isSupportedProviderType(type)) {
+    throw new Error(
+      `Unsupported provider: ${type}. Supported: ${Object.values(
+        SupportedProviderType
+      ).join(", ")}`
+    );
+  }
+  return PROVIDER_METADATA[type];
+}
+
+// src/storefront.ts
+var StorefrontConfigError = class extends Error {
+  platformType;
+  requiredEnvVar;
+  constructor(message, platformType, requiredEnvVar) {
+    super(message);
+    this.name = "StorefrontConfigError";
+    this.platformType = platformType;
+    this.requiredEnvVar = requiredEnvVar;
+  }
+};
+export {
+  PROVIDER_METADATA,
+  StorefrontConfigError,
+  SupportedProviderType,
+  getProviderMetadata,
+  isSupportedProviderType
+};
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../src/provider.ts","../src/storefront.ts"],"sourcesContent":["/**\n * @thorprovider/types — Supported Providers\n *\n * Centralized list of all supported commerce providers.\n * This is the single source of truth for provider types across the monorepo.\n *\n * @remarks\n * - L1 (Foundation): Defines the contract\n * - L2 (@thorprovider/adapters) imports from here to build the factory\n * - L5 (Starters) uses the factory which is bound to this enum\n *\n * When adding a new provider (e.g., Stel Order):\n * 1. Add to SupportedProviderType enum below\n * 2. Update @thorprovider/adapters factory/index.ts with discriminated union\n * 3. Create packages/adapters/src/providers/shopify/\n * 4. Implement CommerceProvider interface\n * 5. Update StorefrontPlatformType in storefront.ts\n */\n\n/**\n * All supported commerce platform providers.\n * `mock` is the backend-optional runtime provider used for layout/design mode.\n * `medusa` is fully implemented for real backend usage; others are placeholders for future expansion.\n *\n * @remarks Implementation status:\n * - ✅ mock: Fixture-backed provider for backend-optional storefronts\n * - ✅ medusa: Fully implemented\n * - 🟡 stelorder: In progress (ERP adapter v1)\n * - 🟡 shopify: Planned (Phase 2)\n * - 🟡 bigcommerce: Planned (Phase 2)\n * - 🟡 woocommerce: Planned (Phase 3)\n * - 🟡 spree: Planned (Phase 3)\n * - 🟡 magento: Planned (Phase 3)\n */\nexport enum SupportedProviderType {\n  Mock = 'mock',\n  Medusa = 'medusa',\n  StelOrder = 'stelorder',\n  Shopify = 'shopify',\n  BigCommerce = 'bigcommerce',\n  WooCommerce = 'woocommerce',\n  Spree = 'spree',\n  Magento = 'magento',\n}\n\n/**\n * Union type of all supported provider string values.\n * Use this for type annotations when a provider type is expected.\n *\n * @example\n * ```typescript\n * function getProviderName(type: ProviderTypeString): string {\n *   // type is 'medusa'\n * }\n * ```\n */\nexport type ProviderTypeString = 'mock' | 'medusa' | 'stelorder' | 'shopify' | 'bigcommerce' | 'woocommerce' | 'spree' | 'magento';\n\n/**\n * Metadata about each provider.\n * Useful for UI, error messages, validation, and documentation.\n *\n * @internal\n */\nexport const PROVIDER_METADATA: Record<\n  ProviderTypeString,\n  {\n    name: string;\n    description: string;\n    requiresStorefront: boolean;\n    requiredEnvVars: string[];\n    maxRetries: number;\n  }\n> = {\n  mock: {\n    name: 'Mock',\n    description: 'Fixture-backed runtime provider for layout/design mode without a real backend',\n    requiresStorefront: false,\n    requiredEnvVars: [],\n    maxRetries: 0,\n  },\n  medusa: {\n    name: 'Medusa JS',\n    description: 'Medusa v2 commerce engine',\n    requiresStorefront: true,\n    requiredEnvVars: [\n      'NEXT_PUBLIC_COMMERCE_API_URL',\n      'NEXT_PUBLIC_COMMERCE_API_KEY',\n      'NEXT_PUBLIC_SALES_CHANNEL_ID',\n    ],\n    maxRetries: 3,\n  },\n  stelorder: {\n    name: 'Stel Order',\n    description: 'Stel Order ERP and sales document API',\n    requiresStorefront: false,\n    requiredEnvVars: [\n      'NEXT_PUBLIC_COMMERCE_API_URL',\n      'NEXT_PUBLIC_COMMERCE_API_KEY',\n    ],\n    maxRetries: 2,\n  },\n  shopify: {\n    name: 'Shopify',\n    description: 'Shopify Storefront API (GraphQL)',\n    requiresStorefront: false,\n    requiredEnvVars: [\n      'NEXT_PUBLIC_SHOPIFY_STORE_DOMAIN',\n      'NEXT_PUBLIC_SHOPIFY_STOREFRONT_TOKEN',\n    ],\n    maxRetries: 3,\n  },\n  bigcommerce: {\n    name: 'BigCommerce',\n    description: 'BigCommerce REST Storefront API',\n    requiresStorefront: false,\n    requiredEnvVars: [\n      'BIGCOMMERCE_STORE_HASH',\n      'BIGCOMMERCE_STOREFRONT_API_TOKEN',\n      'BIGCOMMERCE_CHANNEL_ID',\n    ],\n    maxRetries: 3,\n  },\n  woocommerce: {\n    name: 'WooCommerce',\n    description: 'WooCommerce Store API + REST API v3',\n    requiresStorefront: false,\n    requiredEnvVars: [\n      'WOOCOMMERCE_URL',\n      'WOOCOMMERCE_CONSUMER_KEY',\n      'WOOCOMMERCE_CONSUMER_SECRET',\n    ],\n    maxRetries: 3,\n  },\n  spree: {\n    name: 'Spree Commerce',\n    description: 'Spree API v2 Storefront (JSON:API)',\n    requiresStorefront: false,\n    requiredEnvVars: [\n      'SPREE_API_URL',\n    ],\n    maxRetries: 3,\n  },\n  magento: {\n    name: 'Adobe Commerce (Magento)',\n    description: 'Adobe Commerce GraphQL + REST API',\n    requiresStorefront: true,\n    requiredEnvVars: [\n      'MAGENTO_URL',\n      'MAGENTO_STORE_CODE',\n    ],\n    maxRetries: 3,\n  },\n};\n\n/**\n * Check if a string is a valid provider type.\n *\n * @example\n * ```typescript\n * if (isSupportedProviderType(process.env.COMMERCE_PROVIDER)) {\n *   // type is narrowed to ProviderTypeString\n * }\n * ```\n */\nexport function isSupportedProviderType(\n  value: unknown\n): value is ProviderTypeString {\n  return (\n    typeof value === 'string' &&\n    Object.values(SupportedProviderType).includes(value as SupportedProviderType)\n  );\n}\n\n/**\n * Get metadata for a provider type.\n * Useful for validation, error messages, and logging.\n *\n * @example\n * ```typescript\n * const meta = getProviderMetadata('medusa');\n * console.log(`Using ${meta.name} with max ${meta.maxRetries} retries`);\n * ```\n */\nexport function getProviderMetadata(\n  type: ProviderTypeString\n): (typeof PROVIDER_METADATA)[ProviderTypeString] {\n  if (!isSupportedProviderType(type)) {\n    throw new Error(\n      `Unsupported provider: ${type}. Supported: ${Object.values(\n        SupportedProviderType\n      ).join(', ')}`\n    );\n  }\n  return PROVIDER_METADATA[type];\n}\n","/**\n * @thorprovider/types — Storefront Context\n *\n * Platform-agnostic representation of a \"sales channel\" or equivalent.\n * Abstracts differences between Medusa sales_channel, Shopify publications,\n * BigCommerce channels, WooCommerce sites, Spree stores, and Magento store views.\n *\n * @remarks\n * - Required for all multi-tenant deployments\n * - Returned by `CommerceProvider.getStorefrontContext()`\n * - MUST be validated on startup; errors should NOT be silently ignored\n */\n\n/**\n * Supported commerce platform types for storefront identification.\n *\n * @remarks\n * Keep this type in sync with SupportedProviderType from provider.ts.\n * When adding a new provider, update both packages/types/src/provider.ts\n * and this type.\n *\n * Currently supported:\n * - ✅ 'mock': Backend-optional layout/design mode using fixture data\n * - ✅ 'medusa': Fully implemented\n * - 🟡 'stelorder': ERP adapter v1\n *\n * Planned (not yet implemented):\n * - 🟡 'shopify': Phase 2\n * - 🟡 'bigcommerce': Phase 2\n * - 🟡 'woocommerce': Phase 3\n * - 🟡 'spree': Phase 3\n * - 🟡 'magento': Phase 3\n */\nexport type StorefrontPlatformType = 'mock' | 'medusa' | 'stelorder' | 'shopify' | 'bigcommerce' | 'woocommerce' | 'spree' | 'magento';\n\n/**\n * StorefrontContext\n *\n * Platform-agnostic representation of a \"sales channel\" or equivalent.\n *\n * @example\n * ```typescript\n * const ctx: StorefrontContext = {\n *   id: 'sc_01J...',\n *   name: 'B2C Storefront',\n *   platformType: 'medusa',\n *   requiresProductScoping: true,\n *   currencyCode: 'USD',\n * };\n * ```\n */\nexport interface StorefrontContext {\n  /**\n   * Unique identifier for this storefront across the system.\n   * Examples: \"sc_123\" (Medusa), \"gid://shopify/Channel/789\" (Shopify), \"1\" (WooCommerce)\n   */\n  id: string;\n\n  /**\n   * Human-readable name for logging and debugging.\n   */\n  name: string;\n\n  /**\n   * Platform this storefront belongs to.\n   */\n  platformType: StorefrontPlatformType;\n\n  /**\n   * Whether products must be explicitly linked/published to this storefront.\n   *\n   * @remarks\n   * - Medusa: true (products must be linked to sales channel)\n * - Shopify: false (products visible by default unless unlisted)\n * - Stel Order: false (single-company ERP model, no native channel scoping)\n * - WooCommerce: false (no scoping concept)\n * - BigCommerce: false (products visible by default unless delisted)\n * - Spree: true (products must be assigned per store)\n * - Magento: true (products must be assigned per website)\n   */\n  requiresProductScoping: boolean;\n\n  /**\n   * Primary currency code for this storefront.\n   * Examples: \"USD\", \"EUR\", \"GBP\"\n   */\n  currencyCode: string;\n\n  /**\n   * Optional region or locale code.\n   * Examples: \"US\", \"EU\", \"en-US\", \"es-ES\"\n   */\n  locale?: string;\n\n  /**\n   * Optional: Store/Channel metadata from platform.\n   * @internal\n   */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Storefront validation error.\n * Thrown when storefront configuration is invalid or missing.\n *\n * @example\n * ```typescript\n * throw new StorefrontConfigError(\n *   'Medusa requires NEXT_PUBLIC_SALES_CHANNEL_ID',\n *   'medusa',\n *   'NEXT_PUBLIC_SALES_CHANNEL_ID',\n * );\n * ```\n */\nexport class StorefrontConfigError extends Error {\n  public readonly platformType: string;\n  public readonly requiredEnvVar?: string;\n\n  constructor(\n    message: string,\n    platformType: string,\n    requiredEnvVar?: string,\n  ) {\n    super(message);\n    this.name = 'StorefrontConfigError';\n    this.platformType = platformType;\n    this.requiredEnvVar = requiredEnvVar;\n  }\n}\n"],"mappings":";AAkCO,IAAK,wBAAL,kBAAKA,2BAAL;AACL,EAAAA,uBAAA,UAAO;AACP,EAAAA,uBAAA,YAAS;AACT,EAAAA,uBAAA,eAAY;AACZ,EAAAA,uBAAA,aAAU;AACV,EAAAA,uBAAA,iBAAc;AACd,EAAAA,uBAAA,iBAAc;AACd,EAAAA,uBAAA,WAAQ;AACR,EAAAA,uBAAA,aAAU;AARA,SAAAA;AAAA,GAAA;AA8BL,IAAM,oBAST;AAAA,EACF,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB,CAAC;AAAA,IAClB,YAAY;AAAA,EACd;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,WAAW;AAAA,IACT,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,OAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,IACb,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,IACF;AAAA,IACA,YAAY;AAAA,EACd;AACF;AAYO,SAAS,wBACd,OAC6B;AAC7B,SACE,OAAO,UAAU,YACjB,OAAO,OAAO,qBAAqB,EAAE,SAAS,KAA8B;AAEhF;AAYO,SAAS,oBACd,MACgD;AAChD,MAAI,CAAC,wBAAwB,IAAI,GAAG;AAClC,UAAM,IAAI;AAAA,MACR,yBAAyB,IAAI,gBAAgB,OAAO;AAAA,QAClD;AAAA,MACF,EAAE,KAAK,IAAI,CAAC;AAAA,IACd;AAAA,EACF;AACA,SAAO,kBAAkB,IAAI;AAC/B;;;ACjFO,IAAM,wBAAN,cAAoC,MAAM;AAAA,EAC/B;AAAA,EACA;AAAA,EAEhB,YACE,SACA,cACA,gBACA;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,eAAe;AACpB,SAAK,iBAAiB;AAAA,EACxB;AACF;","names":["SupportedProviderType"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thorprovider/types",
-  "version": "5.7.9",
+  "version": "5.7.10",
   "description": "Shared TypeScript types for Thor Commerce ecosystem - Framework-agnostic type definitions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,4 +32,4 @@
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"
   }
-}
+}

package/src/admin/DropshippingAdmin.ts

@@ -1005,6 +1005,8 @@ export interface CreateDropshipperOrderBody {
   /** One selected option per shipping group (contract v2). Replaces `shipping_method_id`. */
   shipping_groups?: ShippingGroupInput[];
   payment_method_id: string;
+  /** Código de gift card (obligatorio si el método de pago es gift card). */
+  gift_card_code?: string;
   notes?: string;
 }
 
@@ -1025,6 +1027,22 @@ export interface SetPaymentCollectorBody {
   payment_collected_by: 'dropshipper' | 'provider';
 }
 
+/** Body for `POST /admin/thor/dropshipper/gift-cards/validate` */
+export interface ValidateGiftCardBody {
+  code: string;
+  /** Moneda de la orden: si se envía, se valida que la gift card coincida. */
+  currency_code?: string;
+}
+
+/** Response for `POST /admin/thor/dropshipper/gift-cards/validate` */
+export interface ValidateGiftCardResponse {
+  valid: boolean;
+  /** Mensaje de usuario cuando `valid` es false. */
+  reason?: string;
+  balance?: number;
+  currency_code?: string;
+}
+
 /** Response for `POST /admin/thor/dropshipper/orders/:id/set-payment-collector` */
 export interface SetPaymentCollectorResponse {
   order_id: string;
@@ -1136,6 +1154,8 @@ export interface DropshipperDraftOrder {
   /** @deprecated legacy singular shipping method id; use `shipping_groups` instead. */
   shipping_method_id: string | null;
   payment_method_id: string | null;
+  /** Código de gift card persistido en el borrador (metadata). */
+  gift_card_code?: string | null;
   notes: string | null;
   converted_order_id: string | null; // Reference to Medusa order.id after conversion
   converted_at: string | null; // ISO timestamp when converted
@@ -1186,6 +1206,7 @@ export interface CreateDropshipperDraftOrderBody {
   /** @deprecated legacy singular shipping method id; use `shipping_groups` instead. */
   shipping_method_id?: string;
   payment_method_id?: string;
+  gift_card_code?: string;
   notes?: string;
 }
 
@@ -1211,6 +1232,7 @@ export interface UpdateDropshipperDraftOrderBody {
   /** @deprecated legacy singular shipping method id; use `shipping_groups` instead. */
   shipping_method_id?: string;
   payment_method_id?: string;
+  gift_card_code?: string;
   notes?: string;
 }
 
@@ -1237,6 +1259,39 @@ export interface DeleteDropshipperDraftOrderResponse {
   deleted: boolean;
 }
 
+// ============================================================
+// Order totals preview (Solo Y)
+// ============================================================
+
+/** Item for `POST /admin/thor/dropshipper/orders/preview-totals` */
+export interface PreviewDropshipperOrderItem {
+  variant_id: string;
+  quantity: number;
+  /** Sale price per unit the dropshipper intends to charge (honored over the catalog price). */
+  unit_price?: number;
+}
+
+/** Body for `POST /admin/thor/dropshipper/orders/preview-totals` */
+export interface PreviewDropshipperOrderTotalsBody {
+  customer_id: string;
+  currency_code: string;
+  items: PreviewDropshipperOrderItem[];
+  shipping_address: DropshipperOrderShippingAddress;
+  /** One selected option per shipping group (contract v2). Required when any item needs shipping. */
+  shipping_groups?: ShippingGroupInput[];
+}
+
+/** Response for `POST /admin/thor/dropshipper/orders/preview-totals` */
+export interface PreviewDropshipperOrderTotalsResponse {
+  subtotal: number;
+  items_subtotal: number;
+  shipping_subtotal: number;
+  shipping_total: number;
+  tax_total: number;
+  discount_total: number;
+  total: number;
+}
+
 // ============================================================
 // Custom Categories (Solo Y)
 // ============================================================
@@ -1878,6 +1933,8 @@ export interface DashboardStats {
     total: number;
     profit: number;
     status: string;
+    /** Estado de cobro crudo del backend (captured/authorized/partially_captured/...). */
+    payment_status: string;
     created_at: string;
   }>;
   top_products_by_profit: DashboardTopProduct[];

package/src/cart.ts

@@ -26,13 +26,6 @@ export interface CartItem {
   stockStatus?: StockStatus;
   cost: {
     totalAmount: Money;
-    /**
-     * Backend unit price for a single quantity, when the backend supplies it.
-     *
-     * Carried so the display never derives a unit price locally; absent when
-     * the backend did not return one.
-     */
-    unitPrice?: Money;
   };
   merchandise: {
     id: string;
@@ -44,20 +37,11 @@ export interface CartItem {
 
 /**
  * Cart cost breakdown
- *
- * Every amount is backend-authoritative: the adapter carries the backend's
- * value through unchanged (including a legitimate `"0"`) and never derives a
- * total locally. An optional amount is absent only when the backend did not
- * supply it.
  */
 export interface CartCost {
   subtotalAmount: Money;
   totalAmount: Money;
   totalTaxAmount?: Money;
-  /** Backend discount total, when supplied. */
-  discountAmount?: Money;
-  /** Backend shipping total, when supplied. */
-  shippingAmount?: Money;
 }
 
 /**
@@ -100,30 +84,6 @@ export interface Cart {
   stockValidation?: StockValidation;
   /** ISO timestamp when cart was completed/converted to order (undefined if active) */
   completedAt?: string;
-  /**
-   * Backend sales channel the cart is scoped to.
-   *
-   * Carried so the runtime can enforce that a cart belongs to the validated
-   * single-store context before it is mutated; absent when a provider does not
-   * expose it.
-   */
-  salesChannelId?: string;
-  /** Backend region the cart is scoped to (context enforcement). */
-  regionId?: string;
-  /** Backend currency code, uppercased (context enforcement). */
-  currencyCode?: string;
-  /** Backend id of the applied shipping method, when one is selected. */
-  selectedShippingMethodId?: string;
-  /**
-   * Backend id of the shipping option the applied method was created from.
-   *
-   * This is the identity the checkout shipping UI selects (the value passed to
-   * `addShippingMethod`), which is distinct from `selectedShippingMethodId`
-   * (the applied shipping-method record id). Absent when no method is applied.
-   */
-  selectedShippingOptionId?: string;
-  /** Platform-specific backend metadata, carried through unchanged. */
-  metadata?: Record<string, unknown>;
 }
 
 /**

package/src/collection.ts

@@ -26,16 +26,6 @@ export interface GetCollectionsOptions {
   limit?: number;
   /** Search query to filter collections by title */
   query?: string;
-  /**
-   * Scope results to a specific sales channel / storefront channel.
-   * When provided, only collections that contain at least one product available
-   * in the given channel will be returned.
-   *
-   * Maps to: Medusa `sales_channel_id`, Shopify Sales Channel, etc.
-   * Adapters that support native server-side filtering should prefer it;
-   * others may fall back to a client-side post-filter pass.
-   */
-  salesChannelId?: string;
 }
 
 /**

package/src/commerce-provider.ts

@@ -40,7 +40,6 @@ import type { StorefrontContext } from './storefront';
 import type { StockLocation, InventoryLevel, StockValidation, FulfillmentOption } from './stock-location';
 import type { StorefrontConfig } from './storefront-config';
 import type { DesignerConfig, DesignerHistoryEntry } from './designer-config';
-import type { CatalogQuery, CatalogQueryOutcome, CatalogSortKey } from './catalog';
 
 /**
  * Backend capabilities interface
@@ -214,22 +213,6 @@ export interface CommerceProvider {
    */
   readonly capabilities: BackendCapabilities;
 
-  /**
-   * Canonical catalog sort keys this provider can actually apply at the query
-   * level (E2 `storefront-catalog-search-filters`, design Decision 6).
-   *
-   * Advertises only backend-verified orderings — for Medusa, `featured`
-   * (server default), `name` (translated to `title`), and `newest` (translated
-   * to `-created_at`). A global price or rating sort is never advertised. The
-   * runtime query boundary consumes this set as `supportedSortKeys` and turns a
-   * requested sort outside it into a typed unsupported-query error, so the
-   * listing never offers an ordering the backend cannot perform.
-   *
-   * Optional and additive: when absent, no ordering beyond the canonical default
-   * is assumed from the advertisement.
-   */
-  readonly supportedCatalogSortKeys?: readonly CatalogSortKey[];
-
   /**
    * Whether this provider is backed by fixture/mock data instead of a live backend.
    *
@@ -264,25 +247,6 @@ export interface CommerceProvider {
    * for layout/design workflows until a real backend is configured.
    */
   getProducts(options?: GetProductsOptions): Promise<Product[]>;
-
-  /**
-   * Run a canonical, validated catalog query against the real listing endpoint
-   * (OPTIONAL — E2 `storefront-catalog-search-filters`, task 2.2).
-   *
-   * The adapter translates the canonical `CatalogQuery` (text, the route
-   * category scope plus `categories`/`collections`, sort, pagination, and
-   * requested filters) into its backend's parameters and returns a truthful
-   * `CatalogQueryOutcome`: `{ ok: true, results }` only when **every** requested
-   * filter was applied, or `{ ok: false, error }` with `code:
-   * 'unsupported-query'` naming the fields it cannot apply. It never returns a
-   * partial result labelled success and never silently drops a requested filter.
-   *
-   * Optional and additive: providers that cannot forward a canonical query omit
-   * it and callers fall back to `getProducts`/`getCategoryProducts`. The legacy
-   * zero-argument and options-based methods keep their `Product[]` return and
-   * are unchanged. This is the typed seam the runtime catalog bridge consumes.
-   */
-  getCatalogProducts?(query: CatalogQuery): Promise<CatalogQueryOutcome>;
   
   /**
    * Get product recommendations for a given product