@asteby/metacore-runtime-react 39.2.7 → 39.2.9

package/dist/query-batch.d.ts

@@ -14,6 +14,39 @@ export interface QueryPart {
     etag?: string;
     not_modified?: boolean;
 }
+export interface InListToken {
+    field: string;
+    ids: string[];
+    shape: string;
+}
+/**
+ * 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 declare function splitInToken(token: string): InListToken | null;
+export interface NarrowedIn {
+    wire: string;
+    rows: Record<string, unknown>[];
+    missingIds: string[];
+    field: string;
+    shape: string;
+}
+/** Drops ids already cached for this shape. An empty wire means nothing has to travel. */
+export declare function narrowInToken(token: string, now?: number): NarrowedIn | null;
+/**
+ * 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 declare function rememberInRows(token: string, ids: string[], rows: unknown, now?: number): void;
+export declare function resetQueryBatchCache(): void;
+/**
+ * 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 declare function invalidateQueryBatchData(): void;
 export declare function optionsModelFromUrl(url: string): string | null;
 export declare function optionsBatchToken(model: string, field: string, query: string, limit: number | undefined, filter: string | undefined): string;
 /** Names each distinct token so the server can key the response. */
@@ -23,4 +56,19 @@ export declare function nameBatchTokens(tokens: string[]): {
     plan: string;
 }[];
 export declare function loadQueryPart(api: ApiClient, token: string): Promise<QueryPart>;
+/**
+ * Token for a host GET that the batch can serve. Custom endpoints, aggregates
+ * and `/me` stay on the legacy GET.
+ */
+export declare function tokenForGet(url: string, params?: Record<string, unknown>): string | null;
+/**
+ * GET through the batch when the URL is a list, table metadata, modal metadata
+ * or options read. Anything the batch refuses falls back to the original GET.
+ */
+export declare function batchGet(api: ApiClient, url: string, config?: {
+    params?: Record<string, unknown>;
+}): Promise<{
+    data: any;
+    headers?: any;
+}>;
 //# sourceMappingURL=query-batch.d.ts.map

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;AA6BD,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,CAU/E"}
+{"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;;;GAwBxG"}

package/dist/query-batch.js

@@ -1,9 +1,157 @@
 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 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:'))
+        return null;
+    const model = token.slice(2, q);
+    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()) {
+        if (!value.startsWith('in:'))
+            continue;
+        if (field || value.includes('@'))
+            return null;
+        field = key;
+        ids = value
+            .slice(3)
+            .split(',')
+            .map((id) => id.trim())
+            .filter(Boolean);
+    }
+    if (!field || ids.length === 0)
+        return null;
+    const keys = [...new Set(params.keys())].sort();
+    const bits = keys.map((key) => `${key}=${key === field ? 'in:$1' : (params.get(key) ?? '')}`);
+    return { field, ids, shape: `t:${model}?${bits.join('&')}` };
+}
+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));
+    params.set(field, `in:${ids.join(',')}`);
+    return `${token.slice(0, q)}?${params.toString()}`;
+}
+/** Drops ids already cached for this shape. An empty wire means nothing has to travel. */
+export function narrowInToken(token, now = Date.now()) {
+    const parsed = splitInToken(token);
+    if (!parsed)
+        return null;
+    const scope = cacheScope();
+    const rows = [];
+    const missingIds = [];
+    for (const id of parsed.ids) {
+        const hit = entityCache.get(entityKey(scope, parsed.shape, id));
+        if (!hit || now - hit.at >= ENTITY_TTL_MS) {
+            missingIds.push(id);
+            continue;
+        }
+        rows.push(...hit.rows);
+    }
+    if (missingIds.length === parsed.ids.length)
+        return null;
+    return {
+        wire: missingIds.length === 0 ? '' : replaceInIds(token, parsed.field, missingIds),
+        rows,
+        missingIds,
+        field: parsed.field,
+        shape: parsed.shape,
+    };
+}
+/**
+ * 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 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[field] ?? '').trim();
+            const bucket = byId.get(id);
+            if (bucket)
+                bucket.push(row);
+        }
+    }
+    for (const [id, bucket] of byId) {
+        entityCache.set(entityKey(scope, parsed.shape, id), { rows: bucket, at: now });
+    }
+}
+export function resetQueryBatchCache() {
+    partCache.clear();
+    entityCache.clear();
+    waiters = [];
+    if (timer != null)
+        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;
+function mergeCachedRows(cached, part) {
+    if (!cached?.length)
+        return part;
+    const fresh = Array.isArray(part.data) ? part.data : [];
+    return { ...part, data: [...cached, ...fresh] };
+}
 function cacheScope() {
     if (typeof localStorage === 'undefined')
         return '';
@@ -49,12 +197,24 @@ 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);
+    if (narrowed && narrowed.wire === '') {
+        return Promise.resolve({ success: true, data: narrowed.rows, meta: { total: narrowed.rows.length } });
+    }
     return new Promise((resolve, reject) => {
         transport = api;
-        waiters.push({ token, resolve, reject });
+        waiters.push({
+            token,
+            wire: narrowed?.wire ?? token,
+            resolve,
+            reject,
+            cachedRows: narrowed?.rows,
+            missingIds: narrowed?.missingIds,
+            field: narrowed?.field,
+        });
         if (timer == null)
             timer = setTimeout(() => void flushQueryBatch(), WINDOW_MS);
     });
@@ -66,14 +226,15 @@ async function flushQueryBatch() {
     const api = transport;
     if (!api || batch.length === 0)
         return;
-    const named = nameBatchTokens(batch.map((waiter) => waiter.token));
+    const named = nameBatchTokens(batch.map((waiter) => waiter.wire));
     const byToken = new Map(named.map((part) => [part.token, part.name]));
     const inm = {};
     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 });
@@ -82,7 +243,7 @@ async function flushQueryBatch() {
             throw new Error('batch unavailable');
         }
         for (const waiter of batch) {
-            const name = byToken.get(waiter.token);
+            const name = byToken.get(waiter.wire);
             const part = name ? body.parts[name] : undefined;
             if (!part) {
                 waiter.reject(new Error('batch part missing'));
@@ -91,14 +252,23 @@ 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) {
+                rememberInRows(waiter.token, waiter.missingIds, part.data);
             }
             if (part.success) {
-                partCache.set(`${scope}\n${waiter.token}`, { part, at: Date.now() });
+                partCache.set(`${scope}\n${waiter.token}`, { part: merged, at: Date.now() });
             }
-            waiter.resolve(part);
+            waiter.resolve(merged);
         }
     }
     catch (err) {
@@ -107,3 +277,76 @@ async function flushQueryBatch() {
             waiter.reject(error);
     }
 }
+function canonicalParams(params) {
+    if (!params)
+        return '';
+    const keys = Object.keys(params)
+        .filter((key) => params[key] != null && params[key] !== '')
+        .sort();
+    const search = new URLSearchParams();
+    for (const key of keys)
+        search.set(key, String(params[key]));
+    return search.toString();
+}
+/**
+ * Token for a host GET that the batch can serve. Custom endpoints, aggregates
+ * and `/me` stay on the legacy GET.
+ */
+export function tokenForGet(url, params) {
+    const [path, query = ''] = url.split('?');
+    const table = path.match(/^\/metadata\/table\/([A-Za-z][A-Za-z0-9_]*)$/);
+    if (table)
+        return `m:${table[1]}`;
+    const modal = path.match(/^\/metadata\/modal\/([A-Za-z][A-Za-z0-9_]*)$/);
+    if (modal)
+        return `mm:${modal[1]}`;
+    const list = path.match(/^\/data\/([A-Za-z][A-Za-z0-9_]*)$/);
+    if (list) {
+        const q = canonicalParams(params);
+        return q ? `t:${list[1]}?${q}` : `t:${list[1]}`;
+    }
+    const opt = path.match(/^\/options\/([A-Za-z][A-Za-z0-9_]*)$/);
+    if (!opt)
+        return null;
+    const search = new URLSearchParams(query);
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            if (value != null && value !== '')
+                search.set(key, String(value));
+        }
+    }
+    const limit = Number(search.get('limit'));
+    return optionsBatchToken(opt[1], search.get('field') || 'id', search.get('q') || search.get('search') || '', Number.isFinite(limit) && limit > 0 ? limit : undefined, search.get('filter_value') || undefined);
+}
+function batchForbidden(message) {
+    return /forbidden|permiso/i.test(message || '');
+}
+/**
+ * GET through the batch when the URL is a list, table metadata, modal metadata
+ * or options read. Anything the batch refuses falls back to the original GET.
+ */
+export async function batchGet(api, url, config) {
+    const token = tokenForGet(url, config?.params);
+    if (!token)
+        return api.get(url, config);
+    try {
+        const part = await loadQueryPart(api, token);
+        if (!part.success) {
+            if (batchForbidden(part.message)) {
+                const err = new Error(part.message || 'forbidden');
+                err.status = 403;
+                err.response = { status: 403 };
+                throw err;
+            }
+            return api.get(url, config);
+        }
+        return { data: { success: true, data: part.data, meta: part.meta } };
+    }
+    catch (err) {
+        const status = err?.status
+            ?? err?.response?.status;
+        if (status === 403)
+            throw err;
+        return api.get(url, config);
+    }
+}

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.7",
+  "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'))
+    })
+})