@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
@@ -0,0 +1,180 @@
1
+ import {describe, expect, it} from "bun:test";
2
+
3
+ import {
4
+ buildConsentHistoryTemplateData,
5
+ buildConsentResponseTemplateData,
6
+ consentHistoryPrintHtml,
7
+ consentResponsePrintHtml,
8
+ extractResponseFields,
9
+ } from "./consentPdfTemplates";
10
+ import {formatDate} from "./pdfUtils";
11
+
12
+ const signedAt = "2026-10-20T15:30:00.000Z";
13
+
14
+ describe("buildConsentResponseTemplateData", () => {
15
+ it("builds every section of a full admin response", () => {
16
+ const data = buildConsentResponseTemplateData({
17
+ _id: "response-1",
18
+ agreed: true,
19
+ agreedAt: signedAt,
20
+ checkboxValues: {"0": true, "1": false},
21
+ consentFormId: {slug: "intake", title: "Intake", type: "agreement", version: 2},
22
+ contentSnapshot: "# Intake",
23
+ formVersionSnapshot: 2,
24
+ ipAddress: "192.168.1.5",
25
+ locale: "en",
26
+ provisional: true,
27
+ provisionalNote: "Guardian agreed by phone",
28
+ provisionalSignedBy: {_id: "staff-1", name: "Dana Rivera"},
29
+ provisionalSignerIp: "10.0.0.7",
30
+ signature: "data:image/png;base64,AAA",
31
+ signedAt,
32
+ userAgent: "Safari",
33
+ userId: {_id: "member-1", email: "sam@example.com", name: "Sam"},
34
+ voidedAt: "2026-10-21T09:00:00.000Z",
35
+ });
36
+
37
+ expect(data.formTitle).toBe("Intake");
38
+ expect(data.fields).toEqual([
39
+ {label: "Form Slug:", value: "intake"},
40
+ {label: "Form Type:", value: "agreement"},
41
+ {label: "Form Version:", value: "2"},
42
+ {label: "Decision:", value: "Agreed"},
43
+ {label: "Agreed At:", value: formatDate(signedAt)},
44
+ {label: "Locale:", value: "en"},
45
+ ]);
46
+ expect(data.checkboxes).toEqual([
47
+ {checked: true, label: "Checkbox 0"},
48
+ {checked: false, label: "Checkbox 1"},
49
+ ]);
50
+ expect(data.auditTrail).toEqual([
51
+ {label: "IP Address:", value: "192.168.1.5"},
52
+ {label: "User Agent:", value: "Safari"},
53
+ {label: "Form Version:", value: "2"},
54
+ {label: "Signed At:", value: formatDate(signedAt)},
55
+ ]);
56
+ expect(data.userInfo).toEqual({email: "sam@example.com", name: "Sam", userId: "member-1"});
57
+ expect(data.provisionalSignature).toEqual({
58
+ note: "Guardian agreed by phone",
59
+ signedAt,
60
+ signedByName: "Dana Rivera",
61
+ signerIp: "10.0.0.7",
62
+ voidedAt: "2026-10-21T09:00:00.000Z",
63
+ });
64
+ expect(data.responseId).toBe("response-1");
65
+ });
66
+
67
+ it("leaves optional sections out of a minimal response", () => {
68
+ const data = buildConsentResponseTemplateData({agreed: false, userId: "member-1"});
69
+ expect(data.formTitle).toBe("Unknown Form");
70
+ expect(data.fields).toEqual([{label: "Decision:", value: "Declined"}]);
71
+ expect(data.checkboxes).toBeUndefined();
72
+ expect(data.auditTrail).toBeUndefined();
73
+ expect(data.provisionalSignature).toBeUndefined();
74
+ });
75
+ });
76
+
77
+ describe("extractResponseFields", () => {
78
+ it("reads ids from string refs", () => {
79
+ expect(
80
+ extractResponseFields({agreed: true, consentFormId: "form-1", userId: "member-1"})
81
+ ).toEqual({
82
+ formSlug: "",
83
+ formTitle: "Unknown Form",
84
+ formType: "",
85
+ formVersion: undefined,
86
+ userEmail: "",
87
+ userId: "member-1",
88
+ userName: "",
89
+ });
90
+ });
91
+ });
92
+
93
+ describe("buildConsentHistoryTemplateData", () => {
94
+ it("builds every section of the user's entry, without the signer's note", () => {
95
+ const data = buildConsentHistoryTemplateData({
96
+ _id: "entry-1",
97
+ agreed: true,
98
+ agreedAt: signedAt,
99
+ checkboxValues: {"0": true, "1": true},
100
+ contentSnapshot: "# Terms",
101
+ form: {
102
+ captureSignature: false,
103
+ checkboxes: [{label: "I have read the terms", required: true}],
104
+ slug: "tos",
105
+ title: "Terms",
106
+ type: "terms",
107
+ version: 3,
108
+ },
109
+ formVersionSnapshot: 3,
110
+ ipAddress: "192.168.1.5",
111
+ locale: "es",
112
+ provisional: true,
113
+ provisionalSignedBy: {name: "Dana Rivera"},
114
+ signature: "data:image/png;base64,BBB",
115
+ signedAt,
116
+ userAgent: "Chrome",
117
+ });
118
+
119
+ expect(data.fields).toEqual([
120
+ {label: "Form Slug:", value: "tos"},
121
+ {label: "Form Type:", value: "terms"},
122
+ {label: "Form Version:", value: "3"},
123
+ {label: "Decision:", value: "Agreed"},
124
+ {label: "Agreed At:", value: formatDate(signedAt)},
125
+ {label: "Locale:", value: "es"},
126
+ ]);
127
+ expect(data.checkboxes).toEqual([
128
+ {checked: true, label: "I have read the terms"},
129
+ {checked: true, label: "Checkbox 1"},
130
+ ]);
131
+ expect(data.auditTrail).toHaveLength(4);
132
+ expect(data.provisionalSignature).toEqual({
133
+ signedAt,
134
+ signedByName: "Dana Rivera",
135
+ voidedAt: undefined,
136
+ });
137
+ });
138
+
139
+ it("leaves optional sections out of a minimal entry", () => {
140
+ const data = buildConsentHistoryTemplateData({
141
+ _id: "entry-2",
142
+ agreed: false,
143
+ agreedAt: "",
144
+ form: null,
145
+ });
146
+ expect(data.formTitle).toBe("Unknown Form");
147
+ expect(data.fields).toEqual([{label: "Decision:", value: "Declined"}]);
148
+ expect(data.checkboxes).toBeUndefined();
149
+ expect(data.provisionalSignature).toBeUndefined();
150
+ });
151
+ });
152
+
153
+ describe("print HTML", () => {
154
+ it("renders the admin provisional block with the note", () => {
155
+ const html = consentResponsePrintHtml({
156
+ agreed: true,
157
+ agreedAt: signedAt,
158
+ provisional: true,
159
+ provisionalNote: "Guardian agreed by phone",
160
+ provisionalSignedBy: {name: "Dana Rivera"},
161
+ userId: "member-1",
162
+ });
163
+ expect(html).toContain("<h2>Provisional signature</h2>");
164
+ expect(html).toContain("Guardian agreed by phone");
165
+ });
166
+
167
+ it("renders the user's provisional block without a note", () => {
168
+ const html = consentHistoryPrintHtml({
169
+ _id: "entry-1",
170
+ agreed: true,
171
+ agreedAt: signedAt,
172
+ form: null,
173
+ provisional: true,
174
+ provisionalSignedBy: {name: "Dana Rivera"},
175
+ });
176
+ expect(html).toContain("<h2>Provisional signature</h2>");
177
+ expect(html).toContain("Dana Rivera");
178
+ expect(html).not.toContain("Note:");
179
+ });
180
+ });
@@ -0,0 +1,228 @@
1
+ /**
2
+ * `@terreno/ui` PdfTemplateData builders for consent records, shared by the native PDF
3
+ * generators and the print buttons. Admin records include the provisional signer's note and
4
+ * IP; the user's own history never does.
5
+ */
6
+
7
+ import {buildConsentPdfHtml, type PdfTemplateData} from "@terreno/ui";
8
+
9
+ import {
10
+ formatDate,
11
+ type PdfProvisionalSignatureSection,
12
+ provisionalPdfSignature,
13
+ provisionalSignerName,
14
+ } from "./pdfUtils";
15
+ import type {ConsentHistoryEntry} from "./useConsentHistory";
16
+
17
+ export interface ConsentResponseData {
18
+ _id?: string;
19
+ agreed: boolean;
20
+ agreedAt?: string;
21
+ checkboxValues?: Record<string, boolean>;
22
+ consentFormId?: {title?: string; slug?: string; version?: number; type?: string} | string;
23
+ contentSnapshot?: string;
24
+ formVersionSnapshot?: number;
25
+ ipAddress?: string;
26
+ locale?: string;
27
+ provisional?: boolean;
28
+ provisionalNote?: string;
29
+ provisionalSignedBy?: {_id?: string; email?: string; name?: string} | string | null;
30
+ provisionalSignerIp?: string;
31
+ signature?: string;
32
+ signedAt?: string;
33
+ userAgent?: string;
34
+ userId?: {_id?: string; email?: string; id?: string; name?: string} | string;
35
+ voidedAt?: string;
36
+ }
37
+
38
+ /** Admin printouts show every provisional detail, including the signer's note and IP. */
39
+ export const responseProvisionalSection = (
40
+ response: ConsentResponseData
41
+ ): PdfProvisionalSignatureSection | undefined => {
42
+ if (!response.provisional) {
43
+ return undefined;
44
+ }
45
+ return {
46
+ note: response.provisionalNote,
47
+ signedAt: response.agreedAt,
48
+ signedByName: provisionalSignerName(response.provisionalSignedBy),
49
+ signerIp: response.provisionalSignerIp,
50
+ voidedAt: response.voidedAt,
51
+ };
52
+ };
53
+
54
+ export const extractResponseFields = (response: ConsentResponseData) => {
55
+ const formTitle =
56
+ typeof response.consentFormId === "object"
57
+ ? (response.consentFormId?.title ?? "Unknown Form")
58
+ : "Unknown Form";
59
+
60
+ const formSlug =
61
+ typeof response.consentFormId === "object" ? (response.consentFormId?.slug ?? "") : "";
62
+
63
+ const formType =
64
+ typeof response.consentFormId === "object" ? (response.consentFormId?.type ?? "") : "";
65
+
66
+ const formVersion =
67
+ typeof response.consentFormId === "object"
68
+ ? response.consentFormId?.version
69
+ : response.formVersionSnapshot;
70
+
71
+ const userId =
72
+ typeof response.userId === "object"
73
+ ? String(response.userId?._id ?? response.userId?.id ?? response.userId)
74
+ : String(response.userId ?? "");
75
+
76
+ const userEmail = typeof response.userId === "object" ? (response.userId?.email ?? "") : "";
77
+
78
+ const userName = typeof response.userId === "object" ? (response.userId?.name ?? "") : "";
79
+
80
+ return {formSlug, formTitle, formType, formVersion, userEmail, userId, userName};
81
+ };
82
+
83
+ /** Template data for one admin consent response, used by the native PDF and printing. */
84
+ export const buildConsentResponseTemplateData = (
85
+ response: ConsentResponseData
86
+ ): PdfTemplateData => {
87
+ const {formTitle, formSlug, formType, formVersion, userId, userEmail, userName} =
88
+ extractResponseFields(response);
89
+
90
+ const fields: PdfTemplateData["fields"] = [];
91
+ if (formSlug) {
92
+ fields.push({label: "Form Slug:", value: formSlug});
93
+ }
94
+ if (formType) {
95
+ fields.push({label: "Form Type:", value: formType});
96
+ }
97
+ if (formVersion !== undefined) {
98
+ fields.push({label: "Form Version:", value: String(formVersion)});
99
+ }
100
+ fields.push({label: "Decision:", value: response.agreed ? "Agreed" : "Declined"});
101
+ if (response.agreedAt) {
102
+ fields.push({label: "Agreed At:", value: formatDate(response.agreedAt)});
103
+ }
104
+ if (response.locale) {
105
+ fields.push({label: "Locale:", value: response.locale});
106
+ }
107
+
108
+ const checkboxEntries =
109
+ response.checkboxValues && typeof response.checkboxValues === "object"
110
+ ? Object.entries(response.checkboxValues)
111
+ : [];
112
+
113
+ const checkboxes = checkboxEntries.map(([index, checked]) => ({
114
+ checked: Boolean(checked),
115
+ label: `Checkbox ${index}`,
116
+ }));
117
+
118
+ const auditTrail: PdfTemplateData["fields"] = [];
119
+ if (response.ipAddress) {
120
+ auditTrail.push({label: "IP Address:", value: response.ipAddress});
121
+ }
122
+ if (response.userAgent) {
123
+ auditTrail.push({label: "User Agent:", value: response.userAgent});
124
+ }
125
+ if (response.formVersionSnapshot !== undefined) {
126
+ auditTrail.push({label: "Form Version:", value: String(response.formVersionSnapshot)});
127
+ }
128
+ if (response.signedAt) {
129
+ auditTrail.push({label: "Signed At:", value: formatDate(response.signedAt)});
130
+ }
131
+
132
+ return {
133
+ auditTrail: auditTrail.length > 0 ? auditTrail : undefined,
134
+ checkboxes: checkboxes.length > 0 ? checkboxes : undefined,
135
+ contentSnapshot: response.contentSnapshot,
136
+ fields,
137
+ formTitle,
138
+ provisionalSignature: provisionalPdfSignature(responseProvisionalSection(response)),
139
+ responseId: response._id,
140
+ signature: response.signature,
141
+ title: "Consent Record",
142
+ userInfo: {email: userEmail || undefined, name: userName || undefined, userId},
143
+ };
144
+ };
145
+
146
+ /** The user's own printout names the signer and date only, never the signer's note. */
147
+ export const historyProvisionalSection = (
148
+ entry: ConsentHistoryEntry
149
+ ): PdfProvisionalSignatureSection | undefined => {
150
+ if (!entry.provisional) {
151
+ return undefined;
152
+ }
153
+ return {
154
+ signedAt: entry.agreedAt,
155
+ signedByName: provisionalSignerName(entry.provisionalSignedBy),
156
+ voidedAt: entry.voidedAt,
157
+ };
158
+ };
159
+
160
+ /** Template data for one of the user's consent entries, used by the native PDF and printing. */
161
+ export const buildConsentHistoryTemplateData = (entry: ConsentHistoryEntry): PdfTemplateData => {
162
+ const formTitle = entry.form?.title ?? "Unknown Form";
163
+ const formSlug = entry.form?.slug ?? "";
164
+ const formType = entry.form?.type ?? "";
165
+ const formVersion = entry.form?.version ?? entry.formVersionSnapshot;
166
+
167
+ const fields: PdfTemplateData["fields"] = [];
168
+ if (formSlug) {
169
+ fields.push({label: "Form Slug:", value: formSlug});
170
+ }
171
+ if (formType) {
172
+ fields.push({label: "Form Type:", value: formType});
173
+ }
174
+ if (formVersion !== undefined) {
175
+ fields.push({label: "Form Version:", value: String(formVersion)});
176
+ }
177
+ fields.push({label: "Decision:", value: entry.agreed ? "Agreed" : "Declined"});
178
+ if (entry.agreedAt) {
179
+ fields.push({label: "Agreed At:", value: formatDate(entry.agreedAt)});
180
+ }
181
+ if (entry.locale) {
182
+ fields.push({label: "Locale:", value: entry.locale});
183
+ }
184
+
185
+ const checkboxEntries =
186
+ entry.checkboxValues && typeof entry.checkboxValues === "object"
187
+ ? Object.entries(entry.checkboxValues)
188
+ : [];
189
+
190
+ const checkboxes = checkboxEntries.map(([index, checked]) => ({
191
+ checked: Boolean(checked),
192
+ label: entry.form?.checkboxes?.[Number(index)]?.label ?? `Checkbox ${index}`,
193
+ }));
194
+
195
+ const auditTrail: PdfTemplateData["fields"] = [];
196
+ if (entry.ipAddress) {
197
+ auditTrail.push({label: "IP Address:", value: entry.ipAddress});
198
+ }
199
+ if (entry.userAgent) {
200
+ auditTrail.push({label: "User Agent:", value: entry.userAgent});
201
+ }
202
+ if (entry.formVersionSnapshot !== undefined) {
203
+ auditTrail.push({label: "Form Version:", value: String(entry.formVersionSnapshot)});
204
+ }
205
+ if (entry.signedAt) {
206
+ auditTrail.push({label: "Signed At:", value: formatDate(entry.signedAt)});
207
+ }
208
+
209
+ return {
210
+ auditTrail: auditTrail.length > 0 ? auditTrail : undefined,
211
+ checkboxes: checkboxes.length > 0 ? checkboxes : undefined,
212
+ contentSnapshot: entry.contentSnapshot,
213
+ fields,
214
+ formTitle,
215
+ provisionalSignature: provisionalPdfSignature(historyProvisionalSection(entry)),
216
+ responseId: entry._id,
217
+ signature: entry.signature,
218
+ title: "Consent Record",
219
+ };
220
+ };
221
+
222
+ /** Printable HTML for one admin consent response. */
223
+ export const consentResponsePrintHtml = (response: ConsentResponseData): string =>
224
+ buildConsentPdfHtml(buildConsentResponseTemplateData(response));
225
+
226
+ /** Printable HTML for one of the user's consent entries. */
227
+ export const consentHistoryPrintHtml = (entry: ConsentHistoryEntry): string =>
228
+ buildConsentPdfHtml(buildConsentHistoryTemplateData(entry));
@@ -1,9 +1,10 @@
1
- import {buildConsentPdfHtml, type PdfTemplateData, sharePdfFromHtml} from "@terreno/ui";
1
+ import {buildConsentPdfHtml, sharePdfFromHtml} from "@terreno/ui";
2
2
  import {DateTime} from "luxon";
3
3
  import {Platform} from "react-native";
4
-
4
+ import {buildConsentHistoryTemplateData, historyProvisionalSection} from "./consentPdfTemplates";
5
5
  import {
6
6
  CONTENT_WIDTH,
7
+ drawProvisionalSignature,
7
8
  ensureSpace,
8
9
  formatDate,
9
10
  MARGIN_LEFT,
@@ -12,66 +13,6 @@ import {
12
13
  } from "./pdfUtils";
13
14
  import type {ConsentHistoryEntry} from "./useConsentHistory";
14
15
 
15
- const buildTemplateData = (entry: ConsentHistoryEntry): PdfTemplateData => {
16
- const formTitle = entry.form?.title ?? "Unknown Form";
17
- const formSlug = entry.form?.slug ?? "";
18
- const formType = entry.form?.type ?? "";
19
- const formVersion = entry.form?.version ?? entry.formVersionSnapshot;
20
-
21
- const fields: PdfTemplateData["fields"] = [];
22
- if (formSlug) {
23
- fields.push({label: "Form Slug:", value: formSlug});
24
- }
25
- if (formType) {
26
- fields.push({label: "Form Type:", value: formType});
27
- }
28
- if (formVersion !== undefined) {
29
- fields.push({label: "Form Version:", value: String(formVersion)});
30
- }
31
- fields.push({label: "Decision:", value: entry.agreed ? "Agreed" : "Declined"});
32
- if (entry.agreedAt) {
33
- fields.push({label: "Agreed At:", value: formatDate(entry.agreedAt)});
34
- }
35
- if (entry.locale) {
36
- fields.push({label: "Locale:", value: entry.locale});
37
- }
38
-
39
- const checkboxEntries =
40
- entry.checkboxValues && typeof entry.checkboxValues === "object"
41
- ? Object.entries(entry.checkboxValues)
42
- : [];
43
-
44
- const checkboxes = checkboxEntries.map(([index, checked]) => ({
45
- checked: Boolean(checked),
46
- label: entry.form?.checkboxes?.[Number(index)]?.label ?? `Checkbox ${index}`,
47
- }));
48
-
49
- const auditTrail: PdfTemplateData["fields"] = [];
50
- if (entry.ipAddress) {
51
- auditTrail.push({label: "IP Address:", value: entry.ipAddress});
52
- }
53
- if (entry.userAgent) {
54
- auditTrail.push({label: "User Agent:", value: entry.userAgent});
55
- }
56
- if (entry.formVersionSnapshot !== undefined) {
57
- auditTrail.push({label: "Form Version:", value: String(entry.formVersionSnapshot)});
58
- }
59
- if (entry.signedAt) {
60
- auditTrail.push({label: "Signed At:", value: formatDate(entry.signedAt)});
61
- }
62
-
63
- return {
64
- auditTrail: auditTrail.length > 0 ? auditTrail : undefined,
65
- checkboxes: checkboxes.length > 0 ? checkboxes : undefined,
66
- contentSnapshot: entry.contentSnapshot,
67
- fields,
68
- formTitle,
69
- responseId: entry._id,
70
- signature: entry.signature,
71
- title: "Consent Record",
72
- };
73
- };
74
-
75
16
  const generatePdfWeb = async (entry: ConsentHistoryEntry): Promise<void> => {
76
17
  const {jsPDF: JsPDF} = await import("jspdf");
77
18
  const doc = new JsPDF({format: "a4", orientation: "portrait", unit: "mm"});
@@ -185,6 +126,11 @@ const generatePdfWeb = async (entry: ConsentHistoryEntry): Promise<void> => {
185
126
  y += 4;
186
127
  }
187
128
 
129
+ const provisional = historyProvisionalSection(entry);
130
+ if (provisional) {
131
+ y = drawProvisionalSignature(doc, y, provisional);
132
+ }
133
+
188
134
  if (entry.signature) {
189
135
  y = ensureSpace(doc, y, 50);
190
136
  doc.setFontSize(12);
@@ -244,7 +190,7 @@ const generatePdfWeb = async (entry: ConsentHistoryEntry): Promise<void> => {
244
190
  };
245
191
 
246
192
  const generatePdfMobile = async (entry: ConsentHistoryEntry): Promise<void> => {
247
- const templateData = buildTemplateData(entry);
193
+ const templateData = buildConsentHistoryTemplateData(entry);
248
194
  const html = buildConsentPdfHtml(templateData);
249
195
  const formSlug = entry.form?.slug ?? "response";
250
196
  const filename = `consent-${formSlug}-${DateTime.now().toFormat("yyyy-MM-dd")}.pdf`;
@@ -1,9 +1,15 @@
1
- import {buildConsentPdfHtml, type PdfTemplateData, sharePdfFromHtml} from "@terreno/ui";
1
+ import {buildConsentPdfHtml, sharePdfFromHtml} from "@terreno/ui";
2
2
  import {DateTime} from "luxon";
3
3
  import {Platform} from "react-native";
4
-
4
+ import {
5
+ buildConsentResponseTemplateData,
6
+ type ConsentResponseData,
7
+ extractResponseFields,
8
+ responseProvisionalSection,
9
+ } from "./consentPdfTemplates";
5
10
  import {
6
11
  CONTENT_WIDTH,
12
+ drawProvisionalSignature,
7
13
  ensureSpace,
8
14
  formatDate,
9
15
  MARGIN_LEFT,
@@ -11,110 +17,6 @@ import {
11
17
  PAGE_WIDTH,
12
18
  } from "./pdfUtils";
13
19
 
14
- interface ConsentResponseData {
15
- _id?: string;
16
- agreed: boolean;
17
- agreedAt?: string;
18
- checkboxValues?: Record<string, boolean>;
19
- consentFormId?: {title?: string; slug?: string; version?: number; type?: string} | string;
20
- contentSnapshot?: string;
21
- formVersionSnapshot?: number;
22
- ipAddress?: string;
23
- locale?: string;
24
- signature?: string;
25
- signedAt?: string;
26
- userAgent?: string;
27
- userId?: {_id?: string; email?: string; id?: string; name?: string} | string;
28
- }
29
-
30
- const extractResponseFields = (response: ConsentResponseData) => {
31
- const formTitle =
32
- typeof response.consentFormId === "object"
33
- ? (response.consentFormId?.title ?? "Unknown Form")
34
- : "Unknown Form";
35
-
36
- const formSlug =
37
- typeof response.consentFormId === "object" ? (response.consentFormId?.slug ?? "") : "";
38
-
39
- const formType =
40
- typeof response.consentFormId === "object" ? (response.consentFormId?.type ?? "") : "";
41
-
42
- const formVersion =
43
- typeof response.consentFormId === "object"
44
- ? response.consentFormId?.version
45
- : response.formVersionSnapshot;
46
-
47
- const userId =
48
- typeof response.userId === "object"
49
- ? String(response.userId?._id ?? response.userId?.id ?? response.userId)
50
- : String(response.userId ?? "");
51
-
52
- const userEmail = typeof response.userId === "object" ? (response.userId?.email ?? "") : "";
53
-
54
- const userName = typeof response.userId === "object" ? (response.userId?.name ?? "") : "";
55
-
56
- return {formSlug, formTitle, formType, formVersion, userEmail, userId, userName};
57
- };
58
-
59
- const buildTemplateData = (response: ConsentResponseData): PdfTemplateData => {
60
- const {formTitle, formSlug, formType, formVersion, userId, userEmail, userName} =
61
- extractResponseFields(response);
62
-
63
- const fields: PdfTemplateData["fields"] = [];
64
- if (formSlug) {
65
- fields.push({label: "Form Slug:", value: formSlug});
66
- }
67
- if (formType) {
68
- fields.push({label: "Form Type:", value: formType});
69
- }
70
- if (formVersion !== undefined) {
71
- fields.push({label: "Form Version:", value: String(formVersion)});
72
- }
73
- fields.push({label: "Decision:", value: response.agreed ? "Agreed" : "Declined"});
74
- if (response.agreedAt) {
75
- fields.push({label: "Agreed At:", value: formatDate(response.agreedAt)});
76
- }
77
- if (response.locale) {
78
- fields.push({label: "Locale:", value: response.locale});
79
- }
80
-
81
- const checkboxEntries =
82
- response.checkboxValues && typeof response.checkboxValues === "object"
83
- ? Object.entries(response.checkboxValues)
84
- : [];
85
-
86
- const checkboxes = checkboxEntries.map(([index, checked]) => ({
87
- checked: Boolean(checked),
88
- label: `Checkbox ${index}`,
89
- }));
90
-
91
- const auditTrail: PdfTemplateData["fields"] = [];
92
- if (response.ipAddress) {
93
- auditTrail.push({label: "IP Address:", value: response.ipAddress});
94
- }
95
- if (response.userAgent) {
96
- auditTrail.push({label: "User Agent:", value: response.userAgent});
97
- }
98
- if (response.formVersionSnapshot !== undefined) {
99
- auditTrail.push({label: "Form Version:", value: String(response.formVersionSnapshot)});
100
- }
101
- if (response.signedAt) {
102
- auditTrail.push({label: "Signed At:", value: formatDate(response.signedAt)});
103
- }
104
-
105
- return {
106
- auditTrail: auditTrail.length > 0 ? auditTrail : undefined,
107
- checkboxes: checkboxes.length > 0 ? checkboxes : undefined,
108
- contentSnapshot: response.contentSnapshot,
109
- fields,
110
- formTitle,
111
- responseId: response._id,
112
- signature: response.signature,
113
- title: "Consent Record",
114
- userInfo: {email: userEmail || undefined, name: userName || undefined, userId},
115
- };
116
- };
117
-
118
20
  const generatePdfWeb = async (response: ConsentResponseData): Promise<void> => {
119
21
  const {jsPDF: JsPDF} = await import("jspdf");
120
22
  const doc = new JsPDF({format: "a4", orientation: "portrait", unit: "mm"});
@@ -250,6 +152,11 @@ const generatePdfWeb = async (response: ConsentResponseData): Promise<void> => {
250
152
  y += 4;
251
153
  }
252
154
 
155
+ const provisional = responseProvisionalSection(response);
156
+ if (provisional) {
157
+ y = drawProvisionalSignature(doc, y, provisional);
158
+ }
159
+
253
160
  // Signature
254
161
  if (response.signature) {
255
162
  y = ensureSpace(doc, y, 50);
@@ -314,7 +221,7 @@ const generatePdfWeb = async (response: ConsentResponseData): Promise<void> => {
314
221
  };
315
222
 
316
223
  const generatePdfMobile = async (response: ConsentResponseData): Promise<void> => {
317
- const templateData = buildTemplateData(response);
224
+ const templateData = buildConsentResponseTemplateData(response);
318
225
  const html = buildConsentPdfHtml(templateData);
319
226
  const {formSlug, userId} = extractResponseFields(response);
320
227
  const filename = `consent-${formSlug || "response"}-${userId.slice(-6)}-${DateTime.now().toFormat("yyyy-MM-dd")}.pdf`;
package/src/index.tsx CHANGED
@@ -103,6 +103,7 @@ export {
103
103
  serializeJobsDashboardSearchParams,
104
104
  } from "./jobs/jobsDashboardParams";
105
105
  export {LocaleContentEditor} from "./LocaleContentEditor";
106
+ export {MemberSecurityPanel, type MemberSecurityPanelProps} from "./orgs/MemberSecurityPanel";
106
107
  export {
107
108
  type OrganizationSummary,
108
109
  OrgDirectoryScreen,
@@ -115,6 +116,16 @@ export {
115
116
  type OrganizationSettings,
116
117
  organizationSettingsOf,
117
118
  } from "./orgs/organizationSettings";
119
+ export {
120
+ type MemberSecurityAction,
121
+ type MemberSecurityActionResult,
122
+ type MemberSecuritySummary,
123
+ memberSecurityPath,
124
+ resolveSecurityActionRequest,
125
+ type UseMemberSecurityApiArgs,
126
+ type UseMemberSecurityApiResult,
127
+ useMemberSecurityApi,
128
+ } from "./orgs/useMemberSecurityApi";
118
129
  export {useOrganizationsApi} from "./orgs/useOrganizationsApi";
119
130
  export {
120
131
  OrgContextProvider,
@@ -155,6 +166,13 @@ export type {
155
166
  ScreenWidgetComponent,
156
167
  } from "./types";
157
168
  export {resolveAdminBases, SYSTEM_FIELDS} from "./types";
169
+ export {
170
+ UserSecurityLink,
171
+ type UserSecurityLinkProps,
172
+ UserSecurityScreen,
173
+ type UserSecurityScreenProps,
174
+ userSecurityRoute,
175
+ } from "./UserSecurityScreen";
158
176
  export {useAdminApi} from "./useAdminApi";
159
177
  export {useAdminConfig} from "./useAdminConfig";
160
178
  export {useAdminRpc, useAdminRpcMutation, useAdminRpcQuery} from "./useAdminRpc";