@wildo-ai/saas-frontend-lib 1.1.4 → 1.1.6

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

@@ -1,8 +1,9 @@
 /**
  * Common enum registration.
  *
- * Registers enum names for i18n label resolution and stores visual
- * configuration for system enums. Two mechanisms for visual config:
+ * 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:
  *
  * 1. **Schema-level** — when a schema field is provided, calls `.enumUI()`
  *    to mutate the field's metadata in place (same mechanism as `fields`).
@@ -15,19 +16,51 @@
  * - Built-in common enums registered by `registerBuiltinCommonEnums()` in presets
  * - App-specific common enums registered in `App.tsx` or equivalent
  */
-import { SYSTEM_ENUM_NAMES } from '@wildo-ai/presets-components-models';
+import { getEnumUI, getEnumValues } from '@wildo-ai/zod-decorators';
+import { resolveDeclaredSystemEnumName, resolveFieldEnumSchema } from '@wildo-ai/presets-components-models';
 /**
  * Registry-level visual config for common enums, keyed by enum name.
  *
  * Used as a fallback when a schema field has `.systemEnum(name)` but no
  * field-level `.enumUI()`. Populated by `registerCommonEnum()`.
  *
- * Priority chain at render time:
+ * Priority chain at render time — implemented by {@link resolveEnumDisplayConfig}, which every
+ * enum reader goes through:
  * 1. Field-level `.enumUI()` metadata (highest)
  * 2. This registry by `.systemEnum()` name (fallback)
  * 3. Default rendering (no config)
+ *
+ * That chain was DOCUMENTED here and implemented nowhere until 2026-09-20 (#1321): no renderer
+ * read this map, so a registry-only registration coloured nothing and every vocabulary that wanted
+ * a colour had to be decorated again at each field that carried it — three copies of one run-status
+ * map in the creation workbench alone.
  */
 export const COMMON_ENUM_DISPLAY_CONFIG = new Map();
+/**
+ * The enum-UI params a field RENDERS with: its own `.enumUI()` metadata over the registry-level
+ * config of the vocabulary it declares (`.systemEnum(name)`, or an exact framework vocabulary).
+ *
+ * Read this, never `getEnumUI` directly, wherever a colour, an icon or a display mode is resolved
+ * for an enum value — the display formatter, the form controls, the chart colour bridge. It is what
+ * makes "register the vocabulary once" true: a status field that declares `FlowsActors_Status` gets
+ * that vocabulary's badge treatment on every resource that carries it, with nothing decorated at the
+ * field.
+ *
+ * Merge is per key with the field winning, and per VALUE inside `values`, so a field may override
+ * one member's colour without restating the rest of the map.
+ */
+export function resolveEnumDisplayConfig(schema) {
+    const declared = getEnumUI(schema);
+    const enumSchema = resolveFieldEnumSchema(schema);
+    const name = enumSchema ? resolveDeclaredSystemEnumName(enumSchema, getEnumValues(enumSchema)) : undefined;
+    const registered = name ? COMMON_ENUM_DISPLAY_CONFIG.get(name) : undefined;
+    if (!registered)
+        return declared;
+    if (!declared)
+        return registered;
+    const values = registered.values || declared.values ? { ...registered.values, ...declared.values } : undefined;
+    return { ...registered, ...declared, ...(values ? { values } : {}) };
+}
 /**
  * Get visual display config for a system enum by name.
  * Returns `undefined` if the enum has no registered visual config.
@@ -36,9 +69,11 @@ export function getCommonEnumDisplayConfig(name) {
     return COMMON_ENUM_DISPLAY_CONFIG.get(name);
 }
 /**
- * Register a common enum for i18n and optionally apply visual display config.
+ * Register a common enum's visual display config.
  *
- * - Adds the name to `SYSTEM_ENUM_NAMES` (used by `tResourceFieldEnumValue` i18n cascade)
+ * - 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)
@@ -74,7 +109,6 @@ export function getCommonEnumDisplayConfig(name) {
  * ```
  */
 export function registerCommonEnum(name, schema, displayConfig) {
-    SYSTEM_ENUM_NAMES.add(name);
     if (displayConfig) {
         if (typeof displayConfig !== 'function') {
             COMMON_ENUM_DISPLAY_CONFIG.set(name, displayConfig);

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;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAUxE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEpF;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,OAAO,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,MAAqB,EACrB,aAAuE;IAEvE,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE5B,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 * Registers enum names for i18n label resolution and stores visual\n * configuration for system enums. 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 type { DecoratorUpdater, EnumUIParams } from '@wildo-ai/zod-decorators';\nimport { SYSTEM_ENUM_NAMES } 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:\n * 1. Field-level `.enumUI()` metadata (highest)\n * 2. This registry by `.systemEnum()` name (fallback)\n * 3. Default rendering (no config)\n */\nexport const COMMON_ENUM_DISPLAY_CONFIG = new Map<string, CommonEnumVisualConfig>();\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 for i18n and optionally apply visual display config.\n *\n * - Adds the name to `SYSTEM_ENUM_NAMES` (used by `tResourceFieldEnumValue` i18n cascade)\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  SYSTEM_ENUM_NAMES.add(name);\n\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;;;;;;;;;;;;;;;;;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"]}

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

@@ -1 +1 @@
-{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../src/core/errors/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAa,MAAM,OAAO,CAAC;AAUpD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAsBnC;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;gBACtE,KAAK,EAAE,kBAAkB;IAUrC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQ1E,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IAgCjE,UAAU,EAAE,MAAM,IAAI,CAMpB;IAEF,MAAM,IAAI,KAAK,CAAC,SAAS;CA0B1B"}
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAa,MAAM,OAAO,CAAC;AAUpD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAsBnC;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;gBACtE,KAAK,EAAE,kBAAkB;IAUrC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQ1E,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IAgCjE,UAAU,EAAE,MAAM,IAAI,CAMpB;IAEF,MAAM,IAAI,KAAK,CAAC,SAAS;CA0B1B"}

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

@@ -1 +1 @@
-{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../../../../src/core/errors/ErrorBoundary.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { Component, ReactNode } from 'react';\nimport { useNavigate } from 'react-router-dom';\nimport { ErrorType } from '@wildo-ai/saas-models';\nimport { sharedErrorBuilder } from './errors-builder.frontend.services';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { AppLayout_ErrorBoundary } from '~wildo-frontend-lib/components/app/AppLayout_ErrorBoundary';\nimport { frontendEventBus } from '~wildo-frontend-lib/core/events/event-bus.frontend.service';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { navigateHomeWithFreshStart } from '~wildo-frontend-lib/core/navigation/navigation-clean-break.frontend.utils';\nimport {\n  ErrorBoundaryState,\n  ErrorBoundaryProps,\n} from './errors.frontend.schemas';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('ErrorBoundary');\nlogger.setDebugTypeLogging('ErrorBoundary', false);\n\nfunction ErrorBoundaryFallback(props: {\n  error: Error;\n  errorInfo: React.ErrorInfo;\n  resetError: () => void;\n}): React.JSX.Element {\n  const routerNavigate = useNavigate();\n  const { emit } = useEventBus();\n\n  return (\n    <AppLayout_ErrorBoundary\n      {...props}\n      navigateHome={() => navigateHomeWithFreshStart({ emit, routerNavigate })}\n    />\n  );\n}\n\n/**\n * React ErrorBoundary component that catches JavaScript errors anywhere in the child component tree,\n * logs those errors, and displays a fallback UI instead of the component tree that crashed.\n *\n * This integrates with the existing Wildo error handling system to provide consistent error reporting.\n * Uses the APP_LAYOUTS_ERROR_BOUNDARY component for rendering with i18n labels and proper icons.\n */\nexport class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {\n  constructor(props: ErrorBoundaryProps) {\n    super(props);\n    this.state = {\n      hasError: false,\n      error: null,\n      errorInfo: null,\n    };\n    // Uses sharedErrorBuilder singleton for consistent error building with user context\n  }\n\n  static getDerivedStateFromError(error: Error): Partial<ErrorBoundaryState> {\n    // Update state so the next render will show the fallback UI\n    return {\n      hasError: true,\n      error,\n    };\n  }\n\n  componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void {\n    this.setState({\n      error,\n      errorInfo,\n    });\n\n    // Log to console for development\n    logger.error('ErrorBoundary caught an error:', {error, errorInfo});\n\n    // Create a Wildo error for consistent error handling\n    // Uses sharedErrorBuilder singleton - automatically includes user context\n    const wildoError = sharedErrorBuilder.buildReactError(error, errorInfo);\n\n    // Emit error via EventBus (replaces legacy window.dispatchEvent)\n    try {\n      frontendEventBus.emit(FrontendEvents.ERROR_OCCURED, {\n        error: wildoError\n      });\n    } catch (dispatchError) {\n      logger.warn('Failed to emit error event:', {dispatchError});\n    }\n\n    // Call custom onError handler if provided\n    if (this.props.onError) {\n      try {\n        this.props.onError(error, errorInfo);\n      } catch (handlerError) {\n        logger.warn('Error in custom error handler:', handlerError);\n      }\n    }\n  }\n\n  resetError: () => void = () => {\n    this.setState({\n      hasError: false,\n      error: null,\n      errorInfo: null,\n    });\n  };\n\n  render(): React.ReactNode {\n    if (this.state.hasError && this.state.error && this.state.errorInfo) {\n      // Use custom fallback component if provided\n      if (this.props.fallback) {\n        const FallbackComponent = this.props.fallback;\n        return (\n          <FallbackComponent\n            error={this.state.error}\n            errorInfo={this.state.errorInfo}\n            resetError={this.resetError}\n          />\n        );\n      }\n\n      // Use the APP_LAYOUTS_ERROR_BOUNDARY component\n      return (\n        <ErrorBoundaryFallback\n          error={this.state.error}\n          errorInfo={this.state.errorInfo}\n          resetError={this.resetError}\n        />\n      );\n    }\n\n    return this.props.children;\n  }\n}\n\n// Note: withErrorBoundary HOC is in withErrorBoundary.tsx for React Fast Refresh compatibility.\n"]}
+{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../../../../../src/core/errors/ErrorBoundary.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { Component, ReactNode } from 'react';\nimport { useNavigate } from 'react-router-dom';\nimport { ErrorType } from '@wildo-ai/saas-models';\nimport { sharedErrorBuilder } from './errors-builder.frontend.services';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { AppLayout_ErrorBoundary } from '~wildo-frontend-lib/components/app/AppLayout_ErrorBoundary';\nimport { frontendEventBus } from '~wildo-frontend-lib/core/events/event-bus.frontend.service';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { navigateHomeWithFreshStart } from '~wildo-frontend-lib/core/navigation/navigation-clean-break.frontend.utils';\nimport {\n  ErrorBoundaryState,\n  ErrorBoundaryProps,\n} from './errors.frontend.schemas';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('ErrorBoundary');\nlogger.setDebugTypeLogging('ErrorBoundary', false);\n\nfunction ErrorBoundaryFallback(props: {\n  error: Error;\n  errorInfo: React.ErrorInfo;\n  resetError: () => void;\n}): React.JSX.Element {\n  const routerNavigate = useNavigate();\n  const { emit } = useEventBus();\n\n  return (\n    <AppLayout_ErrorBoundary\n      {...props}\n      navigateHome={() => navigateHomeWithFreshStart({ emit, routerNavigate })}\n    />\n  );\n}\n\n/**\n * React ErrorBoundary component that catches JavaScript errors anywhere in the child component tree,\n * logs those errors, and displays a fallback UI instead of the component tree that crashed.\n *\n * This integrates with the existing Wildo error handling system to provide consistent error reporting.\n * Uses the APP_LAYOUTS_ERROR_BOUNDARY component for rendering with i18n labels and proper icons.\n */\nexport class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {\n  constructor(props: ErrorBoundaryProps) {\n    super(props);\n    this.state = {\n      hasError: false,\n      error: null,\n      errorInfo: null,\n    };\n    // Uses sharedErrorBuilder singleton for consistent error building with user context\n  }\n\n  static getDerivedStateFromError(error: Error): Partial<ErrorBoundaryState> {\n    // Update state so the next render will show the fallback UI\n    return {\n      hasError: true,\n      error,\n    };\n  }\n\n  componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void {\n    this.setState({\n      error,\n      errorInfo,\n    });\n\n    // Log to console for development\n    logger.error('ErrorBoundary caught an error:', {error, errorInfo});\n\n    // Create a Wildo error for consistent error handling\n    // Uses sharedErrorBuilder singleton - automatically includes user context\n    const wildoError = sharedErrorBuilder.buildReactError(error, errorInfo);\n\n    // Emit error via EventBus (replaces legacy window.dispatchEvent)\n    try {\n      frontendEventBus.emit(FrontendEvents.ERROR_OCCURED, {\n        error: wildoError\n      });\n    } catch (dispatchError) {\n      logger.warn('Failed to emit error event:', {dispatchError});\n    }\n\n    // Call custom onError handler if provided\n    if (this.props.onError) {\n      try {\n        this.props.onError(error, errorInfo);\n      } catch (handlerError) {\n        logger.warn('Error in custom error handler:', handlerError);\n      }\n    }\n  }\n\n  resetError: () => void = () => {\n    this.setState({\n      hasError: false,\n      error: null,\n      errorInfo: null,\n    });\n  };\n\n  render(): React.ReactNode {\n    if (this.state.hasError && this.state.error && this.state.errorInfo) {\n      // Use custom fallback component if provided\n      if (this.props.fallback) {\n        const FallbackComponent = this.props.fallback;\n        return (\n          <FallbackComponent\n            error={this.state.error}\n            errorInfo={this.state.errorInfo}\n            resetError={this.resetError}\n          />\n        );\n      }\n\n      // Use the APP_LAYOUTS_ERROR_BOUNDARY component\n      return (\n        <ErrorBoundaryFallback\n          error={this.state.error}\n          errorInfo={this.state.errorInfo}\n          resetError={this.resetError}\n        />\n      );\n    }\n\n    return this.props.children;\n  }\n}\n\n// Note: withErrorBoundary HOC is in withErrorBoundary.tsx for React Fast Refresh compatibility.\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"ErrorContext.d.ts","sourceRoot":"","sources":["../../../../src/core/errors/ErrorContext.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,EAAE,SAAS,EAA4D,MAAM,OAAO,CAAC;AAUnG,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAM7D;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAA0D,CAAC;AAEhI,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,CAsP3D,CAAC"}
+{"version":3,"file":"ErrorContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/ErrorContext.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,EAAE,SAAS,EAA4D,MAAM,OAAO,CAAC;AAUnG,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAM7D;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAA0D,CAAC;AAEhI,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,CA+P3D,CAAC"}

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

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { ERROR_DEFINITIONS, ErrorActionFrontend, ErrorType, Error_Frontend_RedirectPolicy, ResourcePrimaryScope } from '@wildo-ai/saas-models';
+import { ERROR_DEFINITIONS, ErrorActionFrontend, Error_Frontend_RedirectPolicy, ResourcePrimaryScope, describeCaughtError } from '@wildo-ai/saas-models';
 import { createContext, useEffect, useCallback, useMemo } from 'react';
 import { WINDOW_EVENTS_SLUGS } from '../../core/commons/window-event.frontend.schemas.js';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
@@ -25,13 +25,20 @@ export const ErrorProvider = ({ children }) => {
         sharedErrorBuilder.updateUserId(userId);
         sharedErrorBuilder.updateOrganizationId(organizationId);
     }, []);
-    // Sync with user context changes - updates shared singleton
+    /*
+     * Attribute error reports to the person this tab knows, and to nobody once they are gone (#1977).
+     * Before `USER_LOGIN` had a producer this listener never ran; it also had no `USER_LOGOUT` half, so
+     * once it did run, errors raised after a sign-out would have been reported as the previous person's.
+     */
     useEffect(() => {
         const unsubscribe = on(FrontendEvents.USER_LOGIN, (payload) => {
             if (payload.userId) {
                 setUserContext(payload.userId, undefined);
             }
         });
+        const unsubscribeLogout = on(FrontendEvents.USER_LOGOUT, () => {
+            setUserContext(undefined, undefined);
+        });
         const unsubscribe2 = on(FrontendEvents.PRIMARY_SCOPE_CHANGED, (payload) => {
             if (payload.scopeLevel === ResourcePrimaryScope.ORGANIZATIONS && payload.newValue) {
                 sharedErrorBuilder.updateOrganizationId(payload.newValue);
@@ -39,6 +46,7 @@ export const ErrorProvider = ({ children }) => {
         });
         return () => {
             unsubscribe();
+            unsubscribeLogout();
             unsubscribe2();
         };
     }, [on, setUserContext]);
@@ -136,18 +144,14 @@ export const ErrorProvider = ({ children }) => {
                         break;
                     }
                     case ErrorActionFrontend.SHOW_MODAL: {
-                        const errorTypeModal = wildoErrorParam.type;
-                        const errorDefinitionModal = ERROR_DEFINITIONS[errorTypeModal];
-                        const customMessageReferenceModal = wildoErrorParam.customMessageReference;
-                        const messageModal = customMessageReferenceModal || errorDefinitionModal.description;
-                        const contextModal = wildoErrorParam.context;
+                        // The error itself, never text: this provider sits ABOVE the I18nProvider, so the modal's renderer
+                        // (`ErrorModalContent`) resolves the words. The raw reference, `ERROR_DEFINITIONS` developer
+                        // description and request context pushed here used to reach the screen (#1159).
                         frontendEventBus.emit(FrontendEvents.NAVIGATION_PUSH, {
                             zone: NavigationZone.OVERLAY,
                             content: {
                                 contentType: NavigationContentType.ERROR_MODAL,
-                                errorType: errorTypeModal,
-                                message: messageModal,
-                                context: contextModal,
+                                errorType: wildoErrorParam.type,
                                 wildoError: wildoErrorParam,
                             },
                             stackEntryId: `error_modal_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
@@ -163,7 +167,7 @@ export const ErrorProvider = ({ children }) => {
                 console.warn('Failed to execute frontend error action', {
                     action,
                     originalError: wildoErrorParam,
-                    actionError: actionError instanceof Error ? actionError.message : String(actionError)
+                    actionError: describeCaughtError(actionError)
                 });
             }
         });
@@ -215,7 +219,12 @@ export const ErrorProvider = ({ children }) => {
                     ...additionalContext,
                 },
             };
-            if (error.wildoErrorEventEmitted === true) {
+            // Already emitted AND displayed: the global handler showed it, so a second toast would duplicate it.
+            // A `silent` request is different — its event was emitted with `suppressUserDisplay`, which means
+            // "the CALLER owns the user-facing message". A caller reporting it here IS that owner, so it is
+            // displayed. Treating every emitted error as displayed is what left a refused form save with no
+            // words of its own: the form fell back to a fresh `Error`, classified as an uncaught exception (#1447).
+            if (error.wildoErrorEventEmitted === true && normalizedWildoError.suppressUserDisplay !== true) {
                 logger.error(enrichedWildoError.customMessageReference, enrichedWildoError.context);
                 return;
             }
@@ -242,22 +251,4 @@ export const ErrorProvider = ({ children }) => {
     }), [handleError, handleWildoError, setUserContext]);
     return _jsx(ErrorContext.Provider, { value: value, children: children });
 };
-// useError hook is now in separate file: ./useError.ts
-// This separation is required for React Fast Refresh compatibility
-/**
- * Utility function to create error with minimal config
- * @__PURE__
- */
-const createError = /* #__PURE__ */ (message, type = ErrorType.UNKNOWN, overrides) => {
-    const error = new Error(message);
-    const wildoError = sharedErrorBuilder.buildWildoError_Frontend(type, {
-        customMessageReference: overrides?.customMessageReference,
-        operationPathKey: overrides?.operationPathKey,
-        context: {
-            originalMessage: message,
-            ...overrides?.context
-        }
-    });
-    return { error, wildoError };
-};
 //# sourceMappingURL=ErrorContext.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ErrorContext.js","sourceRoot":"","sources":["../../../../src/core/errors/ErrorContext.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  ERROR_DEFINITIONS,\n  ErrorActionFrontend,\n  ErrorCustomMessageReference,\n  ErrorType,\n  Error_Frontend_RedirectPolicy,\n  ResourcePrimaryScope,\n  WildoError_Frontend\n} from '@wildo-ai/saas-models';\nimport React, { ReactNode, createContext, useState, useEffect, useCallback, useMemo } from 'react';\nimport { WINDOW_EVENTS_SLUGS } from '~wildo-frontend-lib/core/commons/window-event.frontend.schemas';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { sharedErrorBuilder } from './errors-builder.frontend.services';\nimport { frontendEventBus } from '~wildo-frontend-lib/core/events/event-bus.frontend.service';\nimport { ErrorManagementService } from './error-management.frontend.service';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { NavigationZone, NavigationContentType, NavigationSource } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { ErrorSeverity, FrontendNotificationCustomMessageRefs } from '@wildo-ai/saas-models';\nimport { ErrorContextType } from './errors.frontend.schemas';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('ErrorContext');\nlogger.setDebugTypeLogging('ErrorContext', false);\n\n/**\n * Error Context\n * Exported for use in separate hook file (Fast Refresh compatibility)\n * @internal - Use useError() hook instead of accessing this directly\n */\nexport const ErrorContext: React.Context<ErrorContextType | undefined> = createContext<ErrorContextType | undefined>(undefined);\n\nexport const ErrorProvider: React.FC<{ children: ReactNode }> = ({ children }) => {\n  const { on } = useEventBus();\n\n  const setUserContext = useCallback((userId?: string, organizationId?: string) => {\n    sharedErrorBuilder.updateUserId(userId);\n    sharedErrorBuilder.updateOrganizationId(organizationId);\n  }, []);\n\n  // Sync with user context changes - updates shared singleton\n  useEffect(() => {\n    const unsubscribe = on(FrontendEvents.USER_LOGIN, (payload) => {\n      if (payload.userId) {\n        setUserContext(payload.userId, undefined);\n      }\n    });\n    \n    const unsubscribe2 = on(FrontendEvents.PRIMARY_SCOPE_CHANGED, (payload) => {\n      if (payload.scopeLevel === ResourcePrimaryScope.ORGANIZATIONS && payload.newValue) {\n        sharedErrorBuilder.updateOrganizationId(payload.newValue);\n      }\n    });\n    \n    return () => {\n      unsubscribe();\n      unsubscribe2();\n    };\n  }, [on, setUserContext]);\n\n  const executeFrontendActions = useCallback((wildoErrorParam: WildoError_Frontend) => {\n    const frontendActions: ErrorActionFrontend[] = ((wildoErrorParam as WildoError_Frontend).frontendActions || []) as ErrorActionFrontend[];\n    frontendActions.forEach(action => {\n      try {\n        switch (action) {\n          case ErrorActionFrontend.NOTIFY:\n          case ErrorActionFrontend.SHOW_TOAST: {\n            const showToUser: boolean | undefined = (wildoErrorParam as WildoError_Frontend).showToUser;\n            if (showToUser !== false) {\n              const errorType: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n              const errorDefinition = ERROR_DEFINITIONS[errorType];\n              const customMessageReference: string = (wildoErrorParam as WildoError_Frontend).customMessageReference;\n              const context = wildoErrorParam.context as Record<string, unknown> | undefined;\n              const userGuidance = (wildoErrorParam as any).userGuidance as { explanation?: string; resolution?: string } | undefined;\n              const message = userGuidance?.explanation\n                || userGuidance?.resolution\n                || (context?.message as string)\n                || (context?.errorMessage as string)\n                || (context?.originalMessage as string)\n                || customMessageReference\n                || errorDefinition.description;\n              \n              const eventPayload = {\n                identifier: FrontendNotificationCustomMessageRefs.A_TEMP_REF,\n                data: {\n                  message,\n                  errorType: wildoErrorParam.type,\n                  customMessageReference: wildoErrorParam.customMessageReference,\n                  context,\n                },\n              } as const;\n              \n              switch (errorDefinition.severity) {\n                case 'critical':\n                case 'high':\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_ERROR, eventPayload);\n                  break;\n                case 'medium':\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_WARNING, eventPayload);\n                  break;\n                case 'low':\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_INFO, eventPayload);\n                  break;\n                default:\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_ERROR, eventPayload);\n              }\n            }\n            break;\n          }\n          \n          case ErrorActionFrontend.DISCONNECT: {\n            const errorTypeDisconnect: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n            const timestampDisconnect: Date = (wildoErrorParam as WildoError_Frontend).timestamp;\n            \n            const logoutEvent = new CustomEvent(WINDOW_EVENTS_SLUGS.LOGOUT, {\n              detail: { \n                reason: 'error_disconnect', \n                errorType: errorTypeDisconnect,\n                timestamp: timestampDisconnect \n              }\n            });\n            window.dispatchEvent(logoutEvent);\n            break;\n          }\n          \n          case ErrorActionFrontend.REDIRECT: {\n            const redirectPolicy: Error_Frontend_RedirectPolicy | undefined = (wildoErrorParam as WildoError_Frontend).redirectPolicy;\n            if (redirectPolicy) {\n              switch (redirectPolicy) {\n                case Error_Frontend_RedirectPolicy.LOGIN:\n                  window.location.href = '/login';\n                  break;\n                case Error_Frontend_RedirectPolicy.HOME:\n                  window.location.href = '/';\n                  break;\n                case Error_Frontend_RedirectPolicy.HISTORY_BACK:\n                  window.history.back();\n                  break;\n                default:\n                  logDebug('Redirect policy handled by error boundary', { policy: redirectPolicy });\n                  break;\n              }\n            }\n            break;\n          }\n          \n          case ErrorActionFrontend.REFRESH_TOKEN: {\n            const errorTypeRefresh: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n            const timestampRefresh: Date = (wildoErrorParam as WildoError_Frontend).timestamp;\n            \n            const refreshEvent = new CustomEvent(WINDOW_EVENTS_SLUGS.REFRESH_TOKEN, {\n              detail: { \n                reason: 'error_refresh', \n                errorType: errorTypeRefresh,\n                timestamp: timestampRefresh \n              }\n            });\n            window.dispatchEvent(refreshEvent);\n            break;\n          }\n          \n          case ErrorActionFrontend.SHOW_MODAL: {\n            const errorTypeModal: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n            const errorDefinitionModal = ERROR_DEFINITIONS[errorTypeModal];\n            const customMessageReferenceModal: string = (wildoErrorParam as WildoError_Frontend).customMessageReference;\n            const messageModal = customMessageReferenceModal || errorDefinitionModal.description;\n            const contextModal: Record<string, any> | undefined = (wildoErrorParam as WildoError_Frontend).context;\n            \n            frontendEventBus.emit(FrontendEvents.NAVIGATION_PUSH, {\n              zone: NavigationZone.OVERLAY,\n              content: {\n                contentType: NavigationContentType.ERROR_MODAL,\n                errorType: errorTypeModal,\n                message: messageModal,\n                context: contextModal,\n                wildoError: wildoErrorParam,\n              },\n              stackEntryId: `error_modal_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,\n              navigationSource: NavigationSource.CONTROLLER,\n            });\n            break;\n          }\n          \n          case ErrorActionFrontend.RETRY:\n            break;\n        }\n      } catch (actionError) {\n        console.warn('Failed to execute frontend error action', {\n          action,\n          originalError: wildoErrorParam,\n          actionError: actionError instanceof Error ? actionError.message : String(actionError)\n        });\n      }\n    });\n  }, []);\n\n  const handleWildoError = useCallback((wildoErrorParam: WildoError_Frontend) => {\n    const context: Record<string, any> | undefined = (wildoErrorParam as WildoError_Frontend).context;\n    /*\n     * Logged at the error's OWN severity. This handler used to write every error to the console at\n     * `error` level, so a LOW-severity outcome the behaviour matrix had already decided to keep from\n     * the user — a dangling optional reference answering 404 on a silent label probe — still arrived\n     * in the console as a red line on every render, indistinguishable from a real failure. The\n     * matrix is the one place that ranks an error; the console line follows it.\n     */\n    const logAtSeverity = (message: string): void => {\n      switch (wildoErrorParam.severity) {\n        case ErrorSeverity.LOW:\n          logger.debug(message, context);\n          break;\n        case ErrorSeverity.MEDIUM:\n          logger.warn(message, context);\n          break;\n        default:\n          logger.error(message, context);\n      }\n    };\n    if (context && typeof context === 'object' && 'originalError' in context) {\n      const originalError = context.originalError as unknown;\n      const errorMessage = originalError instanceof Error\n        ? originalError.message\n        : typeof originalError === 'string'\n          ? originalError\n          : String(originalError);\n      logAtSeverity(errorMessage);\n    } else {\n      const customMessageReference: string = (wildoErrorParam as WildoError_Frontend).customMessageReference;\n      logAtSeverity(customMessageReference);\n    }\n\n    executeFrontendActions(wildoErrorParam);\n  }, [executeFrontendActions]);\n\n  const handleError = useCallback((error: Error|any, customMessage?: string, additionalContext?: Record<string, unknown>) => {\n    const normalizedWildoError = error?.wildoError as WildoError_Frontend | undefined;\n    if (normalizedWildoError) {\n      const enrichedWildoError: WildoError_Frontend = {\n        ...normalizedWildoError,\n        context: {\n          ...(normalizedWildoError.context || {}),\n          ...(customMessage ? { originalError: customMessage } : {}),\n          ...additionalContext,\n        },\n      };\n\n      if ((error as any).wildoErrorEventEmitted === true) {\n        logger.error(enrichedWildoError.customMessageReference, enrichedWildoError.context as Record<string, any> | undefined);\n        return;\n      }\n\n      handleWildoError(enrichedWildoError);\n      return;\n    }\n\n    const errorType = ErrorManagementService.classifyError(error);\n    const errorMessage = customMessage || error?.message || 'Unknown error';\n    const errorDefinition = ERROR_DEFINITIONS[errorType];\n\n    const errorContext = {\n      originalError: errorMessage,\n      ...additionalContext\n    };\n\n    const wildoError = sharedErrorBuilder.buildWildoError_Frontend(errorType, {\n      customMessageReference: errorDefinition?.defaultCustomMessageReference,\n      context: errorContext\n    });\n\n    handleWildoError(wildoError);\n  }, [handleWildoError]);\n\n  const value = useMemo<ErrorContextType>(() => ({\n    handleError,\n    handleWildoError,\n    setUserContext,\n  }), [handleError, handleWildoError, setUserContext]);\n\n  return <ErrorContext.Provider value={value}>{children}</ErrorContext.Provider>;\n};\n\n// useError hook is now in separate file: ./useError.ts\n// This separation is required for React Fast Refresh compatibility\n\n/**\n * Utility function to create error with minimal config\n * @__PURE__\n */\nconst createError = /* #__PURE__ */ (\n  message: string, \n  type: ErrorType = ErrorType.UNKNOWN, \n  overrides?: {\n    customMessageReference?: ErrorCustomMessageReference,\n    operationPathKey?: string,\n    context?: Record<string, any>\n  }\n): { error: Error; wildoError: WildoError_Frontend } => {\n  const error = new Error(message);\n  \n  const wildoError = sharedErrorBuilder.buildWildoError_Frontend(type, {\n    customMessageReference: overrides?.customMessageReference,\n    operationPathKey: overrides?.operationPathKey,\n    context: { \n      originalMessage: message, \n      ...overrides?.context \n    }\n  });\n  \n  return { error, wildoError };\n}; "]}
+{"version":3,"file":"ErrorContext.js","sourceRoot":"","sources":["../../../../../src/core/errors/ErrorContext.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  ERROR_DEFINITIONS,\n  ErrorActionFrontend,\n  ErrorType,\n  Error_Frontend_RedirectPolicy,\n  ResourcePrimaryScope,\n  WildoError_Frontend, describeCaughtError } from '@wildo-ai/saas-models';\nimport React, { ReactNode, createContext, useState, useEffect, useCallback, useMemo } from 'react';\nimport { WINDOW_EVENTS_SLUGS } from '~wildo-frontend-lib/core/commons/window-event.frontend.schemas';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { sharedErrorBuilder } from './errors-builder.frontend.services';\nimport { frontendEventBus } from '~wildo-frontend-lib/core/events/event-bus.frontend.service';\nimport { ErrorManagementService } from './error-management.frontend.service';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { NavigationZone, NavigationContentType, NavigationSource } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { ErrorSeverity, FrontendNotificationCustomMessageRefs } from '@wildo-ai/saas-models';\nimport { ErrorContextType } from './errors.frontend.schemas';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('ErrorContext');\nlogger.setDebugTypeLogging('ErrorContext', false);\n\n/**\n * Error Context\n * Exported for use in separate hook file (Fast Refresh compatibility)\n * @internal - Use useError() hook instead of accessing this directly\n */\nexport const ErrorContext: React.Context<ErrorContextType | undefined> = createContext<ErrorContextType | undefined>(undefined);\n\nexport const ErrorProvider: React.FC<{ children: ReactNode }> = ({ children }) => {\n  const { on } = useEventBus();\n\n  const setUserContext = useCallback((userId?: string, organizationId?: string) => {\n    sharedErrorBuilder.updateUserId(userId);\n    sharedErrorBuilder.updateOrganizationId(organizationId);\n  }, []);\n\n  /*\n   * Attribute error reports to the person this tab knows, and to nobody once they are gone (#1977).\n   * Before `USER_LOGIN` had a producer this listener never ran; it also had no `USER_LOGOUT` half, so\n   * once it did run, errors raised after a sign-out would have been reported as the previous person's.\n   */\n  useEffect(() => {\n    const unsubscribe = on(FrontendEvents.USER_LOGIN, (payload) => {\n      if (payload.userId) {\n        setUserContext(payload.userId, undefined);\n      }\n    });\n\n    const unsubscribeLogout = on(FrontendEvents.USER_LOGOUT, () => {\n      setUserContext(undefined, undefined);\n    });\n    \n    const unsubscribe2 = on(FrontendEvents.PRIMARY_SCOPE_CHANGED, (payload) => {\n      if (payload.scopeLevel === ResourcePrimaryScope.ORGANIZATIONS && payload.newValue) {\n        sharedErrorBuilder.updateOrganizationId(payload.newValue);\n      }\n    });\n    \n    return () => {\n      unsubscribe();\n      unsubscribeLogout();\n      unsubscribe2();\n    };\n  }, [on, setUserContext]);\n\n  const executeFrontendActions = useCallback((wildoErrorParam: WildoError_Frontend) => {\n    const frontendActions: ErrorActionFrontend[] = ((wildoErrorParam as WildoError_Frontend).frontendActions || []) as ErrorActionFrontend[];\n    frontendActions.forEach(action => {\n      try {\n        switch (action) {\n          case ErrorActionFrontend.NOTIFY:\n          case ErrorActionFrontend.SHOW_TOAST: {\n            const showToUser: boolean | undefined = (wildoErrorParam as WildoError_Frontend).showToUser;\n            if (showToUser !== false) {\n              const errorType: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n              const errorDefinition = ERROR_DEFINITIONS[errorType];\n              const customMessageReference: string = (wildoErrorParam as WildoError_Frontend).customMessageReference;\n              const context = wildoErrorParam.context as Record<string, unknown> | undefined;\n              const userGuidance = (wildoErrorParam as any).userGuidance as { explanation?: string; resolution?: string } | undefined;\n              const message = userGuidance?.explanation\n                || userGuidance?.resolution\n                || (context?.message as string)\n                || (context?.errorMessage as string)\n                || (context?.originalMessage as string)\n                || customMessageReference\n                || errorDefinition.description;\n              \n              const eventPayload = {\n                identifier: FrontendNotificationCustomMessageRefs.A_TEMP_REF,\n                data: {\n                  message,\n                  errorType: wildoErrorParam.type,\n                  customMessageReference: wildoErrorParam.customMessageReference,\n                  context,\n                },\n              } as const;\n              \n              switch (errorDefinition.severity) {\n                case 'critical':\n                case 'high':\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_ERROR, eventPayload);\n                  break;\n                case 'medium':\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_WARNING, eventPayload);\n                  break;\n                case 'low':\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_INFO, eventPayload);\n                  break;\n                default:\n                  frontendEventBus.emit(FrontendEvents.NOTIFY_CUSTOM_ERROR, eventPayload);\n              }\n            }\n            break;\n          }\n          \n          case ErrorActionFrontend.DISCONNECT: {\n            const errorTypeDisconnect: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n            const timestampDisconnect: Date = (wildoErrorParam as WildoError_Frontend).timestamp;\n            \n            const logoutEvent = new CustomEvent(WINDOW_EVENTS_SLUGS.LOGOUT, {\n              detail: { \n                reason: 'error_disconnect', \n                errorType: errorTypeDisconnect,\n                timestamp: timestampDisconnect \n              }\n            });\n            window.dispatchEvent(logoutEvent);\n            break;\n          }\n          \n          case ErrorActionFrontend.REDIRECT: {\n            const redirectPolicy: Error_Frontend_RedirectPolicy | undefined = (wildoErrorParam as WildoError_Frontend).redirectPolicy;\n            if (redirectPolicy) {\n              switch (redirectPolicy) {\n                case Error_Frontend_RedirectPolicy.LOGIN:\n                  window.location.href = '/login';\n                  break;\n                case Error_Frontend_RedirectPolicy.HOME:\n                  window.location.href = '/';\n                  break;\n                case Error_Frontend_RedirectPolicy.HISTORY_BACK:\n                  window.history.back();\n                  break;\n                default:\n                  logDebug('Redirect policy handled by error boundary', { policy: redirectPolicy });\n                  break;\n              }\n            }\n            break;\n          }\n          \n          case ErrorActionFrontend.REFRESH_TOKEN: {\n            const errorTypeRefresh: ErrorType = (wildoErrorParam as WildoError_Frontend).type;\n            const timestampRefresh: Date = (wildoErrorParam as WildoError_Frontend).timestamp;\n            \n            const refreshEvent = new CustomEvent(WINDOW_EVENTS_SLUGS.REFRESH_TOKEN, {\n              detail: { \n                reason: 'error_refresh', \n                errorType: errorTypeRefresh,\n                timestamp: timestampRefresh \n              }\n            });\n            window.dispatchEvent(refreshEvent);\n            break;\n          }\n          \n          case ErrorActionFrontend.SHOW_MODAL: {\n            // The error itself, never text: this provider sits ABOVE the I18nProvider, so the modal's renderer\n            // (`ErrorModalContent`) resolves the words. The raw reference, `ERROR_DEFINITIONS` developer\n            // description and request context pushed here used to reach the screen (#1159).\n            frontendEventBus.emit(FrontendEvents.NAVIGATION_PUSH, {\n              zone: NavigationZone.OVERLAY,\n              content: {\n                contentType: NavigationContentType.ERROR_MODAL,\n                errorType: (wildoErrorParam as WildoError_Frontend).type,\n                wildoError: wildoErrorParam,\n              },\n              stackEntryId: `error_modal_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,\n              navigationSource: NavigationSource.CONTROLLER,\n            });\n            break;\n          }\n          \n          case ErrorActionFrontend.RETRY:\n            break;\n        }\n      } catch (actionError) {\n        console.warn('Failed to execute frontend error action', {\n          action,\n          originalError: wildoErrorParam,\n          actionError: describeCaughtError(actionError)\n        });\n      }\n    });\n  }, []);\n\n  const handleWildoError = useCallback((wildoErrorParam: WildoError_Frontend) => {\n    const context: Record<string, any> | undefined = (wildoErrorParam as WildoError_Frontend).context;\n    /*\n     * Logged at the error's OWN severity. This handler used to write every error to the console at\n     * `error` level, so a LOW-severity outcome the behaviour matrix had already decided to keep from\n     * the user — a dangling optional reference answering 404 on a silent label probe — still arrived\n     * in the console as a red line on every render, indistinguishable from a real failure. The\n     * matrix is the one place that ranks an error; the console line follows it.\n     */\n    const logAtSeverity = (message: string): void => {\n      switch (wildoErrorParam.severity) {\n        case ErrorSeverity.LOW:\n          logger.debug(message, context);\n          break;\n        case ErrorSeverity.MEDIUM:\n          logger.warn(message, context);\n          break;\n        default:\n          logger.error(message, context);\n      }\n    };\n    if (context && typeof context === 'object' && 'originalError' in context) {\n      const originalError = context.originalError as unknown;\n      const errorMessage = originalError instanceof Error\n        ? originalError.message\n        : typeof originalError === 'string'\n          ? originalError\n          : String(originalError);\n      logAtSeverity(errorMessage);\n    } else {\n      const customMessageReference: string = (wildoErrorParam as WildoError_Frontend).customMessageReference;\n      logAtSeverity(customMessageReference);\n    }\n\n    executeFrontendActions(wildoErrorParam);\n  }, [executeFrontendActions]);\n\n  const handleError = useCallback((error: Error|any, customMessage?: string, additionalContext?: Record<string, unknown>) => {\n    const normalizedWildoError = error?.wildoError as WildoError_Frontend | undefined;\n    if (normalizedWildoError) {\n      const enrichedWildoError: WildoError_Frontend = {\n        ...normalizedWildoError,\n        context: {\n          ...(normalizedWildoError.context || {}),\n          ...(customMessage ? { originalError: customMessage } : {}),\n          ...additionalContext,\n        },\n      };\n\n      // Already emitted AND displayed: the global handler showed it, so a second toast would duplicate it.\n      // A `silent` request is different — its event was emitted with `suppressUserDisplay`, which means\n      // \"the CALLER owns the user-facing message\". A caller reporting it here IS that owner, so it is\n      // displayed. Treating every emitted error as displayed is what left a refused form save with no\n      // words of its own: the form fell back to a fresh `Error`, classified as an uncaught exception (#1447).\n      if ((error as any).wildoErrorEventEmitted === true && (normalizedWildoError as any).suppressUserDisplay !== true) {\n        logger.error(enrichedWildoError.customMessageReference, enrichedWildoError.context as Record<string, any> | undefined);\n        return;\n      }\n\n      handleWildoError(enrichedWildoError);\n      return;\n    }\n\n    const errorType = ErrorManagementService.classifyError(error);\n    const errorMessage = customMessage || error?.message || 'Unknown error';\n    const errorDefinition = ERROR_DEFINITIONS[errorType];\n\n    const errorContext = {\n      originalError: errorMessage,\n      ...additionalContext\n    };\n\n    const wildoError = sharedErrorBuilder.buildWildoError_Frontend(errorType, {\n      customMessageReference: errorDefinition?.defaultCustomMessageReference,\n      context: errorContext\n    });\n\n    handleWildoError(wildoError);\n  }, [handleWildoError]);\n\n  const value = useMemo<ErrorContextType>(() => ({\n    handleError,\n    handleWildoError,\n    setUserContext,\n  }), [handleError, handleWildoError, setUserContext]);\n\n  return <ErrorContext.Provider value={value}>{children}</ErrorContext.Provider>;\n};\n\n// useError hook is now in separate file: ./useError.ts\n// This separation is required for React Fast Refresh compatibility\n"]}

package/dist/esm/core/errors/ErrorModalContent.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+export interface ErrorModalContentProps {
+    /** The error carried by the `ERROR_MODAL` navigation entry — resolved here, never rendered raw. */
+    wildoError: unknown;
+}
+/**
+ * Body of an `ERROR_MODAL` overlay entry (pushed by `ErrorContext` for a `SHOW_MODAL` action).
+ *
+ * Shows ONE thing: the error's localized message, resolved through `useUserFacingErrorMessage` — with no
+ * surface words, since the modal speaks for no particular screen, so a generic bucket shows its own label.
+ *
+ * It deliberately shows nothing else (#1159). It used to render the error TYPE as a heading (`VALIDATION`),
+ * the raw i18n reference as the body, and the whole request context as JSON (`url`, `method`,
+ * `originalMessage`, Zod issues). None of that is for a person; the context remains in the error-handler
+ * logs, where it belongs.
+ */
+export declare const ErrorModalContent: React.FC<ErrorModalContentProps>;
+//# sourceMappingURL=ErrorModalContent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorModalContent.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/ErrorModalContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,sBAAsB;IACrC,mGAAmG;IACnG,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAQ9D,CAAC"}

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

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useUserFacingErrorMessage } from '../../core/errors/useUserFacingErrorMessage.js';
+/**
+ * Body of an `ERROR_MODAL` overlay entry (pushed by `ErrorContext` for a `SHOW_MODAL` action).
+ *
+ * Shows ONE thing: the error's localized message, resolved through `useUserFacingErrorMessage` — with no
+ * surface words, since the modal speaks for no particular screen, so a generic bucket shows its own label.
+ *
+ * It deliberately shows nothing else (#1159). It used to render the error TYPE as a heading (`VALIDATION`),
+ * the raw i18n reference as the body, and the whole request context as JSON (`url`, `method`,
+ * `originalMessage`, Zod issues). None of that is for a person; the context remains in the error-handler
+ * logs, where it belongs.
+ */
+export const ErrorModalContent = ({ wildoError }) => {
+    const toUserFacingErrorMessage = useUserFacingErrorMessage();
+    return (_jsx("div", { className: "space-y-element", children: _jsx("p", { className: "text-sm text-muted-foreground whitespace-pre-wrap", children: toUserFacingErrorMessage(wildoError) }) }));
+};
+//# sourceMappingURL=ErrorModalContent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorModalContent.js","sourceRoot":"","sources":["../../../../../src/core/errors/ErrorModalContent.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAOtG;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;IACpF,MAAM,wBAAwB,GAAG,yBAAyB,EAAE,CAAC;IAE7D,OAAO,CACL,cAAK,SAAS,EAAC,iBAAiB,YAC9B,YAAG,SAAS,EAAC,mDAAmD,YAAE,wBAAwB,CAAC,UAAU,CAAC,GAAK,GACvG,CACP,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import React from 'react';\nimport { useUserFacingErrorMessage } from '~wildo-frontend-lib/core/errors/useUserFacingErrorMessage';\n\nexport interface ErrorModalContentProps {\n  /** The error carried by the `ERROR_MODAL` navigation entry — resolved here, never rendered raw. */\n  wildoError: unknown;\n}\n\n/**\n * Body of an `ERROR_MODAL` overlay entry (pushed by `ErrorContext` for a `SHOW_MODAL` action).\n *\n * Shows ONE thing: the error's localized message, resolved through `useUserFacingErrorMessage` — with no\n * surface words, since the modal speaks for no particular screen, so a generic bucket shows its own label.\n *\n * It deliberately shows nothing else (#1159). It used to render the error TYPE as a heading (`VALIDATION`),\n * the raw i18n reference as the body, and the whole request context as JSON (`url`, `method`,\n * `originalMessage`, Zod issues). None of that is for a person; the context remains in the error-handler\n * logs, where it belongs.\n */\nexport const ErrorModalContent: React.FC<ErrorModalContentProps> = ({ wildoError }) => {\n  const toUserFacingErrorMessage = useUserFacingErrorMessage();\n\n  return (\n    <div className=\"space-y-element\">\n      <p className=\"text-sm text-muted-foreground whitespace-pre-wrap\">{toUserFacingErrorMessage(wildoError)}</p>\n    </div>\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;AAiEpE;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,GACR,EAAE,uBAAuB,GAAG,IAAI,CAqMhC;AAED,eAAe,kBAAkB,CAAC"}
+{"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"}

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

@@ -14,13 +14,14 @@
 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 } from '../../core/events/events.frontend.schemas.js';
+import { FrontendEvents, SessionEndReason } from '../../core/events/events.frontend.schemas.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 { resolveUserFacingErrorMessage } from './user-facing-error-message.frontend.utils.js';
 const logger = LoggerFrontendService.getLogger();
 const logDebug = logger.debugByType('GlobalErrorHandler');
 logger.setDebugTypeLogging('GlobalErrorHandler', false);
@@ -40,39 +41,6 @@ function severityToNotificationType(severity) {
             return 'error';
     }
 }
-/**
- * Extract a human, localized display message from an error.
- *
- * `tErrorMessage(ref)` resolves `errors_messages.{ref}.msg`; when no label
- * exists it returns the key path (ending in `.{ref}.msg`), so we guard against
- * that before trusting it. The backend `customMessageReference` (e.g.
- * `"validation"`) is otherwise an i18n KEY, not a sentence — surfacing it raw is
- * the bug this resolution fixes. Falls back to any backend-provided human
- * message, then the error definition description, then a generic string.
- */
-function extractErrorMessage(wildoError, tErrorMessage) {
-    const errorDefinition = ERROR_DEFINITIONS[wildoError.type];
-    const context = wildoError.context;
-    const userGuidance = wildoError.userGuidance;
-    const ref = wildoError.customMessageReference;
-    let localizedRef;
-    if (ref) {
-        const resolved = tErrorMessage(ref);
-        // tErrorMessage returns the key path (`...{ref}.msg`) when unresolved.
-        if (resolved && !resolved.endsWith(`.${ref}.msg`)) {
-            localizedRef = resolved;
-        }
-    }
-    return (userGuidance?.explanation ||
-        userGuidance?.resolution ||
-        localizedRef ||
-        context?.message ||
-        context?.errorMessage ||
-        context?.originalMessage ||
-        ref ||
-        errorDefinition?.description ||
-        'An error occurred');
-}
 /**
  * Global Error Handler Component
  *
@@ -85,21 +53,20 @@ function extractErrorMessage(wildoError, tErrorMessage) {
 export function GlobalErrorHandler({ onError, }) {
     const { on } = useEventBus();
     const { handleWildoError } = useError();
-    const { logout, isAuthenticated } = useAuthSession();
+    const { endSession, isAuthenticated } = useAuthSession();
     const { notifyError, notifyWarning, notifyInfo } = useNotification();
-    // Resolver for backend error references → localized human messages. No deps
-    // requested: this only borrows the resolver; it resolves against already-loaded
-    // labels and falls back gracefully when an error label is absent.
+    // Resolvers for backend error references and guidance → localized human messages. No deps
+    // requested: `errors_*` sections load eagerly, so this only borrows the resolvers.
     //
     // Held in a ref: `tErrorMessage` (and the whole I18n context value) is NOT
     // memoized, so a new identity is produced on every I18nProvider render. Using it
     // directly as a `useCallback` dep would ripple through `showErrorNotification` →
     // `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 resolver.
-    const { tErrorMessage } = useI18n();
-    const tErrorMessageRef = useRef(tErrorMessage);
-    tErrorMessageRef.current = tErrorMessage;
+    // subscription) stable while always reading the latest resolvers.
+    const { tErrorMessage, tErrorGuidance } = useI18n();
+    const translatorsRef = useRef({ tErrorMessage, tErrorGuidance });
+    translatorsRef.current = { tErrorMessage, tErrorGuidance };
     /**
      * Tear down the AuthSession in response to a `triggerLogout` error.
      *
@@ -111,12 +78,13 @@ export function GlobalErrorHandler({ onError, }) {
     const handleForcedLogout = useCallback(() => {
         if (isAuthenticated()) {
             logDebug('triggerLogout requested - logging out via AuthSession');
-            logout();
+            // The backend refused the session; the person did not sign out, so `USER_LOGOUT` says so (#1977).
+            endSession(SessionEndReason.SESSION_ENDED);
         }
         else {
             logDebug('triggerLogout requested but not authenticated - skipping logout');
         }
-    }, [logout, isAuthenticated]);
+    }, [endSession, isAuthenticated]);
     /**
      * Show error notification via NotificationContext
      * Uses policy-driven display (toast + optional notification center)
@@ -124,7 +92,11 @@ export function GlobalErrorHandler({ onError, }) {
     const showErrorNotification = useCallback((wildoError) => {
         const errorDefinition = ERROR_DEFINITIONS[wildoError.type];
         const severity = wildoError.severity || errorDefinition?.severity || ErrorSeverity.MEDIUM;
-        const message = extractErrorMessage(wildoError, tErrorMessageRef.current);
+        // The global toast speaks for no particular surface, so no surface words are passed: a generic
+        // bucket shows its own label. Server `context.message` / `originalMessage` and the raw reference
+        // are never shown — an unresolvable message falls to the default label, or to its key path when
+        // even that is unauthored (see `resolveUserFacingErrorMessage`).
+        const message = resolveUserFacingErrorMessage(wildoError, { translators: translatorsRef.current });
         const notificationType = severityToNotificationType(severity);
         // Use appropriate notification method based on severity
         const notificationData = {