@asteby/metacore-runtime-react 39.2.8 → 39.2.9

package/dist/query-batch.js

@@ -1,9 +1,30 @@
 const WINDOW_MS = 8;
 const PART_TTL_MS = 30_000;
 const ENTITY_TTL_MS = 30_000;
+/**
+ * Only metadata and i18n are served from memory without asking the server.
+ * Rows (`t:` lists, `r:` records) and options change with every save: they
+ * always travel, and an unchanged payload comes back as `not_modified` when
+ * the server's etag hashes the content.
+ */
+function servedFromMemory(token) {
+    return token.startsWith('m:') || token.startsWith('mm:') || token.startsWith('i:');
+}
+/**
+ * Etags the server derives from the payload itself (`"qh-…"`). The older
+ * `"q-<seed>-<len>"` ones only counted rows or bytes, so a value edited to one
+ * of the same length came back `not_modified` with the old data.
+ */
+function contentEtag(etag) {
+    return !!etag && etag.startsWith('"qh-');
+}
 const partCache = new Map();
 const entityCache = new Map();
-/** A concrete `t:` `in:` list. `@` references stay whole: the ids are not known yet. */
+/**
+ * A concrete `t:` `in:` list. `@` references stay whole: the ids are not known
+ * yet. A paginated list (`page=`) is not split: serving part of it from memory
+ * would change which rows land on the page and the total.
+ */
 export function splitInToken(token) {
     const q = token.indexOf('?');
     if (q < 0 || !token.startsWith('t:'))
@@ -12,6 +33,8 @@ export function splitInToken(token) {
     if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(model))
         return null;
     const params = new URLSearchParams(token.slice(q + 1));
+    if (params.has('page'))
+        return null;
     let field = '';
     let ids = [];
     for (const [key, value] of params.entries()) {
@@ -35,6 +58,10 @@ export function splitInToken(token) {
 function entityKey(scope, shape, id) {
     return `${scope}\n${shape}\n${id}`;
 }
+/** The row column an `in:` filter matches: `f_product_id` filters `product_id`. */
+function rowField(param) {
+    return param.startsWith('f_') ? param.slice(2) : param;
+}
 function replaceInIds(token, field, ids) {
     const q = token.indexOf('?');
     const params = new URLSearchParams(token.slice(q + 1));
@@ -55,8 +82,7 @@ export function narrowInToken(token, now = Date.now()) {
             missingIds.push(id);
             continue;
         }
-        if (hit.row)
-            rows.push(hit.row);
+        rows.push(...hit.rows);
     }
     if (missingIds.length === parsed.ids.length)
         return null;
@@ -68,31 +94,32 @@ export function narrowInToken(token, now = Date.now()) {
         shape: parsed.shape,
     };
 }
-/** Stores one row per requested id. An id with no row is remembered as empty. */
+/**
+ * Stores every row of each requested id (one id can match many rows: the
+ * stock of a product in several warehouses). An id with no row is remembered
+ * as empty.
+ */
 export function rememberInRows(token, ids, rows, now = Date.now()) {
     const parsed = splitInToken(token);
     if (!parsed)
         return;
     const scope = cacheScope();
-    const seen = new Set();
+    const field = rowField(parsed.field);
+    const byId = new Map();
+    for (const id of ids)
+        byId.set(id, []);
     if (Array.isArray(rows)) {
         for (const row of rows) {
             if (!row || typeof row !== 'object')
                 continue;
-            const id = String(row[parsed.field] ?? '').trim();
-            if (!id)
-                continue;
-            seen.add(id);
-            entityCache.set(entityKey(scope, parsed.shape, id), {
-                row: row,
-                at: now,
-            });
+            const id = String(row[field] ?? '').trim();
+            const bucket = byId.get(id);
+            if (bucket)
+                bucket.push(row);
         }
     }
-    for (const id of ids) {
-        if (seen.has(id))
-            continue;
-        entityCache.set(entityKey(scope, parsed.shape, id), { row: null, at: now });
+    for (const [id, bucket] of byId) {
+        entityCache.set(entityKey(scope, parsed.shape, id), { rows: bucket, at: now });
     }
 }
 export function resetQueryBatchCache() {
@@ -103,6 +130,19 @@ export function resetQueryBatchCache() {
         clearTimeout(timer);
     timer = null;
 }
+/**
+ * Forgets every row, record and option read. useApi calls it after each
+ * mutation so the list that just gained, changed or lost a row reads it
+ * again instead of the copy from before the save. Metadata and i18n stay.
+ */
+export function invalidateQueryBatchData() {
+    for (const key of [...partCache.keys()]) {
+        const token = key.slice(key.indexOf('\n') + 1);
+        if (!servedFromMemory(token))
+            partCache.delete(key);
+    }
+    entityCache.clear();
+}
 let waiters = [];
 let timer = null;
 let transport = null;
@@ -157,7 +197,7 @@ export function nameBatchTokens(tokens) {
 }
 export function loadQueryPart(api, token) {
     const cached = partCache.get(`${cacheScope()}\n${token}`);
-    if (cached && Date.now() - cached.at < PART_TTL_MS && cached.part.success) {
+    if (cached && servedFromMemory(token) && Date.now() - cached.at < PART_TTL_MS && cached.part.success) {
         return Promise.resolve(cached.part);
     }
     const narrowed = narrowInToken(token);
@@ -192,8 +232,9 @@ async function flushQueryBatch() {
     const scope = cacheScope();
     for (const part of named) {
         const cached = partCache.get(`${scope}\n${part.token}`);
-        if (cached?.part.etag)
-            inm[part.name] = cached.part.etag;
+        const etag = cached?.part.etag;
+        if (etag && (servedFromMemory(part.token) || contentEtag(etag)))
+            inm[part.name] = etag;
     }
     try {
         const res = await api.post('/q', { parts: named.map((part) => part.plan), inm });
@@ -211,9 +252,14 @@ async function flushQueryBatch() {
             if (part.not_modified) {
                 const cached = partCache.get(`${scope}\n${waiter.token}`);
                 if (cached) {
+                    cached.at = Date.now();
                     waiter.resolve(cached.part);
                     continue;
                 }
+                // Invalidated while the request was in flight: nothing to
+                // reuse, so batchGet falls back to the plain GET.
+                waiter.reject(new Error('batch part not modified but not cached'));
+                continue;
             }
             const merged = mergeCachedRows(waiter.cachedRows, part);
             if (waiter.missingIds && waiter.field) {

package/dist/use-options-resolver.d.ts

@@ -76,6 +76,12 @@ export interface UseOptionsResolverResult {
     /** Forces a refetch. Useful after a parent record updates. */
     refetch: () => void;
 }
+/**
+ * Forgets every cached and in-flight options lookup. Called after any write
+ * (create, edit, delete), so a picker opened right after creating a record
+ * lists it instead of serving the previous 30 s snapshot.
+ */
+export declare function invalidateOptionsCache(): void;
 export declare function optionsRequestKey(scope: string, url: string, field: string, query: string, limit: number | undefined, filter: string | undefined): string;
 export declare function useOptionsResolver(args: UseOptionsResolverArgs): UseOptionsResolverResult;
 /**

package/dist/use-options-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-options-resolver.d.ts","sourceRoot":"","sources":["../src/use-options-resolver.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,cAAc;IAC3B,8CAA8C;IAC9C,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,oEAAoE;IACpE,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;IACnC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,sBAAsB;IACnC;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAA;CACtB;AAoBD,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,CAER;AA8BD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,wBAAwB,CA4JzF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,CAatD"}
+{"version":3,"file":"use-options-resolver.d.ts","sourceRoot":"","sources":["../src/use-options-resolver.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,cAAc;IAC3B,8CAA8C;IAC9C,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,oEAAoE;IACpE,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;IACnC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,sBAAsB;IACnC;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAA;CACtB;AAuBD;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAED,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,CAER;AA8BD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,wBAAwB,CA6JzF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,CAatD"}

package/dist/use-options-resolver.js

@@ -27,6 +27,19 @@ const OPTIONS_TTL_MS = 30_000;
 const optionsCache = new Map();
 const optionsInflight = new Map();
 const optionsEpoch = new Map();
+// Bumped by invalidateOptionsCache: a lookup that started before a write must
+// not store what it read.
+let optionsGeneration = 0;
+/**
+ * Forgets every cached and in-flight options lookup. Called after any write
+ * (create, edit, delete), so a picker opened right after creating a record
+ * lists it instead of serving the previous 30 s snapshot.
+ */
+export function invalidateOptionsCache() {
+    optionsGeneration++;
+    optionsCache.clear();
+    optionsInflight.clear();
+}
 export function optionsRequestKey(scope, url, field, query, limit, filter) {
     return [scope, url, field, query, String(limit ?? ''), filter ?? ''].join('\n');
 }
@@ -108,6 +121,7 @@ export function useOptionsResolver(args) {
             optionsInflight.delete(key);
         }
         const epoch = optionsEpoch.get(key) ?? 0;
+        const generation = optionsGeneration;
         const cached = optionsCache.get(key);
         if (cached && Date.now() - cached.at < OPTIONS_TTL_MS) {
             setOptions(cached.payload.options);
@@ -140,7 +154,7 @@ export function useOptionsResolver(args) {
                             data: part.data,
                             meta: part.meta,
                         });
-                        if ((optionsEpoch.get(key) ?? 0) === epoch) {
+                        if ((optionsEpoch.get(key) ?? 0) === epoch && optionsGeneration === generation) {
                             optionsCache.set(key, { payload, at: Date.now() });
                         }
                         return payload;
@@ -158,7 +172,7 @@ export function useOptionsResolver(args) {
                     throw new Error(body?.message || 'options resolver: unsuccessful response');
                 }
                 const payload = readOptionsEnvelope(body);
-                if ((optionsEpoch.get(key) ?? 0) === epoch) {
+                if ((optionsEpoch.get(key) ?? 0) === epoch && optionsGeneration === generation) {
                     optionsCache.set(key, { payload, at: Date.now() });
                 }
                 return payload;

package/dist/validation-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation-catalog.d.ts","sourceRoot":"","sources":["../src/validation-catalog.ts"],"names":[],"mappings":"AAAA;;yEAEyE;AAEzE,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2CtE,CAAA;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAG3E;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAI3F"}
+{"version":3,"file":"validation-catalog.d.ts","sourceRoot":"","sources":["../src/validation-catalog.ts"],"names":[],"mappings":"AAAA;;yEAEyE;AAEzE,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6CtE,CAAA;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAG3E;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAI3F"}

package/dist/validation-catalog.js

@@ -21,6 +21,7 @@ export const VALIDATION_CATALOGS = {
         integer: '{{label}} debe ser un entero',
         custom: '{{label}} no es válido',
         line_items_required: '{{label}} requiere al menos un renglón',
+        protected_field: 'El campo {{label}} lo administra el sistema y no se puede modificar',
         fallback: '{{label}}: valor inválido',
     },
     en: {
@@ -42,6 +43,7 @@ export const VALIDATION_CATALOGS = {
         integer: 'The {{label}} must be an integer',
         custom: 'The {{label}} is invalid',
         line_items_required: '{{label}} requires at least one row',
+        protected_field: 'The {{label}} field is managed by the system and cannot be changed',
         fallback: '{{label}}: invalid value',
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "39.2.8",
+  "version": "39.2.9",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",
@@ -27,7 +27,7 @@
   },
   "peerDependencies": {
     "@asteby/metacore-sdk": "^3.8.0",
-    "@asteby/metacore-ui": "^2.18.2",
+    "@asteby/metacore-ui": "^2.18.3",
     "@tanstack/react-query": ">=5",
     "@tanstack/react-router": ">=1.100",
     "@tanstack/react-table": ">=8",
@@ -51,7 +51,7 @@
   },
   "devDependencies": {
     "@asteby/metacore-sdk": "3.8.0",
-    "@asteby/metacore-ui": "2.18.2",
+    "@asteby/metacore-ui": "2.18.3",
     "@tanstack/react-query": "^5.95.0",
     "@tanstack/react-router": "^1.168.0",
     "@tanstack/react-table": "^8.20.0",

package/src/__tests__/calendar-date.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, it } from 'vitest'
+import { es } from 'date-fns/locale'
+import { parseCalendarDate } from '../calendar-date'
+import { formatDateCell } from '../dynamic-columns'
+
+describe('parseCalendarDate', () => {
+    it('lee UTC medianoche como el mismo día local (PIT-025)', () => {
+        const d = parseCalendarDate('2026-09-27T00:00:00Z')!
+        expect([d.getFullYear(), d.getMonth(), d.getDate()]).toEqual([2026, 8, 27])
+    })
+
+    it('acepta YYYY-MM-DD y vacíos', () => {
+        expect(parseCalendarDate('2026-01-05')!.getDate()).toBe(5)
+        expect(parseCalendarDate('')).toBeUndefined()
+        expect(parseCalendarDate(null)).toBeUndefined()
+        expect(parseCalendarDate('no es fecha')).toBeUndefined()
+    })
+
+    it('la celda date sin zona de la org no retrocede un día', () => {
+        expect(formatDateCell('2026-09-27T00:00:00Z', 'date', es)?.display).toContain('27')
+    })
+})

package/src/__tests__/options-cache-invalidation.test.tsx

@@ -0,0 +1,126 @@
+// @vitest-environment happy-dom
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import React from 'react'
+import { act, cleanup, render, screen, waitFor } from '@testing-library/react'
+import { ApiProvider, useApi } from '../api-context'
+import { useOptionsResolver, invalidateOptionsCache } from '../use-options-resolver'
+
+afterEach(() => {
+    cleanup()
+    invalidateOptionsCache()
+})
+
+// A picker opened right after creating a record must list it: the 30 s
+// options cache is dropped by every write, whether it goes through useApi()
+// or straight through the host's axios instance.
+
+function Picker() {
+    const { options } = useOptionsResolver({ modelKey: '', ref: 'Brand', fieldKey: 'id' })
+    return <span data-testid="opts">{options.map((o) => o.label).join(',')}</span>
+}
+
+function hostClient(brands: string[]) {
+    const handlers: Array<(res: any) => any> = []
+    const client = {
+        get: vi.fn(async () => ({ data: { success: true, data: brands.map((b) => ({ id: b, label: b })) } })),
+        // The batch path is unavailable on this fake host: /api/q 404s.
+        post: vi.fn(async (url: string) => {
+            if (url === '/q') return { data: { success: false } }
+            return { data: { success: true } }
+        }),
+        put: vi.fn(async () => ({ data: { success: true } })),
+        delete: vi.fn(async () => ({ data: { success: true } })),
+        interceptors: {
+            response: {
+                use: (ok: (res: any) => any) => {
+                    handlers.push(ok)
+                    return handlers.length - 1
+                },
+                eject: vi.fn(),
+            },
+        },
+    }
+    const hostWrite = async (method: string, url = '/data/brands') => {
+        for (const h of handlers) h({ config: { method, url } })
+    }
+    return { client, hostWrite }
+}
+
+describe('options cache invalidation', () => {
+    it('a host write through its own client drops the cached options', async () => {
+        const brands = ['A']
+        const { client, hostWrite } = hostClient(brands)
+        const view = render(
+            <ApiProvider client={client}>
+                <Picker />
+            </ApiProvider>,
+        )
+        await waitFor(() => expect(screen.getByTestId('opts').textContent).toBe('A'))
+
+        brands.push('B')
+        await act(async () => {
+            await hostWrite('post')
+        })
+        view.unmount()
+        render(
+            <ApiProvider client={client}>
+                <Picker />
+            </ApiProvider>,
+        )
+        await waitFor(() => expect(screen.getByTestId('opts').textContent).toBe('A,B'))
+    })
+
+    it('neither a GET nor the /q read batch drops the cache', async () => {
+        const brands = ['A']
+        const { client, hostWrite } = hostClient(brands)
+        const view = render(
+            <ApiProvider client={client}>
+                <Picker />
+            </ApiProvider>,
+        )
+        await waitFor(() => expect(screen.getByTestId('opts').textContent).toBe('A'))
+        const calls = client.get.mock.calls.length
+        brands.push('B')
+        await act(async () => {
+            await hostWrite('get')
+            await hostWrite('post', '/q')
+        })
+        view.unmount()
+        render(
+            <ApiProvider client={client}>
+                <Picker />
+            </ApiProvider>,
+        )
+        await waitFor(() => expect(screen.getByTestId('opts').textContent).toBe('A'))
+        expect(client.get.mock.calls.length).toBe(calls)
+    })
+
+    it('a write through useApi() drops the cached options', async () => {
+        const brands = ['A']
+        const { client } = hostClient(brands)
+        let write: (() => Promise<unknown>) | null = null
+        function Writer() {
+            const api = useApi()
+            write = () => api.post('/data/brands', { name: 'B' })
+            return null
+        }
+        const view = render(
+            <ApiProvider client={{ ...client, interceptors: undefined } as never}>
+                <Picker />
+                <Writer />
+            </ApiProvider>,
+        )
+        await waitFor(() => expect(screen.getByTestId('opts').textContent).toBe('A'))
+        brands.push('B')
+        await act(async () => {
+            await write!()
+        })
+        view.unmount()
+        render(
+            <ApiProvider client={{ ...client, interceptors: undefined } as never}>
+                <Picker />
+            </ApiProvider>,
+        )
+        await waitFor(() => expect(screen.getByTestId('opts').textContent).toBe('A,B'))
+    })
+})

package/src/__tests__/permissions-manager.test.tsx

@@ -400,6 +400,79 @@ describe('PermissionsManager (módulo como combobox agrupado)', () => {
     })
 })
 
+describe('PermissionsManager (entradas que comparten modelo)', () => {
+    // Two sidebar entries over the same model (QA PIT-001: "Ventas POS" and
+    // "Por cobrar" both over sales_orders): picking the second must show the
+    // second, not the first entry with that key.
+    const shared: GroupedPermissionsCatalog = {
+        groups: [
+            {
+                title: 'Caja',
+                modules: [
+                    {
+                        key: 'sales_orders',
+                        label: 'Por cobrar',
+                        kind: 'model',
+                        actions: [{ key: 'index', label: 'Listar', kind: 'crud' }],
+                    },
+                ],
+            },
+            {
+                title: 'Ventas',
+                modules: [
+                    {
+                        key: 'sales_orders',
+                        label: 'Ventas POS',
+                        kind: 'model',
+                        actions: [{ key: 'index', label: 'Listar', kind: 'crud' }],
+                    },
+                ],
+            },
+        ],
+    }
+    const moduleTrigger = () => {
+        const triggers = screen.getAllByRole('combobox')
+        return triggers[triggers.length - 1]
+    }
+
+    it('seleccionar la segunda entrada muestra la segunda', async () => {
+        render(<PermissionsManager {...makeProps(shared)} />)
+        await waitFor(() => expect(moduleTrigger().textContent).toMatch(/Por cobrar/))
+        fireEvent.click(moduleTrigger())
+        fireEvent.click(await screen.findByRole('option', { name: /Ventas POS/ }))
+        await waitFor(() => expect(moduleTrigger().textContent).toMatch(/Ventas POS/))
+    })
+})
+
+describe('PermissionsManager (error al crear rol)', () => {
+    it('muestra dentro del diálogo el motivo del servidor y lo deja abierto', async () => {
+        const dup = Object.assign(new Error('Request failed with status code 422'), {
+            response: {
+                data: {
+                    success: false,
+                    code: 'duplicate',
+                    message: 'Ya existe un registro con esos datos',
+                    error: { code: 'duplicate', message: 'Ya existe un registro con esos datos' },
+                },
+            },
+        })
+        const props = makeProps(grouped, {
+            createRole: vi.fn(async () => {
+                throw dup
+            }),
+        })
+        render(<PermissionsManager {...props} />)
+        fireEvent.click(await screen.findByRole('button', { name: /Nuevo rol/ }))
+        fireEvent.change(await screen.findByLabelText('Nombre del rol'), {
+            target: { value: 'Admin' },
+        })
+        fireEvent.click(screen.getByRole('button', { name: 'Crear rol' }))
+        const alert = await screen.findByRole('alert')
+        expect(alert.textContent).toBe('Ya existe un registro con esos datos')
+        expect(screen.getByRole('dialog')).toBeTruthy()
+    })
+})
+
 describe('PermissionsManager (retrocompat shape viejo {modules})', () => {
     it('renderiza el shape flat legacy sin romper, agrupado por addon', async () => {
         const props = makeProps(legacy)

package/src/api-context.tsx

@@ -2,8 +2,9 @@
 // runtime-react components (DynamicTable, dialogs, action dispatcher) can
 // talk to the backend without a bundler alias to `@/lib/api`. Hosts wrap
 // their app in <ApiProvider value={axiosInstance}> once at the root.
-import React, { createContext, useContext, useMemo } from 'react'
-import { batchGet } from './query-batch'
+import React, { createContext, useContext, useEffect, useMemo } from 'react'
+import { batchGet, invalidateQueryBatchData } from './query-batch'
+import { invalidateOptionsCache } from './use-options-resolver'
 
 /** Minimal axios-compatible client shape consumed by runtime-react. */
 export interface ApiClient {
@@ -21,9 +22,59 @@ export interface ApiProviderProps {
 }
 
 export function ApiProvider({ client, 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.
+    useEffect(() => {
+        const interceptors = (client as AxiosLike).interceptors?.response
+        if (!interceptors?.use) return
+        const onSettled = (config: { method?: string; url?: string } | undefined) => {
+            if (isWrite(config?.method, config?.url)) forgetRemembered()
+        }
+        const id = interceptors.use(
+            (res: any) => {
+                onSettled(res?.config)
+                return res
+            },
+            (err: any) => {
+                onSettled(err?.config)
+                return Promise.reject(err)
+            },
+        )
+        return () => interceptors.eject?.(id)
+    }, [client])
     return <ApiContext.Provider value={client}>{children}</ApiContext.Provider>
 }
 
+interface AxiosLike {
+    interceptors?: {
+        response?: {
+            use?: (onFulfilled: (res: any) => any, onRejected: (err: any) => any) => number
+            eject?: (id: number) => void
+        }
+    }
+}
+
+// The read batch is a POST to /q; it reads, so it must not count as a write.
+const BATCH_READ_URL = /(^|\/)q\/?(\?|$)/
+
+function isWrite(method: string | undefined, url: string | undefined): boolean {
+    const m = (method ?? '').toLowerCase()
+    if (m === '' || m === 'get' || m === 'head' || m === 'options') return false
+    return !BATCH_READ_URL.test(url ?? '')
+}
+
+/** Drops the batch rows and the picker options the runtime remembered. */
+function forgetRemembered(): void {
+    invalidateQueryBatchData()
+    invalidateOptionsCache()
+}
+
+function mutating<T>(request: Promise<T>): Promise<T> {
+    forgetRemembered()
+    return request.finally(forgetRemembered)
+}
+
 /** Returns the host-injected api client. Throws if no <ApiProvider> is mounted. */
 export function useApi(): ApiClient {
     const ctx = useContext(ApiContext)
@@ -31,12 +82,15 @@ export function useApi(): ApiClient {
         throw new Error('useApi() requires an <ApiProvider> ancestor. Hosts must inject an axios-like client via runtime-react ApiProvider.')
     }
     // List, metadata and options GETs share one POST /api/q. Mutations stay
-    // on the host client. The wrapper is stable while the host client is.
+    // on the host client and, settled either way, drop the rows the batch
+    // remembered, so the refresh after a save reads the saved row. The
+    // wrapper is stable while the host client is.
     return useMemo<ApiClient>(() => ({
         get: (url, config) => batchGet(ctx, url, config),
-        post: (url, body, config) => ctx.post(url, body, config),
-        put: (url, body, config) => ctx.put(url, body, config),
-        delete: (url, config) => ctx.delete(url, config),
+        post: (url, body, config) =>
+            isWrite('post', url) ? mutating(ctx.post(url, body, config)) : ctx.post(url, body, config),
+        put: (url, body, config) => mutating(ctx.put(url, body, config)),
+        delete: (url, config) => mutating(ctx.delete(url, config)),
     }), [ctx])
 }
 

package/src/calendar-date.ts

@@ -0,0 +1,16 @@
+// A `date` column is a calendar day, not an instant. The backend often serves
+// it as UTC midnight ("2026-09-27T00:00:00Z"), which a plain Date parse turns
+// into the previous evening west of UTC (QA Pitsline PIT-025: picked the 27th,
+// the form showed the 26th). Read the YYYY-MM-DD prefix as a LOCAL day instead.
+
+/** Parse a calendar day ("YYYY-MM-DD…" or any Date-parseable value) into a
+ *  local Date at noon, or undefined when empty/invalid. */
+export function parseCalendarDate(v: unknown): Date | undefined {
+    if (v === null || v === undefined || v === '') return undefined
+    if (v instanceof Date) return isNaN(v.getTime()) ? undefined : v
+    const s = String(v)
+    const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(s)
+    if (m) return new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]), 12)
+    const d = new Date(s)
+    return isNaN(d.getTime()) ? undefined : d
+}

package/src/dialogs/dynamic-record.tsx

@@ -49,6 +49,7 @@ import {
 import { cn } from '@asteby/metacore-ui/lib'
 import { toast } from 'sonner'
 import { format, parseISO } from 'date-fns'
+import { parseCalendarDate } from '../calendar-date'
 import { es } from 'date-fns/locale'
 import { ExternalLink, Loader2, CalendarIcon, ChevronDown, Check, Upload, X as XIcon, ScanLine } from 'lucide-react'
 import { BarcodeScanner } from '../barcode-scanner'
@@ -2125,7 +2126,11 @@ export function EditField({ field, value, onChange, record, invalid }: {
     }
 
     if (field.type === 'date' || field.type === 'datetime' || field.type === 'timestamp' || field.type === 'timestamptz') {
-        const dateValue = value ? (typeof value === 'string' ? parseISO(value) : new Date(value)) : undefined
+        // A pure `date` is a calendar day: read its YYYY-MM-DD as a local day so
+        // UTC midnight does not render as the day before (PIT-025).
+        const dateValue = field.type === 'date'
+            ? parseCalendarDate(value)
+            : value ? (typeof value === 'string' ? parseISO(value) : new Date(value)) : undefined
         // Treat the Go zero-time (0001-01-01) as empty so an unset date shows the
         // placeholder instead of "31 de diciembre de 1".
         const validDate =

package/src/dynamic-columns.tsx

@@ -15,6 +15,7 @@
 import * as React from 'react'
 import { ColumnDef } from '@tanstack/react-table'
 import { format, type Locale } from 'date-fns'
+import { parseCalendarDate } from './calendar-date'
 import { es, enUS } from 'date-fns/locale'
 import { Calendar, Check, Copy, Mail, Minus, MoreHorizontal } from 'lucide-react'
 import {
@@ -507,7 +508,8 @@ export function formatDateCell(
             title: format(date, 'PPpp', { locale }),
         }
     }
-    return { display: format(date, 'PPP', { locale }) }
+    // Calendar day without an org zone: read YYYY-MM-DD as a local day.
+    return { display: format(parseCalendarDate(value) ?? date, 'PPP', { locale }) }
 }
 
 /**