@pagamio/frontend-commons-lib 0.8.357 → 0.8.358

package/lib/pagamio-table/data-table/ExportButton.d.ts

@@ -52,10 +52,17 @@ type ExportDropdownProps<T extends Record<string, any>> = {
     csvOptions?: CsvExportOptions;
     exportAll?: boolean;
     fetchData?: (params?: Record<string, string>, onProgress?: (fetched: number, total: number) => void) => Promise<T[]>;
+    asyncExport?: {
+        threshold: number;
+        totalRows: number;
+        requestExport: (format: 'csv' | 'xlsx' | 'pdf') => Promise<void>;
+        onQueued?: (message: string) => void;
+        onError?: (error: Error) => void;
+    };
     enableEmailExport?: boolean;
     emailExportApiUrl?: string;
     onEmailExportSuccess?: (message: string) => void;
     onEmailExportError?: (error: Error) => void;
 };
-declare const ExportDropdown: <T extends Record<string, any>>({ data, columns, containerClassName, buttonClassName, extraOptions, pdfOptions, xlsxOptions, csvOptions, exportAll, fetchData, enableEmailExport, emailExportApiUrl, onEmailExportSuccess, onEmailExportError, }: ExportDropdownProps<T>) => import("react/jsx-runtime").JSX.Element;
+declare const ExportDropdown: <T extends Record<string, any>>({ data, columns, containerClassName, buttonClassName, extraOptions, pdfOptions, xlsxOptions, csvOptions, exportAll, fetchData, asyncExport, enableEmailExport, emailExportApiUrl, onEmailExportSuccess, onEmailExportError, }: ExportDropdownProps<T>) => import("react/jsx-runtime").JSX.Element;
 export default ExportDropdown;

package/lib/pagamio-table/data-table/ExportButton.js

@@ -5,7 +5,7 @@ import { HiMail } from 'react-icons/hi';
 import { useEffect, useRef, useState } from 'react';
 import { Button, Modal, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '../../components';
 import { exportToCsv, exportToPdf, exportToXlsx, generateExportAsFile, sendExportEmail } from './exportUtils';
-const ExportDropdown = ({ data, columns, containerClassName, buttonClassName, extraOptions = [], pdfOptions, xlsxOptions, csvOptions, exportAll = false, fetchData, enableEmailExport = false, emailExportApiUrl, onEmailExportSuccess, onEmailExportError, }) => {
+const ExportDropdown = ({ data, columns, containerClassName, buttonClassName, extraOptions = [], pdfOptions, xlsxOptions, csvOptions, exportAll = false, fetchData, asyncExport, enableEmailExport = false, emailExportApiUrl, onEmailExportSuccess, onEmailExportError, }) => {
     const [exportType, setExportType] = useState(null);
     const [excludedColumns, setExcludedColumns] = useState(['action']);
     const [isExporting, setIsExporting] = useState(false);
@@ -114,11 +114,28 @@ const ExportDropdown = ({ data, columns, containerClassName, buttonClassName, ex
         setPendingEmailFormat(null);
         setIsExporting(false);
     };
+    // When exporting all and the dataset is too large to pull into the browser,
+    // hand off to the async backend job instead of paging through it client-side.
+    const shouldQueueAsync = exportAllData && !!asyncExport && asyncExport.totalRows > asyncExport.threshold;
     const handleContinue = async () => {
         const includedColumns = getIncludedColumns();
         setIsExporting(true);
         setExportProgress(null);
         try {
+            if (shouldQueueAsync && asyncExport) {
+                // Async path: server generates the file off the request path and
+                // delivers it via export history / email. Nothing to render here.
+                const format = (isEmailExport ? emailFormat : exportType);
+                try {
+                    await asyncExport.requestExport(format);
+                    asyncExport.onQueued?.('Your export is being prepared. It will appear in export history when ready.');
+                }
+                catch (err) {
+                    asyncExport.onError?.(err instanceof Error ? err : new Error('Export request failed'));
+                }
+                setExportType(null);
+                return;
+            }
             const exportData = exportAllData && fetchData
                 ? await fetchData({ exportAll: 'true' }, (fetched, total) => setExportProgress({ fetched, total }))
                 : data;
@@ -162,7 +179,9 @@ const ExportDropdown = ({ data, columns, containerClassName, buttonClassName, ex
     };
     // Show popover when exportType is set and Select is closed
     const popoverOpened = exportType !== null && !selectOpen;
-    return (_jsxs("div", { className: `w-40 ${containerClassName ?? ''}`, children: [_jsxs(Select, { value: exportType ?? 'none', open: selectOpen, onOpenChange: setSelectOpen, onValueChange: (value) => handleExportChange(value === 'none' ? null : value), children: [_jsx(SelectTrigger, { className: `w-full ${buttonClassName ?? ''}`, children: _jsx(SelectValue, { placeholder: "Export Data" }) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "none", children: _jsx("span", { className: "text-muted-foreground", children: "Export Data As" }) }, "reset"), exportOptions.map((option) => (_jsx(SelectItem, { value: option.value, children: option.label }, option.value))), extraOptions.map((option) => (_jsx(SelectItem, { value: option.value, children: option.label }, option.value)))] })] }, "export-dropdown"), popoverOpened && (_jsxs("div", { ref: popoverRef, className: "mt-2 bg-background rounded-md shadow-lg p-4 z-50 absolute w-45", children: [_jsx("div", { className: "text-sm text-muted-foreground pb-3", children: "Uncheck to exclude column from export" }), _jsxs("div", { className: "mb-4 p-3 bg-muted rounded-md", children: [_jsxs("div", { className: "flex items-center gap-x-2", children: [_jsx(Checkbox, { id: "export-all-data", checked: exportAllData, onChange: (event) => setExportAllData(event.currentTarget.checked), className: "checked:!bg-primary checked:!border-primary" }), _jsx(Label, { htmlFor: "export-all-data", className: "text-sm font-medium", children: "Export all data" })] }), _jsx("p", { className: "text-xs text-muted-foreground mt-1 ml-6", children: "This will fetch all records for the table" })] }), _jsx(Stack, { children: columns.map((col) => {
+    return (_jsxs("div", { className: `w-40 ${containerClassName ?? ''}`, children: [_jsxs(Select, { value: exportType ?? 'none', open: selectOpen, onOpenChange: setSelectOpen, onValueChange: (value) => handleExportChange(value === 'none' ? null : value), children: [_jsx(SelectTrigger, { className: `w-full ${buttonClassName ?? ''}`, children: _jsx(SelectValue, { placeholder: "Export Data" }) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "none", children: _jsx("span", { className: "text-muted-foreground", children: "Export Data As" }) }, "reset"), exportOptions.map((option) => (_jsx(SelectItem, { value: option.value, children: option.label }, option.value))), extraOptions.map((option) => (_jsx(SelectItem, { value: option.value, children: option.label }, option.value)))] })] }, "export-dropdown"), popoverOpened && (_jsxs("div", { ref: popoverRef, className: "mt-2 bg-background rounded-md shadow-lg p-4 z-50 absolute w-45", children: [_jsx("div", { className: "text-sm text-muted-foreground pb-3", children: "Uncheck to exclude column from export" }), _jsxs("div", { className: "mb-4 p-3 bg-muted rounded-md", children: [_jsxs("div", { className: "flex items-center gap-x-2", children: [_jsx(Checkbox, { id: "export-all-data", checked: exportAllData, onChange: (event) => setExportAllData(event.currentTarget.checked), className: "checked:!bg-primary checked:!border-primary" }), _jsx(Label, { htmlFor: "export-all-data", className: "text-sm font-medium", children: "Export all data" })] }), _jsx("p", { className: "text-xs text-muted-foreground mt-1 ml-6", children: shouldQueueAsync
+                                    ? 'This dataset is large — it will be prepared in the background and appear in export history.'
+                                    : 'This will fetch all records for the table' })] }), _jsx(Stack, { children: columns.map((col) => {
                             if (col.accessorKey !== 'action') {
                                 return (_jsxs("div", { className: "flex items-center gap-x-2", children: [_jsx(Checkbox, { id: col.header, checked: !excludedColumns.includes(col.accessorKey), onChange: (event) => handleCheckboxChange(col.accessorKey, !event.currentTarget.checked), className: "checked:!bg-primary checked:!border-primary" }), _jsx(Label, { htmlFor: "rememberMe", children: col.header })] }, col.accessorKey));
                             }

package/lib/pagamio-table/data-table/index.js

@@ -97,7 +97,7 @@ function CustomToolbar({ filters, appliedFilters, onFilterChange, onApply, onCle
             else {
                 handleFilter(name, value);
             }
-        }, handleApplyFilters: onApply, resetFilters: onClearFilters ?? (() => { }), showSearch: searchEnabled, searchQuery: searchQuery, onSearch: onSearch, isNarrow: isNarrow, children: _jsxs("div", { className: "flex flex-wrap items-center justify-end gap-2", children: [exportConfig?.enabled && (_jsx(ExportDropdown, { containerClassName: isNarrow ? 'w-full' : undefined, columns: columns, data: data, buttonClassName: "h-10", extraOptions: exportConfig.extraOptions, pdfOptions: exportConfig.pdf, xlsxOptions: exportConfig.xlsx, csvOptions: exportConfig.csv, exportAll: !!exportConfig.fetchAllData, fetchData: exportConfig.fetchAllData, enableEmailExport: !!exportConfig.email, emailExportApiUrl: exportConfig.email?.apiUrl, onEmailExportSuccess: exportConfig.email?.onSuccess, onEmailExportError: exportConfig.email?.onError })), addButton &&
+        }, handleApplyFilters: onApply, resetFilters: onClearFilters ?? (() => { }), showSearch: searchEnabled, searchQuery: searchQuery, onSearch: onSearch, isNarrow: isNarrow, children: _jsxs("div", { className: "flex flex-wrap items-center justify-end gap-2", children: [exportConfig?.enabled && (_jsx(ExportDropdown, { containerClassName: isNarrow ? 'w-full' : undefined, columns: columns, data: data, buttonClassName: "h-10", extraOptions: exportConfig.extraOptions, pdfOptions: exportConfig.pdf, xlsxOptions: exportConfig.xlsx, csvOptions: exportConfig.csv, exportAll: !!exportConfig.fetchAllData, fetchData: exportConfig.fetchAllData, asyncExport: exportConfig.asyncExport, enableEmailExport: !!exportConfig.email, emailExportApiUrl: exportConfig.email?.apiUrl, onEmailExportSuccess: exportConfig.email?.onSuccess, onEmailExportError: exportConfig.email?.onError })), addButton &&
                     (typeof addButton === 'boolean' ? (_jsx(IconButton, { onClick: onAdd ?? (() => { }), icon: HiPlusSm, label: "add-new-entry", className: cn('items-center text-nowrap', isNarrow ? 'w-full' : undefined), children: addText ?? 'Add New Entry' })) : (addButton))] }) }));
 }
 // ─── PagamioTable Component ──────────────────────────────────────────

package/lib/pagamio-table/data-table/types.d.ts

@@ -95,6 +95,29 @@ export interface ExportConfig<T extends Record<string, any>> {
         onSuccess?: (message: string) => void;
         onError?: (error: Error) => void;
     };
+    /**
+     * Async (queued) export for datasets too large to page through and render in
+     * the browser. When "Export all data" is checked and `totalRows > threshold`,
+     * the export button calls `requestExport(format)` instead of fetching the
+     * whole set client-side — the backend generates the file off the request path
+     * and delivers it via export history / email.
+     *
+     * `usePagamioTable` auto-wires `totalRows` from the table's row count; the
+     * consumer supplies `threshold` and `requestExport` (which POSTs to
+     * `/exports` with its `resourceKey` + current filters).
+     */
+    asyncExport?: {
+        /** Row count above which export is queued instead of run client-side. */
+        threshold: number;
+        /** Current total server rows (auto-wired by the hook). */
+        totalRows: number;
+        /** Queue a server-side export of the full dataset in the chosen format. */
+        requestExport: (format: 'csv' | 'xlsx' | 'pdf') => Promise<void>;
+        /** Called after a successful queue request (e.g. to toast the user). */
+        onQueued?: (message: string) => void;
+        /** Called if the queue request fails. */
+        onError?: (error: Error) => void;
+    };
 }
 export interface ToolbarConfig<T extends Record<string, any>> {
     filters?: BaseFilter[];

package/lib/shared/hooks/usePagamioTable.js

@@ -369,6 +369,14 @@ export const usePagamioTable = ({ queryKey, queryFn, enabled: queryEnabled = tru
                     export: {
                         ...toolbar.export,
                         fetchAllData: toolbar.export.fetchAllData ?? fetchAllPages,
+                        // Keep the async-export row count in sync with the live total so
+                        // the consumer only has to supply `threshold` + `requestExport`.
+                        ...(toolbar.export.asyncExport && {
+                            asyncExport: {
+                                ...toolbar.export.asyncExport,
+                                totalRows: totalItems,
+                            },
+                        }),
                     },
                 }),
             },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pagamio/frontend-commons-lib",
   "description": "Pagamio library for Frontend reusable components like the form engine and table container",
-  "version": "0.8.357",
+  "version": "0.8.358",
   "publishConfig": {
     "access": "public",
     "provenance": false