@terreno/admin-frontend 57.18.0 → 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 +2074 -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 +3 -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
@@ -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
  });
@@ -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
+ };