Feature/api migration and personal mode

[Maphikza]

API Migration and Personal Mode Enhancement

🎯 Summary

This PR migrates the allowed users system to use the new unified backend API endpoints and introduces a new
"Personal Mode" for single-user private relays. It also improves mode labels for better user clarity.

🔧 API Migration Changes

Endpoint Updates

• ✅ GET: ~/api/settings/allowed_users → ~/api/settings
• ✅ POST: ~/api/settings/allowed_users → ~/api/settings

Data Structure Changes

• ✅ Response parsing: Updated to extract from data.settings.allowed_users
• ✅ Request format: Updated to send nested settings.allowed_users structure
• ✅ Backward compatibility: Maintains existing UI/UX while adapting to new API

Error Handling

• ✅ Added fallback for missing tiers data using defaults
• ✅ Improved error handling for missing response data
• ✅ Fixed TypeScript errors with proper type casting

🆕 New Personal Mode

"Free - Only Me" Mode

• 🎯 Purpose: Perfect for single-user private relays
• 💾 Data Limit: Unlimited access
• 💰 Pricing: Free (no cost)
• 🔐 Access: Requires NPUB management (invite-only for self)
• 🎨 UI: Orange theme color for visual distinction

Configuration

personal: {
  readOptions: [{ value: 'allowed_users', label: 'Only Me' }],
  writeOptions: [{ value: 'allowed_users', label: 'Only Me' }],
  allowsFreeTiers: true,
  requiresNpubManagement: true
}

🏷️ Improved Mode Labels

Enhanced clarity for all relay modes:

| Old Label      | New Label                 | Use Case                               |
|----------------|---------------------------|----------------------------------------|
| Free Mode      | Free - Public Relay       | Open access with optional tiers        |
| Paid Mode      | Paid - Subscription Tiers | Subscription-based access control      |
| Exclusive Mode | Free - Invite Only        | Manual NPUB management, multiple users |
| ➕ NEW          | Free - Only Me            | Single user personal relay             |

🔍 Technical Details

Files Modified

- src/api/allowedUsers.api.ts - API endpoint migration and personal mode support
- src/types/allowedUsers.types.ts - Added personal mode types and configurations
- src/components/allowed-users/components/ModeSelector/ModeSelector.tsx - Updated UI labels

Type Safety

- ✅ Added proper TypeScript type casting
- ✅ Extended AllowedUsersMode type union
- ✅ Updated all mode configuration records

API Logic

- ✅ Personal mode handles tier filtering like free mode (active tier only)
- ✅ Proper reconstruction of tier data for UI display
- ✅ Maintains existing behavior for all other modes

🧪 Testing

Backend Compatibility

- ✅ Works with new unified /api/settings endpoint
- ✅ Handles nested response structure correctly
- ✅ Sends data in expected nested format

Frontend Functionality

- ✅ All existing modes work as before
- ✅ New personal mode integrates seamlessly
- ✅ Mode switching works correctly
- ✅ Tier management functions properly

🚀 Deployment Notes

Prerequisites

- Backend must support unified /api/settings endpoint
- Backend must accept nested settings.allowed_users structure
- Backend should return settings.allowed_users in responses

Backward Compatibility

- ✅ No breaking changes to existing functionality
- ✅ Graceful fallbacks for missing data
- ✅ Maintains all existing UI/UX patterns

📋 Checklist

- API endpoints updated to unified structure
- Response parsing handles nested data correctly
- Request format updated for new backend structure
- TypeScript errors resolved
- Personal mode fully implemented
- Mode labels improved for clarity
- All existing functionality preserved
- Error handling improved
- Code committed and pushed to feature branch

---
Ready for review and testing! 🎉