Notification Routes

{
  "data": {
    "notificationIds": [
      "uuid-1",
      "uuid-2",
      "uuid-3"
    ],
    "message": "Notifications sent successfully",
    "count": 3
  }
}

curl -X POST http://localhost:3000/notifications/send \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "type": "info",
    "title": "System Update",
    "message": "The system will be updated tonight at 11 PM.",
    "data": {
      "updateVersion": "1.2.3",
      "maintenanceWindow": "11:00 PM - 12:00 AM"
    },
    "userIds": ["user-id-1", "user-id-2", "user-id-3"]
  }'

{
  "data": [
    {
      "id": "notification-id",
      "type": "info",
      "title": "System Update",
      "message": "The system will be updated tonight at 11 PM.",
      "data": {
        "updateVersion": "1.2.3",
        "maintenanceWindow": "11:00 PM - 12:00 AM"
      },
      "seen": false,
      "userId": "user-id",
      "createdAt": "2025-01-15T10:30:00.000Z",
      "updatedAt": "2025-01-15T10:30:00.000Z"
    }
  ],
  "totalCount": 15,
  "unseenCount": 3
}

# Get all notifications for current user
curl -X GET "http://localhost:3000/notifications" \
  -H "Authorization: Bearer <token>"

# Get only unseen notifications
curl -X GET "http://localhost:3000/notifications?seen=false" \
  -H "Authorization: Bearer <token>"

# Get notifications with pagination
curl -X GET "http://localhost:3000/notifications?limit=10&page=1" \
  -H "Authorization: Bearer <token>"

{
  "data": {
    "message": "Notifications marked as seen",
    "updatedCount": 3
  }
}

curl -X PATCH http://localhost:3000/notifications/seen \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "notificationIds": ["notification-id-1", "notification-id-2"]
  }'

{
  "data": {
    "message": "Notifications deleted successfully",
    "deletedCount": 2
  }
}

curl -X DELETE http://localhost:3000/notifications \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "notificationIds": ["notification-id-1", "notification-id-2"]
  }'

{
  "data": {
    "total": 50,
    "seen": 35,
    "unseen": 15,
    "byType": {
      "info": 30,
      "warning": 15,
      "success": 5
    },
    "recent": {
      "today": 3,
      "thisWeek": 8,
      "thisMonth": 22
    }
  }
}

curl -X GET "http://localhost:3000/notifications/stats" \
  -H "Authorization: Bearer <token>"

// 1. Send a notification to multiple users
const sendResponse = await fetch('/notifications/send', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ' + token
  },
  body: JSON.stringify({
    type: 'info',
    title: 'Welcome!',
    message: 'Welcome to our platform. Get started by exploring the features.',
    data: {
      actionUrl: '/dashboard',
      priority: 'normal'
    },
    userIds: ['user-1', 'user-2']
  })
});

// 2. Get user notifications
const notifications = await fetch('/notifications?limit=20', {
  headers: { 'Authorization': 'Bearer ' + token }
});

// 3. Mark notifications as seen
await fetch('/notifications/seen', {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ' + token
  },
  body: JSON.stringify({
    notificationIds: ['notif-1', 'notif-2']
  })
});

// 4. Get notification statistics
const stats = await fetch('/notifications/stats', {
  headers: { 'Authorization': 'Bearer ' + token }
});

// Client-side Socket.IO listener
socket.on('notification.new', (notification) => {
  console.log('New notification received:', notification);

  // Update UI to show new notification
  showNotificationBadge(notification);

  // Show toast/popup
  showToast(notification.title, notification.message);
});

// Listen for notification updates
socket.on('notification.seen', (data) => {
  console.log('Notification marked as seen:', data.notificationId);
  updateNotificationUI(data.notificationId, { seen: true });
});

{
  "error": {
    "message": "Invalid notification parameters",
    "code": "VALIDATION_ERROR",
    "details": {
      "field": "userIds",
      "message": "userIds must be a non-empty array"
    }
  }
}