@appcorp/fusion-storybook 0.1.4

package/base-modules/admission/context.js

@@ -0,0 +1,755 @@
+"use client";
+/**
+ * Admission Module — business logic + API integration
+ *
+ * Wires the generic module state (created by `createGenericModule`) to network
+ * actions using `useModuleEntityV2`. Contains domain-specific handlers for
+ * create/view/edit/delete, AI analysis, PDF printing, and admit-student flow.
+ *
+ * Key responsibilities:
+ * - expose `useAdmissionModule()` which UI components call for actions
+ * - keep module-specific `apiParams` and callbacks in one place
+ * - ensure cache invalidation and toast notifications on mutation
+ *
+ * Exported utilities:
+ * - `AdmissionProvider` — provider component used by the page
+ * - `AdmissionStateContextProvider` — backward-compat alias for dashboard-providers.tsx
+ * - `ADMISSION_ACTION_TYPES` — action type constants (from factory)
+ * - `ADMISSION_DRAWER` — drawer type constants
+ * - `useAdmissionModule()` — hook that returns state, dispatch, and handlers
+ */
+import { useCallback, useEffect, useMemo } from "react";
+import { validateForm, isCreatedOrUpdated, API_METHODS, fetchData, } from "@react-pakistan/util-functions";
+import { formatCnic } from "@react-pakistan/util-functions/general/cnic-formatter";
+import { formatPhone } from "@react-pakistan/util-functions/general/format-phone";
+import { useModuleEntityV2, } from "@react-pakistan/util-functions/hooks/use-module-entity-v2";
+import { useDebounce } from "@react-pakistan/util-functions/hooks/use-debounce";
+import { createGenericModule } from "@react-pakistan/util-functions/factory/generic-module-factory";
+import { DRAWER_TYPES } from "@react-pakistan/util-functions/factory/generic-component-factory";
+import { generateThemeToast, TOAST_VARIANT, } from "@appcorp/shadcn/lib/toast-utils";
+import { ADMISSION_STATUS, GENDER, } from "../../type";
+import { useTranslations } from "next-intl";
+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 { invalidateFamiliesCache } from "../family/cache";
+import { invalidateFamilyMembersCache } from "../family-member/cache";
+import { invalidateStudentProfilesCache } from "../student-profile/cache";
+import { Filter, Plus } from "lucide-react";
+// ============================================================================
+// DRAWER TYPES
+// ============================================================================
+export const ADMISSION_DRAWER = {
+    FILTER_DRAWER: DRAWER_TYPES.FILTER_DRAWER,
+    FORM_DRAWER: DRAWER_TYPES.FORM_DRAWER,
+    MORE_ACTIONS_DRAWER: "MORE_ACTIONS_DRAWER",
+    VIEW_DRAWER: DRAWER_TYPES.VIEW_DRAWER,
+};
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+const admissionConfig = {
+    name: "Admission",
+    displayName: "Admission",
+    initialState: {
+        // List data
+        items: [],
+        count: 0,
+        // Search & Pagination
+        currentPage: 1,
+        pageLimit,
+        searchQuery: "",
+        // UI State
+        disableSaveButton: false,
+        drawer: null,
+        errors: {},
+        // Form — student detail
+        id: "",
+        bForm: "",
+        discountCode: "",
+        dob: new Date().toISOString().slice(0, 10),
+        emergencyContact: "Mother",
+        firstName: "",
+        gender: GENDER.MALE,
+        hafiz: false,
+        lastName: "",
+        orphan: false,
+        registrationCode: "",
+        // Form — father detail
+        fatherCnic: "",
+        fatherFirstName: "",
+        fatherLastName: "",
+        fatherMobile: "",
+        fatherOccupation: "",
+        fatherOrganization: "",
+        // Form — mother detail
+        motherCnic: "",
+        motherFirstName: "",
+        motherLastName: "",
+        motherMobile: "",
+        // Form — home detail
+        address: "",
+        city: "",
+        country: "",
+        postalCode: "",
+        state: "",
+        // Form — admission detail
+        classForAdmission: "",
+        previousSchool: "",
+        siblings: "",
+        // Form — office use
+        admissionNotes: "",
+        notes: "",
+        // Status / meta
+        enabled: true,
+        status: ADMISSION_STATUS.PENDING,
+        admissionStatus: ADMISSION_STATUS.PENDING,
+        schoolId: "",
+        familyId: null,
+        // AI analysis state
+        aiAnalysis: null,
+        analyzeLoading: false,
+        analyzeError: null,
+        // Filter State
+        filterEnabled: undefined,
+        filterAdmissionStatus: undefined,
+        filterStartDate: undefined,
+        filterEndDate: undefined,
+    },
+    drawerTypes: DRAWER_TYPES,
+};
+// ============================================================================
+// CREATE ADMISSION MODULE
+// ============================================================================
+export const { actionTypes: ADMISSION_ACTION_TYPES, config: admissionModuleConfig, initialState: initialAdmissionState, Provider: AdmissionProvider, reducer: admissionReducer, useContext: useAdmissionContext, } = createGenericModule(admissionConfig);
+// ============================================================================
+// ENHANCED ADMISSION HOOK WITH API INTEGRATION
+// ============================================================================
+export const useAdmissionModule = () => {
+    var _a, _b, _c, _d, _e;
+    const context = useAdmissionContext();
+    const t = useTranslations("admission");
+    const workspace = getCachedWorkspaceSync();
+    const debouncedQuery = useDebounce(context.state.searchQuery, 800);
+    // ============================================================================
+    // API PARAMETERS
+    // ============================================================================
+    const listParams = useMemo(() => {
+        var _a;
+        return (Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ currentPage: context.state.currentPage, pageLimit: context.state.pageLimit, schoolId: ((_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id) || "" }, (debouncedQuery ? { searchQuery: debouncedQuery } : {})), (context.state.filterEnabled !== undefined
+            ? { filterEnabled: String(context.state.filterEnabled) }
+            : {})), (context.state.filterAdmissionStatus
+            ? { filterAdmissionStatus: context.state.filterAdmissionStatus }
+            : {})), (context.state.filterStartDate
+            ? { filterStartDate: context.state.filterStartDate }
+            : {})), (context.state.filterEndDate
+            ? { filterEndDate: context.state.filterEndDate }
+            : {})));
+    }, [
+        context.state.currentPage,
+        context.state.filterAdmissionStatus,
+        context.state.filterEnabled,
+        context.state.filterEndDate,
+        context.state.filterStartDate,
+        context.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: context.state.address || "",
+            admissionNotes: context.state.admissionNotes || "",
+            admissionStatus: context.state.status || ADMISSION_STATUS.PENDING,
+            bForm: context.state.bForm || "",
+            city: context.state.city || "",
+            classForAdmission: context.state.classForAdmission || "",
+            country: context.state.country || "",
+            discountCode: context.state.discountCode || "",
+            dob: context.state.dob || null,
+            emergencyContact: context.state.emergencyContact || "",
+            enabled: (_a = context.state.enabled) !== null && _a !== void 0 ? _a : true,
+            fatherCnic: context.state.fatherCnic || "",
+            fatherFirstName: context.state.fatherFirstName || "",
+            fatherLastName: context.state.fatherLastName || "",
+            fatherMobile: context.state.fatherMobile || "",
+            fatherOccupation: context.state.fatherOccupation || "",
+            fatherOrganization: context.state.fatherOrganization || "",
+            firstName: context.state.firstName || "",
+            gender: context.state.gender || null,
+            hafiz: (_b = context.state.hafiz) !== null && _b !== void 0 ? _b : false,
+            id: context.state.id || "",
+            lastName: context.state.lastName || "",
+            motherCnic: context.state.motherCnic || "",
+            motherFirstName: context.state.motherFirstName || "",
+            motherLastName: context.state.motherLastName || "",
+            motherMobile: context.state.motherMobile || "",
+            notes: context.state.notes || "",
+            orphan: (_c = context.state.orphan) !== null && _c !== void 0 ? _c : false,
+            postalCode: context.state.postalCode || "",
+            previousSchool: context.state.previousSchool || "",
+            registrationCode: context.state.registrationCode || "",
+            schoolId: ((_d = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _d === void 0 ? void 0 : _d.id) || "",
+            siblings: context.state.siblings || "",
+            state: context.state.state || "",
+        });
+    }, [context.state, (_b = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _b === void 0 ? void 0 : _b.id]);
+    const byIdParams = useMemo(() => ({ id: context.state.id }), [context.state.id]);
+    const deleteParams = useMemo(() => ({ id: context.state.id }), [context.state.id]);
+    // ============================================================================
+    // API CALLBACKS
+    // ============================================================================
+    const listCallback = ({ data, error }) => {
+        if (error) {
+            showToast(t("messagesFetchFailed"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            context.dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_ITEMS,
+                payload: { items: data.items || [], count: data.count || 0 },
+            });
+        }
+    };
+    const updateCallback = ({ data, error }) => {
+        const isCreated = isCreatedOrUpdated(data);
+        if (error) {
+            showToast(isCreated ? t("messagesCreateFailed") : t("messagesUpdateFailed"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            showToast(t("messagesSaveSuccess"), TOAST_VARIANT.SUCCESS);
+            invalidateAdmissionsCache();
+            listFetchNow();
+            resetFormAndCloseDrawer();
+        }
+    };
+    const byIdCallback = ({ 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;
+        if (error) {
+            showToast(t("messagesDetailsFetchFailed"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            const admission = data;
+            setField("id", admission.id);
+            setField("firstName", (_a = admission.studentDetails) === null || _a === void 0 ? void 0 : _a.firstName);
+            setField("lastName", (_b = admission.studentDetails) === null || _b === void 0 ? void 0 : _b.lastName);
+            setField("bForm", (_c = admission.studentDetails) === null || _c === void 0 ? void 0 : _c.bForm);
+            // Normalise gender to match GENDER enum values (e.g. 'Male' → 'MALE')
+            const rawGender = (_d = admission.studentDetails) === null || _d === void 0 ? void 0 : _d.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", (_e = admission.studentDetails) === null || _e === void 0 ? void 0 : _e.dob);
+            setField("registrationCode", (_f = admission.studentDetails) === null || _f === void 0 ? void 0 : _f.registrationCode);
+            setField("discountCode", (_g = admission.studentDetails) === null || _g === void 0 ? void 0 : _g.discountCode);
+            setField("hafiz", (_h = admission.studentDetails) === null || _h === void 0 ? void 0 : _h.hafiz);
+            setField("orphan", (_j = admission.studentDetails) === null || _j === void 0 ? void 0 : _j.orphan);
+            setField("fatherFirstName", (_k = admission.fatherDetails) === null || _k === void 0 ? void 0 : _k.fatherFirstName);
+            setField("fatherLastName", (_l = admission.fatherDetails) === null || _l === void 0 ? void 0 : _l.fatherLastName);
+            setField("fatherCnic", (_m = admission.fatherDetails) === null || _m === void 0 ? void 0 : _m.fatherCnic);
+            setField("fatherMobile", (_o = admission.fatherDetails) === null || _o === void 0 ? void 0 : _o.fatherMobile);
+            setField("fatherOccupation", (_p = admission.fatherDetails) === null || _p === void 0 ? void 0 : _p.fatherOccupation);
+            setField("fatherOrganization", (_q = admission.fatherDetails) === null || _q === void 0 ? void 0 : _q.fatherOrganization);
+            setField("motherFirstName", (_r = admission.motherDetails) === null || _r === void 0 ? void 0 : _r.motherFirstName);
+            setField("motherLastName", (_s = admission.motherDetails) === null || _s === void 0 ? void 0 : _s.motherLastName);
+            setField("motherCnic", (_t = admission.motherDetails) === null || _t === void 0 ? void 0 : _t.motherCnic);
+            setField("motherMobile", (_u = admission.motherDetails) === null || _u === void 0 ? void 0 : _u.motherMobile);
+            setField("address", (_v = admission.homeDetails) === null || _v === void 0 ? void 0 : _v.address);
+            setField("city", (_w = admission.homeDetails) === null || _w === void 0 ? void 0 : _w.city);
+            setField("country", (_x = admission.homeDetails) === null || _x === void 0 ? void 0 : _x.country);
+            setField("postalCode", (_y = admission.homeDetails) === null || _y === void 0 ? void 0 : _y.postalCode);
+            setField("state", (_z = admission.homeDetails) === null || _z === void 0 ? void 0 : _z.state);
+            setField("notes", (_0 = admission.officeUse) === null || _0 === void 0 ? void 0 : _0.notes);
+            setField("admissionNotes", (_1 = admission.officeUse) === null || _1 === void 0 ? void 0 : _1.admissionNotes);
+            setField("previousSchool", (_2 = admission.admissionDetails) === null || _2 === void 0 ? void 0 : _2.previousSchool);
+            setField("siblings", (_3 = admission.admissionDetails) === null || _3 === void 0 ? void 0 : _3.siblings);
+            setField("classForAdmission", (_4 = admission.admissionDetails) === null || _4 === void 0 ? void 0 : _4.classForAdmission);
+            setField("status", admission.status || ADMISSION_STATUS.PENDING);
+            setField("enabled", (_5 = admission.enabled) !== null && _5 !== void 0 ? _5 : true);
+            // Populate AI analysis if present
+            const aiAnalysis = (_6 = admission
+                .aiAnalysis) !== null && _6 !== void 0 ? _6 : null;
+            context.dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_FORM_DATA,
+                payload: { form: { aiAnalysis } },
+            });
+        }
+    };
+    const deleteCallback = ({ data, error }) => {
+        if (error) {
+            showToast(t("messagesDeleteFailed"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            showToast(t("messagesDeleteSuccess"), TOAST_VARIANT.SUCCESS);
+            invalidateAdmissionsCache();
+            listFetchNow();
+        }
+    };
+    // ============================================================================
+    // API HOOKS
+    // ============================================================================
+    const { listFetchNow, listLoading, updateFetchNow, updateLoading, byIdFetchNow, deleteFetchNow, deleteLoading, byIdLoading, } = 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,
+        },
+    });
+    // ============================================================================
+    // UTILITIES
+    // ============================================================================
+    const showToast = useCallback((message, variant) => {
+        generateThemeToast({ description: message, variant });
+    }, []);
+    const resetFormAndCloseDrawer = useCallback(() => {
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_ERRORS,
+            payload: { errors: {} },
+        });
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+            payload: { disabled: false },
+        });
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: null },
+        });
+    }, [context]);
+    const setField = useCallback((key, value) => {
+        var _a, _b, _c;
+        let formatted = value === null
+            ? undefined
+            : value;
+        if ((key === "bForm" || key === "fatherCnic" || key === "motherCnic") &&
+            typeof value === "string" &&
+            value.length === 13) {
+            formatted = (_a = formatCnic(value)) !== null && _a !== void 0 ? _a : value;
+        }
+        if ((key === "fatherMobile" || key === "motherMobile") &&
+            typeof value === "string" &&
+            value.length >= 13) {
+            formatted = (_c = (_b = formatPhone(value, "PK")) === null || _b === void 0 ? void 0 : _b.international) !== null && _c !== void 0 ? _c : value;
+        }
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key, value: formatted || value },
+        });
+    }, [context]);
+    // ============================================================================
+    // HANDLERS
+    // ============================================================================
+    const handleChange = useCallback((field, value) => {
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_ERRORS,
+            payload: { errors: {} },
+        });
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+            payload: { disabled: false },
+        });
+        setField(field, value);
+    }, [setField, context]);
+    const handleCloseDrawer = useCallback(() => {
+        resetFormAndCloseDrawer();
+    }, [resetFormAndCloseDrawer]);
+    const handleCreate = useCallback(() => {
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: ADMISSION_DRAWER.FORM_DRAWER },
+        });
+    }, [context]);
+    const handleView = useCallback((row) => {
+        byIdFetchNow === null || byIdFetchNow === void 0 ? void 0 : byIdFetchNow(undefined, { params: { id: row === null || row === void 0 ? void 0 : row.id } });
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: ADMISSION_DRAWER.VIEW_DRAWER },
+        });
+    }, [context, 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 } });
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: ADMISSION_DRAWER.FORM_DRAWER },
+        });
+    }, [context, byIdFetchNow]);
+    const handleDelete = useCallback((row) => {
+        if (!confirm(t("areYouSureYouWantToDeleteThisAdmission")))
+            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(() => {
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: ADMISSION_DRAWER.FILTER_DRAWER },
+        });
+    }, [context]);
+    const handlePageChange = useCallback((page) => {
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: page },
+        });
+    }, [context]);
+    const handlePageLimitChange = useCallback((limit) => {
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_PAGE_LIMIT,
+            payload: { pageLimit: limit },
+        });
+    }, [context]);
+    const handleSearch = useCallback((query) => {
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_SEARCH_QUERY,
+            payload: { searchQuery: query },
+        });
+    }, [context]);
+    const handleSetStartDate = useCallback((startDate) => {
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key: "filterStartDate", value: startDate },
+        });
+    }, [context]);
+    const handleSetEndDate = useCallback((endDate) => {
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key: "filterEndDate", value: endDate },
+        });
+    }, [context]);
+    const clearFilters = useCallback(() => {
+        context.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,
+                },
+            },
+        });
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+    }, [context]);
+    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 || "",
+                bForm: studentDetails.bForm || "",
+                gender: studentDetails.gender || "",
+                dob: studentDetails.dob || "",
+                registrationCode: studentDetails.registrationCode || "",
+                discountCode: studentDetails.discountCode,
+                fatherFirstName: fatherDetails.fatherFirstName || "",
+                fatherLastName: fatherDetails.fatherLastName || "",
+                fatherCnic: fatherDetails.fatherCnic || "",
+                fatherMobile: fatherDetails.fatherMobile || "",
+                fatherOccupation: fatherDetails.fatherOccupation,
+                fatherOrganization: fatherDetails.fatherOrganization,
+                motherFirstName: motherDetails.motherFirstName || "",
+                motherLastName: motherDetails.motherLastName || "",
+                motherCnic: motherDetails.motherCnic || "",
+                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) => {
+        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 }),
+        });
+        listFetchNow();
+        invalidateAdmissionsCache();
+        invalidateFamiliesCache();
+        invalidateFamilyMembersCache();
+        invalidateStudentProfilesCache();
+        if (data) {
+            showToast(t("messagesAdmitSuccess"), TOAST_VARIANT.SUCCESS);
+        }
+        if (error) {
+            showToast(t("messagesAdmitFailed"), TOAST_VARIANT.ERROR);
+        }
+    }, [t, showToast, listFetchNow]);
+    // ============================================================================
+    // NETWORK ACTIONS
+    // ============================================================================
+    const handleAnalyze = useCallback(async (row) => {
+        var _a, _b, _c;
+        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;
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key: "analyzeLoading", value: true },
+        });
+        context.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 } }));
+        context.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 }),
+        });
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key: "analyzeLoading", value: false },
+        });
+        if (error) {
+            context.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) {
+            context.dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_FORM_DATA,
+                payload: { form: { aiAnalysis: result.aiAnalysis } },
+            });
+        }
+        invalidateAdmissionsCache();
+        listFetchNow();
+        generateThemeToast({
+            description: `${t("messagesAnalyzeSuccess")} ${(_b = result === null || result === void 0 ? void 0 : result.score) !== null && _b !== void 0 ? _b : "N/A"} — ${(_c = result === null || result === void 0 ? void 0 : result.status) !== null && _c !== void 0 ? _c : ""}`,
+            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, listFetchNow, context]);
+    const handleSubmit = useCallback(() => {
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+            payload: { disabled: true },
+        });
+        validateForm({
+            params: updateParams,
+            schema: admissionFormValidation,
+            successCallback: () => {
+                updateFetchNow(undefined, {
+                    body: JSON.stringify(updateParams),
+                });
+            },
+            errorCallback: (errors) => {
+                context.dispatch({
+                    type: ADMISSION_ACTION_TYPES.SET_ERRORS,
+                    payload: { errors },
+                });
+                context.dispatch({
+                    type: ADMISSION_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+                    payload: { disabled: false },
+                });
+                showToast(t("messagesFormErrors"), TOAST_VARIANT.ERROR);
+            },
+        });
+    }, [context, updateParams, t, showToast, updateFetchNow]);
+    // ============================================================================
+    // HEADER & ROW ACTIONS
+    // ============================================================================
+    const hasGeminiSecrets = Boolean(((_d = workspace === null || workspace === void 0 ? void 0 : workspace.secrets) === null || _d === void 0 ? void 0 : _d.GEMINI_API_KEY) && ((_e = workspace === null || workspace === void 0 ? void 0 : workspace.secrets) === null || _e === void 0 ? void 0 : _e.GEMINI_MODEL));
+    const headerActions = useMemo(() => [
+        {
+            enabled: true,
+            handleOnClick: handleFilters,
+            label: t("headerActionsFilters"),
+            order: 1,
+            icon: Filter,
+        },
+        {
+            enabled: true,
+            handleOnClick: handleCreate,
+            label: t("headerActionsAddAdmission"),
+            order: 2,
+            icon: Plus,
+        },
+    ], [handleFilters, handleCreate, t]);
+    const rowActions = useMemo(() => [
+        {
+            enabled: true,
+            handleOnClick: handleView,
+            label: t("rowActionsView"),
+            order: 1,
+        },
+        {
+            enabled: true,
+            handleOnClick: handleEdit,
+            label: t("rowActionsEdit"),
+            order: 2,
+        },
+        {
+            enabled: false,
+            handleOnClick: handleDelete,
+            label: t("rowActionsDelete"),
+            order: 3,
+        },
+        {
+            enabled: true,
+            handleOnClick: handlePrint,
+            label: t("rowActionsPrintPdf"),
+            order: 4,
+        },
+        {
+            enabled: hasGeminiSecrets,
+            handleOnClick: handleAnalyze,
+            label: t("rowActionsAnalyzeWithAi"),
+            order: 5,
+        },
+        {
+            enabled: (row) => (row === null || row === void 0 ? void 0 : row.status) !== ADMISSION_STATUS.APPROVED,
+            handleOnClick: handleAddStudent,
+            label: t("rowActionsAddStudent"),
+            order: 6,
+        },
+    ], [
+        handleView,
+        handleEdit,
+        handleDelete,
+        handlePrint,
+        handleAnalyze,
+        handleAddStudent,
+        hasGeminiSecrets,
+        t,
+    ]);
+    const applyFilters = useCallback(() => {
+        context.dispatch({
+            type: ADMISSION_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+        listFetchNow();
+        handleCloseDrawer();
+    }, [context, listFetchNow, handleCloseDrawer]);
+    // ============================================================================
+    // EFFECTS
+    // ============================================================================
+    useEffect(() => {
+        if (!(workspace === null || workspace === void 0 ? void 0 : workspace.id))
+            return;
+        (async () => {
+            try {
+                const { count, items } = await getCachedAdmissions({
+                    params: listParams,
+                });
+                context.dispatch({
+                    type: ADMISSION_ACTION_TYPES.SET_ITEMS,
+                    payload: { items: items || [], count: count || 0 },
+                });
+            }
+            catch (_a) {
+                showToast(t("messagesFetchFailed"), TOAST_VARIANT.ERROR);
+            }
+        })();
+    }, [listParams, workspace === null || workspace === void 0 ? void 0 : workspace.id, t, showToast, context]);
+    // ============================================================================
+    // 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 });
+};