/**
 * Reading feature flags.
 *
 * Server-side only. No flag value reaches the browser bundle, and there is no
 * Unleash dependency in package.json — the SDK lives in FastAPI, which already
 * owns every other piece of data this app renders.
 *
 * Flags are declared in backend/flags.py. A purely front-end flag still has to
 * be declared there; it is a flat data edit, and the return is that one list
 * answers "what flags exist" for the whole system.
 */

export type Flags = Record<string, boolean>;

/*
 * Reading flags pins the calling route to this ISR floor: Next uses the LOWEST
 * revalidate among a route's fetches to set the whole route's revalidation
 * frequency. 300s matches what /school/[slug] already sits at, so a page that
 * reads flags is no more dynamic than a school page already is.
 *
 * It is also what makes a flip propagate without a webhook: five minutes on
 * school pages, an hour on place pages, against flags that flip monthly.
 */
export const FLAGS_REVALIDATE = 300;

const API = process.env.FASTAPI_URL || process.env.NEXT_PUBLIC_API_URL
  || 'http://localhost:8000/api';

/** Every flag and its value. Never throws: an unreadable flag is a dark one. */
export async function getFlags(): Promise<Flags> {
  try {
    const res = await fetch(`${API}/flags`, {
      next: { revalidate: FLAGS_REVALIDATE },
    });
    if (!res.ok) return {};
    return await res.json();
  } catch {
    return {};
  }
}