@basedone/core 0.2.2 → 0.2.4

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,10 @@ import type {
   ListActiveFlashSalesParams,
   ListMerchantProductsParams,
   ListFollowingParams,
+  CalculateShippingRequest,
+  GetGemHistoryParams,
+  GetExpiringGemsParams,
+  SaveBrowsingLocationRequest,
   
   // Response types
   ListProductsResponse,
@@ -47,11 +51,19 @@ import type {
   MessageStatsResponse,
   MessageResponse,
   ActiveFlashSalesResponse,
+  GetPaymentMethodsResponse,
   PublicMerchantProfileResponse,
   MerchantProductsResponse,
   FollowStatusResponse,
   FollowActionResponse,
   ListFollowingResponse,
+  CalculateShippingResponse,
+  GetGemBalanceResponse,
+  GetBrowsingLocationResponse,
+  SaveBrowsingLocationResponse,
+  DeleteBrowsingLocationResponse,
+  GetGemHistoryResponse,
+  GetExpiringGemsResponse,
 } from "../types";
 
 /**
@@ -488,6 +500,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 +809,180 @@ 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");
+  }
+
+  // ============================================================================
+  // GEM System API
+  // ============================================================================
+
+  /**
+   * 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`);
+   * ```
+   */
+  async getGemBalance(): Promise<GetGemBalanceResponse> {
+    return this.get("/api/gems/balance");
+  }
+
+  /**
+   * 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}`);
+   * });
+   * ```
+   */
+  async getGemHistory(params?: GetGemHistoryParams): Promise<GetGemHistoryResponse> {
+    const queryString = params ? buildQueryString(params) : "";
+    return this.get(`/api/gems/history${queryString}`);
+  }
+
+  /**
+   * 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`);
+   *   });
+   * }
+   * ```
+   */
+  async getExpiringGems(params?: GetExpiringGemsParams): Promise<GetExpiringGemsResponse> {
+    const queryString = params ? buildQueryString(params) : "";
+    return this.get(`/api/gems/expiring${queryString}`);
+  }
+
+  // ============================================================================
+  // Browsing Location API
+  // ============================================================================
+
+  /**
+   * 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}`);
+   * }
+   * ```
+   */
+  async getBrowsingLocation(): Promise<GetBrowsingLocationResponse> {
+    return this.get("/api/user/browsing-location");
+  }
+
+  /**
+   * 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}`);
+   * ```
+   */
+  async saveBrowsingLocation(request: SaveBrowsingLocationRequest): Promise<SaveBrowsingLocationResponse> {
+    return this.post("/api/user/browsing-location", request);
+  }
+
+  /**
+   * 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");
+   * ```
+   */
+  async clearBrowsingLocation(): Promise<DeleteBrowsingLocationResponse> {
+    return this.delete("/api/user/browsing-location");
+  }
 }