refactor(frontend): some degree of api wrapping

frontend/lib/api-fetch.ts

@@ -0,0 +1,136 @@
+/** An array returned by the API. (Can be `null` due to a quirk in Go.) */
+export type Arr<T> = T[] | null;
+
+export interface PartialPerson {
+  id: string;
+  name: string;
+  display_name: string | null;
+  avatar_urls: Arr<string>;
+}
+
+export type PartialUser = PartialPerson;
+
+export type PartialMember = PartialPerson;
+
+/** The shared interface of `Member` and `User`.
+ * A typical `_Person` is only one of those two, so consider using `Person` instead.
+ */
+export interface _Person extends PartialPerson {
+  bio: string | null;
+  links: Arr<string>;
+  names: Arr<Name>;
+  pronouns: Arr<Pronoun>;
+  fields: Arr<Field>;
+}
+
+export interface User extends _Person {
+  members: Arr<PartialMember>;
+}
+
+export interface Member extends _Person {
+  user: PartialUser;
+}
+
+export type Person = Member | User;
+
+export interface MeUser extends User {
+  discord: string | null;
+  discord_username: string | null;
+}
+
+export interface Name {
+  name: string;
+  status: WordStatus;
+}
+
+export interface Pronoun {
+  display_text?: string;
+  pronouns: string;
+  status: WordStatus;
+}
+
+export interface Field {
+  name: string;
+  favourite: Arr<string>;
+  okay: Arr<string>;
+  jokingly: Arr<string>;
+  friends_only: Arr<string>;
+  avoid: Arr<string>;
+}
+
+export interface APIError {
+  code: ErrorCode;
+  message?: string;
+  details?: string;
+}
+
+export enum WordStatus {
+  Favourite = 1,
+  Okay = 2,
+  Jokingly = 3,
+  FriendsOnly = 4,
+  Avoid = 5,
+}
+
+export enum ErrorCode {
+  BadRequest = 400,
+  Forbidden = 403,
+  NotFound = 404,
+  MethodNotAllowed = 405,
+  TooManyRequests = 429,
+  InternalServerError = 500,
+
+  InvalidState = 1001,
+  InvalidOAuthCode = 1002,
+  InvalidToken = 1003,
+  InviteRequired = 1004,
+  InvalidTicket = 1005,
+  InvalidUsername = 1006,
+  UsernameTaken = 1007,
+  InvitesDisabled = 1008,
+  InviteLimitReached = 1009,
+  InviteAlreadyUsed = 1010,
+
+  UserNotFound = 2001,
+
+  MemberNotFound = 3001,
+  MemberLimitReached = 3002,
+
+  RequestTooBig = 4001,
+}
+
+export interface SignupRequest {
+  username: string;
+  ticket: string;
+  invite_code?: string;
+}
+
+export interface SignupResponse {
+  user: MeUser;
+  token: string;
+}
+
+const apiBase = process.env.API_BASE ?? "/api";
+
+export async function fetchAPI<T>(
+  path: string,
+  method = "GET",
+  body: any = null
+) {
+  const token =
+    typeof localStorage !== "undefined" &&
+    localStorage.getItem("pronouns-token");
+
+  const resp = await fetch(`${apiBase}/v1${path}`, {
+    method,
+    headers: {
+      ...token ? { Authorization: token } : {},
+      "Content-Type": "application/json",
+    },
+    body: body ? JSON.stringify(body) : null,
+  });
+
+  const data = await resp.json();
+  if (resp.status < 200 || resp.status >= 300) throw data as APIError;
+  return data as T;
+}