@terreno/admin-frontend 57.0.0 → 57.2.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 (158) hide show
  1. package/dist/AdminActionMenu.d.ts +15 -0
  2. package/dist/AdminActionMenu.js +56 -0
  3. package/dist/AdminActionMenu.js.map +1 -0
  4. package/dist/AdminFieldRenderer.js +2 -2
  5. package/dist/AdminFieldRenderer.js.map +1 -1
  6. package/dist/AdminFieldRendererCore.d.ts +2 -0
  7. package/dist/AdminFieldRendererCore.js +18 -47
  8. package/dist/AdminFieldRendererCore.js.map +1 -1
  9. package/dist/AdminFilterDrawer.d.ts +20 -0
  10. package/dist/AdminFilterDrawer.js +117 -0
  11. package/dist/AdminFilterDrawer.js.map +1 -0
  12. package/dist/AdminHome.d.ts +2 -4
  13. package/dist/AdminHome.js +15 -137
  14. package/dist/AdminHome.js.map +1 -1
  15. package/dist/AdminModelForm.js +29 -10
  16. package/dist/AdminModelForm.js.map +1 -1
  17. package/dist/AdminModelList.d.ts +2 -1
  18. package/dist/AdminModelList.js +5 -1
  19. package/dist/AdminModelList.js.map +1 -1
  20. package/dist/AdminModelTable.js +56 -98
  21. package/dist/AdminModelTable.js.map +1 -1
  22. package/dist/AdminObjectPicker.d.ts +3 -0
  23. package/dist/AdminObjectPicker.js +27 -7
  24. package/dist/AdminObjectPicker.js.map +1 -1
  25. package/dist/AdminPrimitiveArrayField.d.ts +2 -0
  26. package/dist/AdminPrimitiveArrayField.js +3 -3
  27. package/dist/AdminPrimitiveArrayField.js.map +1 -1
  28. package/dist/AdminProvider.d.ts +16 -0
  29. package/dist/AdminProvider.js +84 -0
  30. package/dist/AdminProvider.js.map +1 -0
  31. package/dist/AdminRefField.js +2 -2
  32. package/dist/AdminRefField.js.map +1 -1
  33. package/dist/AdminRolesField.d.ts +9 -0
  34. package/dist/AdminRolesField.js +45 -0
  35. package/dist/AdminRolesField.js.map +1 -0
  36. package/dist/AdminRolesList.d.ts +3 -0
  37. package/dist/AdminRolesList.js +187 -0
  38. package/dist/AdminRolesList.js.map +1 -0
  39. package/dist/AdminScreenRouter.d.ts +13 -0
  40. package/dist/AdminScreenRouter.js +52 -0
  41. package/dist/AdminScreenRouter.js.map +1 -0
  42. package/dist/AdminScriptList.js +12 -10
  43. package/dist/AdminScriptList.js.map +1 -1
  44. package/dist/AdminShell.d.ts +2 -0
  45. package/dist/AdminShell.js +68 -21
  46. package/dist/AdminShell.js.map +1 -1
  47. package/dist/Constants.d.ts +4 -0
  48. package/dist/Constants.js +5 -0
  49. package/dist/Constants.js.map +1 -0
  50. package/dist/adminModelListQueryParams.d.ts +4 -0
  51. package/dist/adminModelListQueryParams.js +38 -3
  52. package/dist/adminModelListQueryParams.js.map +1 -1
  53. package/dist/adminPageAccess.d.ts +5 -0
  54. package/dist/adminPageAccess.js +19 -0
  55. package/dist/adminPageAccess.js.map +1 -0
  56. package/dist/index.d.ts +20 -1
  57. package/dist/index.js +18 -0
  58. package/dist/index.js.map +1 -1
  59. package/dist/types.d.ts +74 -0
  60. package/dist/types.js.map +1 -1
  61. package/dist/useAdminRoles.d.ts +65 -0
  62. package/dist/useAdminRoles.js +84 -0
  63. package/dist/useAdminRoles.js.map +1 -0
  64. package/dist/useDocumentStorageApi.js +2 -2
  65. package/dist/useDocumentStorageApi.js.map +1 -1
  66. package/dist/widgets/AIRequestsScreenWidget.d.ts +4 -0
  67. package/dist/widgets/AIRequestsScreenWidget.js +54 -0
  68. package/dist/widgets/AIRequestsScreenWidget.js.map +1 -0
  69. package/dist/widgets/CustomScreensListWidget.d.ts +4 -0
  70. package/dist/widgets/CustomScreensListWidget.js +21 -0
  71. package/dist/widgets/CustomScreensListWidget.js.map +1 -0
  72. package/dist/widgets/DocumentsScreenWidget.d.ts +4 -0
  73. package/dist/widgets/DocumentsScreenWidget.js +9 -0
  74. package/dist/widgets/DocumentsScreenWidget.js.map +1 -0
  75. package/dist/widgets/FeatureFlagsOverridesWidget.d.ts +4 -0
  76. package/dist/widgets/FeatureFlagsOverridesWidget.js +18 -0
  77. package/dist/widgets/FeatureFlagsOverridesWidget.js.map +1 -0
  78. package/dist/widgets/MissingWidget.d.ts +7 -0
  79. package/dist/widgets/MissingWidget.js +6 -0
  80. package/dist/widgets/MissingWidget.js.map +1 -0
  81. package/dist/widgets/ModelsGridWidget.d.ts +3 -0
  82. package/dist/widgets/ModelsGridWidget.js +30 -0
  83. package/dist/widgets/ModelsGridWidget.js.map +1 -0
  84. package/dist/widgets/RecentActivityWidget.d.ts +3 -0
  85. package/dist/widgets/RecentActivityWidget.js +27 -0
  86. package/dist/widgets/RecentActivityWidget.js.map +1 -0
  87. package/dist/widgets/ScriptRunnerWidget.d.ts +3 -0
  88. package/dist/widgets/ScriptRunnerWidget.js +12 -0
  89. package/dist/widgets/ScriptRunnerWidget.js.map +1 -0
  90. package/dist/widgets/VersionConfigScreenWidget.d.ts +3 -0
  91. package/dist/widgets/VersionConfigScreenWidget.js +7 -0
  92. package/dist/widgets/VersionConfigScreenWidget.js.map +1 -0
  93. package/dist/widgets/VersionConfigWidget.d.ts +3 -0
  94. package/dist/widgets/VersionConfigWidget.js +7 -0
  95. package/dist/widgets/VersionConfigWidget.js.map +1 -0
  96. package/dist/widgets/builtInFieldWidgets.d.ts +7 -0
  97. package/dist/widgets/builtInFieldWidgets.js +61 -0
  98. package/dist/widgets/builtInFieldWidgets.js.map +1 -0
  99. package/dist/widgets/builtInWidgets.d.ts +6 -0
  100. package/dist/widgets/builtInWidgets.js +31 -0
  101. package/dist/widgets/builtInWidgets.js.map +1 -0
  102. package/dist/widgets/consentWidgets.d.ts +3 -0
  103. package/dist/widgets/consentWidgets.js +8 -0
  104. package/dist/widgets/consentWidgets.js.map +1 -0
  105. package/dist/widgets/homeWidgetUtils.d.ts +3 -0
  106. package/dist/widgets/homeWidgetUtils.js +37 -0
  107. package/dist/widgets/homeWidgetUtils.js.map +1 -0
  108. package/package.json +3 -2
  109. package/src/AdminActionMenu.test.tsx +78 -0
  110. package/src/AdminActionMenu.tsx +106 -0
  111. package/src/AdminFieldRenderer.tsx +2 -0
  112. package/src/AdminFieldRendererCore.tsx +54 -133
  113. package/src/AdminFilterDrawer.test.tsx +89 -0
  114. package/src/AdminFilterDrawer.tsx +333 -0
  115. package/src/AdminHome.tsx +38 -325
  116. package/src/AdminModelForm.test.tsx +78 -0
  117. package/src/AdminModelForm.tsx +49 -10
  118. package/src/AdminModelList.tsx +7 -2
  119. package/src/AdminModelTable.test.tsx +73 -0
  120. package/src/AdminModelTable.tsx +108 -195
  121. package/src/AdminObjectPicker.tsx +49 -9
  122. package/src/AdminPrimitiveArrayField.tsx +5 -0
  123. package/src/AdminProvider.test.tsx +25 -0
  124. package/src/AdminProvider.tsx +121 -0
  125. package/src/AdminRefField.tsx +4 -0
  126. package/src/AdminRolesField.tsx +129 -0
  127. package/src/AdminRolesList.test.tsx +339 -0
  128. package/src/AdminRolesList.tsx +434 -0
  129. package/src/AdminScreenRouter.test.tsx +112 -0
  130. package/src/AdminScreenRouter.tsx +104 -0
  131. package/src/AdminScriptList.tsx +42 -30
  132. package/src/AdminShell.test.tsx +196 -1
  133. package/src/AdminShell.tsx +166 -69
  134. package/src/Constants.ts +5 -0
  135. package/src/adminModelListQueryParams.test.ts +69 -0
  136. package/src/adminModelListQueryParams.ts +49 -3
  137. package/src/adminPageAccess.test.ts +18 -0
  138. package/src/adminPageAccess.ts +18 -0
  139. package/src/index.tsx +51 -0
  140. package/src/isolated/AdminObjectPicker.isolated.tsx +10 -1
  141. package/src/types.ts +79 -0
  142. package/src/useAdminRoles.ts +146 -0
  143. package/src/useDocumentStorageApi.ts +2 -2
  144. package/src/widgets/AIRequestsScreenWidget.tsx +93 -0
  145. package/src/widgets/CustomScreensListWidget.tsx +56 -0
  146. package/src/widgets/DocumentsScreenWidget.tsx +11 -0
  147. package/src/widgets/FeatureFlagsOverridesWidget.tsx +48 -0
  148. package/src/widgets/MissingWidget.tsx +17 -0
  149. package/src/widgets/ModelsGridWidget.tsx +94 -0
  150. package/src/widgets/RecentActivityWidget.tsx +81 -0
  151. package/src/widgets/ScriptRunnerWidget.tsx +26 -0
  152. package/src/widgets/VersionConfigScreenWidget.tsx +12 -0
  153. package/src/widgets/VersionConfigWidget.tsx +7 -0
  154. package/src/widgets/builtInFieldWidgets.tsx +180 -0
  155. package/src/widgets/builtInWidgets.ts +51 -0
  156. package/src/widgets/consentWidgets.ts +13 -0
  157. package/src/widgets/homeWidgetUtils.ts +38 -0
  158. package/src/widgets/pluginWidgets.test.tsx +29 -0
@@ -0,0 +1,69 @@
1
+ import {describe, expect, it} from "bun:test";
2
+ import {assert} from "chai";
3
+
4
+ import {
5
+ adminFilterStateHasValues,
6
+ areAdminFilterStatesEqual,
7
+ buildAdminListQueryParams,
8
+ compactAdminFilterState,
9
+ } from "./adminModelListQueryParams";
10
+ import type {AdminModelConfig} from "./types";
11
+
12
+ const todoConfig = {
13
+ filters: [{field: "completed", kind: "boolean", label: "Completed"}],
14
+ searchFields: ["title"],
15
+ } as AdminModelConfig;
16
+
17
+ describe("compactAdminFilterState", () => {
18
+ it("drops undefined, empty string, and all", () => {
19
+ expect(
20
+ compactAdminFilterState({
21
+ active: false,
22
+ completed: undefined,
23
+ name: "",
24
+ role: "all",
25
+ title: " ",
26
+ })
27
+ ).toEqual({active: false});
28
+ });
29
+ });
30
+
31
+ describe("areAdminFilterStatesEqual", () => {
32
+ it("treats empty keys as equal to a missing applied state", () => {
33
+ expect(areAdminFilterStatesEqual({completed: undefined}, {})).toBe(true);
34
+ expect(areAdminFilterStatesEqual({completed: true}, {})).toBe(false);
35
+ });
36
+ });
37
+
38
+ describe("adminFilterStateHasValues", () => {
39
+ it("is false for an empty draft", () => {
40
+ expect(adminFilterStateHasValues({})).toBe(false);
41
+ expect(adminFilterStateHasValues({completed: undefined})).toBe(false);
42
+ });
43
+ });
44
+
45
+ describe("buildAdminListQueryParams", () => {
46
+ it("sends q for case-insensitive partial search instead of an exact field match", () => {
47
+ const params = buildAdminListQueryParams({
48
+ filterState: {},
49
+ limit: 25,
50
+ modelConfig: todoConfig,
51
+ page: 1,
52
+ searchDebounced: "TASK",
53
+ });
54
+ assert.equal(params.q, "TASK");
55
+ assert.isUndefined(params.title);
56
+ });
57
+
58
+ it("omits q when search is blank", () => {
59
+ const params = buildAdminListQueryParams({
60
+ filterState: {completed: true},
61
+ limit: 25,
62
+ modelConfig: todoConfig,
63
+ page: 1,
64
+ searchDebounced: " ",
65
+ });
66
+ assert.isUndefined(params.q);
67
+ assert.equal(params.completed, true);
68
+ });
69
+ });
@@ -4,6 +4,52 @@ export const ADMIN_LIST_MAX_SELECTION = 1000;
4
4
 
5
5
  export type AdminListFilterState = Record<string, string | boolean | undefined>;
6
6
 
7
+ const isEmptyFilterValue = (value: string | boolean | undefined): boolean => {
8
+ if (value === undefined || value === "") {
9
+ return true;
10
+ }
11
+ if (value === "all") {
12
+ return true;
13
+ }
14
+ return false;
15
+ };
16
+
17
+ /** Drops unset / "all" keys so draft vs applied comparison is stable. */
18
+ export const compactAdminFilterState = (
19
+ state: AdminListFilterState
20
+ ): Record<string, string | boolean> => {
21
+ const compacted: Record<string, string | boolean> = {};
22
+ const keys = Object.keys(state).sort();
23
+ for (const key of keys) {
24
+ const value = state[key];
25
+ if (isEmptyFilterValue(value)) {
26
+ continue;
27
+ }
28
+ if (typeof value === "boolean") {
29
+ compacted[key] = value;
30
+ continue;
31
+ }
32
+ compacted[key] = String(value).trim();
33
+ if (compacted[key] === "") {
34
+ delete compacted[key];
35
+ }
36
+ }
37
+ return compacted;
38
+ };
39
+
40
+ export const areAdminFilterStatesEqual = (
41
+ left: AdminListFilterState,
42
+ right: AdminListFilterState
43
+ ): boolean => {
44
+ return (
45
+ JSON.stringify(compactAdminFilterState(left)) === JSON.stringify(compactAdminFilterState(right))
46
+ );
47
+ };
48
+
49
+ export const adminFilterStateHasValues = (state: AdminListFilterState): boolean => {
50
+ return Object.keys(compactAdminFilterState(state)).length > 0;
51
+ };
52
+
7
53
  /**
8
54
  * Builds query params for `GET` admin modelRouter list routes from UI state.
9
55
  */
@@ -53,9 +99,9 @@ export const buildAdminListQueryParams = (input: {
53
99
  out[f.field] = String(raw);
54
100
  }
55
101
  }
56
- const firstSearchField = modelConfig.searchFields?.[0];
57
- if (firstSearchField && searchDebounced.trim() !== "") {
58
- out[firstSearchField] = searchDebounced.trim();
102
+ const searchFields = modelConfig.searchFields ?? [];
103
+ if (searchFields.length > 0 && searchDebounced.trim() !== "") {
104
+ out.q = searchDebounced.trim();
59
105
  }
60
106
  return out;
61
107
  };
@@ -0,0 +1,18 @@
1
+ import {describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+
4
+ import {isAdminPageForbiddenError} from "./adminPageAccess";
5
+
6
+ describe("isAdminPageForbiddenError", () => {
7
+ it("detects RTK 403 errors", () => {
8
+ assert.isTrue(isAdminPageForbiddenError({status: 403}));
9
+ assert.isTrue(isAdminPageForbiddenError({originalStatus: 403, status: "FETCH_ERROR"}));
10
+ assert.isTrue(isAdminPageForbiddenError({status: {status: 403}}));
11
+ });
12
+
13
+ it("ignores other failures", () => {
14
+ assert.isFalse(isAdminPageForbiddenError(undefined));
15
+ assert.isFalse(isAdminPageForbiddenError({status: 500}));
16
+ assert.isFalse(isAdminPageForbiddenError(new Error("Failed to load")));
17
+ });
18
+ });
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Detect a 403 from GET /admin/config. That is the single admin-page gate:
3
+ * `admin:access` when RBAC is on, otherwise `user.admin`.
4
+ */
5
+ export const isAdminPageForbiddenError = (error: unknown): boolean => {
6
+ if (!error || typeof error !== "object") {
7
+ return false;
8
+ }
9
+ const withStatus = error as {originalStatus?: unknown; status?: unknown};
10
+ if (withStatus.status === 403 || withStatus.originalStatus === 403) {
11
+ return true;
12
+ }
13
+ const nested = withStatus.status;
14
+ if (nested && typeof nested === "object" && "status" in nested) {
15
+ return (nested as {status?: unknown}).status === 403;
16
+ }
17
+ return false;
18
+ };
package/src/index.tsx CHANGED
@@ -1,5 +1,7 @@
1
+ export {AdminActionMenu} from "./AdminActionMenu";
1
2
  export {type AdminBreadcrumbSegment, AdminBreadcrumbs} from "./AdminBreadcrumbs";
2
3
  export {AdminFieldRenderer} from "./AdminFieldRenderer";
4
+ export {AdminFilterDrawer} from "./AdminFilterDrawer";
3
5
  export {AdminHome} from "./AdminHome";
4
6
  export {AdminModelForm, type AdminModelFormScreenTitleParams} from "./AdminModelForm";
5
7
  export {AdminModelList} from "./AdminModelList";
@@ -7,12 +9,26 @@ export {AdminModelTable} from "./AdminModelTable";
7
9
  export {AdminNestedArrayField} from "./AdminNestedArrayField";
8
10
  export {AdminObjectPicker} from "./AdminObjectPicker";
9
11
  export {AdminPrimitiveArrayField} from "./AdminPrimitiveArrayField";
12
+ export type {AdminProviderProps} from "./AdminProvider";
13
+ export {
14
+ AdminProvider,
15
+ resetAdminWidgetWarningsForTests,
16
+ useAdminContext,
17
+ useDeprecatedCustomScreensProp,
18
+ useFieldWidget,
19
+ useHomeWidget,
20
+ useScreenWidget,
21
+ } from "./AdminProvider";
10
22
  export {AdminRefField, type AdminRefFieldProps} from "./AdminRefField";
23
+ export {AdminRolesField} from "./AdminRolesField";
24
+ export {AdminRolesList} from "./AdminRolesList";
25
+ export {AdminScreenRouter, type AdminScreenRouterProps} from "./AdminScreenRouter";
11
26
  export {AdminScriptList} from "./AdminScriptList";
12
27
  export {AdminScriptRunModal} from "./AdminScriptRunModal";
13
28
  export {AdminShell, type AdminShellProps, type AdminShellSidebarVariant} from "./AdminShell";
14
29
  export {AdminShellLayout, type AdminShellLayoutProps} from "./AdminShellLayout";
15
30
  export {AdminVersionConfig} from "./AdminVersionConfig";
31
+ export {isAdminPageForbiddenError} from "./adminPageAccess";
16
32
  export {groupAdminModelsByGroup} from "./adminShellNav";
17
33
  export {CheckboxListEditor} from "./CheckboxListEditor";
18
34
  export {ConfigurationScreen} from "./ConfigurationScreen";
@@ -20,22 +36,32 @@ export {ConsentFormEditor} from "./ConsentFormEditor";
20
36
  export {ConsentFormList} from "./ConsentFormList";
21
37
  export {ConsentHistory} from "./ConsentHistory";
22
38
  export {ConsentResponseViewer} from "./ConsentResponseViewer";
39
+ export {ADMIN_FILTER_MOBILE_BREAKPOINT, ADMIN_SEARCH_DEBOUNCE_MS} from "./Constants";
23
40
  export {DocumentStorageBrowser} from "./DocumentStorageBrowser";
24
41
  export {generateConsentHistoryPdf} from "./generateConsentHistoryPdf";
25
42
  export {LocaleContentEditor} from "./LocaleContentEditor";
26
43
  export type {
44
+ AdminCapabilities,
27
45
  AdminConfigResponse,
28
46
  AdminCustomScreen,
29
47
  AdminFieldConfig,
48
+ AdminFieldWidgetProps,
49
+ AdminHomeWidgetProps,
30
50
  AdminModelConfig,
51
+ AdminProviderValue,
31
52
  AdminScreenProps,
53
+ AdminScreenWidgetProps,
32
54
  AdminScriptConfig,
55
+ AdminWidgetRegistry,
33
56
  BackgroundTask,
34
57
  DocumentFile,
35
58
  DocumentListResponse,
36
59
  DocumentStorageBrowserProps,
60
+ FieldWidgetComponent,
61
+ HomeWidgetComponent,
37
62
  RefFieldRendererProps,
38
63
  RefRendererMap,
64
+ ScreenWidgetComponent,
39
65
  } from "./types";
40
66
  export {resolveAdminBases, SYSTEM_FIELDS} from "./types";
41
67
  export {useAdminApi} from "./useAdminApi";
@@ -44,3 +70,28 @@ export {useAdminScripts} from "./useAdminScripts";
44
70
  export {useConfigurationApi} from "./useConfigurationApi";
45
71
  export * from "./useConsentHistory";
46
72
  export {useDocumentStorageApi} from "./useDocumentStorageApi";
73
+ export {
74
+ AI_ADMIN_WIDGETS,
75
+ AIRequestsScreenWidget,
76
+ } from "./widgets/AIRequestsScreenWidget";
77
+ export {
78
+ BUILT_IN_FIELD_WIDGETS,
79
+ BUILT_IN_HOME_WIDGETS,
80
+ BUILT_IN_SCREEN_WIDGETS,
81
+ BUILT_IN_WIDGET_REGISTRY,
82
+ mergeWidgetRegistry,
83
+ } from "./widgets/builtInWidgets";
84
+ export {CustomScreensListWidget} from "./widgets/CustomScreensListWidget";
85
+ export {CONSENT_ADMIN_WIDGETS} from "./widgets/consentWidgets";
86
+ export {
87
+ DOCUMENT_STORAGE_ADMIN_WIDGETS,
88
+ DocumentsScreenWidget,
89
+ } from "./widgets/DocumentsScreenWidget";
90
+ export {
91
+ FEATURE_FLAGS_ADMIN_WIDGETS,
92
+ FeatureFlagsOverridesWidget,
93
+ } from "./widgets/FeatureFlagsOverridesWidget";
94
+ export {ModelsGridWidget} from "./widgets/ModelsGridWidget";
95
+ export {RecentActivityWidget} from "./widgets/RecentActivityWidget";
96
+ export {ScriptRunnerWidget} from "./widgets/ScriptRunnerWidget";
97
+ export {VersionConfigWidget} from "./widgets/VersionConfigWidget";
@@ -4,7 +4,7 @@ import {beforeEach, describe, expect, it, mock} from "bun:test";
4
4
  import {renderWithTheme} from "@terreno/ui/src/test-utils";
5
5
  import {act, fireEvent} from "@testing-library/react-native";
6
6
  import React from "react";
7
- import {AdminObjectPicker} from "../AdminObjectPicker";
7
+ import {AdminObjectPicker as BaseAdminObjectPicker} from "../AdminObjectPicker";
8
8
  import type {AdminApi} from "../types";
9
9
 
10
10
  interface ApiState {
@@ -19,6 +19,11 @@ const apiState: ApiState = {
19
19
  selectedItem: undefined,
20
20
  };
21
21
 
22
+ // This suite exercises the search-as-you-type contract explicitly.
23
+ const AdminObjectPicker: React.FC<React.ComponentProps<typeof BaseAdminObjectPicker>> = (
24
+ props
25
+ ): React.ReactElement => <BaseAdminObjectPicker {...props} autocomplete />;
26
+
22
27
  const querySpecs: unknown[] = [];
23
28
  const makeApi = () => ({
24
29
  injectEndpoints: ({endpoints}: {endpoints: (b: unknown) => Record<string, unknown>}) => {
@@ -36,6 +41,7 @@ const makeApi = () => ({
36
41
  const cap = (s: string) => s.charAt(0).toUpperCase() + s.slice(1);
37
42
  const searchKey = keys.find((k) => k.startsWith("adminSearch_"));
38
43
  const readKey = keys.find((k) => k.startsWith("adminSearchRead_"));
44
+ const listKey = keys.find((k) => k.startsWith("adminPickerList_"));
39
45
  const enhanced: Record<string, unknown> = {};
40
46
  if (searchKey) {
41
47
  enhanced[`use${cap(searchKey)}Query`] = (_q: string, opts: Record<string, unknown>) => {
@@ -53,6 +59,9 @@ const makeApi = () => ({
53
59
  return {data: apiState.selectedItem};
54
60
  };
55
61
  }
62
+ if (listKey) {
63
+ enhanced[`use${cap(listKey)}Query`] = () => ({data: undefined, isFetching: false});
64
+ }
56
65
  return enhanced;
57
66
  },
58
67
  });
package/src/types.ts CHANGED
@@ -29,6 +29,11 @@ export type AdminApi = Api<
29
29
  */
30
30
  export type AdminFieldValue = unknown;
31
31
 
32
+ export interface AdminRecordCapabilities {
33
+ delete: boolean;
34
+ update: boolean;
35
+ }
36
+
32
37
  /**
33
38
  * RTK Query's `build` argument from `api.injectEndpoints({ endpoints: (build) => ... })`.
34
39
  *
@@ -82,8 +87,13 @@ export interface AdminModelConfig {
82
87
  * picks a scalar label from common keys (`name`, `title`, …) then the first list column.
83
88
  */
84
89
  recordTitleField?: string;
90
+ /** Fields that use async autocomplete against the model list endpoint (Phase 3+). */
91
+ autocompleteFields?: string[];
92
+ /** Server-side excluded fields (scrubbed from responses; informational for forms). */
93
+ excludeFields?: string[];
85
94
  /** Admin UI v2 — declarative bulk actions */
86
95
  actions?: {
96
+ allowed?: boolean;
87
97
  background?: boolean;
88
98
  confirm?: string;
89
99
  id: string;
@@ -134,12 +144,78 @@ export interface AdminHome {
134
144
  title: string;
135
145
  }
136
146
 
147
+ export interface AdminCapabilities {
148
+ actions: boolean;
149
+ fieldsets: boolean;
150
+ filters: boolean;
151
+ realtime: boolean;
152
+ }
153
+
137
154
  export interface AdminConfigResponse {
155
+ capabilities?: AdminCapabilities;
138
156
  customScreens?: AdminCustomScreen[];
139
157
  home?: AdminHome;
140
158
  models: AdminModelConfig[];
159
+ /** Server-authorized visibility for built-in Platform sidebar tools. */
160
+ platformTools?: {
161
+ configuration: boolean;
162
+ roles: boolean;
163
+ runScripts?: boolean;
164
+ scripts: boolean;
165
+ version: boolean;
166
+ viewScripts?: boolean;
167
+ };
141
168
  schemaVersion?: number;
142
169
  scripts: AdminScriptConfig[];
170
+ /** Plugin home widget ids merged from admin contributions (informational). */
171
+ widgetIds?: string[];
172
+ }
173
+
174
+ /** Props passed to home dashboard widgets resolved from `home.slots`. */
175
+ export interface AdminHomeWidgetProps {
176
+ api: AdminApi;
177
+ apiBase: string;
178
+ routeBase: string;
179
+ config: AdminConfigResponse;
180
+ models: AdminModelConfig[];
181
+ auditModel?: AdminModelConfig;
182
+ featureFlagModel?: AdminModelConfig;
183
+ }
184
+
185
+ /** Props passed to custom admin screen widgets registered in `widgets.screens`. */
186
+ export interface AdminScreenWidgetProps extends AdminScreenProps {
187
+ config: AdminConfigResponse;
188
+ screenName: string;
189
+ }
190
+
191
+ /** Props passed to per-field form widgets registered in `widgets.fields`. */
192
+ export interface AdminFieldWidgetProps extends AdminScreenProps {
193
+ errorText?: string;
194
+ fieldConfig: AdminFieldConfig;
195
+ fieldKey: string;
196
+ modelConfigs?: Array<{name: string; routePath: string}>;
197
+ onChange: (value: AdminFieldValue) => void;
198
+ parentFormState?: Record<string, AdminFieldValue>;
199
+ readOnly?: boolean;
200
+ refRenderers?: RefRendererMap;
201
+ value: AdminFieldValue;
202
+ }
203
+
204
+ export type HomeWidgetComponent = React.FC<AdminHomeWidgetProps>;
205
+ export type ScreenWidgetComponent = React.FC<AdminScreenWidgetProps>;
206
+ export type FieldWidgetComponent = React.FC<AdminFieldWidgetProps>;
207
+
208
+ export interface AdminWidgetRegistry {
209
+ fields: Record<string, FieldWidgetComponent>;
210
+ home: Record<string, HomeWidgetComponent>;
211
+ screens: Record<string, ScreenWidgetComponent>;
212
+ }
213
+
214
+ export interface AdminProviderValue {
215
+ api: AdminApi;
216
+ apiBase: string;
217
+ routeBase: string;
218
+ widgets: AdminWidgetRegistry;
143
219
  }
144
220
 
145
221
  export interface BackgroundTaskProgress {
@@ -251,6 +327,9 @@ export interface RefFieldRendererProps {
251
327
  helperText?: string;
252
328
  /** When true, the picker is display-only and does not submit changes. */
253
329
  readOnly?: boolean;
330
+ /** When true, query the referenced model search endpoint as the user types. */
331
+ autocomplete?: boolean;
332
+ testID?: string;
254
333
  }
255
334
 
256
335
  /**
@@ -0,0 +1,146 @@
1
+ import {useMemo} from "react";
2
+ import {asDynamicHookApi} from "./dynamicHookApi";
3
+ import type {AdminApi, EndpointBuilder} from "./types";
4
+
5
+ export interface RbacRoleRow {
6
+ name: string;
7
+ displayName: string;
8
+ description?: string;
9
+ isLocked?: boolean;
10
+ isSealed?: boolean;
11
+ permissions?: Record<string, string[]>;
12
+ }
13
+
14
+ export interface RbacStatements {
15
+ [resource: string]: readonly string[];
16
+ }
17
+
18
+ export interface RoleInput {
19
+ description?: string | null;
20
+ displayName: string;
21
+ name: string;
22
+ permissions: Record<string, string[]>;
23
+ }
24
+
25
+ interface RoleMutationResult {
26
+ unwrap: () => Promise<unknown>;
27
+ }
28
+
29
+ type CreateRoleMutation = [(input: RoleInput) => RoleMutationResult, {isLoading: boolean}];
30
+
31
+ type UpdateRoleMutation = [
32
+ (input: {changes: Omit<RoleInput, "name">; roleName: string}) => RoleMutationResult,
33
+ {isLoading: boolean},
34
+ ];
35
+
36
+ interface StatementsQueryResult {
37
+ data?: {data?: {statements?: RbacStatements}; statements?: RbacStatements};
38
+ error: unknown;
39
+ isLoading: boolean;
40
+ }
41
+
42
+ /**
43
+ * `@terreno/rtk`'s base query unwraps the `{data}` envelope for non-list responses, so the
44
+ * hook receives a bare array. Apps wiring their own base query may still pass the envelope.
45
+ */
46
+ export type RolesQueryData = RbacRoleRow[] | {data?: RbacRoleRow[]} | undefined;
47
+
48
+ export interface RolesQueryResult {
49
+ data: RolesQueryData;
50
+ isLoading: boolean;
51
+ error: unknown;
52
+ refetch?: () => void;
53
+ }
54
+
55
+ export const normalizeRoles = (data: RolesQueryData): RbacRoleRow[] => {
56
+ if (Array.isArray(data)) {
57
+ return data;
58
+ }
59
+ return data?.data ?? [];
60
+ };
61
+
62
+ const EMPTY_ROLES_HOOK = (): RolesQueryResult => ({
63
+ data: undefined,
64
+ error: null,
65
+ isLoading: false,
66
+ });
67
+
68
+ const EMPTY_STATEMENTS_HOOK = (): StatementsQueryResult => ({
69
+ data: undefined,
70
+ error: null,
71
+ isLoading: false,
72
+ });
73
+
74
+ const unavailableMutation = (): RoleMutationResult => ({
75
+ unwrap: async (): Promise<never> => {
76
+ throw new Error("Role management API is unavailable");
77
+ },
78
+ });
79
+
80
+ const EMPTY_CREATE_MUTATION_HOOK = (): CreateRoleMutation => [
81
+ unavailableMutation,
82
+ {isLoading: false},
83
+ ];
84
+
85
+ const EMPTY_UPDATE_MUTATION_HOOK = (): UpdateRoleMutation => [
86
+ unavailableMutation,
87
+ {isLoading: false},
88
+ ];
89
+
90
+ export const normalizeStatements = (data: StatementsQueryResult["data"]): RbacStatements => {
91
+ return data?.statements ?? data?.data?.statements ?? {};
92
+ };
93
+
94
+ /**
95
+ * Roles are served by `rbacRouter`, which mounts at the API root rather than under the
96
+ * admin base, so the admin base segment is trimmed before building the URL.
97
+ */
98
+ const resolveRbacBase = (apiBase: string): string => apiBase.replace(/\/admin\/?$/, "");
99
+
100
+ export const useAdminRoles = (api: AdminApi, apiBase: string) => {
101
+ const enhancedApi = useMemo(() => {
102
+ // Guard: some call sites (and tests) pass a type-erased API double without
103
+ // `injectEndpoints`. Return null so we can fall back to no-op hooks.
104
+ if (typeof api?.injectEndpoints !== "function") {
105
+ return null;
106
+ }
107
+ return api.injectEndpoints({
108
+ endpoints: (build: EndpointBuilder) => ({
109
+ adminCreateRbacRole: build.mutation({
110
+ query: (body: RoleInput) => ({
111
+ body,
112
+ method: "POST",
113
+ url: `${resolveRbacBase(apiBase)}/rbac/roles`,
114
+ }),
115
+ }),
116
+ adminListRbacRoles: build.query({
117
+ query: () => ({method: "GET", url: `${resolveRbacBase(apiBase)}/rbac/roles`}),
118
+ }),
119
+ adminListRbacStatements: build.query({
120
+ query: () => ({method: "GET", url: `${resolveRbacBase(apiBase)}/rbac/statements`}),
121
+ }),
122
+ adminUpdateRbacRole: build.mutation({
123
+ query: ({changes, roleName}: {changes: Omit<RoleInput, "name">; roleName: string}) => ({
124
+ body: changes,
125
+ method: "PATCH",
126
+ url: `${resolveRbacBase(apiBase)}/rbac/roles/${encodeURIComponent(roleName)}`,
127
+ }),
128
+ }),
129
+ }),
130
+ overrideExisting: true,
131
+ });
132
+ }, [api, apiBase]);
133
+
134
+ const enhanced = asDynamicHookApi(enhancedApi);
135
+
136
+ return {
137
+ useCreateRoleMutation: (enhanced?.useAdminCreateRbacRoleMutation ??
138
+ EMPTY_CREATE_MUTATION_HOOK) as () => CreateRoleMutation,
139
+ useListRolesQuery: (enhanced?.useAdminListRbacRolesQuery ??
140
+ EMPTY_ROLES_HOOK) as () => RolesQueryResult,
141
+ useListStatementsQuery: (enhanced?.useAdminListRbacStatementsQuery ??
142
+ EMPTY_STATEMENTS_HOOK) as () => StatementsQueryResult,
143
+ useUpdateRoleMutation: (enhanced?.useAdminUpdateRbacRoleMutation ??
144
+ EMPTY_UPDATE_MUTATION_HOOK) as () => UpdateRoleMutation,
145
+ };
146
+ };
@@ -4,7 +4,7 @@ import type {AdminApi, EndpointBuilder} from "./types";
4
4
 
5
5
  export const useDocumentStorageApi = (api: AdminApi, basePath: string) => {
6
6
  const enhancedApi = useMemo(() => {
7
- return api.injectEndpoints({
7
+ return api.enhanceEndpoints({addTagTypes: ["documentStorage"]}).injectEndpoints({
8
8
  endpoints: (build: EndpointBuilder) => ({
9
9
  documentStorageCreateFolder: build.mutation({
10
10
  invalidatesTags: ["documentStorage"],
@@ -82,7 +82,7 @@ export const useDocumentStorageApi = (api: AdminApi, basePath: string) => {
82
82
  },
83
83
  }),
84
84
  }),
85
- overrideExisting: false,
85
+ overrideExisting: true,
86
86
  });
87
87
  }, [api, basePath]);
88
88
 
@@ -0,0 +1,93 @@
1
+ import {AIRequestExplorer, type AIRequestExplorerData, Page} from "@terreno/ui";
2
+ import React, {useCallback, useMemo, useState} from "react";
3
+ import {asDynamicHookApi} from "../dynamicHookApi";
4
+ import type {AdminScreenWidgetProps, EndpointBuilder, ScreenWidgetComponent} from "../types";
5
+
6
+ const EXPLORER_LIMIT = 20;
7
+ const AI_REQUESTS_ENDPOINT_KEY = "adminAiRequestsExplorer";
8
+
9
+ interface AIRequestsResponse {
10
+ data: AIRequestExplorerData[];
11
+ limit: number;
12
+ more: boolean;
13
+ page: number;
14
+ total: number;
15
+ }
16
+
17
+ export const AIRequestsScreenWidget: React.FC<AdminScreenWidgetProps> = ({api}) => {
18
+ const [page, setPage] = useState(1);
19
+ const [requestTypeFilter, setRequestTypeFilter] = useState<string[]>([]);
20
+ const [startDate, setStartDate] = useState("");
21
+ const [endDate, setEndDate] = useState("");
22
+
23
+ const enhancedApi = useMemo(
24
+ () =>
25
+ api.injectEndpoints({
26
+ endpoints: (build: EndpointBuilder) => ({
27
+ [AI_REQUESTS_ENDPOINT_KEY]: build.query({
28
+ query: (params: Record<string, unknown>) => ({
29
+ method: "GET",
30
+ params,
31
+ url: "/aiRequestsExplorer",
32
+ }),
33
+ }),
34
+ }),
35
+ overrideExisting: true,
36
+ }),
37
+ [api]
38
+ );
39
+
40
+ const useExplorerQuery = asDynamicHookApi(enhancedApi).useAdminAiRequestsExplorerQuery;
41
+ const {data, isLoading} = useExplorerQuery({
42
+ endDate: endDate || undefined,
43
+ limit: EXPLORER_LIMIT,
44
+ page,
45
+ requestType: requestTypeFilter.length > 0 ? requestTypeFilter.join(",") : undefined,
46
+ startDate: startDate || undefined,
47
+ }) as {data?: AIRequestsResponse; isLoading: boolean};
48
+
49
+ const handlePageChange = useCallback((nextPage: number): void => {
50
+ setPage(nextPage);
51
+ }, []);
52
+
53
+ const handleRequestTypeFilterChange = useCallback((types: string[]): void => {
54
+ setRequestTypeFilter(types);
55
+ setPage(1);
56
+ }, []);
57
+
58
+ const handleStartDateChange = useCallback((value: string): void => {
59
+ setStartDate(value);
60
+ setPage(1);
61
+ }, []);
62
+
63
+ const handleEndDateChange = useCallback((value: string): void => {
64
+ setEndDate(value);
65
+ setPage(1);
66
+ }, []);
67
+
68
+ const total = data?.total ?? 0;
69
+
70
+ return (
71
+ <Page maxWidth="100%" scroll title="AI Request Explorer">
72
+ <AIRequestExplorer
73
+ data={data?.data ?? []}
74
+ endDate={endDate}
75
+ isLoading={isLoading}
76
+ onEndDateChange={handleEndDateChange}
77
+ onPageChange={handlePageChange}
78
+ onRequestTypeFilterChange={handleRequestTypeFilterChange}
79
+ onStartDateChange={handleStartDateChange}
80
+ page={page}
81
+ requestTypeFilter={requestTypeFilter}
82
+ startDate={startDate}
83
+ testID="admin-ai-explorer"
84
+ totalCount={total}
85
+ totalPages={Math.ceil(total / EXPLORER_LIMIT)}
86
+ />
87
+ </Page>
88
+ );
89
+ };
90
+
91
+ export const AI_ADMIN_WIDGETS: Record<string, ScreenWidgetComponent> = {
92
+ "ai-requests": AIRequestsScreenWidget,
93
+ };