@appcorp/fusion-storybook 0.4.39 → 0.4.40

package/base-modules/bulk-operations/constants.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Bulk Operations Constants
+ *
+ * Organization:
+ * - Page Configuration
+ * - Status Options
+ */
+export declare const pageLimit: number;
+export declare const BULK_JOB_STATUS_OPTIONS: {
+    label: string;
+    value: string;
+}[];

package/base-modules/bulk-operations/constants.js

@@ -0,0 +1,20 @@
+/**
+ * Bulk Operations Constants
+ *
+ * Organization:
+ * - Page Configuration
+ * - Status Options
+ */
+// ============================================================================
+// PAGE CONFIGURATION
+// ============================================================================
+export const pageLimit = Number(process.env.NEXT_PUBLIC_PAGE_LIMIT) || 10;
+// ============================================================================
+// STATUS OPTIONS
+// ============================================================================
+export const BULK_JOB_STATUS_OPTIONS = [
+    { label: "queued", value: "queued" },
+    { label: "running", value: "running" },
+    { label: "completed", value: "completed" },
+    { label: "failed", value: "failed" },
+];

package/base-modules/bulk-operations/context.d.ts

@@ -0,0 +1,172 @@
+import { type HeaderAction, type RowAction, type TableRow } from "@appcorp/shadcn/components/enhanced-table";
+import { BulkJobRecord } from "../../type";
+export declare const BULK_OPERATIONS_DRAWER: {
+    readonly FILTER_DRAWER: string;
+    readonly VIEW_DRAWER: string;
+};
+export declare const BULK_OPERATIONS_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";
+}, bulkOperationsModuleConfig: import("@react-pakistan/util-functions/factory/generic-module-factory").ModuleConfig<{
+    items: BulkJobRecord[];
+    count: number;
+    types: string[];
+    currentPage: number;
+    pageLimit: number;
+    searchQuery: string;
+    filterStatus: string;
+    filterType: string;
+    createdAt: string;
+    errors: Record<string, string>;
+    jobId: string;
+    processed: number;
+    results: BulkJobRecord["results"];
+    status: string;
+    total: number;
+    type: string;
+    updatedAt: string;
+    webhookUrl: string | null;
+    disableSaveButton: boolean;
+    drawer: string | null;
+}>, initialBulkOperationsState: {
+    items: BulkJobRecord[];
+    count: number;
+    types: string[];
+    currentPage: number;
+    pageLimit: number;
+    searchQuery: string;
+    filterStatus: string;
+    filterType: string;
+    createdAt: string;
+    errors: Record<string, string>;
+    jobId: string;
+    processed: number;
+    results: BulkJobRecord["results"];
+    status: string;
+    total: number;
+    type: string;
+    updatedAt: string;
+    webhookUrl: string | null;
+    disableSaveButton: boolean;
+    drawer: string | null;
+}, BulkOperationsProvider: import("react").FC<{
+    children: React.ReactNode;
+}>, bulkOperationsReducer: (state: {
+    items: BulkJobRecord[];
+    count: number;
+    types: string[];
+    currentPage: number;
+    pageLimit: number;
+    searchQuery: string;
+    filterStatus: string;
+    filterType: string;
+    createdAt: string;
+    errors: Record<string, string>;
+    jobId: string;
+    processed: number;
+    results: BulkJobRecord["results"];
+    status: string;
+    total: number;
+    type: string;
+    updatedAt: string;
+    webhookUrl: string | null;
+    disableSaveButton: boolean;
+    drawer: string | null;
+}, action: any) => {
+    items: BulkJobRecord[];
+    count: number;
+    types: string[];
+    currentPage: number;
+    pageLimit: number;
+    searchQuery: string;
+    filterStatus: string;
+    filterType: string;
+    createdAt: string;
+    errors: Record<string, string>;
+    jobId: string;
+    processed: number;
+    results: BulkJobRecord["results"];
+    status: string;
+    total: number;
+    type: string;
+    updatedAt: string;
+    webhookUrl: string | null;
+    disableSaveButton: boolean;
+    drawer: string | null;
+}, useBulkOperationsContext: () => import("@react-pakistan/util-functions/factory/generic-module-factory").GenericModuleContextWithHandlers<{
+    items: BulkJobRecord[];
+    count: number;
+    types: string[];
+    currentPage: number;
+    pageLimit: number;
+    searchQuery: string;
+    filterStatus: string;
+    filterType: string;
+    createdAt: string;
+    errors: Record<string, string>;
+    jobId: string;
+    processed: number;
+    results: BulkJobRecord["results"];
+    status: string;
+    total: number;
+    type: string;
+    updatedAt: string;
+    webhookUrl: string | null;
+    disableSaveButton: boolean;
+    drawer: string | null;
+}>;
+export declare const BULK_OPERATIONS_STATUS_OPTIONS: {
+    label: string;
+    value: string;
+}[];
+export declare const useBulkOperationsModule: () => {
+    applyFilters: () => void;
+    clearFilters: () => void;
+    clearSearch: () => void;
+    closeDrawer: () => void;
+    handleChange: (field: string, value: string | number | boolean | undefined) => void;
+    handleFilters: () => void;
+    handlePageChange: (pageOrEvent?: unknown) => void;
+    handlePageLimitChange: (k: string, value: object) => void;
+    handleRefresh: () => void;
+    handleSearch: (query: string) => void;
+    handleView: (row?: TableRow) => void;
+    headerActions: HeaderAction[];
+    listFetchNow: (url?: string, config?: import("@react-pakistan/util-functions/hooks/use-fetch").FetchConfig) => void;
+    listLoading: boolean;
+    rowActions: RowAction[];
+    handleCloseDrawer?: () => void;
+    handleSubmit?: (data: any) => void;
+    state: {
+        items: BulkJobRecord[];
+        count: number;
+        types: string[];
+        currentPage: number;
+        pageLimit: number;
+        searchQuery: string;
+        filterStatus: string;
+        filterType: string;
+        createdAt: string;
+        errors: Record<string, string>;
+        jobId: string;
+        processed: number;
+        results: BulkJobRecord["results"];
+        status: string;
+        total: number;
+        type: string;
+        updatedAt: string;
+        webhookUrl: string | null;
+        disableSaveButton: boolean;
+        drawer: string | null;
+    };
+    dispatch: React.Dispatch<any>;
+};

package/base-modules/bulk-operations/context.js

@@ -0,0 +1,283 @@
+"use client";
+/**
+ * Bulk Operations Module — business logic + API integration
+ *
+ * Read-only module that lists all Redis-backed bulk jobs for the current school.
+ * Uses the generic module state (`createGenericModule`) wired to `useModuleEntityV2`.
+ * No create/edit/delete — only list (search, filter, paginate), a view drawer,
+ * and a manual refresh header action.
+ */
+import { useCallback, useEffect, useMemo, useRef } from "react";
+import { useTheme } from "next-themes";
+import { useTranslations } from "next-intl";
+import { useDebounce } from "@react-pakistan/util-functions/hooks/use-debounce";
+import { useModuleEntityV2, } from "@react-pakistan/util-functions/hooks/use-module-entity-v2";
+import { createGenericModule } from "@react-pakistan/util-functions/factory/generic-module-factory";
+import { DRAWER_TYPES } from "@react-pakistan/util-functions/factory/generic-component-factory";
+import { generateThemeToast, TOAST_VARIANT, } from "@appcorp/shadcn/lib/toast-utils";
+import { pageLimit } from "./constants";
+import { BULK_OPERATIONS_API_ROUTES } from "../../constants";
+import { getCachedWorkspaceSync } from "../workspace/cache";
+// ============================================================================
+// 1.1 DRAWER TYPES
+// ============================================================================
+export const BULK_OPERATIONS_DRAWER = {
+    FILTER_DRAWER: DRAWER_TYPES.FILTER_DRAWER,
+    VIEW_DRAWER: DRAWER_TYPES.VIEW_DRAWER,
+};
+// ============================================================================
+// 1.2 MODULE CONFIGURATION
+// ============================================================================
+const BULK_OPERATIONS_CONFIG = {
+    name: "Bulk Operations",
+    displayName: "Bulk Operations",
+    drawerTypes: DRAWER_TYPES,
+    initialState: {
+        // List Data
+        items: [],
+        count: 0,
+        types: [],
+        // Search & Pagination
+        currentPage: 1,
+        pageLimit,
+        searchQuery: "",
+        // Filters
+        filterStatus: "",
+        filterType: "",
+        // View Drawer Data (populated via SET_FORM_DATA spread on row View)
+        createdAt: "",
+        errors: {},
+        jobId: "",
+        processed: 0,
+        results: null,
+        status: "",
+        total: 0,
+        type: "",
+        updatedAt: "",
+        webhookUrl: null,
+        // UI State
+        disableSaveButton: false,
+        drawer: null,
+    },
+};
+export const { actionTypes: BULK_OPERATIONS_ACTION_TYPES, config: bulkOperationsModuleConfig, initialState: initialBulkOperationsState, Provider: BulkOperationsProvider, reducer: bulkOperationsReducer, useContext: useBulkOperationsContext, } = createGenericModule(BULK_OPERATIONS_CONFIG);
+// ============================================================================
+// 1.3 ENHANCED BULK OPERATIONS HOOK WITH API INTEGRATION
+// ============================================================================
+export const BULK_OPERATIONS_STATUS_OPTIONS = [
+    { label: "queued", value: "queued" },
+    { label: "running", value: "running" },
+    { label: "completed", value: "completed" },
+    { label: "failed", value: "failed" },
+];
+export const useBulkOperationsModule = () => {
+    var _a;
+    const context = useBulkOperationsContext();
+    const { dispatch } = context;
+    const state = context.state;
+    const t = useTranslations("bulkOperations");
+    const { theme } = useTheme();
+    const workspace = getCachedWorkspaceSync();
+    const schoolId = ((_a = workspace === null || workspace === void 0 ? void 0 : workspace.school) === null || _a === void 0 ? void 0 : _a.id) || "";
+    const listFetchNowRef = useRef(null);
+    const debouncedQuery = useDebounce(state.searchQuery, 800);
+    // ==========================================================================
+    // 1.3.1 API PARAMETERS
+    // ==========================================================================
+    const listParams = useMemo(() => (Object.assign(Object.assign(Object.assign({ currentPage: state.currentPage, pageLimit: state.pageLimit, schoolId }, (state.filterType ? { type: state.filterType } : {})), (state.filterStatus ? { status: state.filterStatus } : {})), (debouncedQuery ? { q: debouncedQuery } : {}))), [
+        state.currentPage,
+        state.filterStatus,
+        state.filterType,
+        state.pageLimit,
+        debouncedQuery,
+        schoolId,
+    ]);
+    const noopParams = useMemo(() => ({}), []);
+    const noopCallback = useCallback(() => { }, []);
+    // ==========================================================================
+    // 1.3.2 UTILITIES
+    // ==========================================================================
+    const showToast = useCallback((description, variant) => {
+        generateThemeToast({
+            description,
+            theme: theme,
+            variant,
+        });
+    }, [theme]);
+    const closeDrawer = useCallback(() => {
+        dispatch({ type: BULK_OPERATIONS_ACTION_TYPES.SET_DRAWER, payload: { drawer: null } });
+    }, [dispatch]);
+    // ==========================================================================
+    // 1.3.3 API CALLBACKS
+    // ==========================================================================
+    const listCallback = useCallback(({ data, error }) => {
+        var _a, _b;
+        if (error) {
+            showToast(t("messagesNetworkError"), TOAST_VARIANT.ERROR);
+            return;
+        }
+        if (data) {
+            const response = data;
+            dispatch({
+                type: BULK_OPERATIONS_ACTION_TYPES.SET_ITEMS,
+                payload: {
+                    items: (_a = response.items) !== null && _a !== void 0 ? _a : [],
+                    count: typeof response.count === "number" ? response.count : 0,
+                },
+            });
+            dispatch({
+                type: BULK_OPERATIONS_ACTION_TYPES.SET_INPUT_FIELD,
+                payload: { key: "types", value: (_b = response.types) !== null && _b !== void 0 ? _b : [] },
+            });
+        }
+    }, [dispatch, showToast, t]);
+    // ==========================================================================
+    // 1.3.4 API HOOKS
+    // ==========================================================================
+    const { listFetchNow, listLoading } = useModuleEntityV2({
+        byIdCallback: noopCallback,
+        byIdParams: noopParams,
+        listCallback,
+        listParams,
+        listUrl: BULK_OPERATIONS_API_ROUTES.LIST,
+        searchQuery: debouncedQuery,
+        unitByIdUrl: BULK_OPERATIONS_API_ROUTES.LIST,
+        unitUrl: BULK_OPERATIONS_API_ROUTES.LIST,
+        updateCallback: noopCallback,
+        updateParams: noopParams,
+        headers: {},
+    });
+    // ==========================================================================
+    // 1.3.5 HANDLERS
+    // ==========================================================================
+    const handleChange = useCallback((field, value) => {
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key: field, value },
+        });
+    }, [dispatch]);
+    const handlePageChange = useCallback((pageOrEvent) => {
+        const page = typeof pageOrEvent === "number" && !isNaN(pageOrEvent)
+            ? pageOrEvent
+            : state.currentPage + 1;
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: page },
+        });
+    }, [dispatch, state.currentPage]);
+    const handlePageLimitChange = useCallback((k, value) => {
+        const val = Object.assign({}, value);
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_PAGE_LIMIT,
+            payload: { pageLimit: Number(val.option) },
+        });
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+    }, [dispatch]);
+    const handleSearch = useCallback((query) => {
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_SEARCH_QUERY,
+            payload: { searchQuery: query },
+        });
+    }, [dispatch]);
+    const clearFilters = useCallback(() => {
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_FILTERS,
+            payload: { filters: { filterType: "", filterStatus: "" } },
+        });
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+    }, [dispatch]);
+    const clearSearch = useCallback(() => {
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_SEARCH_QUERY,
+            payload: { searchQuery: "" },
+        });
+    }, [dispatch]);
+    const handleFilters = useCallback(() => {
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: BULK_OPERATIONS_DRAWER.FILTER_DRAWER },
+        });
+    }, [dispatch]);
+    const handleRefresh = useCallback(() => {
+        var _a;
+        (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+    }, []);
+    const handleView = useCallback((row) => {
+        if (!row)
+            return;
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_FORM_DATA,
+            payload: { form: Object.assign({}, row) },
+        });
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_DRAWER,
+            payload: { drawer: BULK_OPERATIONS_DRAWER.VIEW_DRAWER },
+        });
+    }, [dispatch]);
+    const applyFilters = useCallback(() => {
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_CURRENT_PAGE,
+            payload: { currentPage: 1 },
+        });
+        closeDrawer();
+    }, [dispatch, closeDrawer]);
+    // ==========================================================================
+    // 1.3.6 EFFECTS
+    // ==========================================================================
+    useEffect(() => {
+        listFetchNowRef.current = listFetchNow;
+    }, [listFetchNow]);
+    useEffect(() => {
+        var _a;
+        (_a = listFetchNowRef.current) === null || _a === void 0 ? void 0 : _a.call(listFetchNowRef);
+    }, [listParams]);
+    // ==========================================================================
+    // 1.3.7 HEADER & ROW ACTIONS
+    // ==========================================================================
+    const headerActions = useMemo(() => [
+        {
+            enabled: true,
+            handleOnClick: handleRefresh,
+            label: t("actionsButtonRefresh"),
+            order: 0,
+        },
+        {
+            enabled: true,
+            handleOnClick: handleFilters,
+            label: t("actionsButtonFilters"),
+            order: 1,
+        },
+    ], [handleFilters, handleRefresh, t]);
+    const rowActions = useMemo(() => [
+        {
+            enabled: true,
+            handleOnClick: handleView,
+            label: t("actionsButtonView"),
+            order: 0,
+        },
+    ], [handleView, t]);
+    // ==========================================================================
+    // 1.3.8 RETURN
+    // ==========================================================================
+    return Object.assign(Object.assign({}, context), { applyFilters,
+        clearFilters,
+        clearSearch,
+        closeDrawer,
+        handleChange,
+        handleFilters,
+        handlePageChange,
+        handlePageLimitChange,
+        handleRefresh,
+        handleSearch,
+        handleView,
+        headerActions,
+        listFetchNow,
+        listLoading,
+        rowActions });
+};

package/base-modules/bulk-operations/filter.d.ts

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

package/base-modules/bulk-operations/filter.js

@@ -0,0 +1,31 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Bulk Operations Filter
+ *
+ * Filter UI for the bulk-operations list. Supports filterType (select, options
+ * populated from the list response `types`) and filterStatus (select).
+ *
+ * Uses the base generic context directly (state + dispatch) rather than the
+ * enhanced module hook, so consuming this component does not create a second
+ * useModuleEntityV2 instance / auto-fetch effect.
+ */
+import { useTranslations } from "next-intl";
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from "@appcorp/shadcn/components/ui/select";
+import { Label } from "@appcorp/shadcn/components/ui/label";
+import { BULK_OPERATIONS_ACTION_TYPES, useBulkOperationsContext } from "./context";
+import { BULK_JOB_STATUS_OPTIONS } from "./constants";
+export const BulkOperationsFilter = () => {
+    const t = useTranslations("bulkOperations");
+    const { state, dispatch } = useBulkOperationsContext();
+    const { filterType, filterStatus, types } = state;
+    const handleChange = (field, value) => {
+        dispatch({
+            type: BULK_OPERATIONS_ACTION_TYPES.SET_INPUT_FIELD,
+            payload: { key: field, value },
+        });
+    };
+    const typeValue = filterType || "__none";
+    const statusValue = filterStatus || "__none";
+    return (_jsxs("div", { className: "space-y-4", children: [_jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "filterType", children: t("filterTypeLabel") }), _jsxs(Select, { value: typeValue, onValueChange: (v) => handleChange("filterType", v === "__none" ? "" : v), children: [_jsx(SelectTrigger, { id: "filterType", className: "w-full", children: _jsx(SelectValue, { placeholder: t("filterAllTypes") }) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "__none", children: t("filterAllTypes") }), types.map((type) => (_jsx(SelectItem, { value: type, children: type }, type)))] })] })] }), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: "filterStatus", children: t("filterStatusLabel") }), _jsxs(Select, { value: statusValue, onValueChange: (v) => handleChange("filterStatus", v === "__none" ? "" : v), children: [_jsx(SelectTrigger, { id: "filterStatus", className: "w-full", children: _jsx(SelectValue, { placeholder: t("filterAllStatuses") }) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "__none", children: t("filterAllStatuses") }), BULK_JOB_STATUS_OPTIONS.map((opt) => (_jsx(SelectItem, { value: opt.value, children: opt.label }, opt.value)))] })] })] })] }));
+};

package/base-modules/bulk-operations/page.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Bulk Operations 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)
+ *   - bulkOperationsConfig (memoised on locale + drawer change only)
+ *   - permission guard
+ *
+ * Exported utilities: `BulkOperationsPage`
+ */
+import { FC } from "react";
+import { USER_ROLE } from "../../type";
+interface Props {
+    cancelLabel: string;
+    drawerFilterDescription: string;
+    drawerFilterTitle: string;
+    drawerViewDescription: string;
+    drawerViewTitle: string;
+    labelActions: string;
+    labelId: string;
+    labelProgress: string;
+    labelState: string;
+    labelStatus: string;
+    labelType: string;
+    saveLabel: string;
+    searchPlaceholder: string;
+    tableDescription: string;
+    tableTitle: string;
+    userRole: USER_ROLE;
+}
+export declare const BulkOperationsPage: FC<Props>;
+export {};