@thorprovider/types 2.0.2

package/dist/index.js

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

package/dist/index.js.map

@@ -0,0 +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  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 * Currently only 'medusa' is implemented; others are placeholders for future expansion.\n *\n * @remarks Implementation status:\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  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 = '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  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 * - ✅ '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 = '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;;;AC+BO,IAAK,wBAAL,kBAAKC,2BAAL;AACL,EAAAA,uBAAA,YAAS;AACT,EAAAA,uBAAA,aAAU;AACV,EAAAA,uBAAA,iBAAc;AACd,EAAAA,uBAAA,iBAAc;AACd,EAAAA,uBAAA,WAAQ;AACR,EAAAA,uBAAA,aAAU;AANA,SAAAA;AAAA,GAAA;AA4BL,IAAM,oBAST;AAAA,EACF,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;;;AC9DO,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;;;AFSO,IAAKC,yBAAL,kBAAKA,2BAAL;AACL,EAAAA,uBAAA,YAAS;AADC,SAAAA;AAAA,6BAAA;","names":["SupportedProviderType","SupportedProviderType","SupportedProviderType"]}

package/dist/index.mjs

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

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provider.ts","../src/storefront.ts","../src/index.ts"],"sourcesContent":["/**\n * @thorprovider/types — Supported Providers\n *\n * Centralized list of all supported commerce providers.\n * This is the single source of truth for provider types across the monorepo.\n *\n * @remarks\n * - L1 (Foundation): Defines the contract\n * - L2 (@thorprovider/adapters) imports from here to build the factory\n * - L5 (Starters) uses the factory which is bound to this enum\n *\n * When adding a new provider (e.g., 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 * Currently only 'medusa' is implemented; others are placeholders for future expansion.\n *\n * @remarks Implementation status:\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  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 = '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  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 * - ✅ '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 = '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","/**\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  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"],"mappings":";AA+BO,IAAK,wBAAL,kBAAKA,2BAAL;AACL,EAAAA,uBAAA,YAAS;AACT,EAAAA,uBAAA,aAAU;AACV,EAAAA,uBAAA,iBAAc;AACd,EAAAA,uBAAA,iBAAc;AACd,EAAAA,uBAAA,WAAQ;AACR,EAAAA,uBAAA,aAAU;AANA,SAAAA;AAAA,GAAA;AA4BL,IAAM,oBAST;AAAA,EACF,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;;;AC9DO,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;;;ACSO,IAAKC,yBAAL,kBAAKA,2BAAL;AACL,EAAAA,uBAAA,YAAS;AADC,SAAAA;AAAA,6BAAA;","names":["SupportedProviderType","SupportedProviderType"]}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@thorprovider/types",
+  "version": "2.0.2",
+  "description": "Shared TypeScript types for Thor Commerce ecosystem - Framework-agnostic type definitions",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thorprovider/thor-commerce",
+    "directory": "packages/types"
+  },
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/publish.log

@@ -0,0 +1,60 @@
+npm warn Unknown project config "network-concurrency". This will stop working in the next major version of npm.
+npm warn publish npm auto-corrected some errors in your package.json when publishing.  Please run "npm pkg fix" to address these errors.
+npm warn publish errors corrected:
+npm warn publish "repository.url" was normalized to "git+https://github.com/thorprovider/thor-commerce.git"
+npm notice
+npm notice 📦  @thor/types@2.0.1
+npm notice Tarball Contents
+npm notice 277B AGENTS.md
+npm notice 1.6kB CHANGELOG.md
+npm notice 6.4kB README.md
+npm notice 101.2kB dist/index.d.mts
+npm notice 101.2kB dist/index.d.ts
+npm notice 3.2kB dist/index.js
+npm notice 14.3kB dist/index.js.map
+npm notice 1.9kB dist/index.mjs
+npm notice 14.2kB dist/index.mjs.map
+npm notice 832B package.json
+npm notice 724B src/admin/AdminUser.ts
+npm notice 946B src/admin/AuditLog.ts
+npm notice 2.0kB src/admin/DashboardConfig.ts
+npm notice 1.5kB src/admin/DashboardMetrics.ts
+npm notice 268B src/admin/index.ts
+npm notice 1.2kB src/admin/SiteConfigMetadata.ts
+npm notice 6.5kB src/auth.ts
+npm notice 2.8kB src/cart.ts
+npm notice 3.0kB src/category.ts
+npm notice 733B src/collection.ts
+npm notice 35.3kB src/commerce-provider.ts
+npm notice 2.1kB src/common.ts
+npm notice 4.6kB src/customer.ts
+npm notice 2.5kB src/designer-config.ts
+npm notice 7.3kB src/header-config.README.md
+npm notice 4.6kB src/header-config.ts
+npm notice 5.5kB src/index.ts
+npm notice 5.0kB src/order.ts
+npm notice 6.0kB src/payment.ts
+npm notice 10.7kB src/product.ts
+npm notice 3.8kB src/provider.ts
+npm notice 1.4kB src/region.ts
+npm notice 2.1kB src/site-config-labels.ts
+npm notice 3.0kB src/site-config.ts
+npm notice 1.3kB src/stock-location.ts
+npm notice 1.5kB src/storefront-config.ts
+npm notice 3.3kB src/storefront.ts
+npm notice 333B tsconfig.json
+npm notice 303B tsup.config.ts
+npm notice Tarball Details
+npm notice name: @thor/types
+npm notice version: 2.0.1
+npm notice filename: thor-types-2.0.1.tgz
+npm notice package size: 87.7 kB
+npm notice unpacked size: 365.5 kB
+npm notice shasum: 45a0c68b20d21a5446a471abb9077f2dd59cdd0d
+npm notice integrity: sha512-AJRNa0Gs1osFo[...]RLXmlsHuMfinQ==
+npm notice total files: 39
+npm notice
+npm notice Publishing to https://npm.pkg.github.com with tag latest and restricted access
+npm error code E401
+npm error 401 Unauthorized - PUT https://npm.pkg.github.com/@thor%2ftypes - unauthenticated: User cannot be authenticated with the token provided.
+npm error A complete log of this run can be found in: /home/nelson/.npm/_logs/2026-04-16T15_45_29_457Z-debug-0.log

package/src/admin/AdminUser.ts

@@ -0,0 +1,32 @@
+/**
+ * Admin User Types
+ * 
+ * Defines the structure for admin user accounts.
+ * MVP uses single password (no email), but prepared for multi-admin.
+ * 
+ * @module admin/AdminUser
+ */
+
+/**
+ * Admin User Account
+ * 
+ * @remarks
+ * - MVP: email and passwordHash are optional (uses global password)
+ * - Future: Required fields for multi-admin system
+ */
+export interface AdminUser {
+  /** Unique identifier */
+  id: string;
+  
+  /** Email address (optional in MVP, required for multi-admin) */
+  email?: string;
+  
+  /** Bcrypt password hash (optional in MVP, required for multi-admin) */
+  passwordHash?: string;
+  
+  /** Account creation timestamp */
+  createdAt: Date;
+  
+  /** Last update timestamp */
+  updatedAt: Date;
+}

package/src/admin/AuditLog.ts

@@ -0,0 +1,43 @@
+/**
+ * Audit Log Types
+ * 
+ * Defines the structure for audit logging of admin actions.
+ * Tracks all critical operations for security and compliance.
+ * 
+ * @module admin/AuditLog
+ */
+
+/**
+ * Audit Log Entry
+ * 
+ * @remarks
+ * Records all admin actions for security auditing and compliance
+ */
+export interface AuditLog {
+  /** Unique identifier */
+  id: string;
+  
+  /** ID of the admin who performed the action */
+  adminId: string;
+  
+  /** Action performed (e.g., 'login_success', 'update_order_status') */
+  action: string;
+  
+  /** Type of resource affected (e.g., 'auth', 'order', 'product') */
+  resourceType: string;
+  
+  /** ID of the specific resource (optional) */
+  resourceId?: string;
+  
+  /** Additional context data */
+  metadata?: Record<string, unknown>;
+  
+  /** IP address of the requester */
+  ipAddress?: string;
+  
+  /** User agent string */
+  userAgent?: string;
+  
+  /** Timestamp of the action */
+  createdAt: Date;
+}

package/src/admin/DashboardConfig.ts

@@ -0,0 +1,82 @@
+/**
+ * Dashboard Configuration Types
+ * 
+ * Defines the configuration structure for the DashboardModule.
+ * Uses adapters pattern for maximum flexibility and testability.
+ * 
+ * @module admin/DashboardConfig
+ */
+
+import type { DashboardMetrics } from './DashboardMetrics';
+import type { Order, Product } from '../index';
+
+/**
+ * Adapter for fetching dashboard metrics
+ * 
+ * @remarks
+ * L3 components use this interface, L5 provides HTTP implementation
+ */
+export interface DashboardMetricsAdapter {
+  getMetrics(): Promise<DashboardMetrics>;
+}
+
+/**
+ * Adapter for fetching and managing orders
+ */
+export interface DashboardOrdersAdapter {
+  getOrders(params?: {
+    page?: number;
+    limit?: number;
+    search?: string;
+  }): Promise<{ orders: Order[]; total: number }>;
+  
+  getOrderById(id: string): Promise<Order>;
+  
+  updateOrderStatus?(id: string, status: string): Promise<Order>;
+}
+
+/**
+ * Adapter for fetching and managing products
+ */
+export interface DashboardProductsAdapter {
+  getProducts(params?: {
+    page?: number;
+    limit?: number;
+    search?: string;
+  }): Promise<{ products: Product[]; total: number }>;
+  
+  getProductById(id: string): Promise<Product>;
+}
+
+/**
+ * Adapter for fetching audit logs
+ */
+export interface AuditLogAdapter {
+  getLogs(params?: {
+    page?: number;
+    limit?: number;
+  }): Promise<{ logs: any[]; total: number }>;
+}
+
+/**
+ * Complete Dashboard Configuration
+ * 
+ * @remarks
+ * Passed to DashboardModule component
+ */
+export interface DashboardConfig {
+  /** Storefront identifier */
+  storefrontId: string;
+  
+  /** Metrics adapter (required for all variants) */
+  metrics: DashboardMetricsAdapter;
+  
+  /** Orders adapter (required for standard and complete variants) */
+  orders: DashboardOrdersAdapter;
+  
+  /** Products adapter (optional, for complete variant) */
+  products?: DashboardProductsAdapter;
+  
+  /** Audit logs adapter (optional, for complete variant) */
+  auditLogs?: AuditLogAdapter;
+}

package/src/admin/DashboardMetrics.ts

@@ -0,0 +1,81 @@
+/**
+ * Dashboard Metrics Types
+ * 
+ * Defines the structure for dashboard analytics and metrics.
+ * Used by the DashboardModule to display key business indicators.
+ * 
+ * @module admin/DashboardMetrics
+ */
+
+/**
+ * Sales Metrics
+ */
+export interface SalesMetrics {
+  /** Total sales amount (all time) */
+  total: number;
+  
+  /** Sales amount today */
+  today: number;
+  
+  /** Sales amount in the last 7 days */
+  week: number;
+  
+  /** Sales amount in the last 30 days */
+  month: number;
+}
+
+/**
+ * Orders Metrics
+ */
+export interface OrdersMetrics {
+  /** Total number of orders */
+  total: number;
+  
+  /** Number of pending orders */
+  pending: number;
+  
+  /** Number of orders being processed */
+  processing: number;
+  
+  /** Number of completed orders */
+  completed: number;
+}
+
+/**
+ * Products Metrics
+ */
+export interface ProductsMetrics {
+  /** Total number of products */
+  total: number;
+  
+  /** Number of products with low stock */
+  lowStock: number;
+}
+
+/**
+ * Chart Data Point
+ */
+export interface ChartDataPoint {
+  /** Date in ISO format (YYYY-MM-DD) */
+  date: string;
+  
+  /** Sales amount for this date */
+  sales: number;
+}
+
+/**
+ * Complete Dashboard Metrics
+ */
+export interface DashboardMetrics {
+  /** Sales metrics */
+  sales: SalesMetrics;
+  
+  /** Orders metrics */
+  orders: OrdersMetrics;
+  
+  /** Products metrics */
+  products: ProductsMetrics;
+  
+  /** Chart data for visualization (last 7 days) */
+  chartData: ChartDataPoint[];
+}