@terreno/admin-frontend 0.20.1 → 0.21.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
@@ -0,0 +1,121 @@
1
+ import { DateTime } from "luxon";
2
+ /** Visual treatment for a task status, shared by the list, history, and modal. */
3
+ export const statusMeta = (status) => {
4
+ switch (status) {
5
+ case "completed":
6
+ return { badgeStatus: "success", iconName: "circle-check", label: "Completed" };
7
+ case "failed":
8
+ return { badgeStatus: "error", iconName: "circle-xmark", label: "Failed" };
9
+ case "cancelled":
10
+ return { badgeStatus: "warning", iconName: "circle-exclamation", label: "Cancelled" };
11
+ case "running":
12
+ return { badgeStatus: "info", iconName: "spinner", label: "Running" };
13
+ default:
14
+ return { badgeStatus: "neutral", iconName: "clock", label: "Pending" };
15
+ }
16
+ };
17
+ /** Compact relative time (e.g. "just now", "5m ago", "yesterday", "Jun 3"). */
18
+ export const relativeTime = (iso) => {
19
+ if (!iso) {
20
+ return "";
21
+ }
22
+ const then = DateTime.fromISO(iso);
23
+ if (!then.isValid) {
24
+ return "";
25
+ }
26
+ const totalSeconds = Math.max(1, Math.floor(DateTime.now().diff(then).as("seconds")));
27
+ if (totalSeconds < 90) {
28
+ return "just now";
29
+ }
30
+ const minutes = Math.floor(totalSeconds / 60);
31
+ if (minutes < 60) {
32
+ return `${minutes}m ago`;
33
+ }
34
+ const hours = Math.floor(minutes / 60);
35
+ if (hours < 24) {
36
+ return `${hours}h ago`;
37
+ }
38
+ const days = Math.floor(hours / 24);
39
+ if (days === 1) {
40
+ return "yesterday";
41
+ }
42
+ if (days < 7) {
43
+ return `${days}d ago`;
44
+ }
45
+ return then.toLocaleString({ day: "numeric", month: "short" });
46
+ };
47
+ /** Human duration between two ISO timestamps (e.g. "8s", "3m 4s"). */
48
+ export const formatDuration = (startIso, endIso) => {
49
+ if (!startIso || !endIso) {
50
+ return "";
51
+ }
52
+ const start = DateTime.fromISO(startIso);
53
+ const end = DateTime.fromISO(endIso);
54
+ if (!start.isValid || !end.isValid) {
55
+ return "";
56
+ }
57
+ const seconds = Math.max(0, Math.round(end.diff(start).as("seconds")));
58
+ if (seconds < 60) {
59
+ return `${seconds}s`;
60
+ }
61
+ const minutes = Math.floor(seconds / 60);
62
+ return `${minutes}m ${seconds % 60}s`;
63
+ };
64
+ const ERROR_PATTERN = /(error|exception|❌)|\b(fail|failed|failure|cannot|unable|invalid|denied)\b/i;
65
+ /** Heuristic: does an output line read like an error? Used to color/filter result rows. */
66
+ export const isErrorLine = (line) => ERROR_PATTERN.test(line);
67
+ /**
68
+ * Derive success/error counts for a task. The backend returns `result: string[]`
69
+ * plus structured `logs`, so error count prefers `error`-level logs and falls back
70
+ * to a per-line heuristic over the result strings.
71
+ */
72
+ export const summarizeOutput = (task) => {
73
+ var _a, _b;
74
+ const result = (_a = task === null || task === void 0 ? void 0 : task.result) !== null && _a !== void 0 ? _a : [];
75
+ const errorLogs = ((_b = task === null || task === void 0 ? void 0 : task.logs) !== null && _b !== void 0 ? _b : []).filter((log) => log.level === "error").length;
76
+ const heuristicErrors = result.filter(isErrorLine).length;
77
+ const errorCount = Math.max(errorLogs, heuristicErrors);
78
+ const total = result.length;
79
+ return {
80
+ errorCount: Math.min(errorCount, total || errorCount),
81
+ successCount: Math.max(0, total - Math.min(errorCount, total)),
82
+ total,
83
+ };
84
+ };
85
+ /** Short, monospace-friendly id suffix for display (e.g. "…a1b2c3"). */
86
+ export const shortId = (id) => {
87
+ if (!id) {
88
+ return "";
89
+ }
90
+ return id.length <= 6 ? id : id.slice(-6);
91
+ };
92
+ /** Build the CSV/JSON payload for exporting a run's output lines. */
93
+ export const buildExport = (lines, kind) => {
94
+ if (kind === "json") {
95
+ const rows = lines.map((line, index) => ({
96
+ line: index + 1,
97
+ result: line,
98
+ status: isErrorLine(line) ? "error" : "success",
99
+ }));
100
+ return { content: JSON.stringify(rows, null, 2), mimeType: "application/json" };
101
+ }
102
+ const escapeCsv = (value) => `"${String(value).replace(/"/g, '""')}"`;
103
+ const head = "line,status,result\n";
104
+ const body = lines
105
+ .map((line, index) => [String(index + 1), isErrorLine(line) ? "error" : "success", line].map(escapeCsv).join(","))
106
+ .join("\n");
107
+ return { content: head + body, mimeType: "text/csv" };
108
+ };
109
+ /** Most-recent run per script name, keyed by `taskType`. */
110
+ export const latestRunByScript = (runs) => {
111
+ var _a, _b;
112
+ const latest = {};
113
+ for (const run of runs) {
114
+ const existing = latest[run.taskType];
115
+ if (!existing || ((_a = run.created) !== null && _a !== void 0 ? _a : "") > ((_b = existing.created) !== null && _b !== void 0 ? _b : "")) {
116
+ latest[run.taskType] = run;
117
+ }
118
+ }
119
+ return latest;
120
+ };
121
+ //# sourceMappingURL=scriptRunUtils.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scriptRunUtils.js","sourceRoot":"","sources":["../src/scriptRunUtils.ts"],"names":[],"mappings":"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"}
package/dist/types.d.ts CHANGED
@@ -43,6 +43,11 @@ export interface AdminFieldConfig {
43
43
  /** For array fields of ObjectId refs: the referenced model name */
44
44
  itemRef?: string;
45
45
  }
46
+ export interface AdminModelPermissions {
47
+ create?: boolean;
48
+ delete?: boolean;
49
+ update?: boolean;
50
+ }
46
51
  export interface AdminModelConfig {
47
52
  name: string;
48
53
  routePath: string;
@@ -53,6 +58,43 @@ export interface AdminModelConfig {
53
58
  fieldOrder?: string[];
54
59
  /** Optional per-column pixel widths used by AdminModelTable when rendering listFields. */
55
60
  listColumnWidths?: Record<string, number>;
61
+ /**
62
+ * Field key used for the edit screen title (stack / document title). When unset, the form
63
+ * picks a scalar label from common keys (`name`, `title`, …) then the first list column.
64
+ */
65
+ recordTitleField?: string;
66
+ /** Admin UI v2 — declarative bulk actions */
67
+ actions?: {
68
+ background?: boolean;
69
+ confirm?: string;
70
+ id: string;
71
+ label: string;
72
+ patchKeys?: string[];
73
+ }[];
74
+ bulkPatchAllowlist?: string[];
75
+ fieldsets?: {
76
+ fields: string[];
77
+ title: string;
78
+ }[];
79
+ filters?: {
80
+ choices?: {
81
+ label: string;
82
+ value: string;
83
+ }[];
84
+ field: string;
85
+ kind: string;
86
+ label?: string;
87
+ }[];
88
+ group?: string;
89
+ hiddenFields?: string[];
90
+ listDisplay?: string[];
91
+ listDisplayLinks?: string[];
92
+ pageSize?: number;
93
+ permissions?: AdminModelPermissions;
94
+ readonlyFields?: string[];
95
+ realtime?: boolean;
96
+ searchFields?: string[];
97
+ sortableFields?: string[];
56
98
  }
57
99
  export interface AdminCustomScreen {
58
100
  description?: string;
@@ -63,9 +105,22 @@ export interface AdminScriptConfig {
63
105
  name: string;
64
106
  description: string;
65
107
  }
108
+ /** Admin UI v2 home layout slots (Django template-block analogue). */
109
+ export interface AdminHomeSlots {
110
+ contentTop?: string[];
111
+ main?: string[];
112
+ navGlobal?: string[];
113
+ sidebar?: string[];
114
+ }
115
+ export interface AdminHome {
116
+ slots: AdminHomeSlots;
117
+ title: string;
118
+ }
66
119
  export interface AdminConfigResponse {
67
120
  customScreens?: AdminCustomScreen[];
121
+ home?: AdminHome;
68
122
  models: AdminModelConfig[];
123
+ schemaVersion?: number;
69
124
  scripts: AdminScriptConfig[];
70
125
  }
71
126
  export interface BackgroundTaskProgress {
@@ -92,6 +147,19 @@ export interface BackgroundTask {
92
147
  created: string;
93
148
  updated: string;
94
149
  }
150
+ /** A single past script run, as returned by `GET {apiBase}/scripts/runs`. */
151
+ export interface ScriptRun extends BackgroundTask {
152
+ /** Display name (or email) of the admin who triggered the run, when available. */
153
+ createdByName?: string;
154
+ }
155
+ /** Paginated response from the script run-history endpoint. */
156
+ export interface ScriptRunListResponse {
157
+ data: ScriptRun[];
158
+ limit: number;
159
+ more: boolean;
160
+ page: number;
161
+ total: number;
162
+ }
95
163
  /**
96
164
  * Common props for admin screens.
97
165
  *
@@ -149,6 +217,8 @@ export interface RefFieldRendererProps {
149
217
  onChange: (value: string) => void;
150
218
  errorText?: string;
151
219
  helperText?: string;
220
+ /** When true, the picker is display-only and does not submit changes. */
221
+ readOnly?: boolean;
152
222
  }
153
223
  /**
154
224
  * Map from referenced model name (e.g. "User") to a custom component used to render
package/dist/types.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAmIA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAChC,OAAO,EACP,OAAO,EACP,SAAS,GAKV,EAAwC,EAAE;;IACzC,OAAO;QACL,OAAO,EAAE,MAAA,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,OAAO,mCAAI,EAAE;QACjC,SAAS,EAAE,MAAA,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,OAAO,mCAAI,EAAE;KACtC,CAAC;AACJ,CAAC,CAAC;AAmCF,gDAAgD;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAsMA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAChC,OAAO,EACP,OAAO,EACP,SAAS,GAKV,EAAwC,EAAE;;IACzC,OAAO;QACL,OAAO,EAAE,MAAA,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,OAAO,mCAAI,EAAE;QACjC,SAAS,EAAE,MAAA,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,OAAO,mCAAI,EAAE;KACtC,CAAC;AACJ,CAAC,CAAC;AAqCF,gDAAgD;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC"}
@@ -43,6 +43,7 @@ import type { AdminApi } from "./types";
43
43
  * @see AdminModelTable for usage in the table view
44
44
  */
45
45
  export declare const useAdminApi: (api: AdminApi, routePath: string, modelName: string) => {
46
+ useBulkPatchMutation: any;
46
47
  useCreateMutation: any;
47
48
  useDeleteMutation: any;
48
49
  useListQuery: any;
@@ -49,6 +49,7 @@ export const useAdminApi = (api, routePath, modelName) => {
49
49
  const createKey = `adminCreate_${modelName}`;
50
50
  const updateKey = `adminUpdate_${modelName}`;
51
51
  const deleteKey = `adminDelete_${modelName}`;
52
+ const bulkPatchKey = `adminBulkPatch_${modelName}`;
52
53
  const tagType = `admin_${modelName}`;
53
54
  return api.enhanceEndpoints({ addTagTypes: [tagType] }).injectEndpoints({
54
55
  endpoints: (build) => ({
@@ -95,6 +96,14 @@ export const useAdminApi = (api, routePath, modelName) => {
95
96
  url: `${routePath}/${id}`,
96
97
  }),
97
98
  }),
99
+ [bulkPatchKey]: build.mutation({
100
+ invalidatesTags: [`admin_${modelName}`],
101
+ query: ({ ids, patch }) => ({
102
+ body: { ids, patch },
103
+ method: "POST",
104
+ url: `${routePath}/bulk-patch`,
105
+ }),
106
+ }),
98
107
  }),
99
108
  overrideExisting: true,
100
109
  });
@@ -106,10 +115,12 @@ export const useAdminApi = (api, routePath, modelName) => {
106
115
  const createKey = `adminCreate_${modelName}`;
107
116
  const updateKey = `adminUpdate_${modelName}`;
108
117
  const deleteKey = `adminDelete_${modelName}`;
118
+ const bulkPatchKey = `adminBulkPatch_${modelName}`;
109
119
  // noExplicitAny: RTK Query generates hook names dynamically from endpoint keys; not statically expressible
110
120
  // biome-ignore lint/suspicious/noExplicitAny: dynamic hook lookup on RTK Query enhanced API
111
121
  const enhanced = enhancedApi;
112
122
  return {
123
+ useBulkPatchMutation: enhanced[`use${capitalize(bulkPatchKey)}Mutation`],
113
124
  useCreateMutation: enhanced[`use${capitalize(createKey)}Mutation`],
114
125
  useDeleteMutation: enhanced[`use${capitalize(deleteKey)}Mutation`],
115
126
  useListQuery: enhanced[`use${capitalize(listKey)}Query`],
@@ -1 +1 @@
1
- {"version":3,"file":"useAdminApi.js","sourceRoot":"","sources":["../src/useAdminApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;AAQ9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAa,EAAE,SAAiB,EAAE,SAAiB,EAAE,EAAE;IACjF,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE;QAC/B,MAAM,OAAO,GAAG,aAAa,SAAS,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,aAAa,SAAS,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,eAAe,SAAS,EAAE,CAAC;QAC7C,MAAM,SAAS,GAAG,eAAe,SAAS,EAAE,CAAC;QAC7C,MAAM,SAAS,GAAG,eAAe,SAAS,EAAE,CAAC;QAE7C,MAAM,OAAO,GAAG,SAAS,SAAS,EAAE,CAAC;QACrC,OAAO,GAAG,CAAC,gBAAgB,CAAC,EAAC,WAAW,EAAE,CAAC,OAAO,CAAC,EAAC,CAAC,CAAC,eAAe,CAAC;YACpE,SAAS,EAAE,CAAC,KAAsB,EAAE,EAAE,CAAC,CAAC;gBACtC,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;oBACrB,YAAY,EAAE,CAAC,SAAS,SAAS,EAAE,CAAC;oBACpC,KAAK,EAAE,CAAC,MAA2C,EAAE,EAAE,CAAC,CAAC;wBACvD,MAAM,EAAE,KAAK;wBACb,MAAM,EAAE,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE;wBACpB,GAAG,EAAE,SAAS;qBACf,CAAC;iBACH,CAAC;gBACF,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;oBACrB,YAAY,EAAE,CAAC,OAAe,EAAE,MAAc,EAAE,EAAU,EAAE,EAAE,CAAC;wBAC7D,EAAC,EAAE,EAAE,IAAI,EAAE,SAAS,SAAS,EAAE,EAAC;qBACjC;oBACD,KAAK,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC;wBACtB,MAAM,EAAE,KAAK;wBACb,GAAG,EAAE,GAAG,SAAS,IAAI,EAAE,EAAE;qBAC1B,CAAC;iBACH,CAAC;gBACF,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC;oBAC1B,eAAe,EAAE,CAAC,SAAS,SAAS,EAAE,CAAC;oBACvC,KAAK,EAAE,CAAC,IAAkB,EAAE,EAAE,CAAC,CAAC;wBAC9B,IAAI;wBACJ,MAAM,EAAE,MAAM;wBACd,GAAG,EAAE,SAAS;qBACf,CAAC;iBACH,CAAC;gBACF,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC;oBAC1B,eAAe,EAAE,CAAC,OAAe,EAAE,MAAc,EAAE,EAAC,EAAE,EAAe,EAAE,EAAE,CAAC;wBACxE,EAAC,EAAE,EAAE,IAAI,EAAE,SAAS,SAAS,EAAE,EAAC;wBAChC,SAAS,SAAS,EAAE;qBACrB;oBACD,KAAK,EAAE,CAAC,EAAC,EAAE,EAAE,IAAI,EAAmC,EAAE,EAAE,CAAC,CAAC;wBACxD,IAAI;wBACJ,MAAM,EAAE,OAAO;wBACf,GAAG,EAAE,GAAG,SAAS,IAAI,EAAE,EAAE;qBAC1B,CAAC;iBACH,CAAC;gBACF,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC;oBAC1B,eAAe,EAAE,CAAC,SAAS,SAAS,EAAE,CAAC;oBACvC,KAAK,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC;wBACtB,MAAM,EAAE,QAAQ;wBAChB,GAAG,EAAE,GAAG,SAAS,IAAI,EAAE,EAAE;qBAC1B,CAAC;iBACH,CAAC;aACH,CAAC;YACF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IAEhC,0CAA0C;IAC1C,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,aAAa,SAAS,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,aAAa,SAAS,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,eAAe,SAAS,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,eAAe,SAAS,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,eAAe,SAAS,EAAE,CAAC;IAE7C,2GAA2G;IAC3G,4FAA4F;IAC5F,MAAM,QAAQ,GAAG,WAAkB,CAAC;IACpC,OAAO;QACL,iBAAiB,EAAE,QAAQ,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC;QAClE,iBAAiB,EAAE,QAAQ,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC;QAClE,YAAY,EAAE,QAAQ,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC;QACxD,YAAY,EAAE,QAAQ,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC;QACxD,iBAAiB,EAAE,QAAQ,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC;KACnE,CAAC;AACJ,CAAC,CAAC"}
1
+ {"version":3,"file":"useAdminApi.js","sourceRoot":"","sources":["../src/useAdminApi.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { AdminApi } from "./types";
2
+ export interface AdminBackgroundTaskBody {
3
+ ids?: string[];
4
+ kind: string;
5
+ metadata?: Record<string, unknown>;
6
+ resourceRoute?: string;
7
+ }
8
+ /**
9
+ * RTK Query mutation hook for `POST {adminApiRoot}/background-tasks` (admin enqueue).
10
+ */
11
+ export declare const useAdminBackgroundTaskMutation: (api: AdminApi, adminApiRoot: string) => ReturnType<// biome-ignore lint/suspicious/noExplicitAny: RTK mutation type from dynamic injectEndpoints
12
+ any>;
@@ -0,0 +1,26 @@
1
+ import { useMemo } from "react";
2
+ /**
3
+ * RTK Query mutation hook for `POST {adminApiRoot}/background-tasks` (admin enqueue).
4
+ */
5
+ export const useAdminBackgroundTaskMutation = (api, adminApiRoot) => {
6
+ const enhancedApi = useMemo(() => {
7
+ const root = adminApiRoot.replace(/\/$/, "");
8
+ return api.enhanceEndpoints({ addTagTypes: ["AdminBackgroundTask"] }).injectEndpoints({
9
+ endpoints: (build) => ({
10
+ adminPostBackgroundTask: build.mutation({
11
+ invalidatesTags: [],
12
+ query: (body) => ({
13
+ body,
14
+ method: "POST",
15
+ url: `${root}/background-tasks`,
16
+ }),
17
+ }),
18
+ }),
19
+ overrideExisting: true,
20
+ });
21
+ }, [api, adminApiRoot]);
22
+ // biome-ignore lint/suspicious/noExplicitAny: dynamic hook lookup on RTK Query enhanced API
23
+ const enhanced = enhancedApi;
24
+ return enhanced.useAdminPostBackgroundTaskMutation();
25
+ };
26
+ //# sourceMappingURL=useAdminBackgroundTask.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useAdminBackgroundTask.js","sourceRoot":"","sources":["../src/useAdminBackgroundTask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;AAW9B;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAC5C,GAAa,EACb,YAAoB,EAEjB,EAAE;IACL,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE;QAC/B,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7C,OAAO,GAAG,CAAC,gBAAgB,CAAC,EAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,EAAC,CAAC,CAAC,eAAe,CAAC;YAClF,SAAS,EAAE,CAAC,KAAsB,EAAE,EAAE,CAAC,CAAC;gBACtC,uBAAuB,EAAE,KAAK,CAAC,QAAQ,CAAC;oBACtC,eAAe,EAAE,EAAE;oBACnB,KAAK,EAAE,CAAC,IAA6B,EAAE,EAAE,CAAC,CAAC;wBACzC,IAAI;wBACJ,MAAM,EAAE,MAAM;wBACd,GAAG,EAAE,GAAG,IAAI,mBAAmB;qBAChC,CAAC;iBACH,CAAC;aACH,CAAC;YACF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;IAExB,4FAA4F;IAC5F,MAAM,QAAQ,GAAG,WAAkB,CAAC;IACpC,OAAO,QAAQ,CAAC,kCAAkC,EAAE,CAAC;AACvD,CAAC,CAAC"}
@@ -1,4 +1,17 @@
1
- import type { AdminApi, BackgroundTask } from "./types";
1
+ import type { AdminApi, BackgroundTask, ScriptRunListResponse } from "./types";
2
+ export interface ScriptRunsQueryArg {
3
+ /** Limit history to a single script by `taskType`. Omit for all scripts. */
4
+ name?: string;
5
+ page?: number;
6
+ limit?: number;
7
+ }
8
+ interface ScriptRunsQueryResult {
9
+ data: ScriptRunListResponse | undefined;
10
+ isLoading: boolean;
11
+ isFetching?: boolean;
12
+ error: unknown;
13
+ refetch?: () => void;
14
+ }
2
15
  export declare const useAdminScripts: (api: AdminApi, apiBase: string) => {
3
16
  useCancelScriptTaskMutation: () => [(taskId: string) => {
4
17
  unwrap: () => Promise<{
@@ -18,6 +31,10 @@ export declare const useAdminScripts: (api: AdminApi, apiBase: string) => {
18
31
  isLoading: boolean;
19
32
  error: unknown;
20
33
  };
34
+ useListScriptRunsQuery: (arg?: ScriptRunsQueryArg, options?: {
35
+ skip?: boolean;
36
+ pollingInterval?: number;
37
+ }) => ScriptRunsQueryResult;
21
38
  useRunScriptMutation: () => [(args: {
22
39
  name: string;
23
40
  wetRun: boolean;
@@ -29,3 +46,4 @@ export declare const useAdminScripts: (api: AdminApi, apiBase: string) => {
29
46
  isLoading: boolean;
30
47
  }];
31
48
  };
49
+ export {};
@@ -1,10 +1,22 @@
1
1
  import { useMemo } from "react";
2
+ const EMPTY_RUNS_HOOK = () => ({
3
+ data: undefined,
4
+ error: null,
5
+ isFetching: false,
6
+ isLoading: false,
7
+ });
2
8
  export const useAdminScripts = (api, apiBase) => {
9
+ var _a, _b, _c, _d;
3
10
  const enhancedApi = useMemo(() => {
11
+ // Guard: some call sites (and tests) pass a type-erased API double without
12
+ // `injectEndpoints`. Return null so we can fall back to no-op hooks.
13
+ if (typeof (api === null || api === void 0 ? void 0 : api.injectEndpoints) !== "function") {
14
+ return null;
15
+ }
4
16
  return api.injectEndpoints({
5
17
  endpoints: (build) => ({
6
18
  adminCancelScriptTask: build.mutation({
7
- invalidatesTags: ["admin_scriptTask"],
19
+ invalidatesTags: ["admin_scriptTask", "admin_scriptRuns"],
8
20
  query: (taskId) => ({
9
21
  method: "DELETE",
10
22
  url: `${apiBase}/scripts/tasks/${taskId}`,
@@ -17,7 +29,20 @@ export const useAdminScripts = (api, apiBase) => {
17
29
  url: `${apiBase}/scripts/tasks/${taskId}`,
18
30
  }),
19
31
  }),
32
+ adminListScriptRuns: build.query({
33
+ providesTags: ["admin_scriptRuns"],
34
+ query: ({ name, page = 1, limit = 25 } = {}) => {
35
+ const params = new URLSearchParams();
36
+ params.set("page", String(page));
37
+ params.set("limit", String(limit));
38
+ if (name) {
39
+ params.set("name", name);
40
+ }
41
+ return { method: "GET", url: `${apiBase}/scripts/runs?${params.toString()}` };
42
+ },
43
+ }),
20
44
  adminRunScript: build.mutation({
45
+ invalidatesTags: ["admin_scriptRuns"],
21
46
  query: ({ name, wetRun }) => ({
22
47
  method: "POST",
23
48
  url: `${apiBase}/scripts/${name}/run?wetRun=${wetRun}`,
@@ -31,9 +56,13 @@ export const useAdminScripts = (api, apiBase) => {
31
56
  // biome-ignore lint/suspicious/noExplicitAny: dynamic hook lookup on RTK Query enhanced API
32
57
  const enhanced = enhancedApi;
33
58
  return {
34
- useCancelScriptTaskMutation: enhanced.useAdminCancelScriptTaskMutation,
35
- useGetScriptTaskQuery: enhanced.useAdminGetScriptTaskQuery,
36
- useRunScriptMutation: enhanced.useAdminRunScriptMutation,
59
+ useCancelScriptTaskMutation: ((_a = enhanced === null || enhanced === void 0 ? void 0 : enhanced.useAdminCancelScriptTaskMutation) !== null && _a !== void 0 ? _a : (() => [() => ({ unwrap: () => Promise.resolve({}) }), { isLoading: false }])),
60
+ useGetScriptTaskQuery: ((_b = enhanced === null || enhanced === void 0 ? void 0 : enhanced.useAdminGetScriptTaskQuery) !== null && _b !== void 0 ? _b : (() => ({ data: undefined, error: null, isLoading: false }))),
61
+ useListScriptRunsQuery: ((_c = enhanced === null || enhanced === void 0 ? void 0 : enhanced.useAdminListScriptRunsQuery) !== null && _c !== void 0 ? _c : EMPTY_RUNS_HOOK),
62
+ useRunScriptMutation: ((_d = enhanced === null || enhanced === void 0 ? void 0 : enhanced.useAdminRunScriptMutation) !== null && _d !== void 0 ? _d : (() => [
63
+ () => ({ unwrap: () => Promise.resolve({ taskId: "" }) }),
64
+ { isLoading: false },
65
+ ])),
37
66
  };
38
67
  };
39
68
  //# sourceMappingURL=useAdminScripts.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"useAdminScripts.js","sourceRoot":"","sources":["../src/useAdminScripts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;AAG9B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAa,EAAE,OAAe,EAAE,EAAE;IAChE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE;QAC/B,OAAO,GAAG,CAAC,eAAe,CAAC;YACzB,SAAS,EAAE,CAAC,KAAsB,EAAE,EAAE,CAAC,CAAC;gBACtC,qBAAqB,EAAE,KAAK,CAAC,QAAQ,CAAC;oBACpC,eAAe,EAAE,CAAC,kBAAkB,CAAC;oBACrC,KAAK,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC;wBAC1B,MAAM,EAAE,QAAQ;wBAChB,GAAG,EAAE,GAAG,OAAO,kBAAkB,MAAM,EAAE;qBAC1C,CAAC;iBACH,CAAC;gBACF,kBAAkB,EAAE,KAAK,CAAC,KAAK,CAAC;oBAC9B,YAAY,EAAE,CAAC,kBAAkB,CAAC;oBAClC,KAAK,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC;wBAC1B,MAAM,EAAE,KAAK;wBACb,GAAG,EAAE,GAAG,OAAO,kBAAkB,MAAM,EAAE;qBAC1C,CAAC;iBACH,CAAC;gBACF,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC;oBAC7B,KAAK,EAAE,CAAC,EAAC,IAAI,EAAE,MAAM,EAAkC,EAAE,EAAE,CAAC,CAAC;wBAC3D,MAAM,EAAE,MAAM;wBACd,GAAG,EAAE,GAAG,OAAO,YAAY,IAAI,eAAe,MAAM,EAAE;qBACvD,CAAC;iBACH,CAAC;aACH,CAAC;YACF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAEnB,wFAAwF;IACxF,4FAA4F;IAC5F,MAAM,QAAQ,GAAG,WAAkB,CAAC;IACpC,OAAO;QACL,2BAA2B,EAAE,QAAQ,CAAC,gCAGrC;QACD,qBAAqB,EAAE,QAAQ,CAAC,0BAGmD;QACnF,oBAAoB,EAAE,QAAQ,CAAC,yBAG9B;KACF,CAAC;AACJ,CAAC,CAAC"}
1
+ {"version":3,"file":"useAdminScripts.js","sourceRoot":"","sources":["../src/useAdminScripts.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "dependencies": {
3
- "@terreno/ui": "0.20.1",
3
+ "@terreno/ui": "0.21.0",
4
4
  "expo-router": "~6.0.19",
5
5
  "jspdf": "^4.2.0",
6
6
  "lodash": "^4.17.23",
@@ -20,7 +20,8 @@
20
20
  },
21
21
  "files": [
22
22
  "dist/**/*",
23
- "src/**/*"
23
+ "src/**/*",
24
+ ".ai/**/*"
24
25
  ],
25
26
  "license": "Apache-2.0",
26
27
  "main": "dist/index.js",
@@ -51,5 +52,5 @@
51
52
  "test:coverage": "bun run ../scripts/check-coverage.ts"
52
53
  },
53
54
  "types": "dist/index.d.ts",
54
- "version": "0.20.1"
55
+ "version": "0.21.0"
55
56
  }
@@ -0,0 +1,27 @@
1
+ import {describe, expect, it, mock} from "bun:test";
2
+ import {renderWithTheme} from "@terreno/ui/src/test-utils";
3
+ import React from "react";
4
+
5
+ mock.module("expo-router", () => ({
6
+ router: {push: () => {}},
7
+ }));
8
+
9
+ import {AdminBreadcrumbs} from "./AdminBreadcrumbs";
10
+
11
+ describe("AdminBreadcrumbs", () => {
12
+ it("renders labels and separators", () => {
13
+ const {getByText, getByTestId} = renderWithTheme(
14
+ <AdminBreadcrumbs segments={[{href: "/", label: "Admin"}, {label: "Todos"}]} />
15
+ );
16
+ expect(getByText("Admin")).toBeTruthy();
17
+ expect(getByText("Todos")).toBeTruthy();
18
+ expect(getByTestId("admin-breadcrumb-sep-1")).toBeTruthy();
19
+ });
20
+
21
+ it("exposes an accessible control for linked segments", () => {
22
+ const {getByHintText} = renderWithTheme(
23
+ <AdminBreadcrumbs segments={[{href: "/", label: "Admin"}, {label: "Todos"}]} />
24
+ );
25
+ expect(getByHintText("Navigate to Admin")).toBeTruthy();
26
+ });
27
+ });
@@ -0,0 +1,63 @@
1
+ import {Box, Text} from "@terreno/ui";
2
+ import type {Href} from "expo-router";
3
+ import {router} from "expo-router";
4
+ import React, {useCallback} from "react";
5
+
6
+ export interface AdminBreadcrumbSegment {
7
+ /** Path for expo-router (e.g. "/", "/FeatureFlag", "/__scripts") */
8
+ href?: string;
9
+ label: string;
10
+ }
11
+
12
+ export interface AdminBreadcrumbsProps {
13
+ segments: AdminBreadcrumbSegment[];
14
+ }
15
+
16
+ /**
17
+ * Compact breadcrumb row for the admin shell top bar.
18
+ */
19
+ export const AdminBreadcrumbs: React.FC<AdminBreadcrumbsProps> = ({segments}) => {
20
+ const handleCrumbPress = useCallback((href: string) => {
21
+ router.push(href as Href);
22
+ }, []);
23
+
24
+ if (segments.length === 0) {
25
+ return null;
26
+ }
27
+
28
+ return (
29
+ <Box alignItems="center" direction="row" gap={2} testID="admin-breadcrumbs">
30
+ {segments.map((segment, index) => {
31
+ const isLast = index === segments.length - 1;
32
+ return (
33
+ <Box alignItems="center" direction="row" gap={2} key={`${segment.label}-${index}`}>
34
+ {index > 0 ? (
35
+ <Text color="secondaryDark" size="sm" testID={`admin-breadcrumb-sep-${index}`}>
36
+ /
37
+ </Text>
38
+ ) : null}
39
+ {segment.href && !isLast ? (
40
+ <Box
41
+ accessibilityHint={`Navigate to ${segment.label}`}
42
+ accessibilityLabel={segment.label}
43
+ onClick={() => {
44
+ handleCrumbPress(segment.href as string);
45
+ }}
46
+ padding={1}
47
+ testID={`admin-breadcrumb-link-${index}`}
48
+ >
49
+ <Text color="link" size="sm">
50
+ {segment.label}
51
+ </Text>
52
+ </Box>
53
+ ) : (
54
+ <Text bold={isLast} size="sm">
55
+ {segment.label}
56
+ </Text>
57
+ )}
58
+ </Box>
59
+ );
60
+ })}
61
+ </Box>
62
+ );
63
+ };
@@ -28,6 +28,7 @@ export const AdminFieldRenderer: React.FC<AdminFieldRendererProps> = ({
28
28
  modelConfigs,
29
29
  parentFormState,
30
30
  refRenderers,
31
+ readOnly,
31
32
  }) => {
32
33
  if (fieldConfig.type === "array" && fieldConfig.items) {
33
34
  return (
@@ -41,6 +42,7 @@ export const AdminFieldRenderer: React.FC<AdminFieldRendererProps> = ({
41
42
  modelConfigs={modelConfigs}
42
43
  onChange={onChange}
43
44
  parentFormState={parentFormState}
45
+ readOnly={readOnly}
44
46
  refRenderers={refRenderers}
45
47
  routeBase={routeBase}
46
48
  title={startCase(fieldKey)}
@@ -60,6 +62,7 @@ export const AdminFieldRenderer: React.FC<AdminFieldRendererProps> = ({
60
62
  modelConfigs={modelConfigs}
61
63
  onChange={onChange}
62
64
  parentFormState={parentFormState}
65
+ readOnly={readOnly}
63
66
  refRenderers={refRenderers}
64
67
  routeBase={routeBase}
65
68
  value={value}