@appcorp/fusion-storybook 0.1.4

package/base-modules/admission/filter.d.ts

@@ -0,0 +1 @@
+export declare const AdmissionFilter: () => import("react/jsx-runtime").JSX.Element;

package/base-modules/admission/filter.js

@@ -0,0 +1,31 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Admission Filter Component
+ *
+ * Filter UI for admission records. Uses the module state pattern:
+ * `const { state, handleChange, handleSetStartDate, handleSetEndDate } = useAdmissionModule()`
+ */
+import { EnhancedCombobox } from "@appcorp/shadcn/components/enhanced-combobox";
+import { EnhancedRadio } from "@appcorp/shadcn/components/enhanced-radio";
+import { useTranslations } from "next-intl";
+import { ADMISSION_STATUS_OPTIONS } from "./constants";
+import { useAdmissionModule } from "./context";
+export const AdmissionFilter = () => {
+    const { state, handleChange, handleSetStartDate, handleSetEndDate } = useAdmissionModule();
+    const { filterEnabled, filterAdmissionStatus, filterStartDate, filterEndDate, } = state;
+    const t = useTranslations("admission");
+    const filterEnabledValue = filterEnabled === undefined
+        ? "undefined"
+        : filterEnabled
+            ? "true"
+            : "false";
+    return (_jsx("div", { className: "space-y-4", children: _jsxs("div", { className: "grid grid-cols-1 gap-4", children: [_jsx(EnhancedCombobox, { id: "filterAdmissionStatus", label: t("admissionStatus"), info: t("filterByAdmissionStatus"), options: [...ADMISSION_STATUS_OPTIONS], value: filterAdmissionStatus !== null && filterAdmissionStatus !== void 0 ? filterAdmissionStatus : undefined, onValueChange: (value) => handleChange("filterAdmissionStatus", value) }), _jsxs("div", { children: [_jsx("label", { htmlFor: "startDate", className: "text-foreground mb-1 block text-sm font-medium", children: t("startDate") }), _jsx("input", { id: "startDate", type: "date", value: filterStartDate || "", onChange: (e) => handleSetStartDate(e.target.value), className: "border-input bg-background text-foreground focus:ring-ring w-full rounded-md border px-3 py-2 focus:border-transparent focus:ring-2 focus:outline-none" })] }), _jsxs("div", { children: [_jsx("label", { htmlFor: "endDate", className: "text-foreground mb-1 block text-sm font-medium", children: t("endDate") }), _jsx("input", { id: "endDate", type: "date", value: filterEndDate || "", onChange: (e) => handleSetEndDate(e.target.value), className: "border-input bg-background text-foreground focus:ring-ring w-full rounded-md border px-3 py-2 focus:border-transparent focus:ring-2 focus:outline-none" })] }), _jsx(EnhancedRadio, { label: t("enabled"), name: "filterEnabled", value: filterEnabledValue, options: [
+                        { label: t("all"), value: "undefined" },
+                        { label: t("enabled"), value: "true" },
+                        { label: t("disabled"), value: "false" },
+                    ], onValueChange: (next) => {
+                        const parsed = next === "true" ? true : next === "false" ? false : undefined;
+                        handleChange("filterEnabled", parsed);
+                    } })] }) }));
+};

package/base-modules/admission/form.d.ts

@@ -0,0 +1 @@
+export declare const AdmissionForm: () => import("react/jsx-runtime").JSX.Element;

package/base-modules/admission/form.js

@@ -0,0 +1,86 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Admission Form Component
+ *
+ * Create/edit form for admission records. Uses the module state pattern:
+ * `const { state, handleChange, dispatch } = useAdmissionModule()`
+ *
+ * Note: the `state` field in `moduleState` (province/state) is aliased
+ * to `provinceState` to avoid a name collision with the hook's `state` object.
+ */
+import { EnhancedInput } from "@appcorp/shadcn/components/enhanced-input";
+import { EnhancedTextarea } from "@appcorp/shadcn/components/enhanced-textarea";
+import { EnhancedCheckbox } from "@appcorp/shadcn/components/enhanced-checkbox";
+import { EnhancedCombobox } from "@appcorp/shadcn/components/enhanced-combobox";
+import { useAdmissionModule, ADMISSION_ACTION_TYPES } from "./context";
+import { Separator } from "@appcorp/shadcn/components/ui/separator";
+import { GENDER } from "../../type";
+import { useEffect } from "react";
+import { getCachedWorkspaceSync } from "../workspace/cache";
+import { getDialCode, VALUE_DELIMITER } from "@react-pakistan/util-functions";
+import { v4 as uuidv4 } from "uuid";
+import { getCachedDiscountCodesSync } from "../discount-code/cache";
+import { useTranslations } from "next-intl";
+export const AdmissionForm = () => {
+    const { state, handleChange, dispatch } = useAdmissionModule();
+    const { address, admissionNotes, bForm, city, classForAdmission, country, discountCode, dob, emergencyContact, errors, fatherCnic, fatherFirstName, fatherLastName, fatherMobile, fatherOccupation, fatherOrganization, firstName, gender, id, lastName, motherCnic, motherFirstName, motherLastName, motherMobile, notes, previousSchool, registrationCode, siblings, state: provinceState, } = state;
+    const t = useTranslations("admission");
+    const workspace = getCachedWorkspaceSync();
+    const discountCodes = getCachedDiscountCodesSync();
+    const discountCodeOptions = (discountCodes.items || [])
+        .filter((code) => code.enabled)
+        .map((code) => {
+        var _a;
+        return ({
+            label: `${code.code} - ${code.discountValue}${code.discountType === "PERCENTAGE" ? "%" : (_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.currency}`,
+            value: code.code,
+            description: code.description || undefined,
+        });
+    });
+    useEffect(() => {
+        var _a, _b, _c, _d, _e, _f;
+        if (!id) {
+            dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: { key: "city", value: ((_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.city) || "" },
+            });
+            dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: { key: "state", value: ((_b = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _b === void 0 ? void 0 : _b.state) || "" },
+            });
+            dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: { key: "country", value: ((_c = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _c === void 0 ? void 0 : _c.country) || "" },
+            });
+            dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: {
+                    key: "fatherMobile",
+                    value: getDialCode(((_d = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _d === void 0 ? void 0 : _d.country) || "PK") || "",
+                },
+            });
+            dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: {
+                    key: "motherMobile",
+                    value: getDialCode(((_e = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _e === void 0 ? void 0 : _e.country) || "PK") || "",
+                },
+            });
+            dispatch({
+                type: ADMISSION_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: {
+                    key: "registrationCode",
+                    value: `${(_f = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _f === void 0 ? void 0 : _f.code}${VALUE_DELIMITER.COLON}${uuidv4()
+                        .slice(0, 8)
+                        .toUpperCase()}`,
+                },
+            });
+        }
+    }, [id]);
+    return (_jsxs("div", { className: "grid grid-cols-1 gap-2 space-y-2", children: [_jsx("h4", { className: "m-0 p-0", children: t("studentInformation") }), _jsxs("div", { className: "grid grid-cols-5 gap-4", children: [_jsx(EnhancedInput, { error: errors.firstName, id: "firstName", info: t("firstNameInfo"), label: t("firstName"), onChange: (e) => handleChange("firstName", e.target.value), placeholder: t("enterFirstName"), required: true, type: "text", value: firstName || "" }), _jsx(EnhancedInput, { error: errors.lastName, id: "lastName", info: t("lastNameInfo"), label: t("lastName"), onChange: (e) => handleChange("lastName", e.target.value), placeholder: t("enterLastName"), required: true, type: "text", value: lastName || "" }), _jsx(EnhancedInput, { error: errors.bForm, id: "bForm", info: t("bFormInfo"), label: t("bForm"), onChange: (e) => handleChange("bForm", e.target.value), placeholder: t("enterBForm"), required: true, type: "text", value: bForm || "" }), _jsx(EnhancedCombobox, { emptyText: t("noGenderOptionsFound"), error: errors.gender, id: "gender", info: t("genderInfo"), label: t("gender"), required: true, onValueChange: (value) => handleChange("gender", value), options: [
+                            { label: t("male"), value: GENDER.MALE },
+                            { label: t("female"), value: GENDER.FEMALE },
+                            { label: t("other"), value: GENDER.OTHER },
+                        ], placeholder: t("selectGender"), searchPlaceholder: t("searchGender"), value: gender }), _jsx(EnhancedInput, { error: errors.dob, id: "dob", info: t("dobInfo"), label: t("dob"), onChange: (e) => handleChange("dob", e.target.value), placeholder: t("selectDob"), required: true, type: "date", value: dob || "" }), _jsx(EnhancedInput, { error: errors.registrationCode, id: "registrationCode", info: t("registrationCodeInfo"), label: t("registrationCode"), onChange: (e) => handleChange("registrationCode", e.target.value), placeholder: t("enterRegistrationCode"), required: true, type: "text", value: registrationCode || "", disabled: true }), _jsx(EnhancedCombobox, { emptyText: t("noDiscountCodesAvailable"), error: errors.discountCode, id: "discountCode", info: t("discountCodeInfo"), label: t("discountCode"), onValueChange: (value) => handleChange("discountCode", value), options: discountCodeOptions, placeholder: t("enterDiscountCode"), searchPlaceholder: t("searchDiscountCodes"), value: discountCode || "" }), _jsx(EnhancedCheckbox, { label: t("hafiz"), id: "hafiz", info: t("hafizInfo"), onCheckedChange: (checked) => handleChange("hafiz", checked) }), _jsx(EnhancedCheckbox, { label: t("orphan"), id: "orphan", info: t("orphanInfo"), onCheckedChange: (checked) => handleChange("orphan", checked) })] }), _jsx(Separator, {}), _jsx("h4", { className: "m-0 p-0", children: t("fatherInformation") }), _jsxs("div", { className: "grid grid-cols-6 gap-4", children: [_jsx(EnhancedInput, { error: errors.fatherFirstName, id: "fatherFirstName", info: t("fatherFirstNameInfo"), label: t("firstName"), onChange: (e) => handleChange("fatherFirstName", e.target.value), placeholder: t("enterFirstName"), required: true, type: "text", value: fatherFirstName || "" }), _jsx(EnhancedInput, { error: errors.fatherLastName, id: "fatherLastName", info: t("fatherLastNameInfo"), label: t("lastName"), onChange: (e) => handleChange("fatherLastName", e.target.value), placeholder: t("enterLastName"), required: true, type: "text", value: fatherLastName || "" }), _jsx(EnhancedInput, { error: errors.fatherCnic, id: "fatherCnic", info: t("fatherCnicInfo"), label: t("cnic"), onChange: (e) => handleChange("fatherCnic", e.target.value), placeholder: t("enterBForm"), required: true, type: "text", value: fatherCnic || "" }), _jsx(EnhancedInput, { error: errors.fatherMobile, id: "fatherMobile", info: t("fatherMobileInfo"), label: t("mobile"), onChange: (e) => handleChange("fatherMobile", e.target.value), placeholder: "+923001234567", required: true, type: "text", value: fatherMobile || "" }), _jsx(EnhancedInput, { error: errors.fatherOccupation, id: "fatherOccupation", info: t("fatherOccupationInfo"), label: t("occupation"), onChange: (e) => handleChange("fatherOccupation", e.target.value), placeholder: t("enterOccupation"), required: false, type: "text", value: fatherOccupation || "" }), _jsx(EnhancedInput, { error: errors.fatherOrganization, id: "fatherOrganization", info: t("fatherOrganizationInfo"), label: t("organization"), onChange: (e) => handleChange("fatherOrganization", e.target.value), placeholder: t("enterOrganization"), required: false, type: "text", value: fatherOrganization || "" }), _jsx(EnhancedCheckbox, { label: t("emergencyContact"), id: "emergencyContactFather", info: t("fatherEmergencyContactInfo"), checked: emergencyContact === "Father", onCheckedChange: (checked) => handleChange("emergencyContact", checked ? "Father" : "") })] }), _jsx(Separator, {}), _jsx("h4", { className: "m-0 p-0", children: t("motherInformation") }), _jsxs("div", { className: "grid grid-cols-6 gap-4", children: [_jsx(EnhancedInput, { error: errors.motherFirstName, id: "motherFirstName", info: t("motherFirstNameInfo"), label: t("firstName"), onChange: (e) => handleChange("motherFirstName", e.target.value), placeholder: t("enterFirstName"), required: true, type: "text", value: motherFirstName || "" }), _jsx(EnhancedInput, { error: errors.motherLastName, id: "motherLastName", info: t("motherLastNameInfo"), label: t("lastName"), onChange: (e) => handleChange("motherLastName", e.target.value), placeholder: t("enterLastName"), required: true, type: "text", value: motherLastName || "" }), _jsx(EnhancedInput, { error: errors.motherCnic, id: "motherCnic", info: t("motherCnicInfo"), label: t("cnic"), onChange: (e) => handleChange("motherCnic", e.target.value), placeholder: t("enterBForm"), required: true, type: "text", value: motherCnic || "" }), _jsx(EnhancedInput, { error: errors.motherMobile, id: "motherMobile", info: t("motherMobileInfo"), label: t("mobile"), onChange: (e) => handleChange("motherMobile", e.target.value), placeholder: "+923001234567", required: true, type: "text", value: motherMobile || "" }), _jsx(EnhancedCheckbox, { label: t("emergencyContact"), id: "emergencyContactMother", info: t("motherEmergencyContactInfo"), checked: emergencyContact === "Mother", onCheckedChange: (checked) => handleChange("emergencyContact", checked ? "Mother" : "") })] }), _jsx(Separator, {}), _jsx("h4", { className: "m-0 p-0", children: t("homeInformation") }), _jsxs("div", { className: "grid grid-cols-6 gap-4", children: [_jsx(EnhancedTextarea, { error: errors.address, id: "homeAddress", info: t("homeAddressInfo"), label: t("homeAddress"), onChange: (e) => handleChange("address", e.target.value), placeholder: t("enterHomeAddress"), required: true, rows: 2, value: address || "" }), _jsx(EnhancedInput, { error: errors.city, id: "city", info: t("cityInfo"), label: t("city"), onChange: (e) => handleChange("city", e.target.value), placeholder: t("enterCity"), required: true, type: "text", value: city || "" }), _jsx(EnhancedInput, { error: errors.state, id: "state", info: t("stateInfo"), label: t("state"), onChange: (e) => handleChange("state", e.target.value), placeholder: t("enterState"), required: true, type: "text", value: provinceState || "" }), _jsx(EnhancedInput, { error: errors.country, id: "country", info: t("countryInfo"), label: t("country"), onChange: (e) => handleChange("country", e.target.value), placeholder: t("enterCountry"), required: true, type: "text", value: country || "" })] }), _jsx(Separator, {}), _jsx("h4", { className: "m-0 p-0", children: t("admissionInformation") }), _jsxs("div", { className: "grid grid-cols-6 gap-4", children: [_jsx(EnhancedInput, { error: errors.classForAdmission, id: "classForAdmission", info: t("classForAdmissionInfo"), label: t("classForAdmission"), onChange: (e) => handleChange("classForAdmission", e.target.value), placeholder: t("enterClassForAdmission"), required: true, type: "text", value: classForAdmission || "" }), _jsx(EnhancedInput, { error: errors.previousSchool, id: "previousSchool", info: t("previousSchoolInfo"), label: t("previousSchool"), onChange: (e) => handleChange("previousSchool", e.target.value), placeholder: t("enterPreviousSchool"), type: "text", value: previousSchool || "" }), _jsx(EnhancedTextarea, { error: errors.siblings, id: "siblings", info: t("siblingsInfo"), label: t("siblings"), onChange: (e) => handleChange("siblings", e.target.value), placeholder: t("enterSiblings"), rows: 3, value: siblings || "" })] }), _jsx(Separator, {}), _jsx("h4", { className: "m-0 p-0", children: t("officeUse") }), _jsxs("div", { className: "grid grid-cols-4 gap-4", children: [_jsx(EnhancedTextarea, { error: errors.notes, id: "notes", info: t("notesInfo"), label: t("notes"), onChange: (e) => handleChange("notes", e.target.value), placeholder: t("enterNotes"), rows: 3, value: notes || "" }), _jsx(EnhancedTextarea, { error: errors.admissionNotes, id: "admissionNotes", info: t("admissionNotesInfo"), label: t("admissionNotes"), onChange: (e) => handleChange("admissionNotes", e.target.value), placeholder: t("enterAdmissionNotes"), rows: 3, value: admissionNotes || "" })] })] }));
+};

package/base-modules/admission/more-actions.d.ts

@@ -0,0 +1 @@
+export declare const AdmissionMoreActions: () => import("react/jsx-runtime").JSX.Element;

package/base-modules/admission/more-actions.js

@@ -0,0 +1,5 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+export const AdmissionMoreActions = () => {
+    return _jsx("div", { className: "space-y-4", children: "More actions for admissions" });
+};

package/base-modules/admission/page.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Admission Page Component
+ *
+ * Thin wrapper around GenericModulePage. All handlers, header actions, and row
+ * actions live in context.tsx — this file only owns:
+ *   - tableBodyCols  (static, module-level constant)
+ *   - admissionConfig (memoised on locale change only; size fixed to "full" so
+ *     the component type produced by createGenericModulePage never changes at
+ *     runtime, preventing the infinite-remount re-render loop)
+ *   - permission guard
+ */
+import { FC } from "react";
+import { USER_ROLE } from "../../type";
+export declare const AdmissionPage: FC<{
+    userRole: USER_ROLE;
+}>;

package/base-modules/admission/page.js

@@ -0,0 +1,128 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Admission Page Component
+ *
+ * Thin wrapper around GenericModulePage. All handlers, header actions, and row
+ * actions live in context.tsx — this file only owns:
+ *   - tableBodyCols  (static, module-level constant)
+ *   - admissionConfig (memoised on locale change only; size fixed to "full" so
+ *     the component type produced by createGenericModulePage never changes at
+ *     runtime, preventing the infinite-remount re-render loop)
+ *   - permission guard
+ */
+import { useMemo } from "react";
+import { COMPONENT_TYPE } from "@appcorp/shadcn/components/enhanced-table";
+import { createGenericModulePage, } from "@react-pakistan/util-functions/factory/generic-component-factory";
+import { useAdmissionModule, AdmissionProvider, ADMISSION_DRAWER, ADMISSION_ACTION_TYPES, } from "./context";
+import { AdmissionFilter } from "./filter";
+import { AdmissionForm } from "./form";
+import { AdmissionView } from "./view";
+import { resolveRbacPermissions } from "../../utils/resolve-rbac-permissions";
+import { RbacNoAccess } from "../../components/rbac-no-access";
+import { useTranslations } from "next-intl";
+import { AdmissionMoreActions } from "./more-actions";
+// ============================================================================
+// TABLE COLUMN CONFIGURATION (static — no runtime deps)
+// ============================================================================
+const tableBodyCols = [
+    { componentType: COMPONENT_TYPE.ID, key: "id" },
+    { componentType: COMPONENT_TYPE.OBJECT, key: ["studentDetails:firstName"] },
+    { componentType: COMPONENT_TYPE.OBJECT, key: ["studentDetails:lastName"] },
+    {
+        componentType: COMPONENT_TYPE.OBJECT,
+        key: ["studentDetails:registrationCode"],
+    },
+    {
+        componentType: COMPONENT_TYPE.OBJECT,
+        key: ["admissionDetails:classForAdmission"],
+    },
+    { componentType: COMPONENT_TYPE.TEXT, key: "status" },
+    { componentType: COMPONENT_TYPE.BOOLEAN, key: "enabled" },
+    { componentType: COMPONENT_TYPE.ACTIONS },
+];
+const tableColumns = [
+    { label: "id", width: "5%" },
+    { label: "firstName", width: "15%" },
+    { label: "lastName", width: "15%" },
+    { label: "registrationCode", width: "20%" },
+    { label: "class", width: "20%" },
+    { label: "status", width: "10%" },
+    { label: "enabled", width: "10%" },
+    { label: "actions", width: "5%" },
+];
+// ============================================================================
+// TRANSLATED COLUMNS HELPER
+// ============================================================================
+const getTranslatedColumns = (t) => tableColumns.map((col) => (Object.assign(Object.assign({}, col), { label: t(col.label) })));
+// ============================================================================
+// COMPONENT FACTORY (creates JSX elements when config is created, not during render)
+// ============================================================================
+const createComponentInstances = () => ({
+    filter: _jsx(AdmissionFilter, {}),
+    form: _jsx(AdmissionForm, {}),
+    moreActions: _jsx(AdmissionMoreActions, {}),
+    view: _jsx(AdmissionView, {}),
+});
+// ============================================================================
+// CONFIG CREATION HELPER
+// ============================================================================
+const createAdmissionConfig = (t, drawer, dispatch) => {
+    const components = createComponentInstances();
+    return {
+        moduleName: "admission",
+        tableColumns: getTranslatedColumns(t),
+        cancelLabel: t("cancel"),
+        drawerTitle: t("admission"),
+        filterContent: components.filter,
+        formContent: components.form,
+        moreActionsContent: components.moreActions,
+        saveLabel: t("save"),
+        searchPlaceholder: t("searchAdmissions"),
+        tableDescription: t("manageAdmissionsInTheSystem"),
+        tableTitle: t("admission"),
+        viewContent: components.view,
+        size: drawer === ADMISSION_DRAWER.FORM_DRAWER ? "full" : "small",
+        onClearFilters: () => {
+            dispatch({ type: ADMISSION_ACTION_TYPES.RESET_FORM });
+        },
+    };
+};
+// ============================================================================
+// STABLE PAGE COMPONENT (created once, outside render)
+// ============================================================================
+const GenericAdmissionPage = createGenericModulePage({
+    moduleName: "admission",
+    tableColumns: [],
+    cancelLabel: "",
+    drawerTitle: "",
+    filterContent: _jsx(AdmissionFilter, {}),
+    formContent: _jsx(AdmissionForm, {}),
+    moreActionsContent: _jsx(AdmissionMoreActions, {}),
+    saveLabel: "",
+    searchPlaceholder: "",
+    tableDescription: "",
+    tableTitle: "",
+    viewContent: _jsx(AdmissionView, {}),
+    size: "small",
+    onClearFilters: () => { },
+});
+// ============================================================================
+// INNER PAGE (requires AdmissionProvider context)
+// ============================================================================
+const AdmissionPageInner = ({ userRole }) => {
+    const t = useTranslations("admission");
+    const context = useAdmissionModule();
+    // Memoize permission check to avoid recalculation on every render
+    const hasPermission = useMemo(() => resolveRbacPermissions({
+        userRole,
+        moduleName: "Admission",
+    }), [userRole]);
+    // Memoize config creation
+    const admissionConfig = useMemo(() => createAdmissionConfig(t, context.state.drawer, context.dispatch), [t, context.state.drawer, context.dispatch]);
+    if (!hasPermission) {
+        return _jsx(RbacNoAccess, { moduleName: "Admission" });
+    }
+    return (_jsx("div", { className: "p-4", children: _jsx(GenericAdmissionPage, { config: admissionConfig, context: context, tableBodyCols: tableBodyCols }) }));
+};
+export const AdmissionPage = ({ userRole }) => (_jsx(AdmissionProvider, { children: _jsx(AdmissionPageInner, { userRole: userRole }) }));

package/base-modules/admission/validate.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Admission Validation Schema
+ *
+ * Zod validation schema for admission form with i18n keys
+ */
+import { z } from "zod";
+import { GENDER } from "../../type";
+export declare const admissionFormValidation: z.ZodObject<{
+    registrationCode: z.ZodString;
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    bForm: z.ZodString;
+    dob: z.ZodString;
+    gender: z.ZodEnum<typeof GENDER>;
+    discountCode: z.ZodOptional<z.ZodString>;
+    hafiz: z.ZodOptional<z.ZodBoolean>;
+    orphan: z.ZodOptional<z.ZodBoolean>;
+    fatherFirstName: z.ZodString;
+    fatherLastName: z.ZodString;
+    fatherCnic: z.ZodString;
+    fatherMobile: z.ZodString;
+    fatherOccupation: z.ZodOptional<z.ZodString>;
+    fatherOrganization: z.ZodOptional<z.ZodString>;
+    motherFirstName: z.ZodString;
+    motherLastName: z.ZodString;
+    motherCnic: z.ZodString;
+    motherMobile: z.ZodString;
+    address: z.ZodString;
+    city: z.ZodString;
+    state: z.ZodString;
+    country: z.ZodString;
+    classForAdmission: z.ZodString;
+    previousSchool: z.ZodOptional<z.ZodString>;
+    siblings: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+    admissionNotes: z.ZodOptional<z.ZodString>;
+    emergencyContact: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/base-modules/admission/validate.js

@@ -0,0 +1,70 @@
+/**
+ * Admission Validation Schema
+ *
+ * Zod validation schema for admission form with i18n keys
+ */
+import { z } from "zod";
+import { GENDER } from "../../type";
+export const admissionFormValidation = z.object({
+    // Student Information
+    registrationCode: z.string().min(1, "Registration code is required"),
+    firstName: z.string().min(1, "First name is required"),
+    lastName: z.string().min(1, "Last name is required"),
+    bForm: z
+        .string()
+        .min(1, "B. Form is required")
+        .max(15, "B. Form must be 15 characters")
+        .regex(/^\d{5}-\d{7}-\d{1}$/, "B. Form must be in format XXXXX-XXXXXXX-X"),
+    dob: z
+        .string()
+        .min(1, "Date of birth is required")
+        .refine((dateStr) => {
+        const birthDate = new Date(dateStr);
+        const today = new Date();
+        const age = today.getFullYear() - birthDate.getFullYear();
+        // Adjust age if birthday hasn't occurred this year
+        const adjustedAge = today.getMonth() < birthDate.getMonth() ||
+            (today.getMonth() === birthDate.getMonth() &&
+                today.getDate() < birthDate.getDate())
+            ? age - 1
+            : age;
+        return adjustedAge >= 2 && adjustedAge <= 25;
+    }, "Student age must be between 2 and 25 years"),
+    gender: z.nativeEnum(GENDER, { error: "Gender is required" }),
+    discountCode: z.string().optional(),
+    hafiz: z.boolean().optional(),
+    orphan: z.boolean().optional(),
+    // Father Information
+    fatherFirstName: z.string().min(1, "Father's first name is required"),
+    fatherLastName: z.string().min(1, "Father's last name is required"),
+    fatherCnic: z
+        .string()
+        .min(1, "Father's CNIC is required")
+        .max(15, "Father's CNIC must be 15 characters")
+        .regex(/^\d{5}-\d{7}-\d{1}$/, "Father's CNIC must be in format XXXXX-XXXXXXX-X"),
+    fatherMobile: z.string().min(1, "Father's mobile number is required"),
+    fatherOccupation: z.string().optional(),
+    fatherOrganization: z.string().optional(),
+    // Mother Information
+    motherFirstName: z.string().min(1, "Mother's first name is required"),
+    motherLastName: z.string().min(1, "Mother's last name is required"),
+    motherCnic: z
+        .string()
+        .min(1, "Mother's CNIC is required")
+        .max(15, "Mother's CNIC must be 15 characters")
+        .regex(/^\d{5}-\d{7}-\d{1}$/, "Mother's CNIC must be in format XXXXX-XXXXXXX-X"),
+    motherMobile: z.string().min(1, "Mother's mobile number is required"),
+    // Home Information
+    address: z.string().min(1, "Home address is required"),
+    city: z.string().min(1, "City is required"),
+    state: z.string().min(1, "State is required"),
+    country: z.string().min(1, "Country is required"),
+    // Admission Information
+    classForAdmission: z.string().min(1, "Class for admission is required"),
+    previousSchool: z.string().optional(),
+    siblings: z.string().optional(),
+    // Office Use
+    notes: z.string().optional(),
+    admissionNotes: z.string().optional(),
+    emergencyContact: z.string().optional(),
+});

package/base-modules/admission/view.d.ts

@@ -0,0 +1 @@
+export declare const AdmissionView: () => import("react/jsx-runtime").JSX.Element;

package/base-modules/admission/view.js

@@ -0,0 +1,40 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Admission View Component
+ *
+ * Read-only details view for an admission record. Uses the module state pattern:
+ * `const { state, handleAnalyze } = useAdmissionModule()`
+ *
+ * Note: the `state` field in `moduleState` (province/state) is aliased
+ * to `provinceState` to avoid a name collision with the hook's `state` object.
+ */
+import { useAdmissionModule } from "./context";
+import { Card, CardContent, CardDescription, CardHeader, CardTitle, } from "@appcorp/shadcn/components/ui/card";
+import { Badge } from "@appcorp/shadcn/components/ui/badge";
+import { Separator } from "@appcorp/shadcn/components/ui/separator";
+import { AlertTriangle, BookOpen, Brain, Calendar, CheckCircle2, FileText, Home, Loader2, RefreshCw, ShieldCheck, ShieldX, User, XCircle, } from "lucide-react";
+import { Button } from "@appcorp/shadcn/components/ui/button";
+import { useTranslations } from "next-intl";
+import { formatValue } from "../../utils/format-value";
+import { formatDate, DATE_FORMATS } from "@react-pakistan/util-functions";
+export const AdmissionView = () => {
+    const { state, handleAnalyze } = useAdmissionModule();
+    const { address, admissionNotes, aiAnalysis, analyzeLoading, analyzeError, bForm, city, classForAdmission, country, discountCode, dob, emergencyContact, enabled, fatherCnic, fatherFirstName, fatherLastName, fatherMobile, fatherOccupation, fatherOrganization, firstName, gender, hafiz, id, lastName, motherCnic, motherFirstName, motherLastName, motherMobile, notes, orphan, postalCode, previousSchool, registrationCode, siblings, state: provinceState, status, } = state;
+    const t = useTranslations("admission");
+    const decisionColor = (decision) => {
+        if (decision === "APPROVED")
+            return "bg-green-100 text-green-800 border-green-200";
+        if (decision === "REJECTED")
+            return "bg-red-100 text-red-800 border-red-200";
+        return "bg-yellow-100 text-yellow-800 border-yellow-200";
+    };
+    const decisionIcon = (decision) => {
+        if (decision === "APPROVED")
+            return _jsx(ShieldCheck, { className: "h-4 w-4" });
+        if (decision === "REJECTED")
+            return _jsx(ShieldX, { className: "h-4 w-4" });
+        return _jsx(AlertTriangle, { className: "h-4 w-4" });
+    };
+    return (_jsxs("div", { className: "space-y-6", children: [_jsxs(Card, { className: "border-primary/20 border-2", children: [_jsxs(CardHeader, { className: "pb-3", children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Brain, { className: "text-primary h-5 w-5" }), _jsx(CardTitle, { className: "text-lg", children: t("aiAnalysis") })] }), _jsxs(Button, { variant: "outline", size: "sm", disabled: analyzeLoading, onClick: () => handleAnalyze({ id }), children: [analyzeLoading ? (_jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" })) : (_jsx(RefreshCw, { className: "mr-2 h-4 w-4" })), aiAnalysis ? t("reRunAnalysis") : t("analyzeWithAi")] })] }), _jsx(CardDescription, { children: t("geminiPoweredAdmissionScoring") })] }), _jsx(Separator, {}), _jsxs(CardContent, { className: "pt-6", children: [analyzeLoading && (_jsxs("div", { className: "text-muted-foreground flex items-center gap-3", children: [_jsx(Loader2, { className: "h-5 w-5 animate-spin" }), _jsx("span", { children: t("runningAiAnalysis") })] })), analyzeError && !analyzeLoading && (_jsxs("div", { className: "text-destructive flex items-center gap-2 text-sm", children: [_jsx(AlertTriangle, { className: "h-4 w-4" }), _jsx("span", { children: analyzeError })] })), !analyzeLoading && aiAnalysis && (_jsxs("div", { className: "space-y-4", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-4", children: [_jsxs("div", { className: "bg-muted flex flex-col items-center rounded-lg px-6 py-3", children: [_jsx("span", { className: "text-primary text-3xl font-bold", children: aiAnalysis.score }), _jsx("span", { className: "text-muted-foreground text-xs tracking-wide uppercase", children: "/ 100" })] }), _jsxs("span", { className: `inline-flex items-center gap-1.5 rounded-full border px-3 py-1.5 text-sm font-medium ${decisionColor(aiAnalysis.decision)}`, children: [decisionIcon(aiAnalysis.decision), aiAnalysis.decision.replace("_", " ")] }), _jsxs("div", { className: "text-muted-foreground text-sm", children: [_jsxs("span", { className: "font-medium", children: [t("confidence"), ": "] }), (aiAnalysis.confidence * 100).toFixed(0), "%"] })] }), aiAnalysis.reasons.length > 0 && (_jsxs("div", { children: [_jsx("p", { className: "mb-2 text-sm font-medium", children: t("aiReasoningAndRiskFlags") }), _jsx("ul", { className: "space-y-1.5", children: aiAnalysis.reasons.map((reason, i) => (_jsxs("li", { className: "flex items-start gap-2 text-sm", children: [_jsx(AlertTriangle, { className: "mt-0.5 h-4 w-4 shrink-0 text-yellow-500" }), _jsx("span", { children: reason })] }, i))) })] })), _jsxs("p", { className: "text-muted-foreground text-xs", children: [t("lastAnalyzed"), ":", " ", formatDate(String(aiAnalysis.processedAt), DATE_FORMATS.LOCALE_DATE)] })] })), !analyzeLoading && !aiAnalysis && !analyzeError && (_jsx("p", { className: "text-muted-foreground text-sm", children: t("noAiAnalysisYet") }))] })] }), _jsxs(Card, { children: [_jsxs(CardHeader, { className: "pb-3", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(BookOpen, { className: "text-primary h-5 w-5" }), _jsx(CardTitle, { className: "text-lg", children: t("admissionDetails") })] }), _jsx(CardDescription, { children: t("registrationAndAdmissionInformation") })] }), _jsx(Separator, {}), _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "grid grid-cols-1 gap-6 md:grid-cols-2", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("registrationCode") }), _jsx("p", { className: "font-mono text-base", children: formatValue(registrationCode) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("classForAdmission") }), _jsx("p", { className: "text-base", children: formatValue(classForAdmission) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("status") }), _jsx("p", { className: "text-base", children: formatValue(status) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("previousSchool") }), _jsx("p", { className: "text-base", children: formatValue(previousSchool) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("siblings") }), _jsx("p", { className: "text-base", children: formatValue(siblings) })] })] }) })] }), _jsxs(Card, { children: [_jsxs(CardHeader, { className: "pb-3", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(User, { className: "text-primary h-5 w-5" }), _jsx(CardTitle, { className: "text-lg", children: t("studentInformation") })] }), _jsx(CardDescription, { children: t("personalDetails") })] }), _jsx(Separator, {}), _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "grid grid-cols-1 gap-6 md:grid-cols-2", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("fullName") }), _jsxs("p", { className: "text-base", children: [formatValue(firstName), " ", formatValue(lastName)] })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("dob") }), _jsx("p", { className: "text-base", children: formatDate(String(dob), DATE_FORMATS.LOCALE_DATE) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("gender") }), _jsx("p", { className: "text-base", children: formatValue(gender) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("bForm") }), _jsx("p", { className: "text-base", children: formatValue(bForm) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("discountCode") }), _jsx("p", { className: "text-base", children: formatValue(discountCode) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("emergencyContact") }), _jsx("p", { className: "text-base", children: formatValue(emergencyContact) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("hafizEQuran") }), _jsx("p", { className: "text-base", children: hafiz ? t("yes") : t("no") })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("orphan") }), _jsx("p", { className: "text-base", children: orphan ? t("yes") : t("no") })] })] }) })] }), _jsxs(Card, { children: [_jsxs(CardHeader, { className: "pb-3", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(User, { className: "text-primary h-5 w-5" }), _jsx(CardTitle, { className: "text-lg", children: t("fatherInformation") })] }), _jsx(CardDescription, { children: t("fatherDetails") })] }), _jsx(Separator, {}), _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "grid grid-cols-1 gap-6 md:grid-cols-2", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("fullName") }), _jsxs("p", { className: "text-base", children: [formatValue(fatherFirstName), " ", formatValue(fatherLastName)] })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("cnic") }), _jsx("p", { className: "text-base", children: formatValue(fatherCnic) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("mobile") }), _jsx("p", { className: "text-base", children: formatValue(fatherMobile) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("occupation") }), _jsx("p", { className: "text-base", children: formatValue(fatherOccupation) })] }), _jsxs("div", { className: "space-y-1 md:col-span-2", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("organization") }), _jsx("p", { className: "text-base", children: formatValue(fatherOrganization) })] })] }) })] }), _jsxs(Card, { children: [_jsxs(CardHeader, { className: "pb-3", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(User, { className: "text-primary h-5 w-5" }), _jsx(CardTitle, { className: "text-lg", children: t("motherInformation") })] }), _jsx(CardDescription, { children: t("motherDetails") })] }), _jsx(Separator, {}), _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "grid grid-cols-1 gap-6 md:grid-cols-2", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("fullName") }), _jsxs("p", { className: "text-base", children: [formatValue(motherFirstName), " ", formatValue(motherLastName)] })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("cnic") }), _jsx("p", { className: "text-base", children: formatValue(motherCnic) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("mobile") }), _jsx("p", { className: "text-base", children: formatValue(motherMobile) })] })] }) })] }), _jsxs(Card, { children: [_jsxs(CardHeader, { className: "pb-3", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Home, { className: "text-primary h-5 w-5" }), _jsx(CardTitle, { className: "text-lg", children: t("homeDetails") })] }), _jsx(CardDescription, { children: t("addressInformation") })] }), _jsx(Separator, {}), _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "grid grid-cols-1 gap-6 md:grid-cols-2", children: [_jsxs("div", { className: "space-y-1 md:col-span-2", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("address") }), _jsx("p", { className: "text-base", children: formatValue(address) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("city") }), _jsx("p", { className: "text-base", children: formatValue(city) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("state") }), _jsx("p", { className: "text-base", children: formatValue(provinceState) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("country") }), _jsx("p", { className: "text-base", children: formatValue(country) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("postalCode") }), _jsx("p", { className: "text-base", children: formatValue(postalCode) })] })] }) })] }), _jsxs(Card, { children: [_jsxs(CardHeader, { className: "pb-3", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(FileText, { className: "text-primary h-5 w-5" }), _jsx(CardTitle, { className: "text-lg", children: t("officeUse") })] }), _jsx(CardDescription, { children: t("internalNotesAndProcessingInformation") })] }), _jsx(Separator, {}), _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "grid grid-cols-1 gap-6", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("notes") }), _jsx("p", { className: "text-base", children: formatValue(notes) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("admissionNotes") }), _jsx("p", { className: "text-base", children: formatValue(admissionNotes) })] })] }) })] }), _jsxs(Card, { children: [_jsxs(CardHeader, { className: "pb-3", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Calendar, { className: "text-primary h-5 w-5" }), _jsx(CardTitle, { className: "text-lg", children: t("recordStatus") })] }), _jsx(CardDescription, { children: t("recordStateAndMetadata") })] }), _jsx(Separator, {}), _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-muted-foreground text-sm font-medium", children: t("enabled") }), _jsxs(Badge, { variant: enabled ? "default" : "destructive", className: "gap-1", children: [enabled ? (_jsx(CheckCircle2, { className: "h-3 w-3" })) : (_jsx(XCircle, { className: "h-3 w-3" })), enabled ? t("active") : t("inactive")] })] }) })] })] }));
+};

package/base-modules/discount-code/cache.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Discount Code Cache utilities
+ *
+ * Convenience wrappers around the shared cache helpers used across modules.
+ * These helpers are intentionally small: callers in the UI layer expect
+ * simple, well-typed functions such as `getCachedDiscountCodes` and
+ * `invalidateDiscountCodeCache`.
+ *
+ * Usage examples:
+ * - `await getCachedDiscountCodes({ params: { page: 1 } })`
+ * - `invalidateDiscountCodeCache()` after a successful create/update/delete
+ */
+import { DiscountCodeBE } from "@/type";
+/** Synchronous access to cached discount codes (localStorage) */
+export declare const getCachedDiscountCodesSync: () => import("@react-pakistan/util-functions").ListResponse<DiscountCodeBE>;
+/** Fetch cached list (may call network if cache miss or stale) */
+export declare const getCachedDiscountCodes: ({ params, }: {
+    params: Record<string, unknown>;
+}) => Promise<import("@react-pakistan/util-functions").ListResponse<DiscountCodeBE>>;
+/** Get a single discount code from the cache by id */
+export declare const getCachedDiscountCodeById: (discountCodeId: string) => DiscountCodeBE | null;
+/** Remove discount-code cache entries (used after writes) */
+export declare const invalidateDiscountCodeCache: () => void;
+/** Preload discount codes into cache (useful during bootstrap) */
+export declare const preloadDiscountCodes: () => Promise<import("@react-pakistan/util-functions").ListResponse<DiscountCodeBE>>;
+/** Utility to check if the discount codes cache is stale */
+export declare const isDiscountCodesCacheStale: () => boolean;

package/base-modules/discount-code/cache.js

@@ -0,0 +1,46 @@
+/**
+ * Discount Code Cache utilities
+ *
+ * Convenience wrappers around the shared cache helpers used across modules.
+ * These helpers are intentionally small: callers in the UI layer expect
+ * simple, well-typed functions such as `getCachedDiscountCodes` and
+ * `invalidateDiscountCodeCache`.
+ *
+ * Usage examples:
+ * - `await getCachedDiscountCodes({ params: { page: 1 } })`
+ * - `invalidateDiscountCodeCache()` after a successful create/update/delete
+ */
+import { LS_KEYS } from "@/constants";
+import { DISCOUNT_CODE_API_ROUTES } from "./constants";
+import { getCachedData, getCachedDataSync, getCachedItemById, invalidateCache, isCacheStale, preloadCache, } from "@react-pakistan/util-functions";
+// ============================================================================
+// CACHE CONFIGURATION
+// ============================================================================
+const DISCOUNT_CODE_CACHE_CONFIG = {
+    cacheKey: LS_KEYS.DISCOUNT_CODES,
+    apiUrl: DISCOUNT_CODE_API_ROUTES.UNIT,
+};
+// ============================================================================
+// DISCOUNT CODE CACHE FUNCTIONS
+// ============================================================================
+/** Synchronous access to cached discount codes (localStorage) */
+export const getCachedDiscountCodesSync = () => getCachedDataSync(LS_KEYS.DISCOUNT_CODES);
+/** Fetch cached list (may call network if cache miss or stale) */
+export const getCachedDiscountCodes = ({ params, }) => getCachedData({
+    config: DISCOUNT_CODE_CACHE_CONFIG,
+    params,
+    headers: {
+        "Content-Type": "application/json",
+        "x-api-token": process.env.NEXT_PUBLIC_API_KEY,
+    },
+});
+/** Get a single discount code from the cache by id */
+export const getCachedDiscountCodeById = (discountCodeId) => getCachedItemById(LS_KEYS.DISCOUNT_CODES, discountCodeId);
+/** Remove discount-code cache entries (used after writes) */
+export const invalidateDiscountCodeCache = () => {
+    invalidateCache(LS_KEYS.DISCOUNT_CODES);
+};
+/** Preload discount codes into cache (useful during bootstrap) */
+export const preloadDiscountCodes = () => preloadCache(DISCOUNT_CODE_CACHE_CONFIG);
+/** Utility to check if the discount codes cache is stale */
+export const isDiscountCodesCacheStale = () => isCacheStale(LS_KEYS.DISCOUNT_CODES);

package/base-modules/discount-code/constants.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Discount Code Constants
+ *
+ * Centralized constants used by the discount-code module. Keep values
+ * environment-driven (via `NEXT_PUBLIC_*`) where appropriate so CI/infra
+ * can override them without code changes.
+ */
+/**
+ * Default page limit for the discount codes list. Controlled by
+ * `NEXT_PUBLIC_PAGE_LIMIT` with a safe fallback to `10`.
+ */
+export declare const pageLimit: number;
+/**
+ * API routes for discount-code operations. The backend expects requests to
+ * these endpoints and returns the standard `{ items, count }` list shape.
+ */
+export declare const DISCOUNT_CODE_API_ROUTES: {
+    UNIT: string;
+};

package/base-modules/discount-code/constants.js

@@ -0,0 +1,26 @@
+/**
+ * Discount Code Constants
+ *
+ * Centralized constants used by the discount-code module. Keep values
+ * environment-driven (via `NEXT_PUBLIC_*`) where appropriate so CI/infra
+ * can override them without code changes.
+ */
+"use client";
+// ============================================================================
+// PAGE CONFIGURATION
+// ============================================================================
+/**
+ * Default page limit for the discount codes list. Controlled by
+ * `NEXT_PUBLIC_PAGE_LIMIT` with a safe fallback to `10`.
+ */
+export const pageLimit = Number(process.env.NEXT_PUBLIC_PAGE_LIMIT) || 10;
+// ============================================================================
+// API ROUTES
+// ============================================================================
+/**
+ * API routes for discount-code operations. The backend expects requests to
+ * these endpoints and returns the standard `{ items, count }` list shape.
+ */
+export const DISCOUNT_CODE_API_ROUTES = {
+    UNIT: "/api/v1/discount-code",
+};