todo-endpoints.txt

POST /request-otp {} { email } -> {
  session_token: string
}

POST /resend-otp {
  session-token
} -> ''

POST /check-otp {
  session-token
} { otp } -> {
  person_id: number | null
  onboarded: boolean
  units: 'Imperial' | 'Metric'
}

POST /check-session-token {
  session-token
} {} -> {
  person_id: number | null
  onboarded: boolean
  units: 'Imperial' | 'Metric'
}

GET /search-locations?q=$1 {
  session-token
} -> string[]

PATCH /onboardee-info {
  session-token
} (
  | { name }
  | { date-of-birth }
  | { location }
  | { gender }
  | { other-peoples-genders }
  | { photos }
  | { about }
) -> ''

DELETE /onboardee-info {
} (
  { photo }
) -> ''

POST /finish-onboarding {
  session-token
} -> {
  person_id: number
  units: 'Imperial' | 'Metric'
}

POST /sign-out {
  session-token
}

GET /next-questions {
  session-token
} { n, o } -> [
  {
    question-id,
    question-number
    topic
    question-text
  }
]

POST /answer {
  session-token
} {
  question-id
  answer
  public
}

DELETE /answer {
  session-token
} {
  question-id
}

GET /search {
  session-token
} {
  page-number
  number-of-results = 10
} -> [
  {
    person-id
    profile-picture-url
    name
    age
    match-percentage
  }
]

GET /me {
} {} -> {
  // Personality traits
}

GET /me/<person-id> {
} {} -> {
  // Personality traits
}

GET /prospect-profile/<person-id> {
  session-token
} -> {
  pictures: [url-1, ..., url-n],
  name: string
  age: string | undefined
  location: string | undefined
  match-percentage: number
  summary: { gender: , ..., profession: }
  about: "I'm a reasonable..."
  mutual_clubs: [ name ]
  other_clubs: [ name ]
}

POST /skip/<person-id> { session-token }
POST /unskip/<person-id> { session-token } {
  report_reason?: string
}

GET /compare-personalities/<person-id>/('mbti' | 'big5' | 'attachment' | 'politics' | 'other') {
  session-token
} -> {
  ...
}

GET /compare-answers/<person-id> {
  session-token
} {
  page-number
  agreement: 'all' | 'agree' | 'disagree' | 'unanswered'
  topic
} -> [
  {
    question-id
    question-number
    question-topic
    question-text
    prospect-answer
    answer
    public
  }
]

GET /inbox-info {
  session-token
} {
  [person-id]
} -> [
  {
    person_id: string
    name: string
    matchPercentage: number
    imageUuid: string | null
  }
]

DELETE /delete-account {
  session-token
}

POST /deactivate {
  session-token
}

DELETE /profile-info {
  session-token
} {} -> ...

PATCH /profile-info {
  session-token
} {} -> ...

GET /profile-info {
  session-token
} {} -> {
 photo: { position: uuid },
}

GET /search-filters {
  session-token
} -> {
  gender
  ...
}

POST /search-filters {
  session-token
} (
  | { questions: [ { question-id, answer, accept-unanswered }, ... ]
  | { gender: ["Man", ..., null] }
  ...
  | { two-way-filters: ["Man", ..., null] }
)

GET /search-filter-questions {
  session-token
} {
  q?
  n?
  o?
} -> [
  {
    question-id
    question
    topic
    answer?
    accept-unanswered?
  }
]

POST /search-filter-answer {
  session-token
} {
  question_id: number
  answer: boolean | null
  accept_unanswered: boolean
} ->
  | { error: string }
  | { answer: [ ... ] }

GET /search-clubs {
  session-token
} {
  q?
} -> [
  {
    name
    member_count
  }
]

POST /join-club {
  session-token
} {
  name
}

POST /leave-club {
  session-token
} {
  name
}

GET /update-notifications {
} {
  email
  type
  frequency
}