@terreno/admin-frontend 0.20.2 → 0.22.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 (117) hide show
  1. package/.ai/guidelines/core.md +10 -0
  2. package/dist/AdminBreadcrumbs.d.ts +13 -0
  3. package/dist/AdminBreadcrumbs.js +22 -0
  4. package/dist/AdminBreadcrumbs.js.map +1 -0
  5. package/dist/AdminFieldRenderer.js +3 -3
  6. package/dist/AdminFieldRenderer.js.map +1 -1
  7. package/dist/AdminFieldRendererCore.d.ts +2 -0
  8. package/dist/AdminFieldRendererCore.js +28 -18
  9. package/dist/AdminFieldRendererCore.js.map +1 -1
  10. package/dist/AdminHome.d.ts +22 -0
  11. package/dist/AdminHome.js +189 -0
  12. package/dist/AdminHome.js.map +1 -0
  13. package/dist/AdminModelForm.d.ts +24 -1
  14. package/dist/AdminModelForm.js +185 -14
  15. package/dist/AdminModelForm.js.map +1 -1
  16. package/dist/AdminModelList.d.ts +4 -0
  17. package/dist/AdminModelList.js +19 -4
  18. package/dist/AdminModelList.js.map +1 -1
  19. package/dist/AdminModelTable.d.ts +2 -27
  20. package/dist/AdminModelTable.js +316 -60
  21. package/dist/AdminModelTable.js.map +1 -1
  22. package/dist/AdminNestedArrayField.d.ts +1 -0
  23. package/dist/AdminNestedArrayField.js +26 -6
  24. package/dist/AdminNestedArrayField.js.map +1 -1
  25. package/dist/AdminObjectPicker.d.ts +1 -0
  26. package/dist/AdminObjectPicker.js +6 -2
  27. package/dist/AdminObjectPicker.js.map +1 -1
  28. package/dist/AdminPrimitiveArrayField.d.ts +1 -0
  29. package/dist/AdminPrimitiveArrayField.js +9 -8
  30. package/dist/AdminPrimitiveArrayField.js.map +1 -1
  31. package/dist/AdminRefField.js +2 -2
  32. package/dist/AdminRefField.js.map +1 -1
  33. package/dist/AdminScriptList.js +114 -7
  34. package/dist/AdminScriptList.js.map +1 -1
  35. package/dist/AdminScriptRunModal.d.ts +5 -0
  36. package/dist/AdminScriptRunModal.js +136 -30
  37. package/dist/AdminScriptRunModal.js.map +1 -1
  38. package/dist/AdminShell.d.ts +39 -0
  39. package/dist/AdminShell.js +80 -0
  40. package/dist/AdminShell.js.map +1 -0
  41. package/dist/AdminShellLayout.d.ts +23 -0
  42. package/dist/AdminShellLayout.js +32 -0
  43. package/dist/AdminShellLayout.js.map +1 -0
  44. package/dist/AdminVersionConfig.d.ts +5 -0
  45. package/dist/AdminVersionConfig.js +15 -5
  46. package/dist/AdminVersionConfig.js.map +1 -1
  47. package/dist/ConfigurationScreen.js +3 -3
  48. package/dist/ConfigurationScreen.js.map +1 -1
  49. package/dist/ConsentFormEditor.js +2 -2
  50. package/dist/ConsentFormEditor.js.map +1 -1
  51. package/dist/ConsentFormList.js +1 -1
  52. package/dist/ConsentFormList.js.map +1 -1
  53. package/dist/ConsentResponseViewer.js +3 -3
  54. package/dist/ConsentResponseViewer.js.map +1 -1
  55. package/dist/DocumentStorageBrowser.js +1 -1
  56. package/dist/DocumentStorageBrowser.js.map +1 -1
  57. package/dist/adminModelListQueryParams.d.ts +14 -0
  58. package/dist/adminModelListQueryParams.js +51 -0
  59. package/dist/adminModelListQueryParams.js.map +1 -0
  60. package/dist/adminShellNav.d.ts +10 -0
  61. package/dist/adminShellNav.js +29 -0
  62. package/dist/adminShellNav.js.map +1 -0
  63. package/dist/index.d.ts +6 -1
  64. package/dist/index.js +5 -0
  65. package/dist/index.js.map +1 -1
  66. package/dist/scriptRunUtils.d.ts +36 -0
  67. package/dist/scriptRunUtils.js +121 -0
  68. package/dist/scriptRunUtils.js.map +1 -0
  69. package/dist/types.d.ts +70 -0
  70. package/dist/types.js.map +1 -1
  71. package/dist/useAdminApi.d.ts +1 -0
  72. package/dist/useAdminApi.js +11 -0
  73. package/dist/useAdminApi.js.map +1 -1
  74. package/dist/useAdminBackgroundTask.d.ts +12 -0
  75. package/dist/useAdminBackgroundTask.js +26 -0
  76. package/dist/useAdminBackgroundTask.js.map +1 -0
  77. package/dist/useAdminScripts.d.ts +19 -1
  78. package/dist/useAdminScripts.js +33 -4
  79. package/dist/useAdminScripts.js.map +1 -1
  80. package/package.json +4 -3
  81. package/src/AdminBreadcrumbs.test.tsx +27 -0
  82. package/src/AdminBreadcrumbs.tsx +63 -0
  83. package/src/AdminFieldRenderer.tsx +3 -0
  84. package/src/AdminFieldRendererCore.tsx +59 -1
  85. package/src/AdminHome.test.tsx +208 -0
  86. package/src/AdminHome.tsx +474 -0
  87. package/src/AdminModelForm.test.tsx +81 -1
  88. package/src/AdminModelForm.tsx +282 -34
  89. package/src/AdminModelList.test.tsx +1 -1
  90. package/src/AdminModelList.tsx +72 -39
  91. package/src/AdminModelTable.test.tsx +11 -0
  92. package/src/AdminModelTable.tsx +530 -92
  93. package/src/AdminNestedArrayField.tsx +59 -9
  94. package/src/AdminObjectPicker.tsx +19 -1
  95. package/src/AdminPrimitiveArrayField.tsx +30 -15
  96. package/src/AdminRefField.tsx +2 -0
  97. package/src/AdminScriptList.tsx +307 -30
  98. package/src/AdminScriptRunModal.tsx +410 -95
  99. package/src/AdminShell.tsx +296 -0
  100. package/src/AdminShellLayout.tsx +34 -0
  101. package/src/AdminVersionConfig.tsx +120 -76
  102. package/src/ConfigurationScreen.tsx +4 -2
  103. package/src/ConsentFormEditor.tsx +3 -1
  104. package/src/ConsentFormList.tsx +1 -1
  105. package/src/ConsentResponseViewer.tsx +3 -3
  106. package/src/DocumentStorageBrowser.tsx +1 -1
  107. package/src/adminModelListQueryParams.ts +61 -0
  108. package/src/adminShellNav.test.ts +29 -0
  109. package/src/adminShellNav.ts +33 -0
  110. package/src/index.tsx +6 -1
  111. package/src/isolated/AdminScriptRunModal.isolated.tsx +152 -1
  112. package/src/scriptRunUtils.test.ts +146 -0
  113. package/src/scriptRunUtils.ts +149 -0
  114. package/src/types.ts +69 -0
  115. package/src/useAdminApi.ts +11 -0
  116. package/src/useAdminBackgroundTask.ts +40 -0
  117. package/src/useAdminScripts.ts +56 -5
@@ -1,22 +1,34 @@
1
1
  import {
2
2
  Box,
3
3
  Button,
4
+ Card,
4
5
  type ColumnSortInterface,
5
6
  DataTable,
6
7
  type DataTableCellData,
7
8
  type DataTableColumn,
8
9
  type DataTableCustomComponentMap,
10
+ Heading,
9
11
  IconButton,
10
12
  Link,
13
+ Modal,
11
14
  Page,
12
15
  printDateAndTime,
16
+ SelectField,
13
17
  Spinner,
14
18
  Text,
19
+ TextField,
20
+ useToast,
15
21
  } from "@terreno/ui";
16
22
  import type {Href} from "expo-router";
17
23
  import {router, useNavigation} from "expo-router";
18
24
  import startCase from "lodash/startCase";
19
25
  import React, {useCallback, useEffect, useMemo, useState} from "react";
26
+ import {Pressable} from "react-native";
27
+ import {
28
+ ADMIN_LIST_MAX_SELECTION,
29
+ type AdminListFilterState,
30
+ buildAdminListQueryParams,
31
+ } from "./adminModelListQueryParams";
20
32
  import {
21
33
  type AdminApi,
22
34
  type AdminFieldConfig,
@@ -25,6 +37,7 @@ import {
25
37
  resolveAdminBases,
26
38
  } from "./types";
27
39
  import {useAdminApi} from "./useAdminApi";
40
+ import {useAdminBackgroundTaskMutation} from "./useAdminBackgroundTask";
28
41
  import {useAdminConfig} from "./useAdminConfig";
29
42
 
30
43
  interface AdminModelTableProps {
@@ -48,7 +61,8 @@ interface AdminModelTableProps {
48
61
 
49
62
  const ACTIONS_COLUMN_TYPE = "adminActions";
50
63
  const LINK_COLUMN_TYPE = "adminLink";
51
- const DEFAULT_LIMIT = 20;
64
+ const SELECT_COLUMN_TYPE = "adminSelect";
65
+ const INLINE_BOOL_COLUMN_TYPE = "adminInlineBool";
52
66
  const DATE_FIELD_NAMES = new Set(["created", "updated", "deleted"]);
53
67
 
54
68
  const getColumnType = (fieldKey: string, fieldConfig?: AdminFieldConfig): string => {
@@ -71,15 +85,18 @@ const getColumnType = (fieldKey: string, fieldConfig?: AdminFieldConfig): string
71
85
 
72
86
  const getColumnWidth = (fieldKey: string, columnType: string): number => {
73
87
  if (columnType === "boolean") {
74
- return 100;
88
+ return 130;
75
89
  }
76
90
  if (columnType === "number") {
77
- return 120;
91
+ return 130;
78
92
  }
79
93
  if (columnType === "date") {
80
- return 180;
94
+ return 210;
81
95
  }
82
96
  if (fieldKey === "_id") {
97
+ return 260;
98
+ }
99
+ if (fieldKey.toLowerCase().endsWith("id")) {
83
100
  return 240;
84
101
  }
85
102
  return 200;
@@ -106,12 +123,12 @@ const formatCellValue = (value: AdminFieldValue, columnType: string): string =>
106
123
 
107
124
  const buildSortString = (
108
125
  sort: ColumnSortInterface | undefined,
109
- listFields: string[]
126
+ displayFields: string[]
110
127
  ): string | undefined => {
111
128
  if (!sort) {
112
129
  return undefined;
113
130
  }
114
- const fieldKey = listFields[sort.column];
131
+ const fieldKey = displayFields[sort.column];
115
132
  if (!fieldKey) {
116
133
  return undefined;
117
134
  }
@@ -128,11 +145,12 @@ const AdminLinkCell: React.FC<{column: DataTableColumn; cellData: DataTableCellD
128
145
  const AdminActionsCell: React.FC<{column: DataTableColumn; cellData: DataTableCellData}> = ({
129
146
  cellData,
130
147
  }) => {
131
- const {id, baseUrl, modelName, onDelete} = cellData.value as {
148
+ const {id, baseUrl, modelName, onDelete, deleteEnabled} = cellData.value as {
132
149
  id: string;
133
150
  baseUrl: string;
134
151
  modelName: string;
135
152
  onDelete: (id: string) => void;
153
+ deleteEnabled: boolean;
136
154
  };
137
155
  const href = `${baseUrl}/${modelName}/${id}`;
138
156
  return (
@@ -151,19 +169,66 @@ const AdminActionsCell: React.FC<{column: DataTableColumn; cellData: DataTableCe
151
169
  tooltipText="Edit"
152
170
  variant="muted"
153
171
  />
154
- <IconButton
155
- accessibilityLabel="Delete"
156
- confirmationText="Are you sure you want to delete this item?"
157
- iconName="trash"
158
- onClick={() => onDelete(id)}
159
- tooltipText="Delete"
160
- variant="destructive"
161
- withConfirmation
162
- />
172
+ {deleteEnabled ? (
173
+ <IconButton
174
+ accessibilityLabel="Delete"
175
+ confirmationText="Are you sure you want to delete this item?"
176
+ iconName="trash"
177
+ onClick={() => onDelete(id)}
178
+ tooltipText="Delete"
179
+ variant="destructive"
180
+ withConfirmation
181
+ />
182
+ ) : null}
163
183
  </Box>
164
184
  );
165
185
  };
166
186
 
187
+ const AdminSelectCell: React.FC<{column: DataTableColumn; cellData: DataTableCellData}> = ({
188
+ cellData,
189
+ }) => {
190
+ const {id, selected, onToggle} = cellData.value as {
191
+ id: string;
192
+ onToggle: (id: string, next: boolean) => void;
193
+ selected: boolean;
194
+ };
195
+ return (
196
+ <Pressable
197
+ accessibilityRole="checkbox"
198
+ accessibilityState={{checked: selected}}
199
+ onPress={() => onToggle(id, !selected)}
200
+ >
201
+ <Box alignItems="center" justifyContent="center" padding={1}>
202
+ <Text size="lg">{selected ? "\u2611" : "\u2610"}</Text>
203
+ </Box>
204
+ </Pressable>
205
+ );
206
+ };
207
+
208
+ const AdminInlineBoolCell: React.FC<{column: DataTableColumn; cellData: DataTableCellData}> = ({
209
+ cellData,
210
+ }) => {
211
+ const {value, disabled, onToggle} = cellData.value as {
212
+ disabled: boolean;
213
+ onToggle: () => void;
214
+ value: boolean;
215
+ };
216
+ return (
217
+ <Pressable
218
+ accessibilityRole="switch"
219
+ accessibilityState={{checked: Boolean(value), disabled}}
220
+ disabled={disabled}
221
+ onPress={() => !disabled && onToggle()}
222
+ >
223
+ <Box alignItems="center" justifyContent="center" padding={1}>
224
+ <Text color={value ? "success" : "secondaryDark"} size="lg">
225
+ {value ? "\u2713" : "\u2014"}
226
+ </Text>
227
+ </Box>
228
+ </Pressable>
229
+ );
230
+ };
231
+
167
232
  const LoadingContent: React.FC = () => (
168
233
  <Box alignItems="center" justifyContent="center" padding={6}>
169
234
  <Spinner />
@@ -177,33 +242,8 @@ const EmptyContent: React.FC = () => (
177
242
  );
178
243
 
179
244
  /**
180
- * Table view for a specific admin model with pagination, sorting, and CRUD actions.
181
- *
182
- * Displays model data in a DataTable with columns from the model's `listFields` configuration.
183
- * Provides actions for creating new items, editing existing items, and deleting items.
184
- * Supports pagination, sorting, and reference field rendering as clickable links.
185
- *
186
- * @param props - Component props
187
- * @param props.baseUrl - Base URL for admin routes (e.g., "/admin")
188
- * @param props.api - RTK Query API instance for making authenticated requests
189
- * @param props.modelName - Name of the model to display (e.g., "User")
190
- * @param props.columns - Optional array of field names to display. Defaults to model's listFields.
191
- *
192
- * @example
193
- * ```typescript
194
- * import {AdminModelTable} from "@terreno/admin-frontend";
195
- * import {api} from "@/store/openApiSdk";
196
- * import {useLocalSearchParams} from "expo-router";
197
- *
198
- * function AdminModelScreen() {
199
- * const {modelName} = useLocalSearchParams();
200
- * return <AdminModelTable baseUrl="/admin" api={api} modelName={modelName as string} />;
201
- * }
202
- * ```
203
- *
204
- * @see AdminModelForm for the create/edit form
205
- * @see AdminModelList for the model list screen
206
- * @see useAdminApi for the CRUD API hooks
245
+ * Table view for a specific admin model with pagination, sorting, filters, search,
246
+ * optional bulk actions, and CRUD row actions.
207
247
  */
208
248
  export const AdminModelTable: React.FC<AdminModelTableProps> = ({
209
249
  baseUrl,
@@ -220,8 +260,14 @@ export const AdminModelTable: React.FC<AdminModelTableProps> = ({
220
260
  routeBase,
221
261
  });
222
262
  const {config, isLoading: isConfigLoading} = useAdminConfig(api, resolvedApiBase);
263
+ const toast = useToast();
223
264
  const [page, setPage] = useState(1);
224
265
  const [sortColumn, setSortColumn] = useState<ColumnSortInterface | undefined>();
266
+ const [searchText, setSearchText] = useState("");
267
+ const [debouncedSearch, setDebouncedSearch] = useState("");
268
+ const [filterState, setFilterState] = useState<AdminListFilterState>({});
269
+ const [selectedIds, setSelectedIds] = useState<Set<string>>(new Set());
270
+ const [confirmActionId, setConfirmActionId] = useState<string | null>(null);
225
271
  const navigation = useNavigation();
226
272
 
227
273
  const modelConfig: AdminModelConfig | undefined = useMemo(
@@ -229,45 +275,96 @@ export const AdminModelTable: React.FC<AdminModelTableProps> = ({
229
275
  [config, modelName]
230
276
  );
231
277
 
278
+ // Debounce search text for list queries.
279
+ useEffect(() => {
280
+ const t = setTimeout(() => {
281
+ setDebouncedSearch(searchText);
282
+ }, 300);
283
+ return () => {
284
+ clearTimeout(t);
285
+ };
286
+ }, [searchText]);
287
+
288
+ // Reset filter UI when switching models.
232
289
  useEffect(() => {
233
290
  if (!modelConfig) {
234
291
  return;
235
292
  }
236
- navigation.setOptions({
237
- headerRight: () => (
238
- <Box alignItems="center" justifyContent="center" marginRight={3}>
239
- <Button
240
- onClick={() => router.push(`${resolvedRouteBase}/${modelName}/create` as Href)}
241
- testID="admin-create-button"
242
- text="Create"
243
- variant="primary"
244
- />
245
- </Box>
246
- ),
247
- title: modelConfig.displayName,
248
- });
249
- }, [navigation, modelConfig, resolvedRouteBase, modelName]);
293
+ const next: AdminListFilterState = {};
294
+ for (const f of modelConfig.filters ?? []) {
295
+ if (f.kind === "boolean") {
296
+ next[f.field] = undefined;
297
+ } else if (f.kind === "dateRange") {
298
+ next[`${f.field}_gte`] = "";
299
+ next[`${f.field}_lte`] = "";
300
+ } else {
301
+ next[f.field] = "";
302
+ }
303
+ }
304
+ setFilterState(next);
305
+ setSelectedIds(new Set());
306
+ setPage(1);
307
+ setSearchText("");
308
+ setDebouncedSearch("");
309
+ }, [modelConfig]);
250
310
 
251
311
  const displayFields = useMemo(
252
- () => columnsProp ?? modelConfig?.listFields ?? [],
312
+ () => columnsProp ?? modelConfig?.listDisplay ?? modelConfig?.listFields ?? [],
253
313
  [columnsProp, modelConfig]
254
314
  );
255
315
 
316
+ const linkFieldSet = useMemo(() => {
317
+ const links = modelConfig?.listDisplayLinks;
318
+ if (links && links.length > 0) {
319
+ return new Set(links);
320
+ }
321
+ const first = displayFields[0];
322
+ return new Set(first ? [first] : []);
323
+ }, [displayFields, modelConfig?.listDisplayLinks]);
324
+
325
+ const sortableFieldSet = useMemo(() => {
326
+ const sf = modelConfig?.sortableFields;
327
+ if (!sf || sf.length === 0) {
328
+ return undefined;
329
+ }
330
+ return new Set(sf);
331
+ }, [modelConfig?.sortableFields]);
332
+
333
+ const pageLimit = modelConfig?.pageSize ?? 20;
334
+
256
335
  const sortString = useMemo(
257
336
  () => buildSortString(sortColumn, displayFields) ?? modelConfig?.defaultSort,
258
337
  [sortColumn, displayFields, modelConfig]
259
338
  );
260
339
 
261
- const {useListQuery, useDeleteMutation} = useAdminApi(
340
+ const listParams = useMemo(() => {
341
+ if (!modelConfig) {
342
+ return undefined;
343
+ }
344
+ return buildAdminListQueryParams({
345
+ filterState,
346
+ limit: pageLimit,
347
+ modelConfig,
348
+ page,
349
+ searchDebounced: debouncedSearch,
350
+ sort: sortString,
351
+ });
352
+ }, [debouncedSearch, filterState, modelConfig, page, pageLimit, sortString]);
353
+
354
+ const {useListQuery, useDeleteMutation, useUpdateMutation, useBulkPatchMutation} = useAdminApi(
262
355
  api,
263
356
  modelConfig?.routePath ?? "",
264
357
  modelName
265
358
  );
266
- const {data: listData, isLoading: isListLoading} = useListQuery(
267
- {limit: DEFAULT_LIMIT, page, sort: sortString},
268
- {skip: !modelConfig}
269
- );
359
+ const {data: listData, isLoading: isListLoading} = useListQuery(listParams, {skip: !modelConfig});
270
360
  const [deleteItem] = useDeleteMutation();
361
+ const [patchItem] = useUpdateMutation();
362
+ const [bulkPatch] = useBulkPatchMutation();
363
+ const [enqueueBackground] = useAdminBackgroundTaskMutation(api, resolvedApiBase);
364
+
365
+ const deleteEnabled = modelConfig?.permissions?.delete !== false;
366
+ const createEnabled = modelConfig?.permissions?.create !== false;
367
+ const showSelectColumn = Boolean(modelConfig?.actions?.length);
271
368
 
272
369
  const handleDelete = useCallback(
273
370
  async (id: string) => {
@@ -280,54 +377,206 @@ export const AdminModelTable: React.FC<AdminModelTableProps> = ({
280
377
  [deleteItem]
281
378
  );
282
379
 
380
+ const toggleSelected = useCallback(
381
+ (id: string, next: boolean) => {
382
+ setSelectedIds((prev) => {
383
+ const n = new Set(prev);
384
+ if (next) {
385
+ if (n.size >= ADMIN_LIST_MAX_SELECTION) {
386
+ toast.warn(`You can select at most ${ADMIN_LIST_MAX_SELECTION} rows.`);
387
+ return prev;
388
+ }
389
+ n.add(id);
390
+ } else {
391
+ n.delete(id);
392
+ }
393
+ return n;
394
+ });
395
+ },
396
+ [toast]
397
+ );
398
+
399
+ const toggleSelectPage = useCallback(() => {
400
+ const ids = (listData?.data ?? []).map((row: {_id?: string}) => String(row._id));
401
+ const allSelected = ids.length > 0 && ids.every((id: string) => selectedIds.has(id));
402
+ if (allSelected) {
403
+ setSelectedIds((prev) => {
404
+ const n = new Set(prev);
405
+ for (const id of ids) {
406
+ n.delete(id);
407
+ }
408
+ return n;
409
+ });
410
+ return;
411
+ }
412
+ setSelectedIds((prev) => {
413
+ const n = new Set(prev);
414
+ for (const id of ids) {
415
+ if (n.size >= ADMIN_LIST_MAX_SELECTION) {
416
+ break;
417
+ }
418
+ n.add(id);
419
+ }
420
+ if (ids.length > ADMIN_LIST_MAX_SELECTION) {
421
+ toast.warn(`Only the first ${ADMIN_LIST_MAX_SELECTION} rows on this page can be selected.`);
422
+ }
423
+ return n;
424
+ });
425
+ }, [listData?.data, selectedIds, toast]);
426
+
427
+ const runBulkAction = useCallback(
428
+ async (actionId: string) => {
429
+ if (!modelConfig) {
430
+ return;
431
+ }
432
+ const action = modelConfig.actions?.find((a) => a.id === actionId);
433
+ if (!action) {
434
+ return;
435
+ }
436
+ const ids = [...selectedIds];
437
+ if (ids.length === 0) {
438
+ return;
439
+ }
440
+ try {
441
+ if (action.background) {
442
+ await enqueueBackground({
443
+ ids,
444
+ kind: action.id,
445
+ metadata: {actionId: action.id},
446
+ resourceRoute: modelConfig.routePath,
447
+ }).unwrap();
448
+ toast.success("Background task queued");
449
+ } else if (action.patchKeys && action.patchKeys.length > 0) {
450
+ const patch: Record<string, unknown> = {};
451
+ for (const k of action.patchKeys) {
452
+ patch[k] = true;
453
+ }
454
+ await bulkPatch({ids, patch}).unwrap();
455
+ toast.success("Bulk update applied");
456
+ } else {
457
+ toast.warn("This action has no bulk handler configured.");
458
+ }
459
+ setSelectedIds(new Set());
460
+ setConfirmActionId(null);
461
+ } catch (err) {
462
+ toast.catch(err, "Bulk action failed");
463
+ }
464
+ },
465
+ [bulkPatch, enqueueBackground, modelConfig, selectedIds, toast]
466
+ );
467
+
468
+ const handleInlineBooleanToggle = useCallback(
469
+ async (rowId: string, fieldKey: string, next: boolean) => {
470
+ try {
471
+ await patchItem({body: {[fieldKey]: next}, id: rowId}).unwrap();
472
+ } catch (err) {
473
+ toast.catch(err, "Update failed");
474
+ }
475
+ },
476
+ [patchItem, toast]
477
+ );
478
+
479
+ useEffect(() => {
480
+ if (!modelConfig) {
481
+ return;
482
+ }
483
+ navigation.setOptions({
484
+ headerRight: () => (
485
+ <Box alignItems="center" justifyContent="center" marginRight={3}>
486
+ {createEnabled ? (
487
+ <Button
488
+ onClick={() => router.push(`${resolvedRouteBase}/${modelName}/create` as Href)}
489
+ testID="admin-create-button"
490
+ text="Create"
491
+ variant="primary"
492
+ />
493
+ ) : null}
494
+ </Box>
495
+ ),
496
+ title: modelConfig.displayName,
497
+ });
498
+ }, [createEnabled, navigation, modelConfig, resolvedRouteBase, modelName]);
499
+
283
500
  const customColumnComponentMap: DataTableCustomComponentMap = useMemo(
284
501
  () => ({
285
502
  [ACTIONS_COLUMN_TYPE]: AdminActionsCell,
503
+ [INLINE_BOOL_COLUMN_TYPE]: AdminInlineBoolCell,
286
504
  [LINK_COLUMN_TYPE]: AdminLinkCell,
505
+ [SELECT_COLUMN_TYPE]: AdminSelectCell,
287
506
  }),
288
507
  []
289
508
  );
290
509
 
291
510
  if (isConfigLoading || !modelConfig) {
292
511
  return (
293
- <Page maxWidth="100%">
512
+ <Page color="transparent" maxWidth="100%" padding={0}>
294
513
  <LoadingContent />
295
514
  </Page>
296
515
  );
297
516
  }
298
517
 
299
- const dataColumns: DataTableColumn[] = displayFields.map((fieldKey, index) => {
518
+ const dataColumns: DataTableColumn[] = displayFields.map((fieldKey) => {
300
519
  const fieldConfig = modelConfig.fields[fieldKey];
301
- const isFirst = index === 0;
302
520
  const columnType = getColumnType(fieldKey, fieldConfig);
303
521
  const widthOverride = columnWidths?.[fieldKey] ?? modelConfig.listColumnWidths?.[fieldKey];
522
+ const sortable =
523
+ sortableFieldSet === undefined ? true : Boolean(sortableFieldSet.has(fieldKey));
524
+ const isLink = linkFieldSet.has(fieldKey);
525
+ const isInlineBool =
526
+ fieldConfig?.type === "boolean" && modelConfig.permissions?.update !== false;
304
527
  return {
305
- columnType: isFirst ? LINK_COLUMN_TYPE : columnType,
306
- sortable: true,
528
+ columnType: isInlineBool ? INLINE_BOOL_COLUMN_TYPE : isLink ? LINK_COLUMN_TYPE : columnType,
529
+ sortable,
307
530
  title: startCase(fieldKey),
308
531
  width: widthOverride ?? getColumnWidth(fieldKey, columnType),
309
532
  };
310
533
  });
311
534
 
535
+ const selectColumn: DataTableColumn | null = showSelectColumn
536
+ ? {
537
+ columnType: SELECT_COLUMN_TYPE,
538
+ sortable: false,
539
+ title: "",
540
+ width: 48,
541
+ }
542
+ : null;
543
+
312
544
  const columns: DataTableColumn[] = [
545
+ ...(selectColumn ? [selectColumn] : []),
313
546
  ...dataColumns,
314
547
  {
315
548
  columnType: ACTIONS_COLUMN_TYPE,
316
549
  sortable: false,
317
550
  title: "",
318
- width: 140,
551
+ width: deleteEnabled ? 140 : 100,
319
552
  },
320
553
  ];
321
554
 
322
555
  const listItems = (listData?.data ?? []) as Array<Record<string, AdminFieldValue>>;
323
556
  const data = listItems.map((item) => {
324
- const fieldCells = displayFields.map((fieldKey, index) => {
557
+ const id = String(item._id ?? "");
558
+ const selected = selectedIds.has(id);
559
+ const selectCell = selectColumn ? [{value: {id, onToggle: toggleSelected, selected}}] : [];
560
+
561
+ const fieldCells = displayFields.map((fieldKey) => {
325
562
  const fieldConfig = modelConfig.fields[fieldKey];
326
- const isFirst = index === 0;
327
563
  const columnType = getColumnType(fieldKey, fieldConfig);
328
564
  const formatted = formatCellValue(item[fieldKey], columnType);
565
+ const isLink = linkFieldSet.has(fieldKey);
566
+ const isInlineBool =
567
+ fieldConfig?.type === "boolean" && modelConfig.permissions?.update !== false;
568
+
569
+ if (isInlineBool) {
570
+ return {
571
+ value: {
572
+ disabled: modelConfig.permissions?.update === false,
573
+ onToggle: () => handleInlineBooleanToggle(id, fieldKey, !item[fieldKey]),
574
+ value: Boolean(item[fieldKey]),
575
+ },
576
+ };
577
+ }
329
578
 
330
- if (isFirst) {
579
+ if (isLink) {
331
580
  return {
332
581
  value: {
333
582
  href: `${resolvedRouteBase}/${modelName}/${item._id}`,
@@ -342,31 +591,220 @@ export const AdminModelTable: React.FC<AdminModelTableProps> = ({
342
591
  });
343
592
 
344
593
  const actionsCell = {
345
- value: {baseUrl: resolvedRouteBase, id: item._id, modelName, onDelete: handleDelete},
594
+ value: {
595
+ baseUrl: resolvedRouteBase,
596
+ deleteEnabled,
597
+ id,
598
+ modelName,
599
+ onDelete: handleDelete,
600
+ },
346
601
  };
347
- return [...fieldCells, actionsCell];
602
+ return [...selectCell, ...fieldCells, actionsCell];
348
603
  });
349
604
 
350
- const totalPages = listData ? Math.ceil(listData.total / DEFAULT_LIMIT) : 1;
605
+ const totalPages = listData ? Math.ceil((listData.total as number) / pageLimit) : 1;
606
+
607
+ const pendingAction = modelConfig.actions?.find((a) => a.id === confirmActionId);
608
+
609
+ const hasFilterRail =
610
+ Boolean(modelConfig.searchFields?.length) || Boolean((modelConfig.filters ?? []).length);
351
611
 
352
612
  return (
353
- <Page maxWidth="100%">
354
- {isListLoading ? (
355
- <LoadingContent />
356
- ) : data.length === 0 ? (
357
- <EmptyContent />
358
- ) : (
359
- <DataTable
360
- columns={columns}
361
- customColumnComponentMap={customColumnComponentMap}
362
- data={data}
363
- page={page}
364
- setPage={setPage}
365
- setSortColumn={setSortColumn}
366
- sortColumn={sortColumn}
367
- totalPages={totalPages}
368
- />
369
- )}
613
+ <Page color="transparent" maxWidth="100%" padding={0}>
614
+ <Box gap={3} padding={0} testID={`admin-list-${modelName}`}>
615
+ <Box alignItems="stretch" direction="column" gap={3} mdDirection="row">
616
+ <Box direction="column" flex="grow" gap={3} minWidth={0} width="100%">
617
+ {selectColumn ? (
618
+ <Card padding={3}>
619
+ <Box direction="column" gap={3} testID="bulk-action">
620
+ <Box alignItems="end" direction="row" gap={3} wrap>
621
+ {modelConfig.actions && modelConfig.actions.length > 0 ? (
622
+ <Box minWidth={260}>
623
+ <SelectField
624
+ onChange={(next: string) => {
625
+ if (next === "__none__" || !next) {
626
+ return;
627
+ }
628
+ const act = modelConfig.actions?.find((a) => a.id === next);
629
+ if (!act) {
630
+ return;
631
+ }
632
+ if (act.confirm) {
633
+ setConfirmActionId(act.id);
634
+ } else {
635
+ void runBulkAction(act.id);
636
+ }
637
+ }}
638
+ options={[
639
+ {label: "Bulk actions\u2026", value: "__none__"},
640
+ ...modelConfig.actions.map((a) => ({label: a.label, value: a.id})),
641
+ ]}
642
+ title="Actions"
643
+ value="__none__"
644
+ />
645
+ </Box>
646
+ ) : null}
647
+ <Text color="secondaryDark" size="sm">
648
+ {selectedIds.size} selected
649
+ </Text>
650
+ </Box>
651
+ <Button
652
+ onClick={toggleSelectPage}
653
+ text="Toggle page selection"
654
+ variant="outline"
655
+ />
656
+ </Box>
657
+ </Card>
658
+ ) : null}
659
+
660
+ <Card padding={2}>
661
+ {isListLoading ? (
662
+ <LoadingContent />
663
+ ) : data.length === 0 ? (
664
+ <EmptyContent />
665
+ ) : (
666
+ <DataTable
667
+ columns={columns}
668
+ customColumnComponentMap={customColumnComponentMap}
669
+ data={data}
670
+ page={page}
671
+ pinnedColumns={selectColumn ? 1 : 0}
672
+ setPage={setPage}
673
+ setSortColumn={setSortColumn}
674
+ sortColumn={sortColumn}
675
+ totalPages={totalPages}
676
+ />
677
+ )}
678
+ </Card>
679
+ </Box>
680
+
681
+ {hasFilterRail ? (
682
+ <Box alignSelf="stretch" maxWidth={360} minWidth={260}>
683
+ <Card padding={3}>
684
+ <Heading size="sm">Filters</Heading>
685
+ <Box direction="column" gap={3} marginTop={2} width="100%">
686
+ {modelConfig.searchFields && modelConfig.searchFields.length > 0 ? (
687
+ <Box width="100%">
688
+ <TextField
689
+ helperText={`Filter by ${modelConfig.searchFields[0]} (exact match)`}
690
+ onChange={setSearchText}
691
+ title="Search"
692
+ value={searchText}
693
+ />
694
+ </Box>
695
+ ) : null}
696
+ {(modelConfig.filters ?? []).map((f) => {
697
+ if (f.kind === "boolean") {
698
+ const v = filterState[f.field];
699
+ return (
700
+ <Box key={f.field} width="100%">
701
+ <SelectField
702
+ onChange={(next: string) => {
703
+ setFilterState((prev) => ({...prev, [f.field]: next}));
704
+ setPage(1);
705
+ }}
706
+ options={[
707
+ {label: f.label ?? startCase(f.field), value: "all"},
708
+ {label: "Yes", value: "true"},
709
+ {label: "No", value: "false"},
710
+ ]}
711
+ title={f.label ?? startCase(f.field)}
712
+ value={v === true ? "true" : v === false ? "false" : "all"}
713
+ />
714
+ </Box>
715
+ );
716
+ }
717
+ if (f.kind === "dateRange") {
718
+ const gteKey = `${f.field}_gte`;
719
+ const lteKey = `${f.field}_lte`;
720
+ return (
721
+ <Box direction="column" gap={2} key={f.field} width="100%">
722
+ <Box width="100%">
723
+ <TextField
724
+ helperText="ISO date or datetime"
725
+ onChange={(next: string) => {
726
+ setFilterState((prev) => ({...prev, [gteKey]: next}));
727
+ setPage(1);
728
+ }}
729
+ title={`${f.label ?? startCase(f.field)} from`}
730
+ value={String(filterState[gteKey] ?? "")}
731
+ />
732
+ </Box>
733
+ <Box width="100%">
734
+ <TextField
735
+ helperText="ISO date or datetime"
736
+ onChange={(next: string) => {
737
+ setFilterState((prev) => ({...prev, [lteKey]: next}));
738
+ setPage(1);
739
+ }}
740
+ title={`${f.label ?? startCase(f.field)} to`}
741
+ value={String(filterState[lteKey] ?? "")}
742
+ />
743
+ </Box>
744
+ </Box>
745
+ );
746
+ }
747
+ if (f.kind === "choice") {
748
+ return (
749
+ <Box key={f.field} width="100%">
750
+ <SelectField
751
+ onChange={(next: string) => {
752
+ setFilterState((prev) => ({
753
+ ...prev,
754
+ [f.field]: next === "__all__" ? "" : next,
755
+ }));
756
+ setPage(1);
757
+ }}
758
+ options={[
759
+ {label: "All", value: "__all__"},
760
+ ...((f.choices ?? []) as {label: string; value: string}[]).map(
761
+ (c) => ({
762
+ label: c.label,
763
+ value: c.value,
764
+ })
765
+ ),
766
+ ]}
767
+ title={f.label ?? startCase(f.field)}
768
+ value={String(filterState[f.field] ?? "__all__")}
769
+ />
770
+ </Box>
771
+ );
772
+ }
773
+ return (
774
+ <Box key={f.field} width="100%">
775
+ <TextField
776
+ onChange={(next: string) => {
777
+ setFilterState((prev) => ({...prev, [f.field]: next}));
778
+ setPage(1);
779
+ }}
780
+ title={f.label ?? startCase(f.field)}
781
+ value={String(filterState[f.field] ?? "")}
782
+ />
783
+ </Box>
784
+ );
785
+ })}
786
+ </Box>
787
+ </Card>
788
+ </Box>
789
+ ) : null}
790
+ </Box>
791
+ </Box>
792
+
793
+ <Modal
794
+ onDismiss={() => setConfirmActionId(null)}
795
+ primaryButtonOnClick={() => {
796
+ if (confirmActionId) {
797
+ void runBulkAction(confirmActionId);
798
+ }
799
+ }}
800
+ primaryButtonText="Continue"
801
+ secondaryButtonOnClick={() => setConfirmActionId(null)}
802
+ secondaryButtonText="Cancel"
803
+ title="Confirm bulk action"
804
+ visible={Boolean(pendingAction?.confirm)}
805
+ >
806
+ <Text>{pendingAction?.confirm}</Text>
807
+ </Modal>
370
808
  </Page>
371
809
  );
372
810
  };