Skip to content
Sign up

flagon-io/g1t

public
0
541 linesCodeBlameRaw
1import { useEffect, useMemo, useRef, useState } from "react";
2import {
3 isRouteErrorResponse,
4 Link,
5 Links,
6 Meta,
7 Outlet,
8 Scripts,
9 ScrollRestoration,
10 type ShouldRevalidateFunctionArgs,
11 useLocation,
12 useMatches,
13 useRouteError,
14 useRouteLoaderData,
15} from "react-router";
16
17import { type User, awaitsConfirmation, hasAccessIn, sharedWorkspaces } from "@g1t/contracts";
18
19import type { Route } from "./+types/root";
20import appCss from "./app.css?url";
21import displayFont from "@g1t/theme/fonts/bricolage-grotesque-latin.woff2?url";
22import sansFont from "@g1t/theme/fonts/hanken-grotesk-latin.woff2?url";
23import { ButtonLink } from "./components/ui";
24import { AppShell, Progress, type ShellData, useLeaving } from "./components/shell";
25import { SiteFooter } from "./components/footer";
26import { PublicHeader } from "./components/public-header";
27import { SpikeBanner } from "./components/spike-banner";
28import { PolicyNotice } from "./components/policy-notice";
29import { identify } from "./lib/analytics.client";
30import { visitorAsksFirst } from "./lib/analytics-consent";
31import { AnalyticsConsent } from "./components/analytics-consent";
32import { readCookie } from "./lib/mission";
33import { WORKSPACE_COOKIE, workspaceFor } from "./lib/workspace-choice";
34import { PageMain } from "./components/landmark";
35import { NotFound } from "./components/not-found";
36import { frameOf } from "./lib/chrome";
37import { DOCK_COOKIE, SIDEBAR_COOKIE, pinsToShow, sidebarClosed } from "./lib/apps";
38import { savedPins } from "./lib/dock.server";
39import { StandaloneFrame } from "./components/standalone";
40import { billing, chat, inbox, projects, workspaceAgents } from "./lib/services.server";
41import { unreadTotals } from "./lib/chat";
42import { countsFor, readableRepos } from "./lib/access.server";
43import { shortCache } from "./lib/cache.server";
44import { getViewer, viewerMiddleware } from "./lib/session.server";
45import { shortcutOf, workspaceProjects } from "./lib/workspace-projects.server";
46import { registrationMode } from "./lib/registration.server";
47import { addresses } from "./lib/addresses.server";
48import { RELOADED_KEY, RELOAD_GIVE_UP_MS, clientNavigated, reloadFixes, reloadedBefore } from "./lib/stale-build";
49import { useNonce } from "./lib/nonce";
50import { isNeedsSignIn } from "./lib/website-token";
51import { setLiveViaToken } from "./lib/live-socket";
52import { LiveNotifications } from "./components/notifications/live-notifications";
53import { THEME_COLOR, THEME_COOKIE, readTheme, themeAttribute, useThemeChoice } from "./lib/theme";
54
55
56export const links: Route.LinksFunction = () => [
57 { rel: "icon", href: "/favicon.ico", sizes: "32x32" },
58 { rel: "icon", type: "image/svg+xml", href: "/favicon.svg" },
59 { rel: "icon", type: "image/png", sizes: "192x192", href: "/icon-192.png" },
60 { rel: "icon", type: "image/png", sizes: "512x512", href: "/icon-512.png" },
61 // Home screens and password managers look for a square, opaque 180px tile;
62 // the "-precomposed" name is served too, for the ones that ask for it.
63 { rel: "apple-touch-icon", sizes: "180x180", href: "/apple-touch-icon.png" },
64 // Installable: name, icons and colours for "Add to Home Screen" (public/site.webmanifest;
65 // manifest.webmanifest is the same file, kept for installs that already point at it).
66 { rel: "manifest", href: "/site.webmanifest" },
67 // The text and headline faces are wanted on every page, so they start
68 // loading with the stylesheet; mono waits until something uses it.
69 { rel: "preload", href: sansFont, as: "font", type: "font/woff2", crossOrigin: "anonymous" },
70 { rel: "preload", href: displayFont, as: "font", type: "font/woff2", crossOrigin: "anonymous" },
71];
72
73export const middleware: Route.MiddlewareFunction[] = [viewerMiddleware];
74
75export async function loader({ context, params, request }: Route.LoaderArgs) {
76 const user = getViewer(context);
77 const cookies = request.headers.get("cookie");
78 const chosen = readCookie(cookies, WORKSPACE_COOKIE);
79 const dock = readCookie(cookies, DOCK_COOKIE);
80 // Whether sign-up takes an invite: the sign-up page says so, and
81 // Settings → Invites offers invites to g1t only then. Cached per isolate.
82 const [shell, mode] = await Promise.all([
83 // An account still confirming its address sees only the pages that
84 // allows (lib/confirm-gate.ts), in the visitor's frame.
85 user && !awaitsConfirmation(user)
86 ? shellFor(user, params, chosen, context).catch((error: unknown) => {
87 // A sidebar that could not be read is no reason to lose the page,
88 // or to draw it as if they were signed out.
89 console.error("root: the sidebar could not be read", error);
90 return bareShell(user, params, chosen);
91 })
92 : visitorShell(params, context),
93 registrationMode(),
94 ]);
95 // The apps this person pinned to their dock here: as their account keeps
96 // them (read with the rest of the shell), else as this device's cookie
97 // remembers them (lib/apps.ts).
98 if (shell.workspace) shell.pins = pinsToShow(shell.pins, dock, shell.workspace.slug);
99 // Where this g1t lives, for clone lines, agent setup and link previews.
100 return {
101 user,
102 shell,
103 // Whether they folded the sidebar away, so the page is drawn that way from the start.
104 sidebarClosed: sidebarClosed(readCookie(cookies, SIDEBAR_COOKIE)),
105 // Their Appearance, so the page is drawn in it from the first byte (lib/theme.ts).
106 theme: readTheme(readCookie(cookies, THEME_COOKIE)),
107 inviteOnly: mode !== "open",
108 addresses: addresses(),
109 // Visitors from where the law asks first are asked before analytics runs.
110 analyticsConsent: visitorAsksFirst(request),
111 };
112}
113
114/**
115 * The sidebar for someone not signed in: nothing of their own, only the
116 * open counts of the project being looked at. One call, and only in a
117 * project; it answers the same for a private project as a missing one.
118 */
119async function visitorShell(params: { owner?: string; repo?: string }, context: Route.LoaderArgs["context"]): Promise<ShellData> {
120 const path = params.owner && params.repo ? { namespace: params.owner, name: params.repo } : null;
121 const counts = path ? await countsFor(context, params) : null;
122 return {
123 workspace: null,
124 repos: [],
125 repo: path && counts?.ok ? { ...path, member: false, issues: counts.value.issues, pulls: counts.value.pulls } : null,
126 limit: null,
127 monthUsageMicros: null,
128 };
129}
130
131/** The sidebar from what the session already says, with no service asked. */
132function bareShell(user: User, params: { owner?: string; repo?: string }, chosen: string | null): ShellData {
133 return {
134 workspace: workspaceFor(user.workspaces ?? [], chosen, params),
135 repos: [],
136 repo: null,
137 limit: null,
138 monthUsageMicros: null,
139 };
140}
141
142/**
143 * The sidebar only changes with the workspace or repository being looked
144 * at, or after something was submitted: not on every page within them.
145 */
146export function shouldRevalidate({
147 currentParams,
148 nextParams,
149 formMethod,
150 defaultShouldRevalidate,
151}: ShouldRevalidateFunctionArgs) {
152 if (formMethod && formMethod !== "GET") return defaultShouldRevalidate;
153 return currentParams.owner !== nextParams.owner || currentParams.repo !== nextParams.repo;
154}
155
156/**
157 * The sidebar: the workspace whose pages or project these are when it is
158 * one of yours, else the one you chose (lib/workspace-choice.ts); its
159 * projects; and the repository being looked at.
160 */
161async function shellFor(
162 user: User,
163 params: { owner?: string; repo?: string },
164 chosen: string | null,
165 context: Route.LoaderArgs["context"],
166): Promise<ShellData> {
167 const memberships = user.workspaces ?? [];
168 const workspace = workspaceFor(memberships, chosen, params);
169 const path = params.owner && params.repo ? { namespace: params.owner, name: params.repo } : null;
170 const now = new Date();
171 const monthStart = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1)).toISOString();
172 // What the sidebar shows of the workspace changes rarely: kept for a few
173 // seconds per person and workspace, except just after they changed
174 // something (lib/cache.server.ts).
175 const kept = <T,>(what: string, load: () => Promise<T>) =>
176 workspace ? shortCache(`shell:${what}:${user.id}:${workspace.slug}`, SHELL_TTL_MS, load) : Promise.resolve(null);
177 const [listed, counts, status, usage, limit, entitlements, shared, unread, shortcuts, chatUnread, teamAgents, dockPins] = await Promise.all([
178 // Every project, for the palette and the count; the sidebar lists only
179 // the person's pinned and recent ones (lib/pins.ts).
180 workspace ? workspaceProjects(workspace.slug, user) : Promise.resolve(null),
181 path ? countsFor(context, params) : Promise.resolve(null),
182 // Whether billing is on, without reading the account: that asks the
183 // card processor about the workspace's cards, too slow for every page.
184 kept("status", () => billing.status()).catch(() => null),
185 kept(`usage:${monthStart}`, () => billing.usage(workspace!.slug, user, monthStart)).catch(() => null),
186 kept("limit", () => billing.limit(workspace!.slug, user)).catch(() => null),
187 kept("entitlements", () => billing.entitlements(workspace!.slug)).catch(() => null),
188 sharedRepos(user),
189 // The bell's count: one query, never kept, so marking an item shows at once.
190 inbox.counts(user.username).catch(() => null),
191 // Never kept: opening a project moves it up Recent.
192 workspace ? projects.shortcuts(workspace.slug, user).catch(() => null) : Promise.resolve(null),
193 // The rail's Chat badge: never kept, and never waited on for long.
194 workspace ? chatUnreadFor(workspace.slug, user) : Promise.resolve(null),
195 // Home's Recent and the Agents sidebar, on every page: never waited on for long.
196 workspace ? agentsFor(workspace.slug, user) : Promise.resolve(null),
197 // The dock's pins, kept with the account so every device shows the same
198 // dock; never kept here, so a pin shows the moment it is made. Null
199 // falls back to the cookie (lib/dock.server.ts).
200 workspace ? savedPins(user, workspace.slug) : Promise.resolve(null),
201 ]);
202 return {
203 workspace,
204 // Projects are what the sidebar lists: what the workspace builds and runs.
205 repos: listed?.ok ? listed.value.map(shortcutOf) : [],
206 pinned: (shortcuts?.pinned ?? []).map(shortcutOf),
207 recent: (shortcuts?.recent ?? []).map(shortcutOf),
208 repo:
209 path && counts?.ok
210 ? {
211 ...path,
212 // Until the repository's own page says what their role is.
213 member: hasAccessIn(user, path.namespace),
214 issues: counts.value.issues,
215 pulls: counts.value.pulls,
216 }
217 : null,
218 // Where the workspace stands against its usage limit, once billing is on.
219 limit:
220 status?.enabled && limit?.ok
221 ? {
222 exposureMicros: limit.value.exposureMicros,
223 ceilingMicros: limit.value.ceilingMicros,
224 state: limit.value.state,
225 comped: limit.value.trust === "internal",
226 }
227 : null,
228 free: Boolean(status?.free),
229 // A spend spike or a hold pauses new compute: the shell says so on every page.
230 compute:
231 workspace && entitlements && (entitlements.paused || entitlements.spike?.status === "open")
232 ? { paused: entitlements.paused, spike: entitlements.spike ?? null, owner: workspace.role === "owner" }
233 : null,
234 shared,
235 inbox: unread,
236 chat: chatUnread,
237 agents: teamAgents,
238 pins: dockPins ?? undefined,
239 // While g1t is free every charge is zero, so usage is shown at cost.
240 // Usage at price, the one figure every page shows.
241 monthUsageMicros: usage?.ok ? (usage.value.free ? usage.value.usedMicros : (usage.value.priceMicros ?? usage.value.spentMicros)) : null,
242 };
243}
244
245/** Starred and recent conversations Home's sidebar lists. */
246const SHELL_CONVERSATIONS = 8;
247
248/**
249 * What is unread in chat, for the rail, and the starred and latest
250 * conversations, for Home's sidebar; null when chat is slow to answer or
251 * does not.
252 */
253async function chatUnreadFor(slug: string, user: User): Promise<ShellData["chat"]> {
254 const timeout = new Promise<null>((resolve) => setTimeout(() => resolve(null), CHAT_BADGE_WAIT_MS));
255 const read = chat
256 .sidebar(slug, user)
257 .then((result) => {
258 if (!result.ok) return null;
259 const entries = result.value.entries;
260 const latest = [...entries].sort((a, b) => (b.channel.last_message_at ?? "").localeCompare(a.channel.last_message_at ?? ""));
261 return {
262 ...unreadTotals(entries),
263 starred: entries.filter((e) => e.starred).slice(0, SHELL_CONVERSATIONS),
264 recent: latest.slice(0, SHELL_CONVERSATIONS),
265 };
266 })
267 .catch(() => null);
268 return Promise.race([read, timeout]);
269}
270
271/** The workspace's agents, as the shell lists them; null when the agents service is slow or down. */
272async function agentsFor(slug: string, user: User): Promise<ShellData["agents"]> {
273 const timeout = new Promise<null>((resolve) => setTimeout(() => resolve(null), CHAT_BADGE_WAIT_MS));
274 const read = workspaceAgents
275 .list(slug, user)
276 .then((result) =>
277 result.ok
278 ? result.value
279 .filter((agent) => !agent.archived_at)
280 .map((agent) => ({
281 id: agent.id,
282 handle: agent.handle,
283 display_name: agent.display_name,
284 avatar: agent.avatar,
285 avatar_seed: agent.avatar_seed,
286 role: agent.role,
287 title: agent.title,
288 team: agent.team,
289 department: agent.department,
290 status: agent.status,
291 builtin: agent.builtin === true,
292 }))
293 : null,
294 )
295 .catch(() => null);
296 return Promise.race([read, timeout]);
297}
298
299/** The longest the rail's Chat badge holds up a page. */
300const CHAT_BADGE_WAIT_MS = 300;
301
302/**
303 * How long the sidebar's workspace answers are kept: as long as someone's
304 * own changes read fresh anyway (lib/perf.ts `PRIMARY_WINDOW_SECONDS`).
305 */
306const SHELL_TTL_MS = 30_000;
307
308/** Most repositories listed under Shared with you. */
309const MAX_SHARED = 20;
310
311/**
312 * Repositories shared with the user in workspaces they do not belong to,
313 * by their grants: only those, never the workspace's other repositories.
314 */
315async function sharedRepos(user: User): Promise<ShellData["shared"]> {
316 const outside = new Set(sharedWorkspaces(user));
317 if (outside.size === 0) return [];
318 const ids = (user.grants ?? []).filter((grant) => outside.has(grant.workspace)).map((grant) => grant.repo_id).slice(0, MAX_SHARED);
319 const found = await readableRepos(ids, user);
320 return found
321 .map((repo) => ({ namespace: repo.namespace, name: repo.name, isPrivate: repo.isPrivate }))
322 .sort((a, b) => `${a.namespace}/${a.name}`.localeCompare(`${b.namespace}/${b.name}`));
323}
324
325/**
326 * The root's data as the browser last had it. When a navigation fails in a
327 * way that takes the root's data with it, the error is still drawn in the
328 * person's own frame, signed in, not the visitor's. Never kept on the
329 * server, where one module serves everyone.
330 */
331let lastRoot: Awaited<ReturnType<typeof loader>> | undefined;
332
333export function Layout({ children }: { children: React.ReactNode }) {
334 const nonce = useNonce();
335 // Undefined when the root loader itself failed.
336 const loaded = useRouteLoaderData<typeof loader>("root");
337 const inBrowser = typeof document !== "undefined";
338 if (loaded && inBrowser) lastRoot = loaded;
339 const root = loaded ?? (inBrowser ? lastRoot : undefined);
340 const user = root?.user;
341 // A page opened with an access token signs its live sockets in with tickets (lib/live-socket.ts).
342 if (inBrowser) setLiveViaToken(Boolean(user?.token?.website));
343 const { pathname, search } = useLocation();
344 // Drawn around the error page too: a 404 keeps the sidebar out of a
345 // project or workspace the viewer cannot see.
346 const error = useRouteError();
347 const missing = isRouteErrorResponse(error) && error.status === 404;
348 // The billing page shows the full banner itself.
349 const paused = root?.shell?.compute && root.shell.workspace && !pathname.endsWith("/-/billing") && (
350 <SpikeBanner
351 compact
352 slug={root.shell.workspace.slug}
353 entitlements={{ paused: root.shell.compute.paused, spike: root.shell.compute.spike }}
354 owner={root.shell.compute.owner}
355 />
356 );
357 // On the few pages an account still confirming its address can open
358 // besides /confirm-email (policies, support, signing in): the way back.
359 const verify = user && awaitsConfirmation(user) && pathname !== "/confirm-email" && (
360 <p
361 role="status"
362 className="flex flex-wrap items-center justify-center gap-x-3 gap-y-1 border-b border-warn/30 bg-warn/10 px-4 py-2 text-sm"
363 >
364 <span>Confirm your email address to start using g1t.</span>
365 <Link to="/confirm-email" className="font-medium underline underline-offset-4">
366 Enter your code
367 </Link>
368 </p>
369 );
370 // A workspace that requires two-factor authentication of someone who
371 // has not turned it on: they keep their place, and cannot use it yet.
372 const held = user?.held && user.held.length > 0 && pathname !== "/settings/two-factor" && <PolicyNotice held={user.held} />;
373 const leaving = useLeaving();
374 // Auto, Light or Dark: as the cookie said when the page was drawn, or as just switched.
375 const theme = useThemeChoice(root?.theme);
376 // Which frame the page is drawn in (lib/chrome.ts): on its own, the app's, or the public one.
377 const frame = frameOf(pathname, {
378 signedIn: user != null && !awaitsConfirmation(user),
379 workspace: (user?.workspaces ?? []).length > 0,
380 });
381 const banner =
382 paused || verify || held ? (
383 <>
384 {paused}
385 {verify}
386 {held}
387 </>
388 ) : null;
389 return (
390 <html lang="en" data-theme={themeAttribute(theme)}>
391 <head>
392 <meta charSet="utf-8" />
393 <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
394 {/* The browser bar matches the page: one colour for a chosen theme, the system's for Auto. */}
395 {theme === "auto" ? (
396 <>
397 <meta name="theme-color" media="(prefers-color-scheme: light)" content={THEME_COLOR.light} />
398 <meta name="theme-color" media="(prefers-color-scheme: dark)" content={THEME_COLOR.dark} />
399 </>
400 ) : (
401 <meta name="theme-color" content={THEME_COLOR[theme]} />
402 )}
403 <meta name="mobile-web-app-capable" content="yes" />
404 <meta name="apple-mobile-web-app-capable" content="yes" />
405 <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
406 {/* The stylesheet before everything React Router preloads, so a slow
407 connection paints sooner. */}
408 <link rel="stylesheet" href={appCss} precedence="default" />
409 {root?.analyticsConsent && <meta name="g1t-analytics" content="consent" />}
410 <Meta />
411 <Links nonce={nonce} />
412 </head>
413 <body className="flex min-h-screen flex-col" data-frame={frame === "app" && user && root?.shell ? "app" : frame}>
414 {/* The first stop for the keyboard: past the menus, to the page. */}
415 <a
416 href="#content"
417 className="sr-only rounded-md bg-fg px-3 py-2 text-sm font-medium text-bg focus:not-sr-only focus:fixed focus:top-2 focus:left-2 focus:z-[70]"
418 >
419 Skip to content
420 </a>
421 {frame === "standalone" ? (
422 <StandaloneFrame>{children}</StandaloneFrame>
423 ) : frame === "app" && user && root?.shell ? (
424 <AppShell user={user} shell={root.shell} missing={missing} banner={banner} sidebarClosed={root.sidebarClosed}>
425 {children}
426 </AppShell>
427 ) : (
428 <>
429 <Progress />
430 <PublicHeader user={user} />
431 {banner}
432 <div id="content" tabIndex={-1} {...leaving} className={`grow outline-none ${leaving.className}`}>
433 {children}
434 </div>
435 <SiteFooter user={user} />
436 </>
437 )}
438 {/* Live notifications for the signed-in: the feed socket, toasts, the tab's count (components/notifications). */}
439 {user && !awaitsConfirmation(user) && (
440 <LiveNotifications workspace={root?.shell?.workspace?.slug ?? null} inbox={root?.shell?.inbox?.unread ?? null} />
441 )}
442 <AnalyticsConsent />
443 <ScrollRestoration nonce={nonce} />
444 <Scripts nonce={nonce} />
445 </body>
446 </html>
447 );
448}
449
450export default function App() {
451 const userId = useRouteLoaderData<typeof loader>("root")?.user?.id ?? null;
452 // Tell analytics who is signed in, once per change; signing out forgets them.
453 const lastUserId = useRef<string | null>(null);
454 useEffect(() => {
455 identify(userId, lastUserId.current);
456 lastUserId.current = userId;
457 }, [userId]);
458 return <Outlet />;
459}
460
461export function ErrorBoundary({ error }: Route.ErrorBoundaryProps) {
462 const location = useLocation();
463 const matches = useMatches();
464 const href = location.pathname + location.search + location.hash;
465 // A tab left open across a deploy: load the address again as a whole
466 // page, once, rather than show an error the reload fixes. A document load
467 // never reloads, so the server and the hydrating client render the same.
468 const reloadable = reloadFixes({
469 error,
470 status: isRouteErrorResponse(error) ? error.status : undefined,
471 clientNavigation: clientNavigated(location.key),
472 caughtByCatchAll: matches.at(-1)?.id === "routes/not-found",
473 });
474 // Already loaded again once, or the reload never started: show the page.
475 const tried = useMemo(() => reloadable && reloadedBefore(href), [reloadable, href]);
476 const [gaveUp, setGaveUp] = useState<string | null>(null);
477 const reload = reloadable && !tried && gaveUp !== href;
478 useEffect(() => {
479 if (!reload) return;
480 try {
481 sessionStorage.setItem(RELOADED_KEY, href);
482 } catch {
483 // No session storage: reload anyway; a document load never asks again.
484 }
485 window.location.assign(href);
486 const timer = window.setTimeout(() => setGaveUp(href), RELOAD_GIVE_UP_MS);
487 return () => window.clearTimeout(timer);
488 }, [reload, href]);
489 if (reload) {
490 return (
491 <PageMain className="mx-auto max-w-xl px-4 py-32 text-center text-sm text-muted" aria-busy="true">
492 <title>Loading · g1t</title>
493 Loading the latest version of g1t…
494 </PageMain>
495 );
496 }
497
498 let title = "Something went wrong";
499 let details = "An unexpected error occurred. Try again in a moment.";
500 let stack: string | undefined;
501
502 if (isRouteErrorResponse(error)) {
503 // The same page for something private and something missing.
504 if (error.status === 404) {
505 return (
506 <>
507 <title>Not found · g1t</title>
508 <NotFound data={error.data} />
509 </>
510 );
511 }
512 if (typeof error.data === "string" && error.data) {
513 details = error.data;
514 }
515 // A token asked for what needs a real sign-in (lib/website-token.ts).
516 if (isNeedsSignIn(error.data)) {
517 title = "This needs you to sign in";
518 details = error.data.message;
519 }
520 } else if (import.meta.env.DEV && error instanceof Error) {
521 details = error.message;
522 stack = error.stack;
523 }
524
525 return (
526 <PageMain className="mx-auto max-w-xl px-4 py-32 text-center">
527 <h1 className="text-2xl font-semibold tracking-tight">{title}</h1>
528 <p className="mt-3 text-muted">{details}</p>
529 <div className="mt-8">
530 <ButtonLink to="/" variant="quiet">
531 Back to home
532 </ButtonLink>
533 </div>
534 {stack && (
535 <pre className="mt-8 overflow-x-auto rounded-lg border border-line p-4 text-left text-xs">
536 <code>{stack}</code>
537 </pre>
538 )}
539 </PageMain>
540 );
541}