@asteby/metacore-runtime-react 49.4.0 → 49.5.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @asteby/metacore-runtime-react
 
+## 49.5.0
+
+### Minor Changes
+
+- 2fca21f: `ApiProvider` acepta `batch={false}` para no agrupar lecturas en `POST /q`: un host cuyo backend no implementa `/q` ya no paga un POST fallido por cada lectura. Además, con el batch activo, si `/q` responde 404/405 el cliente deja de intentarlo tras el primer fallo y la lectura se resuelve por el GET normal. El comportamiento por defecto no cambia para hosts que sí tienen `/q`.
+- 2575411: DynamicTable: nueva primitiva de acciones masivas. `extraBulkActions` (nodo o función `({ selectedRows, selectedIds, clearSelection, refresh }) => nodo`) pinta las acciones del host en la barra flotante de selección, junto al "Eliminar" integrado; `hideBulkDelete` oculta ese "Eliminar". La selección ahora se indexa por `id` del registro (antes por posición en la página) y, con paginación clásica, se vacía al cambiar de página, tamaño, orden, búsqueda o filtros de columna, de modo que una acción masiva nunca actúa sobre filas que el usuario ya no ve.
+- e030a86: DynamicTable: un fallo del endpoint de lista que no es 403 (500, red o `success: false`) ya no se ve como "No se encontraron resultados": muestra "No se pudieron cargar los datos" con un botón "Reintentar" que vuelve a pedir la lista (claves `dynamic.load_error_title`, `dynamic.load_error_hint`, `dynamic.retry`). Nueva prop opcional `emptyState` para mostrar contenido de primer uso cuando la lista carga bien, está vacía y no hay búsqueda ni filtros activos; nunca tapa un error ni un 403.
+
 ## 49.4.0
 
 ### Minor Changes

package/dist/api-context.d.ts

@@ -20,9 +20,17 @@ export interface ApiClient {
 }
 export interface ApiProviderProps {
     client: ApiClient;
+    /**
+     * Groups list, metadata and options reads into one `POST /q`. Defaults to
+     * `true`. Pass `false` when the host backend does not implement `/q`: every
+     * read then goes straight to its own GET and no POST is attempted. When
+     * left on and `/q` answers 404/405, the batch turns itself off for that
+     * client after the first failed attempt and the read falls back to GET.
+     */
+    batch?: boolean;
     children: React.ReactNode;
 }
-export declare function ApiProvider({ client, children }: ApiProviderProps): React.JSX.Element;
+export declare function ApiProvider({ client, batch, children }: ApiProviderProps): React.JSX.Element;
 /** Returns the host-injected api client. Throws if no <ApiProvider> is mounted. */
 export declare function useApi(): ApiClient;
 /** Optional branch context — hosts that support tenant branches can supply

package/dist/api-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-context.d.ts","sourceRoot":"","sources":["../src/api-context.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAwD,MAAM,OAAO,CAAA;AAI5E,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACtB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAA;IACzE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAA;IACtF,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAA;IACrF,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAA;CAC/E;AAID,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,SAAS,CAAA;IACjB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC5B;AAED,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,gBAAgB,qBAuBjE;AAmCD,mFAAmF;AACnF,wBAAgB,MAAM,IAAI,SAAS,CAkBlC;AAED;;wEAEwE;AACxE,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CACzC;AAID,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,WAAW,CAAA;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC5B;AAED,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,mBAAmB,qBAEvE;AAED,wBAAgB,gBAAgB,IAAI,WAAW,CAE9C"}
+{"version":3,"file":"api-context.d.ts","sourceRoot":"","sources":["../src/api-context.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAwD,MAAM,OAAO,CAAA;AAI5E,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACtB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAA;IACzE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAA;IACtF,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAA;IACrF,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAA;CAC/E;AAKD,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,SAAS,CAAA;IACjB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC5B;AAED,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,KAAY,EAAE,QAAQ,EAAE,EAAE,gBAAgB,qBA2B/E;AAmCD,mFAAmF;AACnF,wBAAgB,MAAM,IAAI,SAAS,CAoBlC;AAED;;wEAEwE;AACxE,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CACzC;AAID,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,WAAW,CAAA;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC5B;AAED,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,mBAAmB,qBAEvE;AAED,wBAAgB,gBAAgB,IAAI,WAAW,CAE9C"}

package/dist/api-context.js

@@ -7,7 +7,8 @@ import { createContext, useContext, useEffect, useMemo } from 'react';
 import { batchGet, invalidateQueryBatchData } from './query-batch';
 import { invalidateOptionsCache } from './use-options-resolver';
 const ApiContext = createContext(null);
-export function ApiProvider({ client, children }) {
+const BatchContext = createContext(true);
+export function ApiProvider({ client, batch = true, children }) {
     // Hosts also write through their own client (native dialogs, settings
     // screens) without going through useApi(). When the client is axios,
     // every non-GET response drops what the runtime remembered as well.
@@ -28,7 +29,7 @@ export function ApiProvider({ client, children }) {
         });
         return () => interceptors.eject?.(id);
     }, [client]);
-    return _jsx(ApiContext.Provider, { value: client, children: children });
+    return (_jsx(ApiContext.Provider, { value: client, children: _jsx(BatchContext.Provider, { value: batch, children: children }) }));
 }
 // POSTs that do not change any record a list or picker shows: the read batch
 // (/q) and the bell inbox the host writes on every control toast
@@ -54,6 +55,7 @@ function mutating(request) {
 /** Returns the host-injected api client. Throws if no <ApiProvider> is mounted. */
 export function useApi() {
     const ctx = useContext(ApiContext);
+    const batch = useContext(BatchContext);
     if (!ctx) {
         throw new Error('useApi() requires an <ApiProvider> ancestor. Hosts must inject an axios-like client via runtime-react ApiProvider.');
     }
@@ -64,11 +66,11 @@ export function useApi() {
     return useMemo(() => ({
         // Each call reaches the host client with the arguments it was given —
         // never a trailing `undefined` it didn't ask for.
-        get: (...args) => batchGet(ctx, ...args),
+        get: (...args) => batch ? batchGet(ctx, ...args) : ctx.get(...args),
         post: (...args) => isWrite('post', args[0]) ? mutating(ctx.post(...args)) : ctx.post(...args),
         put: (...args) => mutating(ctx.put(...args)),
         delete: (...args) => mutating(ctx.delete(...args)),
-    }), [ctx]);
+    }), [ctx, batch]);
 }
 const BranchContext = createContext({ id: undefined });
 export function BranchProvider({ branch, children }) {

package/dist/dynamic-table.d.ts

@@ -1,3 +1,4 @@
+import { type ReactNode } from 'react';
 import { type ColumnDef } from '@tanstack/react-table';
 import type { GetDynamicColumns } from './dynamic-columns-shim';
 export interface DynamicTableProps {
@@ -90,6 +91,35 @@ export interface DynamicTableProps {
      * render every row. A positive number overrides the threshold.
      */
     virtualizeRows?: boolean | number;
+    /**
+     * Host-provided actions rendered in the floating bar that appears while
+     * rows are selected, next to the built-in "Eliminar". Pass a node, or a
+     * function that receives the current selection:
+     *   - `selectedRows`: the selected row objects (current page only);
+     *   - `selectedIds`: their `id`s;
+     *   - `clearSelection()`: unselect everything (call after a successful action);
+     *   - `refresh()`: reload the list.
+     * The selection is cleared whenever the page, page size, sort, search or
+     * column filters change (classic pagination), so a bulk action can never
+     * hit rows the user no longer sees. The host owns the write call and its
+     * authorization — the table only supplies the selection.
+     */
+    extraBulkActions?: ReactNode | ((ctx: DynamicTableBulkContext) => ReactNode);
+    /** Hide the built-in bulk "Eliminar" (e.g. a model whose rows must not be deleted in batch). */
+    hideBulkDelete?: boolean;
+    /**
+     * First-use content shown instead of "No se encontraron resultados" when the
+     * list loaded fine, is empty, and no search/filter is active. Never shown
+     * after a load error (a retry is offered) or a 403.
+     */
+    emptyState?: ReactNode;
+}
+/** Context handed to `DynamicTableProps.extraBulkActions` when it is a function. */
+export interface DynamicTableBulkContext {
+    selectedRows: any[];
+    selectedIds: Array<string | number>;
+    clearSelection: () => void;
+    refresh: () => void;
 }
-export declare function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync, hideImport, hideExport, hiddenColumns, allowedActionKeys, onAction, onRowClick, refreshTrigger, defaultFilters, extraColumns, getDynamicColumns, timeZone: timeZoneProp, currency: currencyProp, pagination: paginationMode, infiniteScroll: infiniteScrollProp, virtualizeRows, }: DynamicTableProps): import("react").JSX.Element;
+export declare function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync, hideImport, hideExport, hiddenColumns, allowedActionKeys, onAction, onRowClick, refreshTrigger, defaultFilters, extraColumns, getDynamicColumns, timeZone: timeZoneProp, currency: currencyProp, pagination: paginationMode, infiniteScroll: infiniteScrollProp, virtualizeRows, extraBulkActions, hideBulkDelete, emptyState, }: DynamicTableProps): import("react").JSX.Element;
 //# sourceMappingURL=dynamic-table.d.ts.map

package/dist/dynamic-table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-table.d.ts","sourceRoot":"","sources":["../src/dynamic-table.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAKH,KAAK,SAAS,EAajB,MAAM,uBAAuB,CAAA;AAmC9B,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAyGnF,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;IAC7C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;IAC/B,cAAc,CAAC,EAAE,GAAG,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACpC,YAAY,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAA;IAC/B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IACjC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CACpC;AAQD,wBAAgB,YAAY,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,gBAAgB,EAChB,aAAoB,EACpB,UAAU,EACV,UAAU,EACV,aAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACV,cAAc,EACd,cAAc,EACd,YAAiB,EACjB,iBAA4C,EAC5C,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,cAAc,EAC1B,cAAc,EAAE,kBAA0B,EAC1C,cAAc,GACjB,EAAE,iBAAiB,+BA2kDnB"}
+{"version":3,"file":"dynamic-table.d.ts","sourceRoot":"","sources":["../src/dynamic-table.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAsE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAM1G,OAAO,EAKH,KAAK,SAAS,EAajB,MAAM,uBAAuB,CAAA;AAmC9B,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAyGnF,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;IAC7C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;IAC/B,cAAc,CAAC,EAAE,GAAG,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACpC,YAAY,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAA;IAC/B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IACjC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACjC;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,EAAE,uBAAuB,KAAK,SAAS,CAAC,CAAA;IAC5E,gGAAgG;IAChG,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;CACzB;AAED,oFAAoF;AACpF,MAAM,WAAW,uBAAuB;IACpC,YAAY,EAAE,GAAG,EAAE,CAAA;IACnB,WAAW,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAA;IACnC,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAA;CACtB;AAQD,wBAAgB,YAAY,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,gBAAgB,EAChB,aAAoB,EACpB,UAAU,EACV,UAAU,EACV,aAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACV,cAAc,EACd,cAAc,EACd,YAAiB,EACjB,iBAA4C,EAC5C,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,cAAc,EAC1B,cAAc,EAAE,kBAA0B,EAC1C,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,UAAU,GACb,EAAE,iBAAiB,+BAioDnB"}

package/dist/dynamic-table.js

@@ -118,7 +118,7 @@ function isForbiddenError(error) {
     const e = error;
     return e?.response?.status === 403 || e?.status === 403;
 }
-export function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync = true, hideImport, hideExport, hiddenColumns = [], allowedActionKeys, onAction, onRowClick, refreshTrigger, defaultFilters, extraColumns = [], getDynamicColumns = defaultGetDynamicColumns, timeZone: timeZoneProp, currency: currencyProp, pagination: paginationMode, infiniteScroll: infiniteScrollProp = false, virtualizeRows, }) {
+export function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync = true, hideImport, hideExport, hiddenColumns = [], allowedActionKeys, onAction, onRowClick, refreshTrigger, defaultFilters, extraColumns = [], getDynamicColumns = defaultGetDynamicColumns, timeZone: timeZoneProp, currency: currencyProp, pagination: paginationMode, infiniteScroll: infiniteScrollProp = false, virtualizeRows, extraBulkActions, hideBulkDelete, emptyState, }) {
     // The org's timezone/currency: an explicit prop wins, else the app-wide
     // OrgRuntimeProvider (without it, money fell back to USD).
     const orgTimeZone = useTimeZone();
@@ -165,6 +165,9 @@ export function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync
     // model. Rendered as "no permission" instead of masquerading as an empty
     // list. Purely display state — never a fetch dependency (no refetch loop).
     const [forbidden, setForbidden] = useState(false);
+    // A list request that failed for a reason other than 403 (500, network,
+    // `success: false`). Shown with a retry instead of a misleading "no results".
+    const [loadError, setLoadError] = useState(false);
     const infPageRef = useRef(1);
     const [optionsMap, setOptionsMap] = useState(new Map());
     const [exportOpen, setExportOpen] = useState(false);
@@ -744,6 +747,7 @@ export function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync
                 params.include = relationInclude;
             const res = await api.get(endpoint || `/data/${model}`, { params });
             setForbidden(false);
+            setLoadError(!res.data.success);
             if (res.data.success) {
                 const rows = res.data.data || [];
                 setData(rows);
@@ -759,11 +763,13 @@ export function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync
         catch (error) {
             if (isForbiddenError(error)) {
                 setForbidden(true);
+                setLoadError(false);
                 setData([]);
                 setRowCount(0);
             }
             else {
                 console.error('Error al cargar los datos', error);
+                setLoadError(true);
             }
         }
         finally {
@@ -813,6 +819,7 @@ export function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync
                 params,
             }));
             setForbidden(false);
+            setLoadError(!res.data.success);
             if (res.data.success) {
                 const rows = res.data.data || [];
                 setData((prev) => (append ? dedupeById(prev, rows) : rows));
@@ -832,6 +839,7 @@ export function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync
         catch (error) {
             if (isForbiddenError(error)) {
                 setForbidden(true);
+                setLoadError(false);
                 if (!append) {
                     setData([]);
                     setRowCount(0);
@@ -840,6 +848,7 @@ export function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync
             }
             else {
                 console.error('Error al cargar los datos', error);
+                setLoadError(true);
             }
         }
         finally {
@@ -1237,6 +1246,10 @@ export function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync
         manualSorting: true,
         manualFiltering: true,
         enableRowSelection: true,
+        // Key the selection by record id, not by position in the page: a bulk
+        // action must act on the rows the user ticked, never on whatever row
+        // lands at the same index after the data changes.
+        getRowId: (row, index) => (row?.id != null ? String(row.id) : String(index)),
         onRowSelectionChange: setRowSelection,
         onSortingChange: setSorting,
         onColumnVisibilityChange: setColumnVisibility,
@@ -1251,6 +1264,19 @@ export function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync
         getFacetedUniqueValues: getFacetedUniqueValues(),
     });
     const tableRows = table.getRowModel().rows;
+    const bulkSelectedRows = table.getFilteredSelectedRowModel().rows.map((r) => r.original);
+    // Classic pagination swaps the visible rows on every page / sort / search /
+    // filter change; drop the selection so it never refers to rows that are no
+    // longer on screen. Infinite mode accumulates rows (selection is id-keyed,
+    // so it stays valid) and is left alone.
+    const selectionScope = infiniteScroll ? '' : JSON.stringify([pagination.pageIndex, pagination.pageSize, sorting, columnFilters, globalFilter]);
+    const prevSelectionScope = useRef(selectionScope);
+    useEffect(() => {
+        if (prevSelectionScope.current !== selectionScope) {
+            prevSelectionScope.current = selectionScope;
+            setRowSelection({});
+        }
+    }, [selectionScope]);
     const virtualizeThreshold = resolveVirtualizeThreshold(virtualizeRows);
     const shouldVirtualize = virtualizeThreshold !== false && tableRows.length >= virtualizeThreshold;
     const colSpan = Math.max(columns.length, 1);
@@ -1302,7 +1328,7 @@ export function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync
                                                             const isActionsColumn = cell.column.id === 'actions';
                                                             const isSelectColumn = cell.column.id === 'select';
                                                             return (_jsx(TableCell, { style: cell.column.columnDef.size ? { width: cell.column.columnDef.size } : undefined, className: cn('py-2', isActionsColumn && 'sticky right-0 bg-card shadow-[-2px_0_5px_-2px_rgba(0,0,0,0.1)]'), onClick: (isActionsColumn || isSelectColumn) ? (e) => e.stopPropagation() : undefined, children: flexRender(cell.column.columnDef.cell, cell.getContext()) }, cell.id));
-                                                        }) }, row.id)))), aggregateColumns.length > 0 && Object.keys(footerTotals).length > 0 && (_jsx(TableRow, { className: 'border-0 hover:bg-transparent', children: _jsx(TableCell, { colSpan: columns.length, className: 'h-full p-0' }) }))] })) : (_jsx(TableRow, { className: 'border-b-0 hover:bg-transparent', children: _jsx(TableCell, { colSpan: columns.length, className: 'h-full p-0', children: _jsxs("div", { className: "flex h-full py-12 flex-col items-center justify-center gap-2 text-muted-foreground", children: [_jsx("div", { className: "flex h-20 w-20 items-center justify-center rounded-full bg-muted/50", children: _jsx(Inbox, { className: "h-10 w-10" }) }), _jsx("div", { className: "flex flex-col items-center gap-1", children: forbidden ? (_jsxs(_Fragment, { children: [_jsx("h3", { className: "text-lg font-semibold text-foreground", role: "alert", children: t('dynamic.forbidden_title', { defaultValue: 'Sin permiso para ver este módulo' }) }), _jsx("p", { className: "text-sm text-muted-foreground", children: t('dynamic.forbidden_hint', { defaultValue: 'Tu rol no tiene acceso de lectura a estos datos. Pide acceso a un administrador.' }) })] })) : (_jsxs(_Fragment, { children: [_jsx("h3", { className: "text-lg font-semibold text-foreground", children: "No se encontraron resultados" }), _jsx("p", { className: "text-sm text-muted-foreground", children: "No hay datos para mostrar en este momento." })] })) })] }) }) })) }), aggregateColumns.length > 0 && Object.keys(footerTotals).length > 0 && (_jsx(TableFooter, { className: "bg-transparent", children: _jsx(TableRow, { className: "hover:bg-transparent", children: table.getVisibleLeafColumns().map((leaf, idx) => {
+                                                        }) }, row.id)))), aggregateColumns.length > 0 && Object.keys(footerTotals).length > 0 && (_jsx(TableRow, { className: 'border-0 hover:bg-transparent', children: _jsx(TableCell, { colSpan: columns.length, className: 'h-full p-0' }) }))] })) : (_jsx(TableRow, { className: 'border-b-0 hover:bg-transparent', children: _jsx(TableCell, { colSpan: columns.length, className: 'h-full p-0', children: _jsxs("div", { className: "flex h-full py-12 flex-col items-center justify-center gap-2 text-muted-foreground", children: [_jsx("div", { className: "flex h-20 w-20 items-center justify-center rounded-full bg-muted/50", children: _jsx(Inbox, { className: "h-10 w-10" }) }), _jsx("div", { className: "flex flex-col items-center gap-1", children: forbidden ? (_jsxs(_Fragment, { children: [_jsx("h3", { className: "text-lg font-semibold text-foreground", role: "alert", children: t('dynamic.forbidden_title', { defaultValue: 'Sin permiso para ver este módulo' }) }), _jsx("p", { className: "text-sm text-muted-foreground", children: t('dynamic.forbidden_hint', { defaultValue: 'Tu rol no tiene acceso de lectura a estos datos. Pide acceso a un administrador.' }) })] })) : loadError ? (_jsxs(_Fragment, { children: [_jsx("h3", { className: "text-lg font-semibold text-foreground", role: "alert", children: t('dynamic.load_error_title', { defaultValue: 'No se pudieron cargar los datos' }) }), _jsx("p", { className: "text-sm text-muted-foreground", children: t('dynamic.load_error_hint', { defaultValue: 'Ocurrió un error al consultar la lista. Inténtalo de nuevo.' }) }), _jsx(Button, { variant: "outline", size: "sm", className: "mt-2", onClick: handleRefresh, children: t('dynamic.retry', { defaultValue: 'Reintentar' }) })] })) : emptyState && !hasActiveFilters ? (emptyState) : (_jsxs(_Fragment, { children: [_jsx("h3", { className: "text-lg font-semibold text-foreground", children: "No se encontraron resultados" }), _jsx("p", { className: "text-sm text-muted-foreground", children: "No hay datos para mostrar en este momento." })] })) })] }) }) })) }), aggregateColumns.length > 0 && Object.keys(footerTotals).length > 0 && (_jsx(TableFooter, { className: "bg-transparent", children: _jsx(TableRow, { className: "hover:bg-transparent", children: table.getVisibleLeafColumns().map((leaf, idx) => {
                                                     const col = (metadata?.columns ?? []).find((c) => c.key === leaf.id);
                                                     const isFirst = idx === 0;
                                                     const stickyBase = 'sticky bottom-0 z-10 border-t bg-background py-2 font-semibold';
@@ -1342,9 +1368,16 @@ export function DynamicTable({ model, endpoint, mutationEndpoint, enableUrlSync
                                                     (typeof header === 'string' ? header : cell.column.id);
                                                 return (_jsxs("div", { className: 'flex items-start justify-between gap-3 text-sm', children: [_jsx("span", { className: 'shrink-0 text-muted-foreground', children: label }), _jsx("span", { className: 'min-w-0 overflow-hidden break-words text-right font-medium [&_[data-slot=badge]]:max-w-full [&_[data-slot=badge]]:whitespace-normal [&_[data-slot=badge]]:text-start', children: flexRender(cell.column.columnDef.cell, cell.getContext()) })] }, cell.id));
                                             }), actionsCell && (_jsx("div", { className: 'flex justify-end border-t pt-2', onClick: onRowClick ? (e) => e.stopPropagation() : undefined, children: flexRender(actionsCell.column.columnDef.cell, actionsCell.getContext()) }))] }, row.id));
-                                }))) : (_jsxs("div", { className: 'flex flex-col items-center justify-center gap-2 rounded-lg border bg-card py-12 text-muted-foreground', children: [_jsx("div", { className: 'flex h-16 w-16 items-center justify-center rounded-full bg-muted/50', children: _jsx(Inbox, { className: 'h-8 w-8' }) }), forbidden ? (_jsxs(_Fragment, { children: [_jsx("h3", { className: 'text-base font-semibold text-foreground', role: 'alert', children: t('dynamic.forbidden_title', { defaultValue: 'Sin permiso para ver este módulo' }) }), _jsx("p", { className: 'text-sm text-muted-foreground', children: t('dynamic.forbidden_hint', { defaultValue: 'Tu rol no tiene acceso de lectura a estos datos. Pide acceso a un administrador.' }) })] })) : (_jsxs(_Fragment, { children: [_jsx("h3", { className: 'text-base font-semibold text-foreground', children: "No se encontraron resultados" }), _jsx("p", { className: 'text-sm text-muted-foreground', children: "No hay datos para mostrar en este momento." })] }))] })), infiniteScroll && (_jsxs(_Fragment, { children: [loadingMore && (_jsx(Skeleton, { className: 'h-16 w-full shrink-0', "data-testid": 'table-loading-more-mobile' })), _jsx("div", { ref: infMobileSentinel, className: 'h-1 w-full shrink-0', "aria-hidden": true })] }))] }), _jsx("div", { className: 'shrink-0 pt-4', children: infiniteScroll ? (data.length > 0 && (_jsx("p", { className: 'text-center text-xs text-muted-foreground tabular-nums', children: t('common.showingCount', {
+                                }))) : (_jsxs("div", { className: 'flex flex-col items-center justify-center gap-2 rounded-lg border bg-card py-12 text-muted-foreground', children: [_jsx("div", { className: 'flex h-16 w-16 items-center justify-center rounded-full bg-muted/50', children: _jsx(Inbox, { className: 'h-8 w-8' }) }), forbidden ? (_jsxs(_Fragment, { children: [_jsx("h3", { className: 'text-base font-semibold text-foreground', role: 'alert', children: t('dynamic.forbidden_title', { defaultValue: 'Sin permiso para ver este módulo' }) }), _jsx("p", { className: 'text-sm text-muted-foreground', children: t('dynamic.forbidden_hint', { defaultValue: 'Tu rol no tiene acceso de lectura a estos datos. Pide acceso a un administrador.' }) })] })) : loadError ? (_jsxs(_Fragment, { children: [_jsx("h3", { className: 'text-base font-semibold text-foreground', role: 'alert', children: t('dynamic.load_error_title', { defaultValue: 'No se pudieron cargar los datos' }) }), _jsx("p", { className: 'text-sm text-muted-foreground', children: t('dynamic.load_error_hint', { defaultValue: 'Ocurrió un error al consultar la lista. Inténtalo de nuevo.' }) }), _jsx(Button, { variant: 'outline', size: 'sm', onClick: handleRefresh, children: t('dynamic.retry', { defaultValue: 'Reintentar' }) })] })) : emptyState && !hasActiveFilters ? (emptyState) : (_jsxs(_Fragment, { children: [_jsx("h3", { className: 'text-base font-semibold text-foreground', children: "No se encontraron resultados" }), _jsx("p", { className: 'text-sm text-muted-foreground', children: "No hay datos para mostrar en este momento." })] }))] })), infiniteScroll && (_jsxs(_Fragment, { children: [loadingMore && (_jsx(Skeleton, { className: 'h-16 w-full shrink-0', "data-testid": 'table-loading-more-mobile' })), _jsx("div", { ref: infMobileSentinel, className: 'h-1 w-full shrink-0', "aria-hidden": true })] }))] }), _jsx("div", { className: 'shrink-0 pt-4', children: infiniteScroll ? (data.length > 0 && (_jsx("p", { className: 'text-center text-xs text-muted-foreground tabular-nums', children: t('common.showingCount', {
                                     defaultValue: '{{count}} de {{total}}',
                                     count: data.length,
                                     total: rowCount,
-                                }) }))) : (_jsx(DataTablePagination, { table: table, pageSizeOptions: metadata.perPageOptions })) })] }), rowActionDialogs, _jsx(AlertDialog, { open: showBulkDeleteConfirm, onOpenChange: (open) => !open && !isBulkDeleting && setShowBulkDeleteConfirm(false), children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsx(AlertDialogTitle, { children: isBulkDeleting ? 'Eliminando registros...' : '¿Eliminar múltiples registros?' }), _jsx(AlertDialogDescription, { children: isBulkDeleting ? (_jsxs("div", { className: "space-y-4 mt-4", children: [_jsx(Progress, { value: (bulkDeleteProgress / bulkDeleteTotal) * 100 }), _jsxs("p", { className: "text-center text-sm", children: ["Procesando ", bulkDeleteProgress, " de ", bulkDeleteTotal, " registros..."] })] })) : (_jsxs(_Fragment, { children: ["Esta acci\u00F3n no se puede deshacer. Se eliminar\u00E1n permanentemente ", _jsx("strong", { children: Object.keys(rowSelection).length }), " registro(s) de nuestros servidores."] })) })] }), !isBulkDeleting && (_jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { children: t('common.cancel') }), _jsx(AlertDialogAction, { onClick: (e) => { e.preventDefault(); confirmBulkDelete(); }, className: "bg-red-600 hover:bg-red-700", children: "Eliminar todos" })] }))] }) }), bulkReasonPrompt.dialog, exportEnabled && (_jsx(ExportDialog, { open: exportOpen, onOpenChange: setExportOpen, model: model, metadata: metadata, currentFilters: buildFilterParams(), hasActiveFilters: hasActiveFilters })), importEnabled && (_jsx(ImportDialog, { open: importOpen, onOpenChange: setImportOpen, model: model, metadata: metadata, onImported: handleRefresh })), _jsx(DataTableBulkActions, { table: table, entityName: "registro", children: _jsxs(Button, { variant: "destructive", size: "sm", className: "h-8", onClick: () => setShowBulkDeleteConfirm(true), children: [_jsx(Trash2, { className: "h-4 w-4 mr-1.5" }), " Eliminar"] }) })] }) }));
+                                }) }))) : (_jsx(DataTablePagination, { table: table, pageSizeOptions: metadata.perPageOptions })) })] }), rowActionDialogs, _jsx(AlertDialog, { open: showBulkDeleteConfirm, onOpenChange: (open) => !open && !isBulkDeleting && setShowBulkDeleteConfirm(false), children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsx(AlertDialogTitle, { children: isBulkDeleting ? 'Eliminando registros...' : '¿Eliminar múltiples registros?' }), _jsx(AlertDialogDescription, { children: isBulkDeleting ? (_jsxs("div", { className: "space-y-4 mt-4", children: [_jsx(Progress, { value: (bulkDeleteProgress / bulkDeleteTotal) * 100 }), _jsxs("p", { className: "text-center text-sm", children: ["Procesando ", bulkDeleteProgress, " de ", bulkDeleteTotal, " registros..."] })] })) : (_jsxs(_Fragment, { children: ["Esta acci\u00F3n no se puede deshacer. Se eliminar\u00E1n permanentemente ", _jsx("strong", { children: Object.keys(rowSelection).length }), " registro(s) de nuestros servidores."] })) })] }), !isBulkDeleting && (_jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { children: t('common.cancel') }), _jsx(AlertDialogAction, { onClick: (e) => { e.preventDefault(); confirmBulkDelete(); }, className: "bg-red-600 hover:bg-red-700", children: "Eliminar todos" })] }))] }) }), bulkReasonPrompt.dialog, exportEnabled && (_jsx(ExportDialog, { open: exportOpen, onOpenChange: setExportOpen, model: model, metadata: metadata, currentFilters: buildFilterParams(), hasActiveFilters: hasActiveFilters })), importEnabled && (_jsx(ImportDialog, { open: importOpen, onOpenChange: setImportOpen, model: model, metadata: metadata, onImported: handleRefresh })), _jsxs(DataTableBulkActions, { table: table, entityName: "registro", children: [typeof extraBulkActions === 'function'
+                            ? extraBulkActions({
+                                selectedRows: bulkSelectedRows,
+                                selectedIds: bulkSelectedRows.map((r) => r.id).filter((id) => id != null),
+                                clearSelection: () => table.resetRowSelection(),
+                                refresh: handleRefresh,
+                            })
+                            : extraBulkActions, !hideBulkDelete && (_jsxs(Button, { variant: "destructive", size: "sm", className: "h-8", onClick: () => setShowBulkDeleteConfirm(true), children: [_jsx(Trash2, { className: "h-4 w-4 mr-1.5" }), " Eliminar"] }))] })] }) }));
 }

package/dist/query-batch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-batch.d.ts","sourceRoot":"","sources":["../src/query-batch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,WAAW,SAAS;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,OAAO,CAAA;CACzB;AAyCD,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAuB9D;AAkBD,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,UAAU,GAAG,IAAI,CAsBhF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,OAAO,EACb,GAAG,SAAa,GACjB,IAAI,CAkBN;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAM3C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C;AAsBD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG9D;AAED,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,CAOR;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAYjG;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAsB/E;AAmED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CA2BxF;AAMD;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;;;GA2BxG"}
+{"version":3,"file":"query-batch.d.ts","sourceRoot":"","sources":["../src/query-batch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,WAAW,SAAS;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,OAAO,CAAA;CACzB;AAyCD,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAuB9D;AAkBD,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,UAAU,GAAG,IAAI,CAsBhF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,OAAO,EACb,GAAG,SAAa,GACjB,IAAI,CAkBN;AAaD,wBAAgB,oBAAoB,IAAI,IAAI,CAO3C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C;AAsBD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG9D;AAED,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,CAOR;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAYjG;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAsB/E;AAwED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CA2BxF;AAMD;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;;;GA2BxG"}

package/dist/query-batch.js

@@ -122,7 +122,17 @@ export function rememberInRows(token, ids, rows, now = Date.now()) {
         entityCache.set(entityKey(scope, parsed.shape, id), { rows: bucket, at: now });
     }
 }
+/**
+ * Clients whose backend has no `/q` (it answered 404/405). They get plain GETs
+ * for the rest of the session instead of one failed POST per read.
+ */
+let unsupportedClients = new WeakSet();
+function errorStatus(err) {
+    const e = err;
+    return e?.status ?? e?.response?.status;
+}
 export function resetQueryBatchCache() {
+    unsupportedClients = new WeakSet();
     partCache.clear();
     entityCache.clear();
     waiters = [];
@@ -272,6 +282,12 @@ async function flushQueryBatch() {
         }
     }
     catch (err) {
+        // The host has no /q route: remember it so later reads skip the POST.
+        // Every waiter of this window still rejects and batchGet answers it
+        // with the plain GET, so no read is lost.
+        const status = errorStatus(err);
+        if (status === 404 || status === 405)
+            unsupportedClients.add(api);
         const error = err instanceof Error ? err : new Error(String(err));
         for (const waiter of batch)
             waiter.reject(error);
@@ -330,7 +346,7 @@ export async function batchGet(api, url, config) {
     // trailing `undefined` config reaching the host client.
     const plainGet = () => (config === undefined ? api.get(url) : api.get(url, config));
     const token = tokenForGet(url, config?.params);
-    if (!token)
+    if (!token || unsupportedClients.has(api))
         return plainGet();
     try {
         const part = await loadQueryPart(api, token);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "49.4.0",
+  "version": "49.5.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",

package/src/__tests__/api-batch-opt-out.test.tsx

@@ -0,0 +1,83 @@
+// @vitest-environment happy-dom
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { renderHook } from '@testing-library/react'
+import type { ReactNode } from 'react'
+import { ApiProvider, useApi, type ApiClient } from '../api-context'
+import { resetQueryBatchCache } from '../query-batch'
+
+const rows = { success: true, data: [{ id: 1 }], meta: { total: 1 } }
+
+function makeClient(post: ApiClient['post']) {
+  const get = vi.fn(async () => ({ data: rows }))
+  const client: ApiClient = {
+    get,
+    post,
+    put: vi.fn(async () => ({ data: {} })),
+    delete: vi.fn(async () => ({ data: {} })),
+  }
+  return { client, get }
+}
+
+function render(client: ApiClient, batch?: boolean) {
+  const wrapper = ({ children }: { children: ReactNode }) => (
+    <ApiProvider client={client} batch={batch}>
+      {children}
+    </ApiProvider>
+  )
+  return renderHook(() => useApi(), { wrapper }).result.current
+}
+
+describe('ApiProvider batch', () => {
+  beforeEach(() => resetQueryBatchCache())
+  afterEach(() => resetQueryBatchCache())
+
+  it('groups reads into one POST /q by default', async () => {
+    const post = vi.fn(async () => ({
+      data: { success: true, parts: { q1: { success: true, data: [{ id: 1 }], meta: { total: 1 } } } },
+    }))
+    const { client, get } = makeClient(post)
+    const api = render(client)
+    const res = await api.get('/data/products')
+    expect(post).toHaveBeenCalledTimes(1)
+    expect(post.mock.calls[0][0]).toBe('/q')
+    expect(get).not.toHaveBeenCalled()
+    expect(res.data.data).toEqual([{ id: 1 }])
+  })
+
+  it('does not emit POST /q with batch={false}', async () => {
+    const post = vi.fn(async () => ({ data: {} }))
+    const { client, get } = makeClient(post)
+    const api = render(client, false)
+    const res = await api.get('/data/products')
+    expect(post).not.toHaveBeenCalled()
+    expect(get).toHaveBeenCalledWith('/data/products')
+    expect(res.data).toEqual(rows)
+  })
+
+  it('turns itself off after a 404 and resolves the read through GET', async () => {
+    const post = vi.fn(async () => {
+      throw Object.assign(new Error('Not Found'), { response: { status: 404 } })
+    })
+    const { client, get } = makeClient(post)
+    const api = render(client)
+    const first = await api.get('/data/products')
+    expect(first.data).toEqual(rows)
+    expect(post).toHaveBeenCalledTimes(1)
+    await api.get('/metadata/table/products')
+    await api.get('/data/orders')
+    expect(post).toHaveBeenCalledTimes(1)
+    expect(get).toHaveBeenCalledTimes(3)
+  })
+
+  it('keeps trying /q after a transient 500', async () => {
+    const post = vi.fn(async () => {
+      throw Object.assign(new Error('boom'), { response: { status: 500 } })
+    })
+    const { client, get } = makeClient(post)
+    const api = render(client)
+    await api.get('/data/products')
+    await api.get('/data/orders')
+    expect(post).toHaveBeenCalledTimes(2)
+    expect(get).toHaveBeenCalledTimes(2)
+  })
+})

package/src/__tests__/dynamic-table-bulk-actions.test.tsx

@@ -0,0 +1,140 @@
+// @vitest-environment happy-dom
+//
+// DynamicTable `extraBulkActions` / `hideBulkDelete`:
+//   1. Host actions render in the floating bar once rows are selected and
+//      receive the selected rows / ids.
+//   2. `clearSelection()` empties the selection.
+//   3. Changing page drops the selection (classic pagination) so a bulk
+//      action can never target rows that are no longer visible.
+//   4. `hideBulkDelete` removes the built-in "Eliminar".
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react'
+
+vi.mock('@tanstack/react-router', () => ({
+    useNavigate: () => () => {},
+}))
+const I18N = {
+    t: (_k: string, o?: { defaultValue?: string; count?: number; total?: number }) => {
+        if (o?.defaultValue && o.count != null && o.total != null) {
+            return o.defaultValue.replace('{{count}}', String(o.count)).replace('{{total}}', String(o.total))
+        }
+        return o?.defaultValue ?? _k
+    },
+    i18n: { language: 'es' },
+}
+vi.mock('react-i18next', () => ({ useTranslation: () => I18N }))
+
+import { DynamicTable } from '../dynamic-table'
+import { makeDefaultGetDynamicColumns } from '../dynamic-columns'
+import { ApiProvider, type ApiClient } from '../api-context'
+import { useMetadataCache } from '../metadata-cache'
+import type { TableMetadata } from '../types'
+
+afterEach(cleanup)
+
+const getDynamicColumns = makeDefaultGetDynamicColumns()
+
+function meta(): TableMetadata {
+    return {
+        title: 'Issues',
+        endpoint: '/data/issue',
+        columns: [
+            { key: 'title', label: 'Title', type: 'text', sortable: true, filterable: false, searchable: true },
+        ],
+        actions: [],
+        perPageOptions: [10, 20, 50],
+        defaultPerPage: 10,
+        searchPlaceholder: 'Buscar...',
+        enableCRUDActions: false,
+        hasActions: false,
+    }
+}
+
+function fakeApi(total: number): ApiClient {
+    const ok = (data: unknown) => ({ data: { success: true, data, meta: { total } } })
+    return {
+        get: vi.fn(async (url: string, cfg?: any) => {
+            if (url.startsWith('/metadata/table/')) return ok(meta())
+            if (url.endsWith('/facets')) return ok([])
+            const p = cfg?.params?.page ?? 1
+            const size = cfg?.params?.per_page ?? 10
+            const rows: Array<{ id: number; title: string }> = []
+            for (let i = (p - 1) * size; i < Math.min(p * size, total); i++) rows.push({ id: i + 1, title: `Issue ${i + 1}` })
+            return ok(rows)
+        }),
+        post: vi.fn(async () => ok(null)),
+        put: vi.fn(async () => ok(null)),
+        delete: vi.fn(async () => ok(null)),
+    }
+}
+
+async function selectFirstRow() {
+    await screen.findAllByText('Issue 1')
+    const boxes = screen.getAllByRole('checkbox')
+    fireEvent.click(boxes[1]) // [0] is the select-all header checkbox
+}
+
+describe('DynamicTable extraBulkActions', () => {
+    beforeEach(() => {
+        localStorage.clear()
+        sessionStorage.clear()
+        useMetadataCache.getState().setMetadata('issue', meta())
+    })
+
+    it('renders host actions with the selection and lets them clear it', async () => {
+        const seen: unknown[] = []
+        render(
+            <ApiProvider client={fakeApi(5)}>
+                <DynamicTable
+                    model="issue"
+                    enableUrlSync={false} getDynamicColumns={getDynamicColumns}
+                    extraBulkActions={({ selectedRows, selectedIds, clearSelection }) => (
+                        <button onClick={() => { seen.push({ rows: selectedRows.length, ids: selectedIds }); clearSelection() }}>
+                            Aprobar seleccionados
+                        </button>
+                    )}
+                />
+            </ApiProvider>,
+        )
+        expect(screen.queryByText('Aprobar seleccionados')).toBeNull()
+        await selectFirstRow()
+        fireEvent.click(await screen.findByText('Aprobar seleccionados'))
+        expect(seen).toEqual([{ rows: 1, ids: [1] }])
+        await waitFor(() => expect(screen.queryByText('Aprobar seleccionados')).toBeNull())
+    })
+
+    it('accepts a plain node and keeps the built-in delete by default', async () => {
+        render(
+            <ApiProvider client={fakeApi(5)}>
+                <DynamicTable model="issue" enableUrlSync={false} getDynamicColumns={getDynamicColumns} extraBulkActions={<button>Extra</button>} />
+            </ApiProvider>,
+        )
+        await selectFirstRow()
+        expect(await screen.findByText('Extra')).toBeTruthy()
+        expect(screen.getByText('Eliminar')).toBeTruthy()
+    })
+
+    it('hideBulkDelete removes the built-in delete', async () => {
+        render(
+            <ApiProvider client={fakeApi(5)}>
+                <DynamicTable model="issue" enableUrlSync={false} getDynamicColumns={getDynamicColumns} hideBulkDelete extraBulkActions={<button>Extra</button>} />
+            </ApiProvider>,
+        )
+        await selectFirstRow()
+        expect(await screen.findByText('Extra')).toBeTruthy()
+        expect(screen.queryByText('Eliminar')).toBeNull()
+    })
+
+    it('drops the selection when the page changes', async () => {
+        render(
+            <ApiProvider client={fakeApi(25)}>
+                <DynamicTable model="issue" enableUrlSync={false} getDynamicColumns={getDynamicColumns} extraBulkActions={<button>Extra</button>} />
+            </ApiProvider>,
+        )
+        await selectFirstRow()
+        expect(await screen.findByText('Extra')).toBeTruthy()
+        fireEvent.click(await screen.findByRole('button', { name: /siguiente|next/i }))
+        await screen.findAllByText('Issue 11')
+        await waitFor(() => expect(screen.queryByText('Extra')).toBeNull())
+    })
+})

package/src/__tests__/dynamic-table-load-error.test.tsx

@@ -0,0 +1,97 @@
+// @vitest-environment happy-dom
+//
+// Un fallo del endpoint de lista que NO es 403 (500, red, `success: false`)
+// no debe verse como "sin resultados": se muestra "No se pudieron cargar los
+// datos" con "Reintentar", que vuelve a pedir la lista. `emptyState` solo
+// reemplaza el vacío cuando la lista cargó bien y no hay filtros activos.
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react'
+
+vi.mock('@tanstack/react-router', () => ({ useNavigate: () => () => {} }))
+
+import { ApiProvider, type ApiClient } from '../api-context'
+import { useMetadataCache } from '../metadata-cache'
+import { DynamicTable } from '../dynamic-table'
+import type { TableMetadata } from '../types'
+
+afterEach(cleanup)
+
+const meta = {
+    title: 'Ajustes',
+    endpoint: '/data/load_err',
+    columns: [],
+    actions: [],
+    perPageOptions: [10],
+    defaultPerPage: 10,
+    searchPlaceholder: 'Buscar...',
+    enableCRUDActions: false,
+    hasActions: false,
+} as unknown as TableMetadata
+
+type ListResult = 'error500' | 'successFalse' | 'empty'
+
+function mount(results: ListResult[], model: string, extra: Record<string, unknown> = {}) {
+    useMetadataCache.getState().setMetadata(model, meta)
+    let listCalls = 0
+    const client: ApiClient = {
+        get: vi.fn(async (url: string) => {
+            if (url.startsWith('/metadata/table/')) return { data: { success: true, data: meta } }
+            if (url.endsWith('/facets')) return { data: { success: true, data: [] } }
+            const r = results[Math.min(listCalls, results.length - 1)]
+            listCalls++
+            if (r === 'error500') throw Object.assign(new Error('500'), { response: { status: 500 } })
+            if (r === 'successFalse') return { data: { success: false, message: 'boom' } }
+            return { data: { success: true, data: [], meta: { total: 0 } } }
+        }),
+        post: vi.fn(async () => ({ data: { success: true, data: null } })),
+        put: vi.fn(async () => ({ data: { success: true, data: null } })),
+        delete: vi.fn(async () => ({ data: { success: true, data: null } })),
+    }
+    render(
+        <ApiProvider client={client}>
+            <DynamicTable model={model} enableUrlSync={false} {...extra} />
+        </ApiProvider>,
+    )
+    return () => listCalls
+}
+
+describe('DynamicTable — fallo de la lista (no 403)', () => {
+    it('un 500 muestra error con Reintentar, no "No se encontraron resultados"', async () => {
+        vi.spyOn(console, 'error').mockImplementation(() => {})
+        mount(['error500'], 'lerr_a')
+        expect((await screen.findAllByText('No se pudieron cargar los datos')).length).toBeGreaterThan(0)
+        expect(screen.queryByText('No se encontraron resultados')).toBeNull()
+        expect(screen.queryByText('Sin permiso para ver este módulo')).toBeNull()
+    })
+
+    it('`success: false` también es un error de carga', async () => {
+        mount(['successFalse'], 'lerr_b')
+        expect((await screen.findAllByText('No se pudieron cargar los datos')).length).toBeGreaterThan(0)
+    })
+
+    it('Reintentar vuelve a pedir la lista y, si ahora carga, limpia el error', async () => {
+        vi.spyOn(console, 'error').mockImplementation(() => {})
+        const calls = mount(['error500', 'empty'], 'lerr_c')
+        const retry = (await screen.findAllByRole('button', { name: 'Reintentar' }))[0]
+        const before = calls()
+        fireEvent.click(retry)
+        await waitFor(() => expect(calls()).toBeGreaterThan(before))
+        await waitFor(() => expect(screen.queryByText('No se pudieron cargar los datos')).toBeNull())
+        expect((await screen.findAllByText('No se encontraron resultados')).length).toBeGreaterThan(0)
+    })
+})
+
+describe('DynamicTable — emptyState', () => {
+    it('reemplaza el vacío cuando la lista cargó bien y no hay filtros', async () => {
+        mount(['empty'], 'lerr_d', { emptyState: <p>Aún no hay registros</p> })
+        expect((await screen.findAllByText('Aún no hay registros')).length).toBeGreaterThan(0)
+        expect(screen.queryByText('No se encontraron resultados')).toBeNull()
+    })
+
+    it('no tapa un error de carga', async () => {
+        vi.spyOn(console, 'error').mockImplementation(() => {})
+        mount(['error500'], 'lerr_e', { emptyState: <p>Aún no hay registros</p> })
+        expect((await screen.findAllByText('No se pudieron cargar los datos')).length).toBeGreaterThan(0)
+        expect(screen.queryByText('Aún no hay registros')).toBeNull()
+    })
+})

package/src/api-context.tsx

@@ -15,13 +15,22 @@ export interface ApiClient {
 }
 
 const ApiContext = createContext<ApiClient | null>(null)
+const BatchContext = createContext<boolean>(true)
 
 export interface ApiProviderProps {
     client: ApiClient
+    /**
+     * Groups list, metadata and options reads into one `POST /q`. Defaults to
+     * `true`. Pass `false` when the host backend does not implement `/q`: every
+     * read then goes straight to its own GET and no POST is attempted. When
+     * left on and `/q` answers 404/405, the batch turns itself off for that
+     * client after the first failed attempt and the read falls back to GET.
+     */
+    batch?: boolean
     children: React.ReactNode
 }
 
-export function ApiProvider({ client, children }: ApiProviderProps) {
+export function ApiProvider({ client, batch = true, children }: ApiProviderProps) {
     // Hosts also write through their own client (native dialogs, settings
     // screens) without going through useApi(). When the client is axios,
     // every non-GET response drops what the runtime remembered as well.
@@ -43,7 +52,11 @@ export function ApiProvider({ client, children }: ApiProviderProps) {
         )
         return () => interceptors.eject?.(id)
     }, [client])
-    return <ApiContext.Provider value={client}>{children}</ApiContext.Provider>
+    return (
+        <ApiContext.Provider value={client}>
+            <BatchContext.Provider value={batch}>{children}</BatchContext.Provider>
+        </ApiContext.Provider>
+    )
 }
 
 interface AxiosLike {
@@ -82,6 +95,7 @@ function mutating<T>(request: Promise<T>): Promise<T> {
 /** Returns the host-injected api client. Throws if no <ApiProvider> is mounted. */
 export function useApi(): ApiClient {
     const ctx = useContext(ApiContext)
+    const batch = useContext(BatchContext)
     if (!ctx) {
         throw new Error('useApi() requires an <ApiProvider> ancestor. Hosts must inject an axios-like client via runtime-react ApiProvider.')
     }
@@ -92,12 +106,13 @@ export function useApi(): ApiClient {
     return useMemo<ApiClient>(() => ({
         // Each call reaches the host client with the arguments it was given —
         // never a trailing `undefined` it didn't ask for.
-        get: (...args: Parameters<ApiClient['get']>) => batchGet(ctx, ...args),
+        get: (...args: Parameters<ApiClient['get']>) =>
+            batch ? batchGet(ctx, ...args) : ctx.get(...args),
         post: (...args: Parameters<ApiClient['post']>) =>
             isWrite('post', args[0]) ? mutating(ctx.post(...args)) : ctx.post(...args),
         put: (...args: Parameters<ApiClient['put']>) => mutating(ctx.put(...args)),
         delete: (...args: Parameters<ApiClient['delete']>) => mutating(ctx.delete(...args)),
-    }), [ctx])
+    }), [ctx, batch])
 }
 
 /** Optional branch context — hosts that support tenant branches can supply

package/src/dynamic-table.tsx

@@ -10,7 +10,7 @@
 //   * `@/components/dynamic/dynamic-columns` → host-injected via the
 //     `getDynamicColumns` prop (hosts retain ownership because the rendered
 //     column cells are tightly coupled to their design system).
-import { useEffect, useState, useMemo, useCallback, useRef, type MouseEvent } from 'react'
+import { useEffect, useState, useMemo, useCallback, useRef, type MouseEvent, type ReactNode } from 'react'
 import { useTranslation } from 'react-i18next'
 import { useTimeZone, useCurrency } from './org-runtime-context'
 import { format } from 'date-fns'
@@ -264,6 +264,36 @@ export interface DynamicTableProps {
      * render every row. A positive number overrides the threshold.
      */
     virtualizeRows?: boolean | number
+    /**
+     * Host-provided actions rendered in the floating bar that appears while
+     * rows are selected, next to the built-in "Eliminar". Pass a node, or a
+     * function that receives the current selection:
+     *   - `selectedRows`: the selected row objects (current page only);
+     *   - `selectedIds`: their `id`s;
+     *   - `clearSelection()`: unselect everything (call after a successful action);
+     *   - `refresh()`: reload the list.
+     * The selection is cleared whenever the page, page size, sort, search or
+     * column filters change (classic pagination), so a bulk action can never
+     * hit rows the user no longer sees. The host owns the write call and its
+     * authorization — the table only supplies the selection.
+     */
+    extraBulkActions?: ReactNode | ((ctx: DynamicTableBulkContext) => ReactNode)
+    /** Hide the built-in bulk "Eliminar" (e.g. a model whose rows must not be deleted in batch). */
+    hideBulkDelete?: boolean
+    /**
+     * First-use content shown instead of "No se encontraron resultados" when the
+     * list loaded fine, is empty, and no search/filter is active. Never shown
+     * after a load error (a retry is offered) or a 403.
+     */
+    emptyState?: ReactNode
+}
+
+/** Context handed to `DynamicTableProps.extraBulkActions` when it is a function. */
+export interface DynamicTableBulkContext {
+    selectedRows: any[]
+    selectedIds: Array<string | number>
+    clearSelection: () => void
+    refresh: () => void
 }
 
 /** True when an api-client error is an HTTP 403 (axios-style or fetch-style). */
@@ -292,6 +322,9 @@ export function DynamicTable({
     pagination: paginationMode,
     infiniteScroll: infiniteScrollProp = false,
     virtualizeRows,
+    extraBulkActions,
+    hideBulkDelete,
+    emptyState,
 }: DynamicTableProps) {
     // The org's timezone/currency: an explicit prop wins, else the app-wide
     // OrgRuntimeProvider (without it, money fell back to USD).
@@ -347,6 +380,9 @@ export function DynamicTable({
     // model. Rendered as "no permission" instead of masquerading as an empty
     // list. Purely display state — never a fetch dependency (no refetch loop).
     const [forbidden, setForbidden] = useState(false)
+    // A list request that failed for a reason other than 403 (500, network,
+    // `success: false`). Shown with a retry instead of a misleading "no results".
+    const [loadError, setLoadError] = useState(false)
     const infPageRef = useRef(1)
     const [optionsMap, setOptionsMap] = useState<Map<string, any[]>>(new Map())
 
@@ -897,6 +933,7 @@ export function DynamicTable({
             if (relationInclude) params.include = relationInclude
             const res = await api.get(endpoint || `/data/${model}`, { params }) as { data: ApiResponse<any[]> }
             setForbidden(false)
+            setLoadError(!res.data.success)
             if (res.data.success) {
                 const rows = res.data.data || []
                 setData(rows)
@@ -914,10 +951,12 @@ export function DynamicTable({
         } catch (error) {
             if (isForbiddenError(error)) {
                 setForbidden(true)
+                setLoadError(false)
                 setData([])
                 setRowCount(0)
             } else {
                 console.error('Error al cargar los datos', error)
+                setLoadError(true)
             }
         } finally {
             setLoadingData(false)
@@ -968,6 +1007,7 @@ export function DynamicTable({
                     params,
                 })) as { data: ApiResponse<any[]> }
                 setForbidden(false)
+                setLoadError(!res.data.success)
                 if (res.data.success) {
                     const rows = res.data.data || []
                     setData((prev) => (append ? dedupeById(prev, rows) : rows))
@@ -989,6 +1029,7 @@ export function DynamicTable({
             } catch (error) {
                 if (isForbiddenError(error)) {
                     setForbidden(true)
+                    setLoadError(false)
                     if (!append) {
                         setData([])
                         setRowCount(0)
@@ -996,6 +1037,7 @@ export function DynamicTable({
                     setInfExhausted(true)
                 } else {
                     console.error('Error al cargar los datos', error)
+                    setLoadError(true)
                 }
             } finally {
                 if (append) setLoadingMore(false)
@@ -1372,6 +1414,10 @@ export function DynamicTable({
         manualSorting: true,
         manualFiltering: true,
         enableRowSelection: true,
+        // Key the selection by record id, not by position in the page: a bulk
+        // action must act on the rows the user ticked, never on whatever row
+        // lands at the same index after the data changes.
+        getRowId: (row: any, index: number) => (row?.id != null ? String(row.id) : String(index)),
         onRowSelectionChange: setRowSelection,
         onSortingChange: setSorting,
         onColumnVisibilityChange: setColumnVisibility,
@@ -1387,6 +1433,21 @@ export function DynamicTable({
     })
 
     const tableRows = table.getRowModel().rows
+    const bulkSelectedRows = table.getFilteredSelectedRowModel().rows.map((r) => r.original as any)
+
+    // Classic pagination swaps the visible rows on every page / sort / search /
+    // filter change; drop the selection so it never refers to rows that are no
+    // longer on screen. Infinite mode accumulates rows (selection is id-keyed,
+    // so it stays valid) and is left alone.
+    const selectionScope = infiniteScroll ? '' : JSON.stringify([pagination.pageIndex, pagination.pageSize, sorting, columnFilters, globalFilter])
+    const prevSelectionScope = useRef(selectionScope)
+    useEffect(() => {
+        if (prevSelectionScope.current !== selectionScope) {
+            prevSelectionScope.current = selectionScope
+            setRowSelection({})
+        }
+    }, [selectionScope])
+
     const virtualizeThreshold = resolveVirtualizeThreshold(virtualizeRows)
     const shouldVirtualize =
         virtualizeThreshold !== false && tableRows.length >= virtualizeThreshold
@@ -1624,6 +1685,14 @@ export function DynamicTable({
                                                         <h3 className="text-lg font-semibold text-foreground" role="alert">{t('dynamic.forbidden_title', { defaultValue: 'Sin permiso para ver este módulo' })}</h3>
                                                         <p className="text-sm text-muted-foreground">{t('dynamic.forbidden_hint', { defaultValue: 'Tu rol no tiene acceso de lectura a estos datos. Pide acceso a un administrador.' })}</p>
                                                     </>
+                                                ) : loadError ? (
+                                                    <>
+                                                        <h3 className="text-lg font-semibold text-foreground" role="alert">{t('dynamic.load_error_title', { defaultValue: 'No se pudieron cargar los datos' })}</h3>
+                                                        <p className="text-sm text-muted-foreground">{t('dynamic.load_error_hint', { defaultValue: 'Ocurrió un error al consultar la lista. Inténtalo de nuevo.' })}</p>
+                                                        <Button variant="outline" size="sm" className="mt-2" onClick={handleRefresh}>{t('dynamic.retry', { defaultValue: 'Reintentar' })}</Button>
+                                                    </>
+                                                ) : emptyState && !hasActiveFilters ? (
+                                                    emptyState
                                                 ) : (
                                                     <>
                                                         <h3 className="text-lg font-semibold text-foreground">No se encontraron resultados</h3>
@@ -1823,6 +1892,14 @@ export function DynamicTable({
                                     <h3 className='text-base font-semibold text-foreground' role='alert'>{t('dynamic.forbidden_title', { defaultValue: 'Sin permiso para ver este módulo' })}</h3>
                                     <p className='text-sm text-muted-foreground'>{t('dynamic.forbidden_hint', { defaultValue: 'Tu rol no tiene acceso de lectura a estos datos. Pide acceso a un administrador.' })}</p>
                                 </>
+                            ) : loadError ? (
+                                <>
+                                    <h3 className='text-base font-semibold text-foreground' role='alert'>{t('dynamic.load_error_title', { defaultValue: 'No se pudieron cargar los datos' })}</h3>
+                                    <p className='text-sm text-muted-foreground'>{t('dynamic.load_error_hint', { defaultValue: 'Ocurrió un error al consultar la lista. Inténtalo de nuevo.' })}</p>
+                                    <Button variant='outline' size='sm' onClick={handleRefresh}>{t('dynamic.retry', { defaultValue: 'Reintentar' })}</Button>
+                                </>
+                            ) : emptyState && !hasActiveFilters ? (
+                                emptyState
                             ) : (
                                 <>
                                     <h3 className='text-base font-semibold text-foreground'>No se encontraron resultados</h3>
@@ -1896,9 +1973,19 @@ export function DynamicTable({
                 <ImportDialog open={importOpen} onOpenChange={setImportOpen} model={model} metadata={metadata} onImported={handleRefresh} />
             )}
             <DataTableBulkActions table={table} entityName="registro">
-                <Button variant="destructive" size="sm" className="h-8" onClick={() => setShowBulkDeleteConfirm(true)}>
-                    <Trash2 className="h-4 w-4 mr-1.5" /> Eliminar
-                </Button>
+                {typeof extraBulkActions === 'function'
+                    ? extraBulkActions({
+                        selectedRows: bulkSelectedRows,
+                        selectedIds: bulkSelectedRows.map((r) => r.id).filter((id) => id != null),
+                        clearSelection: () => table.resetRowSelection(),
+                        refresh: handleRefresh,
+                    })
+                    : extraBulkActions}
+                {!hideBulkDelete && (
+                    <Button variant="destructive" size="sm" className="h-8" onClick={() => setShowBulkDeleteConfirm(true)}>
+                        <Trash2 className="h-4 w-4 mr-1.5" /> Eliminar
+                    </Button>
+                )}
             </DataTableBulkActions>
         </OptionsContext.Provider>
         </RowActionsModelContext.Provider>

package/src/query-batch.ts

@@ -170,7 +170,19 @@ export function rememberInRows(
     }
 }
 
+/**
+ * Clients whose backend has no `/q` (it answered 404/405). They get plain GETs
+ * for the rest of the session instead of one failed POST per read.
+ */
+let unsupportedClients = new WeakSet<object>()
+
+function errorStatus(err: unknown): number | undefined {
+    const e = err as { status?: number; response?: { status?: number } } | null
+    return e?.status ?? e?.response?.status
+}
+
 export function resetQueryBatchCache(): void {
+    unsupportedClients = new WeakSet<object>()
     partCache.clear()
     entityCache.clear()
     waiters = []
@@ -320,6 +332,11 @@ async function flushQueryBatch() {
             waiter.resolve(merged)
         }
     } catch (err) {
+        // The host has no /q route: remember it so later reads skip the POST.
+        // Every waiter of this window still rejects and batchGet answers it
+        // with the plain GET, so no read is lost.
+        const status = errorStatus(err)
+        if (status === 404 || status === 405) unsupportedClients.add(api)
         const error = err instanceof Error ? err : new Error(String(err))
         for (const waiter of batch) waiter.reject(error)
     }
@@ -381,7 +398,7 @@ export async function batchGet(api: ApiClient, url: string, config?: { params?:
     // trailing `undefined` config reaching the host client.
     const plainGet = () => (config === undefined ? api.get(url) : api.get(url, config))
     const token = tokenForGet(url, config?.params)
-    if (!token) return plainGet()
+    if (!token || unsupportedClients.has(api)) return plainGet()
     try {
         const part = await loadQueryPart(api, token)
         if (!part.success) {