@basedone/core 0.2.1 → 0.2.3

package/dist/ecommerce.d.mts

@@ -25,6 +25,8 @@ interface EcommerceClientConfig {
     headers?: Record<string, string>;
     /** Enable automatic retry on retryable errors */
     enableRetry?: boolean;
+    /** Whether to send cookies with requests */
+    withCredentials?: boolean;
 }
 /**
  * Base ecommerce API client class
@@ -199,8 +201,12 @@ declare enum OrderStatus {
  * Payment method enum
  */
 declare enum PaymentMethod {
-    /** USDC payment via Hyperliquid escrow */
+    /** USDC payment via Hyperliquid SpotTransfer */
     USDC_ESCROW = "USDC_ESCROW",
+    /** BasedPay external ledger payment */
+    BASEDPAY = "BASEDPAY",
+    /** Stripe card payment */
+    STRIPE = "STRIPE",
     /** Points-based payment */
     POINTS = "POINTS"
 }
@@ -542,7 +548,7 @@ interface Merchant extends BaseEntity {
 /**
  * Shipping address
  */
-interface ShippingAddress {
+interface ShippingAddress$1 {
     /** Full name */
     fullName: string;
     /** Phone number */
@@ -567,7 +573,7 @@ interface ShippingAddress {
 /**
  * User shipping address entity (saved addresses)
  */
-interface UserShippingAddress extends BaseEntity, ShippingAddress {
+interface UserShippingAddress extends BaseEntity, ShippingAddress$1 {
     /** User ID */
     userId: string;
     /** Is default address */
@@ -670,7 +676,7 @@ interface Order extends BaseEntity {
     /** Payment method */
     paymentMethod: PaymentMethod;
     /** Shipping address */
-    shippingAddress: ShippingAddress;
+    shippingAddress: ShippingAddress$1;
     /** Customer notes */
     customerNotes?: string | null;
     /** Order items */
@@ -1160,6 +1166,92 @@ interface FlashSale {
     /** Flash sale items */
     items: FlashSaleItem[];
 }
+/**
+ * Merchant shipping settings entity
+ */
+interface MerchantShippingSettings extends BaseEntity {
+    /** Merchant ID */
+    merchantId: string;
+    /** Default handling fee in USDC */
+    defaultHandlingFee: number;
+    /** Default processing time in days */
+    defaultProcessingDays: number;
+    /** Default product weight in kg */
+    defaultWeightKg: number;
+    /** Free shipping enabled globally */
+    freeShippingEnabled: boolean;
+    /** Free shipping threshold in USDC */
+    freeShippingThreshold: number | null;
+    /** Show estimated delivery to customers */
+    showEstimatedDelivery: boolean;
+}
+/**
+ * Shipping zone entity
+ */
+interface ShippingZone extends BaseEntity {
+    /** Merchant ID */
+    merchantId: string;
+    /** Zone name */
+    name: string;
+    /** Country codes (ISO 2-letter codes) */
+    countries: string[];
+    /** Is default zone for unlisted countries */
+    isDefault: boolean;
+    /** Is zone active */
+    isActive: boolean;
+    /** Priority (higher = checked first) */
+    priority: number;
+    /** Number of rates in this zone */
+    rateCount?: number;
+    /** Associated shipping rates */
+    rates?: ShippingRate[];
+}
+/**
+ * Shipping rate entity
+ */
+interface ShippingRate extends BaseEntity {
+    /** Zone ID */
+    zoneId: string;
+    /** Zone name (for display) */
+    zoneName?: string;
+    /** Merchant ID */
+    merchantId: string;
+    /** Rate name (e.g., "Standard", "Express") */
+    name: string;
+    /** Base shipping rate in USDC */
+    baseRate: number;
+    /** Per kg rate in USDC */
+    perKgRate: number;
+    /** Minimum weight in kg */
+    minWeightKg: number | null;
+    /** Maximum weight in kg */
+    maxWeightKg: number | null;
+    /** Minimum delivery days */
+    minDeliveryDays: number | null;
+    /** Maximum delivery days */
+    maxDeliveryDays: number | null;
+    /** Free shipping above this amount */
+    freeAboveAmount: number | null;
+    /** Is rate active */
+    isActive: boolean;
+    /** Sort order */
+    sortOrder: number;
+}
+/**
+ * Shipping option (calculated for checkout)
+ */
+interface ShippingOption {
+    /** Rate ID */
+    id: string;
+    /** Rate name */
+    name: string;
+    /** Calculated cost in USDC */
+    cost: number;
+    /** Estimated delivery string */
+    estimatedDelivery: string;
+    /** Zone name */
+    zoneName: string;
+}
 
 /**
  * Ecommerce API Request Types
@@ -1279,13 +1371,21 @@ interface CreateOrderRequest {
     /** Payment method */
     paymentMethod: PaymentMethod;
     /** Shipping address */
-    shippingAddress: ShippingAddress;
+    shippingAddress: ShippingAddress$1;
     /** Customer notes */
     customerNotes?: string;
     /** Coupon code */
     couponCode?: string;
     /** Idempotency key */
     idempotencyKey?: string;
+    /** Selected shipping method name (e.g., "Standard", "Express") */
+    shippingMethod?: string;
+    /** Calculated shipping cost in USDC */
+    shippingCost?: number;
+    /** Shipping zone name for reference */
+    shippingZone?: string;
+    /** Estimated delivery time (e.g., "5-7 business days") */
+    estimatedDelivery?: string;
 }
 /**
  * List orders request parameters
@@ -1347,7 +1447,7 @@ interface RespondToReviewRequest {
 /**
  * Create/update shipping address request
  */
-interface ShippingAddressRequest extends ShippingAddress {
+interface ShippingAddressRequest extends ShippingAddress$1 {
     /** Is default address */
     isDefault?: boolean;
     /** Address label */
@@ -1689,6 +1789,110 @@ interface CreateFlashSaleRequest {
  */
 interface UpdateFlashSaleRequest extends Partial<CreateFlashSaleRequest> {
 }
+/**
+ * List merchant products params
+ */
+interface ListMerchantProductsParams extends PaginationParams {
+    /** Search query */
+    search?: string;
+    /** Filter by category slug */
+    category?: string;
+    /** Minimum price */
+    minPrice?: number;
+    /** Maximum price */
+    maxPrice?: number;
+    /** Sort by: popular, latest, top_sales, price_asc, price_desc, rating */
+    sortBy?: "popular" | "latest" | "top_sales" | "price_asc" | "price_desc" | "rating";
+}
+/**
+ * List followed merchants params
+ */
+interface ListFollowingParams extends PaginationParams {
+    /** Sort by: recent (default) or name */
+    sortBy?: "recent" | "name";
+}
+/**
+ * Update shipping settings request
+ */
+interface UpdateShippingSettingsRequest {
+    /** Default handling fee in USDC */
+    defaultHandlingFee?: number;
+    /** Default processing time in days */
+    defaultProcessingDays?: number;
+    /** Default product weight in kg */
+    defaultWeightKg?: number;
+    /** Free shipping enabled globally */
+    freeShippingEnabled?: boolean;
+    /** Free shipping threshold in USDC */
+    freeShippingThreshold?: number | null;
+    /** Show estimated delivery to customers */
+    showEstimatedDelivery?: boolean;
+}
+/**
+ * Create shipping zone request
+ */
+interface CreateShippingZoneRequest {
+    /** Zone name */
+    name: string;
+    /** Country codes (ISO 2-letter codes) */
+    countries: string[];
+    /** Is default zone for unlisted countries */
+    isDefault?: boolean;
+    /** Is zone active */
+    isActive?: boolean;
+    /** Priority (higher = checked first) */
+    priority?: number;
+}
+/**
+ * Update shipping zone request
+ */
+interface UpdateShippingZoneRequest extends Partial<CreateShippingZoneRequest> {
+}
+/**
+ * Create shipping rate request
+ */
+interface CreateShippingRateRequest {
+    /** Zone ID */
+    zoneId: string;
+    /** Rate name (e.g., "Standard", "Express") */
+    name: string;
+    /** Base shipping rate in USDC */
+    baseRate: number;
+    /** Per kg rate in USDC */
+    perKgRate?: number;
+    /** Minimum weight in kg */
+    minWeightKg?: number | null;
+    /** Maximum weight in kg */
+    maxWeightKg?: number | null;
+    /** Minimum delivery days */
+    minDeliveryDays?: number | null;
+    /** Maximum delivery days */
+    maxDeliveryDays?: number | null;
+    /** Free shipping above this amount */
+    freeAboveAmount?: number | null;
+    /** Is rate active */
+    isActive?: boolean;
+    /** Sort order */
+    sortOrder?: number;
+}
+/**
+ * Update shipping rate request
+ */
+interface UpdateShippingRateRequest extends Partial<Omit<CreateShippingRateRequest, "zoneId">> {
+}
+/**
+ * Calculate shipping options request
+ */
+interface CalculateShippingRequest {
+    /** Merchant ID */
+    merchantId: string;
+    /** Cart items */
+    cartItems: CartItem[];
+    /** Destination country code (ISO 2-letter) */
+    destinationCountry: string;
+    /** Order subtotal in USDC */
+    orderSubtotal: number;
+}
 
 /**
  * Ecommerce API Response Types
@@ -1987,6 +2191,96 @@ interface MerchantProfileResponse {
     /** Merchant */
     merchant: Merchant;
 }
+/**
+ * Public merchant profile (for storefront)
+ */
+interface PublicMerchantProfile {
+    /** Merchant ID */
+    id: string;
+    /** Merchant name */
+    name: string;
+    /** Description */
+    description: string | null;
+    /** Created at */
+    createdAt: string;
+    /** Number of active products */
+    productCount: number;
+    /** Total orders */
+    orderCount: number;
+    /** Average rating */
+    averageRating: number | null;
+    /** Total sold count */
+    totalSold: number;
+    /** Total view count */
+    totalViews: number;
+    /** Review count */
+    reviewCount: number;
+    /** Follower count */
+    followerCount: number;
+    /** Categories the merchant sells in */
+    categories: string[];
+}
+/**
+ * Public merchant profile response
+ */
+interface PublicMerchantProfileResponse {
+    /** Merchant */
+    merchant: PublicMerchantProfile;
+}
+/**
+ * Merchant products response
+ */
+interface MerchantProductsResponse extends PaginatedResponse<Product> {
+    /** Merchant info */
+    merchant: {
+        id: string;
+        name: string;
+    };
+}
+/**
+ * Follow status response
+ */
+interface FollowStatusResponse {
+    /** Whether the user is following */
+    isFollowing: boolean;
+    /** When the user followed (null if not following) */
+    followedAt: string | null;
+}
+/**
+ * Follow action response
+ */
+interface FollowActionResponse {
+    /** Success flag */
+    success: boolean;
+    /** Human-readable message */
+    message: string;
+    /** Whether the user is now following */
+    isFollowing: boolean;
+    /** When the user followed (only for follow action) */
+    followedAt?: string;
+}
+/**
+ * Followed merchant summary
+ */
+interface FollowedMerchantSummary {
+    /** When the user followed */
+    followedAt: string;
+    /** Merchant info */
+    merchant: {
+        id: string;
+        name: string;
+        description: string | null;
+        createdAt: string;
+        productCount: number;
+        averageRating: number | null;
+        totalSold: number;
+    };
+}
+/**
+ * List followed merchants response
+ */
+interface ListFollowingResponse extends PaginatedResponse<FollowedMerchantSummary> {
+}
 /**
  * List coupons response
  */
@@ -2465,6 +2759,130 @@ interface ActiveFlashSalesResponse {
     serverTime: string;
 }
 
+/**
+ * Get shipping settings response
+ */
+interface ShippingSettingsResponse {
+    /** Shipping settings */
+    settings: MerchantShippingSettings | {
+        defaultHandlingFee: number;
+        defaultProcessingDays: number;
+        freeShippingEnabled: boolean;
+        freeShippingThreshold: number | null;
+        defaultWeightKg: number;
+        showEstimatedDelivery: boolean;
+    };
+}
+/**
+ * List shipping zones response
+ */
+interface ListShippingZonesResponse {
+    /** Shipping zones */
+    zones: ShippingZone[];
+}
+/**
+ * Shipping zone response
+ */
+interface ShippingZoneResponse {
+    /** Shipping zone */
+    zone: ShippingZone;
+}
+/**
+ * List shipping rates response
+ */
+interface ListShippingRatesResponse {
+    /** Shipping rates */
+    rates: ShippingRate[];
+}
+/**
+ * Shipping rate response
+ */
+interface ShippingRateResponse {
+    /** Shipping rate */
+    rate: ShippingRate;
+}
+/**
+ * Calculate shipping options response
+ */
+interface CalculateShippingResponse {
+    /** Available shipping options */
+    shippingOptions: ShippingOption[];
+}
+/**
+ * Payment method info for display
+ */
+interface PaymentMethodInfo {
+    /** Payment method ID (e.g., "USDC_ESCROW") */
+    id: string;
+    /** Display name (e.g., "USDC (Hyperliquid)") */
+    name: string;
+    /** Description of the payment method */
+    description: string;
+    /** Icon identifier */
+    icon?: string;
+    /** Whether the payment requires user signature (e.g., blockchain) */
+    requiresSignature?: boolean;
+    /** Whether refunds are supported */
+    supportsRefund?: boolean;
+}
+/**
+ * Get payment methods response
+ */
+interface GetPaymentMethodsResponse {
+    /** Whether the request was successful */
+    success: boolean;
+    /** Whether payments are globally enabled */
+    paymentsEnabled: boolean;
+    /** List of enabled payment methods */
+    methods: PaymentMethodInfo[];
+    /** Optional message (e.g., when payments are disabled) */
+    message?: string;
+}
+/**
+ * Process payment request
+ */
+interface ProcessPaymentRequest {
+    /** Order ID to pay for */
+    orderId: string;
+    /** Payment method to use */
+    paymentMethod: string;
+    /** Amount in USDC */
+    amount: number;
+    /** Pre-signed action for USDC_ESCROW */
+    signedAction?: {
+        action: unknown;
+        nonce: number;
+        signature: unknown;
+    };
+    /** Stripe payment method ID */
+    stripePaymentMethodId?: string;
+    /** BasedPay account ID */
+    basedPayAccountId?: string;
+    /** Points to spend */
+    pointsAmount?: number;
+}
+/**
+ * Process payment response
+ */
+interface ProcessPaymentResponse {
+    /** Whether the payment was successful */
+    success: boolean;
+    /** Payment transaction ID */
+    transactionId?: string;
+    /** Blockchain transaction hash (for crypto payments) */
+    transactionHash?: string;
+    /** Payment status */
+    status: "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "REFUNDED";
+    /** Amount charged */
+    amount: number;
+    /** Currency */
+    currency: string;
+    /** Error message if failed */
+    error?: string;
+    /** Error code */
+    errorCode?: string;
+}
+
 /**
  * Customer/End-User Ecommerce API Client
  *
@@ -2810,6 +3228,29 @@ declare class CustomerEcommerceClient extends BaseEcommerceClient {
      * ```
      */
     calculateTax(request: CalculateTaxRequest): Promise<CalculateTaxResponse>;
+    /**
+     * Calculate shipping options for cart items
+     *
+     * @param request - Cart items, merchant, and destination
+     * @returns Available shipping options with costs
+     *
+     * @example
+     * ```typescript
+     * const result = await client.calculateShippingOptions({
+     *   merchantId: "merchant_123",
+     *   cartItems: [
+     *     { productId: "prod_123", quantity: 2 }
+     *   ],
+     *   destinationCountry: "US",
+     *   orderSubtotal: 99.99
+     * });
+     *
+     * result.shippingOptions.forEach(opt => {
+     *   console.log(opt.name, opt.cost, opt.estimatedDelivery);
+     * });
+     * ```
+     */
+    calculateShippingOptions(request: CalculateShippingRequest): Promise<CalculateShippingResponse>;
     /**
      * Get active promotional banners
      *
@@ -2929,6 +3370,118 @@ declare class CustomerEcommerceClient extends BaseEcommerceClient {
      * ```
      */
     getActiveFlashSales(params?: ListActiveFlashSalesParams): Promise<ActiveFlashSalesResponse>;
+    /**
+     * Get public merchant profile
+     *
+     * Fetches public information about a merchant for the storefront page.
+     *
+     * @param merchantId - Merchant ID
+     * @returns Public merchant profile with stats
+     *
+     * @example
+     * ```typescript
+     * const result = await client.getMerchantProfile("merchant_123");
+     * console.log(result.merchant.name, result.merchant.productCount);
+     * ```
+     */
+    getMerchantProfile(merchantId: string): Promise<PublicMerchantProfileResponse>;
+    /**
+     * List merchant products
+     *
+     * Fetches products for a specific merchant with search, filter, and sort options.
+     *
+     * @param merchantId - Merchant ID
+     * @param params - Query parameters for filtering and pagination
+     * @returns Paginated list of products
+     *
+     * @example
+     * ```typescript
+     * const result = await client.getMerchantProducts("merchant_123", {
+     *   search: "laptop",
+     *   sortBy: "popular",
+     *   limit: 20,
+     * });
+     *
+     * result.items.forEach(product => {
+     *   console.log(product.title, product.priceUSDC);
+     * });
+     * ```
+     */
+    getMerchantProducts(merchantId: string, params?: ListMerchantProductsParams): Promise<MerchantProductsResponse>;
+    /**
+     * Check if following a merchant
+     *
+     * @param merchantId - Merchant ID
+     * @returns Follow status with follow date if applicable
+     *
+     * @example
+     * ```typescript
+     * const status = await client.isFollowingMerchant("merchant_123");
+     * if (status.isFollowing) {
+     *   console.log(`Following since ${status.followedAt}`);
+     * }
+     * ```
+     */
+    isFollowingMerchant(merchantId: string): Promise<FollowStatusResponse>;
+    /**
+     * Follow a merchant
+     *
+     * @param merchantId - Merchant ID to follow
+     * @returns Follow action result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.followMerchant("merchant_123");
+     * console.log(result.message); // "Now following Awesome Store"
+     * ```
+     */
+    followMerchant(merchantId: string): Promise<FollowActionResponse>;
+    /**
+     * Unfollow a merchant
+     *
+     * @param merchantId - Merchant ID to unfollow
+     * @returns Unfollow action result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.unfollowMerchant("merchant_123");
+     * console.log(result.message); // "Unfollowed successfully"
+     * ```
+     */
+    unfollowMerchant(merchantId: string): Promise<FollowActionResponse>;
+    /**
+     * Get list of followed merchants
+     *
+     * @param params - Query parameters for pagination and sorting
+     * @returns Paginated list of followed merchants with their info
+     *
+     * @example
+     * ```typescript
+     * const result = await client.getFollowedMerchants({ limit: 20, sortBy: "recent" });
+     * result.items.forEach(item => {
+     *   console.log(`${item.merchant.name} - followed on ${item.followedAt}`);
+     * });
+     * ```
+     */
+    getFollowedMerchants(params?: ListFollowingParams): Promise<ListFollowingResponse>;
+    /**
+     * Get available payment methods
+     *
+     * Returns the list of enabled payment methods that can be used during checkout.
+     *
+     * @returns List of available payment methods with display info
+     *
+     * @example
+     * ```typescript
+     * const result = await client.getPaymentMethods();
+     * if (result.paymentsEnabled) {
+     *   result.methods.forEach(method => {
+     *     console.log(`${method.name}: ${method.description}`);
+     *   });
+     * }
+     * ```
+     */
+    getPaymentMethods(): Promise<GetPaymentMethodsResponse>;
 }
 
 /**
@@ -3410,6 +3963,166 @@ declare class MerchantEcommerceClient extends BaseEcommerceClient {
      * ```
      */
     updateShipment(shipmentId: string, request: UpdateShipmentRequest): Promise<ShipmentResponse>;
+    /**
+     * Get merchant shipping settings
+     *
+     * @returns Shipping settings
+     *
+     * @example
+     * ```typescript
+     * const { settings } = await client.getShippingSettings();
+     * console.log("Handling fee:", settings.defaultHandlingFee);
+     * ```
+     */
+    getShippingSettings(): Promise<ShippingSettingsResponse>;
+    /**
+     * Update merchant shipping settings
+     *
+     * @param request - Settings to update
+     * @returns Updated settings
+     *
+     * @example
+     * ```typescript
+     * await client.updateShippingSettings({
+     *   defaultHandlingFee: 2.50,
+     *   freeShippingEnabled: true,
+     *   freeShippingThreshold: 100
+     * });
+     * ```
+     */
+    updateShippingSettings(request: UpdateShippingSettingsRequest): Promise<ShippingSettingsResponse>;
+    /**
+     * List all shipping zones
+     *
+     * @returns List of shipping zones with rate counts
+     *
+     * @example
+     * ```typescript
+     * const { zones } = await client.listShippingZones();
+     * zones.forEach(z => console.log(z.name, z.countries.length, "countries"));
+     * ```
+     */
+    listShippingZones(): Promise<ListShippingZonesResponse>;
+    /**
+     * Get a shipping zone by ID
+     *
+     * @param zoneId - Zone ID
+     * @returns Zone with rates
+     *
+     * @example
+     * ```typescript
+     * const { zone } = await client.getShippingZone("zone_123");
+     * console.log(zone.name, zone.rates?.length, "rates");
+     * ```
+     */
+    getShippingZone(zoneId: string): Promise<ShippingZoneResponse>;
+    /**
+     * Create a shipping zone
+     *
+     * @param request - Zone data
+     * @returns Created zone
+     *
+     * @example
+     * ```typescript
+     * const { zone } = await client.createShippingZone({
+     *   name: "Southeast Asia",
+     *   countries: ["SG", "MY", "TH", "ID", "PH", "VN"],
+     *   isDefault: false,
+     *   priority: 10
+     * });
+     * ```
+     */
+    createShippingZone(request: CreateShippingZoneRequest): Promise<ShippingZoneResponse>;
+    /**
+     * Update a shipping zone
+     *
+     * @param zoneId - Zone ID
+     * @param request - Updated zone data
+     * @returns Updated zone
+     *
+     * @example
+     * ```typescript
+     * await client.updateShippingZone("zone_123", {
+     *   countries: ["SG", "MY", "TH", "ID", "PH", "VN", "BN"]
+     * });
+     * ```
+     */
+    updateShippingZone(zoneId: string, request: UpdateShippingZoneRequest): Promise<ShippingZoneResponse>;
+    /**
+     * Delete a shipping zone
+     *
+     * @param zoneId - Zone ID
+     * @returns Success response
+     *
+     * @example
+     * ```typescript
+     * await client.deleteShippingZone("zone_123");
+     * ```
+     */
+    deleteShippingZone(zoneId: string): Promise<SuccessResponse>;
+    /**
+     * List shipping rates
+     *
+     * @param zoneId - Optional zone ID to filter by
+     * @returns List of shipping rates
+     *
+     * @example
+     * ```typescript
+     * // All rates
+     * const { rates } = await client.listShippingRates();
+     *
+     * // Rates for a specific zone
+     * const { rates: zoneRates } = await client.listShippingRates("zone_123");
+     * ```
+     */
+    listShippingRates(zoneId?: string): Promise<ListShippingRatesResponse>;
+    /**
+     * Create a shipping rate
+     *
+     * @param request - Rate data
+     * @returns Created rate
+     *
+     * @example
+     * ```typescript
+     * const { rate } = await client.createShippingRate({
+     *   zoneId: "zone_123",
+     *   name: "Standard Shipping",
+     *   baseRate: 5.00,
+     *   perKgRate: 1.50,
+     *   minDeliveryDays: 7,
+     *   maxDeliveryDays: 14
+     * });
+     * ```
+     */
+    createShippingRate(request: CreateShippingRateRequest): Promise<ShippingRateResponse>;
+    /**
+     * Update a shipping rate
+     *
+     * @param rateId - Rate ID
+     * @param request - Updated rate data
+     * @returns Updated rate
+     *
+     * @example
+     * ```typescript
+     * await client.updateShippingRate("rate_123", {
+     *   baseRate: 6.00,
+     *   freeAboveAmount: 75
+     * });
+     * ```
+     */
+    updateShippingRate(rateId: string, request: UpdateShippingRateRequest): Promise<ShippingRateResponse>;
+    /**
+     * Delete a shipping rate
+     *
+     * @param rateId - Rate ID
+     * @returns Success response
+     *
+     * @example
+     * ```typescript
+     * await client.deleteShippingRate("rate_123");
+     * ```
+     */
+    deleteShippingRate(rateId: string): Promise<SuccessResponse>;
     /**
      * List returns
      *
@@ -3905,6 +4618,506 @@ declare class MerchantEcommerceClient extends BaseEcommerceClient {
      * ```
      */
     exportTaxReport(reportId: string): Promise<string>;
+    /**
+     * List connected dropship suppliers
+     *
+     * @returns Connected and available suppliers
+     *
+     * @example
+     * ```typescript
+     * const { connected, available } = await client.listDropshipSuppliers();
+     * ```
+     */
+    listDropshipSuppliers(): Promise<{
+        connected: DropshipSupplier[];
+        available: DropshipSupplierInfo[];
+    }>;
+    /**
+     * Connect a new dropship supplier
+     *
+     * @param request - Supplier credentials
+     * @returns Connected supplier
+     *
+     * @example
+     * ```typescript
+     * const supplier = await client.connectDropshipSupplier({
+     *   code: "CJ_DROPSHIPPING",
+     *   apiKey: "your-api-key"
+     * });
+     * ```
+     */
+    connectDropshipSupplier(request: ConnectDropshipSupplierRequest): Promise<{
+        supplier: DropshipSupplier;
+        message: string;
+    }>;
+    /**
+     * Update dropship supplier settings
+     *
+     * @param supplierId - Supplier ID
+     * @param request - Settings to update
+     * @returns Updated supplier
+     */
+    updateDropshipSupplier(supplierId: string, request: UpdateDropshipSupplierRequest): Promise<{
+        supplier: DropshipSupplier;
+    }>;
+    /**
+     * Disconnect a dropship supplier
+     *
+     * @param supplierId - Supplier ID
+     */
+    disconnectDropshipSupplier(supplierId: string): Promise<SuccessResponse>;
+    /**
+     * Search products from connected suppliers
+     *
+     * @param request - Search parameters
+     * @returns Search results with pagination
+     *
+     * @example
+     * ```typescript
+     * const results = await client.searchDropshipProducts({
+     *   supplierId: "supplier_123",
+     *   query: "wireless headphones",
+     *   limit: 20
+     * });
+     * ```
+     */
+    searchDropshipProducts(request: SearchDropshipProductsRequest): Promise<{
+        products: SupplierProduct[];
+        pagination: {
+            total: number;
+            page: number;
+            limit: number;
+            hasMore: boolean;
+        };
+        supplier?: string;
+    }>;
+    /**
+     * Get dropship supplier categories
+     *
+     * @param supplierId - Supplier ID
+     * @returns Category list
+     */
+    getDropshipCategories(supplierId: string): Promise<{
+        categories: SupplierCategory[];
+    }>;
+    /**
+     * Get detailed product info from supplier
+     *
+     * @param supplierId - Supplier ID
+     * @param externalProductId - Supplier's product ID
+     * @returns Product details with suggested pricing
+     */
+    getDropshipProductDetails(supplierId: string, externalProductId: string): Promise<{
+        product: SupplierProduct;
+        suggestedPrice: number;
+        estimatedMargin: number;
+    }>;
+    /**
+     * Import a product from supplier to your store
+     *
+     * @param request - Import parameters
+     * @returns Created product IDs
+     *
+     * @example
+     * ```typescript
+     * const result = await client.importDropshipProduct({
+     *   supplierId: "supplier_123",
+     *   externalProductId: "ext_product_456",
+     *   priceUSDC: 29.99,
+     *   title: "Custom Title"
+     * });
+     * ```
+     */
+    importDropshipProduct(request: ImportDropshipProductRequest): Promise<{
+        success: boolean;
+        productId?: string;
+        dropshipProductId?: string;
+        error?: string;
+    }>;
+    /**
+     * Bulk import products from supplier
+     *
+     * @param request - Bulk import parameters
+     * @returns Import results
+     */
+    bulkImportDropshipProducts(request: BulkImportDropshipProductsRequest): Promise<{
+        success: boolean;
+        imported: number;
+        failed: number;
+        results: Array<{
+            externalProductId: string;
+            success: boolean;
+            productId?: string;
+            error?: string;
+        }>;
+    }>;
+    /**
+     * List imported dropship products
+     *
+     * @param params - Filter parameters
+     * @returns Imported products list
+     */
+    listDropshipProducts(params?: {
+        supplierId?: string;
+        isActive?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        items: DropshipProduct[];
+        pagination: {
+            total: number;
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        };
+    }>;
+    /**
+     * List dropship order links
+     *
+     * @param params - Filter parameters
+     * @returns Order links with status summary
+     */
+    listDropshipOrders(params?: {
+        status?: string | string[];
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        items: DropshipOrderLink[];
+        pagination: {
+            total: number;
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        };
+        summary: {
+            pending: number;
+            forwarded: number;
+            processing: number;
+            shipped: number;
+            delivered: number;
+            failed: number;
+        };
+    }>;
+    /**
+     * Forward orders to supplier
+     *
+     * @param orderItemIds - Order item IDs to forward
+     * @returns Forward results
+     */
+    forwardDropshipOrders(orderItemIds: string[]): Promise<{
+        success: boolean;
+        forwarded: number;
+        failed: number;
+        results: Array<{
+            orderItemId: string;
+            success: boolean;
+            externalOrderId?: string;
+            error?: string;
+        }>;
+    }>;
+    /**
+     * Sync tracking for all pending dropship orders
+     *
+     * @returns Sync results
+     */
+    syncDropshipTracking(): Promise<{
+        success: boolean;
+        total: number;
+        synced: number;
+        updated: number;
+        failed: number;
+    }>;
+    /**
+     * Get order forwarding details for manual forwarding
+     *
+     * @param orderItemId - Order item ID
+     * @returns Forwarding details
+     */
+    getDropshipOrderDetails(orderItemId: string): Promise<{
+        details: {
+            orderId: string;
+            orderItemId: string;
+            productTitle: string;
+            quantity: number;
+            supplierName: string;
+            supplierProductId: string;
+            supplierPrice: number;
+            shippingAddress: ShippingAddress;
+            estimatedCost: number;
+            status: string;
+        };
+    }>;
+    /**
+     * Forward a single order item to supplier
+     *
+     * @param orderItemId - Order item ID
+     * @returns Forward result
+     */
+    forwardDropshipOrder(orderItemId: string): Promise<{
+        success: boolean;
+        dropshipOrderLinkId?: string;
+        externalOrderId?: string;
+        error?: string;
+    }>;
+    /**
+     * Get dropship settings
+     *
+     * @returns Merchant dropship settings
+     */
+    getDropshipSettings(): Promise<{
+        settings: DropshipMerchantSettings;
+    }>;
+    /**
+     * Update dropship settings
+     *
+     * @param request - Settings to update
+     * @returns Updated settings
+     */
+    updateDropshipSettings(request: UpdateDropshipSettingsRequest): Promise<{
+        settings: DropshipMerchantSettings;
+    }>;
+    /**
+     * Sync dropship products and/or orders
+     *
+     * @param type - Sync type (products, orders, all, single)
+     * @param dropshipProductId - For single product sync
+     * @returns Sync results
+     */
+    syncDropship(type: "products" | "orders" | "all" | "single", dropshipProductId?: string): Promise<{
+        success: boolean;
+        type: string;
+        results: {
+            products?: {
+                total: number;
+                synced: number;
+                failed: number;
+            };
+            orders?: {
+                total: number;
+                synced: number;
+                updated: number;
+                failed: number;
+            };
+            product?: {
+                success: boolean;
+                updated: boolean;
+                error?: string;
+            };
+        };
+    }>;
+}
+interface DropshipSupplier {
+    id: string;
+    code: string;
+    name: string;
+    isActive: boolean;
+    autoForward: boolean;
+    settings?: Record<string, any>;
+    createdAt: string;
+}
+interface DropshipSupplierInfo {
+    code: string;
+    name: string;
+    description: string;
+    features: string[];
+    isConnected: boolean;
+}
+interface ConnectDropshipSupplierRequest {
+    code: string;
+    apiKey?: string;
+    apiSecret?: string;
+    accessToken?: string;
+}
+interface UpdateDropshipSupplierRequest {
+    autoForward?: boolean;
+    settings?: Record<string, any>;
+    apiKey?: string;
+    apiSecret?: string;
+    accessToken?: string;
+}
+interface SearchDropshipProductsRequest {
+    supplierId?: string;
+    supplierCode?: string;
+    query?: string;
+    category?: string;
+    minPrice?: number;
+    maxPrice?: number;
+    page?: number;
+    limit?: number;
+    sortBy?: "price_asc" | "price_desc" | "rating" | "orders" | "newest";
+}
+interface SupplierProduct {
+    externalProductId: string;
+    externalUrl?: string;
+    externalSku?: string;
+    title: string;
+    description: string;
+    images: string[];
+    price: number;
+    currency: string;
+    shippingCost?: number;
+    processingDays?: number;
+    shippingDays?: number;
+    warehouseLocation?: string;
+    category?: string;
+    variants?: SupplierProductVariant[];
+    rating?: number;
+    reviewCount?: number;
+    minOrderQuantity?: number;
+    inventory?: number;
+}
+interface SupplierProductVariant {
+    externalVariantId: string;
+    name: string;
+    sku?: string;
+    price: number;
+    inventory?: number;
+    attributes: Record<string, string>;
+    image?: string;
+}
+interface SupplierCategory {
+    id: string;
+    name: string;
+    parentId?: string;
+    children?: SupplierCategory[];
+}
+interface ImportDropshipProductRequest {
+    supplierId: string;
+    externalProductId: string;
+    priceUSDC: number;
+    compareAtPrice?: number;
+    title?: string;
+    richDescription?: string;
+    category?: string;
+    categoryId?: string;
+    tags?: string[];
+    isActive?: boolean;
+}
+interface BulkImportDropshipProductsRequest {
+    supplierId: string;
+    products: Array<{
+        externalProductId: string;
+        priceUSDC: number;
+        compareAtPrice?: number;
+        title?: string;
+        category?: string;
+        categoryId?: string;
+    }>;
+}
+interface DropshipProduct {
+    id: string;
+    supplierId: string;
+    externalProductId: string;
+    externalUrl?: string;
+    supplierPrice: string;
+    supplierCurrency: string;
+    shippingCost?: string;
+    processingDays?: number;
+    shippingDays?: number;
+    warehouseLocation?: string;
+    productSnapshot: any;
+    lastSyncedAt?: string;
+    syncError?: string;
+    localProductId?: string;
+    localProduct?: {
+        id: string;
+        title: string;
+        priceUSDC: string;
+        images: string[];
+        isActive: boolean;
+        inventory?: number;
+        soldCount: number;
+    };
+    supplier?: {
+        id: string;
+        name: string;
+        code: string;
+    };
+    isActive: boolean;
+    createdAt: string;
+}
+interface DropshipOrderLink {
+    id: string;
+    orderId: string;
+    orderItemId: string;
+    supplierId: string;
+    dropshipProductId?: string;
+    externalOrderId?: string;
+    externalStatus?: string;
+    status: string;
+    forwardedAt?: string;
+    processedAt?: string;
+    shippedAt?: string;
+    deliveredAt?: string;
+    trackingNumber?: string;
+    trackingUrl?: string;
+    carrier?: string;
+    supplierCost?: string;
+    shippingCost?: string;
+    lastError?: string;
+    order?: {
+        id: string;
+        status: string;
+        totalUSDC: string;
+        shippingAddress: any;
+        createdAt: string;
+    };
+    orderItem?: {
+        id: string;
+        titleSnapshot: string;
+        quantity: number;
+        unitPriceUSDC: string;
+    };
+    supplier?: {
+        id: string;
+        name: string;
+        code: string;
+    };
+    createdAt: string;
+}
+interface DropshipMerchantSettings {
+    merchantId: string;
+    defaultMarkupType: string;
+    defaultMarkupValue: string;
+    roundPriceTo?: string;
+    autoForwardOrders: boolean;
+    autoSyncTracking: boolean;
+    syncIntervalMinutes: number;
+    autoSyncInventory: boolean;
+    lowStockThreshold: number;
+    outOfStockBehavior: string;
+    defaultShippingMethod?: string;
+    freeShippingThreshold?: string;
+    notifyOnNewOrder: boolean;
+    notifyOnLowStock: boolean;
+    notifyOnShipment: boolean;
+}
+interface UpdateDropshipSettingsRequest {
+    defaultMarkupType?: string;
+    defaultMarkupValue?: number;
+    roundPriceTo?: number | null;
+    autoForwardOrders?: boolean;
+    autoSyncTracking?: boolean;
+    syncIntervalMinutes?: number;
+    autoSyncInventory?: boolean;
+    lowStockThreshold?: number;
+    outOfStockBehavior?: string;
+    defaultShippingMethod?: string | null;
+    freeShippingThreshold?: number | null;
+    notifyOnNewOrder?: boolean;
+    notifyOnLowStock?: boolean;
+    notifyOnShipment?: boolean;
+}
+interface ShippingAddress {
+    fullName: string;
+    phone: string;
+    email?: string;
+    addressLine1: string;
+    addressLine2?: string;
+    city: string;
+    state?: string;
+    postalCode: string;
+    country: string;
 }
 
 /**
@@ -3983,4 +5196,4 @@ declare function calculateDiscountAmount(price: number, discountType: "PERCENTAG
  */
 declare function calculateFinalPrice(price: number, discountType: "PERCENTAGE" | "FIXED_AMOUNT", discountValue: number): number;
 
-export { type ActiveFlashSalesResponse, type AnalyticsOverview, type ApiResponse, type AppliedDiscount, type Banner, type BannerResponse, BannerType, BaseEcommerceClient, type BaseEntity, type CalculateCartDiscountsRequest, type CalculateCartDiscountsResponse, type CalculateTaxRequest, type CalculateTaxResponse, type CartItem, type ConfirmEscrowDepositResponse, type Coupon, type CouponResponse, type CouponUsage, type CreateBannerRequest, type CreateCouponRequest, type CreateFlashSaleRequest, type CreateOrderEventRequest, type CreateOrderEventResponse, type CreateOrderRequest, type CreateOrderResponse, type CreateProductRequest, type CreateProductVariantRequest, type CreateReviewRequest, type CreateShippingMethodRequest, type CreateTaxNexusRequest, type CreateTaxRuleRequest, CustomerEcommerceClient, type CustomerMessagesResponse, type CustomerSummary, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, type EcommerceClientConfig, type FlashSale, type FlashSaleItem, type FlashSaleItemInput, type GenerateTaxReportRequest, type GetAnalyticsParams, type GetAnalyticsResponse, type GetCouponResponse, type GetOrderResponse, type GetProductMetricsResponse, type GetProductResponse, type GetTaxReportResponse, InventoryAuditAction, type InventoryAuditEntry, type ListActiveBannersParams, type ListActiveFlashSalesParams, type ListBannersResponse, type ListCouponsResponse, type ListCustomersParams, type ListCustomersResponse, type ListInventoryAuditResponse, type ListMediaAssetsResponse, type ListMessagesResponse, type ListOrdersParams, type ListOrdersResponse, type ListProductVariantsResponse, type ListProductsParams, type ListProductsResponse, type ListReturnsResponse, type ListReviewsParams, type ListReviewsResponse, type ListShipmentsResponse, type ListShippingAddressesResponse, type ListShippingMethodsResponse, type ListTaxNexusResponse, type ListTaxReportsParams, type ListTaxReportsResponse, type ListTaxRulesResponse, type MediaAsset, type MediaAssetResponse, type Merchant, MerchantEcommerceClient, type MerchantProfileRequest, type MerchantProfileResponse, MerchantStatus, type Message, type MessageResponse, type MessageStatsResponse, type Order, type OrderEvent, type OrderItem, type OrderReceiptResponse, OrderStatus, type OrdersByStatus, type PaginatedResponse, type PaginationParams, type Payment, PaymentMethod, PaymentStatus, type Product, type ProductDimensions, type ProductDiscountsResponse, type ProductMetrics, type ProductResponse, type ProductReview, ProductSortBy, type ProductVariant, type ProductVariantResponse, type RecentOrderSummary, type RespondToReviewRequest, type Return, type ReturnItem, type ReturnResponse, ReturnStatus, type RevenueByDay, type ReviewResponse, ReviewSortBy, ReviewStatus, type SendMessageRequest, type Settlement, type Shipment, type ShipmentResponse, ShipmentStatus, type ShippingAddress, type ShippingAddressRequest, type ShippingAddressResponse, type ShippingMethod, type ShippingMethodResponse, SortOrder, type SuccessResponse, TaxBehavior, type TaxBreakdownItem, type TaxNexus, type TaxNexusResponse, type TaxReport, type TaxReportDetails, TaxReportPeriodType, type TaxReportResponse, TaxReportStatus, type TaxRule, type TaxRuleResponse, type TaxSettings, type TaxSettingsResponse, TaxType, type TopProduct, type TrackBannerRequest, type UpdateBannerRequest, type UpdateCouponRequest, type UpdateFlashSaleRequest, type UpdateOrderResponse, type UpdateOrderStatusRequest, type UpdateProductRequest, type UpdateProductVariantRequest, type UpdateShipmentRequest, type UpdateShippingMethodRequest, type UpdateTaxNexusRequest, type UpdateTaxReportStatusRequest, type UpdateTaxRuleRequest, type UpdateTaxSettingsRequest, type UserShippingAddress, type ValidateDiscountRequest, type ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress };
+export { type ActiveFlashSalesResponse, type AnalyticsOverview, type ApiResponse, type AppliedDiscount, type Banner, type BannerResponse, BannerType, BaseEcommerceClient, type BaseEntity, type CalculateCartDiscountsRequest, type CalculateCartDiscountsResponse, type CalculateShippingRequest, type CalculateShippingResponse, type CalculateTaxRequest, type CalculateTaxResponse, type CartItem, type ConfirmEscrowDepositResponse, type Coupon, type CouponResponse, type CouponUsage, type CreateBannerRequest, type CreateCouponRequest, type CreateFlashSaleRequest, type CreateOrderEventRequest, type CreateOrderEventResponse, type CreateOrderRequest, type CreateOrderResponse, type CreateProductRequest, type CreateProductVariantRequest, type CreateReviewRequest, type CreateShippingMethodRequest, type CreateShippingRateRequest, type CreateShippingZoneRequest, type CreateTaxNexusRequest, type CreateTaxRuleRequest, CustomerEcommerceClient, type CustomerMessagesResponse, type CustomerSummary, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, type EcommerceClientConfig, type FlashSale, type FlashSaleItem, type FlashSaleItemInput, type FollowActionResponse, type FollowStatusResponse, type FollowedMerchantSummary, type GenerateTaxReportRequest, type GetAnalyticsParams, type GetAnalyticsResponse, type GetCouponResponse, type GetOrderResponse, type GetPaymentMethodsResponse, type GetProductMetricsResponse, type GetProductResponse, type GetTaxReportResponse, InventoryAuditAction, type InventoryAuditEntry, type ListActiveBannersParams, type ListActiveFlashSalesParams, type ListBannersResponse, type ListCouponsResponse, type ListCustomersParams, type ListCustomersResponse, type ListFollowingParams, type ListFollowingResponse, type ListInventoryAuditResponse, type ListMediaAssetsResponse, type ListMerchantProductsParams, type ListMessagesResponse, type ListOrdersParams, type ListOrdersResponse, type ListProductVariantsResponse, type ListProductsParams, type ListProductsResponse, type ListReturnsResponse, type ListReviewsParams, type ListReviewsResponse, type ListShipmentsResponse, type ListShippingAddressesResponse, type ListShippingMethodsResponse, type ListShippingRatesResponse, type ListShippingZonesResponse, type ListTaxNexusResponse, type ListTaxReportsParams, type ListTaxReportsResponse, type ListTaxRulesResponse, type MediaAsset, type MediaAssetResponse, type Merchant, MerchantEcommerceClient, type MerchantProductsResponse, type MerchantProfileRequest, type MerchantProfileResponse, type MerchantShippingSettings, MerchantStatus, type Message, type MessageResponse, type MessageStatsResponse, type Order, type OrderEvent, type OrderItem, type OrderReceiptResponse, OrderStatus, type OrdersByStatus, type PaginatedResponse, type PaginationParams, type Payment, PaymentMethod, type PaymentMethodInfo, PaymentStatus, type ProcessPaymentRequest, type ProcessPaymentResponse, type Product, type ProductDimensions, type ProductDiscountsResponse, type ProductMetrics, type ProductResponse, type ProductReview, ProductSortBy, type ProductVariant, type ProductVariantResponse, type PublicMerchantProfile, type PublicMerchantProfileResponse, type RecentOrderSummary, type RespondToReviewRequest, type Return, type ReturnItem, type ReturnResponse, ReturnStatus, type RevenueByDay, type ReviewResponse, ReviewSortBy, ReviewStatus, type SendMessageRequest, type Settlement, type Shipment, type ShipmentResponse, ShipmentStatus, type ShippingAddress$1 as ShippingAddress, type ShippingAddressRequest, type ShippingAddressResponse, type ShippingMethod, type ShippingMethodResponse, type ShippingOption, type ShippingRate, type ShippingRateResponse, type ShippingSettingsResponse, type ShippingZone, type ShippingZoneResponse, SortOrder, type SuccessResponse, TaxBehavior, type TaxBreakdownItem, type TaxNexus, type TaxNexusResponse, type TaxReport, type TaxReportDetails, TaxReportPeriodType, type TaxReportResponse, TaxReportStatus, type TaxRule, type TaxRuleResponse, type TaxSettings, type TaxSettingsResponse, TaxType, type TopProduct, type TrackBannerRequest, type UpdateBannerRequest, type UpdateCouponRequest, type UpdateFlashSaleRequest, type UpdateOrderResponse, type UpdateOrderStatusRequest, type UpdateProductRequest, type UpdateProductVariantRequest, type UpdateShipmentRequest, type UpdateShippingMethodRequest, type UpdateShippingRateRequest, type UpdateShippingSettingsRequest, type UpdateShippingZoneRequest, type UpdateTaxNexusRequest, type UpdateTaxReportStatusRequest, type UpdateTaxRuleRequest, type UpdateTaxSettingsRequest, type UserShippingAddress, type ValidateDiscountRequest, type ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress };