@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
@@ -59,7 +59,7 @@ const setWindowWidth = (width: number): (() => void) => {
59
59
  useWindowDimensionsMock.mockImplementation(dimensionsImpl);
60
60
 
61
61
  return (): void => {
62
- useWindowDimensionsMock.mockImplementation(getScaledSize(375));
62
+ useWindowDimensionsMock.mockImplementation?.(getScaledSize(375));
63
63
  };
64
64
  }
65
65
 
@@ -113,6 +113,20 @@ describe("AdminShell", () => {
113
113
  restoreWindowWidth = undefined;
114
114
  });
115
115
 
116
+ it("keeps the hamburger header between the old 768 cutoff and the desktop floor", () => {
117
+ restoreWindowWidth?.();
118
+ restoreWindowWidth = setWindowWidth(800);
119
+
120
+ const {getByTestId, queryByTestId} = renderWithTheme(
121
+ <AdminShell api={mockApi} apiBase="/admin" routeBase="/admin">
122
+ <React.Fragment />
123
+ </AdminShell>
124
+ );
125
+
126
+ expect(queryByTestId("admin-shell-sidebar")).toBeNull();
127
+ expect(getByTestId("admin-shell-mobile-header")).toBeTruthy();
128
+ });
129
+
116
130
  it("shows the fixed sidebar on desktop widths", () => {
117
131
  restoreWindowWidth?.();
118
132
  restoreWindowWidth = setWindowWidth(1024);
@@ -197,7 +211,7 @@ describe("AdminShell", () => {
197
211
  expect(rendered.getByTestId("admin-shell-error")).toBeTruthy();
198
212
  });
199
213
 
200
- it("hides the fixed sidebar and shows a hamburger header below 768px", () => {
214
+ it("hides the fixed sidebar and shows a hamburger header below the desktop floor", () => {
201
215
  const {getByTestId, getByLabelText, queryByTestId, UNSAFE_root} = renderWithTheme(
202
216
  <AdminShell api={mockApi} apiBase="/admin" routeBase="/admin">
203
217
  <React.Fragment />
@@ -1,4 +1,4 @@
1
- import {Box, Heading, Icon, Spinner, Text, useTheme} from "@terreno/ui";
1
+ import {Box, Heading, Icon, isSupportedDesktopWidth, Spinner, Text, useTheme} from "@terreno/ui";
2
2
  import type {Href} from "expo-router";
3
3
  import {router} from "expo-router";
4
4
  import React, {useCallback, useEffect, useState} from "react";
@@ -16,12 +16,9 @@ import type {AdminApi, AdminConfigResponse, AdminCustomScreen, AdminModelConfig}
16
16
  import {resolveAdminBases} from "./types";
17
17
  import {useAdminConfig} from "./useAdminConfig";
18
18
 
19
- /** Sidebar chrome: matches Flourish admin v2 prototype (`adminv2` HTML shell). */
19
+ /** Sidebar chrome for the admin shell. */
20
20
  export type AdminShellSidebarVariant = "clinical" | "colorful";
21
21
 
22
- /** Viewport widths below this use the hamburger + drawer navigation. */
23
- const ADMIN_SHELL_MOBILE_BREAKPOINT = 768;
24
-
25
22
  export interface AdminShellProps {
26
23
  /** @deprecated Use `apiBase`/`routeBase`. */
27
24
  baseUrl?: string;
@@ -359,8 +356,8 @@ const AdminShellSidebarNav: React.FC<AdminShellSidebarNavProps> = ({
359
356
  * Intended for standalone admin SPA or embedded admin: pair with list/table/form screens
360
357
  * as `children`. Fetches `/admin/config` once for the sidebar (Platform, grouped Models, Screens).
361
358
  *
362
- * Below {@link ADMIN_SHELL_MOBILE_BREAKPOINT}px, the fixed sidebar becomes a hamburger-triggered
363
- * left slide-over drawer.
359
+ * Below the desktop floor (web `lg` / native `xl`, 1024pt), the fixed sidebar becomes a
360
+ * hamburger-triggered left slide-over drawer.
364
361
  *
365
362
  * For Expo Router admin roots, prefer {@link AdminShellLayout}: it wraps `children` in a flex
366
363
  * main column so a nested `<Stack />` fills the area beside the sidebar without repeating layout
@@ -389,7 +386,7 @@ export const AdminShell: React.FC<AdminShellProps> = ({
389
386
  const sidebarVariant: AdminShellSidebarVariant =
390
387
  colorScheme === "dark" ? "clinical" : requestedSidebarVariant;
391
388
  const {width: windowWidth} = useWindowDimensions();
392
- const isMobileLayout = windowWidth < ADMIN_SHELL_MOBILE_BREAKPOINT;
389
+ const isMobileLayout = !isSupportedDesktopWidth({width: windowWidth});
393
390
  const [isNavOpen, setIsNavOpen] = useState(false);
394
391
  const {apiBase: resolvedApiBase, routeBase: resolvedRouteBase} = resolveAdminBases({
395
392
  apiBase,
@@ -26,7 +26,7 @@ const apiState: ApiState = {
26
26
  updateImpl: async () => ({}),
27
27
  };
28
28
 
29
- const updateCalls: unknown[] = [];
29
+ const updateCalls: Record<string, unknown>[] = [];
30
30
  const querySpecs: unknown[] = [];
31
31
  const mutationSpecs: unknown[] = [];
32
32
  const makeApi = () => ({
@@ -55,7 +55,7 @@ const makeApi = () => ({
55
55
  isLoading: apiState.isLoading,
56
56
  }),
57
57
  useUpdateVersionConfigMutation: () => [
58
- (body: unknown) => ({
58
+ (body: Record<string, unknown>) => ({
59
59
  unwrap: async () => {
60
60
  updateCalls.push(body);
61
61
  return apiState.updateImpl(body);
@@ -171,7 +171,7 @@ describe("AdminVersionConfig", () => {
171
171
  await new Promise((r) => setTimeout(r, 150));
172
172
  });
173
173
  expect(updateCalls.length).toBe(1);
174
- expect((updateCalls[0] as Record<string, unknown>).updateUrl).toBe("https://x.com");
174
+ expect(updateCalls[0].updateUrl).toBe("https://x.com");
175
175
  expect(updateCalls[0].pollingIntervalMinutes).toBe(120);
176
176
  });
177
177
 
@@ -217,6 +217,6 @@ describe("AdminVersionConfig", () => {
217
217
  fireEvent.press(getByText("Save"));
218
218
  await new Promise((r) => setTimeout(r, 150));
219
219
  });
220
- expect((updateCalls[0] as Record<string, unknown>).updateUrl).toBeNull();
220
+ expect(updateCalls[0].updateUrl).toBeNull();
221
221
  });
222
222
  });
@@ -39,7 +39,12 @@ describe("AnnouncementOverviewScreenWidget", () => {
39
39
 
40
40
  it("routes create, edit, and analytics table actions through expo-router", () => {
41
41
  renderWithTheme(
42
- <AnnouncementOverviewScreenWidget api={{} as unknown as AdminApi} routeBase="/admin" />
42
+ <AnnouncementOverviewScreenWidget
43
+ api={{} as unknown as AdminApi}
44
+ config={{customScreens: [], models: [], scripts: []}}
45
+ routeBase="/admin"
46
+ screenName="announcements"
47
+ />
43
48
  );
44
49
 
45
50
  assert.strictEqual(capturedOverviewProps?.routeBase, "/admin");
@@ -7,6 +7,8 @@ import type {ReactTestInstance} from "react-test-renderer";
7
7
  import {renderWithTheme} from "../../ui/src/test-utils";
8
8
  import {CheckboxListEditor} from "./CheckboxListEditor";
9
9
 
10
+ type CheckboxItem = React.ComponentProps<typeof CheckboxListEditor>["value"][number];
11
+
10
12
  const press = async (el: ReactTestInstance): Promise<void> => {
11
13
  await act(async () => {
12
14
  fireEvent.press(el);
@@ -35,22 +37,22 @@ describe("CheckboxListEditor", () => {
35
37
 
36
38
  it("handles non-array values gracefully", () => {
37
39
  const {toJSON} = renderWithTheme(
38
- <CheckboxListEditor onChange={() => {}} value={undefined as unknown as undefined} />
40
+ <CheckboxListEditor onChange={() => {}} value={undefined as unknown as CheckboxItem[]} />
39
41
  );
40
42
  expect(toJSON()).toBeDefined();
41
43
  });
42
44
 
43
45
  it("adds a new item when Add is clicked", async () => {
44
- const onChange = mock((_: unknown) => undefined);
46
+ const onChange = mock((_: CheckboxItem[]) => undefined);
45
47
  const {getByTestId} = renderWithTheme(<CheckboxListEditor onChange={onChange} value={[]} />);
46
48
  await press(getByTestId("checkbox-add-button"));
47
49
  expect(onChange).toHaveBeenCalled();
48
- const next = (onChange.mock.calls[0] as unknown[])[0];
50
+ const next = onChange.mock.calls[0][0];
49
51
  expect(next).toEqual([{label: "", required: false}]);
50
52
  });
51
53
 
52
54
  it("removes an item when the remove icon is clicked", async () => {
53
- const onChange = mock((_: unknown) => undefined);
55
+ const onChange = mock((_: CheckboxItem[]) => undefined);
54
56
  const {getByTestId} = renderWithTheme(
55
57
  <CheckboxListEditor
56
58
  onChange={onChange}
@@ -62,29 +64,29 @@ describe("CheckboxListEditor", () => {
62
64
  );
63
65
  await press(getByTestId("checkbox-remove-0"));
64
66
  expect(onChange).toHaveBeenCalled();
65
- const next = (onChange.mock.calls[0] as unknown[])[0];
67
+ const next = onChange.mock.calls[0][0];
66
68
  expect(next).toHaveLength(1);
67
69
  expect(next[0].label).toBe("b");
68
70
  });
69
71
 
70
72
  it("updates a field when label/prompt changes", () => {
71
- const onChange = mock((_: unknown) => undefined);
73
+ const onChange = mock((_: CheckboxItem[]) => undefined);
72
74
  const {getByTestId, UNSAFE_root} = renderWithTheme(
73
75
  <CheckboxListEditor onChange={onChange} value={[{label: "a", required: false}]} />
74
76
  );
75
77
  fireEvent.changeText(getByTestId("checkbox-label-0"), "new-label");
76
- const first = (onChange.mock.calls[0] as unknown[])[0];
78
+ const first = onChange.mock.calls[0][0];
77
79
  expect(first[0].label).toBe("new-label");
78
80
 
79
81
  fireEvent.changeText(getByTestId("checkbox-prompt-0"), "prompt?");
80
- const second = (onChange.mock.calls[1] as unknown[])[0];
82
+ const second = onChange.mock.calls[1][0];
81
83
  expect(second[0].confirmationPrompt).toBe("prompt?");
82
84
 
83
85
  const requiredField = UNSAFE_root.find(
84
86
  (node: ReactTestInstance) => node.props?.title === "Required"
85
87
  );
86
88
  requiredField.props.onChange(true);
87
- const third = (onChange.mock.calls[2] as unknown[])[0];
89
+ const third = onChange.mock.calls[2][0];
88
90
  expect(third[0].required).toBe(true);
89
91
  });
90
92
  });
@@ -13,13 +13,13 @@ interface QueryState<T> {
13
13
  const metaState: QueryState<unknown> = {data: undefined, isLoading: false};
14
14
  const valuesState: QueryState<unknown> = {data: undefined, isLoading: false};
15
15
  let updateImpl: (body: unknown) => Promise<unknown> = async () => ({});
16
- const updateCalls: unknown[] = [];
16
+ const updateCalls: Record<string, unknown>[] = [];
17
17
 
18
18
  mock.module("./useConfigurationApi", () => ({
19
19
  useConfigurationApi: () => ({
20
20
  useMetaQuery: () => ({data: metaState.data, isLoading: metaState.isLoading}),
21
21
  useUpdateMutation: () => [
22
- (body: unknown) => ({
22
+ (body: Record<string, unknown>) => ({
23
23
  unwrap: async () => {
24
24
  updateCalls.push(body);
25
25
  return updateImpl(body);
@@ -3,6 +3,7 @@ import {
3
3
  Box,
4
4
  Button,
5
5
  Card,
6
+ FormContainer,
6
7
  Heading,
7
8
  MarkdownEditorField,
8
9
  Page,
@@ -111,6 +112,8 @@ const ConfigField: React.FC<{
111
112
  if (fieldMeta.secret) {
112
113
  return (
113
114
  <TextField
115
+ accessibilityLabel={`${label} (Secret)`}
116
+ autoComplete="off"
114
117
  helperText={helperText ? `${helperText} (secret)` : "Secret value"}
115
118
  onChange={onChange}
116
119
  testID={testID}
@@ -316,7 +319,8 @@ export const ConfigurationScreen: React.FC<ConfigurationScreenProps> = ({
316
319
  scroll
317
320
  title={title}
318
321
  >
319
- <Box gap={4} padding={4}>
322
+ {/* A form holds the secret (password-type) fields, so browsers do not warn about them. */}
323
+ <FormContainer gap={4} padding={4} testID="config-form">
320
324
  {sections.length === 0 ? (
321
325
  <EmptySections />
322
326
  ) : (
@@ -329,7 +333,7 @@ export const ConfigurationScreen: React.FC<ConfigurationScreenProps> = ({
329
333
  />
330
334
  ))
331
335
  )}
332
- </Box>
336
+ </FormContainer>
333
337
  </Page>
334
338
  );
335
339
  };
@@ -1,7 +1,16 @@
1
- import {describe, expect, it, mock} from "bun:test";
1
+ import {afterAll, describe, expect, it, mock, spyOn} from "bun:test";
2
+ import * as terrenoUi from "@terreno/ui";
2
3
  import {act, fireEvent, waitFor} from "@testing-library/react-native";
3
4
  import {renderWithTheme} from "../../ui/src/test-utils";
4
5
 
6
+ const printedHtml: string[] = [];
7
+ // Capture what the print button hands to @terreno/ui's printConsentHtml.
8
+ const printSpy = spyOn(terrenoUi, "printConsentHtml").mockImplementation(
9
+ async ({html}: {html: string}) => {
10
+ printedHtml.push(html);
11
+ }
12
+ );
13
+
5
14
  import {ConsentHistory} from "./ConsentHistory";
6
15
  import type {ConsentHistoryEntry} from "./useConsentHistory";
7
16
 
@@ -158,4 +167,63 @@ describe("ConsentHistory", () => {
158
167
  );
159
168
  expect(getByTestId("consent-history-item-entry-1")).toBeTruthy();
160
169
  });
170
+ describe("provisional entries", () => {
171
+ const provisionalEntry = (): ConsentHistoryEntry =>
172
+ makeEntry({
173
+ _id: "entry-prov",
174
+ agreedAt: "2026-10-20T15:30:00.000Z",
175
+ provisional: true,
176
+ provisionalSignedBy: {name: "Dana Rivera"},
177
+ });
178
+
179
+ it("shows the provisional badge and signer", () => {
180
+ const {getByTestId, getByText} = renderWithTheme(
181
+ <ConsentHistory api={createApi({data: [provisionalEntry()]})} />
182
+ );
183
+ expect(getByTestId("consent-history-provisional-entry-prov")).toBeTruthy();
184
+ expect(getByText("Provisional")).toBeTruthy();
185
+ expect(getByText("Signed on your behalf by Dana Rivera")).toBeTruthy();
186
+ });
187
+
188
+ it("marks a voided provisional entry", () => {
189
+ const {getByText} = renderWithTheme(
190
+ <ConsentHistory
191
+ api={createApi({
192
+ data: [{...provisionalEntry(), voidedAt: "2026-10-21T09:00:00.000Z"}],
193
+ })}
194
+ />
195
+ );
196
+ expect(getByText("Voided")).toBeTruthy();
197
+ });
198
+
199
+ it("shows no provisional badge on the user's own entries", () => {
200
+ const {queryByTestId} = renderWithTheme(
201
+ <ConsentHistory api={createApi({data: [makeEntry()]})} />
202
+ );
203
+ expect(queryByTestId("consent-history-provisional-entry-1")).toBeNull();
204
+ });
205
+
206
+ it("prints the entry with the provisional block and no note", async () => {
207
+ printedHtml.length = 0;
208
+ const {getByTestId} = renderWithTheme(
209
+ <ConsentHistory api={createApi({data: [provisionalEntry()]})} />
210
+ );
211
+ fireEvent.press(getByTestId("consent-history-item-toggle-entry-prov"));
212
+ await act(async () => {
213
+ fireEvent.press(getByTestId("consent-history-print-entry-prov"));
214
+ await new Promise((r) => setTimeout(r, 100));
215
+ });
216
+ await waitFor(() => {
217
+ expect(printedHtml).toHaveLength(1);
218
+ });
219
+ expect(printedHtml[0]).toContain("<h2>Provisional signature</h2>");
220
+ expect(printedHtml[0]).toContain("Dana Rivera");
221
+ expect(printedHtml[0]).toContain("Terms of Service");
222
+ expect(printedHtml[0]).not.toContain("Note:");
223
+ });
224
+ });
225
+ });
226
+
227
+ afterAll(() => {
228
+ printSpy.mockRestore();
161
229
  });
@@ -7,6 +7,7 @@ import {
7
7
  IconButton,
8
8
  MarkdownView,
9
9
  Page,
10
+ printConsentHtml,
10
11
  Spinner,
11
12
  Text,
12
13
  } from "@terreno/ui";
@@ -14,7 +15,9 @@ import {DateTime} from "luxon";
14
15
  import React, {useCallback, useState} from "react";
15
16
  import {Image, Pressable} from "react-native";
16
17
 
18
+ import {consentHistoryPrintHtml} from "./consentPdfTemplates";
17
19
  import {generateConsentHistoryPdf} from "./generateConsentHistoryPdf";
20
+ import {provisionalSignerName} from "./pdfUtils";
18
21
  import type {ConsentHistoryEntry} from "./useConsentHistory";
19
22
  import {useConsentHistory} from "./useConsentHistory";
20
23
 
@@ -54,6 +57,19 @@ const ConsentHistoryItem: React.FC<{entry: ConsentHistoryEntry}> = ({entry}) =>
54
57
  }
55
58
  }, [entry]);
56
59
 
60
+ const [isPrinting, setIsPrinting] = useState(false);
61
+
62
+ const handlePrint = useCallback(async () => {
63
+ setIsPrinting(true);
64
+ try {
65
+ await printConsentHtml({html: consentHistoryPrintHtml(entry)});
66
+ } catch (err) {
67
+ console.error("Failed to print consent record", err);
68
+ } finally {
69
+ setIsPrinting(false);
70
+ }
71
+ }, [entry]);
72
+
57
73
  const formTitle = entry.form?.title ?? "Unknown Form";
58
74
  const formType = entry.form?.type ?? "";
59
75
 
@@ -82,6 +98,20 @@ const ConsentHistoryItem: React.FC<{entry: ConsentHistoryEntry}> = ({entry}) =>
82
98
  {formatDate(entry.agreedAt)}
83
99
  </Text>
84
100
  </Box>
101
+ {Boolean(entry.provisional) && (
102
+ <Box
103
+ alignItems="center"
104
+ direction="row"
105
+ gap={2}
106
+ testID={`consent-history-provisional-${entry._id}`}
107
+ >
108
+ <Badge status="info" value="Provisional" />
109
+ {entry.voidedAt ? <Badge status="error" value="Voided" /> : null}
110
+ <Text color="secondaryDark" size="sm">
111
+ {`Signed on your behalf by ${provisionalSignerName(entry.provisionalSignedBy)}`}
112
+ </Text>
113
+ </Box>
114
+ )}
85
115
  </Box>
86
116
  <Box alignItems="center" justifyContent="center">
87
117
  <Icon
@@ -97,7 +127,15 @@ const ConsentHistoryItem: React.FC<{entry: ConsentHistoryEntry}> = ({entry}) =>
97
127
  <Box gap={3} padding={4} testID={`consent-history-item-details-${entry._id}`}>
98
128
  <Box alignItems="center" direction="row" justifyContent="between">
99
129
  <Box color="disabled" flex="grow" height={1} />
100
- <Box marginLeft={2}>
130
+ <Box direction="row" gap={2} marginLeft={2}>
131
+ <IconButton
132
+ accessibilityLabel="Print"
133
+ iconName="print"
134
+ loading={isPrinting}
135
+ onClick={handlePrint}
136
+ testID={`consent-history-print-${entry._id}`}
137
+ tooltipText="Print"
138
+ />
101
139
  <IconButton
102
140
  accessibilityLabel="Download PDF"
103
141
  iconName="download"
@@ -1,6 +1,7 @@
1
1
  // noExplicitAny: test mocks use type-erased RTK Query API doubles and dynamic mock returns
2
2
  // biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
3
- import {beforeEach, describe, expect, it, mock} from "bun:test";
3
+ import {afterAll, beforeEach, describe, expect, it, mock, spyOn} from "bun:test";
4
+ import * as terrenoUi from "@terreno/ui";
4
5
  import {act, fireEvent} from "@testing-library/react-native";
5
6
  import React from "react";
6
7
  import {renderWithTheme} from "../../ui/src/test-utils";
@@ -22,6 +23,16 @@ mock.module("./generateConsentPdf", () => ({
22
23
  },
23
24
  }));
24
25
 
26
+ const printedHtml: string[] = [];
27
+ let printImpl: () => Promise<void> = async () => {};
28
+ // Capture what the print button hands to @terreno/ui's printConsentHtml.
29
+ const printSpy = spyOn(terrenoUi, "printConsentHtml").mockImplementation(
30
+ async ({html}: {html: string}) => {
31
+ printedHtml.push(html);
32
+ return printImpl();
33
+ }
34
+ );
35
+
25
36
  import {ConsentResponseViewer} from "./ConsentResponseViewer";
26
37
 
27
38
  describe("ConsentResponseViewer", () => {
@@ -39,6 +50,8 @@ describe("ConsentResponseViewer", () => {
39
50
  readState.isLoading = false;
40
51
  pdfCalls.length = 0;
41
52
  pdfImpl = async () => {};
53
+ printedHtml.length = 0;
54
+ printImpl = async () => {};
42
55
  });
43
56
 
44
57
  it("renders loading state", () => {
@@ -134,4 +147,103 @@ describe("ConsentResponseViewer", () => {
134
147
  );
135
148
  expect(toJSON()).toBeDefined();
136
149
  });
150
+ describe("provisional signatures", () => {
151
+ const provisionalResponse = {
152
+ _id: "response-7",
153
+ agreed: true,
154
+ agreedAt: "2026-10-20T15:30:00.000Z",
155
+ consentFormId: {slug: "intake", title: "Intake Consent", type: "agreement", version: 1},
156
+ provisional: true,
157
+ provisionalNote: "Guardian agreed by phone",
158
+ provisionalSignedBy: {_id: "staff-1", email: "dana@example.com", name: "Dana Rivera"},
159
+ provisionalSignerIp: "10.0.0.7",
160
+ userId: {_id: "member-1", email: "sam@example.com", name: "Sam"},
161
+ };
162
+
163
+ it("shows the provisional badge, signer, date, and note", () => {
164
+ readState.data = provisionalResponse;
165
+ const {getByTestId, getByText, queryByTestId} = renderWithTheme(
166
+ <ConsentResponseViewer api={{} as unknown as AdminApi} baseUrl="/admin" id="response-7" />
167
+ );
168
+ expect(getByTestId("consent-response-provisional")).toBeDefined();
169
+ expect(getByText("Provisional")).toBeDefined();
170
+ expect(getByText("Dana Rivera")).toBeDefined();
171
+ expect(getByTestId("consent-response-provisional-note")).toBeDefined();
172
+ expect(getByText("Guardian agreed by phone")).toBeDefined();
173
+ expect(getByText("10.0.0.7")).toBeDefined();
174
+ expect(queryByTestId("consent-response-provisional-voided")).toBeNull();
175
+ });
176
+
177
+ it("shows the void state", () => {
178
+ readState.data = {
179
+ ...provisionalResponse,
180
+ voidedAt: "2026-10-21T09:00:00.000Z",
181
+ voidReason: "Wrong member",
182
+ };
183
+ const {getByTestId, getByText} = renderWithTheme(
184
+ <ConsentResponseViewer api={{} as unknown as AdminApi} baseUrl="/admin" id="response-7" />
185
+ );
186
+ expect(getByTestId("consent-response-provisional-voided")).toBeDefined();
187
+ expect(getByText("Wrong member")).toBeDefined();
188
+ });
189
+
190
+ it("shows no provisional section for the user's own response", () => {
191
+ readState.data = {agreed: true, consentFormId: {title: "Terms"}, userId: "u1"};
192
+ const {queryByTestId} = renderWithTheme(
193
+ <ConsentResponseViewer api={{} as unknown as AdminApi} baseUrl="/admin" id="r1" />
194
+ );
195
+ expect(queryByTestId("consent-response-provisional")).toBeNull();
196
+ });
197
+
198
+ it("prints HTML that includes the provisional block with the note", async () => {
199
+ readState.data = provisionalResponse;
200
+ const {getByTestId} = renderWithTheme(
201
+ <ConsentResponseViewer api={{} as unknown as AdminApi} baseUrl="/admin" id="response-7" />
202
+ );
203
+ await act(async () => {
204
+ fireEvent.press(getByTestId("consent-response-print-button"));
205
+ await new Promise((r) => setTimeout(r, 100));
206
+ });
207
+ expect(printedHtml).toHaveLength(1);
208
+ expect(printedHtml[0]).toContain("<h2>Provisional signature</h2>");
209
+ expect(printedHtml[0]).toContain("Dana Rivera");
210
+ expect(printedHtml[0]).toContain("Guardian agreed by phone");
211
+ expect(printedHtml[0]).toContain("10.0.0.7");
212
+ expect(printedHtml[0]).toContain("Intake Consent");
213
+ expect(pdfCalls).toHaveLength(0);
214
+ });
215
+
216
+ it("prints a non-provisional response without the provisional block", async () => {
217
+ readState.data = {agreed: true, consentFormId: {title: "Terms"}, userId: "u1"};
218
+ const {getByTestId} = renderWithTheme(
219
+ <ConsentResponseViewer api={{} as unknown as AdminApi} baseUrl="/admin" id="r1" />
220
+ );
221
+ await act(async () => {
222
+ fireEvent.press(getByTestId("consent-response-print-button"));
223
+ await new Promise((r) => setTimeout(r, 100));
224
+ });
225
+ expect(printedHtml).toHaveLength(1);
226
+ expect(printedHtml[0]).not.toContain("Provisional signature");
227
+ });
228
+
229
+ it("keeps the page usable when printing fails", async () => {
230
+ readState.data = provisionalResponse;
231
+ printImpl = async () => {
232
+ throw new Error("printer offline");
233
+ };
234
+ const {getByTestId} = renderWithTheme(
235
+ <ConsentResponseViewer api={{} as unknown as AdminApi} baseUrl="/admin" id="response-7" />
236
+ );
237
+ await act(async () => {
238
+ fireEvent.press(getByTestId("consent-response-print-button"));
239
+ await new Promise((r) => setTimeout(r, 100));
240
+ });
241
+ expect(printedHtml).toHaveLength(1);
242
+ expect(getByTestId("consent-response-print-button")).toBeDefined();
243
+ });
244
+ });
245
+ });
246
+
247
+ afterAll(() => {
248
+ printSpy.mockRestore();
137
249
  });