User Availability Status - Mobile/Web Migration Dokumani

Bu doküman, kullanıcı busy / available switch'i için backend response sozlesmesindeki DTO değişikliklerini ve client migration noktalarini açıklar.

Ozet

• Yeni enum: UserAvailabilityStatus = 'available' | 'busy'
• Yeni kalici user alani: availabilityStatus
• Varsayilan deger: available
• Eksik/eski kayitlarda backend response mapper'lari available döner.
• Bu alan sadece gösterim amaclidir; search, recommended, invite veya live stream listelerinde filtreleme yapmaz.
• Tüm HTTP cevaplari global BaseResponseDto<T> wrapper içindedir.

export type UserAvailabilityStatus = 'available' | 'busy';

Yeni Endpoint

Request

export type UpdateAvailabilityStatusDto = {
  availabilityStatus: UserAvailabilityStatus;
};

Response

export type UserAvailabilityStatusResponseDto = {
  _id: string;
  availabilityStatus: UserAvailabilityStatus;
  updatedAt: string; // ISO date
};

export type BaseResponseDto<T> = {
  isSuccess: boolean;
  statusCode: number;
  data: T;
  errors?: string[];
  timestamp: string;
};

Ornek

PATCH /api/v1/users/availability-status
Authorization: Bearer <JWT>
Content-Type: application/json

{
  "availabilityStatus": "busy"
}

{
  "isSuccess": true,
  "statusCode": 200,
  "data": {
    "_id": "507f1f77bcf86cd799439011",
    "availabilityStatus": "busy",
    "updatedAt": "2026-05-06T10:30:00.000Z"
  },
  "errors": [],
  "timestamp": "2026-05-06T10:30:00.000Z"
}

Degisen DTO'lar

UserResponseDto

Eklenen alan:

availabilityStatus?: UserAvailabilityStatus;

Bagli endpointler:

Client aksiyonu:

• UserResponseDto modeline availabilityStatus?: UserAvailabilityStatus ekleyin.
• UI'da eksik gelirse fallback available kullanın.

PublicUserProfileDto

Eklenen alan:

availabilityStatus: UserAvailabilityStatus;

Bagli endpointler:

Client aksiyonu:

• Profil ekraninda durum badge/switch okumasi için availabilityStatus kullanın.
• Bu alan kullanıcının online/offline presence'i değildir.

UserSummaryDto

Eklenen alan:

availabilityStatus?: UserAvailabilityStatus;

Dogrudan bagli endpointler:

Nested olarak etkilenen endpointler:

LiveStreamResponseDto donen baslica endpointler:

• GET /api/v1/live-stream
• GET /api/v1/live-stream/search
• GET /api/v1/live-stream/active
• GET /api/v1/live-stream/whats-live-now
• GET /api/v1/live-stream/ready-to-fund
• GET /api/v1/live-stream/featured
• GET /api/v1/live-stream/my-active-stream
• GET /api/v1/live-stream/funded
• GET /api/v1/live-stream/guest-streams
• GET /api/v1/live-stream/upcoming-live-streams
• GET /api/v1/live-stream/my-past-streams
• GET /api/v2/live-stream/my-past-streams
• GET /api/v1/live-stream/past-streams
• GET /api/v2/live-stream/past-streams
• GET /api/v1/live-stream/user/:userId/active-stream
• GET /api/v1/live-stream/user/:userId/past-streams
• GET /api/v2/live-stream/user/:userId/past-streams
• DELETE /api/v1/live-stream/:id
• POST /api/v1/live-stream/:id/cancel
• PATCH /api/v1/live-stream/:id/replay-settings
• GET /api/v1/live-stream/:id
• POST /api/v1/live-stream/:id/fund

Client aksiyonu:

• Ortak UserSummaryDto tipine availabilityStatus?: UserAvailabilityStatus ekleyin.
• Bu değişiklik live stream kartlarinda nested creator ve guests tiplerine otomatik yayilir.

InvitableUserSummaryDto

InvitableUserSummaryDto, UserSummaryDto extend ettigi için alan inherited gelir:

availabilityStatus?: UserAvailabilityStatus;

Bagli endpoint:

Client aksiyonu:

• Davet listelerinde busy görünümü UI tarafında gösterilebilir.
• Backend busy kullanıcıyi davet listesinden filtrelemez.

SearchUserV2Dto

Eklenen alan:

availabilityStatus?: UserAvailabilityStatus;

Bagli endpoint:

Client aksiyonu:

• SearchUserV2Dto tipine alani ekleyin.
• Mevcut profilePhoto96Url / activeLiveStream davranisi degismedi.

ChatMemberResponseDto

Eklenen alan:

availabilityStatus?: UserAvailabilityStatus;

Bagli endpointler:

Not:

• Pending deletion durumundaki kullanıcılarda username ve profilePhoto maskelenmeye devam eder.
• availabilityStatus eksik/eski kayitlarda available olarak normalize edilir.

Client aksiyonu:

• Chat member modeline availabilityStatus?: UserAvailabilityStatus ekleyin.
• Chat listesinde gösterilecek busy/available badge'i için member.availabilityStatus ?? 'available' kullanın.

FollowUserSummaryDto

Eklenen alan:

availabilityStatus?: UserAvailabilityStatus;

Bagli endpointler:

Client aksiyonu:

• Follow list item modeline availabilityStatus?: UserAvailabilityStatus ekleyin.
• isFollowing, followersCount, followingCount, expertise alanlari degismedi.

MostWatchedCreatorsUserSummaryDto

Eklenen alan:

availabilityStatus?: UserAvailabilityStatus;

Bagli endpoint:

Client aksiyonu:

• Most watched creators liste item tipine alani ekleyin.
• isFollowing davranisi degismedi.

Client Migration Checklist

1. Ortak enum ekleyin:

export type UserAvailabilityStatus = 'available' | 'busy';

2. Asagidaki client modellerine availabilityStatus ekleyin:

type UserResponseDto = {
  availabilityStatus?: UserAvailabilityStatus;
};

type PublicUserProfileDto = {
  availabilityStatus: UserAvailabilityStatus;
};

type UserSummaryDto = {
  availabilityStatus?: UserAvailabilityStatus;
};

type SearchUserV2Dto = {
  availabilityStatus?: UserAvailabilityStatus;
};

type ChatMemberResponseDto = {
  availabilityStatus?: UserAvailabilityStatus;
};

type FollowUserSummaryDto = {
  availabilityStatus?: UserAvailabilityStatus;
};

type MostWatchedCreatorsUserSummaryDto = {
  availabilityStatus?: UserAvailabilityStatus;
};

3. UI fallback:

const availabilityStatus = user.availabilityStatus ?? 'available';

4. Kullanıcı switch'i için mutation ekleyin:

type UpdateAvailabilityStatusDto = {
  availabilityStatus: UserAvailabilityStatus;
};

async function updateAvailabilityStatus(body: UpdateAvailabilityStatusDto) {
  return api.patch('/users/availability-status', body);
}

5. Cache invalidation onerisi:

• Basarili switch sonrasi current user/profile cache'i invalidate edin.
• Search/recommended/follow/live-stream/chat listelerinde durum gösteriliyorsa ilgili listeleri refetch edin veya local cache'teki kullanıcı kartini _id ile patch edin.

Geriye Donuk Uyumluluk

• Backend eski kullanıcılar için availabilityStatus yoksa available normalize eder.
• Yeni alan response'a ekleme seklindedir; mevcut alanlarin adi, tipi ve nullability'si degismedi.
• Busy kullanıcılar backend tarafında listelerden cikarilmaz ve davet akisini bloklamaz.
• Bu alan realtime socket presence değildir; kullanıcı manuel switch ettiginde değişir.