@terreno/admin-frontend 57.19.2 → 57.20.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 (149) hide show
  1. package/CHANGELOG.md +393 -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 +3 -0
  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 +5 -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 +2 -2
  104. package/src/AdminFieldRenderer.tsx +48 -3
  105. package/src/AdminFieldRendererCore.tsx +12 -5
  106. package/src/AdminFilterDrawer.tsx +2 -2
  107. package/src/AdminHome.test.tsx +64 -1
  108. package/src/AdminHome.tsx +14 -6
  109. package/src/AdminModelForm.tsx +4 -0
  110. package/src/AdminNestedArrayField.tsx +116 -44
  111. package/src/AdminNestedObjectField.test.tsx +239 -0
  112. package/src/AdminNestedObjectField.tsx +145 -0
  113. package/src/AdminRolesField.tsx +6 -2
  114. package/src/AdminRolesList.test.tsx +25 -1
  115. package/src/AdminShell.test.tsx +15 -1
  116. package/src/AdminShell.tsx +5 -8
  117. package/src/ConfigurationScreen.tsx +6 -2
  118. package/src/ConsentHistory.test.tsx +69 -1
  119. package/src/ConsentHistory.tsx +39 -1
  120. package/src/ConsentResponseViewer.test.tsx +113 -1
  121. package/src/ConsentResponseViewer.tsx +106 -8
  122. package/src/Constants.ts +5 -2
  123. package/src/UserSecurityScreen.tsx +184 -0
  124. package/src/consentPdfTemplates.test.ts +180 -0
  125. package/src/consentPdfTemplates.ts +228 -0
  126. package/src/generateConsentHistoryPdf.ts +9 -63
  127. package/src/generateConsentPdf.ts +14 -107
  128. package/src/index.tsx +18 -0
  129. package/src/isolated/AdminNestedArrayField.isolated.tsx +93 -1
  130. package/src/isolated/UserSecurityScreen.isolated.tsx +365 -0
  131. package/src/isolated/generateConsentHistoryPdf.isolated.ts +33 -0
  132. package/src/isolated/generateConsentPdf.isolated.ts +47 -0
  133. package/src/isolated/generateConsentPdfMobile.isolated.ts +28 -0
  134. package/src/isolated/generateConsentPdfsMobile.isolated.ts +36 -0
  135. package/src/isolated/hooks.isolated.tsx +97 -0
  136. package/src/orgs/MemberSecurityPanel.test.tsx +584 -0
  137. package/src/orgs/MemberSecurityPanel.tsx +520 -0
  138. package/src/orgs/OrgManagementScreens.test.tsx +120 -1
  139. package/src/orgs/OrgMembersScreen.tsx +71 -4
  140. package/src/orgs/adminModelEndpoints.ts +56 -15
  141. package/src/orgs/useMemberSecurityApi.ts +198 -0
  142. package/src/pdfUtils.test.ts +24 -1
  143. package/src/pdfUtils.ts +93 -0
  144. package/src/types.ts +5 -1
  145. package/src/useAdminApi.ts +23 -3
  146. package/src/useAdminRoles.ts +11 -3
  147. package/src/useAdminRpc.test.tsx +115 -1
  148. package/src/useAdminRpc.ts +19 -3
  149. package/src/useConsentHistory.ts +5 -0
@@ -0,0 +1,145 @@
1
+ import {Box, Heading, Text} from "@terreno/ui";
2
+ import startCase from "lodash/startCase";
3
+ import React, {useCallback, useMemo} from "react";
4
+ import type {AdminFieldConfig, AdminFieldValue} from "./types";
5
+ import {SYSTEM_FIELDS} from "./types";
6
+
7
+ export interface AdminNestedObjectSubFieldArgs {
8
+ /** Dotted path of the subfield, e.g. `tasks.enabled`. */
9
+ fieldKey: string;
10
+ /** Humanized label of the subfield's own key. */
11
+ label: string;
12
+ fieldConfig: AdminFieldConfig;
13
+ value: AdminFieldValue;
14
+ onChange: (value: AdminFieldValue) => void;
15
+ readOnly?: boolean;
16
+ }
17
+
18
+ interface AdminNestedObjectFieldProps {
19
+ /** Dotted path of the object field, used as the prefix for subfield keys and test IDs. */
20
+ fieldKey: string;
21
+ title: string;
22
+ helperText?: string;
23
+ errorText?: string;
24
+ fields: Record<string, AdminFieldConfig>;
25
+ value: AdminFieldValue;
26
+ onChange: (value: Record<string, AdminFieldValue>) => void;
27
+ readOnly?: boolean;
28
+ /**
29
+ * Renders one subfield. Passed in by the caller so subfields can use the full renderer
30
+ * (including nested arrays and deeper objects) without a require cycle.
31
+ */
32
+ renderSubField: (args: AdminNestedObjectSubFieldArgs) => React.ReactElement;
33
+ }
34
+
35
+ /** Whether a field config describes a nested object whose subfields can be rendered as a group. */
36
+ export const isNestedObjectField = (fieldConfig: AdminFieldConfig): boolean => {
37
+ return (
38
+ fieldConfig.type === "object" &&
39
+ !fieldConfig.widget &&
40
+ fieldConfig.items != null &&
41
+ Object.keys(fieldConfig.items).length > 0
42
+ );
43
+ };
44
+
45
+ /**
46
+ * Initial value for a nested object in a create form: each subfield's schema default, or the
47
+ * same blank value a top-level field of that type starts with. Enums, refs, dates, and Mixed
48
+ * subfields without a default are left out so a blank value never fails a cast or enum check.
49
+ */
50
+ export const buildNestedObjectDefault = (
51
+ fields: Record<string, AdminFieldConfig>
52
+ ): Record<string, AdminFieldValue> => {
53
+ const result: Record<string, AdminFieldValue> = {};
54
+ for (const [key, config] of Object.entries(fields)) {
55
+ if (SYSTEM_FIELDS.has(key)) {
56
+ continue;
57
+ }
58
+ if (config.default !== undefined) {
59
+ result[key] = config.default;
60
+ } else if (isNestedObjectField(config) && config.items) {
61
+ result[key] = buildNestedObjectDefault(config.items);
62
+ } else if (config.type === "boolean") {
63
+ result[key] = false;
64
+ } else if (config.type === "number") {
65
+ result[key] = 0;
66
+ } else if (config.type === "array") {
67
+ result[key] = [];
68
+ } else if (config.type === "string" && !config.ref && !config.enum?.length) {
69
+ result[key] = "";
70
+ }
71
+ }
72
+ return result;
73
+ };
74
+
75
+ const toObjectValue = (value: AdminFieldValue): Record<string, AdminFieldValue> => {
76
+ if (value && typeof value === "object" && !Array.isArray(value)) {
77
+ return value as Record<string, AdminFieldValue>;
78
+ }
79
+ return {};
80
+ };
81
+
82
+ /**
83
+ * Renders a nested (non-array) object path as a titled group of its subfields, each with its
84
+ * type-appropriate control. Editing a subfield writes the merged object back to the parent.
85
+ */
86
+ export const AdminNestedObjectField: React.FC<AdminNestedObjectFieldProps> = ({
87
+ fieldKey,
88
+ title,
89
+ helperText,
90
+ errorText,
91
+ fields,
92
+ value,
93
+ onChange,
94
+ readOnly,
95
+ renderSubField,
96
+ }) => {
97
+ const objectValue = useMemo((): Record<string, AdminFieldValue> => toObjectValue(value), [value]);
98
+
99
+ const subFieldEntries = useMemo((): [string, AdminFieldConfig][] => {
100
+ return Object.entries(fields).filter(([key]) => !SYSTEM_FIELDS.has(key));
101
+ }, [fields]);
102
+
103
+ const handleSubFieldChange = useCallback(
104
+ (subKey: string, subValue: AdminFieldValue): void => {
105
+ onChange({...objectValue, [subKey]: subValue});
106
+ },
107
+ [objectValue, onChange]
108
+ );
109
+
110
+ return (
111
+ <Box
112
+ border="default"
113
+ gap={3}
114
+ padding={3}
115
+ rounding="md"
116
+ testID={`admin-field-group-${fieldKey}`}
117
+ >
118
+ <Box gap={1}>
119
+ <Heading size="sm">{title}</Heading>
120
+ {helperText ? (
121
+ <Text color="secondaryDark" size="sm">
122
+ {helperText}
123
+ </Text>
124
+ ) : null}
125
+ {errorText ? (
126
+ <Text color="error" size="sm">
127
+ {errorText}
128
+ </Text>
129
+ ) : null}
130
+ </Box>
131
+ {subFieldEntries.map(([subKey, subConfig]) => (
132
+ <React.Fragment key={subKey}>
133
+ {renderSubField({
134
+ fieldConfig: subConfig,
135
+ fieldKey: `${fieldKey}.${subKey}`,
136
+ label: startCase(subKey),
137
+ onChange: (subValue: AdminFieldValue) => handleSubFieldChange(subKey, subValue),
138
+ readOnly,
139
+ value: objectValue[subKey] ?? subConfig.default,
140
+ })}
141
+ </React.Fragment>
142
+ ))}
143
+ </Box>
144
+ );
145
+ };
@@ -15,7 +15,9 @@ const roleNamesFromValue = (value: unknown): string[] => {
15
15
  * User-role editor backed by the RBAC role collection.
16
16
  *
17
17
  * Existing assignments remain visible and removable while the select only offers roles that
18
- * are not already assigned.
18
+ * are not already assigned. A read-only field lists the assigned role names without loading the
19
+ * role catalog, so staff who may view a user but not read RBAC roles (such as an operator) see
20
+ * the record without a refused `/rbac/roles` request.
19
21
  */
20
22
  export const AdminRolesField: React.FC<AdminFieldWidgetProps> = ({
21
23
  api,
@@ -29,7 +31,9 @@ export const AdminRolesField: React.FC<AdminFieldWidgetProps> = ({
29
31
  }) => {
30
32
  const {apiBase: resolvedApiBase} = resolveAdminBases({apiBase, baseUrl});
31
33
  const {useListRolesQuery} = useAdminRoles(api, resolvedApiBase);
32
- const {data, error, isLoading} = useListRolesQuery();
34
+ // The catalog only supplies display names and the options to add; a read-only field needs
35
+ // neither, and its viewer may lack `rbac:read`.
36
+ const {data, error, isLoading} = useListRolesQuery(undefined, {skip: Boolean(readOnly)});
33
37
  const roles = normalizeRoles(data);
34
38
  const selectedRoleNames = roleNamesFromValue(value);
35
39
  const selectedRoleSet = useMemo(() => new Set(selectedRoleNames), [selectedRoleNames]);
@@ -12,7 +12,11 @@ import type {AdminApi} from "./types";
12
12
  import {normalizeRoles, normalizeStatements, type RolesQueryResult} from "./useAdminRoles";
13
13
 
14
14
  const mockUseListRolesQuery = mock(
15
- (): RolesQueryResult => ({data: undefined, error: null, isLoading: false})
15
+ (_arg?: undefined, _options?: {skip?: boolean}): RolesQueryResult => ({
16
+ data: undefined,
17
+ error: null,
18
+ isLoading: false,
19
+ })
16
20
  );
17
21
  const mockRefetch = mock(() => {});
18
22
  const mockCreateRole = mock(() => ({unwrap: async () => ({})}));
@@ -573,6 +577,26 @@ describe("AdminRolesField", () => {
573
577
  expect(onChange).toHaveBeenCalledWith(["member", "manager"]);
574
578
  });
575
579
 
580
+ it("does not load the role catalog for a read-only field", () => {
581
+ mockUseListRolesQuery.mockClear();
582
+ const {getByTestId, queryByTestId} = renderWithTheme(
583
+ <AdminRolesField
584
+ api={mockApi}
585
+ apiBase="/admin"
586
+ fieldConfig={fieldConfig}
587
+ fieldKey="roles"
588
+ onChange={mock(() => undefined)}
589
+ readOnly
590
+ value={["member"]}
591
+ />
592
+ );
593
+
594
+ expect(mockUseListRolesQuery.mock.calls.at(-1)).toEqual([undefined, {skip: true}]);
595
+ expect(getByTestId("admin-field-roles-selected-member")).toBeTruthy();
596
+ expect(queryByTestId("admin-field-roles-add")).toBeNull();
597
+ expect(queryByTestId("admin-field-roles-load-error")).toBeNull();
598
+ });
599
+
576
600
  it("removes an assigned role without changing other assignments", async () => {
577
601
  const onChange = mock((_value: unknown) => undefined);
578
602
  const {getByTestId} = renderWithTheme(
@@ -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,
@@ -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
  });