@basedone/core 0.2.1 → 0.2.3

package/dist/index.mjs

@@ -1,4 +1,4 @@
-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-MVFO4WRF.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-SKX4VGEN.mjs';
 export { AssetIdUtils, InstrumentClient } from './chunk-VBC6EQ7Q.mjs';
 import { __glob } from './chunk-4UEJOM6W.mjs';
 import Decimal, { Decimal as Decimal$1 } from 'decimal.js';
@@ -1297,6 +1297,12 @@ function getLatestCompletedWeek(currentTimestamp, offset = 0, weekStartsOn = 4 /
   const weekNumber = Math.round(msSinceWeek1 / WEEK_IN_MS) + 1;
   return { weekNumber, startDate, endDate };
 }
+function getWeekInfoFromNumber(weekNumber, weekStartsOn = 4 /* Thursday */) {
+  const week1StartDate = new Date(process.env.WEEK1_START_DATE || "2025-12-04T00:00:00Z");
+  const startDate = new Date(week1StartDate.getTime() + (weekNumber - 1) * WEEK_IN_MS);
+  const endDate = new Date(startDate.getTime() + WEEK_IN_MS);
+  return { weekNumber, startDate, endDate };
+}
 
 // lib/hip3/market-info.ts
 async function getAllPerpsMeta(infoClient) {
@@ -1305,4 +1311,4 @@ async function getAllPerpsMeta(infoClient) {
   });
 }
 
-export { CloidClientCode, CloidClientCodeNameById, DayOfWeek, MetadataClient, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, USDC_SPOT_TOKEN, UserDexAbstractionTypes, WidgetType, WidgetTypeById, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getAllPerpsMeta, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, stableQuoteTokens };
+export { CloidClientCode, CloidClientCodeNameById, DayOfWeek, MetadataClient, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, USDC_SPOT_TOKEN, UserDexAbstractionTypes, WidgetType, WidgetTypeById, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getAllPerpsMeta, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, stableQuoteTokens };

package/lib/ecommerce/QUICK_REFERENCE.md

@@ -57,6 +57,16 @@ await client.createReview("prod_123", {
   comment: "Love it!",
 });
 
+// Shop Following
+const followStatus = await client.isFollowingMerchant("merchant_123");
+await client.followMerchant("merchant_123");
+await client.unfollowMerchant("merchant_123");
+const following = await client.getFollowedMerchants({ limit: 20 });
+
+// Merchant Profile & Products (public)
+const merchant = await client.getMerchantProfile("merchant_123");
+const products = await client.getMerchantProducts("merchant_123", { sortBy: "popular" });
+
 // Calculate discounts
 const discounts = await client.calculateCartDiscounts({
   items: [{ productId: "prod_123", quantity: 2 }],
@@ -67,6 +77,17 @@ const tax = await client.calculateTax({
   items: [{ productId: "prod_123", quantity: 2 }],
   shippingAddress: { country: "US", region: "NY" },
 });
+
+// Get merchant storefront profile
+const merchant = await client.getMerchantProfile("merchant_123");
+console.log(merchant.merchant.name, merchant.merchant.productCount);
+
+// List merchant products with search/sort
+const merchantProducts = await client.getMerchantProducts("merchant_123", {
+  search: "laptop",
+  sortBy: "popular",
+  limit: 20,
+});
 ```
 
 ## Merchant Client
@@ -200,6 +221,11 @@ import type {
   PaymentMethod,
   CreateOrderRequest,
   ListProductsParams,
+  // Merchant storefront types
+  PublicMerchantProfile,
+  PublicMerchantProfileResponse,
+  MerchantProductsResponse,
+  ListMerchantProductsParams,
 } from "@basedone/core/ecommerce";
 ```
 

package/lib/ecommerce/README.md

@@ -68,6 +68,17 @@ if (order.escrow) {
   // After depositing, confirm the transaction
   await client.confirmEscrowDeposit(order.orders[0].id);
 }
+
+// Browse a merchant's storefront
+const merchantProfile = await client.getMerchantProfile("merchant_123");
+console.log(`${merchantProfile.merchant.name} - ${merchantProfile.merchant.productCount} products`);
+
+// Get merchant products with search and sort
+const merchantProducts = await client.getMerchantProducts("merchant_123", {
+  search: "laptop",
+  sortBy: "popular", // popular, latest, top_sales, price_asc, price_desc, rating
+  limit: 20,
+});
 ```
 
 ### Merchant Client
@@ -142,6 +153,16 @@ await client.updateOrderStatus("ord_123", {
 - `getActiveBanners(params?)` - Get active promotional banners
 - `trackBanner(bannerId, request)` - Track banner impression/click
 
+#### Merchant Storefront (Public)
+- `getMerchantProfile(merchantId)` - Get public merchant profile
+- `getMerchantProducts(merchantId, params?)` - Get merchant's products with filtering
+
+#### Shop Following
+- `isFollowingMerchant(merchantId)` - Check if following a merchant
+- `followMerchant(merchantId)` - Follow a merchant
+- `unfollowMerchant(merchantId)` - Unfollow a merchant
+- `getFollowedMerchants(params?)` - Get list of followed merchants
+
 ### Merchant APIs
 
 #### Profile
@@ -319,6 +340,11 @@ import type {
   PaymentMethod,
   CreateOrderRequest,
   ListProductsParams,
+  // Merchant storefront types
+  PublicMerchantProfile,
+  PublicMerchantProfileResponse,
+  MerchantProductsResponse,
+  ListMerchantProductsParams,
   // ... and many more
 } from "@basedone/core/ecommerce";
 ```

package/lib/ecommerce/client/base.ts

@@ -33,6 +33,9 @@ export interface EcommerceClientConfig {
   
   /** Enable automatic retry on retryable errors */
   enableRetry?: boolean;
+
+  /** Whether to send cookies with requests */
+  withCredentials?: boolean;
 }
 
 /**
@@ -55,9 +58,10 @@ export interface EcommerceClientConfig {
  */
 export class BaseEcommerceClient {
   private axiosInstance: AxiosInstance;
-  private config: Required<Omit<EcommerceClientConfig, "authToken" | "headers">> & {
+  private config: Required<Omit<EcommerceClientConfig, "authToken" | "headers" | "withCredentials">> & {
     authToken?: string;
     headers?: Record<string, string>;
+    withCredentials?: boolean;
   };
 
   constructor(config: EcommerceClientConfig) {
@@ -69,11 +73,13 @@ export class BaseEcommerceClient {
       retryBaseDelay: config.retryBaseDelay || 1000,
       headers: config.headers,
       enableRetry: config.enableRetry !== false,
+      withCredentials: config.withCredentials || false,
     };
 
     this.axiosInstance = axios.create({
       baseURL: this.config.baseURL,
       timeout: this.config.timeout,
+      withCredentials: this.config.withCredentials,
       headers: {
         "Content-Type": "application/json",
         ...this.config.headers,

package/lib/ecommerce/client/customer.ts

@@ -22,6 +22,9 @@ import type {
   TrackBannerRequest,
   SendMessageRequest,
   ListActiveFlashSalesParams,
+  ListMerchantProductsParams,
+  ListFollowingParams,
+  CalculateShippingRequest,
   
   // Response types
   ListProductsResponse,
@@ -45,6 +48,13 @@ import type {
   MessageStatsResponse,
   MessageResponse,
   ActiveFlashSalesResponse,
+  GetPaymentMethodsResponse,
+  PublicMerchantProfileResponse,
+  MerchantProductsResponse,
+  FollowStatusResponse,
+  FollowActionResponse,
+  ListFollowingResponse,
+  CalculateShippingResponse,
 } from "../types";
 
 /**
@@ -481,6 +491,36 @@ export class CustomerEcommerceClient extends BaseEcommerceClient {
   async calculateTax(request: CalculateTaxRequest): Promise<CalculateTaxResponse> {
     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: CalculateShippingRequest): Promise<CalculateShippingResponse> {
+    return this.post("/api/marketplace/shipping/calculate", request);
+  }
   
   // ============================================================================
   // Banners API
@@ -635,5 +675,155 @@ export class CustomerEcommerceClient extends BaseEcommerceClient {
     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: string): Promise<PublicMerchantProfileResponse> {
+    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: string,
+    params?: ListMerchantProductsParams
+  ): Promise<MerchantProductsResponse> {
+    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: string): Promise<FollowStatusResponse> {
+    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: string): Promise<FollowActionResponse> {
+    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: string): Promise<FollowActionResponse> {
+    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?: ListFollowingParams): Promise<ListFollowingResponse> {
+    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(): Promise<GetPaymentMethodsResponse> {
+    return this.get("/api/marketplace/payments/methods");
+  }
 }