NestQuest/admin/src/api/presence.ts

/**
 * Typed client for the admin presence routes: a child's repeating schedule
 * (/api/v1/admin/children/{id}/presence-schedule) and the household's
 * date-range overrides (/api/v1/admin/presence-overrides).
 */
import { apiFetch } from "./client";
import { CHILDREN_PATH, readJson } from "./definitions";

/**
 * Cycle week index ("0".."n-1", JSON object keys) -> present weekdays
 * (0 = Monday .. 6 = Sunday). An empty list is away that whole week.
 */
export type PresencePattern = Record<string, number[]>;

export interface PresenceScheduleBody {
  cycle_length_weeks: number;
  /** "YYYY-MM-DD"; pins cycle week 0. */
  anchor_date: string;
  pattern: PresencePattern;
}

export interface PresenceSchedule extends PresenceScheduleBody {
  child_id: number;
}

export interface PresenceOverride {
  id: number;
  child_id: number;
  start_date: string;
  end_date: string;
  is_present: boolean;
  note: string | null;
}

export interface PresenceOverrideFilter {
  childId?: number;
  /** "YYYY-MM-DD"; keeps overrides overlapping [start, end]. */
  start?: string;
  end?: string;
}

export const PRESENCE_OVERRIDES_PATH = "/api/v1/admin/presence-overrides";

export function presenceSchedulePath(childId: number): string {
  return `${CHILDREN_PATH}/${childId}/presence-schedule`;
}

/** The child's schedule, or null when it has none (present every day). */
export async function fetchPresenceSchedule(childId: number): Promise<PresenceSchedule | null> {
  const body = await readJson<{ schedule: PresenceSchedule | null }>(
    await apiFetch(presenceSchedulePath(childId)),
  );
  return body.schedule;
}

/** Set (upsert) the child's schedule; resolves to the schedule as stored. */
export async function savePresenceSchedule(
  childId: number,
  body: PresenceScheduleBody,
): Promise<PresenceSchedule> {
  return readJson<PresenceSchedule>(
    await apiFetch(presenceSchedulePath(childId), {
      method: "PUT",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(body),
    }),
  );
}

export async function fetchPresenceOverrides(
  filter: PresenceOverrideFilter = {},
): Promise<PresenceOverride[]> {
  const params = new URLSearchParams();
  if (filter.childId !== undefined) params.set("child_id", String(filter.childId));
  if (filter.start !== undefined) params.set("start", filter.start);
  if (filter.end !== undefined) params.set("end", filter.end);
  const query = params.toString();
  const body = await readJson<{ overrides: PresenceOverride[] }>(
    await apiFetch(query ? `${PRESENCE_OVERRIDES_PATH}?${query}` : PRESENCE_OVERRIDES_PATH),
  );
  return body.overrides;
}

export interface PresenceOverrideRange {
  child_id: number;
  /** "YYYY-MM-DD", inclusive. */
  start_date: string;
  /** "YYYY-MM-DD", inclusive; never before start_date. */
  end_date: string;
  is_present: boolean;
}

export interface PresenceOverrideBody extends PresenceOverrideRange {
  note?: string;
}

export const PRESENCE_OVERRIDE_CONSEQUENCE_PATH = `${PRESENCE_OVERRIDES_PATH}/consequence`;

function postJson(path: string, body: unknown): Promise<Response> {
  return apiFetch(path, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(body),
  });
}

/**
 * How many open upcoming tasks saving this override would remove. Computed
 * by the API before anything is saved; completed instances never count.
 */
export async function previewOverrideConsequence(range: PresenceOverrideRange): Promise<number> {
  const body = await readJson<{ removed: number }>(
    await postJson(PRESENCE_OVERRIDE_CONSEQUENCE_PATH, range),
  );
  return body.removed;
}

export async function createPresenceOverride(body: PresenceOverrideBody): Promise<PresenceOverride> {
  return readJson<PresenceOverride>(await postJson(PRESENCE_OVERRIDES_PATH, body));
}

export async function deletePresenceOverride(overrideId: number): Promise<void> {
  await readJson<{ status: string }>(
    await apiFetch(`${PRESENCE_OVERRIDES_PATH}/${overrideId}`, { method: "DELETE" }),
  );
}