🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.
TypeScript analyticsautogenevaluationlangchainlarge-language-modelsllama-indexllmllm-evaluationllm-observabilityllmopsmonitoringobservabilityopen-sourceopenaiplaygroundprompt-engineeringprompt-managementself-hostedycombinator
import { useSyncExternalStore } from "react";
/**
* How long after the app first mounts before the version-update banner is
* allowed to appear. This is a post-load grace serving two purposes:
*
* 1. **No mid-deploy prompt (LFE-14537).** A page can be loaded while the web
* container is switching versions; offering a reload in that window pushes
* the user to reload straight into a still-switching pod (a broken loading
* state). Withholding the prompt for the first minute of a session lets a
* deploy that was in flight at load time settle before we ever offer a
* reload. Combined at the banner with the store's new-version debounce
* ({@link VERSION_UPDATE_DEBOUNCE_MS}); both gates must pass.
* 2. **No startup flicker.** During the initial mount/hydration window the
* layout flickers and React StrictMode double-invokes mounts; because the
* banner renders through an overlay portal, a mount landing in that churn is
* torn down and recreated, replaying its entrance animation (a visible
* "jump"). A minute comfortably clears that window, so it mounts once,
* cleanly.
*/
export const APP_SETTLE_DELAY_MS = 60 * 1000;
/**
* A one-shot "the app has settled after first render" gate as an external store.
*
* It is module-scoped (a singleton below), NOT component state, so the settled
* flag survives banner unmount/remount — e.g. when `AppLayout` switches between
* `AuthenticatedLayout` and `MinimalLayout` (navigating to `/onboarding`,
* `/auth/*`, `/public/*` and back). A component-local timer would restart the
* grace period on every such remount, re-hiding an already-acknowledged banner
* for another {@link APP_SETTLE_DELAY_MS}. Once settled it stays settled, so
* later mounts see `true` immediately.
*
* Exposed as a factory for deterministic testing; the app uses the singleton.
*/
export function createAppSettledGate(delayMs = APP_SETTLE_DELAY_MS) {
let settled = false;
let timerStarted = false;
const listeners = new Set<() => void>();
// The timer is the external system this store owns. Start it once, on first
// subscription (the app's first client mount); it is idempotent across the
// StrictMode subscribe/unsubscribe/subscribe cycle and across remounts.
const startTimer = () => {
if (timerStarted || settled) return;
timerStarted = true;
setTimeout(() => {
settled = true;
for (const listener of listeners) listener();
}, delayMs);
};
return {
subscribe(listener: () => void) {
startTimer();
listeners.add(listener);
return () => {
listeners.delete(listener);
};
},
getSnapshot: () => settled,
// Never settled on the server; the banner only exists in a live tab.
getServerSnapshot: () => false,
};
}
const appSettledGate = createAppSettledGate();
/**
* `true` once the app has settled after first render (see
* {@link createAppSettledGate}). Read via `useSyncExternalStore` — no
* effect-driven state, and the value is shared across all consumers and
* survives component remounts.
*/
export function useAppSettled(): boolean {
return useSyncExternalStore(
appSettledGate.subscribe,
appSettledGate.getSnapshot,
appSettledGate.getServerSnapshot,
);
}