SPB Git

Repository Public

Setup.tsx 13.7 KB 302 lines tsx

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
Files main
Menu

Theme