@thorprovider/types 3.2.1 → 3.4.0

package/dist/index.d.ts

@@ -2784,6 +2784,44 @@ 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>;
     /**
      * Get customer by ID (optional)
      * @param customerId - Customer ID
@@ -3383,4 +3421,1099 @@ interface SiteConfigMetadata {
     history?: ConfigHistoryEntry[];
 }
 
-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 };
+/**
+ * @thorprovider/types — Multi-Tenant Admin Types
+ *
+ * Type definitions for admin operations on the Thor Commerce multi-tenant
+ * backend plugin (`/admin/thor/`).
+ *
+ * These types map 1:1 to the API contract defined in
+ * `multitenant-api-contract.md`.
+ *
+ * @module admin/MultiTenantAdmin
+ */
+/**
+ * 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';
+}
+
+/**
+ * @thorprovider/types — Dropshipping Admin Types
+ *
+ * Type definitions for all dropshipping API operations on the Thor Commerce
+ * extended backend plugin (`/admin/thor/dropshipper/`).
+ *
+ * These types map 1:1 to the API contract defined in
+ * `dropshipping-api-contract.md`.
+ *
+ * Actors:
+ *   X = ThorProvider admin (role "Admin")
+ *   Y = Dropshipper (role "Dropshipper")
+ *   V = End customer (store)
+ *
+ * @module admin/DropshippingAdmin
+ */
+
+/** Slim reference to a dropshipper account */
+interface DropshipperAccountRef {
+    id: string;
+    provider_name: string;
+}
+/** Body for `POST /admin/thor/dropshipper/onboard` */
+interface OnboardDropshipperBody {
+    /** Business name — used as SalesChannel name and DropshipperAccount.provider_name */
+    business_name: string;
+    /** Dropshipper user email. Must be unique in the system. */
+    email: string;
+    /** Initial password. Y should change it on first access. */
+    password: string;
+    /** Contact phone number */
+    phone?: string;
+    /** Name of the account contact person */
+    contact_name?: string;
+    /** Payment terms in days after delivery. Default: 15 */
+    payment_terms_days?: number;
+    /** Primary currency code. Default: "usd" */
+    currency_code?: string;
+}
+/** Response for `POST /admin/thor/dropshipper/onboard` */
+interface OnboardDropshipperResponse {
+    dropshipper: {
+        user_id: string;
+        email: string;
+        sales_channel_id: string;
+        sales_channel_name: string;
+        account_id: string;
+        price_list_id: string;
+        /** Publishable API key token for the storefront */
+        publishable_key_token: string;
+        role: 'Dropshipper';
+    };
+}
+/** A single variant cost record */
+interface VariantCost {
+    id: string;
+    account_id: string;
+    variant_id: string;
+    variant_title?: string;
+    product_title?: string;
+    cost_amount: number;
+    currency_code: string;
+    created_at?: string;
+    updated_at: string;
+}
+/** Options for `GET /admin/thor/dropshipper/variant-costs` */
+interface GetVariantCostsOptions {
+    /** Filter by dropshipper account */
+    account_id?: string;
+    variant_id?: string;
+    currency_code?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Response for `GET /admin/thor/dropshipper/variant-costs` */
+interface GetVariantCostsResponse {
+    variant_costs: VariantCost[];
+    count: number;
+    offset: number;
+    limit: number;
+}
+/** Body for `POST /admin/thor/dropshipper/variant-costs` (upsert) */
+interface CreateVariantCostBody {
+    account_id: string;
+    variant_id: string;
+    cost_amount: number;
+    currency_code: string;
+}
+/** Response for `POST /admin/thor/dropshipper/variant-costs` */
+interface CreateVariantCostResponse {
+    variant_cost: VariantCost;
+}
+/** Single item in a batch variant cost update */
+interface BatchVariantCostItem {
+    variant_id: string;
+    cost_amount: number;
+}
+/** Body for `POST /admin/thor/dropshipper/variant-costs/batch` */
+interface BatchVariantCostsBody {
+    account_id: string;
+    currency_code: string;
+    costs: BatchVariantCostItem[];
+}
+/** Response for `POST /admin/thor/dropshipper/variant-costs/batch` */
+interface BatchVariantCostsResponse {
+    updated: number;
+    errors: unknown[];
+}
+/** Response for `DELETE /admin/thor/dropshipper/variant-costs/:id` */
+interface DeleteVariantCostResponse {
+    deleted: true;
+    id: string;
+}
+/** A product variant as seen by the dropshipper */
+interface DropshipperVariant {
+    id: string;
+    title: string;
+    sku: string | null;
+    stock_quantity: number;
+    /** Price Y pays to X. Read-only for Y. */
+    cost_price: number;
+    cost_price_currency: string;
+    /** "custom" if from DropshipperVariantCost, "base_price" if fallback */
+    cost_price_source: 'custom' | 'base_price';
+    /** Price Y charges to V. From the channel's price list. */
+    sale_price: number;
+    sale_price_currency: string;
+    /** sale_price - cost_price (calculated by backend) */
+    margin: number;
+    /** (margin / sale_price) × 100 (calculated by backend) */
+    margin_percent: number;
+}
+/** A product as seen by the dropshipper */
+interface DropshipperProduct {
+    id: string;
+    title: string;
+    thumbnail: string | null;
+    status: 'published' | 'draft' | string;
+    variants: DropshipperVariant[];
+}
+/** Options for `GET /admin/thor/dropshipper/products` */
+interface GetDropshipperProductsOptions {
+    /** Search by product or variant title */
+    q?: string;
+    category_id?: string;
+    status?: 'published' | 'draft';
+    in_stock?: boolean;
+    limit?: number;
+    offset?: number;
+}
+/** Response for `GET /admin/thor/dropshipper/products` */
+interface GetDropshipperProductsResponse {
+    products: DropshipperProduct[];
+    count: number;
+    offset: number;
+    limit: number;
+}
+/** Single price update item */
+interface DropshipperPriceItem {
+    variant_id: string;
+    amount: number;
+}
+/** Body for `PUT /admin/thor/dropshipper/prices` */
+interface UpdateDropshipperPricesBody {
+    currency_code: string;
+    prices: DropshipperPriceItem[];
+}
+/** Response for `PUT /admin/thor/dropshipper/prices` */
+interface UpdateDropshipperPricesResponse {
+    updated: number;
+    price_list_id: string;
+}
+/** Slim customer reference on an order */
+interface DropshipperOrderCustomer {
+    id: string;
+    full_name: string;
+    email: string;
+    phone?: string;
+}
+/** Slim order row as returned in list responses */
+interface DropshipperOrder {
+    id: string;
+    display_id: number;
+    status: string;
+    fulfillment_status: string | null;
+    created_at: string;
+    customer: DropshipperOrderCustomer;
+    currency_code: string;
+    total: number;
+    profit: number;
+    margin_percent: number;
+    items_count: number;
+    payment_collected_by: 'dropshipper' | 'provider' | null;
+    settlement_status: 'settled' | 'unsettled';
+}
+/** Options for `GET /admin/thor/dropshipper/orders` */
+interface GetDropshipperOrdersOptions {
+    status?: string;
+    payment_collector?: 'dropshipper' | 'provider';
+    settlement_status?: 'settled' | 'unsettled';
+    from?: string;
+    to?: string;
+    q?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Response for `GET /admin/thor/dropshipper/orders` */
+interface GetDropshipperOrdersResponse {
+    orders: DropshipperOrder[];
+    count: number;
+    offset: number;
+    limit: number;
+}
+/** A shipping address on an order */
+interface DropshipperOrderShippingAddress {
+    full_name: string;
+    address_1: string;
+    city: string;
+    province: string | null;
+    postal_code: string;
+    country_code: string;
+}
+/** A line item with cost and profit breakdown */
+interface DropshipperOrderItem {
+    id: string;
+    title: string;
+    variant_title: string;
+    sku: string | null;
+    quantity: number;
+    unit_price: number;
+    cost_price: number;
+    subtotal: number;
+    cost_subtotal: number;
+    profit: number;
+    thumbnail: string | null;
+}
+/** Order totals with profit breakdown */
+interface DropshipperOrderTotals {
+    subtotal: number;
+    shipping_total: number;
+    discount_total: number;
+    total: number;
+    cost_total: number;
+    profit: number;
+    margin_percent: number;
+}
+/** Timeline event on an order */
+interface DropshipperOrderTimelineEvent {
+    event: string;
+    timestamp: string;
+}
+/** Full order detail as returned by GET /admin/thor/dropshipper/orders/:id */
+interface DropshipperOrderDetail {
+    id: string;
+    display_id: number;
+    status: string;
+    fulfillment_status: string | null;
+    created_at: string;
+    currency_code: string;
+    customer: DropshipperOrderCustomer & {
+        phone?: string;
+    };
+    shipping_address: DropshipperOrderShippingAddress;
+    items: DropshipperOrderItem[];
+    totals: DropshipperOrderTotals;
+    payment_collected_by: 'dropshipper' | 'provider' | null;
+    settlement_status: 'settled' | 'unsettled';
+    timeline: DropshipperOrderTimelineEvent[];
+}
+/** Response for `GET /admin/thor/dropshipper/orders/:id` */
+interface GetDropshipperOrderDetailResponse {
+    order: DropshipperOrderDetail;
+}
+/** A line item in a manual order creation */
+interface CreateOrderItem {
+    variant_id: string;
+    quantity: number;
+}
+/** Body for `POST /admin/thor/dropshipper/orders` */
+interface CreateDropshipperOrderBody {
+    customer_id: string;
+    currency_code: string;
+    items: CreateOrderItem[];
+    shipping_address: DropshipperOrderShippingAddress & {
+        phone?: string;
+    };
+    shipping_method_id?: string;
+    notes?: string;
+}
+/** Response for `POST /admin/thor/dropshipper/orders` */
+interface CreateDropshipperOrderResponse {
+    order: {
+        id: string;
+        display_id: number;
+        status: string;
+        total: number;
+        profit: number;
+        created_at: string;
+    };
+}
+/** Body for `POST /admin/thor/dropshipper/orders/:id/set-payment-collector` */
+interface SetPaymentCollectorBody {
+    payment_collected_by: 'dropshipper' | 'provider';
+}
+/** Response for `POST /admin/thor/dropshipper/orders/:id/set-payment-collector` */
+interface SetPaymentCollectorResponse {
+    order_id: string;
+    payment_collected_by: 'dropshipper' | 'provider';
+    updated_at: string;
+}
+/** Response for `POST /admin/thor/dropshipper/orders/:id/cancel` */
+interface CancelDropshipperOrderResponse {
+    order: {
+        id: string;
+        status: string;
+        [key: string]: unknown;
+    };
+}
+/** Body for `POST /admin/thor/dropshipper/orders/:id/edits` */
+interface CreateOrderEditBody {
+    internal_note?: string;
+}
+/** Response for `POST /admin/thor/dropshipper/orders/:id/edits` */
+interface CreateOrderEditResponse {
+    order_edit: {
+        id: string;
+        order_id: string;
+        status: string;
+        [key: string]: unknown;
+    };
+}
+/** Body for `POST /admin/thor/dropshipper/orders/:id/edits/:edit_id/items` */
+interface AddOrderEditItemBody {
+    variant_id: string;
+    quantity: number;
+    unit_price?: number;
+}
+/** Response for `POST /admin/thor/dropshipper/orders/:id/edits/:edit_id/items` */
+interface AddOrderEditItemResponse {
+    order_edit: {
+        id: string;
+        [key: string]: unknown;
+    };
+}
+/** Response for `POST /admin/thor/dropshipper/orders/:id/edits/:edit_id/confirm` */
+interface ConfirmOrderEditResponse {
+    order: {
+        id: string;
+        [key: string]: unknown;
+    };
+}
+/** A dropshipper custom category node */
+interface DropshipperCategory {
+    id: string;
+    name: string;
+    handle: string;
+    description?: string | null;
+    position: number;
+    parent_id: string | null;
+    sales_channel_id?: string;
+    products_count?: number;
+    children?: DropshipperCategory[];
+    created_at?: string;
+    updated_at?: string;
+}
+/** Options for `GET /admin/thor/dropshipper/categories` */
+interface GetDropshipperCategoriesOptions {
+    parent_id?: string;
+    include_children?: boolean;
+}
+/** Response for `GET /admin/thor/dropshipper/categories` */
+interface GetDropshipperCategoriesResponse {
+    categories: DropshipperCategory[];
+}
+/** Body for `POST /admin/thor/dropshipper/categories` */
+interface CreateDropshipperCategoryBody {
+    name: string;
+    /** Auto-generated from name if omitted. Must be unique within the channel. */
+    handle?: string;
+    description?: string;
+    parent_id?: string | null;
+    position?: number;
+}
+/** Body for `PUT /admin/thor/dropshipper/categories/:id` */
+interface UpdateDropshipperCategoryBody {
+    name?: string;
+    description?: string;
+    handle?: string;
+    parent_id?: string | null;
+    position?: number;
+}
+/** Response for `DELETE /admin/thor/dropshipper/categories/:id` */
+interface DeleteDropshipperCategoryResponse {
+    deleted: true;
+    id: string;
+    /** Number of products unmapped from the deleted category */
+    unmapped_products: number;
+}
+/** Body for `POST /admin/thor/dropshipper/category-mappings` */
+interface CreateCategoryMappingBody {
+    category_id: string;
+    product_id: string;
+}
+/** Response for `POST /admin/thor/dropshipper/category-mappings` */
+interface CreateCategoryMappingResponse {
+    mapping: {
+        id: string;
+        category_id: string;
+        product_id: string;
+        created_at: string;
+    };
+}
+/** Response for `DELETE /admin/thor/dropshipper/category-mappings/:id` */
+interface DeleteCategoryMappingResponse {
+    deleted: true;
+    id: string;
+}
+/** A customer as seen by the dropshipper (list view) */
+interface DropshipperCustomer {
+    id: string;
+    first_name: string | null;
+    last_name: string | null;
+    email: string;
+    phone: string | null;
+    created_at: string;
+    total_orders: number;
+    total_spent: number;
+    currency_code: string;
+    last_order_at: string | null;
+}
+/** Stats on a customer as seen by the dropshipper */
+interface DropshipperCustomerStats {
+    total_orders: number;
+    total_spent: number;
+    total_profit_generated: number;
+    avg_order_value: number;
+    currency_code: string;
+    first_order_at: string | null;
+    last_order_at: string | null;
+}
+/** Slim order reference for customer detail */
+interface DropshipperCustomerOrderRef {
+    id: string;
+    display_id: number;
+    status: string;
+    total: number;
+    created_at: string;
+}
+/** Full customer detail as seen by the dropshipper */
+interface DropshipperCustomerDetail {
+    id: string;
+    first_name: string | null;
+    last_name: string | null;
+    email: string;
+    phone: string | null;
+    created_at: string;
+    default_shipping_address?: DropshipperOrderShippingAddress | null;
+    stats: DropshipperCustomerStats;
+    recent_orders: DropshipperCustomerOrderRef[];
+}
+/** Options for `GET /admin/thor/dropshipper/customers` */
+interface GetDropshipperCustomersOptions {
+    q?: string;
+    has_orders?: boolean;
+    from?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Response for `GET /admin/thor/dropshipper/customers` */
+interface GetDropshipperCustomersResponse {
+    customers: DropshipperCustomer[];
+    count: number;
+    offset: number;
+    limit: number;
+}
+/** Response for `GET /admin/thor/dropshipper/customers/:id` */
+interface GetDropshipperCustomerDetailResponse {
+    customer: DropshipperCustomerDetail;
+}
+/** Body for `POST /admin/thor/dropshipper/customers` */
+interface CreateDropshipperCustomerBody {
+    first_name?: string;
+    last_name?: string;
+    email: string;
+    phone?: string;
+    password: string;
+    shipping_address?: {
+        address_1?: string;
+        city?: string;
+        province?: string;
+        postal_code?: string;
+        country_code?: string;
+    };
+}
+/** Response for `POST /admin/thor/dropshipper/customers` */
+interface CreateDropshipperCustomerResponse {
+    customer: {
+        id: string;
+        email: string;
+        first_name: string | null;
+        last_name: string | null;
+        sales_channel_id: string;
+        created_at: string;
+    };
+}
+/** Balance breakdown for a dropshipper account */
+interface DropshipperBalance {
+    /** Sum of cost_price × qty for delivered orders where Y collected payment. Unsettled. */
+    payable_to_provider: number;
+    /** Sum of profit for delivered orders where X collected payment (COD). Unsettled. */
+    receivable_from_provider: number;
+    /** receivable - payable. Negative = Y owes X; positive = X owes Y. */
+    net_balance: number;
+    net_balance_label: string;
+}
+/** Pending order counts for a balance summary */
+interface DropshipperPendingOrders {
+    payable_count: number;
+    payable_total: number;
+    receivable_count: number;
+    receivable_total: number;
+}
+/** Full account record as returned by `GET /admin/thor/dropshipper/account` */
+interface DropshipperAccount {
+    id: string;
+    provider_name: string;
+    currency_code: string;
+    payment_terms_days: number;
+    balance: DropshipperBalance;
+    pending_orders: DropshipperPendingOrders;
+}
+/** Response for `GET /admin/thor/dropshipper/account` */
+interface GetDropshipperAccountResponse {
+    account: DropshipperAccount;
+}
+/** A payable order row */
+interface DropshipperPayableOrder {
+    id: string;
+    display_id: number;
+    fulfilled_at: string;
+    due_date: string;
+    customer_name: string;
+    sale_total: number;
+    cost_total: number;
+    amount_payable: number;
+    days_overdue: number;
+}
+/** Response for `GET /admin/thor/dropshipper/account/payable` */
+interface GetDropshipperPayableResponse {
+    orders: DropshipperPayableOrder[];
+    total_payable: number;
+    count: number;
+    offset: number;
+    limit: number;
+}
+/** A receivable order row */
+interface DropshipperReceivableOrder {
+    id: string;
+    display_id: number;
+    fulfilled_at: string;
+    customer_name: string;
+    sale_total: number;
+    cost_total: number;
+    commission_amount: number;
+}
+/** Response for `GET /admin/thor/dropshipper/account/receivable` */
+interface GetDropshipperReceivableResponse {
+    orders: DropshipperReceivableOrder[];
+    total_receivable: number;
+    count: number;
+    offset: number;
+    limit: number;
+}
+/** A settlement record */
+interface SettlementRecord {
+    id: string;
+    type: 'payment_to_provider' | 'commission_from_provider';
+    amount: number;
+    order_ids_count?: number;
+    status: 'pending' | 'confirmed' | 'cancelled';
+    notes?: string | null;
+    created_at: string;
+    settled_at: string | null;
+    confirmed_by: string | null;
+    account?: DropshipperAccountRef;
+    orders?: Array<{
+        id: string;
+        display_id: number;
+        fulfilled_at: string;
+        cost_total: number;
+    }>;
+}
+/** Options for listing settlements */
+interface GetSettlementsOptions {
+    status?: 'pending' | 'confirmed' | 'cancelled';
+    type?: 'payment_to_provider' | 'commission_from_provider';
+    account_id?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Response for `GET /admin/thor/dropshipper/settlements` */
+interface GetSettlementsResponse {
+    settlements: SettlementRecord[];
+    count: number;
+    offset: number;
+    limit: number;
+}
+/** Response for `GET /admin/thor/dropshipper/settlements/:id` */
+interface GetSettlementDetailResponse {
+    settlement: SettlementRecord;
+}
+/** Body for `POST /admin/thor/dropshipper/admin/settlements` (Solo X) */
+interface CreateSettlementBody {
+    account_id: string;
+    type: 'payment_to_provider' | 'commission_from_provider';
+    order_ids: string[];
+    amount: number;
+    notes?: string;
+}
+/** Response for `POST /admin/thor/dropshipper/admin/settlements` */
+interface CreateSettlementResponse {
+    settlement: SettlementRecord;
+}
+/** Body for `POST /admin/thor/dropshipper/admin/settlements/:id/confirm` */
+interface ConfirmSettlementBody {
+    notes?: string;
+}
+/** Body for `POST /admin/thor/dropshipper/admin/settlements/:id/cancel` */
+interface CancelSettlementBody {
+    reason?: string;
+}
+/** Response for confirm/cancel settlement */
+interface UpdateSettlementStatusResponse {
+    settlement: SettlementRecord;
+}
+/** Full account record with channel info as seen by X */
+interface AdminDropshipperAccount {
+    id: string;
+    provider_name: string;
+    provider_email?: string;
+    sales_channel_id: string;
+    sales_channel_name: string;
+    currency_code: string;
+    payment_terms_days: number;
+    created_at?: string;
+}
+/** Response for `GET /admin/thor/dropshipper/admin/accounts` */
+interface GetAdminDropshipperAccountsResponse {
+    accounts: AdminDropshipperAccount[];
+}
+/** Extended balance for admin view of a specific account */
+interface AdminDropshipperBalance extends DropshipperBalance {
+    payable_count: number;
+    payable_order_ids: string[];
+    payable_orders: DropshipperPayableOrder[];
+    receivable_count: number;
+    receivable_order_ids: string[];
+    receivable_orders: DropshipperReceivableOrder[];
+    unclassified_orders: number;
+}
+/** Response for `GET /admin/thor/dropshipper/admin/accounts/:id/balance` */
+interface GetAdminAccountBalanceResponse {
+    account: Pick<AdminDropshipperAccount, 'id' | 'provider_name' | 'currency_code' | 'payment_terms_days' | 'sales_channel_id'>;
+    balance: AdminDropshipperBalance;
+}
+/** Response for `GET /admin/thor/dropshipper/admin/price-lists` */
+interface GetAdminPriceListsResponse {
+    price_lists: Array<{
+        id: string;
+        sales_channel_id: string;
+        sales_channel_name: string;
+        provider_name: string;
+    }>;
+}
+/** Response for `GET /admin/thor/dropshipper/admin/user-channel` */
+interface GetUserChannelResponse {
+    links: Array<{
+        sales_channel_id: string;
+    }>;
+}
+/** A dropshipper promotion record */
+interface DropshipperPromotion {
+    id: string;
+    code: string;
+    /** Maps to application_method.type */
+    type: 'percentage' | 'fixed';
+    value: number;
+    status: 'active' | 'inactive' | string;
+    usage_limit: number | null;
+    usage_count: number;
+    starts_at: string | null;
+    ends_at: string | null;
+    target_type?: 'order' | 'items';
+    min_amount?: number | null;
+    currency_code?: string;
+}
+/** Options for `GET /admin/thor/dropshipper/promotions` */
+interface GetDropshipperPromotionsOptions {
+    type?: 'percentage' | 'fixed';
+    limit?: number;
+    offset?: number;
+}
+/** Response for `GET /admin/thor/dropshipper/promotions` */
+interface GetDropshipperPromotionsResponse {
+    promotions: DropshipperPromotion[];
+    count: number;
+    offset: number;
+    limit: number;
+}
+/** An additional targeting rule for a promotion */
+interface PromotionRule {
+    attribute: string;
+    operator: string;
+    values: string[];
+}
+/** Body for `POST /admin/thor/dropshipper/promotions` */
+interface CreateDropshipperPromotionBody {
+    code: string;
+    type: 'percentage' | 'fixed';
+    value: number;
+    currency_code?: string;
+    target_type?: 'order' | 'items';
+    allocation?: 'each' | 'across';
+    usage_limit?: number | null;
+    starts_at?: string | null;
+    ends_at?: string | null;
+    rules?: PromotionRule[];
+}
+/** Body for `PUT /admin/thor/dropshipper/promotions/:id` */
+interface UpdateDropshipperPromotionBody {
+    value?: number;
+    ends_at?: string | null;
+    usage_limit?: number | null;
+}
+/** Response for `DELETE /admin/thor/dropshipper/promotions/:id` */
+interface DeleteDropshipperPromotionResponse {
+    deleted: true;
+    id: string;
+}
+/** Options for `GET /admin/thor/dropshipper/dashboard/stats` */
+interface GetDashboardStatsOptions {
+    period?: '7d' | '30d' | '90d' | 'custom';
+    /** Required when period = "custom" */
+    from?: string;
+    /** Required when period = "custom" */
+    to?: string;
+    currency_code?: string;
+}
+/** Core period metrics */
+interface DashboardPeriodMetrics {
+    orders_count: number;
+    revenue_total: number;
+    profit_total: number;
+    avg_margin_percent: number;
+    avg_order_value: number;
+    customers_active?: number;
+    customers_new?: number;
+    currency_code: string;
+}
+/** Percentage changes vs. previous period */
+interface DashboardChanges {
+    orders_count_pct: number;
+    revenue_total_pct: number;
+    profit_total_pct: number;
+    avg_margin_percent_pct: number;
+}
+/** Top product row by profit */
+interface DashboardTopProduct {
+    product_id: string;
+    product_title: string;
+    variant_id: string;
+    variant_title: string;
+    units_sold: number;
+    revenue: number;
+    profit: number;
+    margin_percent: number;
+    thumbnail: string | null;
+}
+/** Full dashboard stats response */
+interface DashboardStats {
+    period: {
+        from: string;
+        to: string;
+        label: string;
+    };
+    current: DashboardPeriodMetrics;
+    previous: DashboardPeriodMetrics;
+    changes: DashboardChanges;
+    orders_by_status: Record<string, number>;
+    settlement_summary: DropshipperBalance & {
+        pending_settlement_records: number;
+        currency_code: string;
+    };
+    recent_orders: Array<{
+        id: string;
+        display_id: number;
+        customer_name: string;
+        total: number;
+        profit: number;
+        status: string;
+        created_at: string;
+    }>;
+    top_products_by_profit: DashboardTopProduct[];
+}
+/** Response for `GET /admin/thor/dropshipper/dashboard/stats` */
+interface GetDashboardStatsResponse {
+    stats?: DashboardStats;
+    [key: string]: unknown;
+}
+/** A note attached to an order */
+interface OrderNote {
+    id: string;
+    order_id: string;
+    author_id: string;
+    text: string;
+    created_at: string;
+}
+/** Body for `POST /admin/thor/dropshipper/orders/:id/notes` */
+interface CreateOrderNoteBody {
+    text: string;
+}
+/** Response for `GET /admin/thor/dropshipper/orders/:id/notes` */
+interface GetOrderNotesResponse {
+    notes: OrderNote[];
+}
+/** Response for `DELETE /admin/thor/dropshipper/orders/:id/notes/:note_id` */
+interface DeleteOrderNoteResponse {
+    id: string;
+    deleted: boolean;
+}
+/** Body for creating/updating a dropshipper address */
+interface DropshipperAddressBody {
+    first_name: string;
+    last_name: string;
+    company?: string;
+    address_1: string;
+    address_2?: string;
+    city: string;
+    province?: string;
+    postal_code: string;
+    country_code: string;
+    phone?: string;
+    is_default?: boolean;
+}
+/** Response for creating a dropshipper address */
+interface DropshipperAddressResponse {
+    address: Address & {
+        sales_channel_id: string;
+    };
+}
+/** Response for getting dropshipper addresses for a channel */
+interface GetDropshipperAddressesResponse {
+    addresses: Array<Address & {
+        sales_channel_id: string;
+    }>;
+}
+/** Response for `GET /store/thor/dropshipper-categories` */
+interface GetStorefrontDropshipperCategoriesResponse {
+    categories: DropshipperCategory[];
+}
+
+export { type AccountDropdownConfig, type AccountMenuItem, type ActiveFilter, type AddOrderEditItemBody, type AddOrderEditItemResponse, type Address, type AdminApiKey, type AdminChannelCategory, type AdminChannelCustomer, type AdminDropshipperAccount, type AdminDropshipperBalance, type AdminProduct, type AdminProductVariant, type AdminSalesChannelRef, type AdminSiteConfig, type AdminSiteConfigHistoryEntry, type AdminSiteConfigHistoryEntryFull, type AdminStorefrontConfig, type AdminStorefrontSeoDefaults, type AdminUser, type AdvancedSearchProductsOptions, type AssignCategoriesToChannelsBody, type AssignCategoriesToChannelsResponse, type AssignCollectionsToChannelsBody, type AssignCollectionsToChannelsResponse, type AuditLog, type AuditLogAdapter, type AuthConfig, type AuthMethod, type AuthProvider, type AuthResponse, type AuthStorage, type AuthorConfig, type BackendCapabilities, type BatchVariantCostItem, type BatchVariantCostsBody, type BatchVariantCostsResponse, type BrandConfig, type CachedPaymentMethods, type CancelDropshipperOrderResponse, type CancelSettlementBody, type Cart, type CartCost, type CartItem, type CartLineInput, type CartLineUpdate, type CartProduct, type ChartDataPoint, type Collection, type CollectionProductsOptions, type CommerceProvider, type CompareProduct, type ConfigHistoryEntry, type ConfirmOrderEditResponse, type ConfirmSettlementBody, type Connection, type Country, type CreateAddressData, type CreateCategoryMappingBody, type CreateCategoryMappingResponse, type CreateDropshipperCategoryBody, type CreateDropshipperCustomerBody, type CreateDropshipperCustomerResponse, type CreateDropshipperOrderBody, type CreateDropshipperOrderResponse, type CreateDropshipperPromotionBody, type CreateOrderEditBody, type CreateOrderEditResponse, type CreateOrderItem, type CreateOrderNoteBody, type CreateSettlementBody, type CreateSettlementResponse, type CreateVariantCostBody, type CreateVariantCostResponse, type Customer, type DashboardChanges, type DashboardConfig, type DashboardMetrics, type DashboardMetricsAdapter, type DashboardOrdersAdapter, type DashboardPeriodMetrics, type DashboardProductsAdapter, type DashboardStats, type DashboardTopProduct, type DeleteCategoryMappingResponse, type DeleteDropshipperCategoryResponse, type DeleteDropshipperPromotionResponse, type DeleteOrderNoteResponse, type DeleteVariantCostResponse, type DesignerConfig, type DesignerHistoryEntry, type DesignerNavItem, type DesignerThemeConfig, type DesignerThemePreset, type DiscountCode, type DropshipperAccount, type DropshipperAccountRef, type DropshipperAddressBody, type DropshipperAddressResponse, type DropshipperBalance, type DropshipperCategory, type DropshipperCustomer, type DropshipperCustomerDetail, type DropshipperCustomerOrderRef, type DropshipperCustomerStats, type DropshipperOrder, type DropshipperOrderCustomer, type DropshipperOrderDetail, type DropshipperOrderItem, type DropshipperOrderShippingAddress, type DropshipperOrderTimelineEvent, type DropshipperOrderTotals, type DropshipperPayableOrder, type DropshipperPendingOrders, type DropshipperPriceItem, type DropshipperProduct, type DropshipperPromotion, type DropshipperReceivableOrder, type DropshipperVariant, type DynamicSource, type Edge, type FilterConfig, type FilterOption, type FilterSection, type FulfillmentOption, type FulfillmentSet, type FulfillmentStatus, type GetAdminAccountBalanceResponse, type GetAdminDropshipperAccountsResponse, type GetAdminPriceListsResponse, type GetAdminSiteConfigHistoryOptions, type GetAdminSiteConfigHistoryResponse, type GetAdminSiteConfigResponse, type GetAdminStorefrontConfigResponse, type GetCategoriesCallback, type GetCategoriesOptions, type GetCategorySalesChannelsResponse, type GetChannelApiKeysResponse, type GetChannelCategoriesOptions, type GetChannelCategoriesResponse, type GetChannelCustomersOptions, type GetChannelCustomersResponse, type GetCollectionSalesChannelsResponse, type GetCollectionsOptions, type GetCustomersCallback, type GetCustomersOptions, type GetDashboardStatsOptions, type GetDashboardStatsResponse, type GetDropshipperAccountResponse, type GetDropshipperAddressesResponse, type GetDropshipperCategoriesOptions, type GetDropshipperCategoriesResponse, type GetDropshipperCustomerDetailResponse, type GetDropshipperCustomersOptions, type GetDropshipperCustomersResponse, type GetDropshipperOrderDetailResponse, type GetDropshipperOrdersOptions, type GetDropshipperOrdersResponse, type GetDropshipperPayableResponse, type GetDropshipperProductsOptions, type GetDropshipperProductsResponse, type GetDropshipperPromotionsOptions, type GetDropshipperPromotionsResponse, type GetDropshipperReceivableResponse, type GetOrderNotesResponse, type GetOrdersCallback, type GetOrdersOptions, type GetProductsOptions, type GetSettlementDetailResponse, type GetSettlementsOptions, type GetSettlementsResponse, type GetStorefrontDropshipperCategoriesResponse, type GetUserChannelResponse, type GetVariantCostsOptions, type GetVariantCostsResponse, type HeaderLinkItem, type HeaderNavigationConfig, type IconConfig, type Image, type InventoryLevel, type LinkCustomerToChannelResponse, type LoginCredentials, type ModulesConfig, type Money, type NavigationCalloutItem, type NavigationItem, type NavigationLinkItem, type OnboardDropshipperBody, type OnboardDropshipperResponse, type Order, type OrderItem, type OrderNote, type OrderStatus, type OrdersMetrics, PROVIDER_METADATA, type PaginationOptions, type PasswordResetConfirm, type PasswordResetRequest, type PaymentMethod, type PaymentMethodFeatures, type PaymentMethodType, type PaymentMethodsOptions, type PaymentStatus, type PriceRange, type Product, type ProductCategory, type ProductOption, type ProductPreview, type ProductVariant, type ProductsMetrics, type PromotionRule, type ProviderConfig, type ProviderTypeString, type Region, type RegisterData, type RestoreSiteConfigResponse, type Review, type SEO, type SalesMetrics, type SearchBarConfig, type SearchResultMeta, type SelectedOption, type SetPaymentCollectorBody, type SetPaymentCollectorResponse, type SettlementRecord, type ShippingMethod, type SiteConfig, type SiteConfigLabels, type SiteConfigMetadata, type SocialConfig, type SortOption, type SortOptions, type StockLocation, type StockStatus, type StockValidation, type StorefrontConfig, StorefrontConfigError, type StorefrontContext, type StorefrontPlatformType, type StorefrontSeoDefaults, SupportedProviderType, type UnassignCategoriesFromChannelsBody, type UnassignCategoriesFromChannelsResponse, type UnassignCollectionsFromChannelsBody, type UnassignCollectionsFromChannelsResponse, type UpdateCustomerData, type UpdateDropshipperCategoryBody, type UpdateDropshipperPricesBody, type UpdateDropshipperPricesResponse, type UpdateDropshipperPromotionBody, type UpdateSettlementStatusResponse, type UpdateSiteConfigBody, type UpdateSiteConfigResponse, type UpdateStorefrontConfigBody, type UpdateStorefrontConfigResponse, type VariantCost, getProviderMetadata, isSupportedProviderType };