@basedone/core 0.2.3 → 0.2.5

package/lib/ecommerce/types/responses.ts

@@ -951,6 +951,36 @@ export interface ActiveFlashSalesResponse {
   serverTime: string;
 }
 
+/**
+ * Flash sale allowance info for a single product
+ */
+export interface FlashSaleAllowanceInfo {
+  /** Flash sale ID */
+  flashSaleId: string;
+  /** Limit per customer (null = no limit) */
+  limitPerCustomer: number | null;
+  /** Quantity already purchased by user */
+  purchased: number;
+  /** Remaining quantity user can purchase (null = no limit) */
+  remaining: number | null;
+  /** Current sale price */
+  salePrice: string;
+  /** Maximum quantity available in flash sale (null = unlimited) */
+  maxQuantity: number | null;
+  /** Remaining quantity in flash sale (null = unlimited) */
+  remainingQuantity: number | null;
+}
+
+/**
+ * Get flash sale allowance response
+ */
+export interface GetFlashSaleAllowanceResponse {
+  /** Allowances by product ID */
+  allowances: Record<string, FlashSaleAllowanceInfo>;
+  /** Whether user is authenticated */
+  authenticated: boolean;
+}
+
 // ============================================
 // SHIPPING RESPONSES
 // ============================================
@@ -1099,3 +1129,169 @@ export interface ProcessPaymentResponse {
   errorCode?: string;
 }
 
+// ============================================================================
+// GEM System Responses
+// ============================================================================
+
+/**
+ * Gem source type - how gems were earned
+ */
+export type GemSource = 
+  | "BUILDER_CODE"
+  | "PREDICTION"
+  | "CARD_SPEND"
+  | "MALL_SPEND"
+  | "ADMIN"
+  | "REFUND";
+
+/**
+ * Get gem balance response
+ */
+export interface GetGemBalanceResponse {
+  /** User ID */
+  userId: string;
+  /** Total gems owned */
+  totalGems: number;
+  /** Available gems (not reserved) */
+  availableGems: number;
+  /** Gems expiring within 30 days */
+  expiringSoon: number;
+  /** Last balance update timestamp */
+  lastUpdated: string;
+  /** USD equivalent (totalGems / 100) */
+  usdEquivalent: number;
+  /** Conversion rate (gems per $1) */
+  conversionRate: number;
+}
+
+/**
+ * Gem history item type
+ */
+export type GemHistoryType = "earn" | "spend" | "expire";
+
+/**
+ * Gem history item
+ */
+export interface GemHistoryItem {
+  /** Transaction ID */
+  id: string;
+  /** Type of transaction */
+  type: GemHistoryType;
+  /** Amount of gems (positive for earn, negative for spend) */
+  amount: number;
+  /** Source type (for earn transactions) */
+  source?: GemSource;
+  /** Reason description (for spend transactions) */
+  reason?: string;
+  /** When the transaction occurred */
+  createdAt: string;
+  /** When the gems expire (for earn transactions) */
+  expiresAt?: string;
+}
+
+/**
+ * Get gem history response
+ */
+export interface GetGemHistoryResponse {
+  /** History items */
+  items: GemHistoryItem[];
+  /** Total count of items */
+  total: number;
+  /** Pagination info */
+  pagination: {
+    /** Items per page */
+    limit: number;
+    /** Current offset */
+    offset: number;
+    /** Whether more items exist */
+    hasMore: boolean;
+  };
+}
+
+/**
+ * Expiring gem batch
+ */
+export interface ExpiringGemBatch {
+  /** Batch ID */
+  id: string;
+  /** Remaining gems in batch */
+  amount: number;
+  /** How the gems were earned */
+  source: GemSource;
+  /** When the batch expires */
+  expiresAt: string;
+  /** When the batch was created */
+  createdAt: string;
+  /** Days until expiry */
+  daysUntilExpiry: number;
+}
+
+/**
+ * Get expiring gems response
+ */
+export interface GetExpiringGemsResponse {
+  /** Total gems expiring within the query period */
+  totalExpiring: number;
+  /** Expiring batches */
+  batches: ExpiringGemBatch[];
+  /** Query parameters used */
+  queryParams: {
+    /** Days ahead that were queried */
+    days: number;
+  };
+}
+
+// ============================================================================
+// Browsing Location Responses
+// ============================================================================
+
+/**
+ * User's browsing location for geo-based product filtering
+ */
+export interface BrowsingLocation {
+  /** Location ID */
+  id: string;
+  /** Full display address */
+  formattedAddress: string;
+  /** City name */
+  city: string;
+  /** State/Province (if applicable) */
+  stateProvince?: string | null;
+  /** ISO 2-letter country code */
+  country: string;
+  /** Latitude coordinate */
+  latitude: number;
+  /** Longitude coordinate */
+  longitude: number;
+  /** Last updated timestamp */
+  updatedAt: string;
+}
+
+/**
+ * Get browsing location response
+ */
+export interface GetBrowsingLocationResponse {
+  /** User's saved browsing location (null if not set) */
+  location: BrowsingLocation | null;
+}
+
+/**
+ * Save browsing location response
+ */
+export interface SaveBrowsingLocationResponse {
+  /** Whether the operation was successful */
+  success: boolean;
+  /** The saved location */
+  location: BrowsingLocation;
+}
+
+/**
+ * Delete browsing location response
+ */
+export interface DeleteBrowsingLocationResponse {
+  /** Whether the operation was successful */
+  success: boolean;
+  /** Success message */
+  message: string;
+}
+

package/package.json

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