@appcorp/fusion-storybook 0.3.89 → 0.3.91

package/base-modules/expense/context/expense-api-provider.d.ts

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

package/base-modules/expense/context/expense-api-provider.js

@@ -0,0 +1,229 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef } from "react";
+import { useTheme } from "next-themes";
+import { useTranslations } from "next-intl";
+import { isCreatedOrUpdated } from "@react-pakistan/util-functions/general/is-created-or-updated";
+import { useModuleEntityV2, } from "@react-pakistan/util-functions/hooks/use-module-entity-v2";
+import { useDebounce } from "@react-pakistan/util-functions/hooks/use-debounce";
+import { generateThemeToast, TOAST_VARIANT, } from "@appcorp/shadcn/lib/toast-utils";
+import { EXPENSE_API_ROUTES } from "../../../constants";
+import { getCachedWorkspaceSync } from "../../workspace/cache";
+import { EXPENSE_ACTION_TYPES, useExpenseContext, } from "./shared";
+// ============================================================================
+// CONTEXT
+// ============================================================================
+const ExpenseApiContext = createContext(null);
+export const useExpenseApiContext = () => {
+    const ctx = useContext(ExpenseApiContext);
+    if (!ctx) {
+        throw new Error("useExpenseApiContext must be used within ExpenseApiProvider");
+    }
+    return ctx;
+};
+// ============================================================================
+// PROVIDER
+// ============================================================================
+const normalizeDate = (date) => {
+    if (!date)
+        return "";
+    try {
+        return new Date(date).toISOString().split("T")[0];
+    }
+    catch (_a) {
+        return "";
+    }
+};
+export const ExpenseApiProvider = ({ children, }) => {
+    var _a;
+    const context = useExpenseContext();
+    const { dispatch } = context;
+    const state = context.state;
+    const t = useTranslations("expense");
+    const { theme } = useTheme();
+    const workspace = getCachedWorkspaceSync();
+    const debouncedQuery = useDebounce(state.searchQuery, 800);
+    const schoolId = ((_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id) || "";
+    // ==========================================================================
+    // UTILITIES
+    // ==========================================================================
+    const showToast = useCallback((description, variant) => {
+        generateThemeToast({
+            description,
+            theme: theme,
+            variant,
+        });
+    }, [theme]);
+    const resetFormAndCloseDrawer = useCallback(() => {
+        dispatch({ type: EXPENSE_ACTION_TYPES.RESET_FORM });
+        dispatch({
+            type: EXPENSE_ACTION_TYPES.SET_ERRORS,
+            payload: { errors: {} },
+        });
+        dispatch({
+            type: EXPENSE_ACTION_TYPES.SET_DISABLE_SAVE_BUTTON,
+            payload: { disabled: false },
+        });
+        dispatch({
+            type: EXPENSE_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: null },
+        });
+    }, [dispatch]);
+    // ==========================================================================
+    // API PARAMETERS
+    // ==========================================================================
+    const listParams = useMemo(() => (Object.assign(Object.assign(Object.assign(Object.assign({ currentPage: state.currentPage, pageLimit: state.pageLimit, schoolId }, (debouncedQuery ? { searchQuery: debouncedQuery } : {})), (state.filterCategory ? { filterCategory: state.filterCategory } : {})), (state.filterStatus ? { filterStatus: state.filterStatus } : {})), (state.filterEnabled !== undefined
+        ? { filterEnabled: state.filterEnabled }
+        : {}))), [
+        state.currentPage,
+        state.filterCategory,
+        state.filterEnabled,
+        state.filterStatus,
+        state.pageLimit,
+        debouncedQuery,
+        schoolId,
+    ]);
+    const updateParams = useMemo(() => ({
+        amount: state.amount,
+        approvedBy: state.approvedBy || null,
+        attachments: state.attachments,
+        category: state.category,
+        description: state.description || null,
+        enabled: state.enabled,
+        expenseDate: state.expenseDate,
+        id: state.id,
+        invoiceNumber: state.invoiceNumber || null,
+        paidBy: state.paidBy || null,
+        paymentDate: state.paymentDate || null,
+        paymentMethod: state.paymentMethod || null,
+        receiptNumber: state.receiptNumber || null,
+        remarks: state.remarks || null,
+        schoolId,
+        status: state.status,
+        title: state.title,
+        transactionId: state.transactionId || null,
+        vendorContact: state.vendorContact || null,
+        vendorName: state.vendorName || null,
+    }), [state, schoolId]);
+    const byIdParams = useMemo(() => ({ id: state.id }), [state.id]);
+    const deleteParams = useMemo(() => ({ id: state.id }), [state.id]);
+    // ==========================================================================
+    // API CALLBACKS
+    // ==========================================================================
+    const listCallback = useCallback(({ data, error }) => {
+        var _a;
+        if (error) {
+            showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            const response = data;
+            const items = (_a = response.items) !== null && _a !== void 0 ? _a : [];
+            const count = typeof response.count === "number" ? response.count : 0;
+            dispatch({
+                type: EXPENSE_ACTION_TYPES.SET_ITEMS,
+                payload: { items, count },
+            });
+        }
+    }, [dispatch, showToast, t]);
+    const listFetchNowRef = useRef(null);
+    const updateCallback = useCallback(({ data, error }) => {
+        var _a;
+        if (error) {
+            showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            const isCreated = isCreatedOrUpdated(data);
+            showToast(isCreated ? t("messagesExpenseCreated") : t("messagesExpenseUpdated"), TOAST_VARIANT.SUCCESS);
+            resetFormAndCloseDrawer();
+            (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+        }
+    }, [showToast, t, resetFormAndCloseDrawer]);
+    const byIdCallback = useCallback(({ data, error }) => {
+        if (error) {
+            showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            const expense = data;
+            dispatch({
+                type: EXPENSE_ACTION_TYPES.SET_FORM_DATA,
+                payload: {
+                    form: Object.assign(Object.assign({}, expense), { expenseDate: normalizeDate(expense.expenseDate), paymentDate: normalizeDate(expense.paymentDate), paymentMethod: expense.paymentMethod || "", filterEnabled: undefined, filterCategory: "", filterStatus: "" }),
+                },
+            });
+        }
+    }, [dispatch, showToast, t]);
+    const deleteCallback = useCallback(({ data, error }) => {
+        var _a;
+        if (error) {
+            showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            showToast(t("messagesExpenseDeleted"), TOAST_VARIANT.SUCCESS);
+            (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+        }
+    }, [showToast, t]);
+    // ==========================================================================
+    // SINGLE API HOOK INSTANCE
+    // ==========================================================================
+    const { listFetchNow, listLoading, updateFetchNow, updateLoading, byIdFetchNow, deleteFetchNow, deleteLoading, byIdLoading, } = useModuleEntityV2({
+        byIdCallback,
+        byIdParams,
+        deleteCallback,
+        deleteParams,
+        headers: {
+            "Content-Type": "application/json",
+        },
+        listCallback,
+        listParams,
+        listUrl: EXPENSE_API_ROUTES.UNIT,
+        searchQuery: debouncedQuery,
+        unitByIdUrl: EXPENSE_API_ROUTES.UNIT,
+        unitUrl: EXPENSE_API_ROUTES.UNIT,
+        updateCallback,
+        updateParams,
+    });
+    // ==========================================================================
+    // REF SYNC (for callbacks to always call the latest fetch)
+    // ==========================================================================
+    useEffect(() => {
+        listFetchNowRef.current = listFetchNow;
+    }, [listFetchNow]);
+    // ==========================================================================
+    // AUTO-FETCH EFFECT (runs once, not per child mount)
+    // ==========================================================================
+    useEffect(() => {
+        var _a;
+        if (!schoolId)
+            return;
+        (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+    }, [listParams, schoolId]);
+    // ==========================================================================
+    // CONTEXT VALUE
+    // ==========================================================================
+    const value = useMemo(() => ({
+        listFetchNow,
+        listLoading,
+        updateFetchNow,
+        updateLoading,
+        byIdFetchNow,
+        byIdLoading,
+        deleteFetchNow,
+        deleteLoading,
+        resetFormAndCloseDrawer,
+    }), [
+        listFetchNow,
+        listLoading,
+        updateFetchNow,
+        updateLoading,
+        byIdFetchNow,
+        byIdLoading,
+        deleteFetchNow,
+        deleteLoading,
+        resetFormAndCloseDrawer,
+    ]);
+    return (_jsx(ExpenseApiContext.Provider, { value: value, children: children }));
+};

package/base-modules/expense/context/index.d.ts

@@ -0,0 +1,3 @@
+export { EXPENSE_DRAWER, EXPENSE_ACTION_TYPES, expenseModuleConfig, initialExpenseState, ExpenseProvider, expenseReducer, useExpenseContext, } from "./shared";
+export { ExpenseApiProvider, useExpenseApiContext, } from "./expense-api-provider";
+export { useExpenseModule } from "./use-expense-module";

package/base-modules/expense/context/index.js

@@ -0,0 +1,3 @@
+export { EXPENSE_DRAWER, EXPENSE_ACTION_TYPES, expenseModuleConfig, initialExpenseState, ExpenseProvider, expenseReducer, useExpenseContext, } from "./shared";
+export { ExpenseApiProvider, useExpenseApiContext, } from "./expense-api-provider";
+export { useExpenseModule } from "./use-expense-module";

package/base-modules/expense/{context.d.ts → context/shared.d.ts}

@@ -1,11 +1,16 @@
-import { type RowAction, type TableRow } from "@appcorp/shadcn/components/enhanced-table";
-import { EXPENSE_CATEGORY, EXPENSE_STATUS, ExpenseBE, PAYMENT_METHOD, SchoolBE } from "../../type";
+import { EXPENSE_CATEGORY, EXPENSE_STATUS, ExpenseBE, PAYMENT_METHOD, SchoolBE } from "../../../type";
 export declare const EXPENSE_DRAWER: {
     readonly FILTER_DRAWER: string;
     readonly FORM_DRAWER: string;
     readonly MORE_ACTIONS_DRAWER: string;
     readonly VIEW_DRAWER: string;
 };
+export interface ExpensesListResponse {
+    items: ExpenseBE[];
+    count: number;
+    currentPage: number;
+    pageLimit: number;
+}
 export declare const EXPENSE_ACTION_TYPES: {
     readonly RESET_FORM: "RESET_FORM";
     readonly SET_CURRENT_PAGE: "SET_CURRENT_PAGE";
@@ -186,68 +191,3 @@ export declare const EXPENSE_ACTION_TYPES: {
     filterStatus: EXPENSE_STATUS | "";
     school: SchoolBE | undefined;
 }>;
-export declare const useExpenseModule: () => {
-    applyFilters: () => void;
-    byIdLoading: boolean;
-    clearFilters: () => void;
-    clearSearch: () => void;
-    closeDrawer: () => void;
-    deleteLoading: boolean;
-    handleChange: (field: string, value: string | number | boolean | string[] | undefined) => void;
-    handleCreate: () => void;
-    handleDelete: (row?: TableRow) => void;
-    handleEdit: (row?: TableRow) => void;
-    handleFilters: () => void;
-    handleMoreActions: () => void;
-    handlePageChange: (page: number | unknown) => void;
-    handlePageLimitChange: (k: string, value: object) => void;
-    handleSearch: (query: string) => void;
-    handleSubmit: () => void;
-    handleView: (row?: TableRow) => void;
-    headerActions: {
-        enabled: boolean;
-        handleOnClick: () => void;
-        label: string;
-        order: number;
-    }[];
-    listFetchNow: (url?: string, config?: import("@react-pakistan/util-functions/hooks/use-fetch").FetchConfig) => void;
-    listLoading: boolean;
-    rowActions: RowAction[];
-    updateLoading: boolean;
-    handleCloseDrawer?: () => void;
-    state: {
-        items: ExpenseBE[];
-        count: number;
-        currentPage: number;
-        pageLimit: number;
-        searchQuery: string;
-        disableSaveButton: boolean;
-        drawer: string | null;
-        errors: Record<string, string>;
-        amount: number;
-        approvedBy: string;
-        attachments: string[];
-        category: EXPENSE_CATEGORY | "";
-        description: string;
-        enabled: boolean;
-        expenseDate: string;
-        id: string;
-        invoiceNumber: string;
-        paidBy: string;
-        paymentDate: string;
-        paymentMethod: PAYMENT_METHOD | "";
-        receiptNumber: string;
-        remarks: string;
-        schoolId: string;
-        status: EXPENSE_STATUS | "";
-        title: string;
-        transactionId: string;
-        vendorContact: string;
-        vendorName: string;
-        filterCategory: EXPENSE_CATEGORY | "";
-        filterEnabled: boolean | undefined;
-        filterStatus: EXPENSE_STATUS | "";
-        school: SchoolBE | undefined;
-    };
-    dispatch: React.Dispatch<any>;
-};

package/base-modules/expense/context/shared.js

@@ -0,0 +1,63 @@
+"use client";
+import { createGenericModule } from "@react-pakistan/util-functions/factory/generic-module-factory";
+import { DRAWER_TYPES } from "@react-pakistan/util-functions/factory/generic-component-factory";
+import { PAYMENT_METHOD, } from "../../../type";
+import { pageLimit } from "../constants";
+// ============================================================================
+// 1.1 DRAWER TYPES
+// ============================================================================
+export const EXPENSE_DRAWER = {
+    FILTER_DRAWER: DRAWER_TYPES.FILTER_DRAWER,
+    FORM_DRAWER: DRAWER_TYPES.FORM_DRAWER,
+    MORE_ACTIONS_DRAWER: DRAWER_TYPES.MORE_ACTIONS_DRAWER,
+    VIEW_DRAWER: DRAWER_TYPES.VIEW_DRAWER,
+};
+const expenseConfig = {
+    name: "Expense",
+    displayName: "Expense",
+    drawerTypes: DRAWER_TYPES,
+    initialState: {
+        // List Data
+        items: [],
+        count: 0,
+        // Search & Pagination
+        currentPage: 1,
+        pageLimit,
+        searchQuery: "",
+        // UI State
+        disableSaveButton: false,
+        drawer: null,
+        errors: {},
+        // Form fields
+        amount: 0,
+        approvedBy: "",
+        attachments: [],
+        category: "",
+        description: "",
+        enabled: true,
+        expenseDate: new Date().toISOString().slice(0, 10),
+        id: "",
+        invoiceNumber: "",
+        paidBy: "",
+        paymentDate: new Date().toISOString().slice(0, 10),
+        paymentMethod: PAYMENT_METHOD.CASH,
+        receiptNumber: "",
+        remarks: "",
+        schoolId: "",
+        status: "",
+        title: "",
+        transactionId: "",
+        vendorContact: "",
+        vendorName: "",
+        // Filters
+        filterCategory: "",
+        filterEnabled: undefined,
+        filterStatus: "",
+        // Relations
+        school: undefined,
+    },
+};
+// ============================================================================
+// 1.3 CREATE EXPENSE MODULE
+// ============================================================================
+export const { actionTypes: EXPENSE_ACTION_TYPES, config: expenseModuleConfig, initialState: initialExpenseState, Provider: ExpenseProvider, reducer: expenseReducer, useContext: useExpenseContext, } = createGenericModule(expenseConfig);

package/base-modules/expense/context/use-expense-module.d.ts

@@ -0,0 +1,66 @@
+import { type RowAction, type TableRow } from "@appcorp/shadcn/components/enhanced-table";
+export declare const useExpenseModule: () => {
+    applyFilters: () => void;
+    byIdLoading: boolean;
+    clearFilters: () => void;
+    clearSearch: () => void;
+    closeDrawer: () => void;
+    deleteLoading: boolean;
+    handleChange: (field: string, value: string | number | boolean | string[] | undefined) => void;
+    handleCreate: () => void;
+    handleDelete: (row?: TableRow) => void;
+    handleEdit: (row?: TableRow) => void;
+    handleFilters: () => void;
+    handleMoreActions: () => void;
+    handlePageChange: (page: number | unknown) => void;
+    handlePageLimitChange: (k: string, value: object) => void;
+    handleSearch: (query: string) => void;
+    handleSubmit: () => void;
+    handleView: (row?: TableRow) => void;
+    headerActions: {
+        enabled: boolean;
+        handleOnClick: () => void;
+        label: string;
+        order: number;
+    }[];
+    listFetchNow: (url?: string, config?: import("@react-pakistan/util-functions/hooks/use-fetch").FetchConfig) => void;
+    listLoading: boolean;
+    rowActions: RowAction[];
+    updateLoading: boolean;
+    handleCloseDrawer?: () => void;
+    state: {
+        items: import("../../../types").ExpenseBE[];
+        count: number;
+        currentPage: number;
+        pageLimit: number;
+        searchQuery: string;
+        disableSaveButton: boolean;
+        drawer: string | null;
+        errors: Record<string, string>;
+        amount: number;
+        approvedBy: string;
+        attachments: string[];
+        category: import("../../../types").EXPENSE_CATEGORY | "";
+        description: string;
+        enabled: boolean;
+        expenseDate: string;
+        id: string;
+        invoiceNumber: string;
+        paidBy: string;
+        paymentDate: string;
+        paymentMethod: import("../../../types").PAYMENT_METHOD | "";
+        receiptNumber: string;
+        remarks: string;
+        schoolId: string;
+        status: import("../../../types").EXPENSE_STATUS | "";
+        title: string;
+        transactionId: string;
+        vendorContact: string;
+        vendorName: string;
+        filterCategory: import("../../../types").EXPENSE_CATEGORY | "";
+        filterEnabled: boolean | undefined;
+        filterStatus: import("../../../types").EXPENSE_STATUS | "";
+        school: import("../../../types").SchoolBE | undefined;
+    };
+    dispatch: React.Dispatch<any>;
+};