@basedone/core 0.2.2 → 0.2.4

package/dist/ecommerce.js

@@ -140,11 +140,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
@@ -688,6 +690,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
   // ============================================================================
   /**
@@ -945,6 +975,171 @@ 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");
+  }
+  // ============================================================================
+  // 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() {
+    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) {
+    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) {
+    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() {
+    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) {
+    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() {
+    return this.delete("/api/user/browsing-location");
+  }
 };
 
 // lib/ecommerce/client/merchant.ts
@@ -1479,6 +1674,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
   // ============================================================================
   /**
@@ -2076,6 +2457,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
@@ -2093,6 +2691,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 || {});
@@ -2203,6 +2803,7 @@ var ProductSortBy = /* @__PURE__ */ ((ProductSortBy2) => {
   ProductSortBy2["PRICE_DESC"] = "price_desc";
   ProductSortBy2["POPULAR"] = "popular";
   ProductSortBy2["FEATURED"] = "featured";
+  ProductSortBy2["NEARBY"] = "nearby";
   return ProductSortBy2;
 })(ProductSortBy || {});
 var ReviewSortBy = /* @__PURE__ */ ((ReviewSortBy2) => {

package/dist/ecommerce.mjs

@@ -1,2 +1,2 @@
-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-NVL2HX2H.mjs';
 import './chunk-4UEJOM6W.mjs';