Repository Public
1// Main application shell: sidebar · list · detail, top bar, sync health, live events, keyboard shortcuts.2import { useCallback, useEffect, useMemo, useRef, useState } from "react";3import { type ItemType, newItem } from "../../../../packages/protocol/src/index.ts";4import type { VaultView } from "../core/engine.ts";5import { confirmAction, dateTime, engine, errText, live, notice, relTime, safeSync, toast, useEngine } from "../state.ts";6import { ActivityPage } from "./Activity.tsx";7import { Badge, Brand, Btn, Callout, Dialog, Empty, ErrorText, Fingerprint, Icon, IconBtn, type IconName, Logo, useAction } from "./common.tsx";8import { ConnectPage } from "./Connect.tsx";9import { DevicesPage } from "./Devices.tsx";10import { GeneratorPage } from "./Generator.tsx";11import { ItemDetail } from "./ItemDetail.tsx";12import { type EditorTarget, ItemEditor, TypePicker } from "./ItemEditor.tsx";13import { ItemList } from "./ItemList.tsx";14import { applyFilter, canWrite, CATEGORIES, filterTitle, KIND_LABEL, keyOf, type Sort, sortItems } from "./itemmeta.ts";15import { RelayPage } from "./Relay.tsx";16import { SecurityCenter } from "./SecurityCenter.tsx";17import { SettingsPage } from "./Settings.tsx";18import { VaultsPage } from "./Vaults.tsx";1920type Page = "items" | "generator" | "security" | "vaults" | "shared" | "devices" | "activity" | "connect" | "settings";21type Editing = null | { picking: true } | (EditorTarget & { item: NonNullable<EditorTarget["item"]> });2223function NavBtn({ id, icon, label, n, active, onClick, badge }: { id: string; icon: IconName; label: string; n?: number; active: boolean; onClick: () => void; badge?: React.ReactNode }) {24 return (25 <li><button type="button" className={`nav-item${active ? " active" : ""}`} aria-current={active ? "page" : undefined} onClick={onClick} data-testid={`nav-${id}`}>26 <Icon name={icon} size={17} /><span className="nav-label ellipsis">{label}</span>{badge}{n !== undefined && <span className="nav-count">{n}</span>}27 </button></li>28 );29}3031const isTyping = (t: EventTarget | null) => { const el = t as HTMLElement | null; return !!el && (el.tagName === "INPUT" || el.tagName === "TEXTAREA" || el.tagName === "SELECT" || el.isContentEditable); };3233export function Shell({ onSignedOut }: { onSignedOut: () => void }) {34 const { version } = useEngine();35 const [page, setPage] = useState<Page>("items");36 const [filter, setFilter] = useState("all");37 const [selected, setSelected] = useState<string | null>(null);38 const [editing, setEditing] = useState<Editing>(null);39 const [query, setQuery] = useState("");40 const [sort, setSort] = useState<Sort>("title");41 const [drawer, setDrawer] = useState(false);42 const [syncOpen, setSyncOpen] = useState(false);43 const [online, setOnline] = useState(navigator.onLine);44 const dirty = useRef(false);45 const searchRef = useRef<HTMLInputElement>(null);4647 const all = useMemo(() => engine.list(), [version]);48 const vaults = useMemo(() => [...engine.vaults()].sort((a, b) => a.meta.name.localeCompare(b.meta.name)), [version]);49 const health = useMemo(() => engine.syncHealth(), [version]);50 const tags = useMemo(() => [...new Set(all.filter((v) => !v.item.trashedAt).flatMap((v) => v.item.tags))].sort((a, b) => a.localeCompare(b)), [all]);51 const searching = query.trim() !== "";52 const listed = useMemo(() => sortItems(searching ? engine.search(query) : applyFilter(all, filter), sort), [all, filter, query, sort, searching]);53 const selectedView = selected ? all.find((v) => keyOf(v) === selected) : undefined;54 const vaultName = useCallback((id: string) => vaults.find((v) => v.vaultId === id)?.meta.name ?? "Vault", [vaults]);55 useEffect(() => { if (selected && !selectedView) setSelected(null); }, [selected, selectedView]);5657 /** Runs a navigation unless the editor holds unsaved changes the user wants to keep. */58 const guard = useCallback(async (fn: () => void) => {59 if (dirty.current && !(await confirmAction({ title: "Discard unsaved changes?", danger: true, confirmLabel: "Discard changes", body: "The item you are editing has changes that were not saved." }))) return;60 dirty.current = false; fn();61 }, []);62 const goPage = (p: Page) => guard(() => { setPage(p); setEditing(null); setDrawer(false); if (p !== "items") setSelected(null); });63 const goFilter = (f: string) => guard(() => { setPage("items"); setFilter(f); setQuery(""); setEditing(null); setSelected(null); setDrawer(false); });64 const openItem = (key: string) => guard(() => { setPage("items"); setEditing(null); setSelected(key); });65 const defaultVault = (): VaultView | undefined => {66 const w = vaults.filter(canWrite), me = engine.identity?.accountId;67 return (filter.startsWith("vault:") ? w.find((v) => v.vaultId === filter.slice(6)) : undefined) ?? w.find((v) => v.ownerId === me && v.meta.kind === "personal") ?? w[0];68 };69 const newItemFlow = () => guard(() => {70 if (!defaultVault()) { toast("You have no vault you can write to.", "danger"); return; }71 setPage("items"); setDrawer(false); setEditing({ picking: true });72 });73 const pickType = (t: ItemType) => setEditing({ vaultId: defaultVault()!.vaultId, id: null, item: newItem(t) });74 const lock = () => guard(() => { notice.set(""); engine.lock(); });7576 // keyboard shortcuts77 useEffect(() => {78 const onKey = (e: KeyboardEvent) => {79 if (document.querySelector(".dialog")) return;80 if ((e.metaKey || e.ctrlKey) && !e.altKey && !e.shiftKey && e.key.toLowerCase() === "k") { e.preventDefault(); searchRef.current?.focus(); searchRef.current?.select(); return; }81 if (e.metaKey || e.ctrlKey || e.altKey || isTyping(e.target)) return;82 if (e.key === "/") { e.preventDefault(); searchRef.current?.focus(); }83 else if (e.key.toLowerCase() === "n") { e.preventDefault(); void newItemFlow(); }84 else if (e.key === "L" && e.shiftKey) { e.preventDefault(); void lock(); }85 };86 window.addEventListener("keydown", onKey);87 return () => window.removeEventListener("keydown", onKey);88 });8990 // live pokes + periodic sync91 useEffect(() => {92 let es: EventSource | undefined, retry: ReturnType<typeof setTimeout> | undefined, closed = false;93 const seenPairings = new Set<string>();94 const connect = () => {95 if (closed || !engine.unlocked) return;96 es = new EventSource("/api/v1/events");97 es.onmessage = (m) => {98 let e: any; try { e = JSON.parse(m.data); } catch { return; }99 if (!e || typeof e.type !== "string") return;100 if (e.type === "sync") void safeSync();101 else if (e.type === "devices") void safeSync(); // also detects that this device was revoked102 else if (e.type === "approval") toast("An agent request is waiting for your approval — open Connect & Agents.");103 else if (e.type === "shares") toast("An item was shared with you — open Shared.");104 else if (e.type === "pairing" && typeof e.pairingId === "string" && !seenPairings.has(e.pairingId)) { seenPairings.add(e.pairingId); toast("A device is asking to join your account — review it under Devices."); }105 live.dispatchEvent(new Event(e.type));106 };107 es.onerror = () => {108 if (es?.readyState !== EventSource.CLOSED) return; // the browser reconnects by itself109 es.close(); void safeSync(); // a refused stream usually means the session ended110 retry = setTimeout(connect, 20_000);111 };112 };113 connect();114 const tick = setInterval(() => void safeSync(), 60_000);115 const on = () => { setOnline(true); void safeSync(); }, off = () => setOnline(false), focus = () => void safeSync();116 window.addEventListener("online", on); window.addEventListener("offline", off); window.addEventListener("focus", focus);117 return () => { closed = true; es?.close(); clearTimeout(retry); clearInterval(tick); window.removeEventListener("online", on); window.removeEventListener("offline", off); window.removeEventListener("focus", focus); };118 }, []);119120 const count = (f: string) => applyFilter(all, f).length;121 const offline = !online || !health.online;122 const fActive = (f: string) => page === "items" && !searching && filter === f;123124 const sidebar = (125 <nav className={`sidebar${drawer ? " open" : ""}`} aria-label="Sections">126 <div className="sidebar-brand"><Brand size={26} /><IconBtn icon="x" label="Close menu" className="only-mobile" onClick={() => setDrawer(false)} /></div>127 <div className="sidebar-scroll">128 <ul className="nav-group">129 <NavBtn id="all" icon="grid" label="All Items" n={count("all")} active={fActive("all")} onClick={() => goFilter("all")} />130 <NavBtn id="fav" icon="star" label="Favorites" n={count("fav")} active={fActive("fav")} onClick={() => goFilter("fav")} />131 </ul>132 <div className="nav-title"><span>Vaults</span><button type="button" className="nav-link" onClick={() => goPage("vaults")} data-testid="nav-vaults">Manage</button></div>133 <ul className="nav-group">134 {vaults.map((v) => <NavBtn key={v.vaultId} id={`vault-${v.vaultId}`} icon="vault" label={v.meta.name} n={count(`vault:${v.vaultId}`)} active={fActive(`vault:${v.vaultId}`)} onClick={() => goFilter(`vault:${v.vaultId}`)}135 badge={<>{v.meta.kind !== "personal" && <span className="nav-kind">{KIND_LABEL[v.meta.kind]}</span>}{v.members.length > 1 && <span className="nav-shared" title={`Shared with ${v.members.length - 1} other member${v.members.length > 2 ? "s" : ""}`}><Icon name="users" size={13} /><span className="sr-only">shared</span></span>}</>} />)}136 </ul>137 <div className="nav-title"><span>Categories</span></div>138 <ul className="nav-group">139 {CATEGORIES.map((c) => <NavBtn key={c.id} id={`cat-${c.id}`} icon={c.icon} label={c.label} n={count(`cat:${c.id}`)} active={fActive(`cat:${c.id}`)} onClick={() => goFilter(`cat:${c.id}`)} />)}140 </ul>141 {tags.length > 0 && (142 <details className="nav-tags" open={filter.startsWith("tag:") || undefined}>143 <summary className="nav-title"><span>Tags</span><Icon name="chevron" size={13} /></summary>144 <ul className="nav-group">{tags.map((t) => <NavBtn key={t} id={`tag-${t}`} icon="tag" label={t} n={count(`tag:${t}`)} active={fActive(`tag:${t}`)} onClick={() => goFilter(`tag:${t}`)} />)}</ul>145 </details>146 )}147 <div className="nav-title"><span>Vault tools</span></div>148 <ul className="nav-group">149 <NavBtn id="shared" icon="inbox" label="Shared" active={page === "shared"} onClick={() => goPage("shared")} />150 <NavBtn id="security" icon="shield" label="Security Center" active={page === "security"} onClick={() => goPage("security")} />151 <NavBtn id="generator" icon="dice" label="Generator" active={page === "generator"} onClick={() => goPage("generator")} />152 <NavBtn id="devices" icon="device" label="Devices" active={page === "devices"} onClick={() => goPage("devices")} />153 <NavBtn id="activity" icon="activity" label="Activity" active={page === "activity"} onClick={() => goPage("activity")} />154 <NavBtn id="connect" icon="bot" label="Connect & Agents" active={page === "connect"} onClick={() => goPage("connect")} />155 <NavBtn id="trash" icon="trash" label="Trash" n={count("trash")} active={fActive("trash")} onClick={() => goFilter("trash")} />156 <NavBtn id="settings" icon="gear" label="Settings" active={page === "settings"} onClick={() => goPage("settings")} />157 </ul>158 </div>159 <div className="sidebar-foot">160 <span className="avatar" aria-hidden="true">{(engine.identity?.handle ?? "?")[0]!.toUpperCase()}</span>161 <span className="ellipsis" data-testid="me-handle">{engine.identity?.handle}</span>162 <IconBtn icon="lock" label="Lock (Shift+L)" onClick={lock} data-testid="lock-side" />163 </div>164 </nav>165 );166167 const emptyList = searching ? <Empty icon="search" title="No match">Nothing matches “{query.trim()}”. Search looks at titles, usernames, addresses, tags and notes — never at passwords.</Empty>168 : filter === "trash" ? <Empty icon="trash" title="Trash is empty">Items you move to the trash stay here until you restore or delete them.</Empty>169 : filter === "fav" ? <Empty icon="star" title="No favorites yet">Star an item to keep it one click away.</Empty>170 : all.length === 0 ? <Empty icon="vault" title="Your vault is empty" action={<Btn variant="primary" icon="plus" onClick={newItemFlow} data-testid="empty-new">Add your first item</Btn>}>Everything you add is encrypted on this device before it is synced.</Empty>171 : <Empty icon="grid" title="Nothing here yet" action={<Btn icon="plus" onClick={newItemFlow}>New item</Btn>}>No item in this section.</Empty>;172173 const chip = offline ? { cls: "offline", icon: "alert" as IconName, text: "Offline" } : health.warnings.length ? { cls: "warn", icon: "alert" as IconName, text: `${health.warnings.length} warning${health.warnings.length > 1 ? "s" : ""}` }174 : health.pending ? { cls: "pending", icon: "refresh" as IconName, text: `${health.pending} pending` } : { cls: "ok", icon: "check" as IconName, text: `Synced · ${relTime(health.lastSyncAt)}` };175176 return (177 <div className="shell" data-page={page} data-testid="app">178 <a className="skip-link" href="#main">Skip to content</a>179 {drawer && <div className="scrim" onClick={() => setDrawer(false)} aria-hidden="true" />}180 {sidebar}181 <div className="workspace">182 <header className="topbar">183 <IconBtn icon="menu" label="Open menu" className="only-mobile" onClick={() => setDrawer(true)} data-testid="menu" />184 <span className="only-mobile topbar-logo"><Logo size={26} /></span>185 <div className="search" role="search">186 <Icon name="search" size={16} />187 <input ref={searchRef} type="search" value={query} placeholder="Search" aria-label="Search items" autoComplete="off" spellCheck={false} data-testid="search"188 onChange={(e) => { const q = e.target.value; if (page !== "items" || editing) { void guard(() => { setPage("items"); setEditing(null); setQuery(q); }); } else setQuery(q); }}189 onKeyDown={(e) => { if (e.key === "Escape") { setQuery(""); (e.target as HTMLInputElement).blur(); } else if (e.key === "ArrowDown" || e.key === "Enter") { e.preventDefault(); document.querySelector<HTMLElement>('.item-row[tabindex="0"]')?.focus(); } }} />190 <kbd className="hide-mobile">/</kbd>191 </div>192 <Btn variant="primary" icon="plus" onClick={newItemFlow} className="new-btn" data-testid="new-item" title="New item (N)"><span className="hide-mobile">New item</span></Btn>193 <button type="button" className={`sync-chip ${chip.cls}`} onClick={() => setSyncOpen(true)} data-testid="sync-chip" aria-label={`Sync status: ${chip.text}. Open sync health.`}>194 <Icon name={chip.icon} size={14} /><span className="hide-mobile">{chip.text}</span>195 </button>196 <IconBtn icon="lock" label="Lock (Shift+L)" onClick={lock} data-testid="lock" className="hide-mobile" />197 </header>198 {offline && <div className="offline-banner" role="status"><Icon name="alert" size={15} /> The server cannot be reached. You can keep working: changes are stored encrypted on this device and sent when the connection returns.</div>}199200 <main id="main" className="main" tabIndex={-1}>201 {page === "items" ? (202 <div className="items-view" data-pane={editing || selectedView ? "detail" : "list"}>203 <ItemList items={listed} selected={editing ? null : selected} onOpen={openItem} sort={sort} onSort={setSort} title={searching ? "Search results" : filterTitle(filter, vaults)} empty={emptyList} vaultName={vaultName} showVault={vaults.length > 1 && (searching || !filter.startsWith("vault:"))} />204 <section className="detail-pane" aria-label="Item">205 {editing && "picking" in editing ? <TypePicker onPick={pickType} onCancel={() => setEditing(null)} />206 : editing ? <ItemEditor key={`${editing.vaultId}/${editing.id ?? "new"}`} target={editing} vaults={vaults} items={all} onDirty={(d) => { dirty.current = d; }} onCancel={() => guard(() => setEditing(null))} onSaved={(k) => { dirty.current = false; setEditing(null); setSelected(k); toast("Saved", "ok"); }} />207 : selectedView ? <ItemDetail key={selected} view={selectedView} vaults={vaults} onEdit={() => setEditing({ vaultId: selectedView.vaultId, id: selectedView.id, item: selectedView.item })} onBack={() => setSelected(null)} onOpen={(k) => setSelected(k)} onClosed={() => setSelected(null)} />208 : <div className="detail-empty"><Logo size={56} /><p className="serif">Select an item</p><p className="muted">or press <kbd>N</kbd> to create one · <kbd>/</kbd> to search</p></div>}209 </section>210 </div>211 ) : page === "generator" ? <GeneratorPage />212 : page === "security" ? <SecurityCenter items={all} onOpen={openItem} onBack={() => goPage("items")} />213 : page === "vaults" ? <VaultsPage vaults={vaults} items={all} onOpenVault={(id) => goFilter(`vault:${id}`)} onBack={() => goPage("items")} />214 : page === "shared" ? <RelayPage onBack={() => goPage("items")} />215 : page === "devices" ? <DevicesPage onBack={() => goPage("items")} />216 : page === "activity" ? <ActivityPage onBack={() => goPage("items")} />217 : page === "connect" ? <ConnectPage onBack={() => goPage("items")} />218 : <SettingsPage vaults={vaults} onBack={() => goPage("items")} onSignedOut={onSignedOut} />}219 </main>220221 <nav className="tabbar" aria-label="Primary">222 {([["items", "grid", "Items"], ["generator", "dice", "Generator"], ["security", "shield", "Security"], ["settings", "gear", "Settings"]] as const).map(([p, icon, label]) => (223 <button key={p} type="button" className={page === p ? "active" : ""} aria-current={page === p ? "page" : undefined} onClick={() => (p === "items" ? guard(() => { setPage("items"); setEditing(null); setSelected(null); }) : goPage(p))} data-testid={`tab-${p}`}><Icon name={icon} size={21} /><span>{label}</span></button>224 ))}225 <button type="button" onClick={lock} data-testid="tab-lock"><Icon name="lock" size={21} /><span>Lock</span></button>226 </nav>227 </div>228 {syncOpen && <SyncPanel onClose={() => setSyncOpen(false)} offline={offline} />}229 </div>230 );231}232233function SyncPanel({ onClose, offline }: { onClose: () => void; offline: boolean }) {234 useEngine();235 const h = engine.syncHealth();236 const [digest, setDigest] = useState("");237 const act = useAction();238 const syncNow = () => act.run(async () => { try { await engine.sync(); } catch (e) { throw new Error(errText(e)); } if (!engine.syncHealth().online) throw new Error("The server cannot be reached. Pending changes stay queued on this device."); toast("Synced", "ok"); });239 const verify = () => act.run(async () => { setDigest(await engine.stateDigest()); });240 return (241 <Dialog title="Sync health" onClose={onClose} footer={<><Btn icon="shield" onClick={verify} disabled={act.busy} data-testid="verify-state">Verify sync state</Btn><Btn variant="primary" icon="refresh" onClick={syncNow} busy={act.busy} data-testid="sync-now">Sync now</Btn></>}>242 <div className="stack" data-testid="sync-panel">243 <dl className="kv">244 <dt>Connection</dt><dd>{offline ? <Badge kind="brass" icon="alert">offline</Badge> : <Badge kind="ok" icon="check">online</Badge>}</dd>245 <dt>Last successful sync</dt><dd>{h.lastSyncAt ? `${dateTime(h.lastSyncAt)} (${relTime(h.lastSyncAt)})` : "never"}</dd>246 <dt>Pending writes</dt><dd data-testid="sync-pending">{h.pending}</dd>247 {h.undecryptable > 0 && <><dt>Rejected records</dt><dd>{h.undecryptable}</dd></>}248 </dl>249 {h.warnings.length === 0 ? <p className="muted">No warning. Everything this device received was authenticated.</p> : (250 <div className="stack">{h.warnings.map((w, i) => <Callout key={i} kind={w.startsWith("SECURITY:") || /rollback|forged|rejected/i.test(w) ? "security" : "warn"} title="Warning"><p>{w}</p></Callout>)}</div>251 )}252 <ErrorText text={act.error} />253 {digest && (254 <Callout kind="info" title="State digest of this device">255 <p><Fingerprint value={digest} big /></p>256 <p>Open the same panel on another device that has finished syncing. Identical digits mean both hold exactly the same encrypted records; a difference that persists after “Sync now” on both means the server is showing them different states.</p>257 </Callout>258 )}259 </div>260 </Dialog>261 );262}263