@appcorp/fusion-storybook 0.3.84 → 0.3.86

package/base-modules/student-fee/context/index.d.ts

@@ -0,0 +1,3 @@
+export { STUDENT_FEE_DRAWER, STUDENT_FEE_ACTION_TYPES, studentFeeModuleConfig, initialStudentFeeState, StudentFeeProvider, studentFeeReducer, useStudentFeeContext, } from "./shared";
+export { StudentFeeApiProvider, useStudentFeeApiContext } from "./student-fee-api-provider";
+export { useStudentFeeModule } from "./use-student-fee-module";

package/base-modules/student-fee/context/index.js

@@ -0,0 +1,3 @@
+export { STUDENT_FEE_DRAWER, STUDENT_FEE_ACTION_TYPES, studentFeeModuleConfig, initialStudentFeeState, StudentFeeProvider, studentFeeReducer, useStudentFeeContext, } from "./shared";
+export { StudentFeeApiProvider, useStudentFeeApiContext } from "./student-fee-api-provider";
+export { useStudentFeeModule } from "./use-student-fee-module";

package/base-modules/student-fee/context/student-fee-api-provider.d.ts

@@ -0,0 +1,16 @@
+import type { FetchConfig } from "@react-pakistan/util-functions/hooks/use-fetch";
+export interface StudentFeeApiContextType {
+    listFetchNow: (url?: string, config?: FetchConfig) => void;
+    listLoading: boolean;
+    updateFetchNow: (url?: string, config?: FetchConfig) => void;
+    updateLoading: boolean;
+    byIdFetchNow: (url?: string, config?: FetchConfig) => void;
+    byIdLoading: boolean;
+    deleteFetchNow?: (url?: string, config?: FetchConfig) => void;
+    deleteLoading: boolean;
+    resetFormAndCloseDrawer: () => void;
+}
+export declare const useStudentFeeApiContext: () => StudentFeeApiContextType;
+export declare const StudentFeeApiProvider: ({ children, }: {
+    children: React.ReactNode;
+}) => import("react").JSX.Element;

package/base-modules/student-fee/context/student-fee-api-provider.js

@@ -0,0 +1,233 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef } from "react";
+import { useTheme } from "next-themes";
+import { useTranslations } from "next-intl";
+import { isCreatedOrUpdated } from "@react-pakistan/util-functions/general/is-created-or-updated";
+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 { STUDENT_FEE_API_ROUTES } from "../../../constants";
+import { getCachedWorkspaceSync } from "../../workspace/cache";
+import { STUDENT_FEE_ACTION_TYPES, useStudentFeeContext, } from "./shared";
+// ============================================================================
+// CONTEXT
+// ============================================================================
+const StudentFeeApiContext = createContext(null);
+export const useStudentFeeApiContext = () => {
+    const ctx = useContext(StudentFeeApiContext);
+    if (!ctx) {
+        throw new Error("useStudentFeeApiContext must be used within StudentFeeApiProvider");
+    }
+    return ctx;
+};
+// ============================================================================
+// PROVIDER
+// ============================================================================
+export const StudentFeeApiProvider = ({ children, }) => {
+    var _a;
+    const context = useStudentFeeContext();
+    const { dispatch } = context;
+    const state = context.state;
+    const t = useTranslations("studentFee");
+    const { theme } = useTheme();
+    const workspace = getCachedWorkspaceSync();
+    const debouncedQuery = useDebounce(state.searchQuery, 800);
+    const schoolId = ((_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id) || "";
+    // ==========================================================================
+    // 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]);
+    // ==========================================================================
+    // API PARAMETERS
+    // ==========================================================================
+    const listParams = useMemo(() => (Object.assign({ currentPage: state.currentPage, pageLimit: state.pageLimit, schoolId }, (debouncedQuery ? { searchQuery: debouncedQuery } : {}))), [state.currentPage, 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,
+        paidAt: state.paidAt || null,
+        remarks: state.remarks || null,
+        schoolId,
+        status: state.status,
+        studentProfileId: state.studentProfileId,
+    }), [
+        state.amount,
+        state.amountDue,
+        state.amountPaid,
+        state.discountAmount,
+        state.discountCodeId,
+        state.dueDate,
+        state.enabled,
+        state.familyId,
+        state.feeStructureId,
+        state.id,
+        state.paidAt,
+        state.remarks,
+        state.status,
+        state.studentProfileId,
+        schoolId,
+    ]);
+    const byIdParams = useMemo(() => ({ id: state.id }), [state.id]);
+    const deleteParams = useMemo(() => ({ id: state.id }), [state.id]);
+    // ==========================================================================
+    // 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 listFetchNowRef = useRef(null);
+    const updateCallback = useCallback(({ data, error }) => {
+        var _a;
+        if (error) {
+            showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            const isCreated = isCreatedOrUpdated(data);
+            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.getFullYear()}-${String(rawDueDate.getMonth() + 1).padStart(2, "0")}-${String(rawDueDate.getDate()).padStart(2, "0")}`
+                : String(rawDueDate).slice(0, 10);
+            const rawPaidAt = fee.paidAt;
+            const today = new Date();
+            const todayStr = `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, "0")}-${String(today.getDate()).padStart(2, "0")}`;
+            const paidAt = rawPaidAt instanceof Date
+                ? `${rawPaidAt.getFullYear()}-${String(rawPaidAt.getMonth() + 1).padStart(2, "0")}-${String(rawPaidAt.getDate()).padStart(2, "0")}`
+                : rawPaidAt
+                    ? String(rawPaidAt).slice(0, 10)
+                    : todayStr;
+            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,
+                        paidAt,
+                        originalFee }),
+                },
+            });
+        }
+    }, [dispatch, showToast, t]);
+    const deleteCallback = useCallback(({ data, error }) => {
+        var _a;
+        if (error) {
+            showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            showToast(t("messagesStudentFeeDeleted"), TOAST_VARIANT.SUCCESS);
+            (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+        }
+    }, [showToast, t]);
+    // ==========================================================================
+    // SINGLE API HOOK INSTANCE
+    // ==========================================================================
+    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",
+        },
+    });
+    // ==========================================================================
+    // REF SYNC (for callbacks to always call the latest fetch)
+    // ==========================================================================
+    useEffect(() => {
+        listFetchNowRef.current = listFetchNow;
+    }, [listFetchNow]);
+    // ==========================================================================
+    // AUTO-FETCH EFFECT (runs once, not per child mount)
+    // ==========================================================================
+    useEffect(() => {
+        var _a;
+        (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+    }, [listParams]);
+    // ==========================================================================
+    // CONTEXT VALUE
+    // ==========================================================================
+    const value = useMemo(() => ({
+        listFetchNow,
+        listLoading,
+        updateFetchNow,
+        updateLoading,
+        byIdFetchNow,
+        byIdLoading,
+        deleteFetchNow,
+        deleteLoading,
+        resetFormAndCloseDrawer,
+    }), [
+        listFetchNow,
+        listLoading,
+        updateFetchNow,
+        updateLoading,
+        byIdFetchNow,
+        byIdLoading,
+        deleteFetchNow,
+        deleteLoading,
+        resetFormAndCloseDrawer,
+    ]);
+    return (_jsx(StudentFeeApiContext.Provider, { value: value, children: children }));
+};

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

@@ -1,13 +1,10 @@
 "use client";
-import { useCallback, useEffect, useMemo, useRef } from "react";
+import { useCallback, useMemo } from "react";
 import { useTheme } from "next-themes";
 import { useTranslations } from "next-intl";
 import { validateForm } from "@react-pakistan/util-functions/general/validate-form";
-import { isCreatedOrUpdated } from "@react-pakistan/util-functions/general/is-created-or-updated";
 import { getStorageValue } from "@react-pakistan/util-functions/local-storage/get-storage-value";
 import { API_METHODS } from "@react-pakistan/util-functions/constants/api-methods";
-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 } from "../../../constants";
@@ -16,6 +13,7 @@ import { getCachedWorkspaceSync } from "../../workspace/cache";
 import { getCachedFeeStructureById } from "../../fee-structure/cache";
 import { getCachedDiscountCodesSync } from "../../discount-code/cache";
 import { STUDENT_FEE_ACTION_TYPES, STUDENT_FEE_DRAWER, useStudentFeeContext, } from "./shared";
+import { useStudentFeeApiContext } from "./student-fee-api-provider";
 // ============================================================================
 // AMOUNT CALCULATION HELPER
 // ============================================================================
@@ -29,66 +27,19 @@ const calculateAmounts = (originalFee, discountAmount, amountPaid) => {
 // ============================================================================
 export const useStudentFeeModule = () => {
     // ============================================================================
-    // 1.4.1 STATE & CORE HOOKS
+    // 1.4.1 STATE, CONTEXT & API HOOKS
     // ============================================================================
     var _a, _b, _c, _d;
     const context = useStudentFeeContext();
     const { dispatch } = context;
     const state = context.state;
+    const { listFetchNow, listLoading, updateFetchNow, updateLoading, byIdFetchNow, byIdLoading, deleteFetchNow, deleteLoading, resetFormAndCloseDrawer, } = useStudentFeeApiContext();
     const t = useTranslations("studentFee");
     const { theme } = useTheme();
     const workspace = getCachedWorkspaceSync();
-    const listFetchNowRef = useRef(null);
-    const debouncedQuery = useDebounce(state.searchQuery, 800);
     const schoolId = ((_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id) || "";
     // ============================================================================
-    // 1.4.2 API PARAMETERS
-    // ============================================================================
-    const listParams = useMemo(() => (Object.assign({ currentPage: state.currentPage, pageLimit: state.pageLimit, schoolId }, (debouncedQuery ? { searchQuery: debouncedQuery } : {}))), [
-        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,
-        paidAt: state.paidAt || null,
-        remarks: state.remarks || null,
-        schoolId,
-        status: state.status,
-        studentProfileId: state.studentProfileId,
-    }), [
-        state.amount,
-        state.amountDue,
-        state.amountPaid,
-        state.discountAmount,
-        state.discountCodeId,
-        state.dueDate,
-        state.enabled,
-        state.familyId,
-        state.feeStructureId,
-        state.id,
-        state.paidAt,
-        state.remarks,
-        state.status,
-        state.studentProfileId,
-        schoolId,
-    ]);
-    const byIdParams = useMemo(() => ({ id: state.id }), [state.id]);
-    const deleteParams = useMemo(() => ({ id: state.id }), [state.id]);
-    // ============================================================================
-    // 1.4.3 UTILITIES
+    // 1.4.2 UTILITIES
     // ============================================================================
     const showToast = useCallback((description, variant) => {
         generateThemeToast({
@@ -97,21 +48,6 @@ export const useStudentFeeModule = () => {
             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]);
     const resetRecordFormState = useCallback(() => {
         var _a, _b;
         const dueDay = (_a = workspace === null || workspace === void 0 ? void 0 : workspace.dueDateLength) !== null && _a !== void 0 ? _a : 1;
@@ -155,101 +91,43 @@ export const useStudentFeeModule = () => {
         });
     }, [dispatch, workspace === null || workspace === void 0 ? void 0 : workspace.dueDateLength, (_b = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _b === void 0 ? void 0 : _b.id]);
     // ============================================================================
-    // 1.4.4 API CALLBACKS
+    // 1.4.3 UPDATE PARAMS (used by handleSubmit for validation + fetch body)
     // ============================================================================
-    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);
-            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.getFullYear()}-${String(rawDueDate.getMonth() + 1).padStart(2, "0")}-${String(rawDueDate.getDate()).padStart(2, "0")}`
-                : String(rawDueDate).slice(0, 10);
-            const rawPaidAt = fee.paidAt;
-            const today = new Date();
-            const todayStr = `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, "0")}-${String(today.getDate()).padStart(2, "0")}`;
-            const paidAt = rawPaidAt instanceof Date
-                ? `${rawPaidAt.getFullYear()}-${String(rawPaidAt.getMonth() + 1).padStart(2, "0")}-${String(rawPaidAt.getDate()).padStart(2, "0")}`
-                : rawPaidAt
-                    ? String(rawPaidAt).slice(0, 10)
-                    : todayStr;
-            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,
-                        paidAt,
-                        originalFee }),
-                },
-            });
-        }
-    }, [dispatch, showToast, t]);
-    const deleteCallback = useCallback(({ data, error }) => {
-        var _a;
-        if (error) {
-            showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
-            return;
-        }
-        if (data) {
-            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!,
-        },
-    });
+    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,
+        paidAt: state.paidAt || null,
+        remarks: state.remarks || null,
+        schoolId,
+        status: state.status,
+        studentProfileId: state.studentProfileId,
+    }), [
+        state.amount,
+        state.amountDue,
+        state.amountPaid,
+        state.discountAmount,
+        state.discountCodeId,
+        state.dueDate,
+        state.enabled,
+        state.familyId,
+        state.feeStructureId,
+        state.id,
+        state.paidAt,
+        state.remarks,
+        state.status,
+        state.studentProfileId,
+        schoolId,
+    ]);
     // ============================================================================
-    // 1.4.6 HANDLERS
+    // 1.4.4 HANDLERS
     // ============================================================================
     const handleChange = useCallback(async (field, value) => {
         var _a, _b, _c;
@@ -522,15 +400,16 @@ export const useStudentFeeModule = () => {
             payload: { currentPage: 1 },
         });
         listFetchNow === null || listFetchNow === void 0 ? void 0 : listFetchNow(undefined, {
-            params: Object.assign(Object.assign({}, listParams), { filterEnabled: state.filterEnabled, filterStatus: state.filterStatus }),
+            params: Object.assign(Object.assign({ currentPage: 1, pageLimit: state.pageLimit, schoolId }, (state.filterEnabled && { filterEnabled: state.filterEnabled })), (state.filterStatus && { filterStatus: state.filterStatus })),
         });
     }, [
         closeDrawer,
         dispatch,
         listFetchNow,
-        listParams,
+        schoolId,
         state.filterEnabled,
         state.filterStatus,
+        state.pageLimit,
     ]);
     const clearFilters = useCallback(() => {
         dispatch({
@@ -546,7 +425,8 @@ export const useStudentFeeModule = () => {
             type: STUDENT_FEE_ACTION_TYPES.SET_CURRENT_PAGE,
             payload: { currentPage: 1 },
         });
-    }, [dispatch]);
+        listFetchNow();
+    }, [dispatch, listFetchNow]);
     const handleSearch = useCallback((query) => {
         dispatch({
             type: STUDENT_FEE_ACTION_TYPES.SET_SEARCH_QUERY,
@@ -554,10 +434,10 @@ export const useStudentFeeModule = () => {
         });
     }, [dispatch]);
     // ============================================================================
-    // 1.4.7 NETWORK ACTIONS
+    // 1.4.5 NETWORK ACTIONS
     // ============================================================================
     const handleProceedMonthlyCreation = useCallback(async () => {
-        var _a, _b;
+        var _a;
         const schoolId = (_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id;
         if (!schoolId) {
             showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
@@ -580,9 +460,9 @@ export const useStudentFeeModule = () => {
             }
             showToast(t("messagesMonthlyJobQueued"), TOAST_VARIANT.SUCCESS);
             resetFormAndCloseDrawer();
-            (_b = listFetchNowRef.current) === null || _b === void 0 ? void 0 : _b.call(listFetchNowRef);
+            listFetchNow === null || listFetchNow === void 0 ? void 0 : listFetchNow();
         }
-        catch (_c) {
+        catch (_b) {
             showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
         }
         finally {
@@ -591,7 +471,7 @@ export const useStudentFeeModule = () => {
                 payload: { disabled: false },
             });
         }
-    }, [dispatch, showToast, t, (_c = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _c === void 0 ? void 0 : _c.id, resetFormAndCloseDrawer]);
+    }, [dispatch, showToast, t, (_c = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _c === void 0 ? void 0 : _c.id, resetFormAndCloseDrawer, listFetchNow]);
     const handleSubmit = useCallback(() => {
         dispatch({
             type: STUDENT_FEE_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
@@ -619,14 +499,12 @@ export const useStudentFeeModule = () => {
         });
     }, [dispatch, updateParams, t, showToast, updateFetchNow]);
     const handleSubmitSingleEntry = useCallback(async (fees, amountPaid, remarks, paidAt) => {
-        var _a, _b;
-        console.log("Submitting single entry fees:", fees);
+        var _a;
         dispatch({
             type: STUDENT_FEE_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
             payload: { disabled: true },
         });
         try {
-            // const feeIds = fees.map((f) => f.id);
             const res = await fetch(STUDENT_FEE_API_ROUTES.SINGLE_ENTRY, {
                 method: API_METHODS.POST,
                 headers: { "Content-Type": "application/json" },
@@ -645,9 +523,9 @@ export const useStudentFeeModule = () => {
             }
             showToast(t("messagesStudentFeeUpdated"), TOAST_VARIANT.SUCCESS);
             resetFormAndCloseDrawer();
-            (_b = listFetchNowRef.current) === null || _b === void 0 ? void 0 : _b.call(listFetchNowRef);
+            listFetchNow === null || listFetchNow === void 0 ? void 0 : listFetchNow();
         }
-        catch (_c) {
+        catch (_b) {
             showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
         }
         finally {
@@ -656,9 +534,9 @@ export const useStudentFeeModule = () => {
                 payload: { disabled: false },
             });
         }
-    }, [dispatch, showToast, t, (_d = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _d === void 0 ? void 0 : _d.id, resetFormAndCloseDrawer]);
+    }, [dispatch, showToast, t, (_d = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _d === void 0 ? void 0 : _d.id, resetFormAndCloseDrawer, listFetchNow]);
     // ============================================================================
-    // 1.4.8 HEADER & ROW ACTIONS
+    // 1.4.6 HEADER & ROW ACTIONS
     // ============================================================================
     const headerActions = useMemo(() => [
         {
@@ -702,17 +580,7 @@ export const useStudentFeeModule = () => {
         },
     ], [handleDelete, handleEdit, handleView, t]);
     // ============================================================================
-    // 1.4.9 EFFECTS
-    // ============================================================================
-    useEffect(() => {
-        listFetchNowRef.current = listFetchNow;
-    }, [listFetchNow]);
-    useEffect(() => {
-        var _a;
-        (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
-    }, [listParams]);
-    // ============================================================================
-    // 1.4.10 RETURN
+    // 1.4.7 RETURN
     // ============================================================================
     return Object.assign(Object.assign({}, context), { applyFilters,
         byIdLoading,

package/base-modules/student-fee/filter.js

@@ -5,6 +5,10 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *
  * Filter UI for the student-fee list. Supports filterEnabled (radio) and
  * filterStatus (payment status combobox).
+ *
+ * The API provider (StudentFeeApiProvider) manages a single useModuleEntityV2
+ * instance shared across all consumers, so calling useStudentFeeModule from
+ * child components no longer creates redundant API hooks or auto-fetch effects.
  */
 import { EnhancedRadio } from "@appcorp/shadcn/components/enhanced-radio";
 import { useEnhancedCombobox } from "@appcorp/shadcn/hooks/use-enhanced-combobox";

package/base-modules/student-fee/page.js

@@ -19,12 +19,11 @@ import { COMPONENT_TYPE } from "@appcorp/shadcn/components/enhanced-table";
 import { createGenericModulePage, } from "@react-pakistan/util-functions/factory/generic-component-factory";
 import { DATE_FORMATS, formatDate, } from "@react-pakistan/util-functions/general/format-date";
 import { useStudentFeeModule, StudentFeeProvider, STUDENT_FEE_ACTION_TYPES, } from "./context";
+import { StudentFeeApiProvider } from "./context/student-fee-api-provider";
 import { StudentFeeFilter } from "./filter";
 import { StudentFeeForm } from "./form";
 import { StudentFeeMoreActions } from "./more-actions";
 import { StudentFeeView } from "./view";
-// import { StudentFeeSingleEntry } from "./single-entry";
-// import { StudentFeeCreateMonthly } from "./monthly-create";
 import { resolveRbacPermissions } from "../../utils/resolve-rbac-permissions";
 import { RbacNoAccess } from "../../components/rbac-no-access";
 import { formatStudentName, formatAmount, formatAmountPaid, formatAmountDue, } from "./constants";
@@ -201,4 +200,4 @@ const StudentFeePageInner = (props) => {
 // ============================================================================
 // PAGE EXPORTS
 // ============================================================================
-export const StudentFeePage = (props) => (_jsx(StudentFeeProvider, { children: _jsx(StudentFeePageInner, Object.assign({}, props)) }));
+export const StudentFeePage = (props) => (_jsx(StudentFeeProvider, { children: _jsx(StudentFeeApiProvider, { children: _jsx(StudentFeePageInner, Object.assign({}, props)) }) }));