@basedone/core 0.2.2 → 0.2.3

package/dist/index.js

@@ -42086,6 +42086,12 @@ function getLatestCompletedWeek(currentTimestamp, offset = 0, weekStartsOn = 4 /
   const weekNumber = Math.round(msSinceWeek1 / WEEK_IN_MS) + 1;
   return { weekNumber, startDate, endDate };
 }
+function getWeekInfoFromNumber(weekNumber, weekStartsOn = 4 /* Thursday */) {
+  const week1StartDate = new Date(process.env.WEEK1_START_DATE || "2025-12-04T00:00:00Z");
+  const startDate = new Date(week1StartDate.getTime() + (weekNumber - 1) * WEEK_IN_MS);
+  const endDate = new Date(startDate.getTime() + WEEK_IN_MS);
+  return { weekNumber, startDate, endDate };
+}
 
 // lib/hip3/market-info.ts
 async function getAllPerpsMeta(infoClient) {
@@ -42460,11 +42466,13 @@ var BaseEcommerceClient = class {
       maxRetries: config.maxRetries || 3,
       retryBaseDelay: config.retryBaseDelay || 1e3,
       headers: config.headers,
-      enableRetry: config.enableRetry !== false
+      enableRetry: config.enableRetry !== false,
+      withCredentials: config.withCredentials || false
     };
     this.axiosInstance = axios__default.default.create({
       baseURL: this.config.baseURL,
       timeout: this.config.timeout,
+      withCredentials: this.config.withCredentials,
       headers: {
         "Content-Type": "application/json",
         ...this.config.headers
@@ -43008,6 +43016,34 @@ var CustomerEcommerceClient = class extends BaseEcommerceClient {
     return this.post("/api/marketplace/tax/calculate", request);
   }
   // ============================================================================
+  // Shipping Calculation API
+  // ============================================================================
+  /**
+   * 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);
+   * });
+   * ```
+   */
+  async calculateShippingOptions(request) {
+    return this.post("/api/marketplace/shipping/calculate", request);
+  }
+  // ============================================================================
   // Banners API
   // ============================================================================
   /**
@@ -43265,6 +43301,29 @@ var CustomerEcommerceClient = class extends BaseEcommerceClient {
     const queryString = params ? buildQueryString(params) : "";
     return this.get(`/api/marketplace/following${queryString}`);
   }
+  // ============================================================================
+  // Payment Methods
+  // ============================================================================
+  /**
+   * 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}`);
+   *   });
+   * }
+   * ```
+   */
+  async getPaymentMethods() {
+    return this.get("/api/marketplace/payments/methods");
+  }
 };
 
 // lib/ecommerce/client/merchant.ts
@@ -43799,6 +43858,192 @@ var MerchantEcommerceClient = class extends BaseEcommerceClient {
     return this.patch(`/api/marketplace/merchant/shipping/shipments/${shipmentId}`, request);
   }
   // ============================================================================
+  // Shipping Settings (Zones & Rates)
+  // ============================================================================
+  /**
+   * Get merchant shipping settings
+   * 
+   * @returns Shipping settings
+   * 
+   * @example
+   * ```typescript
+   * const { settings } = await client.getShippingSettings();
+   * console.log("Handling fee:", settings.defaultHandlingFee);
+   * ```
+   */
+  async getShippingSettings() {
+    return this.get("/api/marketplace/merchant/shipping/settings");
+  }
+  /**
+   * Update merchant shipping settings
+   * 
+   * @param request - Settings to update
+   * @returns Updated settings
+   * 
+   * @example
+   * ```typescript
+   * await client.updateShippingSettings({
+   *   defaultHandlingFee: 2.50,
+   *   freeShippingEnabled: true,
+   *   freeShippingThreshold: 100
+   * });
+   * ```
+   */
+  async updateShippingSettings(request) {
+    return this.post("/api/marketplace/merchant/shipping/settings", request);
+  }
+  /**
+   * 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"));
+   * ```
+   */
+  async listShippingZones() {
+    return this.get("/api/marketplace/merchant/shipping/zones");
+  }
+  /**
+   * 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");
+   * ```
+   */
+  async getShippingZone(zoneId) {
+    return this.get(`/api/marketplace/merchant/shipping/zones/${zoneId}`);
+  }
+  /**
+   * 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
+   * });
+   * ```
+   */
+  async createShippingZone(request) {
+    return this.post("/api/marketplace/merchant/shipping/zones", request);
+  }
+  /**
+   * 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"]
+   * });
+   * ```
+   */
+  async updateShippingZone(zoneId, request) {
+    return this.put(`/api/marketplace/merchant/shipping/zones/${zoneId}`, request);
+  }
+  /**
+   * Delete a shipping zone
+   * 
+   * @param zoneId - Zone ID
+   * @returns Success response
+   * 
+   * @example
+   * ```typescript
+   * await client.deleteShippingZone("zone_123");
+   * ```
+   */
+  async deleteShippingZone(zoneId) {
+    return this.delete(`/api/marketplace/merchant/shipping/zones/${zoneId}`);
+  }
+  /**
+   * 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");
+   * ```
+   */
+  async listShippingRates(zoneId) {
+    const query = zoneId ? `?zoneId=${zoneId}` : "";
+    return this.get(`/api/marketplace/merchant/shipping/rates${query}`);
+  }
+  /**
+   * 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
+   * });
+   * ```
+   */
+  async createShippingRate(request) {
+    return this.post("/api/marketplace/merchant/shipping/rates", request);
+  }
+  /**
+   * 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
+   * });
+   * ```
+   */
+  async updateShippingRate(rateId, request) {
+    return this.put(`/api/marketplace/merchant/shipping/rates/${rateId}`, request);
+  }
+  /**
+   * Delete a shipping rate
+   * 
+   * @param rateId - Rate ID
+   * @returns Success response
+   * 
+   * @example
+   * ```typescript
+   * await client.deleteShippingRate("rate_123");
+   * ```
+   */
+  async deleteShippingRate(rateId) {
+    return this.delete(`/api/marketplace/merchant/shipping/rates/${rateId}`);
+  }
+  // ============================================================================
   // Returns & Refunds
   // ============================================================================
   /**
@@ -44396,6 +44641,223 @@ var MerchantEcommerceClient = class extends BaseEcommerceClient {
   async exportTaxReport(reportId) {
     return this.get(`/api/marketplace/merchant/tax-reports/${reportId}/export`);
   }
+  // ============================================
+  // DROPSHIPPING APIs
+  // ============================================
+  /**
+   * List connected dropship suppliers
+   * 
+   * @returns Connected and available suppliers
+   * 
+   * @example
+   * ```typescript
+   * const { connected, available } = await client.listDropshipSuppliers();
+   * ```
+   */
+  async listDropshipSuppliers() {
+    return this.get("/api/marketplace/merchant/dropship/suppliers");
+  }
+  /**
+   * 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"
+   * });
+   * ```
+   */
+  async connectDropshipSupplier(request) {
+    return this.post("/api/marketplace/merchant/dropship/suppliers", request);
+  }
+  /**
+   * Update dropship supplier settings
+   * 
+   * @param supplierId - Supplier ID
+   * @param request - Settings to update
+   * @returns Updated supplier
+   */
+  async updateDropshipSupplier(supplierId, request) {
+    return this.put(`/api/marketplace/merchant/dropship/suppliers/${supplierId}`, request);
+  }
+  /**
+   * Disconnect a dropship supplier
+   * 
+   * @param supplierId - Supplier ID
+   */
+  async disconnectDropshipSupplier(supplierId) {
+    return this.delete(`/api/marketplace/merchant/dropship/suppliers/${supplierId}`);
+  }
+  /**
+   * 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
+   * });
+   * ```
+   */
+  async searchDropshipProducts(request) {
+    return this.post("/api/marketplace/merchant/dropship/search", request);
+  }
+  /**
+   * Get dropship supplier categories
+   * 
+   * @param supplierId - Supplier ID
+   * @returns Category list
+   */
+  async getDropshipCategories(supplierId) {
+    return this.get(`/api/marketplace/merchant/dropship/categories?supplierId=${supplierId}`);
+  }
+  /**
+   * Get detailed product info from supplier
+   * 
+   * @param supplierId - Supplier ID
+   * @param externalProductId - Supplier's product ID
+   * @returns Product details with suggested pricing
+   */
+  async getDropshipProductDetails(supplierId, externalProductId) {
+    return this.get(
+      `/api/marketplace/merchant/dropship/products/${encodeURIComponent(externalProductId)}?supplierId=${supplierId}`
+    );
+  }
+  /**
+   * 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"
+   * });
+   * ```
+   */
+  async importDropshipProduct(request) {
+    return this.post("/api/marketplace/merchant/dropship/import", request);
+  }
+  /**
+   * Bulk import products from supplier
+   * 
+   * @param request - Bulk import parameters
+   * @returns Import results
+   */
+  async bulkImportDropshipProducts(request) {
+    return this.post("/api/marketplace/merchant/dropship/import", request);
+  }
+  /**
+   * List imported dropship products
+   * 
+   * @param params - Filter parameters
+   * @returns Imported products list
+   */
+  async listDropshipProducts(params) {
+    const query = params ? `?${buildQueryString(params)}` : "";
+    return this.get(`/api/marketplace/merchant/dropship/import${query}`);
+  }
+  /**
+   * List dropship order links
+   * 
+   * @param params - Filter parameters
+   * @returns Order links with status summary
+   */
+  async listDropshipOrders(params) {
+    let query = "";
+    if (params) {
+      const queryParams = {};
+      if (params.status) {
+        queryParams.status = Array.isArray(params.status) ? params.status.join(",") : params.status;
+      }
+      if (params.limit) queryParams.limit = params.limit.toString();
+      if (params.offset) queryParams.offset = params.offset.toString();
+      query = `?${buildQueryString(queryParams)}`;
+    }
+    return this.get(`/api/marketplace/merchant/dropship/orders${query}`);
+  }
+  /**
+   * Forward orders to supplier
+   * 
+   * @param orderItemIds - Order item IDs to forward
+   * @returns Forward results
+   */
+  async forwardDropshipOrders(orderItemIds) {
+    return this.post("/api/marketplace/merchant/dropship/orders", {
+      action: "forward",
+      orderItemIds
+    });
+  }
+  /**
+   * Sync tracking for all pending dropship orders
+   * 
+   * @returns Sync results
+   */
+  async syncDropshipTracking() {
+    return this.post("/api/marketplace/merchant/dropship/orders", {
+      action: "sync"
+    });
+  }
+  /**
+   * Get order forwarding details for manual forwarding
+   * 
+   * @param orderItemId - Order item ID
+   * @returns Forwarding details
+   */
+  async getDropshipOrderDetails(orderItemId) {
+    return this.get(`/api/marketplace/merchant/dropship/orders/${orderItemId}/forward`);
+  }
+  /**
+   * Forward a single order item to supplier
+   * 
+   * @param orderItemId - Order item ID
+   * @returns Forward result
+   */
+  async forwardDropshipOrder(orderItemId) {
+    return this.post(`/api/marketplace/merchant/dropship/orders/${orderItemId}/forward`, {});
+  }
+  /**
+   * Get dropship settings
+   * 
+   * @returns Merchant dropship settings
+   */
+  async getDropshipSettings() {
+    return this.get("/api/marketplace/merchant/dropship/settings");
+  }
+  /**
+   * Update dropship settings
+   * 
+   * @param request - Settings to update
+   * @returns Updated settings
+   */
+  async updateDropshipSettings(request) {
+    return this.put("/api/marketplace/merchant/dropship/settings", request);
+  }
+  /**
+   * Sync dropship products and/or orders
+   * 
+   * @param type - Sync type (products, orders, all, single)
+   * @param dropshipProductId - For single product sync
+   * @returns Sync results
+   */
+  async syncDropship(type, dropshipProductId) {
+    return this.post("/api/marketplace/merchant/dropship/sync", {
+      type,
+      dropshipProductId
+    });
+  }
 };
 
 // lib/ecommerce/types/enums.ts
@@ -44413,6 +44875,8 @@ var OrderStatus = /* @__PURE__ */ ((OrderStatus2) => {
 })(OrderStatus || {});
 var PaymentMethod = /* @__PURE__ */ ((PaymentMethod2) => {
   PaymentMethod2["USDC_ESCROW"] = "USDC_ESCROW";
+  PaymentMethod2["BASEDPAY"] = "BASEDPAY";
+  PaymentMethod2["STRIPE"] = "STRIPE";
   PaymentMethod2["POINTS"] = "POINTS";
   return PaymentMethod2;
 })(PaymentMethod || {});
@@ -44605,6 +45069,7 @@ exports.getNextTierInfo = getNextTierInfo;
 exports.getPriceDecimals = getPriceDecimals;
 exports.getStaticCollateralTokenByDex = getStaticCollateralTokenByDex;
 exports.getStaticCollateralTokenSymbol = getStaticCollateralTokenSymbol;
+exports.getWeekInfoFromNumber = getWeekInfoFromNumber;
 exports.getWidgetTypeById = getWidgetTypeById;
 exports.isBasedCloid = isBasedCloid;
 exports.isClientCode = isClientCode;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { BannerType, BaseEcommerceClient, CustomerEcommerceClient, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, InventoryAuditAction, MerchantEcommerceClient, MerchantStatus, OrderStatus, PaymentMethod, PaymentStatus, ProductSortBy, ReturnStatus, ReviewSortBy, ReviewStatus, ShipmentStatus, SortOrder, TaxBehavior, TaxReportPeriodType, TaxReportStatus, TaxType, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './chunk-Z5OW2FDP.mjs';
+export { BannerType, BaseEcommerceClient, CustomerEcommerceClient, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, InventoryAuditAction, MerchantEcommerceClient, MerchantStatus, OrderStatus, PaymentMethod, PaymentStatus, ProductSortBy, ReturnStatus, ReviewSortBy, ReviewStatus, ShipmentStatus, SortOrder, TaxBehavior, TaxReportPeriodType, TaxReportStatus, TaxType, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './chunk-SKX4VGEN.mjs';
 export { AssetIdUtils, InstrumentClient } from './chunk-VBC6EQ7Q.mjs';
 import { __glob } from './chunk-4UEJOM6W.mjs';
 import Decimal, { Decimal as Decimal$1 } from 'decimal.js';
@@ -1297,6 +1297,12 @@ function getLatestCompletedWeek(currentTimestamp, offset = 0, weekStartsOn = 4 /
   const weekNumber = Math.round(msSinceWeek1 / WEEK_IN_MS) + 1;
   return { weekNumber, startDate, endDate };
 }
+function getWeekInfoFromNumber(weekNumber, weekStartsOn = 4 /* Thursday */) {
+  const week1StartDate = new Date(process.env.WEEK1_START_DATE || "2025-12-04T00:00:00Z");
+  const startDate = new Date(week1StartDate.getTime() + (weekNumber - 1) * WEEK_IN_MS);
+  const endDate = new Date(startDate.getTime() + WEEK_IN_MS);
+  return { weekNumber, startDate, endDate };
+}
 
 // lib/hip3/market-info.ts
 async function getAllPerpsMeta(infoClient) {
@@ -1305,4 +1311,4 @@ async function getAllPerpsMeta(infoClient) {
   });
 }
 
-export { CloidClientCode, CloidClientCodeNameById, DayOfWeek, MetadataClient, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, USDC_SPOT_TOKEN, UserDexAbstractionTypes, WidgetType, WidgetTypeById, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getAllPerpsMeta, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, stableQuoteTokens };
+export { CloidClientCode, CloidClientCodeNameById, DayOfWeek, MetadataClient, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, USDC_SPOT_TOKEN, UserDexAbstractionTypes, WidgetType, WidgetTypeById, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getAllPerpsMeta, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, stableQuoteTokens };

package/lib/ecommerce/client/base.ts

@@ -33,6 +33,9 @@ export interface EcommerceClientConfig {
   
   /** Enable automatic retry on retryable errors */
   enableRetry?: boolean;
+
+  /** Whether to send cookies with requests */
+  withCredentials?: boolean;
 }
 
 /**
@@ -55,9 +58,10 @@ export interface EcommerceClientConfig {
  */
 export class BaseEcommerceClient {
   private axiosInstance: AxiosInstance;
-  private config: Required<Omit<EcommerceClientConfig, "authToken" | "headers">> & {
+  private config: Required<Omit<EcommerceClientConfig, "authToken" | "headers" | "withCredentials">> & {
     authToken?: string;
     headers?: Record<string, string>;
+    withCredentials?: boolean;
   };
 
   constructor(config: EcommerceClientConfig) {
@@ -69,11 +73,13 @@ export class BaseEcommerceClient {
       retryBaseDelay: config.retryBaseDelay || 1000,
       headers: config.headers,
       enableRetry: config.enableRetry !== false,
+      withCredentials: config.withCredentials || false,
     };
 
     this.axiosInstance = axios.create({
       baseURL: this.config.baseURL,
       timeout: this.config.timeout,
+      withCredentials: this.config.withCredentials,
       headers: {
         "Content-Type": "application/json",
         ...this.config.headers,

package/lib/ecommerce/client/customer.ts

@@ -24,6 +24,7 @@ import type {
   ListActiveFlashSalesParams,
   ListMerchantProductsParams,
   ListFollowingParams,
+  CalculateShippingRequest,
   
   // Response types
   ListProductsResponse,
@@ -47,11 +48,13 @@ import type {
   MessageStatsResponse,
   MessageResponse,
   ActiveFlashSalesResponse,
+  GetPaymentMethodsResponse,
   PublicMerchantProfileResponse,
   MerchantProductsResponse,
   FollowStatusResponse,
   FollowActionResponse,
   ListFollowingResponse,
+  CalculateShippingResponse,
 } from "../types";
 
 /**
@@ -488,6 +491,36 @@ export class CustomerEcommerceClient extends BaseEcommerceClient {
   async calculateTax(request: CalculateTaxRequest): Promise<CalculateTaxResponse> {
     return this.post("/api/marketplace/tax/calculate", request);
   }
+
+  // ============================================================================
+  // Shipping Calculation API
+  // ============================================================================
+
+  /**
+   * 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);
+   * });
+   * ```
+   */
+  async calculateShippingOptions(request: CalculateShippingRequest): Promise<CalculateShippingResponse> {
+    return this.post("/api/marketplace/shipping/calculate", request);
+  }
   
   // ============================================================================
   // Banners API
@@ -767,5 +800,30 @@ export class CustomerEcommerceClient extends BaseEcommerceClient {
     const queryString = params ? buildQueryString(params) : "";
     return this.get(`/api/marketplace/following${queryString}`);
   }
+
+  // ============================================================================
+  // Payment Methods
+  // ============================================================================
+
+  /**
+   * 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}`);
+   *   });
+   * }
+   * ```
+   */
+  async getPaymentMethods(): Promise<GetPaymentMethodsResponse> {
+    return this.get("/api/marketplace/payments/methods");
+  }
 }