@basedone/core 0.2.1 → 0.2.2

package/dist/{chunk-MVFO4WRF.mjs → chunk-Z5OW2FDP.mjs}

@@ -821,6 +821,120 @@ var CustomerEcommerceClient = class 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) {
+    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

package/dist/ecommerce.d.mts

@@ -1689,6 +1689,28 @@ interface CreateFlashSaleRequest {
  */
 interface UpdateFlashSaleRequest extends Partial<CreateFlashSaleRequest> {
 }
+/**
+ * List merchant products params
+ */
+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
+ */
+interface ListFollowingParams extends PaginationParams {
+    /** Sort by: recent (default) or name */
+    sortBy?: "recent" | "name";
+}
 
 /**
  * Ecommerce API Response Types
@@ -1987,6 +2009,96 @@ interface MerchantProfileResponse {
     /** Merchant */
     merchant: Merchant;
 }
+/**
+ * Public merchant profile (for storefront)
+ */
+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
+ */
+interface PublicMerchantProfileResponse {
+    /** Merchant */
+    merchant: PublicMerchantProfile;
+}
+/**
+ * Merchant products response
+ */
+interface MerchantProductsResponse extends PaginatedResponse<Product> {
+    /** Merchant info */
+    merchant: {
+        id: string;
+        name: string;
+    };
+}
+/**
+ * Follow status response
+ */
+interface FollowStatusResponse {
+    /** Whether the user is following */
+    isFollowing: boolean;
+    /** When the user followed (null if not following) */
+    followedAt: string | null;
+}
+/**
+ * Follow action response
+ */
+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
+ */
+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
+ */
+interface ListFollowingResponse extends PaginatedResponse<FollowedMerchantSummary> {
+}
 /**
  * List coupons response
  */
@@ -2929,6 +3041,100 @@ declare class CustomerEcommerceClient extends BaseEcommerceClient {
      * ```
      */
     getActiveFlashSales(params?: ListActiveFlashSalesParams): Promise<ActiveFlashSalesResponse>;
+    /**
+     * 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);
+     * ```
+     */
+    getMerchantProfile(merchantId: string): Promise<PublicMerchantProfileResponse>;
+    /**
+     * 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);
+     * });
+     * ```
+     */
+    getMerchantProducts(merchantId: string, params?: ListMerchantProductsParams): Promise<MerchantProductsResponse>;
+    /**
+     * 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}`);
+     * }
+     * ```
+     */
+    isFollowingMerchant(merchantId: string): Promise<FollowStatusResponse>;
+    /**
+     * 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"
+     * ```
+     */
+    followMerchant(merchantId: string): Promise<FollowActionResponse>;
+    /**
+     * 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"
+     * ```
+     */
+    unfollowMerchant(merchantId: string): Promise<FollowActionResponse>;
+    /**
+     * 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}`);
+     * });
+     * ```
+     */
+    getFollowedMerchants(params?: ListFollowingParams): Promise<ListFollowingResponse>;
 }
 
 /**
@@ -3983,4 +4189,4 @@ declare function calculateDiscountAmount(price: number, discountType: "PERCENTAG
  */
 declare function calculateFinalPrice(price: number, discountType: "PERCENTAGE" | "FIXED_AMOUNT", discountValue: number): number;
 
-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 };
+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 FollowActionResponse, type FollowStatusResponse, type FollowedMerchantSummary, 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 ListFollowingParams, type ListFollowingResponse, type ListInventoryAuditResponse, type ListMediaAssetsResponse, type ListMerchantProductsParams, 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 MerchantProductsResponse, 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 PublicMerchantProfile, type PublicMerchantProfileResponse, 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 };

package/dist/ecommerce.d.ts

@@ -1689,6 +1689,28 @@ interface CreateFlashSaleRequest {
  */
 interface UpdateFlashSaleRequest extends Partial<CreateFlashSaleRequest> {
 }
+/**
+ * List merchant products params
+ */
+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
+ */
+interface ListFollowingParams extends PaginationParams {
+    /** Sort by: recent (default) or name */
+    sortBy?: "recent" | "name";
+}
 
 /**
  * Ecommerce API Response Types
@@ -1987,6 +2009,96 @@ interface MerchantProfileResponse {
     /** Merchant */
     merchant: Merchant;
 }
+/**
+ * Public merchant profile (for storefront)
+ */
+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
+ */
+interface PublicMerchantProfileResponse {
+    /** Merchant */
+    merchant: PublicMerchantProfile;
+}
+/**
+ * Merchant products response
+ */
+interface MerchantProductsResponse extends PaginatedResponse<Product> {
+    /** Merchant info */
+    merchant: {
+        id: string;
+        name: string;
+    };
+}
+/**
+ * Follow status response
+ */
+interface FollowStatusResponse {
+    /** Whether the user is following */
+    isFollowing: boolean;
+    /** When the user followed (null if not following) */
+    followedAt: string | null;
+}
+/**
+ * Follow action response
+ */
+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
+ */
+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
+ */
+interface ListFollowingResponse extends PaginatedResponse<FollowedMerchantSummary> {
+}
 /**
  * List coupons response
  */
@@ -2929,6 +3041,100 @@ declare class CustomerEcommerceClient extends BaseEcommerceClient {
      * ```
      */
     getActiveFlashSales(params?: ListActiveFlashSalesParams): Promise<ActiveFlashSalesResponse>;
+    /**
+     * 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);
+     * ```
+     */
+    getMerchantProfile(merchantId: string): Promise<PublicMerchantProfileResponse>;
+    /**
+     * 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);
+     * });
+     * ```
+     */
+    getMerchantProducts(merchantId: string, params?: ListMerchantProductsParams): Promise<MerchantProductsResponse>;
+    /**
+     * 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}`);
+     * }
+     * ```
+     */
+    isFollowingMerchant(merchantId: string): Promise<FollowStatusResponse>;
+    /**
+     * 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"
+     * ```
+     */
+    followMerchant(merchantId: string): Promise<FollowActionResponse>;
+    /**
+     * 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"
+     * ```
+     */
+    unfollowMerchant(merchantId: string): Promise<FollowActionResponse>;
+    /**
+     * 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}`);
+     * });
+     * ```
+     */
+    getFollowedMerchants(params?: ListFollowingParams): Promise<ListFollowingResponse>;
 }
 
 /**
@@ -3983,4 +4189,4 @@ declare function calculateDiscountAmount(price: number, discountType: "PERCENTAG
  */
 declare function calculateFinalPrice(price: number, discountType: "PERCENTAGE" | "FIXED_AMOUNT", discountValue: number): number;
 
-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 };
+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 FollowActionResponse, type FollowStatusResponse, type FollowedMerchantSummary, 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 ListFollowingParams, type ListFollowingResponse, type ListInventoryAuditResponse, type ListMediaAssetsResponse, type ListMerchantProductsParams, 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 MerchantProductsResponse, 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 PublicMerchantProfile, type PublicMerchantProfileResponse, 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 };

package/dist/ecommerce.js

@@ -831,6 +831,120 @@ var CustomerEcommerceClient = class 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) {
+    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

package/dist/ecommerce.mjs

@@ -1,2 +1,2 @@
-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-Z5OW2FDP.mjs';
 import './chunk-4UEJOM6W.mjs';

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { SpotToken, MarginTables, PerpsAssetCtx, SpotMeta, ExchangeClient, SuccessResponse, InfoClient } from '@nktkas/hyperliquid';
 import { Hex } from '@nktkas/hyperliquid/types';
 export { A as AllPerpsMeta, d as AssetIdUtils, B as BaseInstrument, I as InstrumentClient, M as MarketInstrument, c as PerpsInstrument, P as PerpsMeta, a as PerpsMetaAndAssetCtxs, b as PerpsUniverse, S as SpotInstrument, g as getAllPerpsMeta } from './client-CgmiTuEX.mjs';
-export { ActiveFlashSalesResponse, AnalyticsOverview, ApiResponse, AppliedDiscount, Banner, BannerResponse, BannerType, BaseEcommerceClient, BaseEntity, CalculateCartDiscountsRequest, CalculateCartDiscountsResponse, CalculateTaxRequest, CalculateTaxResponse, CartItem, ConfirmEscrowDepositResponse, Coupon, CouponResponse, CouponUsage, CreateBannerRequest, CreateCouponRequest, CreateFlashSaleRequest, CreateOrderEventRequest, CreateOrderEventResponse, CreateOrderRequest, CreateOrderResponse, CreateProductRequest, CreateProductVariantRequest, CreateReviewRequest, CreateShippingMethodRequest, CreateTaxNexusRequest, CreateTaxRuleRequest, CustomerEcommerceClient, CustomerMessagesResponse, CustomerSummary, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, EcommerceClientConfig, FlashSale, FlashSaleItem, FlashSaleItemInput, GenerateTaxReportRequest, GetAnalyticsParams, GetAnalyticsResponse, GetCouponResponse, GetOrderResponse, GetProductMetricsResponse, GetProductResponse, GetTaxReportResponse, InventoryAuditAction, InventoryAuditEntry, ListActiveBannersParams, ListActiveFlashSalesParams, ListBannersResponse, ListCouponsResponse, ListCustomersParams, ListCustomersResponse, ListInventoryAuditResponse, ListMediaAssetsResponse, ListMessagesResponse, ListOrdersParams, ListOrdersResponse, ListProductVariantsResponse, ListProductsParams, ListProductsResponse, ListReturnsResponse, ListReviewsParams, ListReviewsResponse, ListShipmentsResponse, ListShippingAddressesResponse, ListShippingMethodsResponse, ListTaxNexusResponse, ListTaxReportsParams, ListTaxReportsResponse, ListTaxRulesResponse, MediaAsset, MediaAssetResponse, Merchant, MerchantEcommerceClient, MerchantProfileRequest, MerchantProfileResponse, MerchantStatus, Message, MessageResponse, MessageStatsResponse, Order, OrderEvent, OrderItem, OrderReceiptResponse, OrderStatus, OrdersByStatus, PaginatedResponse, PaginationParams, Payment, PaymentMethod, PaymentStatus, Product, ProductDimensions, ProductDiscountsResponse, ProductMetrics, ProductResponse, ProductReview, ProductSortBy, ProductVariant, ProductVariantResponse, RecentOrderSummary, RespondToReviewRequest, Return, ReturnItem, ReturnResponse, ReturnStatus, RevenueByDay, ReviewResponse, ReviewSortBy, ReviewStatus, SendMessageRequest, Settlement, Shipment, ShipmentResponse, ShipmentStatus, ShippingAddress, ShippingAddressRequest, ShippingAddressResponse, ShippingMethod, ShippingMethodResponse, SortOrder, SuccessResponse, TaxBehavior, TaxBreakdownItem, TaxNexus, TaxNexusResponse, TaxReport, TaxReportDetails, TaxReportPeriodType, TaxReportResponse, TaxReportStatus, TaxRule, TaxRuleResponse, TaxSettings, TaxSettingsResponse, TaxType, TopProduct, TrackBannerRequest, UpdateBannerRequest, UpdateCouponRequest, UpdateFlashSaleRequest, UpdateOrderResponse, UpdateOrderStatusRequest, UpdateProductRequest, UpdateProductVariantRequest, UpdateShipmentRequest, UpdateShippingMethodRequest, UpdateTaxNexusRequest, UpdateTaxReportStatusRequest, UpdateTaxRuleRequest, UpdateTaxSettingsRequest, UserShippingAddress, ValidateDiscountRequest, ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './ecommerce.mjs';
+export { ActiveFlashSalesResponse, AnalyticsOverview, ApiResponse, AppliedDiscount, Banner, BannerResponse, BannerType, BaseEcommerceClient, BaseEntity, CalculateCartDiscountsRequest, CalculateCartDiscountsResponse, CalculateTaxRequest, CalculateTaxResponse, CartItem, ConfirmEscrowDepositResponse, Coupon, CouponResponse, CouponUsage, CreateBannerRequest, CreateCouponRequest, CreateFlashSaleRequest, CreateOrderEventRequest, CreateOrderEventResponse, CreateOrderRequest, CreateOrderResponse, CreateProductRequest, CreateProductVariantRequest, CreateReviewRequest, CreateShippingMethodRequest, CreateTaxNexusRequest, CreateTaxRuleRequest, CustomerEcommerceClient, CustomerMessagesResponse, CustomerSummary, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, EcommerceClientConfig, FlashSale, FlashSaleItem, FlashSaleItemInput, FollowActionResponse, FollowStatusResponse, FollowedMerchantSummary, GenerateTaxReportRequest, GetAnalyticsParams, GetAnalyticsResponse, GetCouponResponse, GetOrderResponse, GetProductMetricsResponse, GetProductResponse, GetTaxReportResponse, InventoryAuditAction, InventoryAuditEntry, ListActiveBannersParams, ListActiveFlashSalesParams, ListBannersResponse, ListCouponsResponse, ListCustomersParams, ListCustomersResponse, ListFollowingParams, ListFollowingResponse, ListInventoryAuditResponse, ListMediaAssetsResponse, ListMerchantProductsParams, ListMessagesResponse, ListOrdersParams, ListOrdersResponse, ListProductVariantsResponse, ListProductsParams, ListProductsResponse, ListReturnsResponse, ListReviewsParams, ListReviewsResponse, ListShipmentsResponse, ListShippingAddressesResponse, ListShippingMethodsResponse, ListTaxNexusResponse, ListTaxReportsParams, ListTaxReportsResponse, ListTaxRulesResponse, MediaAsset, MediaAssetResponse, Merchant, MerchantEcommerceClient, MerchantProductsResponse, MerchantProfileRequest, MerchantProfileResponse, MerchantStatus, Message, MessageResponse, MessageStatsResponse, Order, OrderEvent, OrderItem, OrderReceiptResponse, OrderStatus, OrdersByStatus, PaginatedResponse, PaginationParams, Payment, PaymentMethod, PaymentStatus, Product, ProductDimensions, ProductDiscountsResponse, ProductMetrics, ProductResponse, ProductReview, ProductSortBy, ProductVariant, ProductVariantResponse, PublicMerchantProfile, PublicMerchantProfileResponse, RecentOrderSummary, RespondToReviewRequest, Return, ReturnItem, ReturnResponse, ReturnStatus, RevenueByDay, ReviewResponse, ReviewSortBy, ReviewStatus, SendMessageRequest, Settlement, Shipment, ShipmentResponse, ShipmentStatus, ShippingAddress, ShippingAddressRequest, ShippingAddressResponse, ShippingMethod, ShippingMethodResponse, SortOrder, SuccessResponse, TaxBehavior, TaxBreakdownItem, TaxNexus, TaxNexusResponse, TaxReport, TaxReportDetails, TaxReportPeriodType, TaxReportResponse, TaxReportStatus, TaxRule, TaxRuleResponse, TaxSettings, TaxSettingsResponse, TaxType, TopProduct, TrackBannerRequest, UpdateBannerRequest, UpdateCouponRequest, UpdateFlashSaleRequest, UpdateOrderResponse, UpdateOrderStatusRequest, UpdateProductRequest, UpdateProductVariantRequest, UpdateShipmentRequest, UpdateShippingMethodRequest, UpdateTaxNexusRequest, UpdateTaxReportStatusRequest, UpdateTaxRuleRequest, UpdateTaxSettingsRequest, UserShippingAddress, ValidateDiscountRequest, ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './ecommerce.mjs';
 import 'axios';
 
 declare function encodeSlug(slug: string): bigint;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { SpotToken, MarginTables, PerpsAssetCtx, SpotMeta, ExchangeClient, SuccessResponse, InfoClient } from '@nktkas/hyperliquid';
 import { Hex } from '@nktkas/hyperliquid/types';
 export { A as AllPerpsMeta, d as AssetIdUtils, B as BaseInstrument, I as InstrumentClient, M as MarketInstrument, c as PerpsInstrument, P as PerpsMeta, a as PerpsMetaAndAssetCtxs, b as PerpsUniverse, S as SpotInstrument, g as getAllPerpsMeta } from './client-CgmiTuEX.js';
-export { ActiveFlashSalesResponse, AnalyticsOverview, ApiResponse, AppliedDiscount, Banner, BannerResponse, BannerType, BaseEcommerceClient, BaseEntity, CalculateCartDiscountsRequest, CalculateCartDiscountsResponse, CalculateTaxRequest, CalculateTaxResponse, CartItem, ConfirmEscrowDepositResponse, Coupon, CouponResponse, CouponUsage, CreateBannerRequest, CreateCouponRequest, CreateFlashSaleRequest, CreateOrderEventRequest, CreateOrderEventResponse, CreateOrderRequest, CreateOrderResponse, CreateProductRequest, CreateProductVariantRequest, CreateReviewRequest, CreateShippingMethodRequest, CreateTaxNexusRequest, CreateTaxRuleRequest, CustomerEcommerceClient, CustomerMessagesResponse, CustomerSummary, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, EcommerceClientConfig, FlashSale, FlashSaleItem, FlashSaleItemInput, GenerateTaxReportRequest, GetAnalyticsParams, GetAnalyticsResponse, GetCouponResponse, GetOrderResponse, GetProductMetricsResponse, GetProductResponse, GetTaxReportResponse, InventoryAuditAction, InventoryAuditEntry, ListActiveBannersParams, ListActiveFlashSalesParams, ListBannersResponse, ListCouponsResponse, ListCustomersParams, ListCustomersResponse, ListInventoryAuditResponse, ListMediaAssetsResponse, ListMessagesResponse, ListOrdersParams, ListOrdersResponse, ListProductVariantsResponse, ListProductsParams, ListProductsResponse, ListReturnsResponse, ListReviewsParams, ListReviewsResponse, ListShipmentsResponse, ListShippingAddressesResponse, ListShippingMethodsResponse, ListTaxNexusResponse, ListTaxReportsParams, ListTaxReportsResponse, ListTaxRulesResponse, MediaAsset, MediaAssetResponse, Merchant, MerchantEcommerceClient, MerchantProfileRequest, MerchantProfileResponse, MerchantStatus, Message, MessageResponse, MessageStatsResponse, Order, OrderEvent, OrderItem, OrderReceiptResponse, OrderStatus, OrdersByStatus, PaginatedResponse, PaginationParams, Payment, PaymentMethod, PaymentStatus, Product, ProductDimensions, ProductDiscountsResponse, ProductMetrics, ProductResponse, ProductReview, ProductSortBy, ProductVariant, ProductVariantResponse, RecentOrderSummary, RespondToReviewRequest, Return, ReturnItem, ReturnResponse, ReturnStatus, RevenueByDay, ReviewResponse, ReviewSortBy, ReviewStatus, SendMessageRequest, Settlement, Shipment, ShipmentResponse, ShipmentStatus, ShippingAddress, ShippingAddressRequest, ShippingAddressResponse, ShippingMethod, ShippingMethodResponse, SortOrder, SuccessResponse, TaxBehavior, TaxBreakdownItem, TaxNexus, TaxNexusResponse, TaxReport, TaxReportDetails, TaxReportPeriodType, TaxReportResponse, TaxReportStatus, TaxRule, TaxRuleResponse, TaxSettings, TaxSettingsResponse, TaxType, TopProduct, TrackBannerRequest, UpdateBannerRequest, UpdateCouponRequest, UpdateFlashSaleRequest, UpdateOrderResponse, UpdateOrderStatusRequest, UpdateProductRequest, UpdateProductVariantRequest, UpdateShipmentRequest, UpdateShippingMethodRequest, UpdateTaxNexusRequest, UpdateTaxReportStatusRequest, UpdateTaxRuleRequest, UpdateTaxSettingsRequest, UserShippingAddress, ValidateDiscountRequest, ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './ecommerce.js';
+export { ActiveFlashSalesResponse, AnalyticsOverview, ApiResponse, AppliedDiscount, Banner, BannerResponse, BannerType, BaseEcommerceClient, BaseEntity, CalculateCartDiscountsRequest, CalculateCartDiscountsResponse, CalculateTaxRequest, CalculateTaxResponse, CartItem, ConfirmEscrowDepositResponse, Coupon, CouponResponse, CouponUsage, CreateBannerRequest, CreateCouponRequest, CreateFlashSaleRequest, CreateOrderEventRequest, CreateOrderEventResponse, CreateOrderRequest, CreateOrderResponse, CreateProductRequest, CreateProductVariantRequest, CreateReviewRequest, CreateShippingMethodRequest, CreateTaxNexusRequest, CreateTaxRuleRequest, CustomerEcommerceClient, CustomerMessagesResponse, CustomerSummary, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, EcommerceClientConfig, FlashSale, FlashSaleItem, FlashSaleItemInput, FollowActionResponse, FollowStatusResponse, FollowedMerchantSummary, GenerateTaxReportRequest, GetAnalyticsParams, GetAnalyticsResponse, GetCouponResponse, GetOrderResponse, GetProductMetricsResponse, GetProductResponse, GetTaxReportResponse, InventoryAuditAction, InventoryAuditEntry, ListActiveBannersParams, ListActiveFlashSalesParams, ListBannersResponse, ListCouponsResponse, ListCustomersParams, ListCustomersResponse, ListFollowingParams, ListFollowingResponse, ListInventoryAuditResponse, ListMediaAssetsResponse, ListMerchantProductsParams, ListMessagesResponse, ListOrdersParams, ListOrdersResponse, ListProductVariantsResponse, ListProductsParams, ListProductsResponse, ListReturnsResponse, ListReviewsParams, ListReviewsResponse, ListShipmentsResponse, ListShippingAddressesResponse, ListShippingMethodsResponse, ListTaxNexusResponse, ListTaxReportsParams, ListTaxReportsResponse, ListTaxRulesResponse, MediaAsset, MediaAssetResponse, Merchant, MerchantEcommerceClient, MerchantProductsResponse, MerchantProfileRequest, MerchantProfileResponse, MerchantStatus, Message, MessageResponse, MessageStatsResponse, Order, OrderEvent, OrderItem, OrderReceiptResponse, OrderStatus, OrdersByStatus, PaginatedResponse, PaginationParams, Payment, PaymentMethod, PaymentStatus, Product, ProductDimensions, ProductDiscountsResponse, ProductMetrics, ProductResponse, ProductReview, ProductSortBy, ProductVariant, ProductVariantResponse, PublicMerchantProfile, PublicMerchantProfileResponse, RecentOrderSummary, RespondToReviewRequest, Return, ReturnItem, ReturnResponse, ReturnStatus, RevenueByDay, ReviewResponse, ReviewSortBy, ReviewStatus, SendMessageRequest, Settlement, Shipment, ShipmentResponse, ShipmentStatus, ShippingAddress, ShippingAddressRequest, ShippingAddressResponse, ShippingMethod, ShippingMethodResponse, SortOrder, SuccessResponse, TaxBehavior, TaxBreakdownItem, TaxNexus, TaxNexusResponse, TaxReport, TaxReportDetails, TaxReportPeriodType, TaxReportResponse, TaxReportStatus, TaxRule, TaxRuleResponse, TaxSettings, TaxSettingsResponse, TaxType, TopProduct, TrackBannerRequest, UpdateBannerRequest, UpdateCouponRequest, UpdateFlashSaleRequest, UpdateOrderResponse, UpdateOrderStatusRequest, UpdateProductRequest, UpdateProductVariantRequest, UpdateShipmentRequest, UpdateShippingMethodRequest, UpdateTaxNexusRequest, UpdateTaxReportStatusRequest, UpdateTaxRuleRequest, UpdateTaxSettingsRequest, UserShippingAddress, ValidateDiscountRequest, ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './ecommerce.js';
 import 'axios';
 
 declare function encodeSlug(slug: string): bigint;

package/dist/index.js

@@ -43151,6 +43151,120 @@ var CustomerEcommerceClient = class 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) {
+    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

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-Z5OW2FDP.mjs';
 export { AssetIdUtils, InstrumentClient } from './chunk-VBC6EQ7Q.mjs';
 import { __glob } from './chunk-4UEJOM6W.mjs';
 import Decimal, { Decimal as Decimal$1 } from 'decimal.js';

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/customer.ts

@@ -22,6 +22,8 @@ import type {
   TrackBannerRequest,
   SendMessageRequest,
   ListActiveFlashSalesParams,
+  ListMerchantProductsParams,
+  ListFollowingParams,
   
   // Response types
   ListProductsResponse,
@@ -45,6 +47,11 @@ import type {
   MessageStatsResponse,
   MessageResponse,
   ActiveFlashSalesResponse,
+  PublicMerchantProfileResponse,
+  MerchantProductsResponse,
+  FollowStatusResponse,
+  FollowActionResponse,
+  ListFollowingResponse,
 } from "../types";
 
 /**
@@ -635,5 +642,130 @@ 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}`);
+  }
 }
 

package/lib/ecommerce/types/requests.ts

@@ -578,3 +578,27 @@ export interface CreateFlashSaleRequest {
  */
 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

@@ -340,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
  */

package/package.json

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