@thorprovider/types 3.3.0 → 3.4.1

package/src/admin/index.ts

@@ -12,3 +12,4 @@ export * from './DashboardConfig';
 export * from './DashboardMetrics';
 export * from './SiteConfigMetadata';
 export * from './MultiTenantAdmin';
+export * from './DropshippingAdmin';

package/src/auth.ts

@@ -233,22 +233,35 @@ export interface AuthProvider {
    * Only implemented if capabilities.deleteAccount is true.
    */
   deleteCustomerAccount(): Promise<void>;
-
+  
   // ========================================
-  // Multi-Tenant — Channel Link
+  // Address Management
   // ========================================
-
+  
   /**
-   * 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.
-   */
-  linkCustomerToChannel(): Promise<{ linked: boolean; reason?: string }>;
+   * 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
+   */
+  deleteAddress(addressId: string): Promise<void>;
 }

package/src/commerce-provider.ts

@@ -740,6 +740,48 @@ export interface CommerceProvider {
    * ```
    */
   updateBillingAddress?(cartId: string, address: Address): Promise<Cart>;
+
+  /**
+   * Update the shipping address on a cart.
+   *
+   * Sets the customer's delivery address and email before proceeding to
+   * shipping method and payment selection.
+   *
+   * @param cartId - Cart ID
+   * @param address - Shipping address and contact details
+   * @throws {ProviderAPIError} If cart not found or address is invalid
+   *
+   * @example
+   * ```typescript
+   * await commerce.updateShippingAddress(cartId, {
+   *   email: 'customer@example.com',
+   *   firstName: 'Jane',
+   *   lastName: 'Doe',
+   *   address1: '123 Main St',
+   *   city: 'Madrid',
+   *   province: 'Madrid',
+   *   postalCode: '28001',
+   *   countryCode: 'ES',
+   *   phone: '+34 600 000 000',
+   * });
+   * ```
+   */
+  updateShippingAddress?(
+    cartId: string,
+    address: {
+      email: string;
+      firstName: string;
+      lastName: string;
+      address1: string;
+      address2?: string;
+      company?: string;
+      city: string;
+      province: string;
+      postalCode: string;
+      countryCode: string;
+      phone: string;
+    },
+  ): Promise<void>;
   
   // ============================================  // Customer Operations (Optional)
   // ============================================

package/src/index.ts

@@ -261,7 +261,112 @@ export type {
   GetAdminSiteConfigHistoryOptions,
   RestoreSiteConfigResponse,
   LinkCustomerToChannelResponse,
-} from './admin';
+  // Dropshipping types
+  DropshipperAccountRef,
+  OnboardDropshipperBody,
+  OnboardDropshipperResponse,
+  VariantCost,
+  GetVariantCostsOptions,
+  GetVariantCostsResponse,
+  CreateVariantCostBody,
+  CreateVariantCostResponse,
+  BatchVariantCostItem,
+  BatchVariantCostsBody,
+  BatchVariantCostsResponse,
+  DeleteVariantCostResponse,
+  DropshipperVariant,
+  DropshipperProduct,
+  GetDropshipperProductsOptions,
+  GetDropshipperProductsResponse,
+  DropshipperPriceItem,
+  UpdateDropshipperPricesBody,
+  UpdateDropshipperPricesResponse,
+  DropshipperOrderCustomer,
+  DropshipperOrder,
+  GetDropshipperOrdersOptions,
+  GetDropshipperOrdersResponse,
+  DropshipperOrderShippingAddress,
+  DropshipperOrderItem,
+  DropshipperOrderTotals,
+  DropshipperOrderTimelineEvent,
+  DropshipperOrderDetail,
+  GetDropshipperOrderDetailResponse,
+  CreateOrderItem,
+  CreateDropshipperOrderBody,
+  CreateDropshipperOrderResponse,
+  SetPaymentCollectorBody,
+  SetPaymentCollectorResponse,
+  DropshipperCategory,
+  GetDropshipperCategoriesOptions,
+  GetDropshipperCategoriesResponse,
+  CreateDropshipperCategoryBody,
+  UpdateDropshipperCategoryBody,
+  DeleteDropshipperCategoryResponse,
+  CreateCategoryMappingBody,
+  CreateCategoryMappingResponse,
+  DeleteCategoryMappingResponse,
+  DropshipperCustomer,
+  DropshipperCustomerStats,
+  DropshipperCustomerOrderRef,
+  DropshipperCustomerDetail,
+  GetDropshipperCustomersOptions,
+  GetDropshipperCustomersResponse,
+  GetDropshipperCustomerDetailResponse,
+  CreateDropshipperCustomerBody,
+  CreateDropshipperCustomerResponse,
+  DropshipperBalance,
+  DropshipperPendingOrders,
+  DropshipperAccount,
+  GetDropshipperAccountResponse,
+  DropshipperPayableOrder,
+  GetDropshipperPayableResponse,
+  DropshipperReceivableOrder,
+  GetDropshipperReceivableResponse,
+  SettlementRecord,
+  GetSettlementsOptions,
+  GetSettlementsResponse,
+  GetSettlementDetailResponse,
+  CreateSettlementBody,
+  CreateSettlementResponse,
+  ConfirmSettlementBody,
+  CancelSettlementBody,
+  UpdateSettlementStatusResponse,
+  AdminDropshipperAccount,
+  AdminDropshipperBalance,
+  GetAdminDropshipperAccountsResponse,
+  GetAdminAccountBalanceResponse,
+  GetAdminPriceListsResponse,
+  GetUserChannelResponse,
+  DropshipperPromotion,
+  GetDropshipperPromotionsOptions,
+  GetDropshipperPromotionsResponse,
+  PromotionRule,
+  CreateDropshipperPromotionBody,
+  UpdateDropshipperPromotionBody,
+   DeleteDropshipperPromotionResponse,
+   GetDashboardStatsOptions,
+   DashboardPeriodMetrics,
+   DashboardChanges,
+   DashboardTopProduct,
+   DashboardStats,
+   GetDashboardStatsResponse,
+   GetStorefrontDropshipperCategoriesResponse,
+   OrderNote,
+   CreateOrderNoteBody,
+   GetOrderNotesResponse,
+   DeleteOrderNoteResponse,
+   // Order cancel and edits
+   CancelDropshipperOrderResponse,
+   CreateOrderEditBody,
+   CreateOrderEditResponse,
+   AddOrderEditItemBody,
+   AddOrderEditItemResponse,
+   ConfirmOrderEditResponse,
+   // Dropshipper addresses (channel-scoped)
+   DropshipperAddressBody,
+   DropshipperAddressResponse,
+   GetDropshipperAddressesResponse,
+  } from './admin';
 
 // ============================================
 // Header Configuration Types

package/src/provider.ts

@@ -36,6 +36,11 @@ export enum SupportedProviderType {
   Mock = 'mock',
   Medusa = 'medusa',
   StelOrder = 'stelorder',
+  Shopify = 'shopify',
+  BigCommerce = 'bigcommerce',
+  WooCommerce = 'woocommerce',
+  Spree = 'spree',
+  Magento = 'magento',
 }
 
 /**
@@ -49,7 +54,7 @@ export enum SupportedProviderType {
  * }
  * ```
  */
-export type ProviderTypeString = 'mock' | 'medusa' | 'stelorder';
+export type ProviderTypeString = 'mock' | 'medusa' | 'stelorder' | 'shopify' | 'bigcommerce' | 'woocommerce' | 'spree' | 'magento';
 
 /**
  * Metadata about each provider.
@@ -95,6 +100,57 @@ export const PROVIDER_METADATA: Record<
     ],
     maxRetries: 2,
   },
+  shopify: {
+    name: 'Shopify',
+    description: 'Shopify Storefront API (GraphQL)',
+    requiresStorefront: false,
+    requiredEnvVars: [
+      'NEXT_PUBLIC_SHOPIFY_STORE_DOMAIN',
+      'NEXT_PUBLIC_SHOPIFY_STOREFRONT_TOKEN',
+    ],
+    maxRetries: 3,
+  },
+  bigcommerce: {
+    name: 'BigCommerce',
+    description: 'BigCommerce REST Storefront API',
+    requiresStorefront: false,
+    requiredEnvVars: [
+      'BIGCOMMERCE_STORE_HASH',
+      'BIGCOMMERCE_STOREFRONT_API_TOKEN',
+      'BIGCOMMERCE_CHANNEL_ID',
+    ],
+    maxRetries: 3,
+  },
+  woocommerce: {
+    name: 'WooCommerce',
+    description: 'WooCommerce Store API + REST API v3',
+    requiresStorefront: false,
+    requiredEnvVars: [
+      'WOOCOMMERCE_URL',
+      'WOOCOMMERCE_CONSUMER_KEY',
+      'WOOCOMMERCE_CONSUMER_SECRET',
+    ],
+    maxRetries: 3,
+  },
+  spree: {
+    name: 'Spree Commerce',
+    description: 'Spree API v2 Storefront (JSON:API)',
+    requiresStorefront: false,
+    requiredEnvVars: [
+      'SPREE_API_URL',
+    ],
+    maxRetries: 3,
+  },
+  magento: {
+    name: 'Adobe Commerce (Magento)',
+    description: 'Adobe Commerce GraphQL + REST API',
+    requiresStorefront: true,
+    requiredEnvVars: [
+      'MAGENTO_URL',
+      'MAGENTO_STORE_CODE',
+    ],
+    maxRetries: 3,
+  },
 };
 
 /**