datastake-daf 0.6.711 → 0.6.713

package/src/@daf/hooks/useAdminDashboard.js

@@ -0,0 +1,84 @@
+import { useState, useEffect, useCallback } from "react";
+
+/**
+ * Generic hook for fetching admin dashboard data
+ * 
+ * @param {Object} config - Configuration object
+ * @param {Object} config.dashboardService - Service object with getDashboardData method
+ * @param {Function} config.onError - Error handler function
+ * 
+ * @returns {Object} Dashboard data and loading states
+ * 
+ * @example
+ * const { data, loading, userGrowthData, fetchUserGrowth } = useAdminDashboard({
+ *   dashboardService: {
+ *     getDashboardData: () => DashboardService.getAdminStats(),
+ *     getUserGrowth: (params) => DashboardService.getUserGrowth(params)
+ *   },
+ *   onError: (err) => console.error(err)
+ * });
+ */
+export function useAdminDashboard({ dashboardService, onError }) {
+	const [data, setData] = useState({});
+	const [loading, setLoading] = useState(false);
+	const [userGrowthData, setUserGrowthData] = useState([]);
+	const [userGrowthDataLoading, setUserGrowthDataLoading] = useState(false);
+
+	const fetchDashboardData = useCallback(async () => {
+		if (!dashboardService?.getDashboardData) {
+			console.warn("dashboardService.getDashboardData not provided");
+			return;
+		}
+
+		setLoading(true);
+		try {
+			const response = await dashboardService.getDashboardData();
+			setData(response || {});
+		} catch (err) {
+			if (onError) {
+				onError(err);
+			} else {
+				console.error("Error fetching dashboard data:", err);
+			}
+		} finally {
+			setLoading(false);
+		}
+	}, [dashboardService, onError]);
+
+	const fetchUserGrowth = useCallback(
+		async (params) => {
+			if (!dashboardService?.getUserGrowth) {
+				console.warn("dashboardService.getUserGrowth not provided");
+				return;
+			}
+
+			setUserGrowthDataLoading(true);
+			try {
+				const response = await dashboardService.getUserGrowth(params);
+				setUserGrowthData(response || []);
+			} catch (err) {
+				if (onError) {
+					onError(err);
+				} else {
+					console.error("Error fetching user growth:", err);
+				}
+			} finally {
+				setUserGrowthDataLoading(false);
+			}
+		},
+		[dashboardService, onError]
+	);
+
+	useEffect(() => {
+		fetchDashboardData();
+	}, [fetchDashboardData]);
+
+	return {
+		data,
+		loading,
+		userGrowthData,
+		fetchUserGrowth,
+		userGrowthDataLoading,
+	};
+}
+

package/src/@daf/utils/adminConfigBuilders.js

@@ -0,0 +1,102 @@
+/**
+ * Utility functions for building admin dashboard configurations
+ * These functions transform simple data arrays into full configuration objects
+ */
+
+/**
+ * Format string to kebab-case
+ * @param {string} str - String to format
+ * @returns {string} Kebab-cased string
+ */
+export function formatToKebabCase(str) {
+	return str.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+
+/**
+ * Build action widgets configuration
+ * 
+ * @param {Object} params
+ * @param {Array} params.widgets - Array of widget definitions
+ * @param {Function} params.getRedirectLink - Function to transform paths
+ * @param {Function} params.t - Translation function
+ * 
+ * @returns {Array} Configured action widgets
+ * 
+ * @example
+ * const widgets = buildActionWidgetsConfig({
+ *   widgets: [
+ *     { icon: "Search", title: "review-requests", path: "/accounts?pending=true" }
+ *   ],
+ *   getRedirectLink: (path) => `/app${path}`,
+ *   t: (key) => translations[key]
+ * });
+ */
+export function buildActionWidgetsConfig({ widgets = [], getRedirectLink, t }) {
+	return widgets.map((widget) => ({
+		icon: widget.icon,
+		title: widget.title,
+		goToPath: getRedirectLink ? getRedirectLink(widget.path) : widget.path,
+		disabled: widget.disabled || false,
+	}));
+}
+
+/**
+ * Build key indicators configuration
+ * 
+ * @param {Object} params
+ * @param {Object} params.keyIndicatorsData - Object with indicator keys and values
+ * @param {Array} params.paths - Array of paths corresponding to each indicator
+ * @param {Function} params.getRedirectLink - Function to transform paths
+ * 
+ * @returns {Array} Configured key indicators
+ * 
+ * @example
+ * const indicators = buildKeyIndicatorsConfig({
+ *   keyIndicatorsData: { totalUsers: 100, totalAccounts: 50 },
+ *   paths: ["/users", "/accounts"],
+ *   getRedirectLink: (path) => `/app${path}`
+ * });
+ */
+export function buildKeyIndicatorsConfig({ keyIndicatorsData = {}, paths = [], getRedirectLink }) {
+	const keys = Object.keys(keyIndicatorsData);
+
+	return keys.map((key, index) => ({
+		title: formatToKebabCase(key),
+		valueToShow: keyIndicatorsData[key],
+		goToPath: getRedirectLink && paths[index] ? getRedirectLink(paths[index]) : paths[index] || "#",
+	}));
+}
+
+/**
+ * Build breadcrumbs configuration
+ * 
+ * @param {Object} params
+ * @param {string} params.view - View type (e.g., "accounts", "users")
+ * @param {Function} params.t - Translation function
+ * @param {Function} params.goTo - Navigation function
+ * @param {boolean} params.isView - Is in view mode
+ * @param {boolean} params.isEdit - Is in edit mode
+ * @param {string} params.id - Entity ID
+ * @param {string} params.mode - Current mode
+ * @param {string} params.group - Current group/section
+ * @param {string} params.basePath - Base path for the view
+ * 
+ * @returns {Array} Breadcrumb configuration
+ */
+export function buildBreadcrumbs({ view, t, goTo, isView, isEdit, id, mode, group, basePath = "/app" }) {
+	return [
+		{
+			label: t("Admin"),
+			path: basePath,
+		},
+		{
+			label: t(view.charAt(0).toUpperCase() + view.slice(1)),
+			path: `${basePath}/${view}`,
+		},
+		{
+			label: isView ? t("View") : t("Edit"),
+			path: `${basePath}/${view}/${mode}/${id}/${group}`,
+		},
+	];
+}
+

package/src/hooks.js

@@ -11,4 +11,5 @@ export { useMapOnExpandableWidget } from "./@daf/hooks/useMapOnExpandableWidget"
 export { checkPermission, checkPermissionList, usePermissions } from "./@daf/hooks/usePermissions";
 export { useFirebase } from "./@daf/hooks/useFirebase.js"
 export { useIsDatastake } from "./@daf/hooks/useIsDatastake.js"
-export { useWidgetFetch } from "./@daf/hooks/useWidgetFetch.js"
+export { useWidgetFetch } from "./@daf/hooks/useWidgetFetch.js"
+export { useAdminDashboard } from "./@daf/hooks/useAdminDashboard.js"

package/src/index.js

@@ -146,13 +146,31 @@ export { default as StakeholderMappings } from "./@daf/core/components/Graphs/St
 
 //* ------------------------------ Screens ------------------------------
 export { default as BaseScreen } from "./@daf/core/components/Screens/BaseScreen/index.jsx";
-// Admin
+// Admin - Base Components
 export { default as AdminDashboard } from "./@daf/core/components/Screens/Admin/AdminDashboard/index.jsx";
 export { default as UserTable } from "./@daf/core/components/Screens/Admin/AdminTables/UserTable/index.jsx";
 export { default as AccountTable } from "./@daf/core/components/Screens/Admin/AdminTables/AccountTable/index.jsx";
 export { default as LocationTable } from "./@daf/core/components/Screens/Admin/AdminTables/LocationTable/index.jsx";
 export { default as SubjectsTable } from "./@daf/core/components/Screens/Admin/AdminTables/SubjectsTable/index.jsx";
 export { default as AdminView } from "./@daf/core/components/Screens/Admin/AdminViews/index.jsx";
+
+// Admin - Ready-to-use Screen Components (Route Wrappers)
+export {
+	AdminDashboardScreen,
+	AdminUsersScreen,
+	AdminAccountsScreen,
+	AdminAccountsViewScreen,
+} from "./@daf/core/components/Screens/Admin/AdminScreens/index.js";
+
+// Admin - Modals
+export {
+	AddAccountModal,
+	AddUserModal,
+	AddUserToAccountModal,
+} from "./@daf/core/components/Screens/Admin/AdminModals/index.js";
+
+// Admin - Routes Generator
+export { getAdminRoutes } from "./@daf/core/components/Screens/Admin/adminRoutes.js";
 //Error
 export { default as NotFound } from "./@daf/core/components/Screens/NotFound/index.jsx";
 export { default as InformationUnavailable } from "./@daf/core/components/Screens/InformationUnavailable/index.jsx";

package/src/utils.js

@@ -52,4 +52,10 @@ export { createTheme, createAdminTheme } from './helpers/theme.js';
 
 export { getRedirectLink } from "./@daf/hooks/useIsDatastake.js"
 
-export { getSourceString, getDivergenceOrEqual } from './helpers/stringHelper.jsx'
+export { getSourceString, getDivergenceOrEqual } from './helpers/stringHelper.jsx'
+
+export { 
+	buildActionWidgetsConfig, 
+	buildKeyIndicatorsConfig, 
+	buildBreadcrumbs
+} from './@daf/utils/adminConfigBuilders.js'

package/build/manifest.json

@@ -1,25 +0,0 @@
-{
-  "short_name": "React App",
-  "name": "Create React App Sample",
-  "icons": [
-    {
-      "src": "favicon.ico",
-      "sizes": "64x64 32x32 24x24 16x16",
-      "type": "image/x-icon"
-    },
-    {
-      "src": "logo192.png",
-      "type": "image/png",
-      "sizes": "192x192"
-    },
-    {
-      "src": "logo512.png",
-      "type": "image/png",
-      "sizes": "512x512"
-    }
-  ],
-  "start_url": ".",
-  "display": "standalone",
-  "theme_color": "#000000",
-  "background_color": "#ffffff"
-}

package/build/robots.txt

@@ -1,3 +0,0 @@
-# https://www.robotstxt.org/robotstxt.html
-User-agent: *
-Disallow: