@terreno/admin-frontend 57.19.2 → 57.21.0

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 (190) hide show
  1. package/CHANGELOG.md +443 -0
  2. package/dist/AdminFieldRenderer.d.ts +3 -2
  3. package/dist/AdminFieldRenderer.d.ts.map +1 -1
  4. package/dist/AdminFieldRenderer.js +12 -5
  5. package/dist/AdminFieldRenderer.js.map +1 -1
  6. package/dist/AdminFieldRendererCore.d.ts +6 -3
  7. package/dist/AdminFieldRendererCore.d.ts.map +1 -1
  8. package/dist/AdminFieldRendererCore.js +10 -7
  9. package/dist/AdminFieldRendererCore.js.map +1 -1
  10. package/dist/AdminFilterDrawer.d.ts.map +1 -1
  11. package/dist/AdminFilterDrawer.js +2 -3
  12. package/dist/AdminFilterDrawer.js.map +1 -1
  13. package/dist/AdminHome.d.ts.map +1 -1
  14. package/dist/AdminHome.js +5 -2
  15. package/dist/AdminHome.js.map +1 -1
  16. package/dist/AdminModelForm.d.ts.map +1 -1
  17. package/dist/AdminModelForm.js +4 -0
  18. package/dist/AdminModelForm.js.map +1 -1
  19. package/dist/AdminNestedArrayField.d.ts +2 -0
  20. package/dist/AdminNestedArrayField.d.ts.map +1 -1
  21. package/dist/AdminNestedArrayField.js +51 -25
  22. package/dist/AdminNestedArrayField.js.map +1 -1
  23. package/dist/AdminNestedObjectField.d.ts +43 -0
  24. package/dist/AdminNestedObjectField.d.ts.map +1 -0
  25. package/dist/AdminNestedObjectField.js +72 -0
  26. package/dist/AdminNestedObjectField.js.map +1 -0
  27. package/dist/AdminRolesField.d.ts +3 -1
  28. package/dist/AdminRolesField.d.ts.map +1 -1
  29. package/dist/AdminRolesField.js +6 -2
  30. package/dist/AdminRolesField.js.map +1 -1
  31. package/dist/AdminShell.d.ts +3 -3
  32. package/dist/AdminShell.d.ts.map +1 -1
  33. package/dist/AdminShell.js +4 -6
  34. package/dist/AdminShell.js.map +1 -1
  35. package/dist/ConfigurationScreen.d.ts.map +1 -1
  36. package/dist/ConfigurationScreen.js +3 -3
  37. package/dist/ConfigurationScreen.js.map +1 -1
  38. package/dist/ConsentHistory.d.ts.map +1 -1
  39. package/dist/ConsentHistory.js +17 -2
  40. package/dist/ConsentHistory.js.map +1 -1
  41. package/dist/ConsentResponseViewer.d.ts.map +1 -1
  42. package/dist/ConsentResponseViewer.js +20 -2
  43. package/dist/ConsentResponseViewer.js.map +1 -1
  44. package/dist/Constants.d.ts +5 -2
  45. package/dist/Constants.d.ts.map +1 -1
  46. package/dist/Constants.js +5 -2
  47. package/dist/Constants.js.map +1 -1
  48. package/dist/UserSecurityScreen.d.ts +45 -0
  49. package/dist/UserSecurityScreen.d.ts.map +1 -0
  50. package/dist/UserSecurityScreen.js +66 -0
  51. package/dist/UserSecurityScreen.js.map +1 -0
  52. package/dist/consentPdfTemplates.d.ts +64 -0
  53. package/dist/consentPdfTemplates.d.ts.map +1 -0
  54. package/dist/consentPdfTemplates.js +160 -0
  55. package/dist/consentPdfTemplates.js.map +1 -0
  56. package/dist/generateConsentHistoryPdf.d.ts.map +1 -1
  57. package/dist/generateConsentHistoryPdf.js +7 -55
  58. package/dist/generateConsentHistoryPdf.js.map +1 -1
  59. package/dist/generateConsentPdf.d.ts +1 -26
  60. package/dist/generateConsentPdf.d.ts.map +1 -1
  61. package/dist/generateConsentPdf.js +7 -69
  62. package/dist/generateConsentPdf.js.map +1 -1
  63. package/dist/index.d.ts +4 -1
  64. package/dist/index.d.ts.map +1 -1
  65. package/dist/index.js +3 -0
  66. package/dist/index.js.map +1 -1
  67. package/dist/orgs/MemberSecurityPanel.d.ts +34 -0
  68. package/dist/orgs/MemberSecurityPanel.d.ts.map +1 -0
  69. package/dist/orgs/MemberSecurityPanel.js +204 -0
  70. package/dist/orgs/MemberSecurityPanel.js.map +1 -0
  71. package/dist/orgs/OrgMembersScreen.d.ts.map +1 -1
  72. package/dist/orgs/OrgMembersScreen.js +33 -6
  73. package/dist/orgs/OrgMembersScreen.js.map +1 -1
  74. package/dist/orgs/adminModelEndpoints.d.ts +13 -1
  75. package/dist/orgs/adminModelEndpoints.d.ts.map +1 -1
  76. package/dist/orgs/adminModelEndpoints.js +30 -13
  77. package/dist/orgs/adminModelEndpoints.js.map +1 -1
  78. package/dist/orgs/useMemberSecurityApi.d.ts +97 -0
  79. package/dist/orgs/useMemberSecurityApi.d.ts.map +1 -0
  80. package/dist/orgs/useMemberSecurityApi.js +98 -0
  81. package/dist/orgs/useMemberSecurityApi.js.map +1 -0
  82. package/dist/pdfUtils.d.ts +15 -0
  83. package/dist/pdfUtils.d.ts.map +1 -1
  84. package/dist/pdfUtils.js +70 -0
  85. package/dist/pdfUtils.js.map +1 -1
  86. package/dist/types.d.ts +7 -1
  87. package/dist/types.d.ts.map +1 -1
  88. package/dist/types.js.map +1 -1
  89. package/dist/useAdminApi.d.ts +8 -2
  90. package/dist/useAdminApi.d.ts.map +1 -1
  91. package/dist/useAdminApi.js +11 -46
  92. package/dist/useAdminApi.js.map +1 -1
  93. package/dist/useAdminRoles.d.ts +5 -1
  94. package/dist/useAdminRoles.d.ts.map +1 -1
  95. package/dist/useAdminRoles.js +3 -3
  96. package/dist/useAdminRoles.js.map +1 -1
  97. package/dist/useAdminRpc.d.ts.map +1 -1
  98. package/dist/useAdminRpc.js +18 -3
  99. package/dist/useAdminRpc.js.map +1 -1
  100. package/dist/useConsentHistory.d.ts +7 -0
  101. package/dist/useConsentHistory.d.ts.map +1 -1
  102. package/dist/useConsentHistory.js.map +1 -1
  103. package/package.json +7 -3
  104. package/src/AdminBreadcrumbs.test.tsx +1 -1
  105. package/src/AdminFieldRenderer.test.tsx +2 -1
  106. package/src/AdminFieldRenderer.tsx +48 -3
  107. package/src/AdminFieldRendererCore.tsx +12 -5
  108. package/src/AdminFilterDrawer.tsx +3 -4
  109. package/src/AdminHome.test.tsx +65 -1
  110. package/src/AdminHome.tsx +14 -6
  111. package/src/AdminModelForm.tsx +4 -0
  112. package/src/AdminModelTable.test.tsx +16 -12
  113. package/src/AdminModelTable.windowed.test.tsx +11 -5
  114. package/src/AdminNestedArrayField.tsx +116 -44
  115. package/src/AdminNestedObjectField.test.tsx +239 -0
  116. package/src/AdminNestedObjectField.tsx +145 -0
  117. package/src/AdminPrimitiveArrayField.test.tsx +3 -3
  118. package/src/AdminProvider.test.tsx +11 -6
  119. package/src/AdminRolesField.tsx +6 -2
  120. package/src/AdminRolesList.test.tsx +47 -14
  121. package/src/AdminScreenPage.test.tsx +1 -1
  122. package/src/AdminScreenRouter.test.tsx +15 -5
  123. package/src/AdminScriptList.test.tsx +9 -2
  124. package/src/AdminShell.test.tsx +16 -2
  125. package/src/AdminShell.tsx +5 -8
  126. package/src/AdminVersionConfig.test.tsx +4 -4
  127. package/src/AnnouncementOverviewScreenWidget.test.tsx +6 -1
  128. package/src/CheckboxListEditor.test.tsx +11 -9
  129. package/src/ConfigurationScreen.test.tsx +2 -2
  130. package/src/ConfigurationScreen.tsx +6 -2
  131. package/src/ConsentHistory.test.tsx +69 -1
  132. package/src/ConsentHistory.tsx +39 -1
  133. package/src/ConsentResponseViewer.test.tsx +113 -1
  134. package/src/ConsentResponseViewer.tsx +106 -8
  135. package/src/Constants.ts +5 -2
  136. package/src/UserSecurityScreen.tsx +184 -0
  137. package/src/adminRequest.test.ts +3 -3
  138. package/src/adminWindowedTable.test.ts +4 -2
  139. package/src/comms/CommsDashboardScreen.test.tsx +5 -5
  140. package/src/comms/CommsMessageDetail.test.tsx +1 -1
  141. package/src/consentPdfTemplates.test.ts +180 -0
  142. package/src/consentPdfTemplates.ts +228 -0
  143. package/src/generateConsentHistoryPdf.ts +9 -63
  144. package/src/generateConsentPdf.ts +14 -107
  145. package/src/index.tsx +20 -0
  146. package/src/isolated/AdminFieldRenderer.isolated.tsx +11 -6
  147. package/src/isolated/AdminFilterDrawer.isolated.tsx +8 -6
  148. package/src/isolated/AdminFilterDrawerMobile.isolated.tsx +3 -1
  149. package/src/isolated/AdminHomeWidgets.isolated.tsx +2 -0
  150. package/src/isolated/AdminNestedArrayField.isolated.tsx +103 -10
  151. package/src/isolated/AdminObjectPicker.isolated.tsx +9 -10
  152. package/src/isolated/AiPromptsListScreen.isolated.tsx +1 -1
  153. package/src/isolated/DocumentStorageBrowser.isolated.tsx +16 -8
  154. package/src/isolated/RecentActivityWidget.isolated.tsx +2 -0
  155. package/src/isolated/UserSecurityScreen.isolated.tsx +365 -0
  156. package/src/isolated/adminWidgets.isolated.tsx +46 -6
  157. package/src/isolated/aiObservabilityScreens.isolated.tsx +18 -9
  158. package/src/isolated/generateConsentHistoryPdf.isolated.ts +60 -7
  159. package/src/isolated/generateConsentPdf.isolated.ts +47 -0
  160. package/src/isolated/generateConsentPdfMobile.isolated.ts +28 -0
  161. package/src/isolated/generateConsentPdfsMobile.isolated.ts +59 -2
  162. package/src/isolated/hooks.isolated.tsx +163 -42
  163. package/src/isolated/rpcDualRun.isolated.tsx +9 -2
  164. package/src/jobs/JobsDashboardScreen.test.tsx +3 -3
  165. package/src/jobs/JobsHomeWidget.test.tsx +1 -1
  166. package/src/jobs/JobsJobDetail.test.tsx +1 -1
  167. package/src/orgs/MemberSecurityPanel.test.tsx +584 -0
  168. package/src/orgs/MemberSecurityPanel.tsx +520 -0
  169. package/src/orgs/OrgManagementScreens.test.tsx +121 -2
  170. package/src/orgs/OrgMembersScreen.tsx +71 -4
  171. package/src/orgs/adminModelEndpoints.test.ts +1 -1
  172. package/src/orgs/adminModelEndpoints.ts +56 -15
  173. package/src/orgs/useMemberSecurityApi.ts +198 -0
  174. package/src/pdfUtils.test.ts +24 -1
  175. package/src/pdfUtils.ts +93 -0
  176. package/src/testing/useAdminApiDouble.ts +2 -1
  177. package/src/types.ts +7 -1
  178. package/src/useAdminApi.ts +23 -3
  179. package/src/useAdminRoles.ts +11 -3
  180. package/src/useAdminRpc.test.tsx +116 -2
  181. package/src/useAdminRpc.ts +19 -3
  182. package/src/useConsentHistory.ts +5 -0
  183. package/src/widgets/AIRequestsScreenWidget.test.tsx +20 -3
  184. package/src/widgets/ModelsGridWidget.test.tsx +25 -5
  185. package/src/widgets/aiObservability/datasets/AiDatasetDetailView.test.tsx +4 -2
  186. package/src/widgets/aiObservability/datasets/datasetTypes.test.ts +0 -1
  187. package/src/widgets/aiObservability/evaluators/AiEvaluatorPanels.test.tsx +89 -23
  188. package/src/widgets/aiObservability/experiments/AiExperimentNewView.test.tsx +4 -0
  189. package/src/widgets/aiObservability/shell/ObservabilityTable.test.tsx +7 -1
  190. package/src/widgets/builtInFieldWidgets.test.tsx +16 -3
@@ -1,8 +1,21 @@
1
- import {Badge, Box, Button, Card, Heading, MarkdownView, Page, Spinner, Text} from "@terreno/ui";
1
+ import {
2
+ Badge,
3
+ Box,
4
+ Button,
5
+ Card,
6
+ Heading,
7
+ MarkdownView,
8
+ Page,
9
+ printConsentHtml,
10
+ Spinner,
11
+ Text,
12
+ } from "@terreno/ui";
2
13
  import {DateTime} from "luxon";
3
14
  import React, {useCallback, useState} from "react";
4
15
  import {Image} from "react-native";
16
+ import {consentResponsePrintHtml} from "./consentPdfTemplates";
5
17
  import {generateConsentPdf} from "./generateConsentPdf";
18
+ import {provisionalSignerName} from "./pdfUtils";
6
19
  import {type AdminApi, resolveAdminBases} from "./types";
7
20
  import {useAdminApi} from "./useAdminApi";
8
21
 
@@ -60,6 +73,22 @@ export const ConsentResponseViewer: React.FC<ConsentResponseViewerProps> = ({
60
73
  }
61
74
  }, [response]);
62
75
 
76
+ const [isPrinting, setIsPrinting] = useState(false);
77
+
78
+ const handlePrint = useCallback(async () => {
79
+ if (!response) {
80
+ return;
81
+ }
82
+ setIsPrinting(true);
83
+ try {
84
+ await printConsentHtml({html: consentResponsePrintHtml(response)});
85
+ } catch (err) {
86
+ console.error("Failed to print consent response", err);
87
+ } finally {
88
+ setIsPrinting(false);
89
+ }
90
+ }, [response]);
91
+
63
92
  if (isLoading) {
64
93
  return (
65
94
  <Page color="transparent" maxWidth="100%" padding={0}>
@@ -116,13 +145,23 @@ export const ConsentResponseViewer: React.FC<ConsentResponseViewerProps> = ({
116
145
  <Box gap={4} padding={4}>
117
146
  <Box alignItems="center" direction="row" justifyContent="between">
118
147
  <Heading size="lg">Consent Response</Heading>
119
- <Button
120
- iconName="download"
121
- loading={isDownloading}
122
- onClick={handleDownloadPdf}
123
- text="Download PDF"
124
- variant="outline"
125
- />
148
+ <Box direction="row" gap={2}>
149
+ <Button
150
+ iconName="print"
151
+ loading={isPrinting}
152
+ onClick={handlePrint}
153
+ testID="consent-response-print-button"
154
+ text="Print"
155
+ variant="outline"
156
+ />
157
+ <Button
158
+ iconName="download"
159
+ loading={isDownloading}
160
+ onClick={handleDownloadPdf}
161
+ text="Download PDF"
162
+ variant="outline"
163
+ />
164
+ </Box>
126
165
  </Box>
127
166
 
128
167
  {/* Core Fields */}
@@ -159,6 +198,65 @@ export const ConsentResponseViewer: React.FC<ConsentResponseViewerProps> = ({
159
198
  </Box>
160
199
  </Card>
161
200
 
201
+ {/* Provisional signature: recorded by staff on the user's behalf */}
202
+ {Boolean(response.provisional) && (
203
+ <Card padding={4} testID="consent-response-provisional">
204
+ <Box gap={3}>
205
+ <Box alignItems="center" direction="row" gap={2}>
206
+ <Heading size="sm">Provisional Signature</Heading>
207
+ <Badge status="info" value="Provisional" />
208
+ {response.voidedAt ? (
209
+ <Badge
210
+ status="error"
211
+ testID="consent-response-provisional-voided"
212
+ value="Voided"
213
+ />
214
+ ) : null}
215
+ </Box>
216
+
217
+ <Box alignItems="center" direction="row" gap={2}>
218
+ <Text color="secondaryDark">Signed By:</Text>
219
+ <Text>{provisionalSignerName(response.provisionalSignedBy)}</Text>
220
+ </Box>
221
+
222
+ {Boolean(response.agreedAt) && (
223
+ <Box alignItems="center" direction="row" gap={2}>
224
+ <Text color="secondaryDark">Signed At:</Text>
225
+ <Text>{formatDate(response.agreedAt)}</Text>
226
+ </Box>
227
+ )}
228
+
229
+ {Boolean(response.provisionalNote) && (
230
+ <Box gap={1}>
231
+ <Text color="secondaryDark">Note:</Text>
232
+ <Text testID="consent-response-provisional-note">{response.provisionalNote}</Text>
233
+ </Box>
234
+ )}
235
+
236
+ {Boolean(response.provisionalSignerIp) && (
237
+ <Box alignItems="center" direction="row" gap={2}>
238
+ <Text color="secondaryDark">Signer IP:</Text>
239
+ <Text>{response.provisionalSignerIp}</Text>
240
+ </Box>
241
+ )}
242
+
243
+ {Boolean(response.voidedAt) && (
244
+ <Box alignItems="center" direction="row" gap={2}>
245
+ <Text color="secondaryDark">Voided At:</Text>
246
+ <Text>{formatDate(response.voidedAt)}</Text>
247
+ </Box>
248
+ )}
249
+
250
+ {Boolean(response.voidReason) && (
251
+ <Box gap={1}>
252
+ <Text color="secondaryDark">Void Reason:</Text>
253
+ <Text>{response.voidReason}</Text>
254
+ </Box>
255
+ )}
256
+ </Box>
257
+ </Card>
258
+ )}
259
+
162
260
  {/* User Information */}
163
261
  <Card padding={4}>
164
262
  <Box gap={3}>
package/src/Constants.ts CHANGED
@@ -1,5 +1,8 @@
1
1
  /** Debounce delay for admin list search input before firing list queries. */
2
2
  export const ADMIN_SEARCH_DEBOUNCE_MS = 250;
3
3
 
4
- /** Viewport width below which filter UI uses a bottom sheet instead of a side drawer. */
5
- export const ADMIN_FILTER_MOBILE_BREAKPOINT = 768;
4
+ /**
5
+ * Desktop floor in pt. Web `lg` and native `xl` both start here.
6
+ * Prefer `isSupportedDesktopWidth` from `@terreno/ui` for layout switches.
7
+ */
8
+ export const ADMIN_FILTER_MOBILE_BREAKPOINT = 1024;
@@ -0,0 +1,184 @@
1
+ import {Box, Button, Heading, Spinner, Text} from "@terreno/ui";
2
+ import type {Href} from "expo-router";
3
+ import {router} from "expo-router";
4
+ import React, {useCallback, useMemo} from "react";
5
+ import {AdminScreenPage} from "./AdminScreenPage";
6
+ import {useAdminContext} from "./adminContext";
7
+ import {MemberSecurityPanel, SecurityAlert} from "./orgs/MemberSecurityPanel";
8
+ import type {AdminConfigResponse} from "./types";
9
+ import {useAdminRpc, useAdminRpcQuery} from "./useAdminRpc";
10
+
11
+ const DEFAULT_ADMIN_BASE = "/admin";
12
+ const DEFAULT_USER_MODEL_NAME = "User";
13
+
14
+ export interface UserSecurityScreenProps {
15
+ /** Base path for admin JSON requests (`{apiBase}/config`). Defaults to the AdminProvider's `apiBase`. */
16
+ apiBase?: string;
17
+ /** Where the back arrow goes. Defaults to the admin user record, `{routeBase}/{userModelName}/{userId}`. */
18
+ backHref?: string;
19
+ /** Base path for in-app admin navigation. Defaults to the AdminProvider's `routeBase`. */
20
+ routeBase?: string;
21
+ /** Route prefix of the platform security routes. Defaults to `/users` (`/users/:id/security`). */
22
+ securityBaseURL?: string;
23
+ testID?: string;
24
+ /** The user whose sign-in security is shown. */
25
+ userId: string;
26
+ /** Admin model name of the user record, for the header and back link. Defaults to `User`. */
27
+ userModelName?: string;
28
+ }
29
+
30
+ interface AdminUserRecord {
31
+ email?: unknown;
32
+ name?: unknown;
33
+ }
34
+
35
+ const unwrapData = <T,>(body: unknown): T | undefined => {
36
+ if (body && typeof body === "object" && "data" in body) {
37
+ return (body as {data: T}).data;
38
+ }
39
+ return body as T | undefined;
40
+ };
41
+
42
+ const stringField = (value: unknown): string | undefined =>
43
+ typeof value === "string" && value.trim().length > 0 ? value : undefined;
44
+
45
+ /**
46
+ * Admin route of a user's security screen: `{routeBase}/users/{userId}/security`. Hosts mount
47
+ * {@link UserSecurityScreen} at this path so {@link UserSecurityLink} reaches it.
48
+ */
49
+ export const userSecurityRoute = ({
50
+ routeBase = DEFAULT_ADMIN_BASE,
51
+ userId,
52
+ }: {
53
+ routeBase?: string;
54
+ userId: string;
55
+ }): string => `${routeBase}/users/${encodeURIComponent(userId)}/security`;
56
+
57
+ export interface UserSecurityLinkProps {
58
+ /** Overrides the target route. Defaults to {@link userSecurityRoute}. */
59
+ href?: string;
60
+ /** Base path for in-app admin navigation. Defaults to the AdminProvider's `routeBase`. */
61
+ routeBase?: string;
62
+ testID?: string;
63
+ userId: string;
64
+ }
65
+
66
+ /**
67
+ * "Security" button for an admin user record, such as in `AdminModelForm` `footerContent`. Render
68
+ * it only for staff who hold `user:manageSecurity`; the routes refuse everyone else.
69
+ */
70
+ export const UserSecurityLink: React.FC<UserSecurityLinkProps> = ({
71
+ href,
72
+ routeBase,
73
+ testID = "admin-user-security-link",
74
+ userId,
75
+ }) => {
76
+ const adminContext = useAdminContext();
77
+ const target =
78
+ href ??
79
+ userSecurityRoute({routeBase: routeBase ?? adminContext?.routeBase ?? undefined, userId});
80
+ const handleOpen = useCallback((): void => {
81
+ router.push(target as Href);
82
+ }, [target]);
83
+
84
+ return (
85
+ <Box direction="row">
86
+ <Button
87
+ accessibilityLabel="Security: sign-in methods and account recovery"
88
+ iconName="shield-halved"
89
+ onClick={handleOpen}
90
+ testID={testID}
91
+ text="Security"
92
+ variant="outline"
93
+ />
94
+ </Box>
95
+ );
96
+ };
97
+
98
+ /**
99
+ * Platform staff view of one user's sign-in security: a header naming the user from their admin
100
+ * record, then {@link MemberSecurityPanel} against the platform `/users/:id/security` routes.
101
+ * Holders of `user:manageSecurity` (superadmin, operator) reach those routes; the server refuses
102
+ * self-targeting and targets holding permissions the caller lacks.
103
+ */
104
+ export const UserSecurityScreen: React.FC<UserSecurityScreenProps> = ({
105
+ apiBase,
106
+ backHref,
107
+ routeBase,
108
+ securityBaseURL,
109
+ testID = "user-security-screen",
110
+ userId,
111
+ userModelName = DEFAULT_USER_MODEL_NAME,
112
+ }) => {
113
+ const adminContext = useAdminContext();
114
+ const rpc = useAdminRpc();
115
+ const resolvedApiBase = apiBase ?? adminContext?.apiBase ?? DEFAULT_ADMIN_BASE;
116
+ const resolvedRouteBase = routeBase ?? adminContext?.routeBase ?? DEFAULT_ADMIN_BASE;
117
+
118
+ const configQuery = useAdminRpcQuery<AdminConfigResponse>({
119
+ rpc,
120
+ skip: !rpc,
121
+ url: `${resolvedApiBase}/config`,
122
+ });
123
+ const userModel = useMemo(
124
+ () => configQuery.data?.models?.find((model) => model.name === userModelName),
125
+ [configQuery.data, userModelName]
126
+ );
127
+ const userQuery = useAdminRpcQuery<unknown>({
128
+ rpc,
129
+ skip: !rpc || !userModel || !userId,
130
+ url: userModel ? `${userModel.routePath}/${encodeURIComponent(userId)}` : "",
131
+ });
132
+ const record = unwrapData<AdminUserRecord>(userQuery.data);
133
+ const name = stringField(record?.name);
134
+ const email = stringField(record?.email);
135
+ const label = name ?? email ?? userId;
136
+ const isRecordLoading =
137
+ configQuery.isLoading || (Boolean(userModel) && userQuery.isLoading && !record);
138
+ const recordError = configQuery.error || userQuery.error;
139
+
140
+ return (
141
+ <AdminScreenPage
142
+ backHref={backHref ?? `${resolvedRouteBase}/${userModelName}/${encodeURIComponent(userId)}`}
143
+ color="transparent"
144
+ maxWidth="100%"
145
+ padding={0}
146
+ testID={testID}
147
+ title="User security"
148
+ >
149
+ <Box gap={4} padding={4}>
150
+ <Box gap={1} testID={`${testID}-header`}>
151
+ {isRecordLoading ? (
152
+ <Box alignItems="start" testID={`${testID}-user-loading`}>
153
+ <Spinner />
154
+ </Box>
155
+ ) : (
156
+ <>
157
+ <Heading size="md" testID={`${testID}-user-name`}>
158
+ {label}
159
+ </Heading>
160
+ {email && email !== label ? (
161
+ <Text color="secondaryDark" testID={`${testID}-user-email`}>
162
+ {email}
163
+ </Text>
164
+ ) : null}
165
+ </>
166
+ )}
167
+ {recordError && !isRecordLoading ? (
168
+ <SecurityAlert
169
+ message="Could not load the user record."
170
+ testID={`${testID}-user-error`}
171
+ />
172
+ ) : null}
173
+ </Box>
174
+ <MemberSecurityPanel
175
+ baseURL={securityBaseURL}
176
+ focusOnMount={false}
177
+ key={userId}
178
+ testID={`${testID}-panel`}
179
+ userId={userId}
180
+ />
181
+ </Box>
182
+ </AdminScreenPage>
183
+ );
184
+ };
@@ -55,7 +55,7 @@ describe("adminRequest", () => {
55
55
  });
56
56
 
57
57
  it("maps 4xx JSON failures to AdminAPIError", async () => {
58
- globalThis.fetch = (async () => {
58
+ globalThis.fetch = (async (_url: string) => {
59
59
  return new Response(JSON.stringify({detail: "q", title: "Invalid filter"}), {
60
60
  headers: {"Content-Type": "application/json"},
61
61
  status: 400,
@@ -75,7 +75,7 @@ describe("adminRequest", () => {
75
75
  });
76
76
 
77
77
  it("maps 5xx failures without JSON to AdminAPIError", async () => {
78
- globalThis.fetch = (async () => {
78
+ globalThis.fetch = (async (_url: string) => {
79
79
  return new Response("nope", {status: 503, statusText: "Service Unavailable"});
80
80
  }) as typeof fetch;
81
81
 
@@ -115,7 +115,7 @@ describe("adminRequest", () => {
115
115
  });
116
116
 
117
117
  it("returns a Blob when parseAs is blob", async () => {
118
- globalThis.fetch = (async () => {
118
+ globalThis.fetch = (async (_url: string) => {
119
119
  return new Response(new Uint8Array([1, 2, 3]), {
120
120
  headers: {"Content-Type": "application/pdf"},
121
121
  status: 200,
@@ -4,16 +4,18 @@ import {assert} from "chai";
4
4
  import {isWindowedAdminTable, resolveWindowedTableRows} from "./adminWindowedTable";
5
5
  import type {AdminModelConfig, AdminSyncDb} from "./types";
6
6
 
7
+ // The gate reads only the broadcast flag, sync collection, and `_id` type.
7
8
  const stringIdConfig = {
8
9
  adminBroadcast: true,
9
10
  fields: {_id: {required: true, type: "string"}, title: {required: true, type: "string"}},
10
11
  syncCollection: "todos",
11
- } as AdminModelConfig;
12
+ } as Partial<AdminModelConfig> as AdminModelConfig;
12
13
 
14
+ // Test double: the gate only checks that a sync client is present.
13
15
  const fakeSyncDb = {
14
16
  hydrateWindow: async () => ({hydratedIds: []}),
15
17
  store: {getEntity: () => undefined},
16
- } as AdminSyncDb;
18
+ } as unknown as AdminSyncDb;
17
19
 
18
20
  describe("isWindowedAdminTable", () => {
19
21
  it("requires syncDb, fetch client, adminBroadcast, syncCollection, and string _id", () => {
@@ -5,7 +5,7 @@ import React from "react";
5
5
  import {renderWithTheme} from "../../../ui/src/test-utils";
6
6
  import type {AdminApi} from "../types";
7
7
 
8
- const pushMock = mock(() => {});
8
+ const pushMock = mock((_href: unknown) => {});
9
9
  mock.module("expo-router", () => ({
10
10
  router: {push: pushMock, replace: mock(() => {})},
11
11
  useLocalSearchParams: () => ({}),
@@ -119,7 +119,7 @@ describe("CommsDashboardScreen", () => {
119
119
 
120
120
  it("writes filter changes through onFiltersChange for URL persistence", () => {
121
121
  listState.data = {data: [], more: false, page: 1, total: 0};
122
- const onFiltersChange = mock(() => {});
122
+ const onFiltersChange = mock((_next: unknown) => {});
123
123
  const {getByTestId} = renderWithTheme(
124
124
  <CommsDashboardScreen
125
125
  api={createCommsApi()}
@@ -139,7 +139,7 @@ describe("CommsDashboardScreen", () => {
139
139
 
140
140
  it("keeps both default date bounds when search changes with empty URL dates", () => {
141
141
  listState.data = {data: [], more: false, page: 1, total: 0};
142
- const onFiltersChange = mock(() => {});
142
+ const onFiltersChange = mock((_next: unknown) => {});
143
143
  const {getByTestId} = renderWithTheme(
144
144
  <CommsDashboardScreen api={createCommsApi()} filters={{}} onFiltersChange={onFiltersChange} />
145
145
  );
@@ -153,7 +153,7 @@ describe("CommsDashboardScreen", () => {
153
153
 
154
154
  it("clears every active filter and returns to the first page", async () => {
155
155
  listState.data = {data: [], more: false, page: 3, total: 0};
156
- const onFiltersChange = mock(() => {});
156
+ const onFiltersChange = mock((_next: unknown) => {});
157
157
  const {getByTestId} = renderWithTheme(
158
158
  <CommsDashboardScreen
159
159
  api={createCommsApi()}
@@ -333,7 +333,7 @@ describe("CommsDashboardScreen", () => {
333
333
 
334
334
  it("pages through results without dropping the active filters", async () => {
335
335
  listState.data = {data: [failedRow], more: true, page: 1, total: 60};
336
- const onFiltersChange = mock(() => {});
336
+ const onFiltersChange = mock((_next: unknown) => {});
337
337
  const {getByTestId} = renderWithTheme(
338
338
  <CommsDashboardScreen
339
339
  api={createCommsApi()}
@@ -4,7 +4,7 @@ import React from "react";
4
4
  import {renderWithTheme} from "../../../ui/src/test-utils";
5
5
  import type {AdminApi} from "../types";
6
6
 
7
- const pushMock = mock(() => {});
7
+ const pushMock = mock((_href: unknown) => {});
8
8
  mock.module("expo-router", () => ({
9
9
  router: {push: pushMock, replace: mock(() => {})},
10
10
  }));
@@ -0,0 +1,180 @@
1
+ import {describe, expect, it} from "bun:test";
2
+
3
+ import {
4
+ buildConsentHistoryTemplateData,
5
+ buildConsentResponseTemplateData,
6
+ consentHistoryPrintHtml,
7
+ consentResponsePrintHtml,
8
+ extractResponseFields,
9
+ } from "./consentPdfTemplates";
10
+ import {formatDate} from "./pdfUtils";
11
+
12
+ const signedAt = "2026-10-20T15:30:00.000Z";
13
+
14
+ describe("buildConsentResponseTemplateData", () => {
15
+ it("builds every section of a full admin response", () => {
16
+ const data = buildConsentResponseTemplateData({
17
+ _id: "response-1",
18
+ agreed: true,
19
+ agreedAt: signedAt,
20
+ checkboxValues: {"0": true, "1": false},
21
+ consentFormId: {slug: "intake", title: "Intake", type: "agreement", version: 2},
22
+ contentSnapshot: "# Intake",
23
+ formVersionSnapshot: 2,
24
+ ipAddress: "192.168.1.5",
25
+ locale: "en",
26
+ provisional: true,
27
+ provisionalNote: "Guardian agreed by phone",
28
+ provisionalSignedBy: {_id: "staff-1", name: "Dana Rivera"},
29
+ provisionalSignerIp: "10.0.0.7",
30
+ signature: "data:image/png;base64,AAA",
31
+ signedAt,
32
+ userAgent: "Safari",
33
+ userId: {_id: "member-1", email: "sam@example.com", name: "Sam"},
34
+ voidedAt: "2026-10-21T09:00:00.000Z",
35
+ });
36
+
37
+ expect(data.formTitle).toBe("Intake");
38
+ expect(data.fields).toEqual([
39
+ {label: "Form Slug:", value: "intake"},
40
+ {label: "Form Type:", value: "agreement"},
41
+ {label: "Form Version:", value: "2"},
42
+ {label: "Decision:", value: "Agreed"},
43
+ {label: "Agreed At:", value: formatDate(signedAt)},
44
+ {label: "Locale:", value: "en"},
45
+ ]);
46
+ expect(data.checkboxes).toEqual([
47
+ {checked: true, label: "Checkbox 0"},
48
+ {checked: false, label: "Checkbox 1"},
49
+ ]);
50
+ expect(data.auditTrail).toEqual([
51
+ {label: "IP Address:", value: "192.168.1.5"},
52
+ {label: "User Agent:", value: "Safari"},
53
+ {label: "Form Version:", value: "2"},
54
+ {label: "Signed At:", value: formatDate(signedAt)},
55
+ ]);
56
+ expect(data.userInfo).toEqual({email: "sam@example.com", name: "Sam", userId: "member-1"});
57
+ expect(data.provisionalSignature).toEqual({
58
+ note: "Guardian agreed by phone",
59
+ signedAt,
60
+ signedByName: "Dana Rivera",
61
+ signerIp: "10.0.0.7",
62
+ voidedAt: "2026-10-21T09:00:00.000Z",
63
+ });
64
+ expect(data.responseId).toBe("response-1");
65
+ });
66
+
67
+ it("leaves optional sections out of a minimal response", () => {
68
+ const data = buildConsentResponseTemplateData({agreed: false, userId: "member-1"});
69
+ expect(data.formTitle).toBe("Unknown Form");
70
+ expect(data.fields).toEqual([{label: "Decision:", value: "Declined"}]);
71
+ expect(data.checkboxes).toBeUndefined();
72
+ expect(data.auditTrail).toBeUndefined();
73
+ expect(data.provisionalSignature).toBeUndefined();
74
+ });
75
+ });
76
+
77
+ describe("extractResponseFields", () => {
78
+ it("reads ids from string refs", () => {
79
+ expect(
80
+ extractResponseFields({agreed: true, consentFormId: "form-1", userId: "member-1"})
81
+ ).toEqual({
82
+ formSlug: "",
83
+ formTitle: "Unknown Form",
84
+ formType: "",
85
+ formVersion: undefined,
86
+ userEmail: "",
87
+ userId: "member-1",
88
+ userName: "",
89
+ });
90
+ });
91
+ });
92
+
93
+ describe("buildConsentHistoryTemplateData", () => {
94
+ it("builds every section of the user's entry, without the signer's note", () => {
95
+ const data = buildConsentHistoryTemplateData({
96
+ _id: "entry-1",
97
+ agreed: true,
98
+ agreedAt: signedAt,
99
+ checkboxValues: {"0": true, "1": true},
100
+ contentSnapshot: "# Terms",
101
+ form: {
102
+ captureSignature: false,
103
+ checkboxes: [{label: "I have read the terms", required: true}],
104
+ slug: "tos",
105
+ title: "Terms",
106
+ type: "terms",
107
+ version: 3,
108
+ },
109
+ formVersionSnapshot: 3,
110
+ ipAddress: "192.168.1.5",
111
+ locale: "es",
112
+ provisional: true,
113
+ provisionalSignedBy: {name: "Dana Rivera"},
114
+ signature: "data:image/png;base64,BBB",
115
+ signedAt,
116
+ userAgent: "Chrome",
117
+ });
118
+
119
+ expect(data.fields).toEqual([
120
+ {label: "Form Slug:", value: "tos"},
121
+ {label: "Form Type:", value: "terms"},
122
+ {label: "Form Version:", value: "3"},
123
+ {label: "Decision:", value: "Agreed"},
124
+ {label: "Agreed At:", value: formatDate(signedAt)},
125
+ {label: "Locale:", value: "es"},
126
+ ]);
127
+ expect(data.checkboxes).toEqual([
128
+ {checked: true, label: "I have read the terms"},
129
+ {checked: true, label: "Checkbox 1"},
130
+ ]);
131
+ expect(data.auditTrail).toHaveLength(4);
132
+ expect(data.provisionalSignature).toEqual({
133
+ signedAt,
134
+ signedByName: "Dana Rivera",
135
+ voidedAt: undefined,
136
+ });
137
+ });
138
+
139
+ it("leaves optional sections out of a minimal entry", () => {
140
+ const data = buildConsentHistoryTemplateData({
141
+ _id: "entry-2",
142
+ agreed: false,
143
+ agreedAt: "",
144
+ form: null,
145
+ });
146
+ expect(data.formTitle).toBe("Unknown Form");
147
+ expect(data.fields).toEqual([{label: "Decision:", value: "Declined"}]);
148
+ expect(data.checkboxes).toBeUndefined();
149
+ expect(data.provisionalSignature).toBeUndefined();
150
+ });
151
+ });
152
+
153
+ describe("print HTML", () => {
154
+ it("renders the admin provisional block with the note", () => {
155
+ const html = consentResponsePrintHtml({
156
+ agreed: true,
157
+ agreedAt: signedAt,
158
+ provisional: true,
159
+ provisionalNote: "Guardian agreed by phone",
160
+ provisionalSignedBy: {name: "Dana Rivera"},
161
+ userId: "member-1",
162
+ });
163
+ expect(html).toContain("<h2>Provisional signature</h2>");
164
+ expect(html).toContain("Guardian agreed by phone");
165
+ });
166
+
167
+ it("renders the user's provisional block without a note", () => {
168
+ const html = consentHistoryPrintHtml({
169
+ _id: "entry-1",
170
+ agreed: true,
171
+ agreedAt: signedAt,
172
+ form: null,
173
+ provisional: true,
174
+ provisionalSignedBy: {name: "Dana Rivera"},
175
+ });
176
+ expect(html).toContain("<h2>Provisional signature</h2>");
177
+ expect(html).toContain("Dana Rivera");
178
+ expect(html).not.toContain("Note:");
179
+ });
180
+ });