Repository Public
1"use client";2import { useState } from "react";3import { apiDelete, apiPost, type Schemas } from "@/api/client";4import { useApiList } from "@/api/query";5import { useI18n } from "@/i18n";6import { useMe, useSession } from "@/shell/session";7import { Banner, Button, Combobox, ConfirmDialog, CopyButton, DataStamp, Dialog, ErrorState, KeyValue, LoadMore, QrCode, SelectField, SkeletonRows, StateDot, TextAreaField, TextField, type Tone } from "@/ui";8import { Gate } from "./SettingsFrame";9import { HANDLE_RE, parseTtl } from "./logic";10import { RowTable, type RowColumn } from "./RowTable";11import { useAct } from "./useAct";1213type Invitation = Schemas["Invitation"];14type Role = Schemas["UserRole"];15const STATUSES: Schemas["InvitationStatus"][] = ["pending", "exchanged", "completed", "expired", "revoked"];16const STATUS_TONE: Record<Schemas["InvitationStatus"], Tone> = { pending: "info", exchanged: "warning", completed: "ok", expired: "offline", revoked: "offline" };17const ROLES: Role[] = ["viewer", "operator", "admin", "owner"];1819export function InvitationsSection() {20 return <Gate permission="invitations.manage"><Invitations /></Gate>;21}2223function Invitations() {24 const { t, fmt } = useI18n();25 const [status, setStatus] = useState<Schemas["InvitationStatus"] | "">("");26 const list = useApiList("/invitations", { query: { limit: 50, ...(status ? { status } : {}) } });27 const { busy, act } = useAct();28 const [creating, setCreating] = useState(false);29 const [revoke, setRevoke] = useState<Invitation | null>(null);3031 const columns: RowColumn<Invitation>[] = [32 { id: "status", header: t("common.state"), cell: (i) => <StateDot tone={STATUS_TONE[i.status]} label={t(`settings.invitations.status.${i.status}`)} /> },33 { id: "who", header: t("settings.invitations.invitee"), cell: (i) => (i.display_name || i.handle ? <span>{i.display_name ?? ""} {i.handle ? <span className="mono muted">@{i.handle}</span> : null}</span> : <span className="faint">{t("settings.invitations.toBeChosen")}</span>) },34 { id: "role", header: t("settings.role"), cell: (i) => t(`states.role.${i.role}`) },35 { id: "purpose", header: t("settings.invitations.purpose"), hide: "md", cell: (i) => t(`settings.invitations.purposes.${i.purpose}`) },36 { id: "by", header: t("settings.invitations.createdBy"), hide: "md", cell: (i) => i.created_by_display_name ?? <span className="faint">{t("settings.invitations.outOfBand")}</span> },37 { id: "expires", header: t("settings.invitations.expires"), hide: "sm", cell: (i) => <time dateTime={i.expires_at} className="num nowrap" title={fmt.dateTime(i.expires_at, { seconds: true })}>{fmt.relative(i.expires_at)}</time> },38 { id: "fails", header: t("settings.invitations.failed"), align: "right", hide: "md", cell: (i) => i.failed_attempts },39 { id: "act", header: t("common.actions"), srOnlyHeader: true, shrink: true, cell: (i) => (i.status === "pending" || i.status === "exchanged" ? <Button size="sm" variant="danger" onClick={() => setRevoke(i)} data-testid="invite-revoke">{t("settings.revoke")}</Button> : null) },40 ];4142 return (43 <div className="stack-lg" data-testid="screen-settings-invitations">44 <section className="section" aria-labelledby="set-inv">45 <div className="section-head">46 <h2 id="set-inv">{t("settings.invitations.title")}</h2>47 <div className="row"><DataStamp at={list.ready ? list.updatedAt : undefined} /><Button variant="primary" icon="plus" onClick={() => setCreating(true)} data-testid="invite-create">{t("settings.invitations.create")}</Button></div>48 </div>49 <p className="muted">{t("settings.invitations.intro")}</p>50 <div className="toolbar"><SelectField label={t("common.state")} value={status} onChange={setStatus} options={[{ value: "", label: t("common.all") }, ...STATUSES.map((s) => ({ value: s, label: t(`settings.invitations.status.${s}`) }))]} data-testid="invite-filter-status" /></div>51 {list.error && !list.ready ? <ErrorState error={list.error} onRetry={list.refetch} /> : !list.ready ? <SkeletonRows rows={4} /> : (52 <RowTable caption={t("settings.invitations.title")} columns={columns} rows={list.items} rowKey={(i) => i.id} rowProps={(i) => ({ "data-testid": "invite-row", "data-status": i.status, "data-invitation-id": i.id })} empty={<span className="muted">{t("settings.invitations.empty")}</span>} />53 )}54 <LoadMore hasMore={list.hasMore} loading={list.loadingMore} onMore={list.loadMore} />55 </section>56 {creating ? <InviteDialog onClose={() => setCreating(false)} /> : null}57 <ConfirmDialog open={revoke !== null} onClose={() => setRevoke(null)} danger busy={busy} title={t("settings.invitations.revokeTitle")} body={t("settings.invitations.revokeBody")} confirmLabel={t("settings.revoke")}58 onConfirm={() => { if (revoke) void act(() => apiDelete("/invitations/{id}", { path: { id: revoke.id } }), { ok: t("settings.invitations.revoked"), invalidate: ["/invitations"] }).then(() => setRevoke(null)); }} />59 </div>60 );61}6263/**64 * Creates an invitation, then shows the setup link ONCE (copy + locally drawn QR code). The link lives only in the65 * state of this dialog: it is never cached, stored or put in a URL, and it is dropped when the dialog closes.66 */67export function InviteDialog({ onClose, targetUser }: { onClose: () => void; targetUser?: Schemas["User"] }) {68 const { t, fmt } = useI18n();69 const me = useMe();70 const { can } = useSession();71 const { busy, act } = useAct();72 const users = useApiList("/users", { query: { limit: 200 } }, { enabled: can("users.manage") && !targetUser });73 const [role, setRole] = useState<Role>(targetUser?.role ?? "viewer");74 const [handle, setHandle] = useState("");75 const [name, setName] = useState("");76 const [note, setNote] = useState("");77 const [ttl, setTtl] = useState("15");78 const [target, setTarget] = useState<string | null>(targetUser?.id ?? null);79 const [tried, setTried] = useState(false);80 const [created, setCreated] = useState<Schemas["InvitationCreated"] | null>(null);8182 const ttlValue = parseTtl(ttl);83 const handleError = handle && !HANDLE_RE.test(handle) ? t("settings.invitations.handleInvalid") : undefined;84 const ttlError = ttlValue === null ? t("settings.invitations.ttlInvalid") : undefined;85 // an admin can neither create nor modify an owner: do not offer it (the server refuses it anyway)86 const roles = ROLES.filter((r) => r !== "owner" || me.user.role === "owner");8788 const submit = async () => {89 setTried(true);90 if (handleError || ttlValue === null) return;91 const body: Schemas["CreateInvitationRequest"] = {92 role, ttl_minutes: ttlValue,93 ...(target ? { target_user_id: target } : { ...(handle ? { handle } : {}), ...(name.trim() ? { display_name: name.trim() } : {}) }),94 ...(note.trim() ? { note: note.trim() } : {}),95 };96 const r = await act(() => apiPost("/invitations", { body }), { invalidate: ["/invitations"] });97 if (r.ok) setCreated(r.value);98 };99100 if (created) {101 const inv = created.invitation;102 return (103 <Dialog open onClose={onClose} title={t("settings.invitations.linkTitle")} size="wide" dismissable={false}104 footer={<Button variant="primary" onClick={onClose} data-testid="invite-done">{t("settings.invitations.done")}</Button>}>105 <Banner tone="warning" icon="warning" role="alert">{t("settings.invitations.linkWarning")}</Banner>106 <div className="set-once">107 <div className="stack grow">108 <div className="stack-sm">109 <span className="caps">{t("settings.invitations.link")}</span>110 <code className="set-secret" data-testid="invite-link">{created.setup_url}</code>111 <div className="row"><CopyButton text={created.setup_url}>{t("settings.invitations.copyLink")}</CopyButton></div>112 </div>113 <KeyValue items={[114 { label: t("settings.role"), value: t(`states.role.${inv.role}`) },115 { label: t("settings.invitations.purpose"), value: t(`settings.invitations.purposes.${inv.purpose}`) },116 ...(inv.handle ? [{ label: t("settings.handle"), value: <span className="mono">@{inv.handle}</span> }] : []),117 { label: t("settings.invitations.expires"), value: <span className="num">{fmt.dateTime(inv.expires_at, { seconds: true })}</span> },118 { label: t("settings.invitations.usage"), value: t("settings.invitations.singleUse") },119 ]} />120 </div>121 <div className="stack-sm set-qr" data-testid="invite-qr">122 <QrCode value={created.setup_url} label={t("settings.invitations.qrLabel")} />123 <span className="mcc-hint">{t("settings.invitations.qrHint")}</span>124 </div>125 </div>126 </Dialog>127 );128 }129130 return (131 <Dialog open onClose={onClose} title={targetUser ? t("settings.invitations.recoveryTitle", { name: targetUser.display_name }) : t("settings.invitations.createTitle")} description={t("settings.invitations.createBody")} size="wide" dismissable={!busy}132 footer={<><Button onClick={onClose} disabled={busy}>{t("common.cancel")}</Button><Button variant="primary" loading={busy} onClick={() => void submit()} data-testid="invite-submit">{t("settings.invitations.submit")}</Button></>}>133 <form className="mcc-form" onSubmit={(e) => { e.preventDefault(); void submit(); }} noValidate>134 <div className="mcc-form-row">135 <SelectField label={t("settings.role")} hint={t(`settings.roleHelp.${role}`)} value={role} onChange={setRole} options={roles.map((r) => ({ value: r, label: t(`states.role.${r}`) }))} data-testid="invite-role" />136 <TextField label={t("settings.invitations.ttl")} hint={t("settings.invitations.ttlHint")} value={ttl} onChange={setTtl} inputMode="numeric" mono required error={tried ? ttlError : undefined} data-testid="invite-ttl" />137 </div>138 {targetUser ? (139 <Banner tone="info">{t("settings.invitations.targetFixed", { name: targetUser.display_name, handle: targetUser.handle })}</Banner>140 ) : (141 <>142 {can("users.manage") ? (143 <Combobox label={t("settings.invitations.target")} hint={t("settings.invitations.targetHint")} options={users.items.map((u) => ({ value: u.id, label: `${u.display_name} (@${u.handle})`, hint: t(`states.role.${u.role}`) }))} value={target} onChange={setTarget} placeholder={t("settings.invitations.targetNone")} />144 ) : null}145 {!target ? (146 <div className="mcc-form-row">147 <TextField label={t("settings.invitations.handle")} hint={t("settings.invitations.handleHint")} value={handle} onChange={(v) => setHandle(v.toLowerCase())} mono autoCapitalize="none" spellCheck={false} maxLength={32} error={handleError} data-testid="invite-handle" />148 <TextField label={t("settings.invitations.name")} hint={t("settings.invitations.nameHint")} value={name} onChange={setName} maxLength={80} data-testid="invite-name" />149 </div>150 ) : null}151 </>152 )}153 <TextAreaField label={t("settings.invitations.note")} hint={t("settings.invitations.noteHint")} value={note} onChange={setNote} maxLength={300} />154 </form>155 </Dialog>156 );157}158