@basedone/core 0.2.0 → 0.2.2

package/lib/ecommerce/types/entities.ts

@@ -720,3 +720,72 @@ export interface CustomerSummary {
   firstOrderDate?: string;
 }
 
+/**
+ * Flash sale item entity
+ */
+export 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
+ */
+export 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[];
+}
+

package/lib/ecommerce/types/requests.ts

@@ -523,3 +523,82 @@ export interface ListActiveBannersParams {
   merchantId?: string;
 }
 
+/**
+ * List active flash sales params
+ */
+export interface ListActiveFlashSalesParams {
+  /** Maximum number of flash sales to return */
+  limit?: number;
+  /** Filter by merchant ID */
+  merchantId?: string;
+}
+
+/**
+ * Flash sale item input
+ */
+export 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
+ */
+export 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
+ */
+export interface UpdateFlashSaleRequest extends Partial<CreateFlashSaleRequest> {}
+
+/**
+ * List merchant products params
+ */
+export interface ListMerchantProductsParams extends PaginationParams {
+  /** Search query */
+  search?: string;
+  /** Filter by category slug */
+  category?: string;
+  /** Minimum price */
+  minPrice?: number;
+  /** Maximum price */
+  maxPrice?: number;
+  /** Sort by: popular, latest, top_sales, price_asc, price_desc, rating */
+  sortBy?: "popular" | "latest" | "top_sales" | "price_asc" | "price_desc" | "rating";
+}
+
+/**
+ * List followed merchants params
+ */
+export interface ListFollowingParams extends PaginationParams {
+  /** Sort by: recent (default) or name */
+  sortBy?: "recent" | "name";
+}
+

package/lib/ecommerce/types/responses.ts

@@ -25,6 +25,7 @@ import {
   CustomerSummary,
   ProductVariant,
   CouponUsage,
+  FlashSale,
 } from "./entities";
 
 /**
@@ -339,6 +340,102 @@ export interface MerchantProfileResponse {
   merchant: Merchant;
 }
 
+/**
+ * Public merchant profile (for storefront)
+ */
+export interface PublicMerchantProfile {
+  /** Merchant ID */
+  id: string;
+  /** Merchant name */
+  name: string;
+  /** Description */
+  description: string | null;
+  /** Created at */
+  createdAt: string;
+  /** Number of active products */
+  productCount: number;
+  /** Total orders */
+  orderCount: number;
+  /** Average rating */
+  averageRating: number | null;
+  /** Total sold count */
+  totalSold: number;
+  /** Total view count */
+  totalViews: number;
+  /** Review count */
+  reviewCount: number;
+  /** Follower count */
+  followerCount: number;
+  /** Categories the merchant sells in */
+  categories: string[];
+}
+
+/**
+ * Public merchant profile response
+ */
+export interface PublicMerchantProfileResponse {
+  /** Merchant */
+  merchant: PublicMerchantProfile;
+}
+
+/**
+ * Merchant products response
+ */
+export interface MerchantProductsResponse extends PaginatedResponse<Product> {
+  /** Merchant info */
+  merchant: {
+    id: string;
+    name: string;
+  };
+}
+
+/**
+ * Follow status response
+ */
+export interface FollowStatusResponse {
+  /** Whether the user is following */
+  isFollowing: boolean;
+  /** When the user followed (null if not following) */
+  followedAt: string | null;
+}
+
+/**
+ * Follow action response
+ */
+export interface FollowActionResponse {
+  /** Success flag */
+  success: boolean;
+  /** Human-readable message */
+  message: string;
+  /** Whether the user is now following */
+  isFollowing: boolean;
+  /** When the user followed (only for follow action) */
+  followedAt?: string;
+}
+
+/**
+ * Followed merchant summary
+ */
+export interface FollowedMerchantSummary {
+  /** When the user followed */
+  followedAt: string;
+  /** Merchant info */
+  merchant: {
+    id: string;
+    name: string;
+    description: string | null;
+    createdAt: string;
+    productCount: number;
+    averageRating: number | null;
+    totalSold: number;
+  };
+}
+
+/**
+ * List followed merchants response
+ */
+export interface ListFollowingResponse extends PaginatedResponse<FollowedMerchantSummary> {}
+
 /**
  * List coupons response
  */
@@ -504,6 +601,40 @@ export interface MessageResponse {
   message: Message;
 }
 
+/**
+ * Customer messages response (for retail users)
+ * 
+ * Groups messages by order, where each order represents a conversation with a merchant.
+ */
+export 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)
+ */
+export interface MessageStatsResponse {
+  /** Unread message count */
+  unread: number;
+}
+
 /**
  * Analytics overview
  */
@@ -803,3 +934,20 @@ export interface CreateOrderEventResponse {
   event: any;
 }
 
+/**
+ * Active flash sales response
+ */
+export 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;
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basedone/core",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Core utilities for Based One",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",