@thorprovider/types 3.4.1 → 3.5.0

package/AGENTS.md

@@ -1 +1 @@
-<!-- TYPES-AGENTS-MD-START -->[@thorprovider/types Docs]|root: ./types|Documentation for @thorprovider/types. Always read package docs before making changes.|To regenerate: yarn workspace @thorprovider/types generate:agent-index|.:{README.md}|src:{header-config.README.md}<!-- TYPES-AGENTS-MD-END -->
+<!-- TYPES-AGENTS-MD-START -->[@thorprovider/types Docs]|root: ./types|Documentation for @thorprovider/types. Always read package docs before making changes.|To regenerate: yarn generate:agents-index|.:{README.md}|src:{header-config.README.md}<!-- TYPES-AGENTS-MD-END -->

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @thorprovider/types Changelog
 
+## 3.5.0
+
+### Minor Changes
+
+- Add dropshipper shipping-option and extended manual-order types for the canonical order SDK contract.
+
 ## 3.2.1
 
 ### Patch Changes

package/README.md

@@ -214,8 +214,10 @@ import type { Product, Cart, CartItem, Collection } from '@thorprovider/types';
 - **Auth**: AuthProvider, LoginCredentials, RegisterData
 - **Storefront**: StorefrontConfig, StorefrontContext
 - **CommerceProvider**: CommerceProvider interface (includes optional `updateShippingAddress?`)
-- **Dropshipping**: DropshipperAccount, DropshipperVariantCost, DropshipperCategory, DropshipperPromotion, DropshipperSettlement — plus all request/response types for the 41+ `DropshipperClient` methods (see `src/admin/DropshippingAdmin.ts`)
+- **Dropshipping**: DropshipperAccount, DropshipperVariantCost, DropshipperCategory, DropshipperPromotion, DropshipperSettlement — plus all request/response types for the 53+ `DropshipperClient` methods (see `src/admin/DropshippingAdmin.ts`)
   - **Order Notes** (part of Dropshipping): OrderNote, CreateOrderNoteBody, GetOrderNotesResponse, DeleteOrderNoteResponse — for managing notes on dropshipper orders
+  - **Provider Categories** (part of Dropshipping): ProviderCategory, GetProviderCategoriesResponse — Medusa native categories exposed via dropshipper API
+  - **Category Mappings** (part of Dropshipping): CategoryMapping, GetCategoryMappingsOptions, GetCategoryMappingsResponse — M:N links between products and custom categories
 
 ## Architecture
 

package/dist/index.d.mts

@@ -3868,6 +3868,51 @@ interface GetDropshipperOrdersResponse {
     offset: number;
     limit: number;
 }
+/** A shipping option returned for manual dropshipper orders */
+interface DropshipperShippingOption {
+    id: string;
+    name: string;
+    amount: number;
+    currency_code: string;
+    price_type: string;
+    is_default: boolean;
+    type: {
+        id: string;
+        label: string;
+        code: string | null;
+    } | null;
+}
+/** Options for `GET /admin/thor/dropshipper/orders/shipping-options` */
+interface GetDropshipperShippingOptionsParams {
+    currency_code: string;
+    country_code?: string;
+}
+/** Response for `GET /admin/thor/dropshipper/orders/shipping-options` */
+interface GetDropshipperShippingOptionsResponse {
+    shipping_options: DropshipperShippingOption[];
+    count: number;
+}
+/** Body for `POST /admin/thor/dropshipper/orders` with checkout-only extensions */
+interface ExtendedCreateDropshipperOrderBody extends CreateDropshipperOrderBody {
+    billing_address?: CreateDropshipperOrderBody['shipping_address'];
+    promo_codes?: string[];
+}
+/** Response for `POST /admin/thor/dropshipper/orders` with totals and shipping method */
+interface ExtendedCreateDropshipperOrderResponse {
+    order: {
+        id: string;
+        display_id: number;
+        status: string;
+        subtotal: number;
+        tax_total: number;
+        shipping_total: number;
+        discount_total: number;
+        total: number;
+        profit: number;
+        created_at: string;
+        shipping_method?: DropshipperShippingOption | null;
+    };
+}
 /** A shipping address on an order */
 interface DropshipperOrderShippingAddress {
     full_name: string;
@@ -4072,6 +4117,36 @@ interface DeleteCategoryMappingResponse {
     deleted: true;
     id: string;
 }
+/** A Medusa ProductCategory as exposed to the dropshipper (read-only) */
+interface ProviderCategory {
+    id: string;
+    name: string;
+    handle: string;
+    parent_category_id: string | null;
+}
+/** Response for `GET /admin/thor/dropshipper/categories/provider` */
+interface GetProviderCategoriesResponse {
+    categories: ProviderCategory[];
+}
+/** Options for `GET /admin/thor/dropshipper/category-mappings` */
+interface GetCategoryMappingsOptions {
+    /** Filter mappings by product */
+    product_id?: string;
+}
+/** A single category mapping entry */
+interface CategoryMapping {
+    id: string;
+    product_id: string;
+    category_id: string;
+    category_name: string;
+    category_handle: string;
+    created_at: string;
+}
+/** Response for `GET /admin/thor/dropshipper/category-mappings` */
+interface GetCategoryMappingsResponse {
+    mappings: CategoryMapping[];
+    count: number;
+}
 /** A customer as seen by the dropshipper (list view) */
 interface DropshipperCustomer {
     id: string;
@@ -4487,8 +4562,9 @@ interface DeleteOrderNoteResponse {
 }
 /** Body for creating/updating a dropshipper address */
 interface DropshipperAddressBody {
-    first_name: string;
-    last_name: string;
+    address_name?: string;
+    first_name?: string;
+    last_name?: string;
     company?: string;
     address_1: string;
     address_2?: string;
@@ -4498,6 +4574,8 @@ interface DropshipperAddressBody {
     country_code: string;
     phone?: string;
     is_default?: boolean;
+    is_default_shipping?: boolean;
+    is_default_billing?: boolean;
 }
 /** Response for creating or updating a dropshipper address */
 interface DropshipperAddressResponse {
@@ -4513,4 +4591,4 @@ interface GetStorefrontDropshipperCategoriesResponse {
     categories: DropshipperCategory[];
 }
 
-export { type AccountDropdownConfig, type AccountMenuItem, type ActiveFilter, type AddOrderEditItemBody, type AddOrderEditItemResponse, type Address, type AdminApiKey, type AdminChannelCategory, type AdminChannelCustomer, type AdminDropshipperAccount, type AdminDropshipperBalance, type AdminProduct, type AdminProductVariant, type AdminSalesChannelRef, type AdminSiteConfig, type AdminSiteConfigHistoryEntry, type AdminSiteConfigHistoryEntryFull, type AdminStorefrontConfig, type AdminStorefrontSeoDefaults, type AdminUser, type AdvancedSearchProductsOptions, type AssignCategoriesToChannelsBody, type AssignCategoriesToChannelsResponse, type AssignCollectionsToChannelsBody, type AssignCollectionsToChannelsResponse, type AuditLog, type AuditLogAdapter, type AuthConfig, type AuthMethod, type AuthProvider, type AuthResponse, type AuthStorage, type AuthorConfig, type BackendCapabilities, type BatchVariantCostItem, type BatchVariantCostsBody, type BatchVariantCostsResponse, type BrandConfig, type CachedPaymentMethods, type CancelDropshipperOrderResponse, type CancelSettlementBody, type Cart, type CartCost, type CartItem, type CartLineInput, type CartLineUpdate, type CartProduct, type ChartDataPoint, type Collection, type CollectionProductsOptions, type CommerceProvider, type CompareProduct, type ConfigHistoryEntry, type ConfirmOrderEditResponse, type ConfirmSettlementBody, type Connection, type Country, type CreateAddressData, type CreateCategoryMappingBody, type CreateCategoryMappingResponse, type CreateDropshipperCategoryBody, type CreateDropshipperCustomerBody, type CreateDropshipperCustomerResponse, type CreateDropshipperOrderBody, type CreateDropshipperOrderResponse, type CreateDropshipperPromotionBody, type CreateOrderEditBody, type CreateOrderEditResponse, type CreateOrderItem, type CreateOrderNoteBody, type CreateSettlementBody, type CreateSettlementResponse, type CreateVariantCostBody, type CreateVariantCostResponse, type Customer, type DashboardChanges, type DashboardConfig, type DashboardMetrics, type DashboardMetricsAdapter, type DashboardOrdersAdapter, type DashboardPeriodMetrics, type DashboardProductsAdapter, type DashboardStats, type DashboardTopProduct, type DeleteCategoryMappingResponse, type DeleteDropshipperCategoryResponse, type DeleteDropshipperPromotionResponse, type DeleteOrderNoteResponse, type DeleteVariantCostResponse, type DesignerConfig, type DesignerHistoryEntry, type DesignerNavItem, type DesignerThemeConfig, type DesignerThemePreset, type DiscountCode, type DropshipperAccount, type DropshipperAccountRef, type DropshipperAddressBody, type DropshipperAddressResponse, type DropshipperBalance, type DropshipperCategory, type DropshipperCustomer, type DropshipperCustomerDetail, type DropshipperCustomerOrderRef, type DropshipperCustomerStats, type DropshipperOrder, type DropshipperOrderCustomer, type DropshipperOrderDetail, type DropshipperOrderItem, type DropshipperOrderShippingAddress, type DropshipperOrderTimelineEvent, type DropshipperOrderTotals, type DropshipperPayableOrder, type DropshipperPendingOrders, type DropshipperPriceItem, type DropshipperProduct, type DropshipperPromotion, type DropshipperReceivableOrder, type DropshipperVariant, type DynamicSource, type Edge, type FilterConfig, type FilterOption, type FilterSection, type FulfillmentOption, type FulfillmentSet, type FulfillmentStatus, type GetAdminAccountBalanceResponse, type GetAdminDropshipperAccountsResponse, type GetAdminPriceListsResponse, type GetAdminSiteConfigHistoryOptions, type GetAdminSiteConfigHistoryResponse, type GetAdminSiteConfigResponse, type GetAdminStorefrontConfigResponse, type GetCategoriesCallback, type GetCategoriesOptions, type GetCategorySalesChannelsResponse, type GetChannelApiKeysResponse, type GetChannelCategoriesOptions, type GetChannelCategoriesResponse, type GetChannelCustomersOptions, type GetChannelCustomersResponse, type GetCollectionSalesChannelsResponse, type GetCollectionsOptions, type GetCustomersCallback, type GetCustomersOptions, type GetDashboardStatsOptions, type GetDashboardStatsResponse, type GetDropshipperAccountResponse, type GetDropshipperAddressesResponse, type GetDropshipperCategoriesOptions, type GetDropshipperCategoriesResponse, type GetDropshipperCustomerDetailResponse, type GetDropshipperCustomersOptions, type GetDropshipperCustomersResponse, type GetDropshipperOrderDetailResponse, type GetDropshipperOrdersOptions, type GetDropshipperOrdersResponse, type GetDropshipperPayableResponse, type GetDropshipperProductsOptions, type GetDropshipperProductsResponse, type GetDropshipperPromotionsOptions, type GetDropshipperPromotionsResponse, type GetDropshipperReceivableResponse, type GetOrderNotesResponse, type GetOrdersCallback, type GetOrdersOptions, type GetProductsOptions, type GetSettlementDetailResponse, type GetSettlementsOptions, type GetSettlementsResponse, type GetStorefrontDropshipperCategoriesResponse, type GetUserChannelResponse, type GetVariantCostsOptions, type GetVariantCostsResponse, type HeaderLinkItem, type HeaderNavigationConfig, type IconConfig, type Image, type InventoryLevel, type LinkCustomerToChannelResponse, type LoginCredentials, type ModulesConfig, type Money, type NavigationCalloutItem, type NavigationItem, type NavigationLinkItem, type OnboardDropshipperBody, type OnboardDropshipperResponse, type Order, type OrderItem, type OrderNote, type OrderStatus, type OrdersMetrics, PROVIDER_METADATA, type PaginationOptions, type PasswordResetConfirm, type PasswordResetRequest, type PaymentMethod, type PaymentMethodFeatures, type PaymentMethodType, type PaymentMethodsOptions, type PaymentStatus, type PriceRange, type Product, type ProductCategory, type ProductOption, type ProductPreview, type ProductVariant, type ProductsMetrics, type PromotionRule, type ProviderConfig, type ProviderTypeString, type Region, type RegisterData, type RestoreSiteConfigResponse, type Review, type SEO, type SalesMetrics, type SearchBarConfig, type SearchResultMeta, type SelectedOption, type SetPaymentCollectorBody, type SetPaymentCollectorResponse, type SettlementRecord, type ShippingMethod, type SiteConfig, type SiteConfigLabels, type SiteConfigMetadata, type SocialConfig, type SortOption, type SortOptions, type StockLocation, type StockStatus, type StockValidation, type StorefrontConfig, StorefrontConfigError, type StorefrontContext, type StorefrontPlatformType, type StorefrontSeoDefaults, SupportedProviderType, type UnassignCategoriesFromChannelsBody, type UnassignCategoriesFromChannelsResponse, type UnassignCollectionsFromChannelsBody, type UnassignCollectionsFromChannelsResponse, type UpdateCustomerData, type UpdateDropshipperCategoryBody, type UpdateDropshipperPricesBody, type UpdateDropshipperPricesResponse, type UpdateDropshipperPromotionBody, type UpdateSettlementStatusResponse, type UpdateSiteConfigBody, type UpdateSiteConfigResponse, type UpdateStorefrontConfigBody, type UpdateStorefrontConfigResponse, type VariantCost, getProviderMetadata, isSupportedProviderType };
+export { type AccountDropdownConfig, type AccountMenuItem, type ActiveFilter, type AddOrderEditItemBody, type AddOrderEditItemResponse, type Address, type AdminApiKey, type AdminChannelCategory, type AdminChannelCustomer, type AdminDropshipperAccount, type AdminDropshipperBalance, type AdminProduct, type AdminProductVariant, type AdminSalesChannelRef, type AdminSiteConfig, type AdminSiteConfigHistoryEntry, type AdminSiteConfigHistoryEntryFull, type AdminStorefrontConfig, type AdminStorefrontSeoDefaults, type AdminUser, type AdvancedSearchProductsOptions, type AssignCategoriesToChannelsBody, type AssignCategoriesToChannelsResponse, type AssignCollectionsToChannelsBody, type AssignCollectionsToChannelsResponse, type AuditLog, type AuditLogAdapter, type AuthConfig, type AuthMethod, type AuthProvider, type AuthResponse, type AuthStorage, type AuthorConfig, type BackendCapabilities, type BatchVariantCostItem, type BatchVariantCostsBody, type BatchVariantCostsResponse, type BrandConfig, type CachedPaymentMethods, type CancelDropshipperOrderResponse, type CancelSettlementBody, type Cart, type CartCost, type CartItem, type CartLineInput, type CartLineUpdate, type CartProduct, type CategoryMapping, type ChartDataPoint, type Collection, type CollectionProductsOptions, type CommerceProvider, type CompareProduct, type ConfigHistoryEntry, type ConfirmOrderEditResponse, type ConfirmSettlementBody, type Connection, type Country, type CreateAddressData, type CreateCategoryMappingBody, type CreateCategoryMappingResponse, type CreateDropshipperCategoryBody, type CreateDropshipperCustomerBody, type CreateDropshipperCustomerResponse, type CreateDropshipperOrderBody, type CreateDropshipperOrderResponse, type CreateDropshipperPromotionBody, type CreateOrderEditBody, type CreateOrderEditResponse, type CreateOrderItem, type CreateOrderNoteBody, type CreateSettlementBody, type CreateSettlementResponse, type CreateVariantCostBody, type CreateVariantCostResponse, type Customer, type DashboardChanges, type DashboardConfig, type DashboardMetrics, type DashboardMetricsAdapter, type DashboardOrdersAdapter, type DashboardPeriodMetrics, type DashboardProductsAdapter, type DashboardStats, type DashboardTopProduct, type DeleteCategoryMappingResponse, type DeleteDropshipperCategoryResponse, type DeleteDropshipperPromotionResponse, type DeleteOrderNoteResponse, type DeleteVariantCostResponse, type DesignerConfig, type DesignerHistoryEntry, type DesignerNavItem, type DesignerThemeConfig, type DesignerThemePreset, type DiscountCode, type DropshipperAccount, type DropshipperAccountRef, type DropshipperAddressBody, type DropshipperAddressResponse, type DropshipperBalance, type DropshipperCategory, type DropshipperCustomer, type DropshipperCustomerDetail, type DropshipperCustomerOrderRef, type DropshipperCustomerStats, type DropshipperOrder, type DropshipperOrderCustomer, type DropshipperOrderDetail, type DropshipperOrderItem, type DropshipperOrderShippingAddress, type DropshipperOrderTimelineEvent, type DropshipperOrderTotals, type DropshipperPayableOrder, type DropshipperPendingOrders, type DropshipperPriceItem, type DropshipperProduct, type DropshipperPromotion, type DropshipperReceivableOrder, type DropshipperShippingOption, type DropshipperVariant, type DynamicSource, type Edge, type ExtendedCreateDropshipperOrderBody, type ExtendedCreateDropshipperOrderResponse, type FilterConfig, type FilterOption, type FilterSection, type FulfillmentOption, type FulfillmentSet, type FulfillmentStatus, type GetAdminAccountBalanceResponse, type GetAdminDropshipperAccountsResponse, type GetAdminPriceListsResponse, type GetAdminSiteConfigHistoryOptions, type GetAdminSiteConfigHistoryResponse, type GetAdminSiteConfigResponse, type GetAdminStorefrontConfigResponse, type GetCategoriesCallback, type GetCategoriesOptions, type GetCategoryMappingsOptions, type GetCategoryMappingsResponse, type GetCategorySalesChannelsResponse, type GetChannelApiKeysResponse, type GetChannelCategoriesOptions, type GetChannelCategoriesResponse, type GetChannelCustomersOptions, type GetChannelCustomersResponse, type GetCollectionSalesChannelsResponse, type GetCollectionsOptions, type GetCustomersCallback, type GetCustomersOptions, type GetDashboardStatsOptions, type GetDashboardStatsResponse, type GetDropshipperAccountResponse, type GetDropshipperAddressesResponse, type GetDropshipperCategoriesOptions, type GetDropshipperCategoriesResponse, type GetDropshipperCustomerDetailResponse, type GetDropshipperCustomersOptions, type GetDropshipperCustomersResponse, type GetDropshipperOrderDetailResponse, type GetDropshipperOrdersOptions, type GetDropshipperOrdersResponse, type GetDropshipperPayableResponse, type GetDropshipperProductsOptions, type GetDropshipperProductsResponse, type GetDropshipperPromotionsOptions, type GetDropshipperPromotionsResponse, type GetDropshipperReceivableResponse, type GetDropshipperShippingOptionsParams, type GetDropshipperShippingOptionsResponse, type GetOrderNotesResponse, type GetOrdersCallback, type GetOrdersOptions, type GetProductsOptions, type GetProviderCategoriesResponse, type GetSettlementDetailResponse, type GetSettlementsOptions, type GetSettlementsResponse, type GetStorefrontDropshipperCategoriesResponse, type GetUserChannelResponse, type GetVariantCostsOptions, type GetVariantCostsResponse, type HeaderLinkItem, type HeaderNavigationConfig, type IconConfig, type Image, type InventoryLevel, type LinkCustomerToChannelResponse, type LoginCredentials, type ModulesConfig, type Money, type NavigationCalloutItem, type NavigationItem, type NavigationLinkItem, type OnboardDropshipperBody, type OnboardDropshipperResponse, type Order, type OrderItem, type OrderNote, type OrderStatus, type OrdersMetrics, PROVIDER_METADATA, type PaginationOptions, type PasswordResetConfirm, type PasswordResetRequest, type PaymentMethod, type PaymentMethodFeatures, type PaymentMethodType, type PaymentMethodsOptions, type PaymentStatus, type PriceRange, type Product, type ProductCategory, type ProductOption, type ProductPreview, type ProductVariant, type ProductsMetrics, type PromotionRule, type ProviderCategory, type ProviderConfig, type ProviderTypeString, type Region, type RegisterData, type RestoreSiteConfigResponse, type Review, type SEO, type SalesMetrics, type SearchBarConfig, type SearchResultMeta, type SelectedOption, type SetPaymentCollectorBody, type SetPaymentCollectorResponse, type SettlementRecord, type ShippingMethod, type SiteConfig, type SiteConfigLabels, type SiteConfigMetadata, type SocialConfig, type SortOption, type SortOptions, type StockLocation, type StockStatus, type StockValidation, type StorefrontConfig, StorefrontConfigError, type StorefrontContext, type StorefrontPlatformType, type StorefrontSeoDefaults, SupportedProviderType, type UnassignCategoriesFromChannelsBody, type UnassignCategoriesFromChannelsResponse, type UnassignCollectionsFromChannelsBody, type UnassignCollectionsFromChannelsResponse, type UpdateCustomerData, type UpdateDropshipperCategoryBody, type UpdateDropshipperPricesBody, type UpdateDropshipperPricesResponse, type UpdateDropshipperPromotionBody, type UpdateSettlementStatusResponse, type UpdateSiteConfigBody, type UpdateSiteConfigResponse, type UpdateStorefrontConfigBody, type UpdateStorefrontConfigResponse, type VariantCost, getProviderMetadata, isSupportedProviderType };

package/dist/index.d.ts

@@ -3868,6 +3868,51 @@ interface GetDropshipperOrdersResponse {
     offset: number;
     limit: number;
 }
+/** A shipping option returned for manual dropshipper orders */
+interface DropshipperShippingOption {
+    id: string;
+    name: string;
+    amount: number;
+    currency_code: string;
+    price_type: string;
+    is_default: boolean;
+    type: {
+        id: string;
+        label: string;
+        code: string | null;
+    } | null;
+}
+/** Options for `GET /admin/thor/dropshipper/orders/shipping-options` */
+interface GetDropshipperShippingOptionsParams {
+    currency_code: string;
+    country_code?: string;
+}
+/** Response for `GET /admin/thor/dropshipper/orders/shipping-options` */
+interface GetDropshipperShippingOptionsResponse {
+    shipping_options: DropshipperShippingOption[];
+    count: number;
+}
+/** Body for `POST /admin/thor/dropshipper/orders` with checkout-only extensions */
+interface ExtendedCreateDropshipperOrderBody extends CreateDropshipperOrderBody {
+    billing_address?: CreateDropshipperOrderBody['shipping_address'];
+    promo_codes?: string[];
+}
+/** Response for `POST /admin/thor/dropshipper/orders` with totals and shipping method */
+interface ExtendedCreateDropshipperOrderResponse {
+    order: {
+        id: string;
+        display_id: number;
+        status: string;
+        subtotal: number;
+        tax_total: number;
+        shipping_total: number;
+        discount_total: number;
+        total: number;
+        profit: number;
+        created_at: string;
+        shipping_method?: DropshipperShippingOption | null;
+    };
+}
 /** A shipping address on an order */
 interface DropshipperOrderShippingAddress {
     full_name: string;
@@ -4072,6 +4117,36 @@ interface DeleteCategoryMappingResponse {
     deleted: true;
     id: string;
 }
+/** A Medusa ProductCategory as exposed to the dropshipper (read-only) */
+interface ProviderCategory {
+    id: string;
+    name: string;
+    handle: string;
+    parent_category_id: string | null;
+}
+/** Response for `GET /admin/thor/dropshipper/categories/provider` */
+interface GetProviderCategoriesResponse {
+    categories: ProviderCategory[];
+}
+/** Options for `GET /admin/thor/dropshipper/category-mappings` */
+interface GetCategoryMappingsOptions {
+    /** Filter mappings by product */
+    product_id?: string;
+}
+/** A single category mapping entry */
+interface CategoryMapping {
+    id: string;
+    product_id: string;
+    category_id: string;
+    category_name: string;
+    category_handle: string;
+    created_at: string;
+}
+/** Response for `GET /admin/thor/dropshipper/category-mappings` */
+interface GetCategoryMappingsResponse {
+    mappings: CategoryMapping[];
+    count: number;
+}
 /** A customer as seen by the dropshipper (list view) */
 interface DropshipperCustomer {
     id: string;
@@ -4487,8 +4562,9 @@ interface DeleteOrderNoteResponse {
 }
 /** Body for creating/updating a dropshipper address */
 interface DropshipperAddressBody {
-    first_name: string;
-    last_name: string;
+    address_name?: string;
+    first_name?: string;
+    last_name?: string;
     company?: string;
     address_1: string;
     address_2?: string;
@@ -4498,6 +4574,8 @@ interface DropshipperAddressBody {
     country_code: string;
     phone?: string;
     is_default?: boolean;
+    is_default_shipping?: boolean;
+    is_default_billing?: boolean;
 }
 /** Response for creating or updating a dropshipper address */
 interface DropshipperAddressResponse {
@@ -4513,4 +4591,4 @@ interface GetStorefrontDropshipperCategoriesResponse {
     categories: DropshipperCategory[];
 }
 
-export { type AccountDropdownConfig, type AccountMenuItem, type ActiveFilter, type AddOrderEditItemBody, type AddOrderEditItemResponse, type Address, type AdminApiKey, type AdminChannelCategory, type AdminChannelCustomer, type AdminDropshipperAccount, type AdminDropshipperBalance, type AdminProduct, type AdminProductVariant, type AdminSalesChannelRef, type AdminSiteConfig, type AdminSiteConfigHistoryEntry, type AdminSiteConfigHistoryEntryFull, type AdminStorefrontConfig, type AdminStorefrontSeoDefaults, type AdminUser, type AdvancedSearchProductsOptions, type AssignCategoriesToChannelsBody, type AssignCategoriesToChannelsResponse, type AssignCollectionsToChannelsBody, type AssignCollectionsToChannelsResponse, type AuditLog, type AuditLogAdapter, type AuthConfig, type AuthMethod, type AuthProvider, type AuthResponse, type AuthStorage, type AuthorConfig, type BackendCapabilities, type BatchVariantCostItem, type BatchVariantCostsBody, type BatchVariantCostsResponse, type BrandConfig, type CachedPaymentMethods, type CancelDropshipperOrderResponse, type CancelSettlementBody, type Cart, type CartCost, type CartItem, type CartLineInput, type CartLineUpdate, type CartProduct, type ChartDataPoint, type Collection, type CollectionProductsOptions, type CommerceProvider, type CompareProduct, type ConfigHistoryEntry, type ConfirmOrderEditResponse, type ConfirmSettlementBody, type Connection, type Country, type CreateAddressData, type CreateCategoryMappingBody, type CreateCategoryMappingResponse, type CreateDropshipperCategoryBody, type CreateDropshipperCustomerBody, type CreateDropshipperCustomerResponse, type CreateDropshipperOrderBody, type CreateDropshipperOrderResponse, type CreateDropshipperPromotionBody, type CreateOrderEditBody, type CreateOrderEditResponse, type CreateOrderItem, type CreateOrderNoteBody, type CreateSettlementBody, type CreateSettlementResponse, type CreateVariantCostBody, type CreateVariantCostResponse, type Customer, type DashboardChanges, type DashboardConfig, type DashboardMetrics, type DashboardMetricsAdapter, type DashboardOrdersAdapter, type DashboardPeriodMetrics, type DashboardProductsAdapter, type DashboardStats, type DashboardTopProduct, type DeleteCategoryMappingResponse, type DeleteDropshipperCategoryResponse, type DeleteDropshipperPromotionResponse, type DeleteOrderNoteResponse, type DeleteVariantCostResponse, type DesignerConfig, type DesignerHistoryEntry, type DesignerNavItem, type DesignerThemeConfig, type DesignerThemePreset, type DiscountCode, type DropshipperAccount, type DropshipperAccountRef, type DropshipperAddressBody, type DropshipperAddressResponse, type DropshipperBalance, type DropshipperCategory, type DropshipperCustomer, type DropshipperCustomerDetail, type DropshipperCustomerOrderRef, type DropshipperCustomerStats, type DropshipperOrder, type DropshipperOrderCustomer, type DropshipperOrderDetail, type DropshipperOrderItem, type DropshipperOrderShippingAddress, type DropshipperOrderTimelineEvent, type DropshipperOrderTotals, type DropshipperPayableOrder, type DropshipperPendingOrders, type DropshipperPriceItem, type DropshipperProduct, type DropshipperPromotion, type DropshipperReceivableOrder, type DropshipperVariant, type DynamicSource, type Edge, type FilterConfig, type FilterOption, type FilterSection, type FulfillmentOption, type FulfillmentSet, type FulfillmentStatus, type GetAdminAccountBalanceResponse, type GetAdminDropshipperAccountsResponse, type GetAdminPriceListsResponse, type GetAdminSiteConfigHistoryOptions, type GetAdminSiteConfigHistoryResponse, type GetAdminSiteConfigResponse, type GetAdminStorefrontConfigResponse, type GetCategoriesCallback, type GetCategoriesOptions, type GetCategorySalesChannelsResponse, type GetChannelApiKeysResponse, type GetChannelCategoriesOptions, type GetChannelCategoriesResponse, type GetChannelCustomersOptions, type GetChannelCustomersResponse, type GetCollectionSalesChannelsResponse, type GetCollectionsOptions, type GetCustomersCallback, type GetCustomersOptions, type GetDashboardStatsOptions, type GetDashboardStatsResponse, type GetDropshipperAccountResponse, type GetDropshipperAddressesResponse, type GetDropshipperCategoriesOptions, type GetDropshipperCategoriesResponse, type GetDropshipperCustomerDetailResponse, type GetDropshipperCustomersOptions, type GetDropshipperCustomersResponse, type GetDropshipperOrderDetailResponse, type GetDropshipperOrdersOptions, type GetDropshipperOrdersResponse, type GetDropshipperPayableResponse, type GetDropshipperProductsOptions, type GetDropshipperProductsResponse, type GetDropshipperPromotionsOptions, type GetDropshipperPromotionsResponse, type GetDropshipperReceivableResponse, type GetOrderNotesResponse, type GetOrdersCallback, type GetOrdersOptions, type GetProductsOptions, type GetSettlementDetailResponse, type GetSettlementsOptions, type GetSettlementsResponse, type GetStorefrontDropshipperCategoriesResponse, type GetUserChannelResponse, type GetVariantCostsOptions, type GetVariantCostsResponse, type HeaderLinkItem, type HeaderNavigationConfig, type IconConfig, type Image, type InventoryLevel, type LinkCustomerToChannelResponse, type LoginCredentials, type ModulesConfig, type Money, type NavigationCalloutItem, type NavigationItem, type NavigationLinkItem, type OnboardDropshipperBody, type OnboardDropshipperResponse, type Order, type OrderItem, type OrderNote, type OrderStatus, type OrdersMetrics, PROVIDER_METADATA, type PaginationOptions, type PasswordResetConfirm, type PasswordResetRequest, type PaymentMethod, type PaymentMethodFeatures, type PaymentMethodType, type PaymentMethodsOptions, type PaymentStatus, type PriceRange, type Product, type ProductCategory, type ProductOption, type ProductPreview, type ProductVariant, type ProductsMetrics, type PromotionRule, type ProviderConfig, type ProviderTypeString, type Region, type RegisterData, type RestoreSiteConfigResponse, type Review, type SEO, type SalesMetrics, type SearchBarConfig, type SearchResultMeta, type SelectedOption, type SetPaymentCollectorBody, type SetPaymentCollectorResponse, type SettlementRecord, type ShippingMethod, type SiteConfig, type SiteConfigLabels, type SiteConfigMetadata, type SocialConfig, type SortOption, type SortOptions, type StockLocation, type StockStatus, type StockValidation, type StorefrontConfig, StorefrontConfigError, type StorefrontContext, type StorefrontPlatformType, type StorefrontSeoDefaults, SupportedProviderType, type UnassignCategoriesFromChannelsBody, type UnassignCategoriesFromChannelsResponse, type UnassignCollectionsFromChannelsBody, type UnassignCollectionsFromChannelsResponse, type UpdateCustomerData, type UpdateDropshipperCategoryBody, type UpdateDropshipperPricesBody, type UpdateDropshipperPricesResponse, type UpdateDropshipperPromotionBody, type UpdateSettlementStatusResponse, type UpdateSiteConfigBody, type UpdateSiteConfigResponse, type UpdateStorefrontConfigBody, type UpdateStorefrontConfigResponse, type VariantCost, getProviderMetadata, isSupportedProviderType };
+export { type AccountDropdownConfig, type AccountMenuItem, type ActiveFilter, type AddOrderEditItemBody, type AddOrderEditItemResponse, type Address, type AdminApiKey, type AdminChannelCategory, type AdminChannelCustomer, type AdminDropshipperAccount, type AdminDropshipperBalance, type AdminProduct, type AdminProductVariant, type AdminSalesChannelRef, type AdminSiteConfig, type AdminSiteConfigHistoryEntry, type AdminSiteConfigHistoryEntryFull, type AdminStorefrontConfig, type AdminStorefrontSeoDefaults, type AdminUser, type AdvancedSearchProductsOptions, type AssignCategoriesToChannelsBody, type AssignCategoriesToChannelsResponse, type AssignCollectionsToChannelsBody, type AssignCollectionsToChannelsResponse, type AuditLog, type AuditLogAdapter, type AuthConfig, type AuthMethod, type AuthProvider, type AuthResponse, type AuthStorage, type AuthorConfig, type BackendCapabilities, type BatchVariantCostItem, type BatchVariantCostsBody, type BatchVariantCostsResponse, type BrandConfig, type CachedPaymentMethods, type CancelDropshipperOrderResponse, type CancelSettlementBody, type Cart, type CartCost, type CartItem, type CartLineInput, type CartLineUpdate, type CartProduct, type CategoryMapping, type ChartDataPoint, type Collection, type CollectionProductsOptions, type CommerceProvider, type CompareProduct, type ConfigHistoryEntry, type ConfirmOrderEditResponse, type ConfirmSettlementBody, type Connection, type Country, type CreateAddressData, type CreateCategoryMappingBody, type CreateCategoryMappingResponse, type CreateDropshipperCategoryBody, type CreateDropshipperCustomerBody, type CreateDropshipperCustomerResponse, type CreateDropshipperOrderBody, type CreateDropshipperOrderResponse, type CreateDropshipperPromotionBody, type CreateOrderEditBody, type CreateOrderEditResponse, type CreateOrderItem, type CreateOrderNoteBody, type CreateSettlementBody, type CreateSettlementResponse, type CreateVariantCostBody, type CreateVariantCostResponse, type Customer, type DashboardChanges, type DashboardConfig, type DashboardMetrics, type DashboardMetricsAdapter, type DashboardOrdersAdapter, type DashboardPeriodMetrics, type DashboardProductsAdapter, type DashboardStats, type DashboardTopProduct, type DeleteCategoryMappingResponse, type DeleteDropshipperCategoryResponse, type DeleteDropshipperPromotionResponse, type DeleteOrderNoteResponse, type DeleteVariantCostResponse, type DesignerConfig, type DesignerHistoryEntry, type DesignerNavItem, type DesignerThemeConfig, type DesignerThemePreset, type DiscountCode, type DropshipperAccount, type DropshipperAccountRef, type DropshipperAddressBody, type DropshipperAddressResponse, type DropshipperBalance, type DropshipperCategory, type DropshipperCustomer, type DropshipperCustomerDetail, type DropshipperCustomerOrderRef, type DropshipperCustomerStats, type DropshipperOrder, type DropshipperOrderCustomer, type DropshipperOrderDetail, type DropshipperOrderItem, type DropshipperOrderShippingAddress, type DropshipperOrderTimelineEvent, type DropshipperOrderTotals, type DropshipperPayableOrder, type DropshipperPendingOrders, type DropshipperPriceItem, type DropshipperProduct, type DropshipperPromotion, type DropshipperReceivableOrder, type DropshipperShippingOption, type DropshipperVariant, type DynamicSource, type Edge, type ExtendedCreateDropshipperOrderBody, type ExtendedCreateDropshipperOrderResponse, type FilterConfig, type FilterOption, type FilterSection, type FulfillmentOption, type FulfillmentSet, type FulfillmentStatus, type GetAdminAccountBalanceResponse, type GetAdminDropshipperAccountsResponse, type GetAdminPriceListsResponse, type GetAdminSiteConfigHistoryOptions, type GetAdminSiteConfigHistoryResponse, type GetAdminSiteConfigResponse, type GetAdminStorefrontConfigResponse, type GetCategoriesCallback, type GetCategoriesOptions, type GetCategoryMappingsOptions, type GetCategoryMappingsResponse, type GetCategorySalesChannelsResponse, type GetChannelApiKeysResponse, type GetChannelCategoriesOptions, type GetChannelCategoriesResponse, type GetChannelCustomersOptions, type GetChannelCustomersResponse, type GetCollectionSalesChannelsResponse, type GetCollectionsOptions, type GetCustomersCallback, type GetCustomersOptions, type GetDashboardStatsOptions, type GetDashboardStatsResponse, type GetDropshipperAccountResponse, type GetDropshipperAddressesResponse, type GetDropshipperCategoriesOptions, type GetDropshipperCategoriesResponse, type GetDropshipperCustomerDetailResponse, type GetDropshipperCustomersOptions, type GetDropshipperCustomersResponse, type GetDropshipperOrderDetailResponse, type GetDropshipperOrdersOptions, type GetDropshipperOrdersResponse, type GetDropshipperPayableResponse, type GetDropshipperProductsOptions, type GetDropshipperProductsResponse, type GetDropshipperPromotionsOptions, type GetDropshipperPromotionsResponse, type GetDropshipperReceivableResponse, type GetDropshipperShippingOptionsParams, type GetDropshipperShippingOptionsResponse, type GetOrderNotesResponse, type GetOrdersCallback, type GetOrdersOptions, type GetProductsOptions, type GetProviderCategoriesResponse, type GetSettlementDetailResponse, type GetSettlementsOptions, type GetSettlementsResponse, type GetStorefrontDropshipperCategoriesResponse, type GetUserChannelResponse, type GetVariantCostsOptions, type GetVariantCostsResponse, type HeaderLinkItem, type HeaderNavigationConfig, type IconConfig, type Image, type InventoryLevel, type LinkCustomerToChannelResponse, type LoginCredentials, type ModulesConfig, type Money, type NavigationCalloutItem, type NavigationItem, type NavigationLinkItem, type OnboardDropshipperBody, type OnboardDropshipperResponse, type Order, type OrderItem, type OrderNote, type OrderStatus, type OrdersMetrics, PROVIDER_METADATA, type PaginationOptions, type PasswordResetConfirm, type PasswordResetRequest, type PaymentMethod, type PaymentMethodFeatures, type PaymentMethodType, type PaymentMethodsOptions, type PaymentStatus, type PriceRange, type Product, type ProductCategory, type ProductOption, type ProductPreview, type ProductVariant, type ProductsMetrics, type PromotionRule, type ProviderCategory, type ProviderConfig, type ProviderTypeString, type Region, type RegisterData, type RestoreSiteConfigResponse, type Review, type SEO, type SalesMetrics, type SearchBarConfig, type SearchResultMeta, type SelectedOption, type SetPaymentCollectorBody, type SetPaymentCollectorResponse, type SettlementRecord, type ShippingMethod, type SiteConfig, type SiteConfigLabels, type SiteConfigMetadata, type SocialConfig, type SortOption, type SortOptions, type StockLocation, type StockStatus, type StockValidation, type StorefrontConfig, StorefrontConfigError, type StorefrontContext, type StorefrontPlatformType, type StorefrontSeoDefaults, SupportedProviderType, type UnassignCategoriesFromChannelsBody, type UnassignCategoriesFromChannelsResponse, type UnassignCollectionsFromChannelsBody, type UnassignCollectionsFromChannelsResponse, type UpdateCustomerData, type UpdateDropshipperCategoryBody, type UpdateDropshipperPricesBody, type UpdateDropshipperPricesResponse, type UpdateDropshipperPromotionBody, type UpdateSettlementStatusResponse, type UpdateSiteConfigBody, type UpdateSiteConfigResponse, type UpdateStorefrontConfigBody, type UpdateStorefrontConfigResponse, type VariantCost, getProviderMetadata, isSupportedProviderType };

package/dist/index.js.map

@@ -1 +1 @@
-{"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// 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} 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  OnboardDropshipperBody,\n  OnboardDropshipperResponse,\n  VariantCost,\n  GetVariantCostsOptions,\n  GetVariantCostsResponse,\n  CreateVariantCostBody,\n  CreateVariantCostResponse,\n  BatchVariantCostItem,\n  BatchVariantCostsBody,\n  BatchVariantCostsResponse,\n  DeleteVariantCostResponse,\n  DropshipperVariant,\n  DropshipperProduct,\n  GetDropshipperProductsOptions,\n  GetDropshipperProductsResponse,\n  DropshipperPriceItem,\n  UpdateDropshipperPricesBody,\n  UpdateDropshipperPricesResponse,\n  DropshipperOrderCustomer,\n  DropshipperOrder,\n  GetDropshipperOrdersOptions,\n  GetDropshipperOrdersResponse,\n  DropshipperOrderShippingAddress,\n  DropshipperOrderItem,\n  DropshipperOrderTotals,\n  DropshipperOrderTimelineEvent,\n  DropshipperOrderDetail,\n  GetDropshipperOrderDetailResponse,\n  CreateOrderItem,\n  CreateDropshipperOrderBody,\n  CreateDropshipperOrderResponse,\n  SetPaymentCollectorBody,\n  SetPaymentCollectorResponse,\n  DropshipperCategory,\n  GetDropshipperCategoriesOptions,\n  GetDropshipperCategoriesResponse,\n  CreateDropshipperCategoryBody,\n  UpdateDropshipperCategoryBody,\n  DeleteDropshipperCategoryResponse,\n  CreateCategoryMappingBody,\n  CreateCategoryMappingResponse,\n  DeleteCategoryMappingResponse,\n  DropshipperCustomer,\n  DropshipperCustomerStats,\n  DropshipperCustomerOrderRef,\n  DropshipperCustomerDetail,\n  GetDropshipperCustomersOptions,\n  GetDropshipperCustomersResponse,\n  GetDropshipperCustomerDetailResponse,\n  CreateDropshipperCustomerBody,\n  CreateDropshipperCustomerResponse,\n  DropshipperBalance,\n  DropshipperPendingOrders,\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   DeleteOrderNoteResponse,\n   // Order cancel and edits\n   CancelDropshipperOrderResponse,\n   CreateOrderEditBody,\n   CreateOrderEditResponse,\n   AddOrderEditItemBody,\n   AddOrderEditItemResponse,\n   ConfirmOrderEditResponse,\n   // Dropshipper addresses (channel-scoped)\n   DropshipperAddressBody,\n   DropshipperAddressResponse,\n   GetDropshipperAddressesResponse,\n  } from './admin';\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"]}
+{"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// 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} 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  OnboardDropshipperBody,\n  OnboardDropshipperResponse,\n  VariantCost,\n  GetVariantCostsOptions,\n  GetVariantCostsResponse,\n  CreateVariantCostBody,\n  CreateVariantCostResponse,\n  BatchVariantCostItem,\n  BatchVariantCostsBody,\n  BatchVariantCostsResponse,\n  DeleteVariantCostResponse,\n  DropshipperVariant,\n  DropshipperProduct,\n  GetDropshipperProductsOptions,\n  GetDropshipperProductsResponse,\n  DropshipperPriceItem,\n  UpdateDropshipperPricesBody,\n  UpdateDropshipperPricesResponse,\n  DropshipperOrderCustomer,\n  DropshipperOrder,\n  GetDropshipperOrdersOptions,\n  GetDropshipperOrdersResponse,\n  DropshipperShippingOption,\n  GetDropshipperShippingOptionsParams,\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  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  DropshipperCustomerOrderRef,\n  DropshipperCustomerDetail,\n  GetDropshipperCustomersOptions,\n  GetDropshipperCustomersResponse,\n  GetDropshipperCustomerDetailResponse,\n  CreateDropshipperCustomerBody,\n  CreateDropshipperCustomerResponse,\n  DropshipperBalance,\n  DropshipperPendingOrders,\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   DeleteOrderNoteResponse,\n   // Order cancel and edits\n   CancelDropshipperOrderResponse,\n   CreateOrderEditBody,\n   CreateOrderEditResponse,\n   AddOrderEditItemBody,\n   AddOrderEditItemResponse,\n   ConfirmOrderEditResponse,\n   // Dropshipper addresses (channel-scoped)\n   DropshipperAddressBody,\n   DropshipperAddressResponse,\n   GetDropshipperAddressesResponse,\n  } from './admin';\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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thorprovider/types",
-  "version": "3.4.1",
+  "version": "3.5.0",
   "description": "Shared TypeScript types for Thor Commerce ecosystem - Framework-agnostic type definitions",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/admin/DropshippingAdmin.ts

@@ -256,6 +256,56 @@ export interface GetDropshipperOrdersResponse {
   limit: number;
 }
 
+/** A shipping option returned for manual dropshipper orders */
+export interface DropshipperShippingOption {
+  id: string;
+  name: string;
+  amount: number;
+  currency_code: string;
+  price_type: string;
+  is_default: boolean;
+  type: {
+    id: string;
+    label: string;
+    code: string | null;
+  } | null;
+}
+
+/** Options for `GET /admin/thor/dropshipper/orders/shipping-options` */
+export interface GetDropshipperShippingOptionsParams {
+  currency_code: string;
+  country_code?: string;
+}
+
+/** Response for `GET /admin/thor/dropshipper/orders/shipping-options` */
+export interface GetDropshipperShippingOptionsResponse {
+  shipping_options: DropshipperShippingOption[];
+  count: number;
+}
+
+/** Body for `POST /admin/thor/dropshipper/orders` with checkout-only extensions */
+export interface ExtendedCreateDropshipperOrderBody extends CreateDropshipperOrderBody {
+  billing_address?: CreateDropshipperOrderBody['shipping_address'];
+  promo_codes?: string[];
+}
+
+/** Response for `POST /admin/thor/dropshipper/orders` with totals and shipping method */
+export interface ExtendedCreateDropshipperOrderResponse {
+  order: {
+    id: string;
+    display_id: number;
+    status: string;
+    subtotal: number;
+    tax_total: number;
+    shipping_total: number;
+    discount_total: number;
+    total: number;
+    profit: number;
+    created_at: string;
+    shipping_method?: DropshipperShippingOption | null;
+  };
+}
+
 /** A shipping address on an order */
 export interface DropshipperOrderShippingAddress {
   full_name: string;
@@ -475,6 +525,45 @@ export interface DeleteCategoryMappingResponse {
   id: string;
 }
 
+// ============================================================
+// Provider Categories (read-only, Solo Y)
+// ============================================================
+
+/** A Medusa ProductCategory as exposed to the dropshipper (read-only) */
+export interface ProviderCategory {
+  id: string;
+  name: string;
+  handle: string;
+  parent_category_id: string | null;
+}
+
+/** Response for `GET /admin/thor/dropshipper/categories/provider` */
+export interface GetProviderCategoriesResponse {
+  categories: ProviderCategory[];
+}
+
+/** Options for `GET /admin/thor/dropshipper/category-mappings` */
+export interface GetCategoryMappingsOptions {
+  /** Filter mappings by product */
+  product_id?: string;
+}
+
+/** A single category mapping entry */
+export interface CategoryMapping {
+  id: string;
+  product_id: string;
+  category_id: string;
+  category_name: string;
+  category_handle: string;
+  created_at: string;
+}
+
+/** Response for `GET /admin/thor/dropshipper/category-mappings` */
+export interface GetCategoryMappingsResponse {
+  mappings: CategoryMapping[];
+  count: number;
+}
+
 // ============================================================
 // Customers (Solo Y)
 // ============================================================
@@ -961,8 +1050,9 @@ export interface DeleteOrderNoteResponse {
 
 /** Body for creating/updating a dropshipper address */
 export interface DropshipperAddressBody {
-  first_name: string;
-  last_name: string;
+  address_name?: string;
+  first_name?: string;
+  last_name?: string;
   company?: string;
   address_1: string;
   address_2?: string;
@@ -972,6 +1062,8 @@ export interface DropshipperAddressBody {
   country_code: string;
   phone?: string;
   is_default?: boolean;
+  is_default_shipping?: boolean;
+  is_default_billing?: boolean;
 }
 
 /** Response for creating or updating a dropshipper address */

package/src/index.ts

@@ -285,6 +285,9 @@ export type {
   DropshipperOrder,
   GetDropshipperOrdersOptions,
   GetDropshipperOrdersResponse,
+  DropshipperShippingOption,
+  GetDropshipperShippingOptionsParams,
+  GetDropshipperShippingOptionsResponse,
   DropshipperOrderShippingAddress,
   DropshipperOrderItem,
   DropshipperOrderTotals,
@@ -294,6 +297,8 @@ export type {
   CreateOrderItem,
   CreateDropshipperOrderBody,
   CreateDropshipperOrderResponse,
+  ExtendedCreateDropshipperOrderBody,
+  ExtendedCreateDropshipperOrderResponse,
   SetPaymentCollectorBody,
   SetPaymentCollectorResponse,
   DropshipperCategory,
@@ -302,6 +307,11 @@ export type {
   CreateDropshipperCategoryBody,
   UpdateDropshipperCategoryBody,
   DeleteDropshipperCategoryResponse,
+  ProviderCategory,
+  GetProviderCategoriesResponse,
+  GetCategoryMappingsOptions,
+  CategoryMapping,
+  GetCategoryMappingsResponse,
   CreateCategoryMappingBody,
   CreateCategoryMappingResponse,
   DeleteCategoryMappingResponse,