@basedone/core 0.2.0 → 0.2.2

package/dist/{chunk-4GAKANLT.mjs → chunk-Z5OW2FDP.mjs}

@@ -717,6 +717,224 @@ var CustomerEcommerceClient = class extends BaseEcommerceClient {
   async trackBanner(bannerId, request) {
     return this.post(`/api/marketplace/banners/${bannerId}/track`, request);
   }
+  // ============================================================================
+  // Messages API
+  // ============================================================================
+  /**
+   * List messages for customer
+   * 
+   * Returns all conversations grouped by order, where each order represents
+   * a conversation with a merchant.
+   * 
+   * @returns List of conversations with messages and stats
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.listMessages();
+   * console.log("Unread:", result.stats.unread);
+   * result.conversations.forEach(conv => {
+   *   console.log(`Order ${conv.orderNumber}: ${conv.unreadCount} unread`);
+   * });
+   * ```
+   */
+  async listMessages() {
+    return this.get("/api/marketplace/messages");
+  }
+  /**
+   * Get message stats (unread count)
+   * 
+   * Lightweight endpoint for notification badges.
+   * 
+   * @returns Unread message count
+   * 
+   * @example
+   * ```typescript
+   * const stats = await client.getMessageStats();
+   * console.log("Unread messages:", stats.unread);
+   * ```
+   */
+  async getMessageStats() {
+    return this.get("/api/marketplace/messages/stats");
+  }
+  /**
+   * Send a message to a merchant about an order
+   * 
+   * @param request - Message data including orderId, recipientId (merchant user ID), and message
+   * @returns Sent message
+   * 
+   * @example
+   * ```typescript
+   * await client.sendMessage({
+   *   orderId: "ord_123",
+   *   recipientId: "user_merchant_456",
+   *   message: "When will my order ship?"
+   * });
+   * ```
+   */
+  async sendMessage(request) {
+    return this.post("/api/marketplace/messages/send", request);
+  }
+  /**
+   * Mark a message as read
+   * 
+   * @param messageId - Message ID
+   * @returns Updated message
+   * 
+   * @example
+   * ```typescript
+   * await client.markMessageAsRead("msg_123");
+   * ```
+   */
+  async markMessageAsRead(messageId) {
+    return this.patch(`/api/marketplace/messages/${messageId}/read`, {});
+  }
+  // ============================================================================
+  // Flash Sales API
+  // ============================================================================
+  /**
+   * Get active flash sales
+   * 
+   * Returns currently running flash sales with their discounted products.
+   * Includes countdown timer information for UI display.
+   * 
+   * @param params - Query parameters
+   * @returns List of active flash sales with time remaining
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.getActiveFlashSales({ limit: 5 });
+   * 
+   * result.flashSales.forEach(sale => {
+   *   console.log(`${sale.name} - ends at ${sale.endsAt}`);
+   *   sale.items.forEach(item => {
+   *     console.log(`  ${item.product.title}: $${item.salePrice} (${item.discountPercent}% off)`);
+   *   });
+   * });
+   * 
+   * // Use timeRemaining for countdown UI
+   * if (result.timeRemaining) {
+   *   console.log(`Featured sale ends in ${result.timeRemaining.remainingSeconds} seconds`);
+   * }
+   * ```
+   */
+  async getActiveFlashSales(params) {
+    const queryString = params ? buildQueryString(params) : "";
+    return this.get(`/api/marketplace/flash-sales/active${queryString}`);
+  }
+  // ============================================================================
+  // Merchant Storefront API
+  // ============================================================================
+  /**
+   * Get public merchant profile
+   * 
+   * Fetches public information about a merchant for the storefront page.
+   * 
+   * @param merchantId - Merchant ID
+   * @returns Public merchant profile with stats
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.getMerchantProfile("merchant_123");
+   * console.log(result.merchant.name, result.merchant.productCount);
+   * ```
+   */
+  async getMerchantProfile(merchantId) {
+    return this.get(`/api/marketplace/merchants/${merchantId}`);
+  }
+  /**
+   * List merchant products
+   * 
+   * Fetches products for a specific merchant with search, filter, and sort options.
+   * 
+   * @param merchantId - Merchant ID
+   * @param params - Query parameters for filtering and pagination
+   * @returns Paginated list of products
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.getMerchantProducts("merchant_123", {
+   *   search: "laptop",
+   *   sortBy: "popular",
+   *   limit: 20,
+   * });
+   * 
+   * result.items.forEach(product => {
+   *   console.log(product.title, product.priceUSDC);
+   * });
+   * ```
+   */
+  async getMerchantProducts(merchantId, params) {
+    const queryString = params ? buildQueryString(params) : "";
+    return this.get(`/api/marketplace/merchants/${merchantId}/products${queryString}`);
+  }
+  // ============================================================================
+  // Shop Following API
+  // ============================================================================
+  /**
+   * Check if following a merchant
+   * 
+   * @param merchantId - Merchant ID
+   * @returns Follow status with follow date if applicable
+   * 
+   * @example
+   * ```typescript
+   * const status = await client.isFollowingMerchant("merchant_123");
+   * if (status.isFollowing) {
+   *   console.log(`Following since ${status.followedAt}`);
+   * }
+   * ```
+   */
+  async isFollowingMerchant(merchantId) {
+    return this.get(`/api/marketplace/merchants/${merchantId}/follow`);
+  }
+  /**
+   * Follow a merchant
+   * 
+   * @param merchantId - Merchant ID to follow
+   * @returns Follow action result
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.followMerchant("merchant_123");
+   * console.log(result.message); // "Now following Awesome Store"
+   * ```
+   */
+  async followMerchant(merchantId) {
+    return this.post(`/api/marketplace/merchants/${merchantId}/follow`);
+  }
+  /**
+   * Unfollow a merchant
+   * 
+   * @param merchantId - Merchant ID to unfollow
+   * @returns Unfollow action result
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.unfollowMerchant("merchant_123");
+   * console.log(result.message); // "Unfollowed successfully"
+   * ```
+   */
+  async unfollowMerchant(merchantId) {
+    return this.delete(`/api/marketplace/merchants/${merchantId}/follow`);
+  }
+  /**
+   * Get list of followed merchants
+   * 
+   * @param params - Query parameters for pagination and sorting
+   * @returns Paginated list of followed merchants with their info
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.getFollowedMerchants({ limit: 20, sortBy: "recent" });
+   * result.items.forEach(item => {
+   *   console.log(`${item.merchant.name} - followed on ${item.followedAt}`);
+   * });
+   * ```
+   */
+  async getFollowedMerchants(params) {
+    const queryString = params ? buildQueryString(params) : "";
+    return this.get(`/api/marketplace/following${queryString}`);
+  }
 };
 
 // lib/ecommerce/client/merchant.ts