Feature flags

gf flags ls -e dev                               # -e: environment id or name
gf flags set new-checkout true -e dev            # boolean (inferred)
gf flags set max-items 25 -e dev                 # number (inferred)
gf flags set banner '{"text":"Hi"}' --type json -e dev
gf flags get new-checkout -e prod
gf flags compare dev prod
gf flags promote dev prod --dry-run              # then without --dry-run
gf flags rm new-checkout -e dev

GET /v1/workspaces/{workspace_id}/flags/runtime?environment_id={environment_id}

{
  "workspace_id": "7965d229-…",
  "environment_id": "0b1e…",
  "flags": { "new-checkout": true, "max-items": 25 }
}

import { useFlag, useFlags } from './lib/flags';

export function Checkout() {
  const newCheckout = useFlag('new-checkout', false);
  const maxItems = useFlag('max-items', 10);
  return newCheckout ? <NewCheckout max={maxItems} /> : <LegacyCheckout />;
}

// Several flags at once — one request, one poller:
export function Toolbar() {
  const { flags, loading, error } = useFlags();
  if (loading) return null;
  return flags['ui.dark_mode'] ? <DarkToolbar /> : <Toolbar />;
}

const CP = process.env.CONTROLPLANE_URL;
const WS = process.env.GROUNDFLOOR_WORKSPACE_ID;
const ENV = process.env.GROUNDFLOOR_ENVIRONMENT_ID;

let token = { value: null, expiresAt: 0 };
async function m2mToken() {
  if (token.value && Date.now() < token.expiresAt - 30_000) return token.value;
  const res = await fetch(`${CP}/v1/workspaces/${WS}/m2m/token`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      client_id: process.env.GROUNDFLOOR_M2M_CLIENT_ID,
      client_secret: process.env.GROUNDFLOOR_M2M_CLIENT_SECRET,
    }),
  });
  if (!res.ok) throw new Error(`m2m token ${res.status}`);
  const body = await res.json();
  token = { value: body.access_token, expiresAt: Date.now() + body.expires_in * 1000 };
  return token.value;
}

let cache = { etag: null, flags: {}, checkedAt: 0 };
export async function getFlags() {
  if (Date.now() - cache.checkedAt < 30_000) return cache.flags;
  const qs = ENV ? `?environment_id=${encodeURIComponent(ENV)}` : '';
  const res = await fetch(`${CP}/v1/workspaces/${WS}/flags/runtime${qs}`, {
    headers: {
      Authorization: `Bearer ${await m2mToken()}`,
      ...(cache.etag ? { 'If-None-Match': cache.etag } : {}),
    },
  });
  cache.checkedAt = Date.now();
  if (res.status === 304) return cache.flags;
  if (!res.ok) throw new Error(`flags ${res.status}: ${await res.text()}`);
  const body = await res.json();
  cache = { ...cache, etag: res.headers.get('etag'), flags: body.flags };
  return cache.flags;
}

// const flags = await getFlags();
// if (flags['new-checkout']) { … }