@appcorp/fusion-storybook 0.2.12 → 0.2.14

package/base-modules/admission/context/use-admission-module.js

@@ -0,0 +1,771 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef } from "react";
+import { useTheme } from "next-themes";
+import { useTranslations } from "next-intl";
+import { validateForm, isCreatedOrUpdated, API_METHODS, fetchData, } 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 { ADMISSION_STATUS, GENDER, } from "../../../type";
+import { ADMISSION_API_ROUTES, pageLimit } from "../constants";
+import { admissionFormValidation } from "../validate";
+import { getCachedAdmissions, invalidateAdmissionsCache } from "../cache";
+import { getCachedWorkspaceSync } from "../../workspace/cache";
+import { generateAdmissionReceiptPDF, } from "../../../utils/admission-pdf";
+import { formatNumber } from "@react-pakistan/util-functions/general/format-number";
+import { formatPhoneDisplay } from "@react-pakistan/util-functions/general/format-phone-display";
+import { invalidateFamiliesCache } from "../../family/cache";
+import { invalidateFamilyMembersCache } from "../../family-member/cache";
+import { invalidateStudentProfilesCache } from "../../student-profile/cache";
+import { Filter, Plus } from "lucide-react";
+import { ADMISSION_DRAWER, ADMISSION_ACTION_TYPES, useAdmissionContext, } from "../context";
+export const useAdmissionModule = () => {
+    var _a, _b, _c, _d, _e, _f;
+    // ============================================================================
+    // 1.4.1 STATE & CORE HOOKS
+    // ============================================================================
+    const context = useAdmissionContext();
+    const { dispatch } = context;
+    const state = context.state;
+    const t = useTranslations("admission");
+    const { theme } = useTheme();
+    const workspace = getCachedWorkspaceSync();
+    const listFetchNowRef = useRef(null);
+    const debouncedQuery = useDebounce(state.searchQuery, 800);
+    // ============================================================================
+    // 1.4.2 API PARAMETERS
+    // ============================================================================
+    const listParams = useMemo(() => {
+        var _a;
+        return (Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ currentPage: state.currentPage, pageLimit: state.pageLimit, schoolId: ((_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id) || "" }, (debouncedQuery ? { searchQuery: debouncedQuery } : {})), (state.filterEnabled !== undefined
+            ? { filterEnabled: String(state.filterEnabled) }
+            : {})), (state.filterAdmissionStatus
+            ? { filterAdmissionStatus: state.filterAdmissionStatus }
+            : {})), (state.filterStartDate
+            ? { filterStartDate: state.filterStartDate }
+            : {})), (state.filterEndDate ? { filterEndDate: state.filterEndDate } : {})));
+    }, [
+        state.currentPage,
+        state.filterAdmissionStatus,
+        state.filterEnabled,
+        state.filterEndDate,
+        state.filterStartDate,
+        state.pageLimit,
+        debouncedQuery,
+        (_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id,
+    ]);
+    const updateParams = useMemo(() => {
+        var _a, _b, _c, _d;
+        return ({
+            address: state.address || "",
+            admissionNotes: state.admissionNotes || "",
+            admissionStatus: state.status || ADMISSION_STATUS.PENDING,
+            studentIdNumber: state.studentIdNumber || "",
+            city: state.city || "",
+            classForAdmission: state.classForAdmission || "",
+            country: state.country || "",
+            discountCode: state.discountCode || "",
+            dob: state.dob || null,
+            emergencyContact: state.emergencyContact || "",
+            enabled: (_a = state.enabled) !== null && _a !== void 0 ? _a : true,
+            fatherIdNumber: state.fatherIdNumber || "",
+            fatherFirstName: state.fatherFirstName || "",
+            fatherLastName: state.fatherLastName || "",
+            fatherMobile: formatNumber(state.fatherMobile),
+            fatherOccupation: state.fatherOccupation || "",
+            fatherOrganization: state.fatherOrganization || "",
+            firstName: state.firstName || "",
+            gender: state.gender || null,
+            hafiz: (_b = state.hafiz) !== null && _b !== void 0 ? _b : false,
+            id: state.id || "",
+            lastName: state.lastName || "",
+            motherIdNumber: state.motherIdNumber || "",
+            motherFirstName: state.motherFirstName || "",
+            motherLastName: state.motherLastName || "",
+            motherMobile: formatNumber(state.motherMobile),
+            notes: state.notes || "",
+            orphan: (_c = state.orphan) !== null && _c !== void 0 ? _c : false,
+            postalCode: state.postalCode || "",
+            previousSchool: state.previousSchool || "",
+            registrationCode: state.registrationCode || "",
+            schoolId: ((_d = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _d === void 0 ? void 0 : _d.id) || "",
+            siblings: state.siblings || "",
+            state: state.state || "",
+        });
+    }, [
+        state.address,
+        state.admissionNotes,
+        state.status,
+        state.studentIdNumber,
+        state.city,
+        state.classForAdmission,
+        state.country,
+        state.discountCode,
+        state.dob,
+        state.emergencyContact,
+        state.enabled,
+        state.fatherIdNumber,
+        state.fatherFirstName,
+        state.fatherLastName,
+        state.fatherMobile,
+        state.fatherOccupation,
+        state.fatherOrganization,
+        state.firstName,
+        state.gender,
+        state.hafiz,
+        state.id,
+        state.lastName,
+        state.motherIdNumber,
+        state.motherFirstName,
+        state.motherLastName,
+        state.motherMobile,
+        state.notes,
+        state.orphan,
+        state.postalCode,
+        state.previousSchool,
+        state.registrationCode,
+        state.siblings,
+        state.state,
+        (_b = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _b === void 0 ? void 0 : _b.id,
+    ]);
+    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.filterAdmissionStatus === undefined &&
+        state.filterStartDate === undefined &&
+        state.filterEndDate === undefined;
+    // ============================================================================
+    // 1.4.3 UTILITIES
+    // ============================================================================
+    const showToast = useCallback((description, variant) => {
+        generateThemeToast({
+            description,
+            theme: theme,
+            variant,
+        });
+    }, [theme]);
+    const setField = useCallback((key, value) => {
+        var _a;
+        let formatted = value === null
+            ? undefined
+            : value;
+        if ((key === "fatherMobile" || key === "motherMobile") &&
+            typeof value === "string") {
+            formatted = (_a = formatPhoneDisplay(value)) !== null && _a !== void 0 ? _a : value;
+        }
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key, value: formatted || value },
+        });
+    }, [dispatch]);
+    const resetFormAndCloseDrawer = useCallback(() => {
+        dispatch({ type: ADMISSION_ACTION_TYPES.RESET_FORM });
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_ERRORS,
+            payload: { errors: {} },
+        });
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+            payload: { disabled: false },
+        });
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: null },
+        });
+    }, [dispatch]);
+    // ============================================================================
+    // 1.4.4 API CALLBACKS
+    // ============================================================================
+    const listCallback = useCallback(({ data, error }) => {
+        if (error) {
+            showToast(t("messagesFetchFailed"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_ITEMS,
+                payload: { items: data.items || [], count: data.count || 0 },
+            });
+        }
+    }, [dispatch, showToast, t]);
+    const updateCallback = useCallback(({ data, error }) => {
+        var _a;
+        const isCreated = isCreatedOrUpdated(data);
+        if (error) {
+            showToast(isCreated ? t("messagesCreateFailed") : t("messagesUpdateFailed"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            invalidateAdmissionsCache();
+            showToast(t("messagesSaveSuccess"), TOAST_VARIANT.SUCCESS);
+            resetFormAndCloseDrawer();
+            (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+        }
+    }, [resetFormAndCloseDrawer, showToast, t]);
+    const byIdCallback = useCallback(({ data, error }) => {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12;
+        if (error) {
+            showToast(t("messagesDetailsFetchFailed"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            const admission = data;
+            if ((_a = admission === null || admission === void 0 ? void 0 : admission.fatherDetails) === null || _a === void 0 ? void 0 : _a.emergencyContact) {
+                setField("emergencyContact", "Father");
+            }
+            if ((_b = admission === null || admission === void 0 ? void 0 : admission.motherDetails) === null || _b === void 0 ? void 0 : _b.emergencyContact) {
+                setField("emergencyContact", "Mother");
+            }
+            setField("id", admission.id);
+            setField("firstName", (_c = admission.studentDetails) === null || _c === void 0 ? void 0 : _c.firstName);
+            setField("lastName", (_d = admission.studentDetails) === null || _d === void 0 ? void 0 : _d.lastName);
+            setField("studentIdNumber", (_e = admission.studentDetails) === null || _e === void 0 ? void 0 : _e.studentIdNumber);
+            // Normalise gender to match GENDER enum values (e.g. 'Male' → 'MALE')
+            const rawGender = (_f = admission.studentDetails) === null || _f === void 0 ? void 0 : _f.gender;
+            let normalizedGender = null;
+            if (typeof rawGender === "string" && rawGender.length > 0) {
+                const upper = rawGender.toUpperCase();
+                normalizedGender = Object.values(GENDER).includes(upper)
+                    ? upper
+                    : rawGender;
+            }
+            setField("gender", normalizedGender);
+            setField("dob", (_g = admission.studentDetails) === null || _g === void 0 ? void 0 : _g.dob);
+            setField("registrationCode", (_h = admission.studentDetails) === null || _h === void 0 ? void 0 : _h.registrationCode);
+            setField("discountCode", (_j = admission.studentDetails) === null || _j === void 0 ? void 0 : _j.discountCode);
+            setField("hafiz", (_k = admission.studentDetails) === null || _k === void 0 ? void 0 : _k.hafiz);
+            setField("orphan", (_l = admission.studentDetails) === null || _l === void 0 ? void 0 : _l.orphan);
+            setField("fatherFirstName", (_m = admission.fatherDetails) === null || _m === void 0 ? void 0 : _m.fatherFirstName);
+            setField("fatherLastName", (_o = admission.fatherDetails) === null || _o === void 0 ? void 0 : _o.fatherLastName);
+            setField("fatherIdNumber", (_p = admission.fatherDetails) === null || _p === void 0 ? void 0 : _p.fatherIdNumber);
+            setField("fatherMobile", (_r = formatPhoneDisplay((_q = admission.fatherDetails) === null || _q === void 0 ? void 0 : _q.fatherMobile)) !== null && _r !== void 0 ? _r : (_s = admission.fatherDetails) === null || _s === void 0 ? void 0 : _s.fatherMobile);
+            setField("fatherOccupation", (_t = admission.fatherDetails) === null || _t === void 0 ? void 0 : _t.fatherOccupation);
+            setField("fatherOrganization", (_u = admission.fatherDetails) === null || _u === void 0 ? void 0 : _u.fatherOrganization);
+            setField("motherFirstName", (_v = admission.motherDetails) === null || _v === void 0 ? void 0 : _v.motherFirstName);
+            setField("motherLastName", (_w = admission.motherDetails) === null || _w === void 0 ? void 0 : _w.motherLastName);
+            setField("motherIdNumber", (_x = admission.motherDetails) === null || _x === void 0 ? void 0 : _x.motherIdNumber);
+            setField("motherMobile", (_z = formatPhoneDisplay((_y = admission.motherDetails) === null || _y === void 0 ? void 0 : _y.motherMobile)) !== null && _z !== void 0 ? _z : (_0 = admission.motherDetails) === null || _0 === void 0 ? void 0 : _0.motherMobile);
+            setField("address", (_1 = admission.homeDetails) === null || _1 === void 0 ? void 0 : _1.address);
+            setField("city", (_2 = admission.homeDetails) === null || _2 === void 0 ? void 0 : _2.city);
+            setField("country", (_3 = admission.homeDetails) === null || _3 === void 0 ? void 0 : _3.country);
+            setField("postalCode", (_4 = admission.homeDetails) === null || _4 === void 0 ? void 0 : _4.postalCode);
+            setField("state", (_5 = admission.homeDetails) === null || _5 === void 0 ? void 0 : _5.state);
+            setField("notes", (_6 = admission.officeUse) === null || _6 === void 0 ? void 0 : _6.notes);
+            setField("admissionNotes", (_7 = admission.officeUse) === null || _7 === void 0 ? void 0 : _7.admissionNotes);
+            setField("previousSchool", (_8 = admission.admissionDetails) === null || _8 === void 0 ? void 0 : _8.previousSchool);
+            setField("siblings", (_9 = admission.admissionDetails) === null || _9 === void 0 ? void 0 : _9.siblings);
+            setField("classForAdmission", (_10 = admission.admissionDetails) === null || _10 === void 0 ? void 0 : _10.classForAdmission);
+            setField("status", admission.status || ADMISSION_STATUS.PENDING);
+            setField("enabled", (_11 = admission.enabled) !== null && _11 !== void 0 ? _11 : true);
+            // Populate AI analysis if present
+            const aiAnalysis = (_12 = admission
+                .aiAnalysis) !== null && _12 !== void 0 ? _12 : null;
+            dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_FORM_DATA,
+                payload: { form: { aiAnalysis } },
+            });
+        }
+    }, [dispatch, showToast, t, setField]);
+    const deleteCallback = useCallback(({ data, error }) => {
+        var _a;
+        if (error) {
+            showToast(t("messagesDeleteFailed"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            invalidateAdmissionsCache();
+            showToast(t("messagesDeleteSuccess"), TOAST_VARIANT.SUCCESS);
+            (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+        }
+    }, [showToast, t]);
+    // ============================================================================
+    // 1.4.5 API HOOKS
+    // ============================================================================
+    const { byIdFetchNow, byIdLoading, deleteFetchNow, deleteLoading, listFetchNow, listLoading, updateFetchNow, updateLoading, } = useModuleEntityV2({
+        byIdCallback,
+        byIdParams,
+        deleteCallback,
+        deleteParams,
+        listCallback,
+        listParams,
+        listUrl: ADMISSION_API_ROUTES.UNIT,
+        searchQuery: debouncedQuery,
+        unitByIdUrl: ADMISSION_API_ROUTES.UNIT,
+        unitUrl: ADMISSION_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) => {
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_ERRORS,
+            payload: { errors: {} },
+        });
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+            payload: { disabled: false },
+        });
+        setField(field, value);
+    }, [setField, dispatch]);
+    const handleCloseDrawer = useCallback(() => {
+        resetFormAndCloseDrawer();
+    }, [resetFormAndCloseDrawer]);
+    const handleCreate = useCallback(() => {
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: ADMISSION_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: ADMISSION_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: ADMISSION_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: ADMISSION_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: ADMISSION_DRAWER.FORM_DRAWER },
+        });
+    }, [dispatch, byIdFetchNow]);
+    const handleDelete = useCallback((row) => {
+        if (!confirm(t("actionDeleteConfirmation")))
+            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: ADMISSION_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: ADMISSION_DRAWER.FILTER_DRAWER },
+        });
+    }, [dispatch]);
+    const handlePageChange = useCallback((page) => {
+        const nextPage = typeof page === "number" ? page : state.currentPage + 1;
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: nextPage },
+        });
+    }, [dispatch, state.currentPage]);
+    const handlePageLimitChange = useCallback((k, value) => {
+        const val = Object.assign({}, value);
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_PAGE_LIMIT,
+            payload: { pageLimit: Number(val.option) },
+        });
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+    }, [dispatch]);
+    const handleSearch = useCallback((query) => {
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_SEARCH_QUERY,
+            payload: { searchQuery: query },
+        });
+    }, [dispatch]);
+    const handleSetStartDate = useCallback((startDate) => {
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key: "filterStartDate", value: startDate },
+        });
+    }, [dispatch]);
+    const handleSetEndDate = useCallback((endDate) => {
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key: "filterEndDate", value: endDate },
+        });
+    }, [dispatch]);
+    const clearFilters = useCallback(() => {
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_FILTERS,
+            payload: {
+                filters: {
+                    filterEnabled: undefined,
+                    filterAdmissionStatus: undefined,
+                    filterStartDate: undefined,
+                    filterEndDate: undefined,
+                    appliedFilterEnabled: undefined,
+                    appliedFilterAdmissionStatus: undefined,
+                    appliedFilterStartDate: undefined,
+                    appliedFilterEndDate: undefined,
+                },
+            },
+        });
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+    }, [dispatch]);
+    const handlePrint = useCallback(async (row) => {
+        var _a, _b, _c, _d, _e;
+        if (!row)
+            return;
+        const logoBase64Res = await fetch(`/api/v1/auth/image-url-to-base64`, {
+            method: API_METHODS.POST,
+            body: JSON.stringify({ url: (_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.logo }),
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-token": process.env.NEXT_PUBLIC_API_KEY,
+            },
+        });
+        const logoBase64 = await logoBase64Res.json();
+        try {
+            const rowRecord = row;
+            const studentDetails = rowRecord.studentDetails || {};
+            const admissionDetails = rowRecord.admissionDetails || {};
+            const fatherDetails = rowRecord.fatherDetails || {};
+            const motherDetails = rowRecord.motherDetails || {};
+            const homeDetails = rowRecord.homeDetails || {};
+            const pdfData = {
+                firstName: studentDetails.firstName || "",
+                lastName: studentDetails.lastName || "",
+                studentIdNumber: studentDetails.studentIdNumber || "",
+                gender: studentDetails.gender || "",
+                dob: studentDetails.dob || "",
+                registrationCode: studentDetails.registrationCode || "",
+                discountCode: studentDetails.discountCode,
+                fatherFirstName: fatherDetails.fatherFirstName || "",
+                fatherLastName: fatherDetails.fatherLastName || "",
+                fatherIdNumber: fatherDetails.fatherIdNumber || "",
+                fatherMobile: fatherDetails.fatherMobile || "",
+                fatherOccupation: fatherDetails.fatherOccupation,
+                fatherOrganization: fatherDetails.fatherOrganization,
+                motherFirstName: motherDetails.motherFirstName || "",
+                motherLastName: motherDetails.motherLastName || "",
+                motherIdNumber: motherDetails.motherIdNumber || "",
+                motherMobile: motherDetails.motherMobile || "",
+                address: homeDetails.address || "",
+                city: homeDetails.city || "",
+                state: homeDetails.state || "",
+                country: homeDetails.country || "",
+                classForAdmission: admissionDetails.classForAdmission || "",
+                previousSchool: admissionDetails.previousSchool,
+                siblings: admissionDetails.siblings,
+                notes: admissionDetails.notes,
+                admissionNotes: admissionDetails.admissionNotes,
+                schoolName: ((_b = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _b === void 0 ? void 0 : _b.name) || undefined,
+                schoolAddress: ((_c = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _c === void 0 ? void 0 : _c.address) || undefined,
+                schoolPhone: ((_d = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _d === void 0 ? void 0 : _d.phone) || undefined,
+                schoolEmail: ((_e = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _e === void 0 ? void 0 : _e.email) || undefined,
+                submissionDate: (row === null || row === void 0 ? void 0 : row.createdAt)
+                    ? new Date(row === null || row === void 0 ? void 0 : row.createdAt).toLocaleDateString()
+                    : undefined,
+                admissionStatus: admissionDetails.admissionStatus,
+                logo: logoBase64.base64,
+            };
+            await generateAdmissionReceiptPDF(pdfData);
+        }
+        catch (_f) {
+            showToast(t("messagesPrintFailed"), TOAST_VARIANT.ERROR);
+        }
+    }, [workspace, t, showToast]);
+    const handleAddStudent = useCallback(async (row) => {
+        var _a;
+        const tableRow = row;
+        const { data, error } = await fetchData({
+            url: "/api/v1/admit-student",
+            method: API_METHODS.POST,
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-token": process.env.NEXT_PUBLIC_API_KEY,
+            },
+            body: JSON.stringify({ admissionId: tableRow === null || tableRow === void 0 ? void 0 : tableRow.id }),
+        });
+        (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+        invalidateAdmissionsCache();
+        invalidateFamiliesCache();
+        invalidateFamilyMembersCache();
+        invalidateStudentProfilesCache();
+        if (data) {
+            showToast(t("messagesAdmitSuccess"), TOAST_VARIANT.SUCCESS);
+        }
+        if (error) {
+            showToast(t("messagesAdmitFailed"), TOAST_VARIANT.ERROR);
+        }
+    }, [t, showToast]);
+    // ============================================================================
+    // 1.4.7 NETWORK ACTIONS
+    // ============================================================================
+    const handleAnalyze = useCallback(async (row) => {
+        var _a, _b, _c, _d;
+        const tableRow = row;
+        if (!(tableRow === null || tableRow === void 0 ? void 0 : tableRow.id))
+            return;
+        const schoolId = (_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id;
+        if (!schoolId)
+            return;
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key: "analyzeLoading", value: true },
+        });
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_FORM_DATA,
+            payload: { form: { analyzeError: null } },
+        });
+        // Open view drawer so user can watch progress
+        await (byIdFetchNow === null || byIdFetchNow === void 0 ? void 0 : byIdFetchNow(undefined, { params: { id: tableRow.id } }));
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: ADMISSION_DRAWER.VIEW_DRAWER },
+        });
+        const { data, error } = await fetchData({
+            url: `/api/v1/admission/analyze`,
+            method: API_METHODS.POST,
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-token": process.env.NEXT_PUBLIC_API_KEY,
+            },
+            body: JSON.stringify({ id: tableRow.id, schoolId }),
+        });
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key: "analyzeLoading", value: false },
+        });
+        if (error) {
+            dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_FORM_DATA,
+                payload: { form: { analyzeError: t("messagesAnalyzeFailed") } },
+            });
+            showToast(t("messagesAnalyzeFailed"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        const result = data;
+        if (result === null || result === void 0 ? void 0 : result.aiAnalysis) {
+            dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_FORM_DATA,
+                payload: { form: { aiAnalysis: result.aiAnalysis } },
+            });
+        }
+        invalidateAdmissionsCache();
+        (_b = listFetchNowRef.current) === null || _b === void 0 ? void 0 : _b.call(listFetchNowRef);
+        generateThemeToast({
+            description: `${t("messagesAnalyzeSuccess")} ${(_c = result === null || result === void 0 ? void 0 : result.score) !== null && _c !== void 0 ? _c : "N/A"} — ${(_d = result === null || result === void 0 ? void 0 : result.status) !== null && _d !== void 0 ? _d : ""}`,
+            variant: TOAST_VARIANT.SUCCESS,
+        });
+    }, [(_c = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _c === void 0 ? void 0 : _c.id, t, showToast, byIdFetchNow, dispatch]);
+    const handleSubmit = useCallback(() => {
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+            payload: { disabled: true },
+        });
+        validateForm({
+            params: updateParams,
+            schema: admissionFormValidation,
+            successCallback: () => {
+                var _a;
+                updateFetchNow(undefined, {
+                    body: JSON.stringify({
+                        schoolId: (_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id,
+                        admissionDetails: {
+                            classForAdmission: updateParams.classForAdmission,
+                            previousSchool: updateParams.previousSchool,
+                            siblings: updateParams.siblings,
+                        },
+                        fatherDetails: {
+                            fatherIdNumber: updateParams.fatherIdNumber,
+                            fatherFirstName: updateParams.fatherFirstName,
+                            fatherLastName: updateParams.fatherLastName,
+                            fatherMobile: updateParams.fatherMobile,
+                            fatherOccupation: updateParams.fatherOccupation,
+                            fatherOrganization: updateParams.fatherOrganization,
+                            emergencyContact: updateParams.emergencyContact === "Father",
+                        },
+                        motherDetails: {
+                            motherIdNumber: updateParams.motherIdNumber || "",
+                            motherFirstName: updateParams.motherFirstName || "N/A",
+                            motherLastName: updateParams.motherLastName || "N/A",
+                            motherMobile: updateParams.motherMobile,
+                            emergencyContact: updateParams.emergencyContact === "Mother",
+                        },
+                        homeDetails: {
+                            address: updateParams.address,
+                            city: updateParams.city,
+                            country: updateParams.country,
+                            postalCode: updateParams.postalCode,
+                            state: updateParams.state,
+                        },
+                        officeUse: {
+                            notes: updateParams.notes,
+                            admissionNotes: updateParams.admissionNotes,
+                        },
+                        studentDetails: {
+                            studentIdNumber: updateParams.studentIdNumber,
+                            discountCode: updateParams.discountCode,
+                            dob: updateParams.dob,
+                            firstName: updateParams.firstName,
+                            gender: updateParams.gender,
+                            hafiz: updateParams.hafiz,
+                            lastName: updateParams.lastName,
+                            orphan: updateParams.orphan,
+                            registrationCode: updateParams.registrationCode,
+                        },
+                    }),
+                });
+            },
+            errorCallback: (errors) => {
+                dispatch({
+                    type: ADMISSION_ACTION_TYPES.SET_ERRORS,
+                    payload: { errors },
+                });
+                dispatch({
+                    type: ADMISSION_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+                    payload: { disabled: false },
+                });
+                showToast(t("messagesFormErrors"), TOAST_VARIANT.ERROR);
+            },
+        });
+    }, [
+        dispatch,
+        updateParams,
+        t,
+        showToast,
+        updateFetchNow,
+        (_d = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _d === void 0 ? void 0 : _d.id,
+    ]);
+    // ============================================================================
+    // 1.4.8 HEADER & ROW ACTIONS
+    // ============================================================================
+    const hasGeminiSecrets = Boolean(((_e = workspace === null || workspace === void 0 ? void 0 : workspace.secrets) === null || _e === void 0 ? void 0 : _e.GEMINI_API_KEY) && ((_f = workspace === null || workspace === void 0 ? void 0 : workspace.secrets) === null || _f === void 0 ? void 0 : _f.GEMINI_MODEL));
+    const headerActions = useMemo(() => [
+        {
+            enabled: true,
+            handleOnClick: handleFilters,
+            label: t("actionHeaderFilters"),
+            order: 1,
+            icon: Filter,
+        },
+        {
+            enabled: true,
+            handleOnClick: handleCreate,
+            label: t("actionHeaderAddAdmission"),
+            order: 2,
+            icon: Plus,
+        },
+    ], [handleFilters, handleCreate, t]);
+    const rowActions = useMemo(() => [
+        {
+            enabled: true,
+            handleOnClick: handleView,
+            label: t("actionRowView"),
+            order: 1,
+        },
+        {
+            enabled: (row) => (row === null || row === void 0 ? void 0 : row.status) === ADMISSION_STATUS.PENDING,
+            handleOnClick: handleEdit,
+            label: t("actionRowEdit"),
+            order: 2,
+        },
+        {
+            enabled: (row) => (row === null || row === void 0 ? void 0 : row.status) === ADMISSION_STATUS.PENDING,
+            handleOnClick: handleDelete,
+            label: t("actionRowDelete"),
+            order: 3,
+            variant: "destructive",
+        },
+        {
+            enabled: true,
+            handleOnClick: handlePrint,
+            label: t("actionRowPrintPdf"),
+            order: 4,
+        },
+        {
+            enabled: (row) => hasGeminiSecrets &&
+                (row === null || row === void 0 ? void 0 : row.status) === ADMISSION_STATUS.PENDING,
+            handleOnClick: handleAnalyze,
+            label: t("actionRowAnalyzeWithAi"),
+            order: 5,
+        },
+        {
+            enabled: (row) => (row === null || row === void 0 ? void 0 : row.status) !== ADMISSION_STATUS.APPROVED,
+            handleOnClick: handleAddStudent,
+            label: t("actionRowAddStudent"),
+            order: 6,
+        },
+    ], [
+        handleView,
+        handleEdit,
+        handleDelete,
+        handlePrint,
+        handleAnalyze,
+        handleAddStudent,
+        hasGeminiSecrets,
+        t,
+    ]);
+    const applyFilters = useCallback(() => {
+        dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+        handleCloseDrawer();
+    }, [dispatch, handleCloseDrawer]);
+    // ============================================================================
+    // 1.4.9 EFFECTS
+    // ============================================================================
+    // Initial load + re-fetch on page/search/filter change via cache
+    useEffect(() => {
+        var _a;
+        if (!(workspace === null || workspace === void 0 ? void 0 : workspace.id))
+            return;
+        if (isDefaultListState) {
+            (async () => {
+                try {
+                    const { count, items } = await getCachedAdmissions({
+                        params: listParams,
+                    });
+                    dispatch({
+                        type: ADMISSION_ACTION_TYPES.SET_ITEMS,
+                        payload: { items: items || [], count: count || 0 },
+                    });
+                }
+                catch (_a) {
+                    showToast(t("messagesFetchFailed"), TOAST_VARIANT.ERROR);
+                }
+            })();
+            return;
+        }
+        (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+    }, [dispatch, isDefaultListState, listParams, workspace === null || workspace === void 0 ? void 0 : workspace.id, t, showToast]);
+    // Sync ref to always point at latest listFetchNow (avoids stale closure in callbacks)
+    useEffect(() => {
+        listFetchNowRef.current = listFetchNow;
+    }, [listFetchNow]);
+    // ============================================================================
+    // 1.4.10 RETURN
+    // ============================================================================
+    return Object.assign(Object.assign({}, context), { applyFilters,
+        byIdLoading,
+        clearFilters,
+        deleteLoading,
+        handleAddStudent,
+        handleAnalyze,
+        handleChange,
+        handleCloseDrawer,
+        handleCreate,
+        handleDelete,
+        handleEdit,
+        handleFilters,
+        handlePageChange,
+        handlePageLimitChange,
+        handlePrint,
+        handleSearch,
+        handleSetEndDate,
+        handleSetStartDate,
+        handleSubmit,
+        handleView,
+        headerActions,
+        listLoading,
+        rowActions,
+        updateLoading });
+};