@thorprovider/types 3.2.0 → 3.3.0

package/dist/index.d.ts

@@ -1387,6 +1387,44 @@ interface GetOrdersOptions {
     customFetcher?: GetOrdersCallback;
 }
 
+/**
+ * @thorprovider/types — Supported Providers
+ *
+ * Centralized list of all supported commerce providers.
+ * This is the single source of truth for provider types across the monorepo.
+ *
+ * @remarks
+ * - L1 (Foundation): Defines the contract
+ * - L2 (@thorprovider/adapters) imports from here to build the factory
+ * - L5 (Starters) uses the factory which is bound to this enum
+ *
+ * When adding a new provider (e.g., Stel Order):
+ * 1. Add to SupportedProviderType enum below
+ * 2. Update @thorprovider/adapters factory/index.ts with discriminated union
+ * 3. Create packages/adapters/src/providers/shopify/
+ * 4. Implement CommerceProvider interface
+ * 5. Update StorefrontPlatformType in storefront.ts
+ */
+/**
+ * All supported commerce platform providers.
+ * `mock` is the backend-optional runtime provider used for layout/design mode.
+ * `medusa` is fully implemented for real backend usage; others are placeholders for future expansion.
+ *
+ * @remarks Implementation status:
+ * - ✅ mock: Fixture-backed provider for backend-optional storefronts
+ * - ✅ medusa: Fully implemented
+ * - 🟡 stelorder: In progress (ERP adapter v1)
+ * - 🟡 shopify: Planned (Phase 2)
+ * - 🟡 bigcommerce: Planned (Phase 2)
+ * - 🟡 woocommerce: Planned (Phase 3)
+ * - 🟡 spree: Planned (Phase 3)
+ * - 🟡 magento: Planned (Phase 3)
+ */
+declare enum SupportedProviderType {
+    Mock = "mock",
+    Medusa = "medusa",
+    StelOrder = "stelorder"
+}
 /**
  * Union type of all supported provider string values.
  * Use this for type annotations when a provider type is expected.
@@ -1398,7 +1436,7 @@ interface GetOrdersOptions {
  * }
  * ```
  */
-type ProviderTypeString = 'mock' | 'medusa' | 'shopify' | 'bigcommerce' | 'woocommerce' | 'spree' | 'magento';
+type ProviderTypeString = 'mock' | 'medusa' | 'stelorder';
 /**
  * Metadata about each provider.
  * Useful for UI, error messages, validation, and documentation.
@@ -1451,13 +1489,14 @@ declare function getProviderMetadata(type: ProviderTypeString): (typeof PROVIDER
  * Supported commerce platform types for storefront identification.
  *
  * @remarks
- * This type is automatically synced with SupportedProviderType from provider.ts.
- * When adding a new provider, update packages/types/src/provider.ts,
- * and this type will automatically reflect the new provider.
+ * Keep this type in sync with SupportedProviderType from provider.ts.
+ * When adding a new provider, update both packages/types/src/provider.ts
+ * and this type.
  *
  * Currently supported:
  * - ✅ 'mock': Backend-optional layout/design mode using fixture data
  * - ✅ 'medusa': Fully implemented
+ * - 🟡 'stelorder': ERP adapter v1
  *
  * Planned (not yet implemented):
  * - 🟡 'shopify': Phase 2
@@ -1466,7 +1505,7 @@ declare function getProviderMetadata(type: ProviderTypeString): (typeof PROVIDER
  * - 🟡 'spree': Phase 3
  * - 🟡 'magento': Phase 3
  */
-type StorefrontPlatformType = 'mock' | 'medusa' | 'shopify' | 'bigcommerce' | 'woocommerce' | 'spree' | 'magento';
+type StorefrontPlatformType = 'mock' | 'medusa' | 'stelorder' | 'shopify' | 'bigcommerce' | 'woocommerce' | 'spree' | 'magento';
 /**
  * StorefrontContext
  *
@@ -1502,11 +1541,12 @@ interface StorefrontContext {
      *
      * @remarks
      * - Medusa: true (products must be linked to sales channel)
-     * - Shopify: false (products visible by default unless unlisted)
-     * - WooCommerce: false (no scoping concept)
-     * - BigCommerce: false (products visible by default unless delisted)
-     * - Spree: true (products must be assigned per store)
-     * - Magento: true (products must be assigned per website)
+   * - Shopify: false (products visible by default unless unlisted)
+   * - Stel Order: false (single-company ERP model, no native channel scoping)
+   * - WooCommerce: false (no scoping concept)
+   * - BigCommerce: false (products visible by default unless delisted)
+   * - Spree: true (products must be assigned per store)
+   * - Magento: true (products must be assigned per website)
      */
     requiresProductScoping: boolean;
     /**
@@ -1878,28 +1918,21 @@ interface AuthProvider {
      */
     deleteCustomerAccount(): Promise<void>;
     /**
-     * Get customer addresses
-     * @returns List of customer addresses
-     */
-    getAddresses(): Promise<Address[]>;
-    /**
-     * Create new address for current customer
-     * @param data - Address data
-     * @returns Created address
-     */
-    createAddress(data: CreateAddressData): Promise<Address>;
-    /**
-     * Update customer address
-     * @param addressId - Address ID
-     * @param data - Fields to update
-     * @returns Updated address
-     */
-    updateAddress(addressId: string, data: Partial<CreateAddressData>): Promise<Address>;
-    /**
-     * Delete customer address
-     * @param addressId - Address ID
+     * Link the currently authenticated customer to the storefront's sales channel.
+     *
+     * Call immediately after a successful `login()` so the customer appears in the
+     * correct channel on the admin panel. Idempotent — repeated calls return
+     * `{ linked: false, reason: 'already_linked' }`.
+     *
+     * Implements `POST /store/thor/customers/me/channels`.
+     *
+     * @returns `{ linked: true }` when the link was created, or
+     *          `{ linked: false, reason: 'already_linked' }` when it already existed.
      */
-    deleteAddress(addressId: string): Promise<void>;
+    linkCustomerToChannel(): Promise<{
+        linked: boolean;
+        reason?: string;
+    }>;
 }
 
 /**
@@ -3339,16 +3372,237 @@ interface SiteConfigMetadata {
 }
 
 /**
- * @thorprovider/types v1.0
- * Shared TypeScript types for Thor Commerce ecosystem
+ * @thorprovider/types — Multi-Tenant Admin Types
+ *
+ * Type definitions for admin operations on the Thor Commerce multi-tenant
+ * backend plugin (`/admin/thor/`).
  *
- * Pure type definitions with zero runtime dependencies.
- * Foundation for type-safe commerce operations following SOLID principles.
+ * These types map 1:1 to the API contract defined in
+ * `multitenant-api-contract.md`.
+ *
+ * @module admin/MultiTenantAdmin
  */
-
-declare enum SupportedProviderType {
-    Mock = "mock",
-    Medusa = "medusa"
+/**
+ * A customer entry as returned by the admin multi-tenant API.
+ */
+interface AdminChannelCustomer {
+    id: string;
+    email: string;
+    first_name: string | null;
+    last_name: string | null;
+    phone: string | null;
+    created_at: string;
+}
+/** Response for `GET /admin/thor/sales-channels/:id/customers` */
+interface GetChannelCustomersResponse {
+    customers: AdminChannelCustomer[];
+    count: number;
+    limit: number;
+    offset: number;
+}
+/** Options for paginating channel customers */
+interface GetChannelCustomersOptions {
+    /** Max customers to return (default 20, max 100) */
+    limit?: number;
+    /** Pagination offset (default 0) */
+    offset?: number;
+}
+/**
+ * A publishable API key entry as returned by the admin multi-tenant API.
+ */
+interface AdminApiKey {
+    id: string;
+    title: string;
+    token: string;
+    type: 'publishable' | string;
+    created_at: string;
+}
+/** Response for `GET /admin/thor/sales-channels/:id/api-keys` */
+interface GetChannelApiKeysResponse {
+    api_keys: AdminApiKey[];
+}
+/**
+ * A product category entry as returned by admin channel category endpoints.
+ */
+interface AdminChannelCategory {
+    id: string;
+    name: string;
+    handle: string;
+    description: string | null;
+    parent_category_id: string | null;
+    rank: number;
+    metadata: Record<string, unknown>;
+}
+/** Response for `GET /admin/thor/sales-channels/:id/categories` */
+interface GetChannelCategoriesResponse {
+    categories: AdminChannelCategory[];
+    count: number;
+}
+/** Options for listing channel categories */
+interface GetChannelCategoriesOptions {
+    /** Max categories per page (default 20, max 100) */
+    limit?: number;
+    /** Pagination offset (default 0) */
+    offset?: number;
+    /** Expand child categories in nested tree */
+    include_descendants?: boolean;
+}
+/**
+ * A slim sales channel reference returned when listing channels for a resource.
+ */
+interface AdminSalesChannelRef {
+    id: string;
+    name: string;
+    description?: string;
+}
+/** Response for `GET /admin/thor/categories/:id/sales-channels` */
+interface GetCategorySalesChannelsResponse {
+    sales_channels: AdminSalesChannelRef[];
+}
+/** Body for `POST /admin/thor/categories/:id/sales-channels` */
+interface AssignCategoriesToChannelsBody {
+    sales_channel_ids: string[];
+}
+/** Response for `POST /admin/thor/categories/:id/sales-channels` */
+interface AssignCategoriesToChannelsResponse {
+    message: string;
+    linked: number;
+}
+/** Body for `DELETE /admin/thor/categories/:id/sales-channels` */
+interface UnassignCategoriesFromChannelsBody {
+    sales_channel_ids: string[];
+}
+/** Response for `DELETE /admin/thor/categories/:id/sales-channels` */
+interface UnassignCategoriesFromChannelsResponse {
+    message: string;
+    dismissed: number;
+}
+/** Response for `GET /admin/thor/collections/:id/sales-channels` */
+interface GetCollectionSalesChannelsResponse {
+    sales_channels: AdminSalesChannelRef[];
+}
+/** Body for `POST /admin/thor/collections/:id/sales-channels` */
+interface AssignCollectionsToChannelsBody {
+    sales_channel_ids: string[];
+}
+/** Response for `POST /admin/thor/collections/:id/sales-channels` */
+interface AssignCollectionsToChannelsResponse {
+    message: string;
+    linked: number;
+}
+/** Body for `DELETE /admin/thor/collections/:id/sales-channels` */
+interface UnassignCollectionsFromChannelsBody {
+    sales_channel_ids: string[];
+}
+/** Response for `DELETE /admin/thor/collections/:id/sales-channels` */
+interface UnassignCollectionsFromChannelsResponse {
+    message: string;
+    dismissed: number;
+}
+/**
+ * SEO defaults as stored in the storefront config.
+ */
+interface AdminStorefrontSeoDefaults {
+    title: string;
+    description: string;
+    ogImage?: string;
+}
+/**
+ * Full storefront config record as returned by admin endpoints.
+ * Uses snake_case to match the API contract response shape exactly.
+ */
+interface AdminStorefrontConfig {
+    id: string;
+    sales_channel_id: string;
+    theme_accent_color: string;
+    logo_url: string;
+    currency_code: string;
+    seo_defaults: AdminStorefrontSeoDefaults;
+    frontend_webhook_url?: string;
+    created_at: string;
+    updated_at: string;
+}
+/** Response for `GET /admin/thor/storefront-config/:id` */
+interface GetAdminStorefrontConfigResponse {
+    storefront_config: AdminStorefrontConfig;
+}
+/** Body for `PUT /admin/thor/storefront-config/:id` */
+interface UpdateStorefrontConfigBody {
+    theme_accent_color: string;
+    logo_url: string;
+    currency_code: string;
+    seo_defaults: {
+        title: string;
+        description: string;
+        ogImage?: string;
+    };
+    frontend_webhook_url?: string;
+}
+/** Response for `PUT /admin/thor/storefront-config/:id` */
+interface UpdateStorefrontConfigResponse {
+    storefront_config: AdminStorefrontConfig;
+}
+/**
+ * A single history entry for the Site Designer config.
+ */
+interface AdminSiteConfigHistoryEntry {
+    id?: string;
+    version: string;
+    createdAt: string;
+    createdBy?: string;
+}
+/**
+ * Full site config record as returned by admin endpoints.
+ * `config` is the free-form `DesignerConfig` JSON object.
+ */
+interface AdminSiteConfig {
+    id: string;
+    sales_channel_id: string;
+    version: string;
+    /** Free-form DesignerConfig object managed by the Site Designer */
+    config: Record<string, unknown>;
+    history?: AdminSiteConfigHistoryEntry[];
+    created_at?: string;
+    updated_at?: string;
+}
+/** Response for `GET /admin/thor/site-config/:sales_channel_id` */
+interface GetAdminSiteConfigResponse {
+    site_config: AdminSiteConfig;
+}
+/** Body for `PUT /admin/thor/site-config/:sales_channel_id` */
+type UpdateSiteConfigBody = Record<string, unknown>;
+/** Response for `PUT /admin/thor/site-config/:sales_channel_id` */
+interface UpdateSiteConfigResponse {
+    site_config: AdminSiteConfig;
+}
+/**
+ * A full history entry including the stored config snapshot.
+ */
+interface AdminSiteConfigHistoryEntryFull {
+    id: string;
+    version: string;
+    config: Record<string, unknown>;
+    createdAt: string;
+    createdBy?: string;
+}
+/** Response for `GET /admin/thor/site-config/:sales_channel_id/history` */
+interface GetAdminSiteConfigHistoryResponse {
+    history: AdminSiteConfigHistoryEntryFull[];
+    count: number;
+}
+/** Options for paginating site config history */
+interface GetAdminSiteConfigHistoryOptions {
+    limit?: number;
+    offset?: number;
+}
+/** Response for `POST /admin/thor/site-config/:sales_channel_id/restore/:version` */
+interface RestoreSiteConfigResponse {
+    site_config: AdminSiteConfig;
+}
+/** Response for `POST /store/thor/customers/me/channels` */
+interface LinkCustomerToChannelResponse {
+    linked: boolean;
+    reason?: 'already_linked';
 }
 
-export { type AccountDropdownConfig, type AccountMenuItem, type ActiveFilter, type Address, type AdminProduct, type AdminProductVariant, type AdminUser, type AdvancedSearchProductsOptions, type AuditLog, type AuditLogAdapter, type AuthConfig, type AuthMethod, type AuthProvider, type AuthResponse, type AuthStorage, type AuthorConfig, type BackendCapabilities, type BrandConfig, type CachedPaymentMethods, 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 Connection, type Country, type CreateAddressData, type Customer, type DashboardConfig, type DashboardMetrics, type DashboardMetricsAdapter, type DashboardOrdersAdapter, type DashboardProductsAdapter, type DesignerConfig, type DesignerHistoryEntry, type DesignerNavItem, type DesignerThemeConfig, type DesignerThemePreset, type DiscountCode, type DynamicSource, type Edge, type FilterConfig, type FilterOption, type FilterSection, type FulfillmentOption, type FulfillmentSet, type FulfillmentStatus, type GetCategoriesCallback, type GetCategoriesOptions, type GetCollectionsOptions, type GetCustomersCallback, type GetCustomersOptions, type GetOrdersCallback, type GetOrdersOptions, type GetProductsOptions, type HeaderLinkItem, type HeaderNavigationConfig, type IconConfig, type Image, type InventoryLevel, type LoginCredentials, type ModulesConfig, type Money, type NavigationCalloutItem, type NavigationItem, type NavigationLinkItem, type Order, type OrderItem, 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 ProviderConfig, type ProviderTypeString, type Region, type RegisterData, type Review, type SEO, type SalesMetrics, type SearchBarConfig, type SearchResultMeta, type SelectedOption, 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 UpdateCustomerData, getProviderMetadata, isSupportedProviderType };
+export { type AccountDropdownConfig, type AccountMenuItem, type ActiveFilter, type Address, type AdminApiKey, type AdminChannelCategory, type AdminChannelCustomer, 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 BrandConfig, type CachedPaymentMethods, 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 Connection, type Country, type CreateAddressData, type Customer, type DashboardConfig, type DashboardMetrics, type DashboardMetricsAdapter, type DashboardOrdersAdapter, type DashboardProductsAdapter, type DesignerConfig, type DesignerHistoryEntry, type DesignerNavItem, type DesignerThemeConfig, type DesignerThemePreset, type DiscountCode, type DynamicSource, type Edge, type FilterConfig, type FilterOption, type FilterSection, type FulfillmentOption, type FulfillmentSet, type FulfillmentStatus, 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 GetOrdersCallback, type GetOrdersOptions, type GetProductsOptions, 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 Order, type OrderItem, 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 ProviderConfig, type ProviderTypeString, type Region, type RegisterData, type RestoreSiteConfigResponse, type Review, type SEO, type SalesMetrics, type SearchBarConfig, type SearchResultMeta, type SelectedOption, 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 UpdateSiteConfigBody, type UpdateSiteConfigResponse, type UpdateStorefrontConfigBody, type UpdateStorefrontConfigResponse, getProviderMetadata, isSupportedProviderType };

package/dist/index.js

@@ -22,22 +22,18 @@ var src_exports = {};
 __export(src_exports, {
   PROVIDER_METADATA: () => PROVIDER_METADATA,
   StorefrontConfigError: () => StorefrontConfigError,
-  SupportedProviderType: () => SupportedProviderType2,
+  SupportedProviderType: () => SupportedProviderType,
   getProviderMetadata: () => getProviderMetadata,
   isSupportedProviderType: () => isSupportedProviderType
 });
 module.exports = __toCommonJS(src_exports);
 
 // src/provider.ts
-var SupportedProviderType = /* @__PURE__ */ ((SupportedProviderType3) => {
-  SupportedProviderType3["Mock"] = "mock";
-  SupportedProviderType3["Medusa"] = "medusa";
-  SupportedProviderType3["Shopify"] = "shopify";
-  SupportedProviderType3["BigCommerce"] = "bigcommerce";
-  SupportedProviderType3["WooCommerce"] = "woocommerce";
-  SupportedProviderType3["Spree"] = "spree";
-  SupportedProviderType3["Magento"] = "magento";
-  return SupportedProviderType3;
+var SupportedProviderType = /* @__PURE__ */ ((SupportedProviderType2) => {
+  SupportedProviderType2["Mock"] = "mock";
+  SupportedProviderType2["Medusa"] = "medusa";
+  SupportedProviderType2["StelOrder"] = "stelorder";
+  return SupportedProviderType2;
 })(SupportedProviderType || {});
 var PROVIDER_METADATA = {
   mock: {
@@ -58,56 +54,15 @@ var PROVIDER_METADATA = {
     ],
     maxRetries: 3
   },
-  shopify: {
-    name: "Shopify",
-    description: "Shopify Storefront API (GraphQL)",
+  stelorder: {
+    name: "Stel Order",
+    description: "Stel Order ERP and sales document API",
     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"
+      "NEXT_PUBLIC_COMMERCE_API_URL",
+      "NEXT_PUBLIC_COMMERCE_API_KEY"
     ],
-    maxRetries: 3
+    maxRetries: 2
   }
 };
 function isSupportedProviderType(value) {
@@ -135,13 +90,6 @@ var StorefrontConfigError = class extends Error {
     this.requiredEnvVar = requiredEnvVar;
   }
 };
-
-// src/index.ts
-var SupportedProviderType2 = /* @__PURE__ */ ((SupportedProviderType3) => {
-  SupportedProviderType3["Mock"] = "mock";
-  SupportedProviderType3["Medusa"] = "medusa";
-  return SupportedProviderType3;
-})(SupportedProviderType2 || {});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PROVIDER_METADATA,

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 enum SupportedProviderType {\n  Mock = 'mock',\n  Medusa = 'medusa',\n}\n\n// Re-export provider types directly\nexport { 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} 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., Shopify):\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 (automatically synced)\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 * - 🟡 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  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' | '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  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 * This type is automatically synced with SupportedProviderType from provider.ts.\n * When adding a new provider, update packages/types/src/provider.ts,\n * and this type will automatically reflect the new provider.\n *\n * Currently supported:\n * - ✅ 'mock': Backend-optional layout/design mode using fixture data\n * - ✅ 'medusa': Fully implemented\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' | '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   * - 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,+BAAAA;AAAA,EAAA;AAAA;AAAA;AAAA;;;ACiCO,IAAK,wBAAL,kBAAKC,2BAAL;AACL,EAAAA,uBAAA,UAAO;AACP,EAAAA,uBAAA,YAAS;AACT,EAAAA,uBAAA,aAAU;AACV,EAAAA,uBAAA,iBAAc;AACd,EAAAA,uBAAA,iBAAc;AACd,EAAAA,uBAAA,WAAQ;AACR,EAAAA,uBAAA,aAAU;AAPA,SAAAA;AAAA,GAAA;AA6BL,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,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;;;ACvEO,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;;;AFQO,IAAKC,yBAAL,kBAAKA,2BAAL;AACL,EAAAA,uBAAA,UAAO;AACP,EAAAA,uBAAA,YAAS;AAFC,SAAAA;AAAA,6BAAA;","names":["SupportedProviderType","SupportedProviderType","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} 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}\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';\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};\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;AAHF,SAAAA;AAAA,GAAA;AAyBL,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;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;;;ACzBO,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"]}