@terreno/admin-frontend 57.0.0-beta.1 → 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,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
+ };
@@ -0,0 +1,56 @@
1
+ import {Box, Card, Heading, Text} from "@terreno/ui";
2
+ import type {Href} from "expo-router";
3
+ import {router} from "expo-router";
4
+ import React, {useCallback} from "react";
5
+ import type {AdminCustomScreen, AdminHomeWidgetProps} from "../types";
6
+
7
+ const CustomScreenCard: React.FC<{
8
+ onPress: () => void;
9
+ screen: AdminCustomScreen;
10
+ }> = ({onPress, screen}) => (
11
+ <Card padding={4} testID={`admin-custom-screen-card-${screen.name}`}>
12
+ <Box
13
+ accessibilityHint={`Navigate to ${screen.displayName}`}
14
+ accessibilityLabel={screen.displayName}
15
+ gap={2}
16
+ onClick={onPress}
17
+ width={240}
18
+ >
19
+ <Heading size="md">{screen.displayName}</Heading>
20
+ <Text color="secondaryDark" size="sm">
21
+ {screen.description ?? "Custom screen"}
22
+ </Text>
23
+ </Box>
24
+ </Card>
25
+ );
26
+
27
+ /** Lists custom admin screens from config as navigable cards (tools section). */
28
+ export const CustomScreensListWidget: React.FC<AdminHomeWidgetProps> = ({config, routeBase}) => {
29
+ const screens = config.customScreens ?? [];
30
+
31
+ const onPress = useCallback(
32
+ (screenName: string): void => {
33
+ router.push(`${routeBase}/${screenName}` as Href);
34
+ },
35
+ [routeBase]
36
+ );
37
+
38
+ if (screens.length === 0) {
39
+ return null;
40
+ }
41
+
42
+ return (
43
+ <Box gap={2} testID="admin-home-widget-customScreens" width="100%">
44
+ <Heading size="sm">Screens</Heading>
45
+ <Box direction="row" gap={4} wrap>
46
+ {screens.map((screen) => (
47
+ <CustomScreenCard
48
+ key={screen.name}
49
+ onPress={() => onPress(screen.name)}
50
+ screen={screen}
51
+ />
52
+ ))}
53
+ </Box>
54
+ </Box>
55
+ );
56
+ };
@@ -0,0 +1,11 @@
1
+ import React from "react";
2
+ import {DocumentStorageBrowser} from "../DocumentStorageBrowser";
3
+ import type {AdminScreenWidgetProps, ScreenWidgetComponent} from "../types";
4
+
5
+ export const DocumentsScreenWidget: React.FC<AdminScreenWidgetProps> = ({api}) => {
6
+ return <DocumentStorageBrowser api={api} basePath="/documents" title="Documents" />;
7
+ };
8
+
9
+ export const DOCUMENT_STORAGE_ADMIN_WIDGETS: Record<string, ScreenWidgetComponent> = {
10
+ documents: DocumentsScreenWidget,
11
+ };
@@ -0,0 +1,48 @@
1
+ import {Box, Button, Card, Heading, Text} from "@terreno/ui";
2
+ import type {Href} from "expo-router";
3
+ import {router} from "expo-router";
4
+ import React, {useCallback} from "react";
5
+ import type {AdminHomeWidgetProps, HomeWidgetComponent} from "../types";
6
+
7
+ export const FeatureFlagsOverridesWidget: React.FC<AdminHomeWidgetProps> = ({
8
+ featureFlagModel,
9
+ routeBase,
10
+ }) => {
11
+ const onOpen = useCallback((): void => {
12
+ if (!featureFlagModel) {
13
+ return;
14
+ }
15
+ const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
16
+ router.push(`${prefix}/${featureFlagModel.name}` as Href);
17
+ }, [routeBase, featureFlagModel]);
18
+
19
+ return (
20
+ <Card padding={4} testID="admin-home-widget-feature-flags-overrides">
21
+ <Heading size="sm">Feature flags</Heading>
22
+ {featureFlagModel ? (
23
+ <Box marginTop={2}>
24
+ <Text color="secondaryDark" size="sm">
25
+ Quick access to feature flag records.
26
+ </Text>
27
+ <Box marginTop={2}>
28
+ <Button
29
+ onClick={onOpen}
30
+ text={`Open ${featureFlagModel.displayName}`}
31
+ variant="outline"
32
+ />
33
+ </Box>
34
+ </Box>
35
+ ) : (
36
+ <Box marginTop={2}>
37
+ <Text color="secondaryDark" size="sm">
38
+ No FeatureFlag model is registered in this admin config.
39
+ </Text>
40
+ </Box>
41
+ )}
42
+ </Card>
43
+ );
44
+ };
45
+
46
+ export const FEATURE_FLAGS_ADMIN_WIDGETS: Record<string, HomeWidgetComponent> = {
47
+ "feature-flags-overrides": FeatureFlagsOverridesWidget,
48
+ };
@@ -0,0 +1,17 @@
1
+ import {Box, Text} from "@terreno/ui";
2
+ import React from "react";
3
+
4
+ interface MissingWidgetProps {
5
+ bucket: "fields" | "home" | "screens";
6
+ widgetId: string;
7
+ }
8
+
9
+ export const MissingWidget: React.FC<MissingWidgetProps> = ({bucket, widgetId}) => {
10
+ return (
11
+ <Box border="default" padding={3} rounding="md" testID={`admin-missing-widget-${widgetId}`}>
12
+ <Text color="secondaryDark" size="sm">
13
+ {`Unknown admin ${bucket} widget "${widgetId}". Register it on AdminProvider.widgets.${bucket}.`}
14
+ </Text>
15
+ </Box>
16
+ );
17
+ };
@@ -0,0 +1,94 @@
1
+ import {Box, Card, Heading, IconButton, Spinner, Text} from "@terreno/ui";
2
+ import type {Href} from "expo-router";
3
+ import {router} from "expo-router";
4
+ import React, {useCallback} from "react";
5
+ import type {AdminHomeWidgetProps, AdminModelConfig} from "../types";
6
+ import {useAdminApi} from "../useAdminApi";
7
+
8
+ const ModelGridCard: React.FC<{
9
+ api: AdminHomeWidgetProps["api"];
10
+ model: AdminModelConfig;
11
+ routeBase: string;
12
+ }> = ({api, model, routeBase}) => {
13
+ const {useListQuery} = useAdminApi(api, model.routePath, model.name);
14
+ const {data, isLoading} = useListQuery({limit: 1, page: 1}, {skip: !model.routePath});
15
+ const total = (data as {total?: number} | undefined)?.total;
16
+ const fieldCount = Object.keys(model.fields).length;
17
+ const createEnabled = model.permissions?.create !== false;
18
+
19
+ const onOpen = useCallback((): void => {
20
+ const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
21
+ const href = `${prefix}/${model.name}` as Href;
22
+ router.push(href);
23
+ }, [routeBase, model.name]);
24
+
25
+ const onCreate = useCallback((): void => {
26
+ if (!createEnabled) {
27
+ return;
28
+ }
29
+ const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
30
+ router.push(`${prefix}/${model.name}/create` as Href);
31
+ }, [createEnabled, routeBase, model.name]);
32
+
33
+ return (
34
+ <Box
35
+ accessibilityHint={`Open ${model.displayName} admin`}
36
+ accessibilityLabel={model.displayName}
37
+ border="default"
38
+ padding={3}
39
+ rounding="md"
40
+ width={220}
41
+ >
42
+ <Box alignItems="start" direction="row" gap={2} justifyContent="between">
43
+ <Box
44
+ accessibilityHint={`View ${model.displayName} list`}
45
+ accessibilityLabel={model.displayName}
46
+ flex="grow"
47
+ minWidth={0}
48
+ onClick={onOpen}
49
+ testID={`admin-home-models-grid-${model.name}`}
50
+ >
51
+ <Text bold>{model.displayName}</Text>
52
+ <Text color="secondaryDark" size="sm">
53
+ {`${fieldCount} fields`}
54
+ </Text>
55
+ <Box marginTop={1}>
56
+ {isLoading ? (
57
+ <Spinner />
58
+ ) : (
59
+ <Text
60
+ color="secondaryDark"
61
+ size="sm"
62
+ testID={`admin-home-model-count-${model.name}`}
63
+ >{`${total != null ? total : "—"} rows`}</Text>
64
+ )}
65
+ </Box>
66
+ </Box>
67
+ {createEnabled ? (
68
+ <IconButton
69
+ accessibilityHint={`Create new ${model.displayName}`}
70
+ accessibilityLabel={`Add ${model.displayName}`}
71
+ iconName="plus"
72
+ onClick={onCreate}
73
+ testID={`admin-home-model-add-${model.name}`}
74
+ tooltipText="Add new"
75
+ variant="secondary"
76
+ />
77
+ ) : null}
78
+ </Box>
79
+ </Box>
80
+ );
81
+ };
82
+
83
+ export const ModelsGridWidget: React.FC<AdminHomeWidgetProps> = ({api, models, routeBase}) => {
84
+ return (
85
+ <Card padding={4} testID="admin-home-widget-modelsGrid">
86
+ <Heading size="sm">Models</Heading>
87
+ <Box direction="row" gap={3} marginTop={2} wrap>
88
+ {models.map((m) => (
89
+ <ModelGridCard api={api} key={m.name} model={m} routeBase={routeBase} />
90
+ ))}
91
+ </Box>
92
+ </Card>
93
+ );
94
+ };
@@ -0,0 +1,81 @@
1
+ import {Box, Card, Heading, printDateAndTime, Spinner, Text} from "@terreno/ui";
2
+ import React, {useMemo} from "react";
3
+ import type {AdminFieldValue, AdminHomeWidgetProps} from "../types";
4
+ import {useAdminApi} from "../useAdminApi";
5
+
6
+ export const RecentActivityWidget: React.FC<AdminHomeWidgetProps> = ({api, auditModel}) => {
7
+ const {useListQuery} = useAdminApi(api, auditModel?.routePath ?? "", auditModel?.name ?? "");
8
+ const {data, isLoading, isError} = useListQuery(
9
+ {limit: 8, page: 1, sort: "-createdAt"},
10
+ {skip: !auditModel?.routePath}
11
+ );
12
+
13
+ const rows = useMemo((): Record<string, AdminFieldValue>[] => {
14
+ const body = data as {data?: Record<string, AdminFieldValue>[]} | undefined;
15
+ return Array.isArray(body?.data) ? body.data : [];
16
+ }, [data]);
17
+
18
+ if (!auditModel) {
19
+ return (
20
+ <Card padding={4} testID="admin-home-widget-recentActivity">
21
+ <Heading size="sm">Recent activity</Heading>
22
+ <Box marginTop={2}>
23
+ <Text color="secondaryDark" size="sm">
24
+ Register an AdminAuditLog model to show recent mutations here.
25
+ </Text>
26
+ </Box>
27
+ </Card>
28
+ );
29
+ }
30
+
31
+ return (
32
+ <Card padding={4} testID="admin-home-widget-recentActivity">
33
+ <Heading size="sm">Recent activity</Heading>
34
+ {isLoading ? (
35
+ <Box alignItems="center" marginTop={3} padding={2}>
36
+ <Spinner />
37
+ </Box>
38
+ ) : null}
39
+ {isError ? (
40
+ <Box marginTop={2}>
41
+ <Text color="error" size="sm">
42
+ Could not load audit entries.
43
+ </Text>
44
+ </Box>
45
+ ) : null}
46
+ {!isLoading && !isError && rows.length === 0 ? (
47
+ <Box marginTop={2}>
48
+ <Text color="secondaryDark" size="sm">
49
+ No audit entries yet.
50
+ </Text>
51
+ </Box>
52
+ ) : null}
53
+ {!isLoading && !isError && rows.length > 0 ? (
54
+ <Box gap={2} marginTop={2}>
55
+ {rows.map((row) => {
56
+ const id = String(row._id ?? row.id ?? "");
57
+ const verb = String(row.verb ?? "");
58
+ const modelName = String(row.modelName ?? "");
59
+ const label = String(row.recordLabel ?? row.recordId ?? "");
60
+ const created = row.createdAt ?? row.created;
61
+ const when =
62
+ typeof created === "string" ? printDateAndTime(created, {defaultValue: created}) : "";
63
+ return (
64
+ <Box border="default" key={id || `${verb}-${label}`} padding={2} rounding="sm">
65
+ <Text size="sm">
66
+ <Text bold>{verb}</Text> {modelName}
67
+ {label ? ` — ${label}` : ""}
68
+ </Text>
69
+ {when ? (
70
+ <Text color="secondaryDark" size="sm">
71
+ {when}
72
+ </Text>
73
+ ) : null}
74
+ </Box>
75
+ );
76
+ })}
77
+ </Box>
78
+ ) : null}
79
+ </Card>
80
+ );
81
+ };
@@ -0,0 +1,26 @@
1
+ import {Box, Button, Card, Heading, Text} from "@terreno/ui";
2
+ import type {Href} from "expo-router";
3
+ import {router} from "expo-router";
4
+ import React, {useCallback} from "react";
5
+ import type {AdminHomeWidgetProps} from "../types";
6
+
7
+ export const ScriptRunnerWidget: React.FC<AdminHomeWidgetProps> = ({routeBase}) => {
8
+ const onScripts = useCallback((): void => {
9
+ const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
10
+ router.push(`${prefix}/__scripts` as Href);
11
+ }, [routeBase]);
12
+
13
+ return (
14
+ <Card padding={4} testID="admin-home-widget-scriptRunner">
15
+ <Heading size="sm">Scripts</Heading>
16
+ <Box marginTop={1}>
17
+ <Text color="secondaryDark" size="sm">
18
+ Run registered admin maintenance scripts.
19
+ </Text>
20
+ </Box>
21
+ <Box marginTop={2}>
22
+ <Button onClick={onScripts} text="Open scripts" variant="primary" />
23
+ </Box>
24
+ </Card>
25
+ );
26
+ };
@@ -0,0 +1,12 @@
1
+ import {AdminVersionConfig} from "../AdminVersionConfig";
2
+ import type {AdminScreenWidgetProps} from "../types";
3
+
4
+ /** Full-page version config screen (`version-config` route). */
5
+ export const VersionConfigScreenWidget: React.FC<AdminScreenWidgetProps> = ({
6
+ api,
7
+ apiBase,
8
+ baseUrl,
9
+ routeBase,
10
+ }) => {
11
+ return <AdminVersionConfig api={api} apiBase={apiBase} baseUrl={baseUrl} routeBase={routeBase} />;
12
+ };
@@ -0,0 +1,7 @@
1
+ import {AdminVersionConfig} from "../AdminVersionConfig";
2
+ import type {AdminHomeWidgetProps} from "../types";
3
+
4
+ /** Home-slot wrapper around the version config editor (embedded panel). */
5
+ export const VersionConfigWidget: React.FC<AdminHomeWidgetProps> = ({api, apiBase, routeBase}) => {
6
+ return <AdminVersionConfig api={api} apiBase={apiBase} embedded routeBase={routeBase} />;
7
+ };