@thorprovider/medusa-extended 1.8.0 → 1.9.0

package/dist/index.d.mts

@@ -0,0 +1,759 @@
+import { GetChannelCustomersOptions, GetChannelCustomersResponse, GetChannelApiKeysResponse, GetChannelCategoriesOptions, GetChannelCategoriesResponse, GetCategorySalesChannelsResponse, AssignCategoriesToChannelsBody, AssignCategoriesToChannelsResponse, UnassignCategoriesFromChannelsBody, UnassignCategoriesFromChannelsResponse, GetCollectionSalesChannelsResponse, AssignCollectionsToChannelsBody, AssignCollectionsToChannelsResponse, UnassignCollectionsFromChannelsBody, UnassignCollectionsFromChannelsResponse, GetAdminStorefrontConfigResponse, UpdateStorefrontConfigBody, UpdateStorefrontConfigResponse, GetAdminSiteConfigResponse, UpdateSiteConfigBody, UpdateSiteConfigResponse, GetAdminSiteConfigHistoryOptions, GetAdminSiteConfigHistoryResponse, RestoreSiteConfigResponse, DropshipperDashboardCapabilities, GetMyProfileResponse, GetNotificationsOptions, GetNotificationsResponse, OnboardDropshipperBody, OnboardDropshipperResponse, GetVariantCostsOptions, GetVariantCostsResponse, CreateVariantCostBody, CreateVariantCostResponse, BatchVariantCostsBody, BatchVariantCostsResponse, DeleteVariantCostResponse, GetDropshipperProductsOptions, GetDropshipperProductsResponse, ValidateCheckoutItemsRequest, ValidateCheckoutItemsResponse, CostPriceChangesCheckResponse, CostPriceChangesResponse, AcknowledgeCostPriceChangesResponse, UpdateDropshipperProductStatusBody, UpdateDropshipperProductStatusResponse, GetProductAttributesResponse, GetDropshipperAttributesResponse, UpdateDropshipperPricesBody, UpdateDropshipperPricesResponse, GetDropshipperOrdersOptions, GetDropshipperOrdersResponse, GetDropshipperOrderDetailResponse, GetDropshipperShippingOptionsParams, GetDropshipperShippingOptionsResponse, ExtendedCreateDropshipperOrderBody, ExtendedCreateDropshipperOrderResponse, SetPaymentCollectorBody, SetPaymentCollectorResponse, SetPaymentMethodBody, SetPaymentMethodResponse, CancelDropshipperOrderResponse, CreateOrderEditBody, CreateOrderEditResponse, AddOrderEditItemBody, AddOrderEditItemResponse, ConfirmOrderEditResponse, GetOrderNotesResponse, CreateOrderNoteBody, CreateOrderNoteResponse, DeleteOrderNoteResponse, GetProviderCategoriesResponse, GetDropshipperCategoriesOptions, GetDropshipperCategoriesResponse, CreateDropshipperCategoryBody, DropshipperCategory, UpdateDropshipperCategoryBody, DeleteDropshipperCategoryResponse, GetCategoryMappingsOptions, GetCategoryMappingsResponse, CreateCategoryMappingBody, CreateCategoryMappingResponse, DeleteCategoryMappingResponse, GetDropshipperCustomersOptions, GetDropshipperCustomersResponse, GetDropshipperCustomerDetailResponse, CreateDropshipperCustomerBody, CreateDropshipperCustomerResponse, UpdateDropshipperCustomerBody, UpdateDropshipperCustomerResponse, GetDropshipperAddressesResponse, DropshipperAddressBody, DropshipperAddressResponse, GetDropshipperAccountResponse, GetDropshipperPayableResponse, GetDropshipperReceivableResponse, GetSettlementsOptions, GetSettlementsResponse, GetSettlementDetailResponse, GetDropshipperAccountBalanceResponse, GetDropshipperAccountOrdersOptions, GetDropshipperAccountOrdersResponse, CreateSettlementBody, CreateSettlementResponse, ConfirmSettlementBody, UpdateSettlementStatusResponse, CancelSettlementBody, GetAdminDropshipperAccountsResponse, GetAdminAccountBalanceResponse, GetAdminPriceListsResponse, GetUserChannelResponse, GetAdminDropshipperAccountOrdersResponse, GetAdminDropshipperAccountSettlementsOptions, GetAdminDropshipperAccountSettlementsResponse, ResolveGuaranteeBody, ResolveGuaranteeResponse, CreateCompensacionBody, CreateCompensacionResponse, CreateAjusteBody, CreateAjusteResponse, CreateCobroBody, CreateCobroResponse, CreatePagoBody, CreatePagoResponse, CreateReversoBody, CreateReversoResponse, ConfirmMovementBody, ConfirmMovementResponse, CancelMovementBody, CancelMovementResponse, GetFinancialAnalysisResponse, RegisterPaymentBody, RegisterPaymentResponse, GetDropshipperPromotionsOptions, GetDropshipperPromotionsResponse, CreateDropshipperPromotionBody, DropshipperPromotion, UpdateDropshipperPromotionBody, DeleteDropshipperPromotionResponse, GetDashboardStatsOptions, GetDashboardStatsResponse, GetStorefrontDropshipperCategoriesResponse, GetDropshipperDraftOrdersOptions, GetDropshipperDraftOrdersResponse, GetDropshipperDraftOrderDetailResponse, CreateDropshipperDraftOrderBody, CreateDropshipperDraftOrderResponse, UpdateDropshipperDraftOrderBody, UpdateDropshipperDraftOrderResponse, ConvertDropshipperDraftOrderBody, ConvertDropshipperDraftOrderResponse, GetGeoCountriesResponse, GetGeoProvincesResponse, GetGeoCitiesResponse } from '@thorprovider/types';
+
+/**
+ * @fileoverview Medusa Multi-Tenant Admin Client
+ * @module @thorprovider/adapters/providers/medusa/admin
+ *
+ * Wrapper methods for all `/admin/thor/` endpoints defined in the Thor Commerce
+ * multi-tenant API contract.  Requires an admin API key (`adminConfig.apiKey`)
+ * to be provided when creating the Medusa provider.
+ *
+ * Every method performs a raw `fetch` against the Medusa backend using the
+ * admin API key (`x-medusa-access-token`) — the Medusa JS-SDK's admin client
+ * does not expose these custom Thor plugin routes, so we use direct HTTP calls.
+ *
+ * Endpoint reference: `multitenant-api-contract.md`
+ */
+
+/**
+ * Configuration required to instantiate the admin client.
+ */
+interface MedusaAdminClientConfig {
+    /** Medusa backend base URL */
+    baseUrl: string;
+    /** Secret admin API key (x-medusa-access-token) */
+    apiKey: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * HTTP client for Thor Commerce multi-tenant admin endpoints (`/admin/thor/`).
+ *
+ * All methods throw `ProviderAPIError` on non-2xx responses.
+ *
+ * @example
+ * ```typescript
+ * const admin = new MedusaAdminClient({
+ *   baseUrl: process.env.MEDUSA_BACKEND_URL!,
+ *   apiKey: process.env.MEDUSA_ADMIN_API_KEY!,
+ * });
+ *
+ * const { customers } = await admin.getChannelCustomers('sc_01JXXXXX');
+ * ```
+ */
+declare class MedusaAdminClient {
+    private baseUrl;
+    private apiKey;
+    private logger;
+    constructor(config: MedusaAdminClientConfig);
+    private request;
+    /**
+     * Paginated list of customers linked to a sales channel.
+     *
+     * `GET /admin/thor/sales-channels/:id/customers`
+     */
+    getChannelCustomers(salesChannelId: string, options?: GetChannelCustomersOptions): Promise<GetChannelCustomersResponse>;
+    /**
+     * Publishable API keys associated with a sales channel.
+     *
+     * `GET /admin/thor/sales-channels/:id/api-keys`
+     */
+    getChannelApiKeys(salesChannelId: string): Promise<GetChannelApiKeysResponse>;
+    /**
+     * Product categories assigned to a sales channel.
+     *
+     * `GET /admin/thor/sales-channels/:id/categories`
+     */
+    getChannelCategories(salesChannelId: string, options?: GetChannelCategoriesOptions): Promise<GetChannelCategoriesResponse>;
+    /**
+     * Sales channels to which a category is assigned.
+     *
+     * `GET /admin/thor/categories/:id/sales-channels`
+     */
+    getCategorySalesChannels(categoryId: string): Promise<GetCategorySalesChannelsResponse>;
+    /**
+     * Assign a category to one or more sales channels (idempotent).
+     *
+     * `POST /admin/thor/categories/:id/sales-channels`
+     */
+    assignCategoryToChannels(categoryId: string, body: AssignCategoriesToChannelsBody): Promise<AssignCategoriesToChannelsResponse>;
+    /**
+     * Remove category assignment from one or more sales channels (idempotent).
+     *
+     * `DELETE /admin/thor/categories/:id/sales-channels`
+     */
+    unassignCategoryFromChannels(categoryId: string, body: UnassignCategoriesFromChannelsBody): Promise<UnassignCategoriesFromChannelsResponse>;
+    /**
+     * Sales channels to which a collection is assigned.
+     *
+     * `GET /admin/thor/collections/:id/sales-channels`
+     */
+    getCollectionSalesChannels(collectionId: string): Promise<GetCollectionSalesChannelsResponse>;
+    /**
+     * Assign a collection to one or more sales channels (idempotent).
+     *
+     * `POST /admin/thor/collections/:id/sales-channels`
+     */
+    assignCollectionToChannels(collectionId: string, body: AssignCollectionsToChannelsBody): Promise<AssignCollectionsToChannelsResponse>;
+    /**
+     * Remove collection assignment from one or more sales channels (idempotent).
+     *
+     * `DELETE /admin/thor/collections/:id/sales-channels`
+     */
+    unassignCollectionFromChannels(collectionId: string, body: UnassignCollectionsFromChannelsBody): Promise<UnassignCollectionsFromChannelsResponse>;
+    /**
+     * Read the visual storefront configuration for a channel.
+     * `:id` is the `sales_channel_id`.
+     *
+     * `GET /admin/thor/storefront-config/:id`
+     */
+    getStorefrontConfig(salesChannelId: string): Promise<GetAdminStorefrontConfigResponse>;
+    /**
+     * Update the visual storefront configuration for a channel.
+     * Triggers the `storefront_config.updated` event → ISR webhook.
+     *
+     * `PUT /admin/thor/storefront-config/:id`
+     */
+    updateStorefrontConfig(salesChannelId: string, body: UpdateStorefrontConfigBody): Promise<UpdateStorefrontConfigResponse>;
+    /**
+     * Read the active Site Designer configuration for a channel, including the
+     * last 10 history entries.
+     *
+     * `GET /admin/thor/site-config/:sales_channel_id`
+     */
+    getSiteConfig(salesChannelId: string): Promise<GetAdminSiteConfigResponse>;
+    /**
+     * Update the Site Designer configuration for a channel.
+     * Creates a new history entry on every PUT.
+     *
+     * `PUT /admin/thor/site-config/:sales_channel_id`
+     */
+    updateSiteConfig(salesChannelId: string, body: UpdateSiteConfigBody): Promise<UpdateSiteConfigResponse>;
+    /**
+     * Full paginated history of Site Designer versions for a channel.
+     * Entries are immutable — they are never deleted.
+     *
+     * `GET /admin/thor/site-config/:sales_channel_id/history`
+     */
+    getSiteConfigHistory(salesChannelId: string, options?: GetAdminSiteConfigHistoryOptions): Promise<GetAdminSiteConfigHistoryResponse>;
+    /**
+     * Restore a previous Site Designer version.
+     * Internally runs the update workflow with the stored config of the target
+     * version — this creates a **new** history entry and does NOT mutate past
+     * entries.
+     *
+     * `POST /admin/thor/site-config/:sales_channel_id/restore/:version`
+     */
+    restoreSiteConfig(salesChannelId: string, version: string): Promise<RestoreSiteConfigResponse>;
+}
+
+/**
+ * @fileoverview Dropshipper Client — Thor Commerce Extended
+ * @module @thorprovider/medusa-extended/dropshipper
+ *
+ * HTTP client for all `/admin/thor/dropshipper/` endpoints.
+ *
+ * Used by both:
+ *   - X (ThorProvider admin) — authenticated via admin JWT, role "Admin"
+ *   - Y (Dropshipper panel) — authenticated via dropshipper JWT, role "Dropshipper"
+ *
+ * Access control is enforced server-side via `withDropshipperScope` middleware.
+ * This client always sends `Authorization: Bearer <token>`.
+ *
+ * Endpoint reference: `dropshipping-api-contract.md`
+ */
+
+/**
+ * Configuration required to instantiate the dropshipper client.
+ */
+interface DropshipperClientConfig {
+    /** Medusa backend base URL */
+    baseUrl: string;
+    /**
+     * JWT token obtained from `POST /auth/user/emailpass`.
+     * Used as `Authorization: Bearer <token>`.
+     */
+    token: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * HTTP client for Thor Commerce dropshipping endpoints (`/admin/thor/dropshipper/`).
+ *
+ * All methods throw `ProviderAPIError` on non-2xx responses.
+ *
+ * @example
+ * ```typescript
+ * const client = new DropshipperClient({
+ *   baseUrl: process.env.MEDUSA_BACKEND_URL!,
+ *   token: jwtFromLogin,
+ * });
+ *
+ * // Y: list own products
+ * const { products } = await client.getProducts();
+ *
+ * // X: onboard a new dropshipper
+ * const { dropshipper } = await client.onboardDropshipper({ ... });
+ * ```
+ */
+declare class DropshipperClient {
+    private baseUrl;
+    private token;
+    private logger;
+    constructor(config: DropshipperClientConfig);
+    private request;
+    /**
+     * Fetch dashboard capabilities from the backend.
+     *
+     * `GET /admin/thor/dropshipper/capabilities`
+     */
+    getCapabilities(): Promise<DropshipperDashboardCapabilities>;
+    /**
+     * Fetch the authenticated dropshipper's personal profile including
+     * first_name, last_name, email, avatar_url, and linked sales channel.
+     *
+     * `GET /admin/thor/dropshipper/me`
+     */
+    getMyProfile(): Promise<GetMyProfileResponse>;
+    /**
+     * List feed notifications for the authenticated dropshipper.
+     *
+     * `GET /admin/thor/dropshipper/notifications`
+     */
+    getNotifications(options?: GetNotificationsOptions): Promise<GetNotificationsResponse>;
+    /**
+     * Create a new dropshipper account (sales channel + user + price list).
+     *
+     * `POST /admin/thor/dropshipper/onboard`
+     */
+    onboardDropshipper(body: OnboardDropshipperBody): Promise<OnboardDropshipperResponse>;
+    /**
+     * List variant cost records, optionally filtered by account/variant/currency.
+     *
+     * `GET /admin/thor/dropshipper/variant-costs`
+     */
+    getVariantCosts(options?: GetVariantCostsOptions): Promise<GetVariantCostsResponse>;
+    /**
+     * Upsert a single variant cost record.
+     *
+     * `POST /admin/thor/dropshipper/variant-costs`
+     */
+    createVariantCost(body: CreateVariantCostBody): Promise<CreateVariantCostResponse>;
+    /**
+     * Batch-upsert variant costs for a given account and currency.
+     *
+     * `POST /admin/thor/dropshipper/variant-costs/batch`
+     */
+    batchVariantCosts(body: BatchVariantCostsBody): Promise<BatchVariantCostsResponse>;
+    /**
+     * Delete a variant cost record by ID.
+     *
+     * `DELETE /admin/thor/dropshipper/variant-costs/:id`
+     */
+    deleteVariantCost(id: string): Promise<DeleteVariantCostResponse>;
+    /**
+     * List products available in Y's channel with cost/margin data.
+     *
+     * `GET /admin/thor/dropshipper/products`
+     */
+    getProducts(options?: GetDropshipperProductsOptions): Promise<GetDropshipperProductsResponse>;
+    /**
+     * Validate cart items for checkout — returns current stock_quantity, sale_price,
+     * and cost_price for each variant so the client can detect stale prices or
+     * insufficient stock before creating an order or converting a draft.
+     *
+     * `POST /admin/thor/dropshipper/checkout/validate`
+     */
+    validateCheckoutItems(body: ValidateCheckoutItemsRequest): Promise<ValidateCheckoutItemsResponse>;
+    /**
+     * Check whether cost prices have changed since the last acknowledgment.
+     * Compares a hash of all base cost prices from the channel's price list
+     * against a stored snapshot on the dropshipper account.
+     *
+     * `GET /admin/thor/dropshipper/cost-prices/has-changes`
+     */
+    checkCostPriceChanges(): Promise<CostPriceChangesCheckResponse>;
+    /**
+     * Get the full diff of cost price changes since the last acknowledgment.
+     * Returns product/variant info with old and new cost prices.
+     *
+     * `GET /admin/thor/dropshipper/cost-prices/changes`
+     */
+    getCostPriceChanges(): Promise<CostPriceChangesResponse>;
+    /**
+     * Acknowledge current cost prices as reviewed. Stores the current hash
+     * and snapshot so subsequent checks will not report these prices as changed.
+     *
+     * `POST /admin/thor/dropshipper/cost-prices/acknowledge`
+     */
+    acknowledgeCostPriceChanges(): Promise<AcknowledgeCostPriceChangesResponse>;
+    /**
+     * Toggle whether a product is visible in the public store for the current sales channel.
+     * This does not mutate the shared global Medusa product status.
+     *
+     * `POST /admin/thor/dropshipper/products/:id/status`
+     */
+    updateProductStatus(productId: string, body: UpdateDropshipperProductStatusBody): Promise<UpdateDropshipperProductStatusResponse>;
+    /**
+     * Fetch custom attribute values assigned to a product, grouped by attribute.
+     *
+     * `GET /admin/thor/dropshipper/products/:id/attributes`
+     */
+    getProductAttributes(productId: string): Promise<GetProductAttributesResponse>;
+    /**
+     * List attribute definitions (with their possible values) scoped to the
+     * dropshipper's channel. Only attributes linked to at least one channel
+     * product are returned.
+     *
+     * `GET /admin/thor/dropshipper/attributes`
+     */
+    getAttributes(): Promise<GetDropshipperAttributesResponse>;
+    /**
+     * Bulk-update product and variant margins on Y's channel price list.
+     *
+     * `PUT /admin/thor/dropshipper/prices`
+     */
+    updatePrices(body: UpdateDropshipperPricesBody): Promise<UpdateDropshipperPricesResponse>;
+    /**
+     * Paginated list of orders in Y's channel.
+     *
+     * `GET /admin/thor/dropshipper/orders`
+     */
+    getOrders(options?: GetDropshipperOrdersOptions): Promise<GetDropshipperOrdersResponse>;
+    /**
+     * Full detail for a single order with profit breakdown.
+     *
+     * `GET /admin/thor/dropshipper/orders/:id`
+     */
+    getOrder(orderId: string): Promise<GetDropshipperOrderDetailResponse>;
+    /**
+     * List shipping options for a manual dropshipper order.
+     *
+     * `GET /admin/thor/dropshipper/orders/shipping-options`
+     */
+    getOrderShippingOptions(params: GetDropshipperShippingOptionsParams): Promise<GetDropshipperShippingOptionsResponse>;
+    /**
+     * Manually create an order on behalf of a customer.
+     *
+     * `POST /admin/thor/dropshipper/orders`
+     */
+    createOrder(body: ExtendedCreateDropshipperOrderBody): Promise<ExtendedCreateDropshipperOrderResponse>;
+    /**
+     * Set who collects payment for an order (Solo X).
+     *
+     * `POST /admin/thor/dropshipper/orders/:id/set-payment-collector`
+     */
+    setPaymentCollector(orderId: string, body: SetPaymentCollectorBody): Promise<SetPaymentCollectorResponse>;
+    /**
+     * Change the payment method of a confirmed order.
+     *
+     * `POST /admin/thor/dropshipper/orders/:id/set-payment-method`
+     */
+    setPaymentMethod(orderId: string, body: SetPaymentMethodBody): Promise<SetPaymentMethodResponse>;
+    /**
+     * Cancel a dropshipper order.
+     *
+     * `POST /admin/thor/dropshipper/orders/:id/cancel`
+     */
+    cancelOrder(orderId: string): Promise<CancelDropshipperOrderResponse>;
+    /**
+     * Create an order edit for a dropshipper order.
+     *
+     * `POST /admin/thor/dropshipper/orders/:id/edit`
+     */
+    createOrderEdit(orderId: string, body?: CreateOrderEditBody): Promise<CreateOrderEditResponse>;
+    /**
+     * Add an item to the active order edit.
+     *
+     * `POST /admin/thor/dropshipper/orders/:id/edit/items`
+     */
+    addOrderEditItem(orderId: string, body: AddOrderEditItemBody): Promise<AddOrderEditItemResponse>;
+    /**
+     * Confirm the active order edit, applying changes to the order.
+     *
+     * `POST /admin/thor/dropshipper/orders/:id/edit/confirm`
+     */
+    confirmOrderEdit(orderId: string): Promise<ConfirmOrderEditResponse>;
+    /**
+      * Get all notes for an order.
+   *
+   * `GET /admin/thor/dropshipper/orders/:id/notes`
+   */
+    getOrderNotes(orderId: string): Promise<GetOrderNotesResponse>;
+    /**
+     * Create a new note for an order.
+     *
+     * `POST /admin/thor/dropshipper/orders/:id/notes`
+     */
+    createOrderNote(orderId: string, body: CreateOrderNoteBody): Promise<CreateOrderNoteResponse>;
+    /**
+     * Delete a note from an order.
+     *
+     * `DELETE /admin/thor/dropshipper/orders/:id/notes/:noteId`
+     */
+    deleteOrderNote(orderId: string, noteId: string): Promise<DeleteOrderNoteResponse>;
+    /**
+     * List Medusa provider categories linked to Y's channel (read-only).
+     *
+     * `GET /admin/thor/dropshipper/categories/provider`
+     */
+    getProviderCategories(): Promise<GetProviderCategoriesResponse>;
+    /**
+     * List Y's custom product categories.
+     *
+     * `GET /admin/thor/dropshipper/categories`
+     */
+    getCategories(options?: GetDropshipperCategoriesOptions): Promise<GetDropshipperCategoriesResponse>;
+    /**
+     * Create a custom category in Y's channel.
+     *
+     * `POST /admin/thor/dropshipper/categories`
+     */
+    createCategory(body: CreateDropshipperCategoryBody): Promise<DropshipperCategory>;
+    /**
+     * Update a custom category.
+     *
+     * `PUT /admin/thor/dropshipper/categories/:id`
+     */
+    updateCategory(categoryId: string, body: UpdateDropshipperCategoryBody): Promise<DropshipperCategory>;
+    /**
+     * Delete a custom category.
+     *
+     * `DELETE /admin/thor/dropshipper/categories/:id`
+     */
+    deleteCategory(categoryId: string, options?: {
+        force?: boolean;
+    }): Promise<DeleteDropshipperCategoryResponse>;
+    /**
+     * List product-to-category mappings, optionally filtered by product.
+     *
+     * `GET /admin/thor/dropshipper/category-mappings`
+     */
+    getCategoryMappings(options?: GetCategoryMappingsOptions): Promise<GetCategoryMappingsResponse>;
+    /**
+     * Map a product to a custom category.
+     *
+     * `POST /admin/thor/dropshipper/category-mappings`
+     */
+    createCategoryMapping(body: CreateCategoryMappingBody): Promise<CreateCategoryMappingResponse>;
+    /**
+     * Remove a product-to-category mapping.
+     *
+     * `DELETE /admin/thor/dropshipper/category-mappings/:id`
+     */
+    deleteCategoryMapping(mappingId: string): Promise<DeleteCategoryMappingResponse>;
+    /**
+     * Paginated list of customers in Y's channel.
+     *
+     * `GET /admin/thor/dropshipper/customers`
+     */
+    getCustomers(options?: GetDropshipperCustomersOptions): Promise<GetDropshipperCustomersResponse>;
+    /**
+     * Backwards-compatible alias used by the dashboard checkout flow.
+     */
+    getChannelCustomers(_channelId: string, options?: GetDropshipperCustomersOptions): Promise<GetDropshipperCustomersResponse>;
+    /**
+     * Full detail for a single customer.
+     *
+     * `GET /admin/thor/dropshipper/customers/:id`
+     */
+    getCustomer(customerId: string): Promise<GetDropshipperCustomerDetailResponse>;
+    /**
+     * Create a customer scoped to Y's channel.
+     *
+     * `POST /admin/thor/dropshipper/customers`
+     */
+    createCustomer(body: CreateDropshipperCustomerBody): Promise<CreateDropshipperCustomerResponse>;
+    /**
+     * Update a customer scoped to Y's channel.
+     *
+     * `POST /admin/thor/dropshipper/customers/:id`
+     */
+    updateCustomer(customerId: string, body: UpdateDropshipperCustomerBody): Promise<UpdateDropshipperCustomerResponse>;
+    /**
+     * Transform a raw snake_case address from the API into a camelCase Address.
+     */
+    private transformAddress;
+    /**
+     * List addresses for a customer in Y's channel.
+     *
+     * `GET /admin/thor/dropshipper/customers/:id/addresses`
+     */
+    getCustomerAddresses(customerId: string): Promise<GetDropshipperAddressesResponse>;
+    /**
+     * Create a new address for a customer.
+     *
+     * `POST /admin/thor/dropshipper/customers/:id/addresses`
+     */
+    createCustomerAddress(customerId: string, body: DropshipperAddressBody): Promise<DropshipperAddressResponse>;
+    /**
+     * Update an existing customer address.
+     *
+     * `POST /admin/thor/dropshipper/customers/:id/addresses/:addressId`
+     */
+    updateCustomerAddress(customerId: string, addressId: string, body: Partial<DropshipperAddressBody>): Promise<DropshipperAddressResponse>;
+    /**
+     * Delete a customer address.
+     *
+     * `DELETE /admin/thor/dropshipper/customers/:id/addresses/:addressId`
+     */
+    deleteCustomerAddress(customerId: string, addressId: string): Promise<{
+        deleted: true;
+        id: string;
+    }>;
+    /**
+     * Y's account info with current balance.
+     *
+     * `GET /admin/thor/dropshipper/account`
+     */
+    getAccount(): Promise<GetDropshipperAccountResponse>;
+    /**
+     * Orders where Y owes money to X (Y collected payment, needs to pay costs).
+     *
+     * `GET /admin/thor/dropshipper/account/payable`
+     */
+    getPayable(): Promise<GetDropshipperPayableResponse>;
+    /**
+     * Orders where X owes money to Y (X collected COD, needs to transfer profit).
+     *
+     * `GET /admin/thor/dropshipper/account/receivable`
+     */
+    getReceivable(): Promise<GetDropshipperReceivableResponse>;
+    /**
+     * List settlements (Y sees own; X can filter by account_id).
+     *
+     * `GET /admin/thor/dropshipper/settlements`
+     */
+    getSettlements(options?: GetSettlementsOptions): Promise<GetSettlementsResponse>;
+    /**
+     * Full detail for a single settlement record.
+     *
+     * `GET /admin/thor/dropshipper/settlements/:id`
+     */
+    getSettlement(settlementId: string): Promise<GetSettlementDetailResponse>;
+    /**
+     * Consolidated financial balance for the authenticated dropshipper.
+     *
+     * `GET /admin/thor/dropshipper/account/balance`
+     */
+    getAccountBalance(): Promise<GetDropshipperAccountBalanceResponse>;
+    /**
+     * Unified financial order list for the authenticated dropshipper.
+     *
+     * `GET /admin/thor/dropshipper/account/orders`
+     */
+    getAccountOrders(options?: GetDropshipperAccountOrdersOptions): Promise<GetDropshipperAccountOrdersResponse>;
+    /**
+     * Create a settlement record for a dropshipper account.
+     *
+     * `POST /admin/thor/dropshipper/admin/settlements`
+     */
+    createSettlement(body: CreateSettlementBody): Promise<CreateSettlementResponse>;
+    /**
+     * Confirm a pending settlement (marks it as paid/received).
+     *
+     * `POST /admin/thor/dropshipper/admin/settlements/:id/confirm`
+     */
+    confirmSettlement(settlementId: string, body?: ConfirmSettlementBody): Promise<UpdateSettlementStatusResponse>;
+    /**
+     * Cancel a pending settlement.
+     *
+     * `POST /admin/thor/dropshipper/admin/settlements/:id/cancel`
+     */
+    cancelSettlement(settlementId: string, body?: CancelSettlementBody): Promise<UpdateSettlementStatusResponse>;
+    /**
+     * X views all settlement records across all dropshipper accounts.
+     *
+     * `GET /admin/thor/dropshipper/admin/settlements`
+     */
+    getAdminSettlements(options?: GetSettlementsOptions): Promise<GetSettlementsResponse>;
+    /**
+     * List all dropshipper accounts.
+     *
+     * `GET /admin/thor/dropshipper/admin/accounts`
+     */
+    getAdminAccounts(): Promise<GetAdminDropshipperAccountsResponse>;
+    /**
+     * Full balance detail for a specific dropshipper account.
+     *
+     * `GET /admin/thor/dropshipper/admin/accounts/:id/balance`
+     */
+    getAdminAccountBalance(accountId: string): Promise<GetAdminAccountBalanceResponse>;
+    /**
+     * List all dropshipper price lists.
+     *
+     * `GET /admin/thor/dropshipper/admin/price-lists`
+     */
+    getAdminPriceLists(): Promise<GetAdminPriceListsResponse>;
+    /**
+     * Utility: look up which sales channel a user belongs to.
+     *
+     * `GET /admin/thor/dropshipper/admin/user-channel`
+     */
+    getUserChannel(): Promise<GetUserChannelResponse>;
+    /**
+     * List orders with financial detail for a dropshipper account (Admin only).
+     *
+     * `GET /admin/thor/dropshipper/admin/accounts/:id/orders`
+     */
+    getAdminAccountOrders(accountId: string, options?: GetDropshipperAccountOrdersOptions): Promise<GetAdminDropshipperAccountOrdersResponse>;
+    /**
+     * List financial movements for a dropshipper account (Admin only).
+     *
+     * `GET /admin/thor/dropshipper/admin/accounts/:id/settlements`
+     */
+    getAdminAccountSettlements(accountId: string, options?: GetAdminDropshipperAccountSettlementsOptions): Promise<GetAdminDropshipperAccountSettlementsResponse>;
+    /**
+     * Manually resolve a guarantee on an order (Admin only).
+     *
+     * `POST /admin/thor/dropshipper/admin/accounts/:id/guarantee/:order_id`
+     */
+    resolveGuarantee(accountId: string, orderId: string, body: ResolveGuaranteeBody): Promise<ResolveGuaranteeResponse>;
+    /**
+     * Create an internal compensation (netting) between DS and Thor debts (Admin only).
+     *
+     * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/compensacion`
+     */
+    createCompensacion(accountId: string, body: CreateCompensacionBody): Promise<CreateCompensacionResponse>;
+    /**
+     * Create a financial adjustment (Admin only).
+     *
+     * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/ajuste`
+     */
+    createAjuste(accountId: string, body: CreateAjusteBody): Promise<CreateAjusteResponse>;
+    /**
+     * Register a cobro — DS pays Thor the product cost (Admin only).
+     *
+     * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/cobro`
+     */
+    createCobro(accountId: string, body: CreateCobroBody): Promise<CreateCobroResponse>;
+    /**
+     * Register a pago — Thor pays the dropshipper their commission (Admin only).
+     *
+     * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/pago`
+     */
+    createPago(accountId: string, body: CreatePagoBody): Promise<CreatePagoResponse>;
+    /**
+     * Reverse a confirmed financial movement (Admin only).
+     *
+     * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/:mov_id/reverso`
+     */
+    reverseSettlement(accountId: string, movementId: string, body: CreateReversoBody): Promise<CreateReversoResponse>;
+    /**
+     * Confirm a pending financial movement (Admin only).
+     *
+     * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/:mov_id/confirm`
+     */
+    confirmSettlementMovement(accountId: string, movementId: string, body?: ConfirmMovementBody): Promise<ConfirmMovementResponse>;
+    /**
+     * Cancel a pending financial movement draft (Admin only).
+     *
+     * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/:mov_id/cancel`
+     */
+    cancelSettlementMovement(accountId: string, movementId: string, body: CancelMovementBody): Promise<CancelMovementResponse>;
+    /**
+     * Get financial analysis for a dropshipper order (Admin only).
+     *
+     * `GET /admin/thor/dropshipper/admin/orders/:id/financial-analysis`
+     */
+    getOrderFinancialAnalysis(orderId: string): Promise<GetFinancialAnalysisResponse>;
+    /**
+     * Register a partial or full payment for an order.
+     *
+     * `POST /admin/thor/dropshipper/orders/:id/payment`
+     */
+    registerOrderPayment(orderId: string, body: RegisterPaymentBody): Promise<RegisterPaymentResponse>;
+    /**
+     * List Y's promotions (discount codes).
+     *
+     * `GET /admin/thor/dropshipper/promotions`
+     */
+    getPromotions(options?: GetDropshipperPromotionsOptions): Promise<GetDropshipperPromotionsResponse>;
+    /**
+     * Create a promotion for Y's channel.
+     *
+     * `POST /admin/thor/dropshipper/promotions`
+     */
+    createPromotion(body: CreateDropshipperPromotionBody): Promise<DropshipperPromotion>;
+    /**
+     * Get a single promotion by ID.
+     *
+     * `GET /admin/thor/dropshipper/promotions/:id`
+     */
+    getPromotion(promotionId: string): Promise<DropshipperPromotion>;
+    /**
+     * Update an existing promotion.
+     *
+     * `PUT /admin/thor/dropshipper/promotions/:id`
+     */
+    updatePromotion(promotionId: string, body: UpdateDropshipperPromotionBody): Promise<DropshipperPromotion>;
+    /**
+     * Delete a promotion.
+     *
+     * `DELETE /admin/thor/dropshipper/promotions/:id`
+     */
+    deletePromotion(promotionId: string): Promise<DeleteDropshipperPromotionResponse>;
+    /**
+     * Aggregate stats for Y's dashboard (revenue, profit, top products).
+     *
+     * `GET /admin/thor/dropshipper/dashboard/stats`
+     */
+    getDashboardStats(options?: GetDashboardStatsOptions): Promise<GetDashboardStatsResponse>;
+    /**
+     * Public endpoint: dropshipper-scoped categories for the storefront.
+     * Typically called with a publishable API key rather than a JWT.
+     *
+     * `GET /store/thor/dropshipper-categories`
+     */
+    getStorefrontCategories(): Promise<GetStorefrontDropshipperCategoriesResponse>;
+    /**
+     * List all draft orders in the dropshipper's channel.
+     *
+     * `GET /admin/thor/dropshipper/draft-orders`
+     */
+    getDraftOrders(options?: GetDropshipperDraftOrdersOptions): Promise<GetDropshipperDraftOrdersResponse>;
+    /**
+     * Get a specific draft order by ID.
+     *
+     * `GET /admin/thor/dropshipper/draft-orders/:id`
+     */
+    getDraftOrder(draftOrderId: string): Promise<GetDropshipperDraftOrderDetailResponse>;
+    /**
+     * Create a new draft order.
+     *
+     * `POST /admin/thor/dropshipper/draft-orders`
+     */
+    createDraftOrder(body: CreateDropshipperDraftOrderBody): Promise<CreateDropshipperDraftOrderResponse>;
+    /**
+     * Update a draft order.
+     *
+     * `POST /admin/thor/dropshipper/draft-orders/:id`
+     */
+    updateDraftOrder(draftOrderId: string, body: UpdateDropshipperDraftOrderBody): Promise<UpdateDropshipperDraftOrderResponse>;
+    /**
+     * Convert a draft order to a real order.
+     *
+     * `POST /admin/thor/dropshipper/draft-orders/:id/convert`
+     */
+    convertDraftOrder(draftOrderId: string, body: ConvertDropshipperDraftOrderBody): Promise<ConvertDropshipperDraftOrderResponse>;
+    /**
+     * List all geo-reference countries.
+     *
+     * `GET /admin/geo-reference`
+     */
+    getGeoCountries(): Promise<GetGeoCountriesResponse>;
+    /**
+     * List provinces/states for a country.
+     *
+     * `GET /admin/geo-reference/countries/:iso_2/provinces`
+     */
+    getGeoProvinces(iso2: string): Promise<GetGeoProvincesResponse>;
+    /**
+     * List cities for a province/state.
+     *
+     * `GET /admin/geo-reference/provinces/:code/cities`
+     */
+    getGeoCities(code: string): Promise<GetGeoCitiesResponse>;
+}
+
+export { DropshipperClient, type DropshipperClientConfig, MedusaAdminClient, type MedusaAdminClientConfig };