@pagamio/frontend-commons-lib 0.8.340 → 0.8.341

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

@@ -177,6 +177,15 @@ export interface UsePagamioTableConfig<T extends BaseEntity> {
     enabled?: boolean;
     staleTime?: number;
     gcTime?: number;
+    /**
+     * Auto-refetch interval (ms) for tables backed by long-running jobs
+     * (exports, imports, async report generation). Pass a fixed number to
+     * always poll, `false` to disable, or a predicate `(rows) => number | false`
+     * that returns the interval only while any row is still in flight — the
+     * predicate runs on every fetch settle so polling stops automatically
+     * once everything is terminal.
+     */
+    refetchInterval?: number | false | ((rows: T[]) => number | false);
     /**
      * Keep the previous page's rows visible while the next page fetches
      * (TanStack `placeholderData: keepPreviousData`). Defaults to true so

package/lib/shared/hooks/usePagamioTable.d.ts

@@ -17,4 +17,4 @@ export declare const pagamioMapping: ResponseMapping;
  * The hook tracks `page` zero-indexed internally; we bump on the way out.
  */
 export declare const pagamioQueryConfig: QueryParamConfig;
-export declare const usePagamioTable: <T extends BaseEntity>({ queryKey, queryFn, enabled: queryEnabled, staleTime, gcTime, keepPreviousData: keepPrev, data: clientData, columns, defaultFilters, responseMapping, queryParamConfig, pagination: paginationConfig, filtering: filteringConfig, sorting: sortingConfig, toolbar, searchPlaceholder, onRowClick, rowClassName, expandable, renderDetailPanel, }: UsePagamioTableConfig<T>) => UsePagamioTableReturn<T>;
+export declare const usePagamioTable: <T extends BaseEntity>({ queryKey, queryFn, enabled: queryEnabled, staleTime, gcTime, refetchInterval, keepPreviousData: keepPrev, data: clientData, columns, defaultFilters, responseMapping, queryParamConfig, pagination: paginationConfig, filtering: filteringConfig, sorting: sortingConfig, toolbar, searchPlaceholder, onRowClick, rowClassName, expandable, renderDetailPanel, }: UsePagamioTableConfig<T>) => UsePagamioTableReturn<T>;

package/lib/shared/hooks/usePagamioTable.js

@@ -158,7 +158,7 @@ function clientSort(items, sortConfig) {
     return sorted;
 }
 // ─── Hook ────────────────────────────────────────────────────────────
-export const usePagamioTable = ({ queryKey, queryFn, enabled: queryEnabled = true, staleTime, gcTime, keepPreviousData: keepPrev = true, data: clientData, columns, defaultFilters = {}, responseMapping = springBootMapping, queryParamConfig = defaultQueryConfig, pagination: paginationConfig = { enabled: true, mode: 'client' }, filtering: filteringConfig = { enabled: true, mode: 'client', searchMode: 'server' }, sorting: sortingConfig = { enabled: true, mode: 'client' }, toolbar, searchPlaceholder, onRowClick, rowClassName, expandable, renderDetailPanel, }) => {
+export const usePagamioTable = ({ queryKey, queryFn, enabled: queryEnabled = true, staleTime, gcTime, refetchInterval, keepPreviousData: keepPrev = true, data: clientData, columns, defaultFilters = {}, responseMapping = springBootMapping, queryParamConfig = defaultQueryConfig, pagination: paginationConfig = { enabled: true, mode: 'client' }, filtering: filteringConfig = { enabled: true, mode: 'client', searchMode: 'server' }, sorting: sortingConfig = { enabled: true, mode: 'client' }, toolbar, searchPlaceholder, onRowClick, rowClassName, expandable, renderDetailPanel, }) => {
     // ── Local state ──────────────────────────────────────────────────
     const [currentPage, setCurrentPage] = useState(paginationConfig.pageIndex ?? 0);
     const [pageSize, setPageSize] = useState(paginationConfig.pageSize ?? 10);
@@ -190,6 +190,18 @@ export const usePagamioTable = ({ queryKey, queryFn, enabled: queryEnabled = tru
         staleTime,
         gcTime,
         placeholderData: keepPrev ? keepPreviousData : undefined,
+        // Predicate form re-extracts rows from the raw response so callers can
+        // gate polling on row state (e.g. "any pending export") without needing
+        // to know the responseMapping shape.
+        refetchInterval: typeof refetchInterval === 'function'
+            ? (query) => {
+                const raw = query.state.data;
+                if (!raw)
+                    return false;
+                const { data: rows } = processResponse(raw, responseMapping);
+                return refetchInterval(rows);
+            }
+            : refetchInterval,
     });
     // ── Process server response ──────────────────────────────────────
     const { serverData, serverTotal } = useMemo(() => {

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.340",
+  "version": "0.8.341",
   "publishConfig": {
     "access": "public",
     "provenance": false