TypeScript Data Types: Interfaces and Type Definitions

// src/types/index.ts
export interface MemberDetail {
  id: string;
  email: string;
  userEmail?: string;        // Alias — same value as email in some contexts
  name: string;
  phone: string;
  major: string;
  graduationDate: string;    // Expected graduation year or date string
  status: string;            // "Looking for Internship" | "Looking for Full-time" | "Not Looking"
  about: string;             // Member bio
  internship: string;        // Current or most recent internship
  photoUrl: string;          // Profile photo URL
  hours: string;             // Total accumulated event hours
  developmentHours?: string;
  professionalHours?: string;
  serviceHours?: string;
  socialHours?: string;
  links?: string[];          // External links (LinkedIn, GitHub, etc.)
  rank: string;              // "Current" | "Pledge" | "Alumni"
  role: string;              // "e-board" | "general-member" | "sponsor-admin"
  event_attendance?: any[];  // Array of attended event records from API
  deleted_at?: string | null; // Non-null means the member is archived
  type?: "member";           // Discriminant field used by NetworkList
}

// src/types/index.ts
export type MemberRank = 'pledge' | 'inducted' | 'alumni';

// src/types/index.ts
export interface Announcement {
  id: string;
  title: string;
  description: string;
  created_at?: string;           // ISO timestamp
  updated_at?: string;           // ISO timestamp
  is_pinned?: boolean;           // Pinned announcements sort to top
  target_audience?: "all" | "members" | "pledges";
  date?: string;                 // Legacy general date field
  announcement_date?: string | null; // Legacy specific date field
}

// src/types/index.ts
export type BaseEvent = {
  id: string;
  event_name: string;
  event_description: string;
  event_location?: string;
  event_date: string;            // "YYYY-MM-DD"
  event_time?: string;           // "HH:MM:SS"
  dress_code?: string;
  event_hours?: number;
  event_hours_type?: string;     // "professional" | "service" | "social" | "development"
  sponsors_attending?: string[]; // Sponsor company names
  event_limit?: number;          // Max RSVP cap (null = unlimited)
  rsvp_count: number;            // Aggregate across all users
  attending_count: number;       // Aggregate across all users
};

// src/types/index.ts
export type MemberEvent = BaseEvent & {
  event_lat?: number | null;    // Only present when user has RSVP'd
  event_long?: number | null;   // Only present when user has RSVP'd
  user_rsvped: boolean;         // Current user's RSVP status
  user_attended: boolean;       // Current user's attendance status
  can_check_in: boolean;        // Whether check-in window is currently open
  check_in_window?: number;     // Minutes window (only if RSVP'd)
  check_in_radius?: number;     // Meters radius (only if RSVP'd)
};

// src/types/index.ts
export type AdminEvent = BaseEvent & {
  event_lat: number;            // Always present for admin
  event_long: number;           // Always present for admin
  event_rsvped: string[];       // Array of user IDs (not emails)
  event_attending: string[];    // Array of user IDs (not emails)
  is_hidden: boolean;           // Hidden from non-admin views
  check_in_window: number;      // Minutes — always present for admin
  check_in_radius: number;      // Meters — always present for admin
  user_rsvped: boolean;         // Admin's own RSVP status
  user_attended: boolean;       // Admin's own attendance status
};

// src/types/index.ts
export type EventParticipants = {
  event_id: string;
  event_name: string;
  rsvped_users: {
    user_id: string;
    name: string;
    user_email: string;
  }[];
  attending_users: {
    user_id: string;
    name: string;
    user_email: string;
    checked_in_at?: string;  // ISO timestamp of check-in
  }[];
  rsvp_count: number;
  attending_count: number;
};

// src/types/index.ts
export type Event = MemberEvent | AdminEvent;

// Narrowing example in EventCard
const userRsvped = 'user_rsvped' in event ? event.user_rsvped : false;
const checkInWindow = 'check_in_window' in event ? event.check_in_window : undefined;

// src/types/index.ts
export interface Sponsor {
  id?: string;                          // Standardized to string
  type?: "sponsor";                     // Discriminant for NetworkList
  name: string;
  about: string;
  links?: string[] | null;
  photoUrl?: string | null;             // Profile logo URL
  resources?: { label: string; url: string }[] | null;
  tier?: string;                        // "gold" | "silver" | "bronze" | ...
  emails?: string[];                    // Contact emails for the sponsor
}

// src/types/index.ts
export type EboardFacultyEntry = {
  role: string;                 // Position title, e.g. "President"
  role_email: string;           // Position email, e.g. "president@bap.org"
  email: string;                // Holder's personal email
  display_email?: string;       // Publicly shown email (may differ from email)
  profile_photo_url?: string;   // Photo URL
  name: string | null;          // Full name of position holder
  major: string | null;         // Academic major
  rank?: number;                // Display sort order
};

// src/services/memberArchiveService.ts
export interface ArchiveResponse {
  success: boolean;
  message: string;  // Human-readable result description
}

// src/services/memberArchiveService.ts
export interface ArchivedMember {
  email: string;
  name: string;
  deleted_at: string;      // ISO timestamp of soft-deletion
  role: string;            // Role at time of archival
  rank?: string;
  major?: string;
  graduating_year?: number;
  photoUrl?: string;
}

// Event narrowing
if ('event_rsvped' in event) {
  // event is AdminEvent
  console.log(event.is_hidden);
}

// Network entity narrowing
if (entity.type === 'sponsor') {
  // entity is Sponsor
  console.log(entity.tier);
} else if (entity.type === 'member') {
  // entity is MemberDetail
  console.log(entity.rank);
}

// RoleType narrowing (from authProvider.tsx)
if (typeof role === 'object' && role !== null && role.type === 'sponsor') {
  // role is SponsorRole
  const companyName = role.companyName;
}