[Service] Product Follow Contract Service for StarShop Frontend

[aguilar1x]

🎯 Objective

Develop a comprehensive TypeScript service layer for the Product Follow Contract that manages product following, notifications, alerts, and user preferences within the StarShop marketplace.

---

🏗 Service Structure

src/shared/services/product_follow/
  follow.service.ts                // Main service class
  types/
    follow.types.ts               // TypeScript interfaces
    notification.types.ts         // Notification types
    alert.types.ts                // Alert types
  utils/
    follow.utils.ts               // Helper functions
  constants/
    follow.constants.ts           // Contract addresses, error codes

---

🗂 Requirements

1. Follow Management

• followProduct(productId, user) - Follow product
• unfollowProduct(productId, user) - Unfollow product
• getFollowers(productId) - Get product followers
• getFollowing(user) - Get user's followed products
• isFollowing(productId, user) - Check if user follows product

2. Notification Management

• setNotificationPreferences(user, preferences) - Set preferences
• getNotificationPreferences(user) - Get preferences
• sendNotification(productId, type, data) - Send notification
• getNotificationHistory(user) - Get notification history

3. Alert Management

• createAlert(productId, conditions) - Create price/stock alert
• updateAlert(alertId, conditions) - Update alert
• deleteAlert(alertId) - Delete alert
• getAlerts(user) - Get user's alerts
• triggerAlert(alertId) - Trigger alert

4. Rate Limiting & Validation

• checkRateLimit(user, action) - Check rate limits
• validateNotificationFormat(data) - Validate notification
• validateUserPreferences(preferences) - Validate preferences

---

[zintarh]

Hi @aguilar1x I'll love to work on this

[Kelechiokpani]

I’d like to work on this because I enjoy solving problems around product engagement, alerts, and notifications. I can build a clean TypeScript service layer that makes following, preferences, and alerts reliable and easy to manage in StarShop.

[komyunghan]

Happy to implement this.

I'll create src/services/productFollow.ts covering follow, unfollow, and isFollowing query against the Product Follow contract. I'll add a useProductFollow hook that integrates with the existing user store for auth context.

ETA: 1-2 days.