@nexys/user-management-web 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/README.md +61 -0
  2. package/components.json +21 -0
  3. package/package.json +66 -0
  4. package/src/components/audit/audit-log-table.test.tsx +98 -0
  5. package/src/components/audit/audit-log-table.tsx +227 -0
  6. package/src/components/auth/accept-invitation-card.tsx +104 -0
  7. package/src/components/auth/forgot-password-form.tsx +93 -0
  8. package/src/components/auth/reset-password-form.tsx +144 -0
  9. package/src/components/auth/sign-in-form.test.tsx +164 -0
  10. package/src/components/auth/sign-in-form.tsx +504 -0
  11. package/src/components/auth/sign-up-form.tsx +124 -0
  12. package/src/components/layout/app-shell.tsx +189 -0
  13. package/src/components/layout/auth-shell.tsx +28 -0
  14. package/src/components/layout/theme-toggle.tsx +55 -0
  15. package/src/components/layout/user-menu.tsx +84 -0
  16. package/src/components/primitives/empty-state.tsx +40 -0
  17. package/src/components/primitives/page-header.tsx +27 -0
  18. package/src/components/primitives/spinner.tsx +28 -0
  19. package/src/components/profile/api-tokens-card.tsx +238 -0
  20. package/src/components/profile/change-password-form.tsx +159 -0
  21. package/src/components/profile/passkeys-card.tsx +186 -0
  22. package/src/components/profile/profile-card.tsx +107 -0
  23. package/src/components/profile/refresh-tokens-list.tsx +176 -0
  24. package/src/components/profile/two-factor-card.tsx +230 -0
  25. package/src/components/projects/project-consents.tsx +577 -0
  26. package/src/components/projects/project-create-dialog.tsx +193 -0
  27. package/src/components/projects/project-detail-tabs.tsx +64 -0
  28. package/src/components/projects/project-email-templates.tsx +285 -0
  29. package/src/components/projects/project-notices.tsx +461 -0
  30. package/src/components/projects/project-settings.tsx +1059 -0
  31. package/src/components/projects/project-tenants.tsx +108 -0
  32. package/src/components/projects/projects-table.test.tsx +109 -0
  33. package/src/components/projects/projects-table.tsx +240 -0
  34. package/src/components/roles/role-badge.tsx +91 -0
  35. package/src/components/roles/role-select.tsx +76 -0
  36. package/src/components/tenants/tenant-create-dialog.tsx +164 -0
  37. package/src/components/tenants/tenant-detail-tabs.tsx +51 -0
  38. package/src/components/tenants/tenant-members.tsx +587 -0
  39. package/src/components/tenants/tenant-roles.test.tsx +107 -0
  40. package/src/components/tenants/tenant-roles.tsx +418 -0
  41. package/src/components/tenants/tenant-settings.tsx +392 -0
  42. package/src/components/tenants/tenants-table.test.tsx +81 -0
  43. package/src/components/tenants/tenants-table.tsx +247 -0
  44. package/src/components/ui/alert.tsx +52 -0
  45. package/src/components/ui/avatar.tsx +46 -0
  46. package/src/components/ui/badge.tsx +32 -0
  47. package/src/components/ui/button.tsx +64 -0
  48. package/src/components/ui/card.tsx +65 -0
  49. package/src/components/ui/dialog.tsx +99 -0
  50. package/src/components/ui/dropdown-menu.tsx +97 -0
  51. package/src/components/ui/field.tsx +44 -0
  52. package/src/components/ui/input.tsx +23 -0
  53. package/src/components/ui/label.tsx +19 -0
  54. package/src/components/ui/select.tsx +87 -0
  55. package/src/components/ui/separator.tsx +22 -0
  56. package/src/components/ui/skeleton.tsx +13 -0
  57. package/src/components/ui/switch.tsx +29 -0
  58. package/src/components/ui/table.tsx +87 -0
  59. package/src/components/ui/tabs.tsx +51 -0
  60. package/src/components/ui/textarea.tsx +22 -0
  61. package/src/components/ui/tooltip.tsx +27 -0
  62. package/src/components/users/user-create-dialog.tsx +229 -0
  63. package/src/components/users/user-delete-dialog.tsx +88 -0
  64. package/src/components/users/user-detail.tsx +818 -0
  65. package/src/components/users/users-table.test.tsx +107 -0
  66. package/src/components/users/users-table.tsx +386 -0
  67. package/src/context/auth-context.tsx +127 -0
  68. package/src/context/theme-context.test.tsx +78 -0
  69. package/src/context/theme-context.tsx +110 -0
  70. package/src/hooks/use-call.ts +60 -0
  71. package/src/index.ts +160 -0
  72. package/src/lib/error-message.ts +16 -0
  73. package/src/lib/utils.test.ts +61 -0
  74. package/src/lib/utils.ts +79 -0
  75. package/src/lib/webauthn.ts +36 -0
  76. package/src/styles.css +107 -0
  77. package/src/test-setup.ts +5 -0
  78. package/tailwind.preset.cjs +15 -0
@@ -0,0 +1,107 @@
1
+ /// <reference lib="dom" />
2
+ import { afterEach, describe, expect, mock, test } from "bun:test";
3
+
4
+ import { render, screen, waitFor } from "@testing-library/react";
5
+
6
+ import { createClient } from "@nexys/user-management-client";
7
+
8
+ import { AuthProvider } from "../../context/auth-context.js";
9
+ import { UsersTable } from "./users-table.js";
10
+
11
+ const user = (id: string, name: string, email: string) => ({
12
+ id,
13
+ name,
14
+ firstName: name,
15
+ lastName: null,
16
+ email,
17
+ role: "user",
18
+ status: "active",
19
+ type: "human",
20
+ providers: ["credential"],
21
+ deletedAt: null,
22
+ createdAt: "2026-01-01T00:00:00Z",
23
+ updatedAt: "2026-01-01T00:00:00Z",
24
+ });
25
+
26
+ const ROWS = [
27
+ user("u1", "alice", "alice@example.com"),
28
+ user("u2", "Bob", "bob@example.com"),
29
+ ];
30
+
31
+ afterEach(() => {
32
+ document.body.innerHTML = "";
33
+ });
34
+
35
+ const clientFor = (requests: string[]) => {
36
+ const fetcher = mock(async (input: RequestInfo | URL) => {
37
+ const url = input.toString();
38
+ if (url.endsWith("/api/me")) {
39
+ return new Response(JSON.stringify({ code: "unauth" }), { status: 401 });
40
+ }
41
+ if (url.includes("/api/admin/users")) {
42
+ requests.push(url);
43
+ return new Response(
44
+ JSON.stringify({ total: ROWS.length, rows: ROWS }),
45
+ { status: 200, headers: { "content-type": "application/json" } }
46
+ );
47
+ }
48
+ return new Response("nope", { status: 404 });
49
+ });
50
+ return createClient({
51
+ baseUrl: "https://auth.example.com",
52
+ fetch: fetcher as unknown as typeof fetch,
53
+ });
54
+ };
55
+
56
+ describe("<UsersTable />", () => {
57
+ test("requests the list sorted by name A–Z by default", async () => {
58
+ const requests: string[] = [];
59
+ render(
60
+ <AuthProvider client={clientFor(requests)} refreshIntervalMs={0}>
61
+ <UsersTable />
62
+ </AuthProvider>
63
+ );
64
+
65
+ await waitFor(() => {
66
+ expect(screen.getByText("alice")).toBeTruthy();
67
+ });
68
+ expect(screen.getByText("Bob")).toBeTruthy();
69
+
70
+ const listUrl = requests.find((u) => u.includes("/api/admin/users"));
71
+ expect(listUrl).toBeTruthy();
72
+ expect(listUrl).toContain("sortBy=name");
73
+ expect(listUrl).toContain("order=asc");
74
+ // No status filter selected → no status param sent.
75
+ expect(listUrl).not.toContain("status=");
76
+ });
77
+
78
+ test("shows the sort and status filter controls in the toolbar", async () => {
79
+ const requests: string[] = [];
80
+ render(
81
+ <AuthProvider client={clientFor(requests)} refreshIntervalMs={0}>
82
+ <UsersTable />
83
+ </AuthProvider>
84
+ );
85
+
86
+ await waitFor(() => {
87
+ expect(screen.getByLabelText("Sort by")).toBeTruthy();
88
+ });
89
+ expect(screen.getByLabelText("Filter by status")).toBeTruthy();
90
+ });
91
+
92
+ test("hides the status filter when a fixed status prop is given", async () => {
93
+ const requests: string[] = [];
94
+ render(
95
+ <AuthProvider client={clientFor(requests)} refreshIntervalMs={0}>
96
+ <UsersTable status="active" />
97
+ </AuthProvider>
98
+ );
99
+
100
+ await waitFor(() => {
101
+ expect(screen.getByText("alice")).toBeTruthy();
102
+ });
103
+ expect(screen.queryByLabelText("Filter by status")).toBeNull();
104
+ const listUrl = requests.find((u) => u.includes("/api/admin/users"));
105
+ expect(listUrl).toContain("status=active");
106
+ });
107
+ });
@@ -0,0 +1,386 @@
1
+ import {
2
+ adminListUsers,
3
+ adminRevokeUserTokens,
4
+ adminSetUserRole,
5
+ adminSetUserStatus,
6
+ type AdminUserRow,
7
+ type AdminUsersSortBy,
8
+ type UserRole,
9
+ type UserStatus,
10
+ } from "@nexys/user-management-client";
11
+ import {
12
+ AlertCircle,
13
+ ArrowUpDown,
14
+ Eye,
15
+ KeyRound,
16
+ ListFilter,
17
+ MoreHorizontal,
18
+ Power,
19
+ RefreshCcw,
20
+ Search,
21
+ UserCheck,
22
+ Users,
23
+ } from "lucide-react";
24
+ import { useMemo, useState } from "react";
25
+
26
+ import { useUmClient } from "../../context/auth-context.js";
27
+ import { useCall } from "../../hooks/use-call.js";
28
+ import { errorMessage } from "../../lib/error-message.js";
29
+ import { formatRelative, initialsOf } from "../../lib/utils.js";
30
+ import { EmptyState } from "../primitives/empty-state.js";
31
+ import { StatusBadge, UserRoleBadge } from "../roles/role-badge.js";
32
+ import { UserRoleSelect } from "../roles/role-select.js";
33
+ import { Alert, AlertDescription } from "../ui/alert.js";
34
+ import { Avatar, AvatarFallback } from "../ui/avatar.js";
35
+ import { Button } from "../ui/button.js";
36
+ import {
37
+ DropdownMenu,
38
+ DropdownMenuContent,
39
+ DropdownMenuItem,
40
+ DropdownMenuLabel,
41
+ DropdownMenuSeparator,
42
+ DropdownMenuTrigger,
43
+ } from "../ui/dropdown-menu.js";
44
+ import { Input } from "../ui/input.js";
45
+ import {
46
+ Select,
47
+ SelectContent,
48
+ SelectItem,
49
+ SelectTrigger,
50
+ SelectValue,
51
+ } from "../ui/select.js";
52
+ import { Skeleton } from "../ui/skeleton.js";
53
+ import {
54
+ Table,
55
+ TableBody,
56
+ TableCell,
57
+ TableHead,
58
+ TableHeader,
59
+ TableRow,
60
+ } from "../ui/table.js";
61
+ import { Badge } from "../ui/badge.js";
62
+ import { UserCreateDialog } from "./user-create-dialog.js";
63
+
64
+ const NEXT_STATUS: Record<UserStatus, UserStatus> = {
65
+ active: "inactive",
66
+ inactive: "active",
67
+ pending: "active",
68
+ };
69
+
70
+ /** "<sortBy>-<order>" values the sort select offers, A–Z first. */
71
+ const SORT_OPTIONS: { value: string; label: string }[] = [
72
+ { value: "name-asc", label: "Name A–Z" },
73
+ { value: "name-desc", label: "Name Z–A" },
74
+ { value: "email-asc", label: "Email A–Z" },
75
+ { value: "email-desc", label: "Email Z–A" },
76
+ { value: "createdAt-desc", label: "Newest first" },
77
+ { value: "createdAt-asc", label: "Oldest first" },
78
+ ];
79
+
80
+ const STATUS_OPTIONS: { value: string; label: string }[] = [
81
+ { value: "all", label: "All statuses" },
82
+ { value: "active", label: "Active" },
83
+ { value: "pending", label: "Pending" },
84
+ { value: "inactive", label: "Inactive" },
85
+ ];
86
+
87
+ export interface UsersTableProps {
88
+ /** Server-side filters. */
89
+ status?: UserStatus;
90
+ /** Visible role select — set to false in read-only contexts. */
91
+ allowRoleChange?: boolean;
92
+ /** Show the "New user" button (superadmin only on the server). */
93
+ allowCreate?: boolean;
94
+ /**
95
+ * Called when a row is opened — wire this to navigation towards the
96
+ * user detail page (edit, status, roles, auth methods live there).
97
+ */
98
+ onOpenUser?: (user: AdminUserRow) => void;
99
+ /** When true, includes soft-deleted users (superadmin only). */
100
+ includeDeleted?: boolean;
101
+ pageSize?: number;
102
+ }
103
+
104
+ export const UsersTable = ({
105
+ status,
106
+ allowRoleChange = true,
107
+ allowCreate = false,
108
+ onOpenUser,
109
+ includeDeleted = false,
110
+ pageSize = 50,
111
+ }: UsersTableProps) => {
112
+ const client = useUmClient();
113
+ const [query, setQuery] = useState("");
114
+ const [sort, setSort] = useState("name-asc");
115
+ const [statusFilter, setStatusFilter] = useState("all");
116
+ const [busyId, setBusyId] = useState<string | null>(null);
117
+ const [actionError, setActionError] = useState<string | null>(null);
118
+
119
+ // A fixed `status` prop wins over the toolbar filter.
120
+ const filterActive = status === undefined && statusFilter !== "all";
121
+ const effectiveStatus =
122
+ status ?? (filterActive ? (statusFilter as UserStatus) : undefined);
123
+ const [sortBy, order] = sort.split("-") as [AdminUsersSortBy, "asc" | "desc"];
124
+
125
+ const { data, error, loading, refresh } = useCall(adminListUsers, {
126
+ status: effectiveStatus,
127
+ includeDeleted,
128
+ limit: pageSize,
129
+ offset: 0,
130
+ sortBy,
131
+ order,
132
+ });
133
+
134
+ const filtered = useMemo(() => {
135
+ if (!data) return [];
136
+ const q = query.trim().toLowerCase();
137
+ if (!q) return data.rows;
138
+ return data.rows.filter(
139
+ (u) =>
140
+ u.email.toLowerCase().includes(q) ||
141
+ u.name.toLowerCase().includes(q) ||
142
+ u.id.toLowerCase().includes(q)
143
+ );
144
+ }, [data, query]);
145
+
146
+ const withBusy = async <O, E>(
147
+ u: AdminUserRow,
148
+ op: () => Promise<{ ok: true; data: O } | { ok: false; error: E }>
149
+ ) => {
150
+ setBusyId(u.id);
151
+ setActionError(null);
152
+ const res = await op();
153
+ setBusyId(null);
154
+ if (res.ok) {
155
+ await refresh();
156
+ } else {
157
+ setActionError(errorMessage(res.error as never, "Action failed."));
158
+ }
159
+ };
160
+
161
+ const setStatus = (u: AdminUserRow, next: UserStatus) =>
162
+ withBusy(u, () => client.call(adminSetUserStatus, { userId: u.id, status: next }));
163
+ const setRole = (u: AdminUserRow, role: UserRole) =>
164
+ withBusy(u, () => client.call(adminSetUserRole, { userId: u.id, role }));
165
+ const revokeTokens = (u: AdminUserRow) =>
166
+ withBusy(u, () => client.call(adminRevokeUserTokens, { userId: u.id }));
167
+
168
+ return (
169
+ <div className="grid gap-3">
170
+ <div className="flex flex-wrap items-center justify-between gap-2">
171
+ <div className="relative min-w-[14rem] max-w-sm flex-1">
172
+ <Search className="pointer-events-none absolute left-3 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" />
173
+ <Input
174
+ value={query}
175
+ onChange={(e) => setQuery(e.target.value)}
176
+ placeholder="Search by name, email or ID…"
177
+ className="pl-9"
178
+ />
179
+ </div>
180
+ <div className="flex flex-wrap items-center gap-2">
181
+ {status === undefined ? (
182
+ <Select value={statusFilter} onValueChange={setStatusFilter}>
183
+ <SelectTrigger
184
+ className="h-8 w-[9.5rem]"
185
+ aria-label="Filter by status"
186
+ >
187
+ <ListFilter className="size-3.5 text-muted-foreground" />
188
+ <SelectValue />
189
+ </SelectTrigger>
190
+ <SelectContent>
191
+ {STATUS_OPTIONS.map((o) => (
192
+ <SelectItem key={o.value} value={o.value}>
193
+ {o.label}
194
+ </SelectItem>
195
+ ))}
196
+ </SelectContent>
197
+ </Select>
198
+ ) : null}
199
+ <Select value={sort} onValueChange={setSort}>
200
+ <SelectTrigger className="h-8 w-[9.5rem]" aria-label="Sort by">
201
+ <ArrowUpDown className="size-3.5 text-muted-foreground" />
202
+ <SelectValue />
203
+ </SelectTrigger>
204
+ <SelectContent>
205
+ {SORT_OPTIONS.map((o) => (
206
+ <SelectItem key={o.value} value={o.value}>
207
+ {o.label}
208
+ </SelectItem>
209
+ ))}
210
+ </SelectContent>
211
+ </Select>
212
+ <Button variant="outline" size="sm" onClick={refresh}>
213
+ <RefreshCcw />
214
+ Refresh
215
+ </Button>
216
+ {allowCreate ? <UserCreateDialog onCreated={() => void refresh()} /> : null}
217
+ </div>
218
+ </div>
219
+
220
+ {actionError ? (
221
+ <Alert variant="destructive">
222
+ <AlertCircle />
223
+ <AlertDescription>{actionError}</AlertDescription>
224
+ </Alert>
225
+ ) : null}
226
+
227
+ {error ? (
228
+ <Alert variant="destructive">
229
+ <AlertCircle />
230
+ <AlertDescription>{errorMessage(error)}</AlertDescription>
231
+ </Alert>
232
+ ) : null}
233
+
234
+ <div className="overflow-hidden rounded-xl border bg-card">
235
+ <Table>
236
+ <TableHeader>
237
+ <TableRow>
238
+ <TableHead>User</TableHead>
239
+ <TableHead>Role</TableHead>
240
+ <TableHead>Status</TableHead>
241
+ <TableHead>Sign-in</TableHead>
242
+ <TableHead>Joined</TableHead>
243
+ <TableHead className="text-right">Actions</TableHead>
244
+ </TableRow>
245
+ </TableHeader>
246
+ <TableBody>
247
+ {loading ? (
248
+ Array.from({ length: 5 }).map((_, i) => (
249
+ <TableRow key={`sk-${i}`}>
250
+ <TableCell>
251
+ <div className="flex items-center gap-3">
252
+ <Skeleton className="size-9 rounded-full" />
253
+ <div className="grid gap-1.5">
254
+ <Skeleton className="h-3.5 w-32" />
255
+ <Skeleton className="h-3 w-44" />
256
+ </div>
257
+ </div>
258
+ </TableCell>
259
+ <TableCell><Skeleton className="h-6 w-24" /></TableCell>
260
+ <TableCell><Skeleton className="h-6 w-16" /></TableCell>
261
+ <TableCell><Skeleton className="h-6 w-20" /></TableCell>
262
+ <TableCell><Skeleton className="h-3.5 w-20" /></TableCell>
263
+ <TableCell className="text-right">
264
+ <Skeleton className="ml-auto h-8 w-8 rounded-md" />
265
+ </TableCell>
266
+ </TableRow>
267
+ ))
268
+ ) : filtered.length === 0 ? (
269
+ <TableRow>
270
+ <TableCell colSpan={6} className="p-0">
271
+ <EmptyState
272
+ icon={Users}
273
+ title={query || filterActive ? "No matches" : "No users yet"}
274
+ description={
275
+ query || filterActive
276
+ ? "Try a different search term or filter."
277
+ : "Invite someone to get started."
278
+ }
279
+ className="border-0 rounded-none bg-transparent"
280
+ />
281
+ </TableCell>
282
+ </TableRow>
283
+ ) : (
284
+ filtered.map((u) => (
285
+ <TableRow key={u.id} data-busy={busyId === u.id || undefined}>
286
+ <TableCell>
287
+ <div className="flex items-center gap-3">
288
+ <Avatar>
289
+ <AvatarFallback>
290
+ {initialsOf(u.name, u.email)}
291
+ </AvatarFallback>
292
+ </Avatar>
293
+ <div className="grid leading-tight">
294
+ {onOpenUser ? (
295
+ <button
296
+ type="button"
297
+ onClick={() => onOpenUser(u)}
298
+ className="w-fit text-left text-sm font-medium hover:underline"
299
+ >
300
+ {u.name || u.email}
301
+ </button>
302
+ ) : (
303
+ <span className="text-sm font-medium">
304
+ {u.name || u.email}
305
+ </span>
306
+ )}
307
+ <span className="text-xs text-muted-foreground">{u.email}</span>
308
+ </div>
309
+ </div>
310
+ </TableCell>
311
+ <TableCell>
312
+ {allowRoleChange ? (
313
+ <UserRoleSelect
314
+ value={u.role}
315
+ onChange={(next) => setRole(u, next)}
316
+ disabled={busyId === u.id}
317
+ />
318
+ ) : (
319
+ <UserRoleBadge role={u.role} />
320
+ )}
321
+ </TableCell>
322
+ <TableCell>
323
+ <StatusBadge status={u.status} />
324
+ </TableCell>
325
+ <TableCell>
326
+ <div className="flex flex-wrap gap-1">
327
+ {(u.providers ?? []).map((p) => (
328
+ <Badge key={p} variant="outline" className="capitalize">
329
+ {p === "credential" ? "password" : p}
330
+ </Badge>
331
+ ))}
332
+ </div>
333
+ </TableCell>
334
+ <TableCell title={u.createdAt} className="text-sm text-muted-foreground">
335
+ {formatRelative(u.createdAt)}
336
+ </TableCell>
337
+ <TableCell className="text-right">
338
+ <DropdownMenu>
339
+ <DropdownMenuTrigger asChild>
340
+ <Button variant="ghost" size="icon">
341
+ <MoreHorizontal />
342
+ <span className="sr-only">Actions</span>
343
+ </Button>
344
+ </DropdownMenuTrigger>
345
+ <DropdownMenuContent align="end">
346
+ <DropdownMenuLabel>Manage user</DropdownMenuLabel>
347
+ {onOpenUser ? (
348
+ <DropdownMenuItem onSelect={() => onOpenUser(u)}>
349
+ <Eye /> View details
350
+ </DropdownMenuItem>
351
+ ) : null}
352
+ <DropdownMenuItem
353
+ onSelect={() => setStatus(u, NEXT_STATUS[u.status as UserStatus] ?? "active")}
354
+ >
355
+ {u.status === "active" ? (
356
+ <>
357
+ <Power /> Deactivate
358
+ </>
359
+ ) : (
360
+ <>
361
+ <UserCheck /> Activate
362
+ </>
363
+ )}
364
+ </DropdownMenuItem>
365
+ <DropdownMenuSeparator />
366
+ <DropdownMenuItem onSelect={() => revokeTokens(u)}>
367
+ <KeyRound /> Revoke all sessions
368
+ </DropdownMenuItem>
369
+ </DropdownMenuContent>
370
+ </DropdownMenu>
371
+ </TableCell>
372
+ </TableRow>
373
+ ))
374
+ )}
375
+ </TableBody>
376
+ </Table>
377
+ </div>
378
+
379
+ {data && data.total > filtered.length && (
380
+ <p className="text-right text-xs text-muted-foreground">
381
+ Showing {filtered.length} of {data.total}
382
+ </p>
383
+ )}
384
+ </div>
385
+ );
386
+ };
@@ -0,0 +1,127 @@
1
+ import {
2
+ createContext,
3
+ useCallback,
4
+ useContext,
5
+ useEffect,
6
+ useMemo,
7
+ useState,
8
+ type ReactNode,
9
+ } from "react";
10
+
11
+ import {
12
+ me as meEndpoint,
13
+ refreshViaCookie as refreshEndpoint,
14
+ signOut as signOutEndpoint,
15
+ type MeResponse,
16
+ type TenantRole,
17
+ type UmClient,
18
+ type UserRole,
19
+ } from "@nexys/user-management-client";
20
+
21
+ export interface AuthSnapshot {
22
+ user: MeResponse["user"];
23
+ session: MeResponse["session"];
24
+ authSource: MeResponse["authSource"];
25
+ }
26
+
27
+ export interface AuthContextValue {
28
+ client: UmClient;
29
+ status: "loading" | "authenticated" | "unauthenticated";
30
+ data: AuthSnapshot | null;
31
+ refresh: () => Promise<void>;
32
+ signOut: () => Promise<void>;
33
+ hasUserRole: (...roles: UserRole[]) => boolean;
34
+ hasTenantRole: (...roles: TenantRole[]) => boolean;
35
+ }
36
+
37
+ const Ctx = createContext<AuthContextValue | null>(null);
38
+
39
+ export interface AuthProviderProps {
40
+ client: UmClient;
41
+ children: ReactNode;
42
+ /** Re-poll /api/me on this interval (ms). 0 disables. Default 5min. */
43
+ refreshIntervalMs?: number;
44
+ /** Silently rotate JWT cookies on this interval (ms). 0 disables. Default 10min. */
45
+ tokenRefreshIntervalMs?: number;
46
+ /** Called after sign-out completes; consumer typically navigates to /sign-in. */
47
+ onSignOut?: () => void;
48
+ /** Optional fallback while we're determining the auth state. */
49
+ fallback?: ReactNode;
50
+ }
51
+
52
+ export const AuthProvider = ({
53
+ client,
54
+ children,
55
+ refreshIntervalMs = 5 * 60 * 1000,
56
+ tokenRefreshIntervalMs = 10 * 60 * 1000,
57
+ onSignOut,
58
+ fallback,
59
+ }: AuthProviderProps) => {
60
+ const [status, setStatus] = useState<AuthContextValue["status"]>("loading");
61
+ const [data, setData] = useState<AuthSnapshot | null>(null);
62
+
63
+ const refresh = useCallback(async () => {
64
+ const res = await client.call(meEndpoint);
65
+ if (res.ok) {
66
+ setData(res.data);
67
+ setStatus("authenticated");
68
+ } else {
69
+ setData(null);
70
+ setStatus("unauthenticated");
71
+ }
72
+ }, [client]);
73
+
74
+ useEffect(() => {
75
+ void refresh();
76
+ }, [refresh]);
77
+
78
+ useEffect(() => {
79
+ if (!refreshIntervalMs || status !== "authenticated") return;
80
+ const id = setInterval(() => void refresh(), refreshIntervalMs);
81
+ return () => clearInterval(id);
82
+ }, [refresh, refreshIntervalMs, status]);
83
+
84
+ // Silently rotate JWT cookies before the access token expires.
85
+ useEffect(() => {
86
+ if (!tokenRefreshIntervalMs || status !== "authenticated") return;
87
+ const id = setInterval(() => {
88
+ void client.call(refreshEndpoint);
89
+ }, tokenRefreshIntervalMs);
90
+ return () => clearInterval(id);
91
+ }, [client, tokenRefreshIntervalMs, status]);
92
+
93
+ const signOut = useCallback(async () => {
94
+ await client.call(signOutEndpoint);
95
+ setData(null);
96
+ setStatus("unauthenticated");
97
+ onSignOut?.();
98
+ }, [client, onSignOut]);
99
+
100
+ const value = useMemo<AuthContextValue>(
101
+ () => ({
102
+ client,
103
+ status,
104
+ data,
105
+ refresh,
106
+ signOut,
107
+ hasUserRole: (...roles) => (data ? roles.includes(data.user.role) : false),
108
+ hasTenantRole: (...roles) =>
109
+ data ? data.session.tenantRoles.some((r) => roles.includes(r)) : false,
110
+ }),
111
+ [client, status, data, refresh, signOut]
112
+ );
113
+
114
+ if (status === "loading" && fallback !== undefined) {
115
+ return <>{fallback}</>;
116
+ }
117
+
118
+ return <Ctx.Provider value={value}>{children}</Ctx.Provider>;
119
+ };
120
+
121
+ export const useAuth = (): AuthContextValue => {
122
+ const v = useContext(Ctx);
123
+ if (!v) throw new Error("useAuth must be used inside <AuthProvider>");
124
+ return v;
125
+ };
126
+
127
+ export const useUmClient = (): UmClient => useAuth().client;
@@ -0,0 +1,78 @@
1
+ /// <reference lib="dom" />
2
+ import { afterEach, describe, expect, test } from "bun:test";
3
+
4
+ import { fireEvent, render, screen } from "@testing-library/react";
5
+
6
+ import { THEME_STORAGE_KEY, ThemeProvider, useTheme } from "./theme-context.js";
7
+
8
+ const Probe = () => {
9
+ const { theme, resolvedTheme, setTheme } = useTheme();
10
+ return (
11
+ <div>
12
+ <span data-testid="theme">{theme}</span>
13
+ <span data-testid="resolved">{resolvedTheme}</span>
14
+ <button onClick={() => setTheme("dark")}>go dark</button>
15
+ <button onClick={() => setTheme("light")}>go light</button>
16
+ </div>
17
+ );
18
+ };
19
+
20
+ afterEach(() => {
21
+ document.body.innerHTML = "";
22
+ document.documentElement.classList.remove("dark");
23
+ localStorage.removeItem(THEME_STORAGE_KEY);
24
+ });
25
+
26
+ describe("<ThemeProvider />", () => {
27
+ test("setTheme('dark') applies the .dark class and persists", () => {
28
+ render(
29
+ <ThemeProvider defaultTheme="light">
30
+ <Probe />
31
+ </ThemeProvider>
32
+ );
33
+ expect(document.documentElement.classList.contains("dark")).toBe(false);
34
+
35
+ fireEvent.click(screen.getByRole("button", { name: /go dark/i }));
36
+
37
+ expect(screen.getByTestId("theme").textContent).toBe("dark");
38
+ expect(screen.getByTestId("resolved").textContent).toBe("dark");
39
+ expect(document.documentElement.classList.contains("dark")).toBe(true);
40
+ expect(localStorage.getItem(THEME_STORAGE_KEY)).toBe("dark");
41
+ });
42
+
43
+ test("switching back to light removes the .dark class", () => {
44
+ render(
45
+ <ThemeProvider defaultTheme="dark">
46
+ <Probe />
47
+ </ThemeProvider>
48
+ );
49
+ expect(document.documentElement.classList.contains("dark")).toBe(true);
50
+
51
+ fireEvent.click(screen.getByRole("button", { name: /go light/i }));
52
+
53
+ expect(document.documentElement.classList.contains("dark")).toBe(false);
54
+ expect(localStorage.getItem(THEME_STORAGE_KEY)).toBe("light");
55
+ });
56
+
57
+ test("restores the stored preference on mount", () => {
58
+ localStorage.setItem(THEME_STORAGE_KEY, "dark");
59
+ render(
60
+ <ThemeProvider defaultTheme="light">
61
+ <Probe />
62
+ </ThemeProvider>
63
+ );
64
+ expect(screen.getByTestId("theme").textContent).toBe("dark");
65
+ expect(document.documentElement.classList.contains("dark")).toBe(true);
66
+ });
67
+
68
+ test("ignores garbage in storage and falls back to the default", () => {
69
+ localStorage.setItem(THEME_STORAGE_KEY, "neon");
70
+ render(
71
+ <ThemeProvider defaultTheme="light">
72
+ <Probe />
73
+ </ThemeProvider>
74
+ );
75
+ expect(screen.getByTestId("theme").textContent).toBe("light");
76
+ expect(document.documentElement.classList.contains("dark")).toBe(false);
77
+ });
78
+ });