@basedone/core 0.2.0 → 0.2.1

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

@@ -717,6 +717,110 @@ 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}`);
+  }
 };
 
 // lib/ecommerce/client/merchant.ts

package/dist/ecommerce.d.mts

@@ -1093,6 +1093,73 @@ interface CustomerSummary {
     /** First order date */
     firstOrderDate?: string;
 }
+/**
+ * Flash sale item entity
+ */
+interface FlashSaleItem {
+    /** Item ID */
+    id: string;
+    /** Product ID */
+    productId: string;
+    /** Sale price in USDC */
+    salePrice: string;
+    /** Original price in USDC */
+    originalPrice: string;
+    /** Discount percentage */
+    discountPercent: number;
+    /** Maximum quantity available at this price */
+    maxQuantity: number | null;
+    /** Quantity sold at flash price */
+    soldQuantity: number;
+    /** Remaining quantity */
+    remainingQuantity: number | null;
+    /** Limit per customer */
+    limitPerCustomer: number | null;
+    /** Product details */
+    product: {
+        id: string;
+        title: string;
+        description?: string | null;
+        images: string[];
+        priceUSDC: string;
+        inventory: number | null;
+        soldCount: number;
+        averageRating: number | null;
+        reviewCount: number;
+        merchant?: {
+            id: string;
+            name: string;
+        };
+    };
+}
+/**
+ * Flash sale entity
+ */
+interface FlashSale {
+    /** Flash sale ID */
+    id: string;
+    /** Sale name */
+    name: string;
+    /** Description */
+    description?: string | null;
+    /** Start timestamp */
+    startsAt: string;
+    /** End timestamp */
+    endsAt: string;
+    /** Badge text (e.g., "Mall", "Hot Deal") */
+    badgeText?: string | null;
+    /** Badge color (hex) */
+    badgeColor?: string | null;
+    /** Priority (higher = shown first) */
+    priority: number;
+    /** Merchant information */
+    merchant?: {
+        id: string;
+        name: string;
+    } | null;
+    /** Flash sale items */
+    items: FlashSaleItem[];
+}
 
 /**
  * Ecommerce API Request Types
@@ -1570,6 +1637,58 @@ interface ListActiveBannersParams {
     /** Filter by merchant ID */
     merchantId?: string;
 }
+/**
+ * List active flash sales params
+ */
+interface ListActiveFlashSalesParams {
+    /** Maximum number of flash sales to return */
+    limit?: number;
+    /** Filter by merchant ID */
+    merchantId?: string;
+}
+/**
+ * Flash sale item input
+ */
+interface FlashSaleItemInput {
+    /** Product ID */
+    productId: string;
+    /** Sale price in USDC */
+    salePrice: number;
+    /** Maximum quantity available */
+    maxQuantity?: number | null;
+    /** Limit per customer */
+    limitPerCustomer?: number;
+    /** Sort order */
+    sortOrder?: number;
+}
+/**
+ * Create flash sale request
+ */
+interface CreateFlashSaleRequest {
+    /** Sale name */
+    name: string;
+    /** Description */
+    description?: string | null;
+    /** Start timestamp */
+    startsAt: string;
+    /** End timestamp */
+    endsAt: string;
+    /** Badge text */
+    badgeText?: string;
+    /** Badge color (hex) */
+    badgeColor?: string;
+    /** Priority (higher = shown first) */
+    priority?: number;
+    /** Is active */
+    isActive?: boolean;
+    /** Flash sale items */
+    items?: FlashSaleItemInput[];
+}
+/**
+ * Update flash sale request
+ */
+interface UpdateFlashSaleRequest extends Partial<CreateFlashSaleRequest> {
+}
 
 /**
  * Ecommerce API Response Types
@@ -2019,6 +2138,38 @@ interface MessageResponse {
     /** Message */
     message: Message;
 }
+/**
+ * Customer messages response (for retail users)
+ *
+ * Groups messages by order, where each order represents a conversation with a merchant.
+ */
+interface CustomerMessagesResponse {
+    /** Conversations grouped by order */
+    conversations: Array<{
+        orderId: string;
+        orderNumber: string;
+        merchant: {
+            id: string;
+            name: string;
+            ownerUserId: string;
+        };
+        lastMessage: Message;
+        unreadCount: number;
+        messages: Message[];
+    }>;
+    /** Stats */
+    stats: {
+        total: number;
+        unread: number;
+    };
+}
+/**
+ * Message stats response (for notification badges)
+ */
+interface MessageStatsResponse {
+    /** Unread message count */
+    unread: number;
+}
 /**
  * Analytics overview
  */
@@ -2297,6 +2448,22 @@ interface CreateOrderEventResponse {
     /** Event */
     event: any;
 }
+/**
+ * Active flash sales response
+ */
+interface ActiveFlashSalesResponse {
+    /** Flash sales */
+    flashSales: FlashSale[];
+    /** Time remaining for the featured/first sale */
+    timeRemaining: {
+        /** End timestamp */
+        endsAt: string;
+        /** Remaining seconds */
+        remainingSeconds: number;
+    } | null;
+    /** Server time (for client-side sync) */
+    serverTime: string;
+}
 
 /**
  * Customer/End-User Ecommerce API Client
@@ -2675,6 +2842,93 @@ declare class CustomerEcommerceClient extends BaseEcommerceClient {
      * ```
      */
     trackBanner(bannerId: string, request: TrackBannerRequest): Promise<SuccessResponse>;
+    /**
+     * 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`);
+     * });
+     * ```
+     */
+    listMessages(): Promise<CustomerMessagesResponse>;
+    /**
+     * 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);
+     * ```
+     */
+    getMessageStats(): Promise<MessageStatsResponse>;
+    /**
+     * 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?"
+     * });
+     * ```
+     */
+    sendMessage(request: SendMessageRequest): Promise<MessageResponse>;
+    /**
+     * Mark a message as read
+     *
+     * @param messageId - Message ID
+     * @returns Updated message
+     *
+     * @example
+     * ```typescript
+     * await client.markMessageAsRead("msg_123");
+     * ```
+     */
+    markMessageAsRead(messageId: string): Promise<MessageResponse>;
+    /**
+     * 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`);
+     * }
+     * ```
+     */
+    getActiveFlashSales(params?: ListActiveFlashSalesParams): Promise<ActiveFlashSalesResponse>;
 }
 
 /**
@@ -3729,4 +3983,4 @@ declare function calculateDiscountAmount(price: number, discountType: "PERCENTAG
  */
 declare function calculateFinalPrice(price: number, discountType: "PERCENTAGE" | "FIXED_AMOUNT", discountValue: number): number;
 
-export { 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 CreateOrderEventRequest, type CreateOrderEventResponse, type CreateOrderRequest, type CreateOrderResponse, type CreateProductRequest, type CreateProductVariantRequest, type CreateReviewRequest, type CreateShippingMethodRequest, type CreateTaxNexusRequest, type CreateTaxRuleRequest, CustomerEcommerceClient, type CustomerSummary, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, type EcommerceClientConfig, type GenerateTaxReportRequest, type GetAnalyticsParams, type GetAnalyticsResponse, type GetCouponResponse, type GetOrderResponse, type GetProductMetricsResponse, type GetProductResponse, type GetTaxReportResponse, InventoryAuditAction, type InventoryAuditEntry, type ListActiveBannersParams, type ListBannersResponse, type ListCouponsResponse, type ListCustomersParams, type ListCustomersResponse, type ListInventoryAuditResponse, type ListMediaAssetsResponse, 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 MerchantProfileRequest, type MerchantProfileResponse, MerchantStatus, type Message, type MessageResponse, 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 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 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 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 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 ListInventoryAuditResponse, type ListMediaAssetsResponse, 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 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 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 };