40 lines
1.4 KiB
TypeScript
40 lines
1.4 KiB
TypeScript
|
/**
|
||
|
|
* 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 {};
|
||
|
|
}
|
||
|
|
}
|