@terreno/admin-frontend 57.1.0 → 57.3.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 (139) hide show
  1. package/.ai/guidelines/core.md +10 -7
  2. package/README.md +2 -0
  3. package/dist/AdminModelForm.js +14 -7
  4. package/dist/AdminModelForm.js.map +1 -1
  5. package/dist/AdminModelList.js +3 -1
  6. package/dist/AdminModelList.js.map +1 -1
  7. package/dist/AdminModelTable.js +2 -1
  8. package/dist/AdminModelTable.js.map +1 -1
  9. package/dist/AdminRolesList.js +67 -6
  10. package/dist/AdminRolesList.js.map +1 -1
  11. package/dist/AdminScreenPage.d.ts +18 -0
  12. package/dist/AdminScreenPage.js +35 -0
  13. package/dist/AdminScreenPage.js.map +1 -0
  14. package/dist/AdminScreenRouter.js +4 -3
  15. package/dist/AdminScreenRouter.js.map +1 -1
  16. package/dist/AdminScriptList.js +12 -10
  17. package/dist/AdminScriptList.js.map +1 -1
  18. package/dist/AdminShell.js +24 -11
  19. package/dist/AdminShell.js.map +1 -1
  20. package/dist/DocumentStorageBrowser.js +4 -3
  21. package/dist/DocumentStorageBrowser.js.map +1 -1
  22. package/dist/adminPageAccess.d.ts +5 -0
  23. package/dist/adminPageAccess.js +19 -0
  24. package/dist/adminPageAccess.js.map +1 -0
  25. package/dist/comms/CommsDashboardScreen.d.ts +10 -0
  26. package/dist/comms/CommsDashboardScreen.js +183 -0
  27. package/dist/comms/CommsDashboardScreen.js.map +1 -0
  28. package/dist/comms/CommsDashboardScreenWidget.d.ts +4 -0
  29. package/dist/comms/CommsDashboardScreenWidget.js +11 -0
  30. package/dist/comms/CommsDashboardScreenWidget.js.map +1 -0
  31. package/dist/comms/CommsMessageDetail.d.ts +8 -0
  32. package/dist/comms/CommsMessageDetail.js +50 -0
  33. package/dist/comms/CommsMessageDetail.js.map +1 -0
  34. package/dist/comms/CommsStatCard.d.ts +17 -0
  35. package/dist/comms/CommsStatCard.js +14 -0
  36. package/dist/comms/CommsStatCard.js.map +1 -0
  37. package/dist/comms/CommsStatusBadge.d.ts +5 -0
  38. package/dist/comms/CommsStatusBadge.js +14 -0
  39. package/dist/comms/CommsStatusBadge.js.map +1 -0
  40. package/dist/comms/commsDashboardParams.d.ts +17 -0
  41. package/dist/comms/commsDashboardParams.js +71 -0
  42. package/dist/comms/commsDashboardParams.js.map +1 -0
  43. package/dist/comms/commsMessagePayload.d.ts +49 -0
  44. package/dist/comms/commsMessagePayload.js +43 -0
  45. package/dist/comms/commsMessagePayload.js.map +1 -0
  46. package/dist/comms/commsRetrySummary.d.ts +4 -0
  47. package/dist/comms/commsRetrySummary.js +12 -0
  48. package/dist/comms/commsRetrySummary.js.map +1 -0
  49. package/dist/comms/useCommsDashboardApi.d.ts +78 -0
  50. package/dist/comms/useCommsDashboardApi.js +60 -0
  51. package/dist/comms/useCommsDashboardApi.js.map +1 -0
  52. package/dist/comms/useCommsDashboardUrlFilters.d.ts +5 -0
  53. package/dist/comms/useCommsDashboardUrlFilters.js +16 -0
  54. package/dist/comms/useCommsDashboardUrlFilters.js.map +1 -0
  55. package/dist/index.d.ts +8 -0
  56. package/dist/index.js +8 -0
  57. package/dist/index.js.map +1 -1
  58. package/dist/types.d.ts +15 -0
  59. package/dist/types.js.map +1 -1
  60. package/dist/useAdminBackgroundTask.d.ts +10 -2
  61. package/dist/useAdminBackgroundTask.js.map +1 -1
  62. package/dist/useConfigurationApi.d.ts +13 -15
  63. package/dist/useConfigurationApi.js.map +1 -1
  64. package/dist/widgets/AIRequestsScreenWidget.js +4 -3
  65. package/dist/widgets/AIRequestsScreenWidget.js.map +1 -1
  66. package/dist/widgets/DocumentsScreenWidget.js +2 -2
  67. package/dist/widgets/DocumentsScreenWidget.js.map +1 -1
  68. package/dist/widgets/builtInWidgets.js +2 -1
  69. package/dist/widgets/builtInWidgets.js.map +1 -1
  70. package/package.json +17 -3
  71. package/src/AdminActionMenu.test.tsx +1 -1
  72. package/src/AdminBreadcrumbs.test.tsx +1 -1
  73. package/src/AdminFieldRenderer.test.tsx +6 -1
  74. package/src/AdminHome.test.tsx +1 -1
  75. package/src/AdminModelForm.test.tsx +34 -1
  76. package/src/AdminModelForm.tsx +25 -9
  77. package/src/AdminModelList.test.tsx +1 -1
  78. package/src/AdminModelList.tsx +3 -1
  79. package/src/AdminModelTable.test.tsx +1 -1
  80. package/src/AdminModelTable.tsx +3 -1
  81. package/src/AdminPrimitiveArrayField.test.tsx +1 -1
  82. package/src/AdminRolesList.test.tsx +85 -3
  83. package/src/AdminRolesList.tsx +147 -24
  84. package/src/AdminScreenPage.test.tsx +81 -0
  85. package/src/AdminScreenPage.tsx +37 -0
  86. package/src/AdminScreenRouter.test.tsx +2 -1
  87. package/src/AdminScreenRouter.tsx +18 -5
  88. package/src/AdminScriptList.test.tsx +1 -1
  89. package/src/AdminScriptList.tsx +42 -30
  90. package/src/AdminShell.test.tsx +90 -1
  91. package/src/AdminShell.tsx +31 -10
  92. package/src/AdminVersionConfig.test.tsx +1 -1
  93. package/src/CheckboxListEditor.test.tsx +1 -1
  94. package/src/ConfigurationScreen.test.tsx +1 -1
  95. package/src/ConsentFormEditor.test.tsx +1 -1
  96. package/src/ConsentFormList.test.tsx +1 -1
  97. package/src/ConsentHistory.test.tsx +1 -1
  98. package/src/ConsentResponseViewer.test.tsx +1 -1
  99. package/src/DocumentStorageBrowser.test.tsx +1 -1
  100. package/src/DocumentStorageBrowser.tsx +10 -3
  101. package/src/LocaleContentEditor.test.tsx +1 -1
  102. package/src/adminModelListQueryParams.test.ts +59 -0
  103. package/src/adminPageAccess.test.ts +18 -0
  104. package/src/adminPageAccess.ts +18 -0
  105. package/src/comms/CommsDashboardScreen.test.tsx +397 -0
  106. package/src/comms/CommsDashboardScreen.tsx +500 -0
  107. package/src/comms/CommsDashboardScreenWidget.test.tsx +62 -0
  108. package/src/comms/CommsDashboardScreenWidget.tsx +20 -0
  109. package/src/comms/CommsMessageDetail.test.tsx +245 -0
  110. package/src/comms/CommsMessageDetail.tsx +239 -0
  111. package/src/comms/CommsStatCard.test.tsx +69 -0
  112. package/src/comms/CommsStatCard.tsx +60 -0
  113. package/src/comms/CommsStatusBadge.tsx +14 -0
  114. package/src/comms/commsDashboardParams.test.ts +75 -0
  115. package/src/comms/commsDashboardParams.ts +91 -0
  116. package/src/comms/commsMessagePayload.test.ts +22 -0
  117. package/src/comms/commsMessagePayload.ts +83 -0
  118. package/src/comms/commsRetrySummary.ts +10 -0
  119. package/src/comms/useCommsDashboardApi.test.tsx +144 -0
  120. package/src/comms/useCommsDashboardApi.tsx +128 -0
  121. package/src/comms/useCommsDashboardUrlFilters.test.tsx +58 -0
  122. package/src/comms/useCommsDashboardUrlFilters.tsx +31 -0
  123. package/src/dynamicHookApi.ts +1 -1
  124. package/src/index.tsx +15 -0
  125. package/src/isolated/AdminFieldRenderer.isolated.tsx +1 -1
  126. package/src/{AdminFilterDrawer.test.tsx → isolated/AdminFilterDrawer.isolated.tsx} +8 -2
  127. package/src/isolated/AdminNestedArrayField.isolated.tsx +1 -1
  128. package/src/isolated/AdminObjectPicker.isolated.tsx +1 -1
  129. package/src/isolated/AdminRefField.isolated.tsx +1 -1
  130. package/src/isolated/AdminScriptRunModal.isolated.tsx +1 -1
  131. package/src/isolated/DocumentStorageBrowser.isolated.tsx +1 -1
  132. package/src/isolated/hooks.isolated.tsx +1 -1
  133. package/src/types.ts +16 -0
  134. package/src/useAdminBackgroundTask.ts +7 -5
  135. package/src/useConfigurationApi.ts +13 -16
  136. package/src/widgets/AIRequestsScreenWidget.tsx +5 -4
  137. package/src/widgets/DocumentsScreenWidget.tsx +9 -2
  138. package/src/widgets/builtInWidgets.ts +2 -0
  139. package/src/widgets/pluginWidgets.test.tsx +3 -1
@@ -0,0 +1,245 @@
1
+ import {beforeEach, describe, expect, it, mock} from "bun:test";
2
+ import {act, fireEvent} from "@testing-library/react-native";
3
+ import React from "react";
4
+ import {renderWithTheme} from "../../../ui/src/test-utils";
5
+ import type {AdminApi} from "../types";
6
+
7
+ const pushMock = mock(() => {});
8
+ mock.module("expo-router", () => ({
9
+ router: {push: pushMock, replace: mock(() => {})},
10
+ }));
11
+
12
+ interface DetailState {
13
+ /** Either the `{data}` envelope or the row Better Auth unwraps it into. */
14
+ data?: Record<string, unknown>;
15
+ error?: unknown;
16
+ isLoading: boolean;
17
+ }
18
+
19
+ const detailState: DetailState = {isLoading: false};
20
+ let retryImpl = mock(async () => ({data: {_id: "new-row"}}) as unknown);
21
+
22
+ /**
23
+ * Stands in for the host RTK Query API so the real `useCommsDashboardApi` runs.
24
+ * Mocking that module instead would leak process-wide and make the suite order-dependent.
25
+ */
26
+ const createCommsApi = (): AdminApi => {
27
+ const commsHooks: Record<string, unknown> = {
28
+ useCommsDashboardDetailQuery: () => detailState,
29
+ useCommsDashboardRetryMutation: () => [() => ({unwrap: retryImpl}), {isLoading: false}],
30
+ };
31
+ // The detail screen also mounts AdminRefField, which injects its own endpoints; answer any
32
+ // other hook name with an idle query so the picker renders without a second module mock.
33
+ const hooks = new Proxy(commsHooks, {
34
+ get: (target, key: string) =>
35
+ target[key] ?? (() => ({data: undefined, isLoading: false, isSuccess: true})),
36
+ });
37
+ const api = {
38
+ enhanceEndpoints: () => api,
39
+ injectEndpoints: () => hooks,
40
+ };
41
+ return api as unknown as AdminApi;
42
+ };
43
+
44
+ import {CommsMessageDetail} from "./CommsMessageDetail";
45
+ import {formatCommsTimestamp} from "./commsMessagePayload";
46
+
47
+ describe("CommsMessageDetail", () => {
48
+ beforeEach(() => {
49
+ detailState.data = undefined;
50
+ detailState.error = undefined;
51
+ detailState.isLoading = false;
52
+ pushMock.mockClear();
53
+ retryImpl = mock(async () => ({data: {_id: "new-row"}}) as unknown);
54
+ });
55
+
56
+ it("renders loading and error states", () => {
57
+ detailState.isLoading = true;
58
+ const loading = renderWithTheme(<CommsMessageDetail api={createCommsApi()} messageId="m1" />);
59
+ expect(loading.getByTestId("comms-detail-loading")).toBeTruthy();
60
+
61
+ detailState.isLoading = false;
62
+ detailState.error = {status: 500};
63
+ const errored = renderWithTheme(<CommsMessageDetail api={createCommsApi()} messageId="m1" />);
64
+ expect(errored.getByTestId("comms-detail-error")).toBeTruthy();
65
+ });
66
+
67
+ it("shows the specific non-retryable reason on the retry control", () => {
68
+ detailState.data = {
69
+ data: {
70
+ _id: "m1",
71
+ attempts: [
72
+ {
73
+ at: "2026-08-20T00:00:00.000Z",
74
+ error: "invalid",
75
+ errorCode: "550",
76
+ provider: "sendgrid",
77
+ providerMessageId: "sg-1",
78
+ },
79
+ ],
80
+ channel: "mail",
81
+ created: "2026-08-20T00:00:00.000Z",
82
+ metadata: {consoleUrl: "https://sendgrid.example/activity/sg-1"},
83
+ payload: {subject: "Hi"},
84
+ provider: "sendgrid",
85
+ retryable: false,
86
+ retryDisabledReason: "Permanent failures cannot be retried",
87
+ status: "failed",
88
+ to: "a***@example.com",
89
+ },
90
+ };
91
+ const {getByTestId, getByText} = renderWithTheme(
92
+ <CommsMessageDetail api={createCommsApi()} messageId="m1" />
93
+ );
94
+ expect(getByTestId("comms-detail-retry").props.accessibilityState?.disabled).toBe(true);
95
+ expect(getByTestId("comms-attempt-0")).toBeTruthy();
96
+ expect(getByTestId("comms-detail-payload")).toBeTruthy();
97
+ expect(
98
+ getByText(`Created ${formatCommsTimestamp({empty: "—", value: "2026-08-20T00:00:00.000Z"})}`)
99
+ ).toBeTruthy();
100
+ expect(
101
+ getByText(formatCommsTimestamp({empty: "—", value: "2026-08-20T00:00:00.000Z"}))
102
+ ).toBeTruthy();
103
+ });
104
+
105
+ it("renders an unwrapped Better Auth detail payload", () => {
106
+ detailState.data = {
107
+ _id: "m1",
108
+ attempts: [{at: "2026-08-20T00:00:00.000Z", provider: "sendgrid"}],
109
+ channel: "mail",
110
+ provider: "sendgrid",
111
+ retryable: true,
112
+ status: "failed",
113
+ to: "a***@example.com",
114
+ };
115
+ const {getByTestId} = renderWithTheme(
116
+ <CommsMessageDetail api={createCommsApi()} messageId="m1" />
117
+ );
118
+ expect(getByTestId("comms-detail-retry")).toBeTruthy();
119
+ expect(getByTestId("comms-attempt-0")).toBeTruthy();
120
+ });
121
+
122
+ it("reports a missing message rather than an empty shell", () => {
123
+ detailState.data = undefined;
124
+ const {getByTestId} = renderWithTheme(
125
+ <CommsMessageDetail api={createCommsApi()} messageId="m1" />
126
+ );
127
+ expect(getByTestId("comms-detail-empty")).toBeTruthy();
128
+ });
129
+
130
+ it("links the retry chain, the user, and the provider console", async () => {
131
+ detailState.data = {
132
+ _id: "m2",
133
+ attempts: [
134
+ {
135
+ at: "not-a-timestamp",
136
+ provider: "sendgrid",
137
+ providerMessageId: "sg-9",
138
+ },
139
+ {provider: "sendgrid"},
140
+ ],
141
+ channel: "mail",
142
+ metadata: {consoleUrl: "https://sendgrid.example/activity/sg-9"},
143
+ provider: "sendgrid",
144
+ retriedById: "m3",
145
+ retriedFromId: "m0",
146
+ retryable: false,
147
+ status: "bounced",
148
+ to: "a***@example.com",
149
+ userId: "user-1",
150
+ };
151
+ const {getByTestId} = renderWithTheme(
152
+ <CommsMessageDetail api={createCommsApi()} messageId="m2" routeBase="/admin" />
153
+ );
154
+
155
+ // An unparseable attempt timestamp is shown verbatim instead of crashing the timeline.
156
+ expect(getByTestId("comms-attempt-0-console")).toBeTruthy();
157
+ expect(getByTestId("comms-detail-user-card")).toBeTruthy();
158
+
159
+ await act(async () => {
160
+ fireEvent.press(getByTestId("comms-detail-retried-from"));
161
+ });
162
+ expect(String(pushMock.mock.calls.at(-1)?.[0])).toBe("/admin/comms/m0");
163
+
164
+ await act(async () => {
165
+ fireEvent.press(getByTestId("comms-detail-retried-by"));
166
+ });
167
+ expect(String(pushMock.mock.calls.at(-1)?.[0])).toBe("/admin/comms/m3");
168
+ });
169
+
170
+ it("surfaces a rejected retry without navigating", async () => {
171
+ detailState.data = {
172
+ _id: "m1",
173
+ channel: "mail",
174
+ provider: "sendgrid",
175
+ retryable: true,
176
+ status: "failed",
177
+ to: "a***@example.com",
178
+ };
179
+ retryImpl = mock(async () => {
180
+ throw {status: 400, title: "Retained payload is missing or expired"};
181
+ });
182
+ const {getAllByText, getByTestId} = renderWithTheme(
183
+ <CommsMessageDetail api={createCommsApi()} messageId="m1" />
184
+ );
185
+ await act(async () => {
186
+ fireEvent.press(getByTestId("comms-detail-retry"));
187
+ });
188
+ await act(async () => {
189
+ const confirms = getAllByText("Confirm");
190
+ fireEvent.press(confirms[confirms.length - 1]);
191
+ });
192
+ expect(retryImpl).toHaveBeenCalled();
193
+ expect(pushMock).not.toHaveBeenCalled();
194
+ });
195
+
196
+ it("treats a retry response without a row as a failure", async () => {
197
+ detailState.data = {
198
+ _id: "m1",
199
+ channel: "mail",
200
+ provider: "sendgrid",
201
+ retryable: true,
202
+ status: "failed",
203
+ to: "a***@example.com",
204
+ };
205
+ retryImpl = mock(async () => ({}) as unknown);
206
+ const {getAllByText, getByTestId} = renderWithTheme(
207
+ <CommsMessageDetail api={createCommsApi()} messageId="m1" />
208
+ );
209
+ await act(async () => {
210
+ fireEvent.press(getByTestId("comms-detail-retry"));
211
+ });
212
+ await act(async () => {
213
+ const confirms = getAllByText("Confirm");
214
+ fireEvent.press(confirms[confirms.length - 1]);
215
+ });
216
+ expect(pushMock).not.toHaveBeenCalled();
217
+ });
218
+
219
+ it("navigates to the new row after a confirmed retry", async () => {
220
+ detailState.data = {
221
+ data: {
222
+ _id: "m1",
223
+ channel: "mail",
224
+ provider: "sendgrid",
225
+ retryable: true,
226
+ status: "failed",
227
+ to: "a***@example.com",
228
+ },
229
+ };
230
+ const {getAllByText, getByTestId} = renderWithTheme(
231
+ <CommsMessageDetail api={createCommsApi()} messageId="m1" />
232
+ );
233
+ await act(async () => {
234
+ fireEvent.press(getByTestId("comms-detail-retry"));
235
+ });
236
+ await act(async () => {
237
+ const confirmButtons = getAllByText("Confirm");
238
+ fireEvent.press(confirmButtons[confirmButtons.length - 1]);
239
+ });
240
+ expect(retryImpl).toHaveBeenCalled();
241
+ expect(pushMock).toHaveBeenCalled();
242
+ const href = String((pushMock.mock.calls[0] as unknown as [string])[0]);
243
+ expect(href).toContain("/admin/comms/new-row");
244
+ });
245
+ });
@@ -0,0 +1,239 @@
1
+ import {
2
+ Accordion,
3
+ Box,
4
+ Button,
5
+ Card,
6
+ Heading,
7
+ Link,
8
+ MarkdownView,
9
+ Spinner,
10
+ Text,
11
+ useToast,
12
+ } from "@terreno/ui";
13
+ import type {Href} from "expo-router";
14
+ import {router} from "expo-router";
15
+ import React, {useCallback, useMemo} from "react";
16
+ import {AdminRefField} from "../AdminRefField";
17
+ import {AdminScreenPage} from "../AdminScreenPage";
18
+ import type {AdminApi} from "../types";
19
+ import {CommsStatusBadge} from "./CommsStatusBadge";
20
+ import {
21
+ type CommsMessageRow,
22
+ commsMessageId,
23
+ formatCommsTimestamp,
24
+ unwrapCommsMessage,
25
+ } from "./commsMessagePayload";
26
+ import {useCommsDashboardApi} from "./useCommsDashboardApi";
27
+
28
+ export interface CommsMessageDetailProps {
29
+ api: AdminApi;
30
+ messageId: string;
31
+ routeBase?: string;
32
+ }
33
+
34
+ const toJsonMarkdown = (value: unknown): string => {
35
+ return `\`\`\`json\n${JSON.stringify(value ?? null, null, 2)}\n\`\`\``;
36
+ };
37
+
38
+ const consoleUrlFromMetadata = (
39
+ metadata: Record<string, unknown> | undefined
40
+ ): string | undefined => {
41
+ const url = metadata?.consoleUrl;
42
+ return typeof url === "string" && url.length > 0 ? url : undefined;
43
+ };
44
+
45
+ export const CommsMessageDetail: React.FC<CommsMessageDetailProps> = ({
46
+ api,
47
+ messageId,
48
+ routeBase = "/admin",
49
+ }) => {
50
+ const toast = useToast();
51
+ const {useDetailQuery, useRetryMutation} = useCommsDashboardApi(api);
52
+ const {data, error, isLoading} = useDetailQuery(messageId);
53
+ const [retryMessage, retryState] = useRetryMutation();
54
+ const message = unwrapCommsMessage(data);
55
+
56
+ const openMessage = useCallback(
57
+ (id: string): void => {
58
+ router.push(`${routeBase}/comms/${id}` as Href);
59
+ },
60
+ [routeBase]
61
+ );
62
+
63
+ const handleRetry = useCallback(async (): Promise<void> => {
64
+ try {
65
+ const result = await retryMessage(messageId).unwrap();
66
+ const created = unwrapCommsMessage(result);
67
+ if (!created) {
68
+ throw new Error("Retry did not return a message");
69
+ }
70
+ openMessage(commsMessageId(created));
71
+ } catch (retryError: unknown) {
72
+ toast.catch(retryError, "Retry failed");
73
+ }
74
+ }, [messageId, openMessage, retryMessage, toast]);
75
+
76
+ const noopChange = useCallback((_value: string): void => undefined, []);
77
+
78
+ const consoleUrl = useMemo(() => consoleUrlFromMetadata(message?.metadata), [message?.metadata]);
79
+
80
+ return (
81
+ <AdminScreenPage
82
+ backHref={`${routeBase}/comms`}
83
+ color="transparent"
84
+ maxWidth="100%"
85
+ padding={0}
86
+ scroll
87
+ title="Comms message"
88
+ >
89
+ <Box gap={4} padding={4} testID="comms-message-detail">
90
+ {isLoading ? (
91
+ <Box alignItems="center" padding={6} testID="comms-detail-loading">
92
+ <Spinner />
93
+ </Box>
94
+ ) : null}
95
+ {error ? (
96
+ <Text color="error" testID="comms-detail-error">
97
+ Failed to load delivery log.
98
+ </Text>
99
+ ) : null}
100
+ {!isLoading && !error && !message ? (
101
+ <Text testID="comms-detail-empty">Message not found.</Text>
102
+ ) : null}
103
+ {message ? (
104
+ <MessageBody
105
+ api={api}
106
+ consoleUrl={consoleUrl}
107
+ handleRetry={handleRetry}
108
+ message={message}
109
+ noopChange={noopChange}
110
+ openMessage={openMessage}
111
+ retryLoading={retryState.isLoading}
112
+ routeBase={routeBase}
113
+ />
114
+ ) : null}
115
+ </Box>
116
+ </AdminScreenPage>
117
+ );
118
+ };
119
+
120
+ interface MessageBodyProps {
121
+ api: AdminApi;
122
+ consoleUrl?: string;
123
+ handleRetry: () => Promise<void>;
124
+ message: CommsMessageRow;
125
+ noopChange: (value: string) => void;
126
+ openMessage: (id: string) => void;
127
+ retryLoading: boolean;
128
+ routeBase: string;
129
+ }
130
+
131
+ const MessageBody: React.FC<MessageBodyProps> = ({
132
+ api,
133
+ consoleUrl,
134
+ handleRetry,
135
+ message,
136
+ noopChange,
137
+ openMessage,
138
+ retryLoading,
139
+ routeBase,
140
+ }) => {
141
+ return (
142
+ <>
143
+ <Box direction="row" gap={3} justifyContent="between" wrap>
144
+ <Box gap={2}>
145
+ <Box alignItems="center" direction="row" gap={2}>
146
+ <Heading size="md">Delivery log</Heading>
147
+ <CommsStatusBadge status={message.status} testID="comms-detail-status" />
148
+ </Box>
149
+ <Text testID="comms-detail-channel">{`${message.channel} · ${message.provider}`}</Text>
150
+ <Text testID="comms-detail-to">{`To ${message.to}`}</Text>
151
+ <Text color="secondaryDark" size="sm">
152
+ {`Created ${formatCommsTimestamp({empty: "—", value: message.created})}`}
153
+ </Text>
154
+ </Box>
155
+ <Button
156
+ disabled={!message.retryable}
157
+ loading={retryLoading}
158
+ onClick={handleRetry}
159
+ testID="comms-detail-retry"
160
+ text="Retry"
161
+ tooltipText={message.retryable ? "Retry this message" : message.retryDisabledReason}
162
+ variant="primary"
163
+ withConfirmation={message.retryable === true}
164
+ />
165
+ </Box>
166
+ {message.userId ? (
167
+ <Card padding={3} testID="comms-detail-user-card">
168
+ <AdminRefField
169
+ api={api}
170
+ onChange={noopChange}
171
+ readOnly
172
+ refModelName="User"
173
+ routeBase={routeBase}
174
+ routePath="/users"
175
+ testID="comms-detail-user"
176
+ title="User"
177
+ value={message.userId}
178
+ />
179
+ </Card>
180
+ ) : null}
181
+ <Box direction="row" gap={3} wrap>
182
+ {message.retriedFromId ? (
183
+ <Link
184
+ onClick={() => openMessage(message.retriedFromId ?? "")}
185
+ testID="comms-detail-retried-from"
186
+ text="Original message"
187
+ />
188
+ ) : null}
189
+ {message.retriedById ? (
190
+ <Link
191
+ onClick={() => openMessage(message.retriedById ?? "")}
192
+ testID="comms-detail-retried-by"
193
+ text="Retry row"
194
+ />
195
+ ) : null}
196
+ </Box>
197
+ <Card padding={3}>
198
+ <Heading size="sm">Attempts</Heading>
199
+ {(message.attempts ?? []).length === 0 ? (
200
+ <Text color="secondaryDark">No attempts recorded.</Text>
201
+ ) : (
202
+ (message.attempts ?? []).map((attempt, index) => (
203
+ <Box
204
+ gap={1}
205
+ key={`${attempt.at ?? "attempt"}-${index}`}
206
+ padding={2}
207
+ testID={`comms-attempt-${index}`}
208
+ >
209
+ <Text bold size="sm">
210
+ {formatCommsTimestamp({empty: "—", value: attempt.at})}
211
+ </Text>
212
+ <Text size="sm">{attempt.provider ?? message.provider}</Text>
213
+ {attempt.providerMessageId && consoleUrl ? (
214
+ <Link
215
+ href={consoleUrl}
216
+ testID={`comms-attempt-${index}-console`}
217
+ text={attempt.providerMessageId}
218
+ />
219
+ ) : (
220
+ <Text size="sm">{attempt.providerMessageId ?? ""}</Text>
221
+ )}
222
+ {attempt.errorCode || attempt.error ? (
223
+ <Text color="error" size="sm">
224
+ {[attempt.errorCode, attempt.error].filter(Boolean).join(" — ")}
225
+ </Text>
226
+ ) : null}
227
+ </Box>
228
+ ))
229
+ )}
230
+ </Card>
231
+ <Accordion isCollapsed testID="comms-detail-payload" title="Retained payload">
232
+ <MarkdownView>{toJsonMarkdown(message.payload)}</MarkdownView>
233
+ </Accordion>
234
+ <Accordion isCollapsed testID="comms-detail-metadata" title="Provider metadata">
235
+ <MarkdownView>{toJsonMarkdown(message.metadata)}</MarkdownView>
236
+ </Accordion>
237
+ </>
238
+ );
239
+ };
@@ -0,0 +1,69 @@
1
+ import {describe, expect, it} from "bun:test";
2
+ import React from "react";
3
+ import {renderWithTheme} from "../../../ui/src/test-utils";
4
+ import {CommsStatCard} from "./CommsStatCard";
5
+
6
+ const findByProp = (
7
+ tree: Record<string, unknown> | null,
8
+ predicate: (node: Record<string, unknown>) => boolean
9
+ ): Record<string, unknown> | undefined => {
10
+ if (!tree) {
11
+ return undefined;
12
+ }
13
+ if (predicate(tree)) {
14
+ return tree;
15
+ }
16
+ const children = (tree.children ?? []) as Array<Record<string, unknown>>;
17
+ for (const child of children) {
18
+ const match = findByProp(child, predicate);
19
+ if (match) {
20
+ return match;
21
+ }
22
+ }
23
+ return undefined;
24
+ };
25
+
26
+ describe("CommsStatCard", () => {
27
+ it("renders a neutral metric on the base surface without an alert icon", () => {
28
+ const {getByText, queryByText} = renderWithTheme(
29
+ <CommsStatCard label="Delivered" testID="comms-stat-delivered" value="12" />
30
+ );
31
+ expect(getByText("Delivered")).toBeTruthy();
32
+ expect(getByText("12")).toBeTruthy();
33
+ expect(queryByText("2 of 4 failed")).toBeNull();
34
+ });
35
+
36
+ it("tints the alert tone instead of putting default text on a saturated fill", () => {
37
+ const neutral = renderWithTheme(
38
+ <CommsStatCard label="Failed" testID="comms-stat-failed" value="0" />
39
+ );
40
+ const alert = renderWithTheme(
41
+ <CommsStatCard
42
+ caption="100% failure rate"
43
+ label="Failed"
44
+ testID="comms-stat-failed"
45
+ tone="alert"
46
+ value="1"
47
+ />
48
+ );
49
+
50
+ const neutralCard = findByProp(
51
+ neutral.toJSON() as Record<string, unknown> | null,
52
+ (node) => (node.props as {testID?: string})?.testID === "comms-stat-failed"
53
+ );
54
+ const alertCard = findByProp(
55
+ alert.toJSON() as Record<string, unknown> | null,
56
+ (node) => (node.props as {testID?: string})?.testID === "comms-stat-failed"
57
+ );
58
+
59
+ const backgroundOf = (node?: Record<string, unknown>): string | undefined => {
60
+ const style = (node?.props as {style?: Record<string, unknown>})?.style;
61
+ return style?.backgroundColor as string | undefined;
62
+ };
63
+
64
+ // Light error tint (error000), not the saturated error200 fill the old card used.
65
+ expect(backgroundOf(alertCard)).toBe("#FDD7D7");
66
+ expect(backgroundOf(alertCard)).not.toBe(backgroundOf(neutralCard));
67
+ expect(alert.getByText("100% failure rate")).toBeTruthy();
68
+ });
69
+ });
@@ -0,0 +1,60 @@
1
+ import {Box, Card, Heading, Icon, Text} from "@terreno/ui";
2
+ import React from "react";
3
+
4
+ const CARD_MIN_WIDTH = 148;
5
+
6
+ export interface CommsStatCardProps {
7
+ /** Secondary line under the value, e.g. what the value measures. */
8
+ caption?: string;
9
+ label: string;
10
+ testID?: string;
11
+ /** `alert` tints the card and its text for a failing metric. */
12
+ tone?: "alert" | "neutral";
13
+ value: string;
14
+ }
15
+
16
+ /**
17
+ * One metric tile in the comms dashboard summary row.
18
+ *
19
+ * The alert tone uses the light error surface with error-colored text so a failing
20
+ * metric stays legible; a saturated fill would leave dark body text unreadable.
21
+ */
22
+ export const CommsStatCard: React.FC<CommsStatCardProps> = ({
23
+ caption,
24
+ label,
25
+ testID,
26
+ tone = "neutral",
27
+ value,
28
+ }) => {
29
+ const isAlert = tone === "alert";
30
+ return (
31
+ <Card
32
+ border={isAlert ? "error" : "default"}
33
+ color={isAlert ? "errorLight" : "base"}
34
+ flex="grow"
35
+ minHeight={104}
36
+ minWidth={CARD_MIN_WIDTH}
37
+ padding={4}
38
+ testID={testID}
39
+ >
40
+ <Box gap={1}>
41
+ <Box alignItems="center" direction="row" gap={1}>
42
+ {isAlert ? (
43
+ <Icon color="error" iconName="triangle-exclamation" size="sm" type="solid" />
44
+ ) : null}
45
+ <Text color={isAlert ? "error" : "secondaryDark"} size="sm" truncate>
46
+ {label}
47
+ </Text>
48
+ </Box>
49
+ <Heading color={isAlert ? "error" : "primary"} size="lg">
50
+ {value}
51
+ </Heading>
52
+ {caption ? (
53
+ <Text color={isAlert ? "error" : "secondaryLight"} size="sm">
54
+ {caption}
55
+ </Text>
56
+ ) : null}
57
+ </Box>
58
+ </Card>
59
+ );
60
+ };
@@ -0,0 +1,14 @@
1
+ import {Badge} from "@terreno/ui";
2
+ import React from "react";
3
+
4
+ const STATUS_BADGE: Record<string, "error" | "info" | "neutral" | "success" | "warning"> = {
5
+ bounced: "warning",
6
+ cancelled: "neutral",
7
+ delivered: "success",
8
+ failed: "error",
9
+ sent: "info",
10
+ };
11
+
12
+ export const CommsStatusBadge: React.FC<{status: string; testID?: string}> = ({status, testID}) => {
13
+ return <Badge status={STATUS_BADGE[status] ?? "neutral"} testID={testID} value={status} />;
14
+ };