@appcorp/fusion-storybook 0.2.12 → 0.2.14

package/base-modules/student-fee/context/use-student-fee-module.js

@@ -0,0 +1,610 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef } from "react";
+import { useTheme } from "next-themes";
+import { useTranslations } from "next-intl";
+import { validateForm, isCreatedOrUpdated, } from "@react-pakistan/util-functions";
+import { useModuleEntityV2, } from "@react-pakistan/util-functions/hooks/use-module-entity-v2";
+import { useDebounce } from "@react-pakistan/util-functions/hooks/use-debounce";
+import { generateThemeToast, TOAST_VARIANT, } from "@appcorp/shadcn/lib/toast-utils";
+import { PAYMENT_STATUS, DISCOUNT_TYPE, } from "../../../type";
+import { STUDENT_FEE_API_ROUTES, pageLimit } from "../constants";
+import { studentFeeFormValidation } from "../validate";
+import { getCachedStudentFees, invalidateStudentFeesCache } from "../cache";
+import { getCachedWorkspaceSync } from "../../workspace/cache";
+import { getCachedFeeStructureById } from "../../fee-structure/cache";
+import { getCachedStudentProfilesSync } from "../../student-profile/cache";
+import { getCachedDiscountCodesSync } from "../../discount-code/cache";
+import { STUDENT_FEE_ACTION_TYPES, STUDENT_FEE_DRAWER, useStudentFeeContext, } from "./shared";
+// ============================================================================
+// AMOUNT CALCULATION HELPER
+// ============================================================================
+const calculateAmounts = (originalFee, discountAmount, amountPaid) => {
+    const amount = Math.max(0, originalFee - discountAmount);
+    const amountDue = Math.max(0, amount - amountPaid);
+    return { amount, amountDue };
+};
+// ============================================================================
+// ENHANCED STUDENT FEE HOOK WITH API INTEGRATION
+// ============================================================================
+export const useStudentFeeModule = () => {
+    // ============================================================================
+    // 1.4.1 STATE & CORE HOOKS
+    // ============================================================================
+    var _a;
+    const context = useStudentFeeContext();
+    const { dispatch } = context;
+    const state = context.state;
+    const t = useTranslations("studentFee");
+    const { theme } = useTheme();
+    const workspace = getCachedWorkspaceSync();
+    const schoolId = ((_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id) || "";
+    const listFetchNowRef = useRef(null);
+    const debouncedQuery = useDebounce(state.searchQuery, 800);
+    // ============================================================================
+    // 1.4.2 API PARAMETERS
+    // ============================================================================
+    const listParams = useMemo(() => (Object.assign(Object.assign(Object.assign({ currentPage: state.currentPage, pageLimit: state.pageLimit, schoolId }, (debouncedQuery ? { searchQuery: debouncedQuery } : {})), (state.filterEnabled !== undefined
+        ? { filterEnabled: state.filterEnabled }
+        : {})), (state.filterStatus ? { status: state.filterStatus } : {}))), [
+        state.currentPage,
+        state.filterEnabled,
+        state.filterStatus,
+        state.pageLimit,
+        debouncedQuery,
+        schoolId,
+    ]);
+    const updateParams = useMemo(() => ({
+        amount: Number(state.amount),
+        amountDue: Number(state.amountDue),
+        amountPaid: Number(state.amountPaid),
+        discountAmount: Number(state.discountAmount),
+        discountCodeId: state.discountCodeId,
+        dueDate: state.dueDate,
+        enabled: state.enabled,
+        familyId: state.familyId,
+        feeStructureId: state.feeStructureId,
+        id: state.id,
+        remarks: state.remarks || null,
+        schoolId,
+        status: state.status,
+        studentProfileId: state.studentProfileId,
+    }), [state, schoolId]);
+    const byIdParams = useMemo(() => ({ id: state.id }), [state.id]);
+    const deleteParams = useMemo(() => ({ id: state.id }), [state.id]);
+    const isDefaultListState = state.currentPage === 1 &&
+        state.pageLimit === pageLimit &&
+        !debouncedQuery &&
+        state.filterEnabled === undefined &&
+        !state.filterStatus;
+    // ============================================================================
+    // 1.4.3 UTILITIES
+    // ============================================================================
+    const showToast = useCallback((description, variant) => {
+        generateThemeToast({
+            description,
+            theme: theme,
+            variant,
+        });
+    }, [theme]);
+    const resetFormAndCloseDrawer = useCallback(() => {
+        dispatch({ type: STUDENT_FEE_ACTION_TYPES.RESET_FORM });
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_ERRORS,
+            payload: { errors: {} },
+        });
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+            payload: { disabled: false },
+        });
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: null },
+        });
+    }, [dispatch]);
+    // ============================================================================
+    // 1.4.4 API CALLBACKS
+    // ============================================================================
+    const listCallback = useCallback(({ data, error }) => {
+        var _a, _b;
+        if (error) {
+            showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            const response = data;
+            dispatch({
+                type: STUDENT_FEE_ACTION_TYPES.SET_ITEMS,
+                payload: { items: (_a = response.items) !== null && _a !== void 0 ? _a : [], count: (_b = response.count) !== null && _b !== void 0 ? _b : 0 },
+            });
+        }
+    }, [dispatch, showToast, t]);
+    const updateCallback = useCallback(({ data, error }) => {
+        var _a;
+        if (error) {
+            showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            const isCreated = isCreatedOrUpdated(data);
+            invalidateStudentFeesCache();
+            showToast(isCreated
+                ? t("messagesStudentFeeCreated")
+                : t("messagesStudentFeeUpdated"), TOAST_VARIANT.SUCCESS);
+            resetFormAndCloseDrawer();
+            (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+        }
+    }, [showToast, t, resetFormAndCloseDrawer]);
+    const byIdCallback = useCallback(({ data, error }) => {
+        if (error) {
+            showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            const fee = data;
+            const rawDueDate = fee.dueDate;
+            const dueDate = rawDueDate instanceof Date
+                ? rawDueDate.toISOString().slice(0, 10)
+                : String(rawDueDate).slice(0, 10);
+            const originalFee = Number(fee.amount) + Number(fee.discountAmount || 0);
+            dispatch({
+                type: STUDENT_FEE_ACTION_TYPES.SET_FORM_DATA,
+                payload: {
+                    form: Object.assign(Object.assign({}, fee), { dueDate,
+                        originalFee, filterEnabled: undefined, filterStatus: state.filterStatus }),
+                },
+            });
+        }
+    }, [dispatch, showToast, t, state.filterStatus]);
+    const deleteCallback = useCallback(({ data, error }) => {
+        var _a;
+        if (error) {
+            showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            invalidateStudentFeesCache();
+            showToast(t("messagesStudentFeeDeleted"), TOAST_VARIANT.SUCCESS);
+            (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+        }
+    }, [showToast, t]);
+    // ============================================================================
+    // 1.4.5 API HOOKS
+    // ============================================================================
+    const { listFetchNow, listLoading, updateFetchNow, updateLoading, byIdFetchNow, deleteFetchNow, deleteLoading, byIdLoading, } = useModuleEntityV2({
+        byIdCallback,
+        byIdParams,
+        deleteCallback,
+        deleteParams,
+        listCallback,
+        listParams,
+        listUrl: STUDENT_FEE_API_ROUTES.UNIT,
+        searchQuery: debouncedQuery,
+        unitByIdUrl: STUDENT_FEE_API_ROUTES.UNIT,
+        unitUrl: STUDENT_FEE_API_ROUTES.UNIT,
+        updateCallback,
+        updateParams,
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-token": process.env.NEXT_PUBLIC_API_KEY,
+        },
+    });
+    // ============================================================================
+    // 1.4.6 HANDLERS
+    // ============================================================================
+    const handleChange = useCallback((field, value) => {
+        var _a, _b, _c, _d, _e;
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_ERRORS,
+            payload: { errors: {} },
+        });
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+            payload: { disabled: false },
+        });
+        const currentState = Object.assign({}, state);
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key: field, value },
+        });
+        const discountCodes = getCachedDiscountCodesSync();
+        if (field === "feeStructureId" && typeof value === "string" && value) {
+            try {
+                const feeStructure = getCachedFeeStructureById(value);
+                if (feeStructure && typeof feeStructure.amount === "number") {
+                    const originalFee = Number(feeStructure.amount);
+                    dispatch({
+                        type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                        payload: { key: "originalFee", value: originalFee },
+                    });
+                    let discountAmount = Number(currentState.discountAmount) || 0;
+                    if (currentState.discountCodeId) {
+                        const discountCode = (_a = discountCodes.items) === null || _a === void 0 ? void 0 : _a.find((code) => code.id === currentState.discountCodeId && code.enabled);
+                        if (discountCode) {
+                            discountAmount =
+                                discountCode.discountType === DISCOUNT_TYPE.PERCENTAGE
+                                    ? (originalFee * discountCode.discountValue) / 100
+                                    : discountCode.discountValue;
+                            discountAmount = Math.min(discountAmount, originalFee);
+                            dispatch({
+                                type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                                payload: { key: "discountAmount", value: discountAmount },
+                            });
+                        }
+                    }
+                    const { amount, amountDue } = calculateAmounts(originalFee, discountAmount, Number(currentState.amountPaid) || 0);
+                    dispatch({
+                        type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                        payload: { key: "amount", value: amount },
+                    });
+                    dispatch({
+                        type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                        payload: { key: "amountDue", value: amountDue },
+                    });
+                }
+            }
+            catch (_f) {
+                // silent fallback
+            }
+        }
+        if (field === "studentProfileId" && typeof value === "string" && value) {
+            try {
+                const studentProfile = (_b = getCachedStudentProfilesSync().items) === null || _b === void 0 ? void 0 : _b.find((s) => s.id === value);
+                dispatch({
+                    type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                    payload: {
+                        key: "familyId",
+                        value: (_c = studentProfile === null || studentProfile === void 0 ? void 0 : studentProfile.familyMember) === null || _c === void 0 ? void 0 : _c.familyId,
+                    },
+                });
+                if (studentProfile === null || studentProfile === void 0 ? void 0 : studentProfile.discountCode) {
+                    const discountCode = (_d = discountCodes.items) === null || _d === void 0 ? void 0 : _d.find((code) => code.code === studentProfile.discountCode && code.enabled);
+                    if (discountCode) {
+                        dispatch({
+                            type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                            payload: { key: "discountCodeId", value: discountCode.id },
+                        });
+                        const originalFee = Number(currentState.originalFee) || 0;
+                        let discountAmount = 0;
+                        if (originalFee > 0) {
+                            discountAmount =
+                                discountCode.discountType === DISCOUNT_TYPE.PERCENTAGE
+                                    ? (originalFee * discountCode.discountValue) / 100
+                                    : discountCode.discountValue;
+                            discountAmount = Math.min(discountAmount, originalFee);
+                            const { amount, amountDue } = calculateAmounts(originalFee, discountAmount, Number(currentState.amountPaid) || 0);
+                            dispatch({
+                                type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                                payload: { key: "amount", value: amount },
+                            });
+                            dispatch({
+                                type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                                payload: { key: "amountDue", value: amountDue },
+                            });
+                        }
+                        dispatch({
+                            type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                            payload: { key: "discountAmount", value: discountAmount },
+                        });
+                    }
+                }
+            }
+            catch (_g) {
+                // silent fallback
+            }
+        }
+        if (field === "discountCodeId" && typeof value === "string" && value) {
+            try {
+                const discountCode = (_e = discountCodes.items) === null || _e === void 0 ? void 0 : _e.find((code) => code.id === value && code.enabled);
+                if (discountCode) {
+                    const originalFee = Number(currentState.originalFee) || 0;
+                    let discountAmount = discountCode.discountType === DISCOUNT_TYPE.PERCENTAGE
+                        ? (originalFee * discountCode.discountValue) / 100
+                        : discountCode.discountValue;
+                    discountAmount = Math.min(discountAmount, originalFee);
+                    dispatch({
+                        type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                        payload: { key: "discountAmount", value: discountAmount },
+                    });
+                    const { amount, amountDue } = calculateAmounts(originalFee, discountAmount, Number(currentState.amountPaid) || 0);
+                    dispatch({
+                        type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                        payload: { key: "amount", value: amount },
+                    });
+                    dispatch({
+                        type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                        payload: { key: "amountDue", value: amountDue },
+                    });
+                }
+            }
+            catch (_h) {
+                // silent fallback
+            }
+        }
+        if (field === "discountAmount" && typeof value === "number") {
+            const originalFee = Number(currentState.originalFee) || 0;
+            const validatedDiscount = Math.min(Number(value) || 0, originalFee);
+            if (validatedDiscount !== value) {
+                dispatch({
+                    type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                    payload: { key: "discountAmount", value: validatedDiscount },
+                });
+            }
+            const amountPaid = Number(currentState.amountPaid) || 0;
+            const { amount, amountDue } = calculateAmounts(originalFee, validatedDiscount, amountPaid);
+            dispatch({
+                type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: { key: "amount", value: amount },
+            });
+            dispatch({
+                type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: { key: "amountDue", value: amountDue },
+            });
+            const newStatus = amountPaid === 0
+                ? PAYMENT_STATUS.PENDING
+                : amountPaid >= amount
+                    ? PAYMENT_STATUS.PAID
+                    : PAYMENT_STATUS.PARTIAL;
+            dispatch({
+                type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: { key: "status", value: newStatus },
+            });
+        }
+        if (field === "amountPaid" && typeof value === "number") {
+            const originalFee = Number(currentState.originalFee) || 0;
+            const discountAmount = Number(currentState.discountAmount) || 0;
+            const maxAllowed = Math.max(0, originalFee - discountAmount);
+            const validatedPaid = Math.min(Number(value) || 0, maxAllowed);
+            if (validatedPaid !== value) {
+                dispatch({
+                    type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                    payload: { key: "amountPaid", value: validatedPaid },
+                });
+            }
+            const { amountDue } = calculateAmounts(originalFee, discountAmount, validatedPaid);
+            dispatch({
+                type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: { key: "amountDue", value: amountDue },
+            });
+            const totalAmount = Math.max(0, originalFee - discountAmount);
+            const newStatus = validatedPaid === 0
+                ? PAYMENT_STATUS.PENDING
+                : validatedPaid >= totalAmount
+                    ? PAYMENT_STATUS.PAID
+                    : PAYMENT_STATUS.PARTIAL;
+            dispatch({
+                type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: { key: "status", value: newStatus },
+            });
+        }
+        if (field === "amount" && typeof value === "number") {
+            const amountPaid = Number(currentState.amountPaid) || 0;
+            const amountDue = Math.max(0, Number(value) - amountPaid);
+            dispatch({
+                type: STUDENT_FEE_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: { key: "amountDue", value: amountDue },
+            });
+        }
+    }, [dispatch, state]);
+    const handlePageChange = useCallback((page) => {
+        const nextPage = typeof page === "number" ? page : state.currentPage + 1;
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: nextPage },
+        });
+    }, [dispatch, state.currentPage]);
+    const handlePageLimitChange = useCallback((k, value) => {
+        const { option } = Object.assign({}, value);
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_PAGE_LIMIT,
+            payload: { pageLimit: Number(option) },
+        });
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+    }, [dispatch]);
+    const closeDrawer = useCallback(() => {
+        resetFormAndCloseDrawer();
+    }, [resetFormAndCloseDrawer]);
+    const clearSearch = useCallback(() => {
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_SEARCH_QUERY,
+            payload: { searchQuery: "" },
+        });
+    }, [dispatch]);
+    const toggleStatus = useCallback((row) => {
+        updateFetchNow(undefined, {
+            body: JSON.stringify(Object.assign(Object.assign({}, row), { enabled: !(row === null || row === void 0 ? void 0 : row.enabled) })),
+        });
+    }, [updateFetchNow]);
+    const handleCreate = useCallback(() => {
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: STUDENT_FEE_DRAWER.FORM_DRAWER },
+        });
+    }, [dispatch]);
+    const handleView = useCallback((row) => {
+        byIdFetchNow === null || byIdFetchNow === void 0 ? void 0 : byIdFetchNow(undefined, { params: { id: row === null || row === void 0 ? void 0 : row.id } });
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: STUDENT_FEE_DRAWER.VIEW_DRAWER },
+        });
+    }, [dispatch, byIdFetchNow]);
+    const handleEdit = useCallback((row) => {
+        byIdFetchNow === null || byIdFetchNow === void 0 ? void 0 : byIdFetchNow(undefined, { params: { id: row === null || row === void 0 ? void 0 : row.id } });
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: STUDENT_FEE_DRAWER.FORM_DRAWER },
+        });
+    }, [dispatch, byIdFetchNow]);
+    const handleDelete = useCallback((row) => {
+        if (!confirm(t("messagesDeleteConfirmation")))
+            return;
+        deleteFetchNow === null || deleteFetchNow === void 0 ? void 0 : deleteFetchNow(undefined, {
+            body: JSON.stringify({ id: row === null || row === void 0 ? void 0 : row.id }),
+        });
+    }, [t, deleteFetchNow]);
+    const handleFilters = useCallback(() => {
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: STUDENT_FEE_DRAWER.FILTER_DRAWER },
+        });
+    }, [dispatch]);
+    const handleMoreActions = useCallback(() => {
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: STUDENT_FEE_DRAWER.MORE_ACTIONS_DRAWER },
+        });
+    }, [dispatch]);
+    const applyFilters = useCallback(() => {
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+        closeDrawer();
+    }, [dispatch, closeDrawer]);
+    const clearFilters = useCallback(() => {
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_FILTERS,
+            payload: { filters: { filterEnabled: undefined, filterStatus: "" } },
+        });
+    }, [dispatch]);
+    const handleSearch = useCallback((query) => {
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_SEARCH_QUERY,
+            payload: { searchQuery: query },
+        });
+    }, [dispatch]);
+    // ============================================================================
+    // 1.4.7 NETWORK ACTIONS
+    // ============================================================================
+    const handleSubmit = useCallback(() => {
+        dispatch({
+            type: STUDENT_FEE_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+            payload: { disabled: true },
+        });
+        validateForm({
+            params: updateParams,
+            schema: studentFeeFormValidation,
+            successCallback: () => {
+                updateFetchNow(undefined, {
+                    body: JSON.stringify(updateParams),
+                });
+            },
+            errorCallback: (errors) => {
+                dispatch({
+                    type: STUDENT_FEE_ACTION_TYPES.SET_ERRORS,
+                    payload: { errors },
+                });
+                dispatch({
+                    type: STUDENT_FEE_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+                    payload: { disabled: false },
+                });
+                showToast(t("messagesFormErrors"), TOAST_VARIANT.ERROR);
+            },
+        });
+    }, [dispatch, updateParams, t, showToast, updateFetchNow]);
+    // ============================================================================
+    // 1.4.8 HEADER & ROW ACTIONS
+    // ============================================================================
+    const headerActions = useMemo(() => [
+        {
+            enabled: false,
+            handleOnClick: handleMoreActions,
+            label: t("actionsButtonMoreActions"),
+            order: 0,
+        },
+        {
+            enabled: true,
+            handleOnClick: handleFilters,
+            label: t("actionsButtonFilters"),
+            order: 1,
+        },
+        {
+            enabled: true,
+            handleOnClick: handleCreate,
+            label: t("actionsButtonAdd"),
+            order: 2,
+        },
+    ], [handleMoreActions, handleFilters, handleCreate, t]);
+    const rowActions = useMemo(() => [
+        {
+            enabled: true,
+            handleOnClick: handleView,
+            label: t("actionsButtonView"),
+            order: 1,
+        },
+        {
+            enabled: true,
+            handleOnClick: handleEdit,
+            label: t("actionsButtonEdit"),
+            order: 2,
+        },
+        {
+            enabled: false,
+            handleOnClick: handleDelete,
+            label: t("actionsButtonDelete"),
+            order: 3,
+            variant: "destructive",
+        },
+    ], [handleDelete, handleEdit, handleView, t]);
+    // ============================================================================
+    // 1.4.9 EFFECTS
+    // ============================================================================
+    useEffect(() => {
+        var _a;
+        if (!schoolId)
+            return;
+        if (isDefaultListState) {
+            (async () => {
+                try {
+                    const { count, items } = await getCachedStudentFees({
+                        params: listParams,
+                    });
+                    dispatch({
+                        type: STUDENT_FEE_ACTION_TYPES.SET_ITEMS,
+                        payload: { items: items || [], count: count || 0 },
+                    });
+                }
+                catch (_a) {
+                    showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
+                }
+            })();
+            return;
+        }
+        (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+    }, [dispatch, isDefaultListState, listParams, schoolId, showToast, t]);
+    useEffect(() => {
+        listFetchNowRef.current = listFetchNow;
+    }, [listFetchNow]);
+    // ============================================================================
+    // 1.4.10 RETURN
+    // ============================================================================
+    return Object.assign(Object.assign({}, context), { applyFilters,
+        byIdLoading,
+        clearFilters,
+        clearSearch,
+        closeDrawer,
+        deleteLoading,
+        handleChange,
+        handleCreate,
+        handleDelete,
+        handleEdit,
+        handleFilters,
+        handleMoreActions,
+        handlePageChange,
+        handlePageLimitChange,
+        handleSearch,
+        handleSubmit,
+        handleView,
+        headerActions,
+        listFetchNow,
+        listLoading,
+        rowActions,
+        toggleStatus,
+        updateLoading });
+};