Social API

/api/v1/social

{
  "followingId": "uuid"
}

{
  "success": true,
  "data": {
    "follower_id": "uuid",
    "following_id": "uuid",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

const response = await fetch('/api/v1/social', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ followingId: 'user-uuid-here' }),
});

const result = await response.json();
if (result.success) {
  console.log('Now following user!');
}

{
  "followingId": "uuid"
}

DELETE /api/v1/social?followingId=uuid

{
  "success": true,
  "data": {
    "unfollowed": true
  }
}

const response = await fetch('/api/v1/social', {
  method: 'DELETE',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ followingId: 'user-uuid-here' }),
});

{
  "success": true,
  "data": {
    "user": {
      "id": "uuid",
      "username": "beerlover",
      "email": "user@example.com",
      "first_name": "John",
      "last_name": "Doe",
      "avatar_url": "https://cdn.brewhoard.com/avatars/...",
      "bio": "Craft beer enthusiast",
      "location": "Portland, OR",
      "created_at": "2023-06-15T10:00:00Z",
      "displayName": "John Doe"
    },
    "stats": {
      "followers": 42,
      "following": 28,
      "collection": 156,
      "ratings": 89
    },
    "social": {
      "isFollowing": false,
      "isOwnProfile": true
    },
    "recentActivity": [
      {
        "id": "uuid",
        "type": "rating",
        "data": {
          "beer_name": "Hop Heaven IPA",
          "brewery_name": "Craft Brewery",
          "rating": 4.5
        },
        "timestamp": "2024-01-14T18:30:00Z"
      }
    ]
  }
}

const response = await fetch('/api/v1/social?userId=user-uuid-here');
const { data } = await response.json();

console.log(`${data.user.displayName} has ${data.stats.followers} followers`);

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "eventType": "collection_add",
      "targetType": "beer",
      "targetId": "beer-uuid",
      "metadata": {
        "beerName": "Imperial Stout",
        "breweryName": "Dark Brewing Co",
        "quantity": 6
      },
      "createdAt": "2024-01-15T14:30:00Z",
      "user": {
        "id": "uuid",
        "username": "craftlover",
        "avatarUrl": "https://cdn.brewhoard.com/avatars/...",
        "displayName": "Sarah Smith"
      }
    },
    {
      "id": "uuid",
      "eventType": "rating",
      "targetType": "beer",
      "targetId": "beer-uuid",
      "metadata": {
        "beerName": "Hoppy Blonde",
        "rating": 4.5,
        "review": "Excellent summer beer!"
      },
      "createdAt": "2024-01-15T12:15:00Z",
      "user": {
        "id": "uuid",
        "username": "hophead",
        "displayName": "Mike Johnson"
      }
    }
  ]
}

async function loadFeed(page = 1) {
  const limit = 20;
  const offset = (page - 1) * limit;
  
  const response = await fetch(
    `/api/v1/social?action=feed&limit=${limit}&offset=${offset}`
  );
  
  const { data } = await response.json();
  return data;
}

{
  "targetType": "rating",
  "targetId": "uuid"
}

{
  "success": true,
  "data": {
    "liked": true
  }
}

async function toggleLike(targetType, targetId) {
  const response = await fetch('/api/v1/social/like', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ targetType, targetId }),
  });
  
  const { data } = await response.json();
  return data.liked;
}

// Usage
const isLiked = await toggleLike('rating', 'rating-uuid');

{
  "success": true,
  "data": {
    "comments": [
      {
        "id": "uuid",
        "content": "Great choice! I love this beer too.",
        "parentId": null,
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z",
        "user": {
          "id": "uuid",
          "username": "beerfan",
          "avatarUrl": "https://cdn.brewhoard.com/avatars/...",
          "displayName": "Alex Brown"
        }
      }
    ]
  }
}

{
  "targetType": "rating",
  "targetId": "uuid",
  "content": "Excellent review! I had the same experience.",
  "parentId": null
}

{
  "success": true,
  "data": {
    "comment": {
      "id": "uuid",
      "content": "Excellent review! I had the same experience.",
      "parentId": null,
      "createdAt": "2024-01-15T14:30:00Z",
      "user": {
        "id": "uuid",
        "username": "currentuser",
        "displayName": "Current User"
      }
    }
  }
}

{
  "success": true,
  "data": {
    "followers": [
      {
        "id": "uuid",
        "username": "craftlover",
        "first_name": "Sarah",
        "last_name": "Smith",
        "avatar_url": "https://cdn.brewhoard.com/avatars/...",
        "displayName": "Sarah Smith",
        "followed_at": "2024-01-10T08:00:00Z"
      }
    ],
    "pagination": {
      "total": 42,
      "limit": 20,
      "offset": 0,
      "hasMore": true
    }
  }
}

{
  "success": true,
  "data": {
    "following": [
      {
        "id": "uuid",
        "username": "hophead",
        "displayName": "Mike Johnson",
        "followed_at": "2024-01-05T12:00:00Z"
      }
    ],
    "pagination": {
      "total": 28,
      "limit": 20,
      "offset": 0,
      "hasMore": true
    }
  }
}

import { io } from 'socket.io-client';

const socket = io();

// Subscribe to activity updates
socket.on('activity:new', (activity) => {
  console.log('New activity:', activity);
  // Add to feed UI
});

// Subscribe to notifications
socket.on('notification:follow', (data) => {
  console.log(`${data.fromUsername} started following you!`);
});

socket.on('notification:like', (data) => {
  console.log(`${data.fromUser} liked your ${data.targetType}`);
});

{
  "success": false,
  "error": "User ID is required",
  "code": "MISSING_USER_ID"
}

// Check if following
async function checkFollowing(userId) {
  const response = await fetch(`/api/v1/social?userId=${userId}`);
  const { data } = await response.json();
  return data.social.isFollowing;
}

// Toggle follow
async function toggleFollow(userId, isCurrentlyFollowing) {
  const method = isCurrentlyFollowing ? 'DELETE' : 'POST';
  
  const response = await fetch('/api/v1/social', {
    method,
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ followingId: userId }),
  });
  
  return response.ok;
}

<script>
  let activities = $state([]);
  let loading = $state(false);
  let page = $state(1);
  
  async function loadMore() {
    loading = true;
    const limit = 20;
    const offset = (page - 1) * limit;
    
    const response = await fetch(
      `/api/v1/social?action=feed&limit=${limit}&offset=${offset}`
    );
    const { data } = await response.json();
    
    activities = [...activities, ...data];
    page += 1;
    loading = false;
  }
  
  // Initial load
  $effect(() => {
    loadMore();
  });
</script>

{#each activities as activity}
  <ActivityCard {activity} />
{/each}

<button onclick={loadMore} disabled={loading}>
  {loading ? 'Loading...' : 'Load More'}
</button>