@basedone/core 0.2.2 → 0.2.4

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"
 }
@@ -404,7 +410,9 @@ declare enum ProductSortBy {
     /** Sort by popularity */
     POPULAR = "popular",
     /** Sort by featured status */
-    FEATURED = "featured"
+    FEATURED = "featured",
+    /** Sort by proximity to user location (requires lat/lng) */
+    NEARBY = "nearby"
 }
 /**
  * Review sort by enum
@@ -542,7 +550,7 @@ interface Merchant extends BaseEntity {
 /**
  * Shipping address
  */
-interface ShippingAddress {
+interface ShippingAddress$1 {
     /** Full name */
     fullName: string;
     /** Phone number */
@@ -567,7 +575,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 +678,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 +1168,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
@@ -1200,6 +1294,12 @@ interface ListProductsParams extends PaginationParams {
     sortBy?: ProductSortBy;
     /** Filter by active status */
     isActive?: boolean;
+    /** Filter by destination country (ISO 2-letter code) - only show products from merchants that ship here */
+    country?: string;
+    /** User latitude for proximity sorting (used with sortBy=nearby) */
+    lat?: number;
+    /** User longitude for proximity sorting (used with sortBy=nearby) */
+    lng?: number;
 }
 /**
  * Create product request
@@ -1279,13 +1379,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 +1455,7 @@ interface RespondToReviewRequest {
 /**
  * Create/update shipping address request
  */
-interface ShippingAddressRequest extends ShippingAddress {
+interface ShippingAddressRequest extends ShippingAddress$1 {
     /** Is default address */
     isDefault?: boolean;
     /** Address label */
@@ -1711,6 +1819,123 @@ 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;
+}
+/**
+ * Gem history type filter
+ */
+type GemHistoryTypeFilter = "earn" | "spend" | "all";
+/**
+ * Get gem history parameters
+ */
+interface GetGemHistoryParams extends PaginationParams {
+    /** Filter by transaction type */
+    type?: GemHistoryTypeFilter;
+}
+/**
+ * Get expiring gems parameters
+ */
+interface GetExpiringGemsParams {
+    /** Number of days ahead to check (default: 30, max: 180) */
+    days?: number;
+}
+/**
+ * Save browsing location request
+ */
+interface SaveBrowsingLocationRequest {
+    /** Full display address from Google Places */
+    formattedAddress: string;
+    /** City name */
+    city: string;
+    /** State/Province (optional) */
+    stateProvince?: string;
+    /** ISO 2-letter country code (e.g., "SG", "US") */
+    country: string;
+    /** Latitude coordinate */
+    latitude: number;
+    /** Longitude coordinate */
+    longitude: number;
+}
 
 /**
  * Ecommerce API Response Types
@@ -2577,6 +2802,271 @@ 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;
+}
+/**
+ * Gem source type - how gems were earned
+ */
+type GemSource = "BUILDER_CODE" | "PREDICTION" | "CARD_SPEND" | "MALL_SPEND" | "ADMIN" | "REFUND";
+/**
+ * Get gem balance response
+ */
+interface GetGemBalanceResponse {
+    /** User ID */
+    userId: string;
+    /** Total gems owned */
+    totalGems: number;
+    /** Available gems (not reserved) */
+    availableGems: number;
+    /** Gems expiring within 30 days */
+    expiringSoon: number;
+    /** Last balance update timestamp */
+    lastUpdated: string;
+    /** USD equivalent (totalGems / 100) */
+    usdEquivalent: number;
+    /** Conversion rate (gems per $1) */
+    conversionRate: number;
+}
+/**
+ * Gem history item type
+ */
+type GemHistoryType = "earn" | "spend" | "expire";
+/**
+ * Gem history item
+ */
+interface GemHistoryItem {
+    /** Transaction ID */
+    id: string;
+    /** Type of transaction */
+    type: GemHistoryType;
+    /** Amount of gems (positive for earn, negative for spend) */
+    amount: number;
+    /** Source type (for earn transactions) */
+    source?: GemSource;
+    /** Reason description (for spend transactions) */
+    reason?: string;
+    /** When the transaction occurred */
+    createdAt: string;
+    /** When the gems expire (for earn transactions) */
+    expiresAt?: string;
+}
+/**
+ * Get gem history response
+ */
+interface GetGemHistoryResponse {
+    /** History items */
+    items: GemHistoryItem[];
+    /** Total count of items */
+    total: number;
+    /** Pagination info */
+    pagination: {
+        /** Items per page */
+        limit: number;
+        /** Current offset */
+        offset: number;
+        /** Whether more items exist */
+        hasMore: boolean;
+    };
+}
+/**
+ * Expiring gem batch
+ */
+interface ExpiringGemBatch {
+    /** Batch ID */
+    id: string;
+    /** Remaining gems in batch */
+    amount: number;
+    /** How the gems were earned */
+    source: GemSource;
+    /** When the batch expires */
+    expiresAt: string;
+    /** When the batch was created */
+    createdAt: string;
+    /** Days until expiry */
+    daysUntilExpiry: number;
+}
+/**
+ * Get expiring gems response
+ */
+interface GetExpiringGemsResponse {
+    /** Total gems expiring within the query period */
+    totalExpiring: number;
+    /** Expiring batches */
+    batches: ExpiringGemBatch[];
+    /** Query parameters used */
+    queryParams: {
+        /** Days ahead that were queried */
+        days: number;
+    };
+}
+/**
+ * User's browsing location for geo-based product filtering
+ */
+interface BrowsingLocation {
+    /** Location ID */
+    id: string;
+    /** Full display address */
+    formattedAddress: string;
+    /** City name */
+    city: string;
+    /** State/Province (if applicable) */
+    stateProvince?: string | null;
+    /** ISO 2-letter country code */
+    country: string;
+    /** Latitude coordinate */
+    latitude: number;
+    /** Longitude coordinate */
+    longitude: number;
+    /** Last updated timestamp */
+    updatedAt: string;
+}
+/**
+ * Get browsing location response
+ */
+interface GetBrowsingLocationResponse {
+    /** User's saved browsing location (null if not set) */
+    location: BrowsingLocation | null;
+}
+/**
+ * Save browsing location response
+ */
+interface SaveBrowsingLocationResponse {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** The saved location */
+    location: BrowsingLocation;
+}
+/**
+ * Delete browsing location response
+ */
+interface DeleteBrowsingLocationResponse {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Success message */
+    message: string;
+}
+
 /**
  * Customer/End-User Ecommerce API Client
  *
@@ -2922,6 +3412,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
      *
@@ -3135,6 +3648,146 @@ declare class CustomerEcommerceClient extends BaseEcommerceClient {
      * ```
      */
     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>;
+    /**
+     * Get user's gem balance
+     *
+     * Returns the current gem balance including total gems, available gems,
+     * and gems expiring soon. Gems are earned at 100 per $1 of revenue.
+     *
+     * @returns Current gem balance with USD equivalent
+     *
+     * @example
+     * ```typescript
+     * const balance = await client.getGemBalance();
+     * console.log(`You have ${balance.totalGems} gems (${balance.usdEquivalent} USD)`);
+     * console.log(`${balance.expiringSoon} gems expiring soon`);
+     * ```
+     */
+    getGemBalance(): Promise<GetGemBalanceResponse>;
+    /**
+     * Get gem transaction history
+     *
+     * Returns paginated history of gem transactions including earning,
+     * spending, and expiration events.
+     *
+     * @param params - Query parameters for filtering and pagination
+     * @returns Paginated gem history
+     *
+     * @example
+     * ```typescript
+     * // Get all history
+     * const history = await client.getGemHistory({ limit: 20, offset: 0 });
+     *
+     * // Get only earned gems
+     * const earned = await client.getGemHistory({ type: "earn", limit: 10 });
+     *
+     * // Get only spent gems
+     * const spent = await client.getGemHistory({ type: "spend", limit: 10 });
+     *
+     * history.items.forEach(item => {
+     *   console.log(`${item.type}: ${item.amount} gems - ${item.createdAt}`);
+     * });
+     * ```
+     */
+    getGemHistory(params?: GetGemHistoryParams): Promise<GetGemHistoryResponse>;
+    /**
+     * Get gems that are expiring soon
+     *
+     * Returns gem batches that will expire within the specified number of days.
+     * Useful for prompting users to spend gems before they expire.
+     *
+     * @param params - Query parameters (days: default 30, max 180)
+     * @returns Expiring gem batches with countdown info
+     *
+     * @example
+     * ```typescript
+     * // Get gems expiring in next 30 days (default)
+     * const expiring = await client.getExpiringGems();
+     *
+     * // Get gems expiring in next 7 days
+     * const urgent = await client.getExpiringGems({ days: 7 });
+     *
+     * if (expiring.totalExpiring > 0) {
+     *   console.log(`${expiring.totalExpiring} gems expiring soon!`);
+     *   expiring.batches.forEach(batch => {
+     *     console.log(`${batch.amount} gems expire in ${batch.daysUntilExpiry} days`);
+     *   });
+     * }
+     * ```
+     */
+    getExpiringGems(params?: GetExpiringGemsParams): Promise<GetExpiringGemsResponse>;
+    /**
+     * Get user's browsing location
+     *
+     * Returns the user's saved delivery location for geo-based product filtering.
+     * This location is used to show products from merchants that ship to the area.
+     *
+     * @returns Current browsing location or null if not set
+     *
+     * @example
+     * ```typescript
+     * const result = await client.getBrowsingLocation();
+     * if (result.location) {
+     *   console.log(`Delivery to: ${result.location.city}, ${result.location.country}`);
+     * }
+     * ```
+     */
+    getBrowsingLocation(): Promise<GetBrowsingLocationResponse>;
+    /**
+     * Save user's browsing location
+     *
+     * Sets the user's delivery location for geo-based product filtering.
+     * Products will be filtered to show only items from merchants that ship to this location.
+     *
+     * @param request - Location data from Google Places or manual input
+     * @returns The saved location
+     *
+     * @example
+     * ```typescript
+     * const result = await client.saveBrowsingLocation({
+     *   formattedAddress: "Singapore, Singapore",
+     *   city: "Singapore",
+     *   country: "SG",
+     *   latitude: 1.3521,
+     *   longitude: 103.8198
+     * });
+     * console.log(`Location saved: ${result.location.formattedAddress}`);
+     * ```
+     */
+    saveBrowsingLocation(request: SaveBrowsingLocationRequest): Promise<SaveBrowsingLocationResponse>;
+    /**
+     * Clear user's browsing location
+     *
+     * Removes the user's saved delivery location. Products will no longer
+     * be filtered by shipping destination.
+     *
+     * @returns Success response
+     *
+     * @example
+     * ```typescript
+     * await client.clearBrowsingLocation();
+     * console.log("Location cleared - showing all products");
+     * ```
+     */
+    clearBrowsingLocation(): Promise<DeleteBrowsingLocationResponse>;
 }
 
 /**
@@ -3616,6 +4269,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
      *
@@ -4111,6 +4924,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;
 }
 
 /**
@@ -4189,4 +5502,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 FollowActionResponse, type FollowStatusResponse, type FollowedMerchantSummary, 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 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 ListTaxNexusResponse, type ListTaxReportsParams, type ListTaxReportsResponse, type ListTaxRulesResponse, type MediaAsset, type MediaAssetResponse, type Merchant, MerchantEcommerceClient, type MerchantProductsResponse, 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 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, 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 BrowsingLocation, 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, type DeleteBrowsingLocationResponse, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, type EcommerceClientConfig, type ExpiringGemBatch, type FlashSale, type FlashSaleItem, type FlashSaleItemInput, type FollowActionResponse, type FollowStatusResponse, type FollowedMerchantSummary, type GemHistoryItem, type GemHistoryType, type GemHistoryTypeFilter, type GemSource, type GenerateTaxReportRequest, type GetAnalyticsParams, type GetAnalyticsResponse, type GetBrowsingLocationResponse, type GetCouponResponse, type GetExpiringGemsParams, type GetExpiringGemsResponse, type GetGemBalanceResponse, type GetGemHistoryParams, type GetGemHistoryResponse, 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 SaveBrowsingLocationRequest, type SaveBrowsingLocationResponse, 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 };