TudorandClaude Opus 5
54a30de0d8
Ships without a consumer, deliberately. The first flag needs none — the backend withholds the field and the page follows — but 'UI elements on existing pages' is one of the three surfaces this capability exists for, and a flag layer that cannot gate one is incomplete. Never throws: an unreadable flag is a dark one, which matches the backend's fail-closed default. A page that 500s because the flags endpoint blinked would be a worse outcome than a hidden feature. Reading flags pins the calling route to a 300s ISR floor, since Next takes the lowest revalidate among a route's fetches. That matches what /school/[slug] already sits at, and it is the same property that makes a flip propagate without a webhook. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015mWQnpye9F299NVRCCSRvj
41 lines
1.4 KiB
TypeScript
41 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 {};
|
|
}
|
|
}
|