@appcorp/fusion-storybook 0.1.4

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

@@ -0,0 +1,86 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * StudentProfile Page — generic page wrapper
+ *
+ * Uses `createGenericModulePage` to provide the table + drawer chrome while
+ * wiring the module-specific content (filter, form, view, more-actions)
+ * via the `ComponentConfig`.
+ */
+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 { useStudentProfileModule, StudentProfileProvider, STUDENT_PROFILE_DRAWER, STUDENT_PROFILE_ACTION_TYPES, } from "./context";
+import { StudentProfileFilter } from "./filter";
+import { StudentProfileForm } from "./form";
+import { StudentProfileMoreActions } from "./more-actions";
+import { StudentProfileView } from "./view";
+// import { useAuthStateContext } from "@/contexts/auth-context";
+import { resolveRbacPermissions } from "@/utils/resolve-rbac-permissions";
+import { USER_ROLE } from "@/type";
+import { RbacNoAccess } from "@/components/rbac-no-access";
+import { useTranslations } from "next-intl";
+// ============================================================================
+// TABLE COLUMN CONFIGURATION (static — no runtime deps)
+// ============================================================================
+const tableBodyCols = [
+    { componentType: COMPONENT_TYPE.ID, key: "id" },
+    { componentType: COMPONENT_TYPE.OBJECT, key: ["familyMember:firstName"] },
+    { componentType: COMPONENT_TYPE.OBJECT, key: ["familyMember:lastName"] },
+    { componentType: COMPONENT_TYPE.TEXT, key: "studentCode" },
+    { componentType: COMPONENT_TYPE.TEXT, key: "status" },
+    { componentType: COMPONENT_TYPE.BOOLEAN, key: "enabled" },
+    { componentType: COMPONENT_TYPE.ACTIONS },
+];
+// ============================================================================
+// GENERIC PAGE COMPONENT
+// ============================================================================
+const StudentProfilePageInner = () => {
+    // const { user } = useAuthStateContext();
+    // const userRole = user?.user_metadata?.role as USER_ROLE;
+    const userRole = USER_ROLE.SCHOOL_ADMIN; // Default for storybook
+    const t = useTranslations("studentProfile");
+    const context = useStudentProfileModule();
+    // Config only changes when the locale changes or the drawer changes (size).
+    // Keeping this stable is critical: createGenericModulePage closes over config
+    // and produces a new React component type. If that type changes during render,
+    // React unmounts → remounts → effects fire → dispatch → infinite loop.
+    const studentProfileConfig = useMemo(() => ({
+        moduleName: "studentProfile",
+        tableColumns: [
+            { label: t("id"), width: "5%" },
+            { label: t("firstName"), width: "15%" },
+            { label: t("lastName"), width: "15%" },
+            { label: t("studentCode"), width: "15%" },
+            { label: t("status"), width: "20%" },
+            { label: t("enabled"), width: "10%" },
+            { label: t("actions"), width: "5%" },
+        ],
+        cancelLabel: t("cancel"),
+        drawerTitle: t("studentProfile"),
+        filterContent: _jsx(StudentProfileFilter, {}),
+        formContent: _jsx(StudentProfileForm, {}),
+        moreActionsContent: _jsx(StudentProfileMoreActions, {}),
+        saveLabel: t("save"),
+        searchPlaceholder: t("searchStudentProfiles"),
+        tableDescription: t("manageStudentProfilesAndTheirInformation"),
+        tableTitle: t("studentProfile"),
+        viewContent: _jsx(StudentProfileView, {}),
+        size: context.state.drawer === STUDENT_PROFILE_DRAWER.FORM_DRAWER
+            ? "full"
+            : "small",
+        onClearFilters: () => {
+            context.dispatch({ type: STUDENT_PROFILE_ACTION_TYPES.RESET_FORM });
+        },
+    }), [t, context.state.drawer]);
+    const GenericStudentProfilePage = useMemo(() => createGenericModulePage(studentProfileConfig), [studentProfileConfig]);
+    const hasPermission = resolveRbacPermissions({
+        userRole,
+        moduleName: "People Management",
+    });
+    if (!hasPermission) {
+        return _jsx(RbacNoAccess, { moduleName: "People Management" });
+    }
+    return (_jsx("div", { className: "p-4", children: _jsx(GenericStudentProfilePage, { config: studentProfileConfig, context: context, tableBodyCols: tableBodyCols }) }));
+};
+export const StudentProfilePage = () => (_jsx(StudentProfileProvider, { children: _jsx(StudentProfilePageInner, {}) }));

package/base-modules/student-profile/validate.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Student Validation Schema
+ *
+ * Zod validation schemas for student form data.
+ */
+import { z } from "zod";
+export declare const studentProfileFormValidation: z.ZodObject<{
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    phone: z.ZodOptional<z.ZodString>;
+    emergencyPhone: z.ZodOptional<z.ZodString>;
+    status: z.ZodString;
+    dateOfBirth: z.ZodOptional<z.ZodString>;
+    enrollmentDate: z.ZodOptional<z.ZodString>;
+    gender: z.ZodOptional<z.ZodString>;
+    bloodGroup: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    city: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    postalCode: z.ZodOptional<z.ZodString>;
+    country: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;

package/base-modules/student-profile/validate.js

@@ -0,0 +1,34 @@
+/**
+ * Student Validation Schema
+ *
+ * Zod validation schemas for student form data.
+ */
+import { z } from "zod";
+// ============================================================================
+// VALIDATION SCHEMA
+// ============================================================================
+export const studentProfileFormValidation = z.object({
+    firstName: z.string().min(1, "First name is required"),
+    lastName: z.string().min(1, "Last name is required"),
+    phone: z
+        .string()
+        .optional()
+        .refine((val) => !val ||
+        /^([+]?[\s0-9]+)?(\d{3}|[(]?[0-9]+[)]?)?([-]?[\s]?[0-9])+$/.test(val), "Invalid phone number format"),
+    emergencyPhone: z
+        .string()
+        .optional()
+        .refine((val) => !val ||
+        /^([+]?[\s0-9]+)?(\d{3}|[(]?[0-9]+[)]?)?([-]?[\s]?[0-9])+$/.test(val), "Invalid phone number format"),
+    status: z.string().min(1, "Status is required"),
+    dateOfBirth: z.string().optional(),
+    enrollmentDate: z.string().optional(),
+    gender: z.string().optional(),
+    bloodGroup: z.string().optional(),
+    address: z.string().optional(),
+    city: z.string().optional(),
+    state: z.string().optional(),
+    postalCode: z.string().optional(),
+    country: z.string().optional(),
+    enabled: z.boolean().optional(),
+});

package/base-modules/student-profile/view.d.ts

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

package/base-modules/student-profile/view.js

@@ -0,0 +1,29 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+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 { Avatar, AvatarFallback, AvatarImage, } from "@appcorp/shadcn/components/ui/avatar";
+import { formatDate, DATE_FORMATS } from "@react-pakistan/util-functions";
+import { User, Phone, MapPin, Calendar, GraduationCap, CheckCircle2, XCircle, } from "lucide-react";
+import { useTranslations } from "next-intl";
+import { useStudentProfileModule } from "./context";
+import { formatValue } from "@/utils/format-value";
+export const StudentProfileView = () => {
+    const t = useTranslations("studentProfile");
+    const context = useStudentProfileModule();
+    const { address, avatar, city, country, dateOfBirth, email, emergencyPhone, enabled, firstName, gender, lastName, phone, postalCode, status, studentCode, } = context.state;
+    const stateValue = context.state.state;
+    const fullName = `${firstName} ${lastName}`;
+    const initials = `${(firstName === null || firstName === void 0 ? void 0 : firstName[0]) || ""}${(lastName === null || lastName === void 0 ? void 0 : lastName[0]) || ""}`.toUpperCase();
+    const formatDateValue = (date) => {
+        if (!date)
+            return "\u2014";
+        return formatDate(new Date(date).toISOString(), DATE_FORMATS.LOCALE_DATE);
+    };
+    return (_jsxs("div", { className: "space-y-4", children: [_jsx(Card, { children: _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "flex items-center gap-6", children: [_jsxs(Avatar, { className: "h-24 w-24", children: [_jsx(AvatarImage, { src: avatar || undefined, alt: fullName }), _jsx(AvatarFallback, { className: "text-2xl", children: initials })] }), _jsxs("div", { className: "flex-1", children: [_jsxs("div", { className: "flex items-center gap-3", children: [_jsx("h2", { className: "text-2xl font-bold", children: fullName }), enabled ? (_jsx(CheckCircle2, { className: "h-5 w-5 text-green-500" })) : (_jsx(XCircle, { className: "h-5 w-5 text-red-500" }))] }), _jsxs("p", { className: "text-muted-foreground mt-1", children: [t("studentCode"), ": ", studentCode || "N/A"] }), email && (_jsx("p", { className: "text-sm text-muted-foreground mt-1", children: email }))] })] }) }) }), _jsxs(Card, { children: [_jsxs(CardHeader, { className: "pb-3", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(User, { className: "h-5 w-5 text-primary" }), _jsx(CardTitle, { className: "text-lg", children: t("personalInformation") })] }), _jsx(CardDescription, { children: t("basicPersonalDetails") })] }), _jsx(Separator, {}), _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-6", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("firstName") }), _jsx("p", { className: "text-base", children: formatValue(firstName) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("lastName") }), _jsx("p", { className: "text-base", children: formatValue(lastName) })] }), _jsxs("div", { className: "space-y-1", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Calendar, { className: "h-4 w-4 text-muted-foreground" }), _jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("dateOfBirth") })] }), _jsx("p", { className: "text-base", children: formatDateValue(dateOfBirth) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("gender") }), _jsx(Badge, { variant: "secondary", className: "capitalize", children: formatValue(gender === null || gender === void 0 ? void 0 : gender.toLowerCase()) })] })] }) })] }), _jsxs(Card, { children: [_jsxs(CardHeader, { className: "pb-3", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Phone, { className: "h-5 w-5 text-primary" }), _jsx(CardTitle, { className: "text-lg", children: t("contactInformation") })] }), _jsx(CardDescription, { children: t("contactDetailsAndLocation") })] }), _jsx(Separator, {}), _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-6", children: [email && (_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("email") }), _jsx("p", { className: "text-base", children: formatValue(email) })] })), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("phone") }), _jsx("p", { className: "text-base", children: formatValue(phone) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("emergencyPhone") }), _jsx("p", { className: "text-base", children: formatValue(emergencyPhone) })] }), _jsxs("div", { className: "space-y-1 md:col-span-2", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(MapPin, { className: "h-4 w-4 text-muted-foreground" }), _jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("address") })] }), _jsx("p", { className: "text-base", children: formatValue(address) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("city") }), _jsx("p", { className: "text-base", children: formatValue(city) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("stateProvince") }), _jsx("p", { className: "text-base", children: formatValue(stateValue) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("country") }), _jsx("p", { className: "text-base", children: formatValue(country) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", 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(GraduationCap, { className: "h-5 w-5 text-primary" }), _jsx(CardTitle, { className: "text-lg", children: t("academicInformation") })] }), _jsx(CardDescription, { children: t("enrollmentAndAcademicStatus") })] }), _jsx(Separator, {}), _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "grid grid-cols-1 md:grid-cols-2 gap-6", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("status") }), _jsx(Badge, { variant: status === "ACTIVE"
+                                                ? "default"
+                                                : status === "GRADUATED"
+                                                    ? "secondary"
+                                                    : "outline", className: "capitalize", children: formatValue(status === null || status === void 0 ? void 0 : status.toLowerCase().replace(/_/g, " ")) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-sm font-medium text-muted-foreground", children: t("accountStatus") }), _jsx("div", { className: "flex items-center gap-2", children: enabled ? (_jsxs(_Fragment, { children: [_jsx(CheckCircle2, { className: "h-5 w-5 text-green-600 dark:text-green-400" }), _jsx(Badge, { variant: "outline", className: "border-green-600 text-green-700 dark:border-green-400 dark:text-green-400", children: t("active") })] })) : (_jsxs(_Fragment, { children: [_jsx(XCircle, { className: "h-5 w-5 text-gray-400" }), _jsx(Badge, { variant: "outline", className: "text-muted-foreground", children: t("inactive") })] })) })] })] }) })] })] }));
+};

package/base-modules/workspace/cache.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Workspace Cache
+ *
+ * Cache utilities for workspace data using generic cache system.
+ */
+import { WorkspaceBE } from "@/type";
+export declare const getCachedWorkspace: (id: string) => Promise<WorkspaceBE | null>;
+export declare const getCachedWorkspaceSync: () => WorkspaceBE | null;
+export declare const invalidateWorkspaceCache: () => void;

package/base-modules/workspace/cache.js

@@ -0,0 +1,28 @@
+/**
+ * Workspace Cache
+ *
+ * Cache utilities for workspace data using generic cache system.
+ */
+import { getCachedSingleItem, getCachedSingleItemSync, invalidateCache, } from "@react-pakistan/util-functions";
+import { WORKSPACE_API_ROUTES } from "./constants";
+import { LS_KEYS } from "@/constants";
+// ============================================================================
+// CACHE CONFIGURATION
+// ============================================================================
+const CACHE_CONFIG = {
+    cacheKey: LS_KEYS.WORKSPACE,
+    apiUrl: WORKSPACE_API_ROUTES.UNIT,
+    responseKey: "item",
+};
+// ============================================================================
+// CACHE WRAPPERS
+// ============================================================================
+export const getCachedWorkspace = (id) => {
+    return getCachedSingleItem(CACHE_CONFIG, { id });
+};
+export const getCachedWorkspaceSync = () => {
+    return getCachedSingleItemSync(LS_KEYS.WORKSPACE);
+};
+export const invalidateWorkspaceCache = () => {
+    invalidateCache(LS_KEYS.WORKSPACE);
+};

package/base-modules/workspace/constants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Workspace Constants
+ *
+ * Organization:
+ * - Page Configuration
+ * - API Routes
+ */
+export declare const pageLimit: number;
+export declare const WORKSPACE_API_ROUTES: Record<string, string>;
+export declare const secretKeys: string[];

package/base-modules/workspace/constants.js

@@ -0,0 +1,18 @@
+/**
+ * Workspace Constants
+ *
+ * Organization:
+ * - Page Configuration
+ * - API Routes
+ */
+// ============================================================================
+// PAGE CONFIGURATION
+// ============================================================================
+export const pageLimit = Number(process.env.NEXT_PUBLIC_PAGE_LIMIT) || 10;
+// ============================================================================
+// API ROUTES
+// ============================================================================
+export const WORKSPACE_API_ROUTES = {
+    UNIT: "/api/v1/workspace",
+};
+export const secretKeys = ["GOOGLE_SMTP", "GEMINI_API_KEY", "GEMINI_MODEL"];

package/base-modules/workspace/context.d.ts

@@ -0,0 +1,187 @@
+export declare const WORKSPACE_ACTION_TYPES: {
+    readonly RESET_FORM: "RESET_FORM";
+    readonly SET_CURRENT_PAGE: "SET_CURRENT_PAGE";
+    readonly SET_PAGE_LIMIT: "SET_PAGE_LIMIT";
+    readonly SET_SEARCH_QUERY: "SET_SEARCH_QUERY";
+    readonly SET_DRAWER: "SET_DRAWER";
+    readonly SET_ITEMS: "SET_ITEMS";
+    readonly SET_FORM_DATA: "SET_FORM_DATA";
+    readonly SET_DISABLE_SAVE_BUTTON: "SET_DISABLE_SAVE_BUTTON";
+    readonly SET_INPUT_FIELD: "SET_INPUT_FIELD";
+    readonly SET_ERRORS: "SET_ERRORS";
+    readonly SET_FILTERS: "SET_FILTERS";
+}, workspaceModuleConfig: import("@react-pakistan/util-functions/factory/generic-module-factory").ModuleConfig<{
+    agreedCurrency: string;
+    agreedPrice: number;
+    billingDate: null;
+    billingInterval: string;
+    classesCount: number;
+    coursesCount: number;
+    description: string;
+    dueDateLength: number;
+    enabled: boolean;
+    familiesCount: number;
+    id: string;
+    logo: string;
+    name: string;
+    planEndDate: null;
+    planId: string;
+    planStartDate: null;
+    secrets: {};
+    staffAccountsCount: number;
+    storageUsedMB: number;
+    studentsCount: number;
+    subdomain: string;
+    teachersCount: number;
+    disableSaveButton: boolean;
+    drawer: null;
+    errors: Record<string, string>;
+}>, initialWorkspaceState: {
+    agreedCurrency: string;
+    agreedPrice: number;
+    billingDate: null;
+    billingInterval: string;
+    classesCount: number;
+    coursesCount: number;
+    description: string;
+    dueDateLength: number;
+    enabled: boolean;
+    familiesCount: number;
+    id: string;
+    logo: string;
+    name: string;
+    planEndDate: null;
+    planId: string;
+    planStartDate: null;
+    secrets: {};
+    staffAccountsCount: number;
+    storageUsedMB: number;
+    studentsCount: number;
+    subdomain: string;
+    teachersCount: number;
+    disableSaveButton: boolean;
+    drawer: null;
+    errors: Record<string, string>;
+}, WorkspaceProvider: import("react").FC<{
+    children: React.ReactNode;
+}>, workspaceReducer: (state: {
+    agreedCurrency: string;
+    agreedPrice: number;
+    billingDate: null;
+    billingInterval: string;
+    classesCount: number;
+    coursesCount: number;
+    description: string;
+    dueDateLength: number;
+    enabled: boolean;
+    familiesCount: number;
+    id: string;
+    logo: string;
+    name: string;
+    planEndDate: null;
+    planId: string;
+    planStartDate: null;
+    secrets: {};
+    staffAccountsCount: number;
+    storageUsedMB: number;
+    studentsCount: number;
+    subdomain: string;
+    teachersCount: number;
+    disableSaveButton: boolean;
+    drawer: null;
+    errors: Record<string, string>;
+}, action: any) => {
+    agreedCurrency: string;
+    agreedPrice: number;
+    billingDate: null;
+    billingInterval: string;
+    classesCount: number;
+    coursesCount: number;
+    description: string;
+    dueDateLength: number;
+    enabled: boolean;
+    familiesCount: number;
+    id: string;
+    logo: string;
+    name: string;
+    planEndDate: null;
+    planId: string;
+    planStartDate: null;
+    secrets: {};
+    staffAccountsCount: number;
+    storageUsedMB: number;
+    studentsCount: number;
+    subdomain: string;
+    teachersCount: number;
+    disableSaveButton: boolean;
+    drawer: null;
+    errors: Record<string, string>;
+}, useWorkspaceContext: () => import("@react-pakistan/util-functions/factory/generic-module-factory").GenericModuleContext<{
+    agreedCurrency: string;
+    agreedPrice: number;
+    billingDate: null;
+    billingInterval: string;
+    classesCount: number;
+    coursesCount: number;
+    description: string;
+    dueDateLength: number;
+    enabled: boolean;
+    familiesCount: number;
+    id: string;
+    logo: string;
+    name: string;
+    planEndDate: null;
+    planId: string;
+    planStartDate: null;
+    secrets: {};
+    staffAccountsCount: number;
+    storageUsedMB: number;
+    studentsCount: number;
+    subdomain: string;
+    teachersCount: number;
+    disableSaveButton: boolean;
+    drawer: null;
+    errors: Record<string, string>;
+}>;
+export declare const WORKSPACE_DRAWER: {
+    readonly FORM_DRAWER: string;
+    readonly MORE_ACTIONS_DRAWER: string;
+    readonly VIEW_DRAWER: string;
+};
+export declare const useWorkspaceModule: () => {
+    plans: any[];
+    handleChange: (field: string, value: string | number | boolean | undefined | Record<string, string>) => void;
+    handleCloseDrawer: () => void;
+    handleEdit: () => void;
+    handleSubmit: () => void;
+    handleView: () => void;
+    updateLoading: boolean;
+    state: {
+        agreedCurrency: string;
+        agreedPrice: number;
+        billingDate: null;
+        billingInterval: string;
+        classesCount: number;
+        coursesCount: number;
+        description: string;
+        dueDateLength: number;
+        enabled: boolean;
+        familiesCount: number;
+        id: string;
+        logo: string;
+        name: string;
+        planEndDate: null;
+        planId: string;
+        planStartDate: null;
+        secrets: {};
+        staffAccountsCount: number;
+        storageUsedMB: number;
+        studentsCount: number;
+        subdomain: string;
+        teachersCount: number;
+        disableSaveButton: boolean;
+        drawer: null;
+        errors: Record<string, string>;
+    };
+    dispatch: React.Dispatch<any>;
+};