@terreno/admin-frontend 57.0.0 → 57.1.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 (150) 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 +15 -3
  16. package/dist/AdminModelForm.js.map +1 -1
  17. package/dist/AdminModelList.d.ts +2 -1
  18. package/dist/AdminModelList.js +2 -0
  19. package/dist/AdminModelList.js.map +1 -1
  20. package/dist/AdminModelTable.js +54 -97
  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 +126 -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/AdminShell.d.ts +2 -0
  43. package/dist/AdminShell.js +53 -19
  44. package/dist/AdminShell.js.map +1 -1
  45. package/dist/Constants.d.ts +4 -0
  46. package/dist/Constants.js +5 -0
  47. package/dist/Constants.js.map +1 -0
  48. package/dist/adminModelListQueryParams.d.ts +4 -0
  49. package/dist/adminModelListQueryParams.js +38 -3
  50. package/dist/adminModelListQueryParams.js.map +1 -1
  51. package/dist/index.d.ts +19 -1
  52. package/dist/index.js +17 -0
  53. package/dist/index.js.map +1 -1
  54. package/dist/types.d.ts +61 -0
  55. package/dist/types.js.map +1 -1
  56. package/dist/useAdminRoles.d.ts +65 -0
  57. package/dist/useAdminRoles.js +84 -0
  58. package/dist/useAdminRoles.js.map +1 -0
  59. package/dist/useDocumentStorageApi.js +2 -2
  60. package/dist/useDocumentStorageApi.js.map +1 -1
  61. package/dist/widgets/AIRequestsScreenWidget.d.ts +4 -0
  62. package/dist/widgets/AIRequestsScreenWidget.js +54 -0
  63. package/dist/widgets/AIRequestsScreenWidget.js.map +1 -0
  64. package/dist/widgets/CustomScreensListWidget.d.ts +4 -0
  65. package/dist/widgets/CustomScreensListWidget.js +21 -0
  66. package/dist/widgets/CustomScreensListWidget.js.map +1 -0
  67. package/dist/widgets/DocumentsScreenWidget.d.ts +4 -0
  68. package/dist/widgets/DocumentsScreenWidget.js +9 -0
  69. package/dist/widgets/DocumentsScreenWidget.js.map +1 -0
  70. package/dist/widgets/FeatureFlagsOverridesWidget.d.ts +4 -0
  71. package/dist/widgets/FeatureFlagsOverridesWidget.js +18 -0
  72. package/dist/widgets/FeatureFlagsOverridesWidget.js.map +1 -0
  73. package/dist/widgets/MissingWidget.d.ts +7 -0
  74. package/dist/widgets/MissingWidget.js +6 -0
  75. package/dist/widgets/MissingWidget.js.map +1 -0
  76. package/dist/widgets/ModelsGridWidget.d.ts +3 -0
  77. package/dist/widgets/ModelsGridWidget.js +30 -0
  78. package/dist/widgets/ModelsGridWidget.js.map +1 -0
  79. package/dist/widgets/RecentActivityWidget.d.ts +3 -0
  80. package/dist/widgets/RecentActivityWidget.js +27 -0
  81. package/dist/widgets/RecentActivityWidget.js.map +1 -0
  82. package/dist/widgets/ScriptRunnerWidget.d.ts +3 -0
  83. package/dist/widgets/ScriptRunnerWidget.js +12 -0
  84. package/dist/widgets/ScriptRunnerWidget.js.map +1 -0
  85. package/dist/widgets/VersionConfigScreenWidget.d.ts +3 -0
  86. package/dist/widgets/VersionConfigScreenWidget.js +7 -0
  87. package/dist/widgets/VersionConfigScreenWidget.js.map +1 -0
  88. package/dist/widgets/VersionConfigWidget.d.ts +3 -0
  89. package/dist/widgets/VersionConfigWidget.js +7 -0
  90. package/dist/widgets/VersionConfigWidget.js.map +1 -0
  91. package/dist/widgets/builtInFieldWidgets.d.ts +7 -0
  92. package/dist/widgets/builtInFieldWidgets.js +61 -0
  93. package/dist/widgets/builtInFieldWidgets.js.map +1 -0
  94. package/dist/widgets/builtInWidgets.d.ts +6 -0
  95. package/dist/widgets/builtInWidgets.js +31 -0
  96. package/dist/widgets/builtInWidgets.js.map +1 -0
  97. package/dist/widgets/consentWidgets.d.ts +3 -0
  98. package/dist/widgets/consentWidgets.js +8 -0
  99. package/dist/widgets/consentWidgets.js.map +1 -0
  100. package/dist/widgets/homeWidgetUtils.d.ts +3 -0
  101. package/dist/widgets/homeWidgetUtils.js +37 -0
  102. package/dist/widgets/homeWidgetUtils.js.map +1 -0
  103. package/package.json +3 -2
  104. package/src/AdminActionMenu.test.tsx +78 -0
  105. package/src/AdminActionMenu.tsx +106 -0
  106. package/src/AdminFieldRenderer.tsx +2 -0
  107. package/src/AdminFieldRendererCore.tsx +54 -133
  108. package/src/AdminFilterDrawer.test.tsx +89 -0
  109. package/src/AdminFilterDrawer.tsx +333 -0
  110. package/src/AdminHome.tsx +38 -325
  111. package/src/AdminModelForm.test.tsx +45 -0
  112. package/src/AdminModelForm.tsx +24 -1
  113. package/src/AdminModelList.tsx +4 -1
  114. package/src/AdminModelTable.test.tsx +73 -0
  115. package/src/AdminModelTable.tsx +105 -194
  116. package/src/AdminObjectPicker.tsx +49 -9
  117. package/src/AdminPrimitiveArrayField.tsx +5 -0
  118. package/src/AdminProvider.test.tsx +25 -0
  119. package/src/AdminProvider.tsx +121 -0
  120. package/src/AdminRefField.tsx +4 -0
  121. package/src/AdminRolesField.tsx +129 -0
  122. package/src/AdminRolesList.test.tsx +257 -0
  123. package/src/AdminRolesList.tsx +311 -0
  124. package/src/AdminScreenRouter.test.tsx +112 -0
  125. package/src/AdminScreenRouter.tsx +104 -0
  126. package/src/AdminShell.test.tsx +107 -1
  127. package/src/AdminShell.tsx +143 -67
  128. package/src/Constants.ts +5 -0
  129. package/src/adminModelListQueryParams.test.ts +69 -0
  130. package/src/adminModelListQueryParams.ts +49 -3
  131. package/src/index.tsx +50 -0
  132. package/src/isolated/AdminObjectPicker.isolated.tsx +10 -1
  133. package/src/types.ts +65 -0
  134. package/src/useAdminRoles.ts +146 -0
  135. package/src/useDocumentStorageApi.ts +2 -2
  136. package/src/widgets/AIRequestsScreenWidget.tsx +93 -0
  137. package/src/widgets/CustomScreensListWidget.tsx +56 -0
  138. package/src/widgets/DocumentsScreenWidget.tsx +11 -0
  139. package/src/widgets/FeatureFlagsOverridesWidget.tsx +48 -0
  140. package/src/widgets/MissingWidget.tsx +17 -0
  141. package/src/widgets/ModelsGridWidget.tsx +94 -0
  142. package/src/widgets/RecentActivityWidget.tsx +81 -0
  143. package/src/widgets/ScriptRunnerWidget.tsx +26 -0
  144. package/src/widgets/VersionConfigScreenWidget.tsx +12 -0
  145. package/src/widgets/VersionConfigWidget.tsx +7 -0
  146. package/src/widgets/builtInFieldWidgets.tsx +180 -0
  147. package/src/widgets/builtInWidgets.ts +51 -0
  148. package/src/widgets/consentWidgets.ts +13 -0
  149. package/src/widgets/homeWidgetUtils.ts +38 -0
  150. package/src/widgets/pluginWidgets.test.tsx +29 -0
@@ -0,0 +1,121 @@
1
+ import React, {createContext, useContext, useEffect, useMemo, useRef} from "react";
2
+ import type {
3
+ AdminProviderValue,
4
+ AdminScreenProps,
5
+ AdminWidgetRegistry,
6
+ FieldWidgetComponent,
7
+ HomeWidgetComponent,
8
+ ScreenWidgetComponent,
9
+ } from "./types";
10
+ import {resolveAdminBases} from "./types";
11
+ import {BUILT_IN_WIDGET_REGISTRY, mergeWidgetRegistry} from "./widgets/builtInWidgets";
12
+
13
+ const AdminWidgetContext = createContext<AdminProviderValue | null>(null);
14
+
15
+ const warnedMissingWidgets = new Set<string>();
16
+
17
+ const missingKey = (bucket: string, id: string): string => `${bucket}:${id}`;
18
+
19
+ const warnMissingWidget = (bucket: "fields" | "home" | "screens", widgetId: string): void => {
20
+ const key = missingKey(bucket, widgetId);
21
+ if (warnedMissingWidgets.has(key)) {
22
+ return;
23
+ }
24
+ warnedMissingWidgets.add(key);
25
+ if (typeof __DEV__ !== "undefined" && __DEV__) {
26
+ console.warn(
27
+ `[AdminProvider] Unknown admin ${bucket} widget "${widgetId}". Register it on AdminProvider.widgets.${bucket}.`
28
+ );
29
+ }
30
+ };
31
+
32
+ /** @internal Test helper — clears one-time missing-widget warnings. */
33
+ export const resetAdminWidgetWarningsForTests = (): void => {
34
+ warnedMissingWidgets.clear();
35
+ };
36
+
37
+ export interface AdminProviderProps extends AdminScreenProps {
38
+ children: React.ReactNode;
39
+ widgets?: Partial<AdminWidgetRegistry>;
40
+ }
41
+
42
+ export const AdminProvider: React.FC<AdminProviderProps> = ({
43
+ children,
44
+ api,
45
+ baseUrl,
46
+ apiBase,
47
+ routeBase,
48
+ widgets: userWidgets,
49
+ }) => {
50
+ const bases = resolveAdminBases({apiBase, baseUrl, routeBase});
51
+ const mergedWidgets = useMemo(() => mergeWidgetRegistry(userWidgets), [userWidgets]);
52
+ const value = useMemo(
53
+ (): AdminProviderValue => ({
54
+ api,
55
+ apiBase: bases.apiBase,
56
+ routeBase: bases.routeBase,
57
+ widgets: mergedWidgets,
58
+ }),
59
+ [api, bases.apiBase, bases.routeBase, mergedWidgets]
60
+ );
61
+
62
+ return <AdminWidgetContext.Provider value={value}>{children}</AdminWidgetContext.Provider>;
63
+ };
64
+
65
+ export const useAdminContext = (): AdminProviderValue | null => {
66
+ return useContext(AdminWidgetContext);
67
+ };
68
+
69
+ export const useAdminWidgetRegistry = (): AdminWidgetRegistry => {
70
+ const ctx = useAdminContext();
71
+ return ctx?.widgets ?? BUILT_IN_WIDGET_REGISTRY;
72
+ };
73
+
74
+ export const useHomeWidget = (widgetId: string): HomeWidgetComponent | undefined => {
75
+ const registry = useAdminWidgetRegistry();
76
+ const widget = registry.home[widgetId];
77
+ if (!widget) {
78
+ warnMissingWidget("home", widgetId);
79
+ }
80
+ return widget;
81
+ };
82
+
83
+ export const useScreenWidget = (screenName: string): ScreenWidgetComponent | undefined => {
84
+ const registry = useAdminWidgetRegistry();
85
+ const widget = registry.screens[screenName];
86
+ if (!widget) {
87
+ warnMissingWidget("screens", screenName);
88
+ }
89
+ return widget;
90
+ };
91
+
92
+ export const useFieldWidget = (widgetKey: string | undefined): FieldWidgetComponent | undefined => {
93
+ if (!widgetKey) {
94
+ return undefined;
95
+ }
96
+ const registry = useAdminWidgetRegistry();
97
+ const widget = registry.fields[widgetKey];
98
+ if (!widget) {
99
+ warnMissingWidget("fields", widgetKey);
100
+ }
101
+ return widget;
102
+ };
103
+
104
+ /** Warn once when legacy `customScreens` prop is used alongside AdminProvider. */
105
+ export const useDeprecatedCustomScreensProp = (customScreens?: unknown[]): void => {
106
+ const ctx = useAdminContext();
107
+ const warnedRef = useRef(false);
108
+ useEffect(() => {
109
+ if (warnedRef.current || !ctx) {
110
+ return;
111
+ }
112
+ if (customScreens && customScreens.length > 0) {
113
+ warnedRef.current = true;
114
+ if (typeof __DEV__ !== "undefined" && __DEV__) {
115
+ console.warn(
116
+ "[admin] AdminModelList customScreens prop is deprecated when using AdminProvider. Register screens via widgets.screens instead."
117
+ );
118
+ }
119
+ }
120
+ }, [ctx, customScreens]);
121
+ };
@@ -18,16 +18,20 @@ export const AdminRefField: React.FC<RefFieldRendererProps> = ({
18
18
  errorText,
19
19
  helperText,
20
20
  readOnly,
21
+ autocomplete = false,
22
+ testID,
21
23
  }) => {
22
24
  return (
23
25
  <AdminObjectPicker
24
26
  api={api}
27
+ autocomplete={autocomplete}
25
28
  errorText={errorText}
26
29
  helperText={helperText}
27
30
  onChange={onChange}
28
31
  readOnly={readOnly}
29
32
  refModelName={refModelName}
30
33
  routePath={routePath}
34
+ testID={testID}
31
35
  title={title}
32
36
  value={value}
33
37
  />
@@ -0,0 +1,129 @@
1
+ import {Badge, Box, IconButton, SelectField, Spinner, Text} from "@terreno/ui";
2
+ import React, {useCallback, useMemo} from "react";
3
+ import type {AdminFieldWidgetProps} from "./types";
4
+ import {resolveAdminBases} from "./types";
5
+ import {normalizeRoles, useAdminRoles} from "./useAdminRoles";
6
+
7
+ const roleNamesFromValue = (value: unknown): string[] => {
8
+ if (!Array.isArray(value)) {
9
+ return [];
10
+ }
11
+ return value.filter((roleName): roleName is string => typeof roleName === "string");
12
+ };
13
+
14
+ /**
15
+ * User-role editor backed by the RBAC role collection.
16
+ *
17
+ * Existing assignments remain visible and removable while the select only offers roles that
18
+ * are not already assigned.
19
+ */
20
+ export const AdminRolesField: React.FC<AdminFieldWidgetProps> = ({
21
+ api,
22
+ apiBase,
23
+ baseUrl,
24
+ errorText,
25
+ fieldConfig,
26
+ onChange,
27
+ readOnly,
28
+ value,
29
+ }) => {
30
+ const {apiBase: resolvedApiBase} = resolveAdminBases({apiBase, baseUrl});
31
+ const {useListRolesQuery} = useAdminRoles(api, resolvedApiBase);
32
+ const {data, error, isLoading} = useListRolesQuery();
33
+ const roles = normalizeRoles(data);
34
+ const selectedRoleNames = roleNamesFromValue(value);
35
+ const selectedRoleSet = useMemo(() => new Set(selectedRoleNames), [selectedRoleNames]);
36
+ const roleLabels = useMemo(
37
+ () => new Map(roles.map((role) => [role.name, role.displayName])),
38
+ [roles]
39
+ );
40
+ const availableOptions = useMemo(
41
+ () =>
42
+ roles
43
+ .filter((role) => !selectedRoleSet.has(role.name))
44
+ .map((role) => ({label: role.displayName || role.name, value: role.name})),
45
+ [roles, selectedRoleSet]
46
+ );
47
+
48
+ const handleAddRole = useCallback(
49
+ (roleName: string): void => {
50
+ if (!roleName || selectedRoleSet.has(roleName)) {
51
+ return;
52
+ }
53
+ onChange([...selectedRoleNames, roleName]);
54
+ },
55
+ [onChange, selectedRoleNames, selectedRoleSet]
56
+ );
57
+
58
+ const handleRemoveRole = useCallback(
59
+ (roleName: string): void => {
60
+ onChange(selectedRoleNames.filter((selectedRoleName) => selectedRoleName !== roleName));
61
+ },
62
+ [onChange, selectedRoleNames]
63
+ );
64
+
65
+ return (
66
+ <Box gap={2} testID="admin-field-roles">
67
+ <Text bold color="primary">
68
+ Roles
69
+ </Text>
70
+ {selectedRoleNames.length === 0 ? (
71
+ <Text color="secondaryDark" size="sm">
72
+ No roles assigned.
73
+ </Text>
74
+ ) : (
75
+ <Box gap={1}>
76
+ {selectedRoleNames.map((roleName) => (
77
+ <Box
78
+ alignItems="center"
79
+ direction="row"
80
+ gap={2}
81
+ justifyContent="between"
82
+ key={roleName}
83
+ testID={`admin-field-roles-selected-${roleName}`}
84
+ >
85
+ <Badge value={roleLabels.get(roleName) ?? roleName} />
86
+ {!readOnly ? (
87
+ <IconButton
88
+ accessibilityHint={`Removes the ${roleLabels.get(roleName) ?? roleName} role`}
89
+ accessibilityLabel={`Remove ${roleLabels.get(roleName) ?? roleName}`}
90
+ iconName="xmark"
91
+ onClick={() => handleRemoveRole(roleName)}
92
+ testID={`admin-field-roles-remove-${roleName}`}
93
+ variant="muted"
94
+ />
95
+ ) : null}
96
+ </Box>
97
+ ))}
98
+ </Box>
99
+ )}
100
+ {isLoading ? (
101
+ <Box alignItems="center" padding={2} testID="admin-field-roles-loading">
102
+ <Spinner />
103
+ </Box>
104
+ ) : null}
105
+ {error ? (
106
+ <Text color="error" size="sm" testID="admin-field-roles-load-error">
107
+ Failed to load available roles.
108
+ </Text>
109
+ ) : null}
110
+ {!readOnly && !isLoading && !error ? (
111
+ <SelectField
112
+ disabled={availableOptions.length === 0}
113
+ errorText={errorText}
114
+ helperText={
115
+ availableOptions.length === 0
116
+ ? "All available roles are assigned."
117
+ : fieldConfig.description
118
+ }
119
+ onChange={handleAddRole}
120
+ options={availableOptions}
121
+ placeholder="Select a role to add"
122
+ testID="admin-field-roles-add"
123
+ title="Add role"
124
+ value=""
125
+ />
126
+ ) : null}
127
+ </Box>
128
+ );
129
+ };
@@ -0,0 +1,257 @@
1
+ // noExplicitAny: test mocks use type-erased RTK Query API doubles and dynamic mock returns
2
+ // biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
3
+ import {beforeEach, describe, expect, it, mock} from "bun:test";
4
+ import {SelectField} from "@terreno/ui";
5
+ import {renderWithTheme} from "@terreno/ui/src/test-utils";
6
+ import {act, fireEvent} from "@testing-library/react-native";
7
+ import React from "react";
8
+ import {AdminRolesField} from "./AdminRolesField";
9
+ import {AdminRolesList} from "./AdminRolesList";
10
+ import type {AdminApi} from "./types";
11
+ import {normalizeRoles, normalizeStatements, type RolesQueryResult} from "./useAdminRoles";
12
+
13
+ const mockUseListRolesQuery = mock(
14
+ (): RolesQueryResult => ({data: undefined, error: null, isLoading: false})
15
+ );
16
+ const mockRefetch = mock(() => {});
17
+ const mockCreateRole = mock(() => ({unwrap: async () => ({})}));
18
+ const mockUpdateRole = mock(() => ({unwrap: async () => ({})}));
19
+ const mockUseListStatementsQuery = mock(() => ({
20
+ data: {statements: {admin: ["access", "runScripts"], todo: ["read", "update"]}},
21
+ error: null,
22
+ isLoading: false,
23
+ }));
24
+
25
+ mock.module("./useAdminRoles", () => ({
26
+ normalizeRoles,
27
+ normalizeStatements,
28
+ useAdminRoles: () => ({
29
+ useCreateRoleMutation: () => [mockCreateRole, {isLoading: false}],
30
+ useListRolesQuery: mockUseListRolesQuery,
31
+ useListStatementsQuery: mockUseListStatementsQuery,
32
+ useUpdateRoleMutation: () => [mockUpdateRole, {isLoading: false}],
33
+ }),
34
+ }));
35
+
36
+ const mockApi = {} as unknown as AdminApi;
37
+
38
+ interface RenderedNode {
39
+ props?: {testID?: unknown};
40
+ children?: unknown[];
41
+ }
42
+
43
+ const collectTestIDs = (node: unknown): string[] => {
44
+ const rendered = node as RenderedNode | null;
45
+ const own = typeof rendered?.props?.testID === "string" ? [rendered.props.testID] : [];
46
+ const children = Array.isArray(rendered?.children) ? rendered.children : [];
47
+ return [...own, ...children.flatMap((child) => collectTestIDs(child))];
48
+ };
49
+
50
+ const ROLES = [
51
+ {displayName: "Super Admin", isLocked: true, isSealed: true, name: "superadmin"},
52
+ {description: "Baseline role for signed-up users", displayName: "Todo User", name: "todoUser"},
53
+ ];
54
+
55
+ describe("AdminRolesList", () => {
56
+ beforeEach(() => {
57
+ mockUseListRolesQuery.mockClear();
58
+ mockCreateRole.mockClear();
59
+ mockUpdateRole.mockClear();
60
+ mockUseListStatementsQuery.mockClear();
61
+ mockUseListStatementsQuery.mockClear();
62
+ mockUseListRolesQuery.mockReturnValue({
63
+ data: undefined,
64
+ error: null,
65
+ isLoading: false,
66
+ refetch: mockRefetch,
67
+ });
68
+ });
69
+
70
+ it("renders a spinner while loading", () => {
71
+ mockUseListRolesQuery.mockReturnValue({data: undefined, error: null, isLoading: true});
72
+
73
+ const {getByTestId} = renderWithTheme(<AdminRolesList api={mockApi} apiBase="/admin" />);
74
+
75
+ expect(getByTestId("admin-roles-loading")).toBeTruthy();
76
+ });
77
+
78
+ it("renders an error state when the request fails", () => {
79
+ mockUseListRolesQuery.mockReturnValue({
80
+ data: undefined,
81
+ error: new Error("boom"),
82
+ isLoading: false,
83
+ });
84
+
85
+ const {getByTestId} = renderWithTheme(<AdminRolesList api={mockApi} apiBase="/admin" />);
86
+
87
+ expect(getByTestId("admin-roles-error")).toBeTruthy();
88
+ });
89
+
90
+ it("renders roles returned as a bare array", () => {
91
+ mockUseListRolesQuery.mockReturnValue({data: ROLES, error: null, isLoading: false});
92
+
93
+ const {getByTestId, getByText} = renderWithTheme(
94
+ <AdminRolesList api={mockApi} apiBase="/admin" />
95
+ );
96
+
97
+ expect(getByTestId("admin-roles-item-superadmin")).toBeTruthy();
98
+ expect(getByTestId("admin-roles-item-todoUser")).toBeTruthy();
99
+ expect(getByText("Super Admin")).toBeTruthy();
100
+ expect(getByText("Todo User")).toBeTruthy();
101
+ });
102
+
103
+ it("lists available permissions and exposes role creation", () => {
104
+ mockUseListRolesQuery.mockReturnValue({
105
+ data: ROLES,
106
+ error: null,
107
+ isLoading: false,
108
+ refetch: mockRefetch,
109
+ });
110
+ const {getByTestId, getByText} = renderWithTheme(
111
+ <AdminRolesList api={mockApi} apiBase="/admin" />
112
+ );
113
+
114
+ expect(getByTestId("admin-permissions-list")).toBeTruthy();
115
+ expect(getByText("admin:runScripts")).toBeTruthy();
116
+ expect(getByTestId("admin-roles-add-button")).toBeTruthy();
117
+ });
118
+
119
+ it("enables editing for non-sealed roles and disables sealed roles", () => {
120
+ mockUseListRolesQuery.mockReturnValue({
121
+ data: ROLES,
122
+ error: null,
123
+ isLoading: false,
124
+ refetch: mockRefetch,
125
+ });
126
+ const {getByTestId} = renderWithTheme(<AdminRolesList api={mockApi} apiBase="/admin" />);
127
+
128
+ expect(getByTestId("admin-roles-edit-todoUser").props.disabled).toBeFalsy();
129
+ expect(getByTestId("admin-roles-edit-superadmin").props.disabled).toBeTruthy();
130
+ });
131
+
132
+ it("scrolls the role list body while keeping the add button outside the scroll area", () => {
133
+ mockUseListRolesQuery.mockReturnValue({
134
+ data: ROLES,
135
+ error: null,
136
+ isLoading: false,
137
+ refetch: mockRefetch,
138
+ });
139
+ const {getByTestId} = renderWithTheme(<AdminRolesList api={mockApi} apiBase="/admin" />);
140
+
141
+ const scrollArea = getByTestId("admin-roles-scroll");
142
+ expect(scrollArea).toBeTruthy();
143
+
144
+ const scrollTestIDs = collectTestIDs(scrollArea);
145
+ expect(scrollTestIDs).toContain("admin-roles-item-superadmin");
146
+ expect(scrollTestIDs).toContain("admin-permissions-list");
147
+ expect(scrollTestIDs).not.toContain("admin-roles-add-button");
148
+ });
149
+
150
+ it("renders roles returned inside a data envelope", () => {
151
+ mockUseListRolesQuery.mockReturnValue({data: {data: ROLES}, error: null, isLoading: false});
152
+
153
+ const {getByTestId} = renderWithTheme(<AdminRolesList api={mockApi} apiBase="/admin" />);
154
+
155
+ expect(getByTestId("admin-roles-item-superadmin")).toBeTruthy();
156
+ });
157
+
158
+ it("renders an empty state when there are no roles", () => {
159
+ mockUseListRolesQuery.mockReturnValue({data: [], error: null, isLoading: false});
160
+
161
+ const {getByText} = renderWithTheme(<AdminRolesList api={mockApi} apiBase="/admin" />);
162
+
163
+ expect(getByText("No roles found.")).toBeTruthy();
164
+ });
165
+ });
166
+
167
+ describe("AdminRolesField", () => {
168
+ const fieldConfig = {
169
+ description: "Roles assigned to this user",
170
+ itemType: "string",
171
+ required: false,
172
+ type: "array",
173
+ };
174
+
175
+ beforeEach(() => {
176
+ mockUseListRolesQuery.mockReturnValue({
177
+ data: [
178
+ {displayName: "Admin", name: "admin"},
179
+ {displayName: "Manager", name: "manager"},
180
+ {displayName: "Member", name: "member"},
181
+ ],
182
+ error: null,
183
+ isLoading: false,
184
+ });
185
+ });
186
+
187
+ it("offers unassigned existing roles in an Add role dropdown", () => {
188
+ const onChange = mock((_value: unknown) => undefined);
189
+ const {getByTestId, UNSAFE_root} = renderWithTheme(
190
+ <AdminRolesField
191
+ api={mockApi}
192
+ apiBase="/admin"
193
+ fieldConfig={fieldConfig}
194
+ fieldKey="roles"
195
+ onChange={onChange}
196
+ value={["member"]}
197
+ />
198
+ );
199
+
200
+ expect(getByTestId("admin-field-roles-selected-member")).toBeTruthy();
201
+ const roleSelect = UNSAFE_root.findByType(SelectField);
202
+ expect(roleSelect.props.title).toBe("Add role");
203
+ expect(roleSelect.props.options).toEqual([
204
+ {label: "Admin", value: "admin"},
205
+ {label: "Manager", value: "manager"},
206
+ ]);
207
+
208
+ act(() => {
209
+ roleSelect.props.onChange("manager");
210
+ });
211
+ expect(onChange).toHaveBeenCalledWith(["member", "manager"]);
212
+ });
213
+
214
+ it("removes an assigned role without changing other assignments", async () => {
215
+ const onChange = mock((_value: unknown) => undefined);
216
+ const {getByTestId} = renderWithTheme(
217
+ <AdminRolesField
218
+ api={mockApi}
219
+ apiBase="/admin"
220
+ fieldConfig={fieldConfig}
221
+ fieldKey="roles"
222
+ onChange={onChange}
223
+ value={["admin", "member"]}
224
+ />
225
+ );
226
+
227
+ await act(async () => {
228
+ fireEvent.press(getByTestId("admin-field-roles-remove-admin"));
229
+ });
230
+
231
+ expect(onChange).toHaveBeenCalledWith(["member"]);
232
+ });
233
+ });
234
+
235
+ describe("normalizeRoles", () => {
236
+ it("returns a bare array unchanged", () => {
237
+ expect(normalizeRoles(ROLES)).toEqual(ROLES);
238
+ });
239
+
240
+ it("unwraps a data envelope", () => {
241
+ expect(normalizeRoles({data: ROLES})).toEqual(ROLES);
242
+ });
243
+
244
+ it("falls back to an empty array", () => {
245
+ expect(normalizeRoles(undefined)).toEqual([]);
246
+ expect(normalizeRoles({})).toEqual([]);
247
+ });
248
+ });
249
+
250
+ describe("normalizeStatements", () => {
251
+ it("normalizes direct and enveloped statement responses", () => {
252
+ const statements = {todo: ["read", "update"]};
253
+ expect(normalizeStatements({statements})).toEqual(statements);
254
+ expect(normalizeStatements({data: {statements}})).toEqual(statements);
255
+ expect(normalizeStatements(undefined)).toEqual({});
256
+ });
257
+ });