@asteby/metacore-runtime-react 16.0.0 → 17.0.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # @asteby/metacore-runtime-react
 
+## 17.0.0
+
+### Patch Changes
+
+- c834e67: Render the nil UUID (`00000000-0000-0000-0000-000000000000`) as empty in
+  dynamic tables and the detail view.
+
+  A nullable FK that a backend serializes as the all-zeros UUID instead of `null`
+  used to leak into cells and read-only fields as a long string of zeros. The
+  table cell renderer (`defaultGetDynamicColumns`) and the record detail view
+  (`DynamicRecordDialog`/`ViewRecordDialog`) now treat the nil UUID as "no value",
+  falling through to their existing empty markers (`-` / `—`). This covers
+  relation/ref chips, `creator`/`url`/`status`/`dynamic_select` and any generic
+  UUID-bearing column. A new shared guard (`NIL_UUID`, `isNilUuid`,
+  `normalizeNilUuid`) is exported for hosts that render values themselves.
+
+- Updated dependencies [8a4a315]
+  - @asteby/metacore-sdk@3.2.0
+
+## 16.0.1
+
+### Patch Changes
+
+- cde025c: Fix intermittent `#RUNTIME-009` ("Please call createInstance first") addon load
+  errors.
+
+  When an addon mounts before `@module-federation/vite`'s asynchronous runtime
+  init lands at host boot, `registerRemotes`/`loadRemote` throw RUNTIME-009. The
+  runtime is on its way — it's a boot race — so `AddonLoader` now treats that
+  specific error as transient and retries with a short backoff (~10 × 60ms) until
+  the host's federation runtime is ready, instead of surfacing a dead "Addon load
+  error" to the user. Genuine failures (bad URL, missing export, 404) still
+  rethrow immediately.
+
 ## 16.0.0
 
 ### Minor Changes

package/dist/addon-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addon-loader.d.ts","sourceRoot":"","sources":["../src/addon-loader.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGjE,MAAM,WAAW,gBAAgB;IAC7B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAA;IACX,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,GAAG,EAAE,QAAQ,CAAA;IACb,wCAAwC;IACxC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;IAC9B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC7B;AA6CD,wBAAgB,WAAW,CAAC,EACxB,KAAK,EACL,GAAG,EACH,MAAqB,EACrB,GAAG,EACH,QAAe,EACf,OAAO,EACP,OAAO,EACP,MAAM,EACN,QAAQ,GACX,EAAE,gBAAgB,2CA8ClB"}
+{"version":3,"file":"addon-loader.d.ts","sourceRoot":"","sources":["../src/addon-loader.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGjE,MAAM,WAAW,gBAAgB;IAC7B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAA;IACX,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,GAAG,EAAE,QAAQ,CAAA;IACb,wCAAwC;IACxC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;IAC9B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC7B;AAoFD,wBAAgB,WAAW,CAAC,EACxB,KAAK,EACL,GAAG,EACH,MAAqB,EACrB,GAAG,EACH,QAAe,EACf,OAAO,EACP,OAAO,EACP,MAAM,EACN,QAAQ,GACX,EAAE,gBAAgB,2CA8ClB"}

package/dist/addon-loader.js

@@ -25,22 +25,56 @@ function remoteId(scope, module) {
     const expose = module.replace(/^\.\//, '');
     return `${scope}/${expose}`;
 }
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+// `@module-federation/vite` initialises the shared federation runtime instance
+// asynchronously at host boot (it injects an init call into the entry). If an
+// addon mounts before that init resolves — a real race on slow first paints,
+// route preloads, or HMR — `registerRemotes`/`loadRemote` throw
+// `[ Federation Runtime ]: Please call createInstance first. #RUNTIME-009`.
+// It's transient: the runtime IS coming, we just raced it. So we treat
+// RUNTIME-009 specifically as retryable and back off briefly until the host's
+// init lands, instead of surfacing a dead "Addon load error" to the user.
+function isRuntimeNotReady(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return msg.includes('#RUNTIME-009') || msg.includes('call createInstance');
+}
+// Retry an operation that may hit the boot race above. ~10 attempts × 60ms ≈
+// 600ms worst case — generous for the host init, imperceptible in the common
+// case (first attempt succeeds). Non-RUNTIME-009 errors (bad URL, 404, no
+// export) rethrow immediately so genuine failures still surface fast.
+async function withRuntimeReady(op) {
+    const maxAttempts = 10;
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await op();
+        }
+        catch (e) {
+            if (!isRuntimeNotReady(e) || attempt >= maxAttempts)
+                throw e;
+            await sleep(60);
+        }
+    }
+}
 async function loadAddon(scope, url, module) {
     // Register the remote container as an ES module. `type: 'module'` matches
     // the `@module-federation/vite` remote (remoteEntry.js is an ESM bundle).
     // The `url` already carries the `?v=` cache-bust the host computed, so the
     // browser refetches a fresh remoteEntry when the addon version changes.
+    //
+    // Both calls are wrapped in `withRuntimeReady` because EITHER can throw
+    // RUNTIME-009 when an addon mounts ahead of the host's federation init —
+    // registration is what actually touches the (maybe-uninitialised) runtime.
     if (!registered.has(scope)) {
-        registerRemotes([{ name: scope, entry: url, type: 'module' }], 
+        await withRuntimeReady(() => registerRemotes([{ name: scope, entry: url, type: 'module' }], 
         // `force: true` so a re-registration with a new `?v=` URL (addon
         // hot-swap / version bump) overwrites the stale entry + cache.
-        { force: true });
+        { force: true }));
         registered.add(scope);
     }
     // loadRemote("<scope>/<expose>") returns the exposed module namespace (or
     // null if it can't be resolved). No manual share-scope init — the host's
     // federation runtime already initialised it.
-    return loadRemote(remoteId(scope, module));
+    return withRuntimeReady(() => loadRemote(remoteId(scope, module)));
 }
 export function AddonLoader({ scope, url, module = './register', api, fallback = null, onReady, onError, layout, children, }) {
     const [status, setStatus] = useState('loading');

package/dist/dialogs/dynamic-record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-record.d.ts","sourceRoot":"","sources":["../../src/dialogs/dynamic-record.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAwF1C,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAClF;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IACpG;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAsDD,wBAAgB,mBAAmB,CAAC,EAChC,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,MAAM,GACT,EAAE,wBAAwB,2CAsP1B"}
+{"version":3,"file":"dynamic-record.d.ts","sourceRoot":"","sources":["../../src/dialogs/dynamic-record.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAyF1C,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAClF;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IACpG;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAwDD,wBAAgB,mBAAmB,CAAC,EAChC,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,MAAM,GACT,EAAE,wBAAwB,2CAsP1B"}

package/dist/dialogs/dynamic-record.js

@@ -14,10 +14,13 @@ import { ExternalLink, Loader2, CalendarIcon, ChevronDown, Check, Upload, X as X
 import { useApi } from '../api-context';
 import { DynamicSelectField } from '../dynamic-select-field';
 import { getFieldRef } from '../dynamic-form-schema';
+import { normalizeNilUuid } from '../nil-uuid';
 function resolvePath(obj, path) {
     return path.split('.').reduce((acc, part) => acc?.[part], obj);
 }
-function formatDisplayValue(value, field) {
+function formatDisplayValue(rawValue, field) {
+    // Unset nullable FK serialized as the nil UUID renders as empty, not zeros.
+    const value = normalizeNilUuid(rawValue);
     if (value === null || value === undefined || value === '')
         return '—';
     if (field.type === 'boolean' || typeof value === 'boolean')
@@ -227,7 +230,10 @@ function FieldRow({ field, record, value, mode, onChange }) {
     const isReadonly = field.readonly || mode === 'view';
     return (_jsxs("div", { className: "flex flex-col gap-1.5", children: [_jsxs(Label, { className: "text-xs font-medium text-muted-foreground uppercase tracking-wide", children: [field.label, field.required && mode !== 'view' && (_jsx("span", { className: "text-destructive ml-0.5", children: "*" }))] }), isReadonly ? (_jsx(ViewValue, { field: field, value: value, record: record })) : (_jsx(EditField, { field: field, value: value, onChange: onChange }))] }));
 }
-function ViewValue({ field, value }) {
+function ViewValue({ field, value: rawValue }) {
+    // Normalize the nil UUID to undefined up front so the search/url/color/
+    // image/select branches all fall through to their empty states.
+    const value = normalizeNilUuid(rawValue);
     if (field.type === 'search' && value) {
         return _jsx(SearchViewValue, { field: field, value: value });
     }

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

@@ -1 +1 @@
-{"version":3,"file":"dynamic-columns.d.ts","sourceRoot":"","sources":["../src/dynamic-columns.tsx"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE9D,OAAO,KAAK,EAER,iBAAiB,EACpB,MAAM,wBAAwB,CAAA;AAE/B,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAgGD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,GAAG,EAAE,KAAK,GAAG,KAAG,OAMlE,CAAA;AAwHD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAG,MAGnE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAStE,CAAA;AAiED;;;;GAIG;AACH,wBAAgB,4BAA4B,CACxC,OAAO,GAAE,qBAA0B,GACpC,iBAAiB,CAgmBnB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBACL,CAAA"}
+{"version":3,"file":"dynamic-columns.d.ts","sourceRoot":"","sources":["../src/dynamic-columns.tsx"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE9D,OAAO,KAAK,EAER,iBAAiB,EACpB,MAAM,wBAAwB,CAAA;AAE/B,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAgGD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,GAAG,EAAE,KAAK,GAAG,KAAG,OAMlE,CAAA;AAwHD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAG,MAGnE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAWtE,CAAA;AAiED;;;;GAIG;AACH,wBAAgB,4BAA4B,CACxC,OAAO,GAAE,qBAA0B,GACpC,iBAAiB,CAmmBnB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBACL,CAAA"}

package/dist/dynamic-columns.js

@@ -23,6 +23,7 @@ import { generateBadgeStyles, getInitials, optionColor, relationChipStyles, } fr
 import { Progress } from './dialogs/_primitives';
 import { OptionsContext } from './options-context';
 import { DynamicIcon } from './dynamic-icon';
+import { isNilUuid, normalizeNilUuid } from './nil-uuid';
 import { isColumnVisibleInTable } from './column-visibility';
 const defaultGetImageUrl = (path) => path;
 const getNestedValue = (obj, path) => path.split('.').reduce((acc, part) => acc && acc[part], obj);
@@ -213,7 +214,10 @@ export const resolveRelationLabel = (col, row) => {
     if (label !== undefined && label !== null && label !== '')
         return String(label);
     const raw = getNestedValue(row, col.key);
-    return raw !== undefined && raw !== null ? String(raw) : '';
+    // An unresolved FK that arrived as the nil UUID reads as empty, not zeros.
+    if (raw === undefined || raw === null || isNilUuid(raw))
+        return '';
+    return String(raw);
 };
 /**
  * Renders a resolved FK relation as a clean, truncated chip. Reads the
@@ -290,7 +294,10 @@ export function makeDefaultGetDynamicColumns(helpers = {}) {
                 meta: columnMeta,
                 header: ({ column }) => filterConfig ? (_jsx(FilterableColumnHeader, { column: column, title: translatedLabel })) : (_jsx(DataTableColumnHeader, { column: column, title: translatedLabel })),
                 cell: ({ row }) => {
-                    const value = getNestedValue(row.original, col.key);
+                    // Treat the nil UUID (unset nullable FK serialized as
+                    // all-zeros) as no value, so every type below hits its
+                    // existing empty branch instead of printing the zeros.
+                    const value = normalizeNilUuid(getNestedValue(row.original, col.key));
                     // Kernel emits the renderer flag as `type`; older hosts used
                     // `cellStyle`. Accept both so a single backend works across
                     // SDK versions.

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export { useHotSwapReload, applyHotSwapReload, withVersionParam, clearFederation
 export * from './dynamic-icon';
 export type { ColumnFilterConfig, FilterOption as DynamicColumnFilterOption, GetDynamicColumns, DynamicIconComponent, } from './dynamic-columns-shim';
 export { defaultGetDynamicColumns, makeDefaultGetDynamicColumns, relationKeyFor, resolveRelationLabel, type DynamicColumnsHelpers, } from './dynamic-columns';
+export { NIL_UUID, isNilUuid, normalizeNilUuid } from './nil-uuid';
 export { DynamicRecordDialog } from './dialogs/dynamic-record';
 export { CreateRecordDialog } from './dialogs/create-record-dialog';
 export { ViewRecordDialog } from './dialogs/view-record-dialog';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -21,6 +21,7 @@ export { ADDON_MANIFEST_CHANGED_TYPE, wireHotSwapInvalidation, useManifestHotSwa
 export { useHotSwapReload, applyHotSwapReload, withVersionParam, clearFederationContainer, shortenHash, } from './hotswap-reload-policy';
 export * from './dynamic-icon';
 export { defaultGetDynamicColumns, makeDefaultGetDynamicColumns, relationKeyFor, resolveRelationLabel, } from './dynamic-columns';
+export { NIL_UUID, isNilUuid, normalizeNilUuid } from './nil-uuid';
 export { DynamicRecordDialog } from './dialogs/dynamic-record';
 export { CreateRecordDialog } from './dialogs/create-record-dialog';
 export { ViewRecordDialog } from './dialogs/view-record-dialog';

package/dist/nil-uuid.d.ts

@@ -0,0 +1,15 @@
+/** The canonical nil/zero UUID sentinel. */
+export declare const NIL_UUID = "00000000-0000-0000-0000-000000000000";
+/**
+ * True when `value` is the nil UUID string. Tolerant of surrounding whitespace
+ * and letter-case (UUIDs are conventionally lowercase, but be defensive). Only
+ * matches strings — numeric/object values are never the nil UUID.
+ */
+export declare const isNilUuid: (value: unknown) => boolean;
+/**
+ * Normalizes a raw cell value: returns `undefined` when it is the nil UUID so
+ * downstream renderers hit their existing nullish/empty branches; otherwise the
+ * value is passed through unchanged.
+ */
+export declare const normalizeNilUuid: <T>(value: T) => T | undefined;
+//# sourceMappingURL=nil-uuid.d.ts.map

package/dist/nil-uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nil-uuid.d.ts","sourceRoot":"","sources":["../src/nil-uuid.ts"],"names":[],"mappings":"AAOA,4CAA4C;AAC5C,eAAO,MAAM,QAAQ,yCAAyC,CAAA;AAE9D;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,OAC6B,CAAA;AAExE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,CAAC,GAAG,SACX,CAAA"}

package/dist/nil-uuid.js

@@ -0,0 +1,20 @@
+// Shared guard for the "nil UUID" — the all-zeros UUID Postgres/Go emit for a
+// nullable FK that was never set (`00000000-0000-0000-0000-000000000000`).
+// Backends sometimes serialize an unset `uuid` column as this sentinel instead
+// of `null`, which then leaks into the UI as a long string of zeros. Treat it
+// as "no value" so cell/detail renderers fall through to their existing empty
+// markers ("-" / "—"). Cosmetic defense-in-depth — the backend should emit null.
+/** The canonical nil/zero UUID sentinel. */
+export const NIL_UUID = '00000000-0000-0000-0000-000000000000';
+/**
+ * True when `value` is the nil UUID string. Tolerant of surrounding whitespace
+ * and letter-case (UUIDs are conventionally lowercase, but be defensive). Only
+ * matches strings — numeric/object values are never the nil UUID.
+ */
+export const isNilUuid = (value) => typeof value === 'string' && value.trim().toLowerCase() === NIL_UUID;
+/**
+ * Normalizes a raw cell value: returns `undefined` when it is the nil UUID so
+ * downstream renderers hit their existing nullish/empty branches; otherwise the
+ * value is passed through unchanged.
+ */
+export const normalizeNilUuid = (value) => isNilUuid(value) ? undefined : value;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "16.0.0",
+  "version": "17.0.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",
@@ -33,7 +33,7 @@
     "lucide-react": ">=0.460",
     "date-fns": ">=3",
     "react-day-picker": ">=8",
-    "@asteby/metacore-sdk": "^3.1.0",
+    "@asteby/metacore-sdk": "^3.2.0",
     "@asteby/metacore-ui": "^2.4.0"
   },
   "peerDependenciesMeta": {
@@ -61,7 +61,7 @@
     "typescript": "^6.0.0",
     "vitest": "^4.0.0",
     "zustand": "^5.0.0",
-    "@asteby/metacore-sdk": "3.1.0",
+    "@asteby/metacore-sdk": "3.2.0",
     "@asteby/metacore-ui": "2.4.0"
   },
   "scripts": {

package/src/__tests__/nil-uuid.test.ts

@@ -0,0 +1,42 @@
+// Locks the nil-UUID guard shared by the table cell renderer and the detail
+// view. The all-zeros UUID is the sentinel a backend emits for an unset
+// nullable FK; the UI must read it as "no value", never as a string of zeros.
+import { describe, it, expect } from 'vitest'
+import { NIL_UUID, isNilUuid, normalizeNilUuid } from '../nil-uuid'
+
+describe('isNilUuid', () => {
+    it('matches the canonical nil UUID', () => {
+        expect(isNilUuid(NIL_UUID)).toBe(true)
+        expect(isNilUuid('00000000-0000-0000-0000-000000000000')).toBe(true)
+    })
+
+    it('is tolerant of whitespace and case', () => {
+        expect(isNilUuid('  00000000-0000-0000-0000-000000000000  ')).toBe(true)
+        expect(isNilUuid('00000000-0000-0000-0000-000000000000'.toUpperCase())).toBe(true)
+    })
+
+    it('does not match a real UUID', () => {
+        expect(isNilUuid('3f2504e0-4f89-11d3-9a0c-0305e82c3301')).toBe(false)
+    })
+
+    it('does not match non-string values', () => {
+        expect(isNilUuid(null)).toBe(false)
+        expect(isNilUuid(undefined)).toBe(false)
+        expect(isNilUuid(0)).toBe(false)
+        expect(isNilUuid('')).toBe(false)
+        expect(isNilUuid({ value: NIL_UUID })).toBe(false)
+    })
+})
+
+describe('normalizeNilUuid', () => {
+    it('maps the nil UUID to undefined', () => {
+        expect(normalizeNilUuid(NIL_UUID)).toBeUndefined()
+    })
+
+    it('passes through real values unchanged', () => {
+        expect(normalizeNilUuid('real-id')).toBe('real-id')
+        expect(normalizeNilUuid(42)).toBe(42)
+        expect(normalizeNilUuid(null)).toBeNull()
+        expect(normalizeNilUuid('')).toBe('')
+    })
+})

package/src/__tests__/relation-option-cells.test.ts

@@ -50,4 +50,17 @@ describe('resolveRelationLabel', () => {
         expect(resolveRelationLabel(col({ ref: 'categories' }), {})).toBe('')
         expect(resolveRelationLabel(col({ ref: 'categories' }), { category_id: null })).toBe('')
     })
+
+    it('treats an unresolved nil UUID FK as empty, not a string of zeros', () => {
+        const row = { category_id: '00000000-0000-0000-0000-000000000000' }
+        expect(resolveRelationLabel(col({ ref: 'categories' }), row)).toBe('')
+    })
+
+    it('still prefers a resolved sibling label even if the FK id is the nil UUID', () => {
+        const row = {
+            category_id: '00000000-0000-0000-0000-000000000000',
+            category: { value: '00000000-0000-0000-0000-000000000000', label: 'Sin categoría' },
+        }
+        expect(resolveRelationLabel(col({ ref: 'categories' }), row)).toBe('Sin categoría')
+    })
 })

package/src/addon-loader.tsx

@@ -64,6 +64,37 @@ function remoteId(scope: string, module: string): string {
     return `${scope}/${expose}`
 }
 
+const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms))
+
+// `@module-federation/vite` initialises the shared federation runtime instance
+// asynchronously at host boot (it injects an init call into the entry). If an
+// addon mounts before that init resolves — a real race on slow first paints,
+// route preloads, or HMR — `registerRemotes`/`loadRemote` throw
+// `[ Federation Runtime ]: Please call createInstance first. #RUNTIME-009`.
+// It's transient: the runtime IS coming, we just raced it. So we treat
+// RUNTIME-009 specifically as retryable and back off briefly until the host's
+// init lands, instead of surfacing a dead "Addon load error" to the user.
+function isRuntimeNotReady(e: unknown): boolean {
+    const msg = e instanceof Error ? e.message : String(e)
+    return msg.includes('#RUNTIME-009') || msg.includes('call createInstance')
+}
+
+// Retry an operation that may hit the boot race above. ~10 attempts × 60ms ≈
+// 600ms worst case — generous for the host init, imperceptible in the common
+// case (first attempt succeeds). Non-RUNTIME-009 errors (bad URL, 404, no
+// export) rethrow immediately so genuine failures still surface fast.
+async function withRuntimeReady<T>(op: () => T | Promise<T>): Promise<T> {
+    const maxAttempts = 10
+    for (let attempt = 1; ; attempt++) {
+        try {
+            return await op()
+        } catch (e) {
+            if (!isRuntimeNotReady(e) || attempt >= maxAttempts) throw e
+            await sleep(60)
+        }
+    }
+}
+
 async function loadAddon(
     scope: string,
     url: string,
@@ -73,19 +104,27 @@ async function loadAddon(
     // the `@module-federation/vite` remote (remoteEntry.js is an ESM bundle).
     // The `url` already carries the `?v=` cache-bust the host computed, so the
     // browser refetches a fresh remoteEntry when the addon version changes.
+    //
+    // Both calls are wrapped in `withRuntimeReady` because EITHER can throw
+    // RUNTIME-009 when an addon mounts ahead of the host's federation init —
+    // registration is what actually touches the (maybe-uninitialised) runtime.
     if (!registered.has(scope)) {
-        registerRemotes(
-            [{ name: scope, entry: url, type: 'module' }],
-            // `force: true` so a re-registration with a new `?v=` URL (addon
-            // hot-swap / version bump) overwrites the stale entry + cache.
-            { force: true },
+        await withRuntimeReady(() =>
+            registerRemotes(
+                [{ name: scope, entry: url, type: 'module' }],
+                // `force: true` so a re-registration with a new `?v=` URL (addon
+                // hot-swap / version bump) overwrites the stale entry + cache.
+                { force: true },
+            ),
         )
         registered.add(scope)
     }
     // loadRemote("<scope>/<expose>") returns the exposed module namespace (or
     // null if it can't be resolved). No manual share-scope init — the host's
     // federation runtime already initialised it.
-    return loadRemote<AddonRegisterModule>(remoteId(scope, module))
+    return withRuntimeReady(() =>
+        loadRemote<AddonRegisterModule>(remoteId(scope, module)),
+    )
 }
 
 export function AddonLoader({

package/src/dialogs/dynamic-record.tsx

@@ -42,6 +42,7 @@ import { ExternalLink, Loader2, CalendarIcon, ChevronDown, Check, Upload, X as X
 import { useApi } from '../api-context'
 import { DynamicSelectField } from '../dynamic-select-field'
 import { getFieldRef } from '../dynamic-form-schema'
+import { normalizeNilUuid } from '../nil-uuid'
 import type { ActionFieldDef } from '../types'
 
 interface FieldOption {
@@ -137,7 +138,9 @@ function resolvePath(obj: any, path: string): any {
     return path.split('.').reduce((acc, part) => acc?.[part], obj)
 }
 
-function formatDisplayValue(value: any, field: FieldDef): string {
+function formatDisplayValue(rawValue: any, field: FieldDef): string {
+    // Unset nullable FK serialized as the nil UUID renders as empty, not zeros.
+    const value = normalizeNilUuid(rawValue)
     if (value === null || value === undefined || value === '') return '—'
     if (field.type === 'boolean' || typeof value === 'boolean') return value ? 'Sí' : 'No'
 
@@ -489,7 +492,10 @@ function FieldRow({ field, record, value, mode, onChange }: FieldRowProps) {
     )
 }
 
-function ViewValue({ field, value }: { field: FieldDef; value: any; record: any }) {
+function ViewValue({ field, value: rawValue }: { field: FieldDef; value: any; record: any }) {
+    // Normalize the nil UUID to undefined up front so the search/url/color/
+    // image/select branches all fall through to their empty states.
+    const value = normalizeNilUuid(rawValue)
     if (field.type === 'search' && value) {
         return <SearchViewValue field={field} value={value} />
     }

package/src/dynamic-columns.tsx

@@ -44,6 +44,7 @@ import {
 import { Progress } from './dialogs/_primitives'
 import { OptionsContext } from './options-context'
 import { DynamicIcon } from './dynamic-icon'
+import { isNilUuid, normalizeNilUuid } from './nil-uuid'
 import type { TableMetadata, ColumnDefinition } from './types'
 import { isColumnVisibleInTable } from './column-visibility'
 import type {
@@ -328,7 +329,9 @@ export const resolveRelationLabel = (col: ColumnDefinition, row: any): string =>
             : undefined
     if (label !== undefined && label !== null && label !== '') return String(label)
     const raw = getNestedValue(row, col.key)
-    return raw !== undefined && raw !== null ? String(raw) : ''
+    // An unresolved FK that arrived as the nil UUID reads as empty, not zeros.
+    if (raw === undefined || raw === null || isNilUuid(raw)) return ''
+    return String(raw)
 }
 
 /**
@@ -476,7 +479,10 @@ export function makeDefaultGetDynamicColumns(
                         <DataTableColumnHeader column={column} title={translatedLabel} />
                     ),
                 cell: ({ row }) => {
-                    const value = getNestedValue(row.original, col.key)
+                    // Treat the nil UUID (unset nullable FK serialized as
+                    // all-zeros) as no value, so every type below hits its
+                    // existing empty branch instead of printing the zeros.
+                    const value = normalizeNilUuid(getNestedValue(row.original, col.key))
                     // Kernel emits the renderer flag as `type`; older hosts used
                     // `cellStyle`. Accept both so a single backend works across
                     // SDK versions.

package/src/index.ts

@@ -66,6 +66,7 @@ export {
     resolveRelationLabel,
     type DynamicColumnsHelpers,
 } from './dynamic-columns'
+export { NIL_UUID, isNilUuid, normalizeNilUuid } from './nil-uuid'
 export { DynamicRecordDialog } from './dialogs/dynamic-record'
 export { CreateRecordDialog } from './dialogs/create-record-dialog'
 export { ViewRecordDialog } from './dialogs/view-record-dialog'

package/src/nil-uuid.ts

@@ -0,0 +1,25 @@
+// Shared guard for the "nil UUID" — the all-zeros UUID Postgres/Go emit for a
+// nullable FK that was never set (`00000000-0000-0000-0000-000000000000`).
+// Backends sometimes serialize an unset `uuid` column as this sentinel instead
+// of `null`, which then leaks into the UI as a long string of zeros. Treat it
+// as "no value" so cell/detail renderers fall through to their existing empty
+// markers ("-" / "—"). Cosmetic defense-in-depth — the backend should emit null.
+
+/** The canonical nil/zero UUID sentinel. */
+export const NIL_UUID = '00000000-0000-0000-0000-000000000000'
+
+/**
+ * True when `value` is the nil UUID string. Tolerant of surrounding whitespace
+ * and letter-case (UUIDs are conventionally lowercase, but be defensive). Only
+ * matches strings — numeric/object values are never the nil UUID.
+ */
+export const isNilUuid = (value: unknown): boolean =>
+    typeof value === 'string' && value.trim().toLowerCase() === NIL_UUID
+
+/**
+ * Normalizes a raw cell value: returns `undefined` when it is the nil UUID so
+ * downstream renderers hit their existing nullish/empty branches; otherwise the
+ * value is passed through unchanged.
+ */
+export const normalizeNilUuid = <T>(value: T): T | undefined =>
+    isNilUuid(value) ? undefined : value