@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

package/dist/esm/core/enums/common-enum-registry.js

@@ -3,14 +3,13 @@
  *
  * Stores visual configuration for system enums. It does NOT wire words: an enum value is worded through
  * the `system_enums.<name>` block of the enum its FIELD declares (`.systemEnum(name)`), whether or not the
- * name was registered here (#966). Two mechanisms for visual config:
+ * name was registered here (#966). Visual config is stored in `COMMON_ENUM_DISPLAY_CONFIG` by enum name and
+ * reaches every field that declares the vocabulary through {@link resolveEnumDisplayConfig}.
  *
- * 1. **Schema-level** — when a schema field is provided, calls `.enumUI()`
- *    to mutate the field's metadata in place (same mechanism as `fields`).
- * 2. **Registry-level** — visual config is always stored in
- *    `COMMON_ENUM_DISPLAY_CONFIG` by enum name. This serves as a fallback for
- *    fields with `.systemEnum(name)` but no `.enumUI()` of their own
- *    (e.g., standalone enums like `AvailableLanguage`, `AvailableCountry`).
+ * There used to be a second, schema-level mechanism: given a field, registration called `.enumUI()` on it to
+ * mutate its metadata in place. A decorator returns a copy since #1308, and the registry has served every
+ * declaring field since #1321, so a field passed in is now CHECKED instead: it must declare the vocabulary it
+ * is registered under, or the registration would colour nothing.
  *
  * Registration is typically done at application startup, before React mounts:
  * - Built-in common enums registered by `registerBuiltinCommonEnums()` in presets
@@ -74,28 +73,22 @@ export function getCommonEnumDisplayConfig(name) {
  * - Wires NO words. `tResourceFieldEnumValue` reads `system_enums.<name>` only for the enum a field
  *   DECLARES (`.systemEnum(name)`, see `resolveResourceLabelSystemEnumName`). Registration used to add
  *   the name to a `SYSTEM_ENUM_NAMES` set the cascade walked by value; the walk and the set are gone (#966)
- * - If `displayConfig` is a plain object, stores it in `COMMON_ENUM_DISPLAY_CONFIG`
- *   for registry-level fallback
- * - If `schema` is also provided, calls `.enumUI()` on it (schema-level, highest priority)
+ * - Stores `displayConfig` in `COMMON_ENUM_DISPLAY_CONFIG`: a plain object as given, or an updater function
+ *   `(current) => next` applied to what is registered under the name so far.
+ * - If `schema` is provided, refuses it unless it DECLARES the vocabulary `name` (`.systemEnum(name)`, or an
+ *   exact framework vocabulary): that declaration is what makes the registered config reach the field. Nothing
+ *   is written to the schema.
  *
- * `displayConfig` accepts either:
- * - A **plain object** (deep-merged with existing metadata — restricted to
- *   `values`, `defaultColor`, `defaultIcon` for safety)
- * - A **`DecoratorUpdater` function** `(current) => newConfig` for full control
- *   when the restricted subset is not sufficient
- *
- * **Shared vs. independent metadata:** when a schema is provided, this function
- * mutates it directly. If the same enum field is reused across multiple resource
- * schemas, all share the same metadata. When a resource needs independent overrides,
- * use `z_clone()` from `@wildo-ai/zod-decorators` to create an independent copy.
+ * A field that needs its own colours, beyond the vocabulary's, declares `.enumUI()` on its own declaration;
+ * the field's config wins per key and per value.
  *
  * @param name - Unique enum name (e.g., `'SubscriptionStatus'`, `'AvailableLanguage'`)
- * @param schema - Optional Zod schema field to apply visual config to (e.g., `Shape.status`)
- * @param displayConfig - Visual config: plain object (deep-merged) or updater function (full replacement)
+ * @param schema - Optional field the registration is FOR, checked to declare `name` (e.g., `Shape.status`)
+ * @param displayConfig - Visual config: plain object, or an updater of the registered one
  *
  * @example
  * ```ts
- * // With schema field — applies to schema AND stores in registry
+ * // With a field: checked to declare `.systemEnum('SubscriptionStatus')`, and the config stored by name
  * const shape = getZodObjectShape(SubscriptionSchema);
  * registerCommonEnum('SubscriptionStatus', shape.status, {
  *   values: { active: { color: 'success' }, cancelled: { color: 'destructive' } },
@@ -109,13 +102,17 @@ export function getCommonEnumDisplayConfig(name) {
  * ```
  */
 export function registerCommonEnum(name, schema, displayConfig) {
-    if (displayConfig) {
-        if (typeof displayConfig !== 'function') {
-            COMMON_ENUM_DISPLAY_CONFIG.set(name, displayConfig);
-        }
-        if (schema) {
-            schema.enumUI(displayConfig);
+    if (schema) {
+        const enumSchema = resolveFieldEnumSchema(schema);
+        const declared = enumSchema ? resolveDeclaredSystemEnumName(enumSchema, getEnumValues(enumSchema)) : undefined;
+        if (declared !== name) {
+            throw new Error(`registerCommonEnum('${name}'): the field passed in declares ${declared ? `the vocabulary '${declared}'` : 'no vocabulary'}, `
+                + `so the registered display would never reach it. Declare \`.systemEnum('${name}')\` on the field, or register without the field.`);
         }
     }
+    if (displayConfig) {
+        const next = typeof displayConfig === 'function' ? displayConfig(COMMON_ENUM_DISPLAY_CONFIG.get(name)) : displayConfig;
+        COMMON_ENUM_DISPLAY_CONFIG.set(name, next);
+    }
 }
 //# sourceMappingURL=common-enum-registry.js.map

package/dist/esm/core/enums/common-enum-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"common-enum-registry.js","sourceRoot":"","sources":["../../../../../src/core/enums/common-enum-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAU5G;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEpF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAoB;IAC3D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,6BAA6B,CAAC,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,IAAI,CAAC,UAAU;QAAE,OAAO,QAAQ,CAAC;IACjC,IAAI,CAAC,QAAQ;QAAE,OAAO,UAAU,CAAC;IACjC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/G,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,OAAO,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,MAAqB,EACrB,aAAuE;IAEvE,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;YACxC,0BAA0B,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACV,MAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["/**\n * Common enum registration.\n *\n * Stores visual configuration for system enums. It does NOT wire words: an enum value is worded through\n * the `system_enums.<name>` block of the enum its FIELD declares (`.systemEnum(name)`), whether or not the\n * name was registered here (#966). Two mechanisms for visual config:\n *\n * 1. **Schema-level** — when a schema field is provided, calls `.enumUI()`\n *    to mutate the field's metadata in place (same mechanism as `fields`).\n * 2. **Registry-level** — visual config is always stored in\n *    `COMMON_ENUM_DISPLAY_CONFIG` by enum name. This serves as a fallback for\n *    fields with `.systemEnum(name)` but no `.enumUI()` of their own\n *    (e.g., standalone enums like `AvailableLanguage`, `AvailableCountry`).\n *\n * Registration is typically done at application startup, before React mounts:\n * - Built-in common enums registered by `registerBuiltinCommonEnums()` in presets\n * - App-specific common enums registered in `App.tsx` or equivalent\n */\n\nimport type { z } from 'zod';\nimport { getEnumUI, getEnumValues } from '@wildo-ai/zod-decorators';\nimport type { DecoratorUpdater, EnumUIParams } from '@wildo-ai/zod-decorators';\nimport { resolveDeclaredSystemEnumName, resolveFieldEnumSchema } from '@wildo-ai/presets-components-models';\n\n/**\n * Subset of enum-UI params appropriate for common enum registration: per-value\n * colors/icons (`values`), the color/icon defaults, and `display` (so a common enum\n * can opt into `displayMode: BADGE`/`ICON` — without it, `DisplayFieldEnum` defaults to\n * `TEXT`, which renders neither the registered colors nor icons).\n */\ntype CommonEnumVisualConfig = Pick<EnumUIParams, 'values' | 'defaultColor' | 'defaultIcon' | 'display'>;\n\n/**\n * Registry-level visual config for common enums, keyed by enum name.\n *\n * Used as a fallback when a schema field has `.systemEnum(name)` but no\n * field-level `.enumUI()`. Populated by `registerCommonEnum()`.\n *\n * Priority chain at render time — implemented by {@link resolveEnumDisplayConfig}, which every\n * enum reader goes through:\n * 1. Field-level `.enumUI()` metadata (highest)\n * 2. This registry by `.systemEnum()` name (fallback)\n * 3. Default rendering (no config)\n *\n * That chain was DOCUMENTED here and implemented nowhere until 2026-09-20 (#1321): no renderer\n * read this map, so a registry-only registration coloured nothing and every vocabulary that wanted\n * a colour had to be decorated again at each field that carried it — three copies of one run-status\n * map in the creation workbench alone.\n */\nexport const COMMON_ENUM_DISPLAY_CONFIG = new Map<string, CommonEnumVisualConfig>();\n\n/**\n * The enum-UI params a field RENDERS with: its own `.enumUI()` metadata over the registry-level\n * config of the vocabulary it declares (`.systemEnum(name)`, or an exact framework vocabulary).\n *\n * Read this, never `getEnumUI` directly, wherever a colour, an icon or a display mode is resolved\n * for an enum value — the display formatter, the form controls, the chart colour bridge. It is what\n * makes \"register the vocabulary once\" true: a status field that declares `FlowsActors_Status` gets\n * that vocabulary's badge treatment on every resource that carries it, with nothing decorated at the\n * field.\n *\n * Merge is per key with the field winning, and per VALUE inside `values`, so a field may override\n * one member's colour without restating the rest of the map.\n */\nexport function resolveEnumDisplayConfig(schema: z.ZodTypeAny): EnumUIParams | undefined {\n  const declared = getEnumUI(schema);\n  const enumSchema = resolveFieldEnumSchema(schema);\n  const name = enumSchema ? resolveDeclaredSystemEnumName(enumSchema, getEnumValues(enumSchema)) : undefined;\n  const registered = name ? COMMON_ENUM_DISPLAY_CONFIG.get(name) : undefined;\n  if (!registered) return declared;\n  if (!declared) return registered;\n  const values = registered.values || declared.values ? { ...registered.values, ...declared.values } : undefined;\n  return { ...registered, ...declared, ...(values ? { values } : {}) };\n}\n\n/**\n * Get visual display config for a system enum by name.\n * Returns `undefined` if the enum has no registered visual config.\n */\nexport function getCommonEnumDisplayConfig(name: string): CommonEnumVisualConfig | undefined {\n  return COMMON_ENUM_DISPLAY_CONFIG.get(name);\n}\n\n/**\n * Register a common enum's visual display config.\n *\n * - Wires NO words. `tResourceFieldEnumValue` reads `system_enums.<name>` only for the enum a field\n *   DECLARES (`.systemEnum(name)`, see `resolveResourceLabelSystemEnumName`). Registration used to add\n *   the name to a `SYSTEM_ENUM_NAMES` set the cascade walked by value; the walk and the set are gone (#966)\n * - If `displayConfig` is a plain object, stores it in `COMMON_ENUM_DISPLAY_CONFIG`\n *   for registry-level fallback\n * - If `schema` is also provided, calls `.enumUI()` on it (schema-level, highest priority)\n *\n * `displayConfig` accepts either:\n * - A **plain object** (deep-merged with existing metadata — restricted to\n *   `values`, `defaultColor`, `defaultIcon` for safety)\n * - A **`DecoratorUpdater` function** `(current) => newConfig` for full control\n *   when the restricted subset is not sufficient\n *\n * **Shared vs. independent metadata:** when a schema is provided, this function\n * mutates it directly. If the same enum field is reused across multiple resource\n * schemas, all share the same metadata. When a resource needs independent overrides,\n * use `z_clone()` from `@wildo-ai/zod-decorators` to create an independent copy.\n *\n * @param name - Unique enum name (e.g., `'SubscriptionStatus'`, `'AvailableLanguage'`)\n * @param schema - Optional Zod schema field to apply visual config to (e.g., `Shape.status`)\n * @param displayConfig - Visual config: plain object (deep-merged) or updater function (full replacement)\n *\n * @example\n * ```ts\n * // With schema field — applies to schema AND stores in registry\n * const shape = getZodObjectShape(SubscriptionSchema);\n * registerCommonEnum('SubscriptionStatus', shape.status, {\n *   values: { active: { color: 'success' }, cancelled: { color: 'destructive' } },\n *   defaultColor: 'secondary',\n * });\n *\n * // Without schema field — registry-only (for standalone enums)\n * registerCommonEnum('AvailableLanguage', undefined, {\n *   values: { en: { icon: '🇺🇸' }, fr: { icon: '🇫🇷' } },\n * });\n * ```\n */\nexport function registerCommonEnum(\n  name: string,\n  schema?: z.ZodTypeAny,\n  displayConfig?: CommonEnumVisualConfig | DecoratorUpdater<EnumUIParams>,\n): void {\n  if (displayConfig) {\n    if (typeof displayConfig !== 'function') {\n      COMMON_ENUM_DISPLAY_CONFIG.set(name, displayConfig);\n    }\n    if (schema) {\n      (schema as any).enumUI(displayConfig);\n    }\n  }\n}\n"]}
+{"version":3,"file":"common-enum-registry.js","sourceRoot":"","sources":["../../../../../src/core/enums/common-enum-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAU5G;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEpF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAoB;IAC3D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,6BAA6B,CAAC,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,IAAI,CAAC,UAAU;QAAE,OAAO,QAAQ,CAAC;IACjC,IAAI,CAAC,QAAQ;QAAE,OAAO,UAAU,CAAC;IACjC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/G,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,OAAO,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,MAAqB,EACrB,aAAuE;IAEvE,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,UAAU,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,6BAA6B,CAAC,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/G,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,uBAAuB,IAAI,oCAAoC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,QAAQ,GAAG,CAAC,CAAC,CAAC,eAAe,IAAI;kBAC5H,0EAA0E,IAAI,mDAAmD,CACpI,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QACvH,0BAA0B,CAAC,GAAG,CAAC,IAAI,EAAE,IAA8B,CAAC,CAAC;IACvE,CAAC;AACH,CAAC","sourcesContent":["/**\n * Common enum registration.\n *\n * Stores visual configuration for system enums. It does NOT wire words: an enum value is worded through\n * the `system_enums.<name>` block of the enum its FIELD declares (`.systemEnum(name)`), whether or not the\n * name was registered here (#966). Visual config is stored in `COMMON_ENUM_DISPLAY_CONFIG` by enum name and\n * reaches every field that declares the vocabulary through {@link resolveEnumDisplayConfig}.\n *\n * There used to be a second, schema-level mechanism: given a field, registration called `.enumUI()` on it to\n * mutate its metadata in place. A decorator returns a copy since #1308, and the registry has served every\n * declaring field since #1321, so a field passed in is now CHECKED instead: it must declare the vocabulary it\n * is registered under, or the registration would colour nothing.\n *\n * Registration is typically done at application startup, before React mounts:\n * - Built-in common enums registered by `registerBuiltinCommonEnums()` in presets\n * - App-specific common enums registered in `App.tsx` or equivalent\n */\n\nimport type { z } from 'zod';\nimport { getEnumUI, getEnumValues } from '@wildo-ai/zod-decorators';\nimport type { DecoratorUpdater, EnumUIParams } from '@wildo-ai/zod-decorators';\nimport { resolveDeclaredSystemEnumName, resolveFieldEnumSchema } from '@wildo-ai/presets-components-models';\n\n/**\n * Subset of enum-UI params appropriate for common enum registration: per-value\n * colors/icons (`values`), the color/icon defaults, and `display` (so a common enum\n * can opt into `displayMode: BADGE`/`ICON` — without it, `DisplayFieldEnum` defaults to\n * `TEXT`, which renders neither the registered colors nor icons).\n */\ntype CommonEnumVisualConfig = Pick<EnumUIParams, 'values' | 'defaultColor' | 'defaultIcon' | 'display'>;\n\n/**\n * Registry-level visual config for common enums, keyed by enum name.\n *\n * Used as a fallback when a schema field has `.systemEnum(name)` but no\n * field-level `.enumUI()`. Populated by `registerCommonEnum()`.\n *\n * Priority chain at render time — implemented by {@link resolveEnumDisplayConfig}, which every\n * enum reader goes through:\n * 1. Field-level `.enumUI()` metadata (highest)\n * 2. This registry by `.systemEnum()` name (fallback)\n * 3. Default rendering (no config)\n *\n * That chain was DOCUMENTED here and implemented nowhere until 2026-09-20 (#1321): no renderer\n * read this map, so a registry-only registration coloured nothing and every vocabulary that wanted\n * a colour had to be decorated again at each field that carried it — three copies of one run-status\n * map in the creation workbench alone.\n */\nexport const COMMON_ENUM_DISPLAY_CONFIG = new Map<string, CommonEnumVisualConfig>();\n\n/**\n * The enum-UI params a field RENDERS with: its own `.enumUI()` metadata over the registry-level\n * config of the vocabulary it declares (`.systemEnum(name)`, or an exact framework vocabulary).\n *\n * Read this, never `getEnumUI` directly, wherever a colour, an icon or a display mode is resolved\n * for an enum value — the display formatter, the form controls, the chart colour bridge. It is what\n * makes \"register the vocabulary once\" true: a status field that declares `FlowsActors_Status` gets\n * that vocabulary's badge treatment on every resource that carries it, with nothing decorated at the\n * field.\n *\n * Merge is per key with the field winning, and per VALUE inside `values`, so a field may override\n * one member's colour without restating the rest of the map.\n */\nexport function resolveEnumDisplayConfig(schema: z.ZodTypeAny): EnumUIParams | undefined {\n  const declared = getEnumUI(schema);\n  const enumSchema = resolveFieldEnumSchema(schema);\n  const name = enumSchema ? resolveDeclaredSystemEnumName(enumSchema, getEnumValues(enumSchema)) : undefined;\n  const registered = name ? COMMON_ENUM_DISPLAY_CONFIG.get(name) : undefined;\n  if (!registered) return declared;\n  if (!declared) return registered;\n  const values = registered.values || declared.values ? { ...registered.values, ...declared.values } : undefined;\n  return { ...registered, ...declared, ...(values ? { values } : {}) };\n}\n\n/**\n * Get visual display config for a system enum by name.\n * Returns `undefined` if the enum has no registered visual config.\n */\nexport function getCommonEnumDisplayConfig(name: string): CommonEnumVisualConfig | undefined {\n  return COMMON_ENUM_DISPLAY_CONFIG.get(name);\n}\n\n/**\n * Register a common enum's visual display config.\n *\n * - Wires NO words. `tResourceFieldEnumValue` reads `system_enums.<name>` only for the enum a field\n *   DECLARES (`.systemEnum(name)`, see `resolveResourceLabelSystemEnumName`). Registration used to add\n *   the name to a `SYSTEM_ENUM_NAMES` set the cascade walked by value; the walk and the set are gone (#966)\n * - Stores `displayConfig` in `COMMON_ENUM_DISPLAY_CONFIG`: a plain object as given, or an updater function\n *   `(current) => next` applied to what is registered under the name so far.\n * - If `schema` is provided, refuses it unless it DECLARES the vocabulary `name` (`.systemEnum(name)`, or an\n *   exact framework vocabulary): that declaration is what makes the registered config reach the field. Nothing\n *   is written to the schema.\n *\n * A field that needs its own colours, beyond the vocabulary's, declares `.enumUI()` on its own declaration;\n * the field's config wins per key and per value.\n *\n * @param name - Unique enum name (e.g., `'SubscriptionStatus'`, `'AvailableLanguage'`)\n * @param schema - Optional field the registration is FOR, checked to declare `name` (e.g., `Shape.status`)\n * @param displayConfig - Visual config: plain object, or an updater of the registered one\n *\n * @example\n * ```ts\n * // With a field: checked to declare `.systemEnum('SubscriptionStatus')`, and the config stored by name\n * const shape = getZodObjectShape(SubscriptionSchema);\n * registerCommonEnum('SubscriptionStatus', shape.status, {\n *   values: { active: { color: 'success' }, cancelled: { color: 'destructive' } },\n *   defaultColor: 'secondary',\n * });\n *\n * // Without schema field — registry-only (for standalone enums)\n * registerCommonEnum('AvailableLanguage', undefined, {\n *   values: { en: { icon: '🇺🇸' }, fr: { icon: '🇫🇷' } },\n * });\n * ```\n */\nexport function registerCommonEnum(\n  name: string,\n  schema?: z.ZodTypeAny,\n  displayConfig?: CommonEnumVisualConfig | DecoratorUpdater<EnumUIParams>,\n): void {\n  if (schema) {\n    const enumSchema = resolveFieldEnumSchema(schema);\n    const declared = enumSchema ? resolveDeclaredSystemEnumName(enumSchema, getEnumValues(enumSchema)) : undefined;\n    if (declared !== name) {\n      throw new Error(\n        `registerCommonEnum('${name}'): the field passed in declares ${declared ? `the vocabulary '${declared}'` : 'no vocabulary'}, `\n        + `so the registered display would never reach it. Declare \\`.systemEnum('${name}')\\` on the field, or register without the field.`,\n      );\n    }\n  }\n  if (displayConfig) {\n    const next = typeof displayConfig === 'function' ? displayConfig(COMMON_ENUM_DISPLAY_CONFIG.get(name)) : displayConfig;\n    COMMON_ENUM_DISPLAY_CONFIG.set(name, next as CommonEnumVisualConfig);\n  }\n}\n"]}

package/dist/esm/core/errors/GlobalErrorHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalErrorHandler.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/GlobalErrorHandler.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiBH,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAyBpE;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,GACR,EAAE,uBAAuB,GAAG,IAAI,CAyMhC;AAED,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"GlobalErrorHandler.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/GlobalErrorHandler.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkBH,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AA6BpE;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,GACR,EAAE,uBAAuB,GAAG,IAAI,CAsQhC;AAED,eAAe,kBAAkB,CAAC"}

package/dist/esm/core/errors/GlobalErrorHandler.js

@@ -14,14 +14,18 @@
 import { useEffect, useCallback, useRef } from 'react';
 import { ErrorActionFrontend, ERROR_DEFINITIONS, ErrorSeverity, } from '@wildo-ai/saas-models';
 import { useEventBus } from '../../core/events/useEventBus.js';
-import { FrontendEvents, SessionEndReason } from '../../core/events/events.frontend.schemas.js';
+import { FrontendEvents } from '../../core/events/events.frontend.schemas.js';
+import { sessionEndReasonForRefusal } from '../../core/requests/auth-refresh-resilience.frontend.js';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
 import { useError } from './useError.js';
 import { useAuthSession } from '../../core/security/useAuthSession.js';
 import { useNotification } from '../../core/events/useNotification.js';
 import { useI18n } from '../../core/i18n/useI18n.js';
 import { errorManagement } from './error-management.frontend.service.js';
+import { LabellingTypes } from '@wildo-ai/presets-components-models';
 import { resolveUserFacingErrorMessage } from './user-facing-error-message.frontend.utils.js';
+/** How long a toast raised before the error words settle waits for them (#2542). */
+const ERROR_WORDS_WAIT_MS = 4000;
 const logger = LoggerFrontendService.getLogger();
 const logDebug = logger.debugByType('GlobalErrorHandler');
 logger.setDebugTypeLogging('GlobalErrorHandler', false);
@@ -53,7 +57,7 @@ function severityToNotificationType(severity) {
 export function GlobalErrorHandler({ onError, }) {
     const { on } = useEventBus();
     const { handleWildoError } = useError();
-    const { endSession, isAuthenticated } = useAuthSession();
+    const { endSession, isAuthenticated, getEndedSessionReason } = useAuthSession();
     const { notifyError, notifyWarning, notifyInfo } = useNotification();
     // Resolvers for backend error references and guidance → localized human messages. No deps
     // requested: `errors_*` sections load eagerly, so this only borrows the resolvers.
@@ -64,9 +68,24 @@ export function GlobalErrorHandler({ onError, }) {
     // `handleErrorEvent` → the `ERROR_OCCURED` subscription effect, re-subscribing
     // the global handler on every i18n render. The ref keeps those callbacks (and the
     // subscription) stable while always reading the latest resolvers.
-    const { tErrorMessage, tErrorGuidance } = useI18n();
+    const { tErrorMessage, tErrorGuidance, isKeySettled } = useI18n();
     const translatorsRef = useRef({ tErrorMessage, tErrorGuidance });
     translatorsRef.current = { tErrorMessage, tErrorGuidance };
+    /**
+     * Whether the error words can be read yet (#2542). `errors_*` load eagerly, but "eagerly" is still a request: an
+     * error raised while the app is booting (a restored session refused before the first labels land) used to be
+     * resolved at that instant, so even the default label rendered as its key path, `errors_messages.default.msg`,
+     * and the toast kept that text. A toast raised before the words settle now waits for them.
+     *
+     * Bounded, because a FAILED eager load clears its keys without marking them settled: past
+     * {@link ERROR_WORDS_WAIT_MS} the held toasts are shown with whatever resolves, which is the key path a missing
+     * label must look like, rather than never.
+     */
+    const errorWordsSettled = isKeySettled(LabellingTypes.ERRORS_MESSAGES);
+    const errorWordsSettledRef = useRef(errorWordsSettled);
+    errorWordsSettledRef.current = errorWordsSettled;
+    const heldErrorsRef = useRef([]);
+    const heldErrorsTimerRef = useRef(null);
     /**
      * Tear down the AuthSession in response to a `triggerLogout` error.
      *
@@ -75,11 +94,12 @@ export function GlobalErrorHandler({ onError, }) {
      * Fires for ANY error flagged `triggerLogout`, not only AUTHENTICATION-typed
      * ones — see the gate in handleErrorEvent.
      */
-    const handleForcedLogout = useCallback(() => {
+    const handleForcedLogout = useCallback((wildoError) => {
         if (isAuthenticated()) {
             logDebug('triggerLogout requested - logging out via AuthSession');
-            // The backend refused the session; the person did not sign out, so `USER_LOGOUT` says so (#1977).
-            endSession(SessionEndReason.SESSION_ENDED);
+            // The backend refused the session; the person did not sign out, so `USER_LOGOUT` says so (#1977), and why,
+            // when the refusal names it (#2541).
+            endSession(sessionEndReasonForRefusal(wildoError));
         }
         else {
             logDebug('triggerLogout requested but not authenticated - skipping logout');
@@ -89,7 +109,7 @@ export function GlobalErrorHandler({ onError, }) {
      * Show error notification via NotificationContext
      * Uses policy-driven display (toast + optional notification center)
      */
-    const showErrorNotification = useCallback((wildoError) => {
+    const displayErrorNotification = useCallback((wildoError) => {
         const errorDefinition = ERROR_DEFINITIONS[wildoError.type];
         const severity = wildoError.severity || errorDefinition?.severity || ErrorSeverity.MEDIUM;
         // The global toast speaks for no particular surface, so no surface words are passed: a generic
@@ -122,6 +142,35 @@ export function GlobalErrorHandler({ onError, }) {
             message,
         });
     }, [notifyError, notifyWarning, notifyInfo]);
+    const flushHeldErrorNotifications = useCallback(() => {
+        if (heldErrorsTimerRef.current) {
+            clearTimeout(heldErrorsTimerRef.current);
+            heldErrorsTimerRef.current = null;
+        }
+        const held = heldErrorsRef.current;
+        heldErrorsRef.current = [];
+        for (const wildoError of held)
+            displayErrorNotification(wildoError);
+    }, [displayErrorNotification]);
+    /** Show now when the error words are readable, else hold until they are (#2542). */
+    const showErrorNotification = useCallback((wildoError) => {
+        if (errorWordsSettledRef.current) {
+            displayErrorNotification(wildoError);
+            return;
+        }
+        heldErrorsRef.current.push(wildoError);
+        heldErrorsTimerRef.current ??= setTimeout(flushHeldErrorNotifications, ERROR_WORDS_WAIT_MS);
+    }, [displayErrorNotification, flushHeldErrorNotifications]);
+    useEffect(() => {
+        if (errorWordsSettled && heldErrorsRef.current.length > 0)
+            flushHeldErrorNotifications();
+    }, [errorWordsSettled, flushHeldErrorNotifications]);
+    useEffect(() => () => {
+        if (heldErrorsTimerRef.current)
+            clearTimeout(heldErrorsTimerRef.current);
+        // Reset, or a remount (React StrictMode) would see a timer that no longer exists and never arm a new one.
+        heldErrorsTimerRef.current = null;
+    }, []);
     /**
      * Handle ERROR_OCCURED event
      *
@@ -156,7 +205,7 @@ export function GlobalErrorHandler({ onError, }) {
         // Handle logout via AuthSession if needed (before delegating to ErrorContext)
         if (shouldTriggerLogout) {
             logDebug('triggerLogout=true - calling AuthSession logout handler');
-            handleForcedLogout();
+            handleForcedLogout(wildoError);
             // Remove DISCONNECT action from frontendActions since we already handled logout
             const frontendActions = (wildoError.frontendActions || []);
             if (frontendActions.includes(ErrorActionFrontend.DISCONNECT)) {
@@ -201,6 +250,19 @@ export function GlobalErrorHandler({ onError, }) {
                     && action !== ErrorActionFrontend.SHOW_MODAL),
             };
         }
+        else if (shouldTriggerLogout && getEndedSessionReason() !== null) {
+            // The sign-in page says why the session ended (#2541), so the request that discovered it raises no toast of
+            // its own: a generic "something went wrong" there contradicts the notice. Asked AFTER the logout above, and of
+            // the session rather than of this call: in production the refresh handler usually ended the session a beat
+            // earlier, so this handler found nobody signed in, and the notice is already there. When no backend-ended
+            // session is being explained (a public page's 401), the toast stays. Display actions only; REDIRECT still runs.
+            errorForDelegation = {
+                ...wildoError,
+                frontendActions: frontendActions.filter(action => action !== ErrorActionFrontend.NOTIFY
+                    && action !== ErrorActionFrontend.SHOW_TOAST
+                    && action !== ErrorActionFrontend.SHOW_MODAL),
+            };
+        }
         else if (shouldShowNotification && hasNotifyAction) {
             showErrorNotification(wildoError);
             errorForDelegation = {
@@ -215,7 +277,7 @@ export function GlobalErrorHandler({ onError, }) {
         // Delegate to ErrorContext for other frontend actions (REDIRECT, SHOW_MODAL, etc.)
         // Note: We've already handled NOTIFY above via NotificationContext
         handleWildoError(errorForDelegation);
-    }, [handleWildoError, onError, handleForcedLogout, showErrorNotification]);
+    }, [handleWildoError, onError, handleForcedLogout, showErrorNotification, getEndedSessionReason]);
     // Subscribe to ERROR_OCCURED events
     useEffect(() => {
         logDebug('Subscribing to ERROR_OCCURED events', {

package/dist/esm/core/errors/GlobalErrorHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalErrorHandler.js","sourceRoot":"","sources":["../../../../../src/core/errors/GlobalErrorHandler.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Global Error Handler\n * \n * Subscribes to ERROR_OCCURED events from the event bus and executes\n * frontend actions based on the error configuration.\n * \n * This component integrates with:\n * - AuthSession: For authentication error handling (logout)\n * - NotificationContext: For toast and notification center display\n * - ErrorContext: For other frontend actions (REDIRECT, SHOW_MODAL, etc.)\n * \n * Must be rendered inside AuthSessionProvider and NotificationProvider.\n */\n\nimport { useEffect, useCallback, useRef } from 'react';\nimport {\n  ErrorActionFrontend,\n  WildoError_Frontend,\n  ERROR_DEFINITIONS,\n  ErrorSeverity,\n} from '@wildo-ai/saas-models';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents, FrontendEventErrorOccured, SessionEndReason } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { useError } from './useError';\nimport { useAuthSession } from '~wildo-frontend-lib/core/security/useAuthSession';\nimport { useNotification } from '~wildo-frontend-lib/core/events/useNotification';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { errorManagement } from './error-management.frontend.service';\nimport { GlobalErrorHandlerProps } from './errors.frontend.schemas';\nimport { NotificationType } from '~wildo-frontend-lib/core/events/NotificationContext';\nimport { resolveUserFacingErrorMessage, type ErrorMessageTranslators } from './user-facing-error-message.frontend.utils';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('GlobalErrorHandler');\nlogger.setDebugTypeLogging('GlobalErrorHandler', false);\n\n/**\n * Map error severity to notification type\n */\nfunction severityToNotificationType(severity: ErrorSeverity): NotificationType {\n  switch (severity) {\n    case ErrorSeverity.CRITICAL:\n    case ErrorSeverity.HIGH:\n      return 'error';\n    case ErrorSeverity.MEDIUM:\n      return 'warning';\n    case ErrorSeverity.LOW:\n      return 'info';\n    default:\n      return 'error';\n  }\n}\n\n/**\n * Global Error Handler Component\n * \n * Subscribes to ERROR_OCCURED events and executes frontend actions.\n * Integrates with AuthSession for authentication error handling (logout).\n * Delegates notification display to NotificationContext.\n * \n * Should be rendered once, inside the AuthSessionProvider and NotificationProvider.\n */\nexport function GlobalErrorHandler({\n  onError,\n}: GlobalErrorHandlerProps): null {\n  const { on } = useEventBus();\n  const { handleWildoError } = useError();\n  const { endSession, isAuthenticated } = useAuthSession();\n  const { notifyError, notifyWarning, notifyInfo } = useNotification();\n  // Resolvers for backend error references and guidance → localized human messages. No deps\n  // requested: `errors_*` sections load eagerly, so this only borrows the resolvers.\n  //\n  // Held in a ref: `tErrorMessage` (and the whole I18n context value) is NOT\n  // memoized, so a new identity is produced on every I18nProvider render. Using it\n  // directly as a `useCallback` dep would ripple through `showErrorNotification` →\n  // `handleErrorEvent` → the `ERROR_OCCURED` subscription effect, re-subscribing\n  // the global handler on every i18n render. The ref keeps those callbacks (and the\n  // subscription) stable while always reading the latest resolvers.\n  const { tErrorMessage, tErrorGuidance } = useI18n();\n  const translatorsRef = useRef<ErrorMessageTranslators>({ tErrorMessage, tErrorGuidance });\n  translatorsRef.current = { tErrorMessage, tErrorGuidance };\n  \n  /**\n   * Tear down the AuthSession in response to a `triggerLogout` error.\n   *\n   * Only logs out when currently authenticated, to avoid a redundant logout\n   * (e.g. when the token-refresh interceptor already logged the session out).\n   * Fires for ANY error flagged `triggerLogout`, not only AUTHENTICATION-typed\n   * ones — see the gate in handleErrorEvent.\n   */\n  const handleForcedLogout = useCallback(() => {\n    if (isAuthenticated()) {\n      logDebug('triggerLogout requested - logging out via AuthSession');\n      // The backend refused the session; the person did not sign out, so `USER_LOGOUT` says so (#1977).\n      endSession(SessionEndReason.SESSION_ENDED);\n    } else {\n      logDebug('triggerLogout requested but not authenticated - skipping logout');\n    }\n  }, [endSession, isAuthenticated]);\n  \n  /**\n   * Show error notification via NotificationContext\n   * Uses policy-driven display (toast + optional notification center)\n   */\n  const showErrorNotification = useCallback((wildoError: WildoError_Frontend) => {\n    const errorDefinition = ERROR_DEFINITIONS[wildoError.type];\n    const severity = (wildoError as any).severity || errorDefinition?.severity || ErrorSeverity.MEDIUM;\n    // The global toast speaks for no particular surface, so no surface words are passed: a generic\n    // bucket shows its own label. Server `context.message` / `originalMessage` and the raw reference\n    // are never shown — an unresolvable message falls to the default label, or to its key path when\n    // even that is unauthored (see `resolveUserFacingErrorMessage`).\n    const message = resolveUserFacingErrorMessage(wildoError, { translators: translatorsRef.current });\n    const notificationType = severityToNotificationType(severity);\n    \n    // Use appropriate notification method based on severity\n    const notificationData = {\n      errorType: wildoError.type,\n      severity,\n      context: wildoError.context,\n    };\n    \n    switch (notificationType) {\n      case 'error':\n        notifyError(message, { data: notificationData });\n        break;\n      case 'warning':\n        notifyWarning(message, { data: notificationData });\n        break;\n      case 'info':\n        notifyInfo(message, { data: notificationData });\n        break;\n    }\n    \n    logDebug('Error notification displayed via NotificationContext', {\n      errorType: wildoError.type,\n      severity,\n      notificationType,\n      message,\n    });\n  }, [notifyError, notifyWarning, notifyInfo]);\n  \n  /**\n   * Handle ERROR_OCCURED event\n   *\n   * Delegates to ErrorContext.handleWildoError for action execution, but intercepts\n   * any error flagged `triggerLogout` to tear down the session via the AuthSession\n   * `logout()` callback instead of the DISCONNECT window-event fallback.\n   */\n  const handleErrorEvent = useCallback((payload: FrontendEventErrorOccured) => {\n    let wildoError: WildoError_Frontend = payload.error;\n\n    logDebug('Received ERROR_OCCURED event', {\n      errorType: wildoError.type,\n      customMessageReference: wildoError.customMessageReference,\n      triggerLogout: wildoError.triggerLogout,\n    });\n    \n    // Check for duplicate errors using deduplication service\n    if (errorManagement.shouldSuppress(wildoError)) {\n      logDebug('Error suppressed (duplicate)', {\n        errorType: wildoError.type,\n        customMessageReference: wildoError.customMessageReference,\n      });\n      return; // Don't process duplicate\n    }\n    \n    // `triggerLogout` is the authoritative \"force a logout\" signal (set by the HTTP\n    // error-behavior matrix, e.g. a 401 invalid session). It drives the AuthSession\n    // logout on its own — deliberately NOT additionally gated on\n    // `type === AUTHENTICATION`. The error's `type` is taken from the backend payload\n    // (`backendErrorType || behavior.errorType` in buildWildoError), so a 401 whose\n    // backend type is not AUTHENTICATION would still carry triggerLogout=true; an extra\n    // type gate would silently swallow that logout. Mirrors `handleHttpError`'s\n    // `shouldLogout`, which is also triggerLogout-only.\n    const shouldTriggerLogout = wildoError.triggerLogout === true;\n\n    // Handle logout via AuthSession if needed (before delegating to ErrorContext)\n    if (shouldTriggerLogout) {\n      logDebug('triggerLogout=true - calling AuthSession logout handler');\n      handleForcedLogout();\n      \n      // Remove DISCONNECT action from frontendActions since we already handled logout\n      const frontendActions = (wildoError.frontendActions || []) as ErrorActionFrontend[];\n      if (frontendActions.includes(ErrorActionFrontend.DISCONNECT)) {\n        wildoError = {\n          ...wildoError,\n          frontendActions: frontendActions.filter(a => a !== ErrorActionFrontend.DISCONNECT),\n        };\n      }\n    }\n    \n    // Log error for analytics/debugging\n    logDebug('Error occurred', {\n      errorType: wildoError.type,\n      customMessageReference: wildoError.customMessageReference,\n    });\n    \n    // `suppressUserDisplay` (set when the originating request was `silent`) means\n    // the CALLER owns the user-facing error UX — e.g. a resource form already shows\n    // NOTIFY_RESOURCE_ERROR + inline field errors. In that case strip ALL display\n    // actions (toast + modal) so the global handler never double-surfaces the error,\n    // while still running the side-effect actions below (REDIRECT, DISCONNECT) and\n    // the auth-logout handled earlier. This is what lets a silent resource mutation\n    // log out on 401 without raising a duplicate global toast.\n    //\n    // INVARIANT (load-bearing): we deliberately KEEP REDIRECT/DISCONNECT here, so the\n    // \"silent\" contract relies on HTTP_ERROR_BEHAVIOR_MATRIX never placing those two\n    // actions at a risk level a silent caller can reach (today the matrix only adds\n    // REDIRECT at HIGH/CRITICAL, and silent callers are autosave / RMM-fallback /\n    // guidance / uniqueness — MEDIUM-or-lower). If you add REDIRECT/DISCONNECT at a\n    // lower risk, OR via `setHttpErrorBehaviorOverride`, a silent background op would\n    // navigate/disconnect with NO visible toast to explain it — add those to the\n    // strip list here if that ever changes.\n    const suppressUserDisplay = (wildoError as any).suppressUserDisplay === true;\n    const shouldShowNotification = !suppressUserDisplay && (wildoError as any).showToUser !== false;\n    const frontendActions = (wildoError.frontendActions || []) as ErrorActionFrontend[];\n    const hasNotifyAction = frontendActions.includes(ErrorActionFrontend.NOTIFY)\n      || frontendActions.includes(ErrorActionFrontend.SHOW_TOAST);\n\n    let errorForDelegation = wildoError;\n    if (suppressUserDisplay) {\n      errorForDelegation = {\n        ...wildoError,\n        frontendActions: frontendActions.filter(\n          action => action !== ErrorActionFrontend.NOTIFY\n            && action !== ErrorActionFrontend.SHOW_TOAST\n            && action !== ErrorActionFrontend.SHOW_MODAL,\n        ),\n      };\n    } else if (shouldShowNotification && hasNotifyAction) {\n      showErrorNotification(wildoError);\n      errorForDelegation = {\n        ...wildoError,\n        frontendActions: frontendActions.filter(\n          action => action !== ErrorActionFrontend.NOTIFY && action !== ErrorActionFrontend.SHOW_TOAST,\n        ),\n      };\n    }\n    \n    // Call custom error handler if provided\n    if (onError) {\n      onError(wildoError);\n    }\n    \n    // Delegate to ErrorContext for other frontend actions (REDIRECT, SHOW_MODAL, etc.)\n    // Note: We've already handled NOTIFY above via NotificationContext\n    handleWildoError(errorForDelegation);\n  }, [handleWildoError, onError, handleForcedLogout, showErrorNotification]);\n  \n  // Subscribe to ERROR_OCCURED events\n  useEffect(() => {\n    logDebug('Subscribing to ERROR_OCCURED events', {\n      eventName: FrontendEvents.ERROR_OCCURED,\n    });\n    \n    const unsubscribe = on(FrontendEvents.ERROR_OCCURED, handleErrorEvent);\n    \n    return () => {\n      logDebug('Unsubscribing from ERROR_OCCURED events');\n      unsubscribe();\n    };\n  }, [on, handleErrorEvent]);\n  \n  // This component renders nothing - it only subscribes to events\n  return null;\n}\n\nexport default GlobalErrorHandler;\n"]}
+{"version":3,"file":"GlobalErrorHandler.js","sourceRoot":"","sources":["../../../../../src/core/errors/GlobalErrorHandler.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Global Error Handler\n * \n * Subscribes to ERROR_OCCURED events from the event bus and executes\n * frontend actions based on the error configuration.\n * \n * This component integrates with:\n * - AuthSession: For authentication error handling (logout)\n * - NotificationContext: For toast and notification center display\n * - ErrorContext: For other frontend actions (REDIRECT, SHOW_MODAL, etc.)\n * \n * Must be rendered inside AuthSessionProvider and NotificationProvider.\n */\n\nimport { useEffect, useCallback, useRef } from 'react';\nimport {\n  ErrorActionFrontend,\n  WildoError_Frontend,\n  ERROR_DEFINITIONS,\n  ErrorSeverity,\n} from '@wildo-ai/saas-models';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents, FrontendEventErrorOccured } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { sessionEndReasonForRefusal } from '~wildo-frontend-lib/core/requests/auth-refresh-resilience.frontend';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { useError } from './useError';\nimport { useAuthSession } from '~wildo-frontend-lib/core/security/useAuthSession';\nimport { useNotification } from '~wildo-frontend-lib/core/events/useNotification';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { errorManagement } from './error-management.frontend.service';\nimport { GlobalErrorHandlerProps } from './errors.frontend.schemas';\nimport { NotificationType } from '~wildo-frontend-lib/core/events/NotificationContext';\nimport { LabellingTypes } from '@wildo-ai/presets-components-models';\nimport { resolveUserFacingErrorMessage, type ErrorMessageTranslators } from './user-facing-error-message.frontend.utils';\n\n/** How long a toast raised before the error words settle waits for them (#2542). */\nconst ERROR_WORDS_WAIT_MS = 4000;\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('GlobalErrorHandler');\nlogger.setDebugTypeLogging('GlobalErrorHandler', false);\n\n/**\n * Map error severity to notification type\n */\nfunction severityToNotificationType(severity: ErrorSeverity): NotificationType {\n  switch (severity) {\n    case ErrorSeverity.CRITICAL:\n    case ErrorSeverity.HIGH:\n      return 'error';\n    case ErrorSeverity.MEDIUM:\n      return 'warning';\n    case ErrorSeverity.LOW:\n      return 'info';\n    default:\n      return 'error';\n  }\n}\n\n/**\n * Global Error Handler Component\n * \n * Subscribes to ERROR_OCCURED events and executes frontend actions.\n * Integrates with AuthSession for authentication error handling (logout).\n * Delegates notification display to NotificationContext.\n * \n * Should be rendered once, inside the AuthSessionProvider and NotificationProvider.\n */\nexport function GlobalErrorHandler({\n  onError,\n}: GlobalErrorHandlerProps): null {\n  const { on } = useEventBus();\n  const { handleWildoError } = useError();\n  const { endSession, isAuthenticated, getEndedSessionReason } = useAuthSession();\n  const { notifyError, notifyWarning, notifyInfo } = useNotification();\n  // Resolvers for backend error references and guidance → localized human messages. No deps\n  // requested: `errors_*` sections load eagerly, so this only borrows the resolvers.\n  //\n  // Held in a ref: `tErrorMessage` (and the whole I18n context value) is NOT\n  // memoized, so a new identity is produced on every I18nProvider render. Using it\n  // directly as a `useCallback` dep would ripple through `showErrorNotification` →\n  // `handleErrorEvent` → the `ERROR_OCCURED` subscription effect, re-subscribing\n  // the global handler on every i18n render. The ref keeps those callbacks (and the\n  // subscription) stable while always reading the latest resolvers.\n  const { tErrorMessage, tErrorGuidance, isKeySettled } = useI18n();\n  const translatorsRef = useRef<ErrorMessageTranslators>({ tErrorMessage, tErrorGuidance });\n  translatorsRef.current = { tErrorMessage, tErrorGuidance };\n\n  /**\n   * Whether the error words can be read yet (#2542). `errors_*` load eagerly, but \"eagerly\" is still a request: an\n   * error raised while the app is booting (a restored session refused before the first labels land) used to be\n   * resolved at that instant, so even the default label rendered as its key path, `errors_messages.default.msg`,\n   * and the toast kept that text. A toast raised before the words settle now waits for them.\n   *\n   * Bounded, because a FAILED eager load clears its keys without marking them settled: past\n   * {@link ERROR_WORDS_WAIT_MS} the held toasts are shown with whatever resolves, which is the key path a missing\n   * label must look like, rather than never.\n   */\n  const errorWordsSettled = isKeySettled(LabellingTypes.ERRORS_MESSAGES);\n  const errorWordsSettledRef = useRef(errorWordsSettled);\n  errorWordsSettledRef.current = errorWordsSettled;\n  const heldErrorsRef = useRef<WildoError_Frontend[]>([]);\n  const heldErrorsTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  \n  /**\n   * Tear down the AuthSession in response to a `triggerLogout` error.\n   *\n   * Only logs out when currently authenticated, to avoid a redundant logout\n   * (e.g. when the token-refresh interceptor already logged the session out).\n   * Fires for ANY error flagged `triggerLogout`, not only AUTHENTICATION-typed\n   * ones — see the gate in handleErrorEvent.\n   */\n  const handleForcedLogout = useCallback((wildoError: WildoError_Frontend) => {\n    if (isAuthenticated()) {\n      logDebug('triggerLogout requested - logging out via AuthSession');\n      // The backend refused the session; the person did not sign out, so `USER_LOGOUT` says so (#1977), and why,\n      // when the refusal names it (#2541).\n      endSession(sessionEndReasonForRefusal(wildoError));\n    } else {\n      logDebug('triggerLogout requested but not authenticated - skipping logout');\n    }\n  }, [endSession, isAuthenticated]);\n  \n  /**\n   * Show error notification via NotificationContext\n   * Uses policy-driven display (toast + optional notification center)\n   */\n  const displayErrorNotification = useCallback((wildoError: WildoError_Frontend) => {\n    const errorDefinition = ERROR_DEFINITIONS[wildoError.type];\n    const severity = (wildoError as any).severity || errorDefinition?.severity || ErrorSeverity.MEDIUM;\n    // The global toast speaks for no particular surface, so no surface words are passed: a generic\n    // bucket shows its own label. Server `context.message` / `originalMessage` and the raw reference\n    // are never shown — an unresolvable message falls to the default label, or to its key path when\n    // even that is unauthored (see `resolveUserFacingErrorMessage`).\n    const message = resolveUserFacingErrorMessage(wildoError, { translators: translatorsRef.current });\n    const notificationType = severityToNotificationType(severity);\n    \n    // Use appropriate notification method based on severity\n    const notificationData = {\n      errorType: wildoError.type,\n      severity,\n      context: wildoError.context,\n    };\n    \n    switch (notificationType) {\n      case 'error':\n        notifyError(message, { data: notificationData });\n        break;\n      case 'warning':\n        notifyWarning(message, { data: notificationData });\n        break;\n      case 'info':\n        notifyInfo(message, { data: notificationData });\n        break;\n    }\n    \n    logDebug('Error notification displayed via NotificationContext', {\n      errorType: wildoError.type,\n      severity,\n      notificationType,\n      message,\n    });\n  }, [notifyError, notifyWarning, notifyInfo]);\n\n  const flushHeldErrorNotifications = useCallback(() => {\n    if (heldErrorsTimerRef.current) {\n      clearTimeout(heldErrorsTimerRef.current);\n      heldErrorsTimerRef.current = null;\n    }\n    const held = heldErrorsRef.current;\n    heldErrorsRef.current = [];\n    for (const wildoError of held) displayErrorNotification(wildoError);\n  }, [displayErrorNotification]);\n\n  /** Show now when the error words are readable, else hold until they are (#2542). */\n  const showErrorNotification = useCallback((wildoError: WildoError_Frontend) => {\n    if (errorWordsSettledRef.current) {\n      displayErrorNotification(wildoError);\n      return;\n    }\n    heldErrorsRef.current.push(wildoError);\n    heldErrorsTimerRef.current ??= setTimeout(flushHeldErrorNotifications, ERROR_WORDS_WAIT_MS);\n  }, [displayErrorNotification, flushHeldErrorNotifications]);\n\n  useEffect(() => {\n    if (errorWordsSettled && heldErrorsRef.current.length > 0) flushHeldErrorNotifications();\n  }, [errorWordsSettled, flushHeldErrorNotifications]);\n\n  useEffect(() => () => {\n    if (heldErrorsTimerRef.current) clearTimeout(heldErrorsTimerRef.current);\n    // Reset, or a remount (React StrictMode) would see a timer that no longer exists and never arm a new one.\n    heldErrorsTimerRef.current = null;\n  }, []);\n  \n  /**\n   * Handle ERROR_OCCURED event\n   *\n   * Delegates to ErrorContext.handleWildoError for action execution, but intercepts\n   * any error flagged `triggerLogout` to tear down the session via the AuthSession\n   * `logout()` callback instead of the DISCONNECT window-event fallback.\n   */\n  const handleErrorEvent = useCallback((payload: FrontendEventErrorOccured) => {\n    let wildoError: WildoError_Frontend = payload.error;\n\n    logDebug('Received ERROR_OCCURED event', {\n      errorType: wildoError.type,\n      customMessageReference: wildoError.customMessageReference,\n      triggerLogout: wildoError.triggerLogout,\n    });\n    \n    // Check for duplicate errors using deduplication service\n    if (errorManagement.shouldSuppress(wildoError)) {\n      logDebug('Error suppressed (duplicate)', {\n        errorType: wildoError.type,\n        customMessageReference: wildoError.customMessageReference,\n      });\n      return; // Don't process duplicate\n    }\n    \n    // `triggerLogout` is the authoritative \"force a logout\" signal (set by the HTTP\n    // error-behavior matrix, e.g. a 401 invalid session). It drives the AuthSession\n    // logout on its own — deliberately NOT additionally gated on\n    // `type === AUTHENTICATION`. The error's `type` is taken from the backend payload\n    // (`backendErrorType || behavior.errorType` in buildWildoError), so a 401 whose\n    // backend type is not AUTHENTICATION would still carry triggerLogout=true; an extra\n    // type gate would silently swallow that logout. Mirrors `handleHttpError`'s\n    // `shouldLogout`, which is also triggerLogout-only.\n    const shouldTriggerLogout = wildoError.triggerLogout === true;\n\n    // Handle logout via AuthSession if needed (before delegating to ErrorContext)\n    if (shouldTriggerLogout) {\n      logDebug('triggerLogout=true - calling AuthSession logout handler');\n      handleForcedLogout(wildoError);\n      \n      // Remove DISCONNECT action from frontendActions since we already handled logout\n      const frontendActions = (wildoError.frontendActions || []) as ErrorActionFrontend[];\n      if (frontendActions.includes(ErrorActionFrontend.DISCONNECT)) {\n        wildoError = {\n          ...wildoError,\n          frontendActions: frontendActions.filter(a => a !== ErrorActionFrontend.DISCONNECT),\n        };\n      }\n    }\n    \n    // Log error for analytics/debugging\n    logDebug('Error occurred', {\n      errorType: wildoError.type,\n      customMessageReference: wildoError.customMessageReference,\n    });\n    \n    // `suppressUserDisplay` (set when the originating request was `silent`) means\n    // the CALLER owns the user-facing error UX — e.g. a resource form already shows\n    // NOTIFY_RESOURCE_ERROR + inline field errors. In that case strip ALL display\n    // actions (toast + modal) so the global handler never double-surfaces the error,\n    // while still running the side-effect actions below (REDIRECT, DISCONNECT) and\n    // the auth-logout handled earlier. This is what lets a silent resource mutation\n    // log out on 401 without raising a duplicate global toast.\n    //\n    // INVARIANT (load-bearing): we deliberately KEEP REDIRECT/DISCONNECT here, so the\n    // \"silent\" contract relies on HTTP_ERROR_BEHAVIOR_MATRIX never placing those two\n    // actions at a risk level a silent caller can reach (today the matrix only adds\n    // REDIRECT at HIGH/CRITICAL, and silent callers are autosave / RMM-fallback /\n    // guidance / uniqueness — MEDIUM-or-lower). If you add REDIRECT/DISCONNECT at a\n    // lower risk, OR via `setHttpErrorBehaviorOverride`, a silent background op would\n    // navigate/disconnect with NO visible toast to explain it — add those to the\n    // strip list here if that ever changes.\n    const suppressUserDisplay = (wildoError as any).suppressUserDisplay === true;\n    const shouldShowNotification = !suppressUserDisplay && (wildoError as any).showToUser !== false;\n    const frontendActions = (wildoError.frontendActions || []) as ErrorActionFrontend[];\n    const hasNotifyAction = frontendActions.includes(ErrorActionFrontend.NOTIFY)\n      || frontendActions.includes(ErrorActionFrontend.SHOW_TOAST);\n\n    let errorForDelegation = wildoError;\n    if (suppressUserDisplay) {\n      errorForDelegation = {\n        ...wildoError,\n        frontendActions: frontendActions.filter(\n          action => action !== ErrorActionFrontend.NOTIFY\n            && action !== ErrorActionFrontend.SHOW_TOAST\n            && action !== ErrorActionFrontend.SHOW_MODAL,\n        ),\n      };\n    } else if (shouldTriggerLogout && getEndedSessionReason() !== null) {\n      // The sign-in page says why the session ended (#2541), so the request that discovered it raises no toast of\n      // its own: a generic \"something went wrong\" there contradicts the notice. Asked AFTER the logout above, and of\n      // the session rather than of this call: in production the refresh handler usually ended the session a beat\n      // earlier, so this handler found nobody signed in, and the notice is already there. When no backend-ended\n      // session is being explained (a public page's 401), the toast stays. Display actions only; REDIRECT still runs.\n      errorForDelegation = {\n        ...wildoError,\n        frontendActions: frontendActions.filter(\n          action => action !== ErrorActionFrontend.NOTIFY\n            && action !== ErrorActionFrontend.SHOW_TOAST\n            && action !== ErrorActionFrontend.SHOW_MODAL,\n        ),\n      };\n    } else if (shouldShowNotification && hasNotifyAction) {\n      showErrorNotification(wildoError);\n      errorForDelegation = {\n        ...wildoError,\n        frontendActions: frontendActions.filter(\n          action => action !== ErrorActionFrontend.NOTIFY && action !== ErrorActionFrontend.SHOW_TOAST,\n        ),\n      };\n    }\n    \n    // Call custom error handler if provided\n    if (onError) {\n      onError(wildoError);\n    }\n    \n    // Delegate to ErrorContext for other frontend actions (REDIRECT, SHOW_MODAL, etc.)\n    // Note: We've already handled NOTIFY above via NotificationContext\n    handleWildoError(errorForDelegation);\n  }, [handleWildoError, onError, handleForcedLogout, showErrorNotification, getEndedSessionReason]);\n  \n  // Subscribe to ERROR_OCCURED events\n  useEffect(() => {\n    logDebug('Subscribing to ERROR_OCCURED events', {\n      eventName: FrontendEvents.ERROR_OCCURED,\n    });\n    \n    const unsubscribe = on(FrontendEvents.ERROR_OCCURED, handleErrorEvent);\n    \n    return () => {\n      logDebug('Unsubscribing from ERROR_OCCURED events');\n      unsubscribe();\n    };\n  }, [on, handleErrorEvent]);\n  \n  // This component renders nothing - it only subscribes to events\n  return null;\n}\n\nexport default GlobalErrorHandler;\n"]}

package/dist/esm/core/errors/error-management.frontend.service.d.ts

@@ -51,10 +51,6 @@ declare class ErrorManagementService {
      * Check if an HTTP status code should trigger logout for a given risk level
      */
     static shouldTriggerLogout(statusCode: number, riskLevel?: ResourceOperationRiskLevel): boolean;
-    /**
-     * Check if an HTTP status code should be retried
-     */
-    static shouldRetryHttpError(statusCode: number, riskLevel?: ResourceOperationRiskLevel): boolean;
     /**
      * Frontend HTTP consumers receive the transport error object, while the
      * normalized Wildo error is attached on `error.wildoError`.

package/dist/esm/core/errors/error-management.frontend.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-management.frontend.service.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/error-management.frontend.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"error-management.frontend.service.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/error-management.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,SAAS,EACT,mBAAmB,EAGnB,0BAA0B,EAC1B,cAAc,EAEsB,MAAM,uBAAuB,CAAC;AAMpE,OAAO,EACL,iBAAiB,EAEjB,kCAAkC,EAClC,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EAKpB,MAAM,2BAA2B,CAAC;AA+CnC;;;;GAIG;AACH,cAAM,sBAAsB;IAK1B,uCAAuC;IACvC,OAAO,CAAC,aAAa,CAAwC;IAE7D,gDAAgD;IAChD,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAsE;IAMrG;;;;;;;OAOG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,SAAS;IAwE3C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,6BAA6B;IAkB5C;;;;;;;;OAQG;IACH,MAAM,CAAC,oBAAoB,CACzB,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,0BAA8D,GACxE,iBAAiB;IA6CpB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,0BAA8D,GACxE,OAAO;IAKV;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAQxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAyBhC;;OAEG;IACH,MAAM,CAAC,oBAAoB,CACzB,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,0BAA8D,EACzE,MAAM,GAAE,OAAe,GACtB,OAAO;IAQV;;OAEG;IACH,MAAM,CAAC,4BAA4B,CACjC,UAAU,EAAE,cAAc,EAC1B,QAAQ,EAAE,kCAAkC,GAC3C,IAAI;IAIP;;OAEG;IACH,MAAM,CAAC,8BAA8B,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IAIvE;;OAEG;IACH,MAAM,CAAC,kCAAkC,IAAI,IAAI;IAIjD;;OAEG;IACH,MAAM,CAAC,uBAAuB,IAAI,iBAAiB;IAQnD;;;OAGG;IACH,MAAM,CAAC,6BAA6B,IAAI,IAAI;IA2D5C;;OAEG;IACH,MAAM,CAAC,0BAA0B,IAAI,IAAI;IAUzC;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO;IAqDxD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,OAAO;IAQf;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAQ1B;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI;IAqEhE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAsBjB;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe;IAoE5E;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkC3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAwEvB;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,QAAQ;IA8BhB;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAoB1C;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAoBzC;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IA8BpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAE9D;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,sBAAsB;CAM7C;AAGD,eAAO,MAAM,eAAe,wBAAuC,CAAC;AAGpE,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/esm/core/errors/error-management.frontend.service.js

@@ -213,13 +213,6 @@ class ErrorManagementService {
         const behavior = ErrorManagementService.getHttpErrorBehavior(statusCode, riskLevel);
         return behavior.triggerLogout === true;
     }
-    /**
-     * Check if an HTTP status code should be retried
-     */
-    static shouldRetryHttpError(statusCode, riskLevel = ResourceOperationRiskLevel.MEDIUM) {
-        const behavior = ErrorManagementService.getHttpErrorBehavior(statusCode, riskLevel);
-        return behavior.shouldRetry === true;
-    }
     /**
      * Frontend HTTP consumers receive the transport error object, while the
      * normalized Wildo error is attached on `error.wildoError`.
@@ -681,7 +674,11 @@ class ErrorManagementService {
         if (responseData.error) {
             const backendError = responseData.error;
             return {
-                customMessageReference: backendError.code || backendError.customMessageReference,
+                // The REFERENCE names the words (`errors_messages`); `code` is the refusal's own machine code, distinct from it since
+                // #1620, and travels in `details` for the surfaces that word a code (`resolveRefusalCodeLabel`). Taking the code
+                // first replaced a refusal's reference with a code `errors_messages` has no words for (#1643). A bare envelope
+                // naming only a code still has it read as the reference.
+                customMessageReference: backendError.customMessageReference || backendError.code,
                 message: backendError.message,
                 errorContext: backendError.details ?? backendError.context,
                 backendErrorType: backendError.type,