Repository Public
1"use client";2import { useRouter } from "next/navigation";3import { useEffect, useRef, useState } from "react";4import { apiDelete, apiGet, apiPost, type Schemas } from "@/api/client";5import { ApiError } from "@/api/errors";6import { useI18n } from "@/i18n";7import { createPasskey, WebAuthnError, webauthnSupported } from "@/lib/webauthn";8import { useSession } from "@/shell/session";9import { unwrapPublicKey } from "@/shell/stepup";10import { Badge, Banner, Button, Checkbox, EmptyState, Icon, KeyValue, LinkButton, Skeleton, TextField } from "@/ui";11import { beginSignIn, clientInfo, finishSignIn } from "./client";1213type Tx = Schemas["InvitationTransaction"];14type Phase =15 | { step: "loading" }16 | { step: "dead"; reason: "gone" | "none" | "rate" | "error"; ref?: string | undefined }17 | { step: "profile"; tx: Tx }18 | { step: "passkey"; tx: Tx }19 | { step: "link"; tx: Tx }20 | { step: "done"; user: Schemas["User"] };2122/**23 * Takes the invitation token out of the URL fragment. The fragment is removed from the address bar and from the24 * current history entry BEFORE anything else happens, so the token never lands in history, logs or referrers.25 */26export function takeTokenFromFragment(win: Pick<Window, "location" | "history">): string | null {27 const raw = win.location.hash.replace(/^#/, "");28 if (raw === "") return null;29 win.history.replaceState(null, "", win.location.pathname + win.location.search);30 let token = raw;31 try {32 token = decodeURIComponent(raw);33 } catch {34 /* keep the raw value */35 }36 return /^[A-Za-z0-9_-]{16,512}$/.test(token) ? token : "";37}3839// One exchange per page load, even when React runs effects twice in development.40let startOnce: Promise<Phase> | null = null;4142async function start(): Promise<Phase> {43 const token = takeTokenFromFragment(window);44 try {45 if (token === "") return { step: "dead", reason: "gone" };46 const tx = token ? await apiPost("/invitations/exchange", { body: { token, client: clientInfo() } }) : await apiGet("/invitations/transaction");47 return phaseFor(tx);48 } catch (e) {49 if (e instanceof ApiError) {50 if (e.status === 410) return { step: "dead", reason: "gone", ref: e.correlationId };51 if (e.status === 401 || e.status === 400) return { step: "dead", reason: token ? "gone" : "none", ref: e.correlationId };52 if (e.status === 429) return { step: "dead", reason: "rate", ref: e.correlationId };53 return { step: "dead", reason: "error", ref: e.correlationId };54 }55 return { step: "dead", reason: "error" };56 }57}58function phaseFor(tx: Tx): Phase {59 if (tx.requires_existing_account) return { step: "link", tx };60 return tx.profile_required ? { step: "profile", tx } : { step: "passkey", tx };61}6263export function Setup() {64 const { t, fmt } = useI18n();65 const router = useRouter();66 const session = useSession();67 const [phase, setPhase] = useState<Phase>({ step: "loading" });68 const [busy, setBusy] = useState(false);69 const [error, setError] = useState<{ text: string; ref?: string | undefined } | null>(null);70 const [handle, setHandle] = useState("");71 const [name, setName] = useState("");72 const [fieldErrors, setFieldErrors] = useState<{ handle?: string; name?: string }>({});73 const [confirm, setConfirm] = useState(false);74 const mounted = useRef(true);7576 useEffect(() => {77 mounted.current = true;78 startOnce ??= start().finally(() => window.setTimeout(() => (startOnce = null), 2000));79 void startOnce.then((p) => {80 if (!mounted.current) return;81 setPhase(p);82 if (p.step === "profile") {83 setHandle(p.tx.handle ?? "");84 setName(p.tx.display_name ?? "");85 }86 });87 return () => {88 mounted.current = false;89 };90 }, []);9192 const fail = (e: unknown) => {93 setBusy(false);94 if (e instanceof ApiError && e.status === 410) {95 setPhase({ step: "dead", reason: "gone", ref: e.correlationId });96 return;97 }98 if (e instanceof WebAuthnError) {99 setError({ text: e.reason === "cancelled" ? t("setup.error.cancelled") : e.reason === "duplicate" ? t("setup.error.duplicate") : e.reason === "unsupported" ? t("auth.unsupported") : t("setup.error.passkey") });100 } else if (e instanceof ApiError) {101 setError({ text: e.status === 409 ? t("setup.error.conflict") : e.status === 429 ? t("auth.error.rateLimited") : e.forbidden ? t("setup.error.wrongAccount") : e.code === "step_up_required" ? t("errors.stepUpCancelled") : e.network ? t("errors.network.body") : `${t("setup.error.generic")} (${e.code})`, ref: e.correlationId });102 } else setError({ text: t("setup.error.generic") });103 };104105 const saveProfile = async () => {106 const errs: { handle?: string; name?: string } = {};107 if (!/^[a-z0-9][a-z0-9._-]{1,31}$/.test(handle)) errs.handle = t("setup.profile.handleInvalid");108 if (name.trim().length < 1 || name.trim().length > 80) errs.name = t("setup.profile.nameInvalid");109 setFieldErrors(errs);110 if (errs.handle || errs.name) return;111 setBusy(true);112 setError(null);113 try {114 const tx = await apiPost("/invitations/transaction/profile", { body: { handle, display_name: name.trim() } });115 setBusy(false);116 setPhase({ step: "passkey", tx });117 } catch (e) {118 if (e instanceof ApiError && e.status === 409) {119 setBusy(false);120 setFieldErrors({ handle: t("setup.profile.handleTaken") });121 } else fail(e);122 }123 };124125 const createKey = async () => {126 setBusy(true);127 setError(null);128 try {129 const client = clientInfo();130 const challenge = await apiPost("/auth/webauthn/registration/begin", { body: {} });131 const credential = await createPasskey(unwrapPublicKey(challenge.public_key));132 const result = await apiPost("/auth/webauthn/registration/finish", { body: { challenge_id: challenge.challenge_id, credential, client, ...(client.label ? { label: client.label } : {}) } });133 if (result.auth) {134 await session.adopt(result.auth);135 setBusy(false);136 setPhase({ step: "done", user: result.auth.user });137 } else {138 setBusy(false);139 setPhase({ step: "dead", reason: "error" });140 }141 } catch (e) {142 fail(e);143 }144 };145146 const signInForLink = async () => {147 setBusy(true);148 setError(null);149 try {150 await session.adopt(await finishSignIn(await beginSignIn()));151 setBusy(false);152 } catch (e) {153 if (e instanceof ApiError && e.code === "webauthn_failed") {154 setBusy(false);155 setError({ text: t("auth.error.rejected"), ref: e.correlationId });156 } else fail(e);157 }158 };159160 const link = async () => {161 setBusy(true);162 setError(null);163 try {164 const r = await apiPost("/invitations/transaction/link", { body: { confirm: true } });165 await session.refresh();166 setBusy(false);167 setPhase({ step: "done", user: r.user });168 } catch (e) {169 fail(e);170 }171 };172173 const abandon = async () => {174 try {175 await apiDelete("/invitations/transaction");176 } catch {177 /* the transaction expires on its own */178 }179 setPhase({ step: "dead", reason: "none" });180 };181182 const errorBanner = error ? (183 <Banner tone="critical" role="alert"><span data-testid="setup-error">{error.text}</span>{error.ref ? <span className="faint mono"> · {error.ref}</span> : null}</Banner>184 ) : null;185186 if (phase.step === "loading") {187 return <div className="public-card" role="status" aria-label={t("common.loading")}><Skeleton width="60" height="lg" /><Skeleton width="80" /><Skeleton width="40" /></div>;188 }189190 if (phase.step === "dead") {191 const title = phase.reason === "gone" ? t("setup.dead.goneTitle") : phase.reason === "none" ? t("setup.dead.noneTitle") : phase.reason === "rate" ? t("setup.dead.rateTitle") : t("setup.dead.errorTitle");192 const body = phase.reason === "gone" ? t("setup.dead.goneBody") : phase.reason === "none" ? t("setup.dead.noneBody") : phase.reason === "rate" ? t("setup.dead.rateBody") : t("setup.dead.errorBody");193 return (194 <div className="public-card" data-testid="setup-dead" data-reason={phase.reason}>195 <h1>{title}</h1>196 <EmptyState icon={phase.reason === "gone" ? "offline" : "info"} title={t("setup.dead.what")} actions={<LinkButton href="/signin" icon="passkey">{t("setup.dead.signIn")}</LinkButton>}>197 {body}198 </EmptyState>199 {phase.ref ? <p className="mcc-hint">{t("errors.reference", { id: phase.ref })}</p> : null}200 </div>201 );202 }203204 if (phase.step === "done") {205 return (206 <div className="public-card" data-testid="setup-done">207 <h1>{t("setup.done.title")}</h1>208 <Banner tone="ok">{t("setup.done.body", { name: phase.user.display_name, role: t(`states.role.${phase.user.role}`) })}</Banner>209 <Button variant="primary" size="lg" onClick={() => router.replace("/")} autoFocus data-testid="setup-continue">{t("setup.done.continue")}</Button>210 <p className="mcc-hint">{t("setup.done.recovery")}</p>211 </div>212 );213 }214215 const tx = phase.tx;216 const identity = (217 <div className="identity-card" data-testid="setup-identity">218 <div className="row-between">219 <span className="caps">{t("setup.identity.heading")}</span>220 <Badge tone="info" icon="shield">{t(`states.role.${tx.role}`)}</Badge>221 </div>222 <KeyValue223 items={[224 { label: t("setup.identity.invitedBy"), value: tx.inviter_display_name },225 ...(tx.display_name ? [{ label: t("setup.identity.name"), value: tx.display_name }] : []),226 ...(tx.handle ? [{ label: t("setup.identity.handle"), value: <span className="mono">@{tx.handle}</span> }] : []),227 { label: t("setup.identity.role"), value: <span>{t(`states.role.${tx.role}`)} — <span className="muted">{t(`setup.roleHelp.${tx.role}`)}</span></span> },228 { label: t("setup.identity.purpose"), value: t(`setup.purpose.${tx.purpose}`) },229 { label: t("setup.identity.expires"), value: <span className="num">{fmt.time(tx.expires_at)}</span> },230 ]}231 />232 </div>233 );234 const steps = tx.requires_existing_account ? null : (235 <ol className="steps" aria-label={t("setup.steps.label")}>236 <li aria-current={phase.step === "profile" ? "step" : undefined}><span className="n">1</span>{t("setup.steps.identity")}</li>237 <li aria-hidden="true"><Icon name="chevron-right" size={12} /></li>238 <li aria-current={phase.step === "passkey" ? "step" : undefined}><span className="n">2</span>{t("setup.steps.passkey")}</li>239 </ol>240 );241242 if (phase.step === "profile") {243 return (244 <div className="public-card">245 <div className="stack-sm"><h1>{t("setup.title")}</h1><p className="lead">{t("setup.lead", { inviter: tx.inviter_display_name })}</p></div>246 {steps}247 {identity}248 {errorBanner}249 <form className="mcc-form" onSubmit={(e) => { e.preventDefault(); void saveProfile(); }} noValidate>250 <TextField label={t("setup.profile.name")} value={name} onChange={setName} required autoComplete="name" maxLength={80} error={fieldErrors.name} />251 <TextField label={t("setup.profile.handle")} hint={t("setup.profile.handleHint")} value={handle} onChange={(v) => setHandle(v.toLowerCase())} required mono autoComplete="username" autoCapitalize="none" spellCheck={false} maxLength={32} error={fieldErrors.handle} />252 <Button type="submit" variant="primary" size="lg" loading={busy} block data-testid="setup-profile-submit">{t("common.continue")}</Button>253 </form>254 <Button variant="ghost" size="sm" onClick={() => void abandon()}>{t("setup.abandon")}</Button>255 </div>256 );257 }258259 if (phase.step === "passkey") {260 return (261 <div className="public-card">262 <div className="stack-sm"><h1>{t("setup.passkey.title")}</h1><p className="lead">{t("setup.passkey.lead")}</p></div>263 {steps}264 {identity}265 {!webauthnSupported() ? <Banner tone="critical" role="alert">{t("auth.unsupported")}</Banner> : null}266 {errorBanner}267 <ul className="stack-sm muted">268 <li className="row"><Icon name="check" size={15} />{t("setup.passkey.point1")}</li>269 <li className="row"><Icon name="check" size={15} />{t("setup.passkey.point2")}</li>270 <li className="row"><Icon name="check" size={15} />{t("setup.passkey.point3")}</li>271 </ul>272 <Button variant="primary" size="lg" icon="passkey" loading={busy} onClick={() => void createKey()} block data-testid="setup-create-passkey">{t("setup.passkey.create")}</Button>273 <Button variant="ghost" size="sm" onClick={() => void abandon()}>{t("setup.abandon")}</Button>274 </div>275 );276 }277278 // link to an existing account279 const me = session.me;280 return (281 <div className="public-card">282 <div className="stack-sm"><h1>{t("setup.link.title")}</h1><p className="lead">{t("setup.link.lead", { inviter: tx.inviter_display_name })}</p></div>283 {identity}284 {errorBanner}285 {!me ? (286 <>287 <p className="muted">{t("setup.link.signInFirst")}</p>288 <Button variant="primary" size="lg" icon="passkey" loading={busy || session.status === "loading"} onClick={() => void signInForLink()} block data-testid="setup-link-signin">{t("auth.signIn")}</Button>289 </>290 ) : (291 <>292 <Banner tone="info">{t("setup.link.signedInAs", { name: me.user.display_name, handle: me.user.handle, role: t(`states.role.${me.user.role}`) })}</Banner>293 <Checkbox checked={confirm} onChange={setConfirm} label={t("setup.link.confirm", { role: t(`states.role.${tx.role}`), handle: me.user.handle })} />294 <Button variant="primary" size="lg" disabled={!confirm} loading={busy} onClick={() => void link()} block data-testid="setup-link-confirm">{t("setup.link.apply")}</Button>295 <p className="mcc-hint">{t("setup.link.stepUpNote")}</p>296 </>297 )}298 <Button variant="ghost" size="sm" onClick={() => void abandon()}>{t("setup.abandon")}</Button>299 </div>300 );301}302