@wildo-ai/saas-frontend-lib 1.1.3 → 1.1.5

package/dist/esm/core/errors/errors.frontend.schemas.d.ts

@@ -177,24 +177,37 @@ export declare const ERROR_DEDUPLICATION_WINDOW_MS = 5000;
  */
 export declare const ERROR_MAX_DUPLICATES = 3;
 /**
- * Enhanced Error interface for extracting error information from HTTP client errors
- * Used by resource layout presets for displaying error information
+ * The TECHNICAL facts of a caught error: a code a person may quote to support, and the structured context.
+ *
+ * It deliberately carries NO `message` (#1160). It used to, and that field held text no person should read:
+ * a backend error's `customMessageReference` (an i18n KEY such as `validation`), a plain `Error`'s developer
+ * text, or `String(err)`. Every screen that rendered it showed a key or developer English in every locale.
+ * Text for a person comes only from `resolveUserFacingErrorMessage` / `useUserFacingErrorMessage` — see
+ * {@link DisplayableError}.
  */
 export interface EnhancedError {
-    message: string;
     code?: string;
     context?: Record<string, any>;
 }
 /**
- * Extract enhanced error information from HTTP client errors.
- * Shared utility used by resource layout presets (List, Search, etc.).
+ * A caught error prepared for DISPLAY: the technical facts plus `message`, the text a person reads.
+ *
+ * `message` must come from `resolveUserFacingErrorMessage` / `useUserFacingErrorMessage` (localized, never the
+ * error's own text). Keeping it a separate type is what makes the contract checkable: a screen cannot render
+ * an `EnhancedError`'s message because it has none.
+ */
+export interface DisplayableError extends EnhancedError {
+    message: string;
+}
+/**
+ * Extract the technical facts of an error. Shared by resource layout presets (List, Search, Header, …).
+ *
+ * Three-tier classification —
+ *   1. Structured `WildoError_Backend`: `customMessageReference` as `code`, plus its `context`.
+ *   2. Any other object (a plain `Error`, the HTTP client's rejection): its own `code` and `context`.
+ *   3. Anything else: no facts.
  *
- * E-1: Three-tier classification —
- *   1. Structured `WildoError_Backend` (preferred): use `customMessageReference`
- *      as `code` and propagate `context` from the structured payload so the
- *      UI can resolve a localized, branded message.
- *   2. Plain `Error` instances or `{ message, code, context }`-shaped objects.
- *   3. Anything else: stringify.
+ * Returns no display text by design; resolve that with `useUserFacingErrorMessage(err)`.
  */
 export declare function extractErrorInfo(err: unknown): EnhancedError;
 //# sourceMappingURL=errors.frontend.schemas.d.ts.map

package/dist/esm/core/errors/errors.frontend.schemas.d.ts.map

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

package/dist/esm/core/errors/errors.frontend.schemas.js

@@ -21,20 +21,18 @@ export const ERROR_DEDUPLICATION_WINDOW_MS = 5000;
  */
 export const ERROR_MAX_DUPLICATES = 3;
 /**
- * Extract enhanced error information from HTTP client errors.
- * Shared utility used by resource layout presets (List, Search, etc.).
+ * Extract the technical facts of an error. Shared by resource layout presets (List, Search, Header, …).
  *
- * E-1: Three-tier classification —
- *   1. Structured `WildoError_Backend` (preferred): use `customMessageReference`
- *      as `code` and propagate `context` from the structured payload so the
- *      UI can resolve a localized, branded message.
- *   2. Plain `Error` instances or `{ message, code, context }`-shaped objects.
- *   3. Anything else: stringify.
+ * Three-tier classification —
+ *   1. Structured `WildoError_Backend`: `customMessageReference` as `code`, plus its `context`.
+ *   2. Any other object (a plain `Error`, the HTTP client's rejection): its own `code` and `context`.
+ *   3. Anything else: no facts.
+ *
+ * Returns no display text by design; resolve that with `useUserFacingErrorMessage(err)`.
  */
 export function extractErrorInfo(err) {
     if (isWildoBackendError(err)) {
         return {
-            message: err.customMessageReference,
             code: err.customMessageReference,
             context: err.context,
         };
@@ -42,11 +40,10 @@ export function extractErrorInfo(err) {
     if (err && typeof err === 'object') {
         const error = err;
         return {
-            message: error.message || 'An unexpected error occurred',
             code: error.code,
             context: error.context,
         };
     }
-    return { message: String(err) };
+    return {};
 }
 //# sourceMappingURL=errors.frontend.schemas.js.map

package/dist/esm/core/errors/errors.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/errors/errors.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAQL,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AA6N/B,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAgBtC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,sBAAsB;YACnC,IAAI,EAAE,GAAG,CAAC,sBAAsB;YAChC,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,GAAU,CAAC;QACzB,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,8BAA8B;YACxD,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AAClC,CAAC","sourcesContent":["/**\n * Frontend Error Management Schemas\n * \n * Centralized definitions for all frontend-specific error handling types, interfaces, and enums.\n * \n * Note: Core error types (ErrorType, ErrorSeverity, ErrorActionFrontend, WildoError_Frontend, etc.)\n * are defined in @wildo-ai/saas-models and should be imported from there.\n * \n * This file contains ONLY frontend-specific extensions and configurations.\n */\n\nimport {\n  ErrorType,\n  ErrorSeverity,\n  ErrorActionFrontend,\n  Error_Frontend_RedirectPolicy,\n  HttpStatusCode,\n  ResourceOperationRiskLevel,\n  WildoError_Frontend,\n  isWildoBackendError,\n} from '@wildo-ai/saas-models';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Error Source Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Error source identifier - tracks where the error originated\n */\nexport type ErrorSource = 'http' | 'react' | 'router' | 'websocket' | 'promise' | 'manual';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// HTTP Error Behavior Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * HTTP Error Behavior Configuration\n * Defines how a specific HTTP status code should be handled\n */\nexport interface HttpErrorBehavior {\n  /** The error type to classify this HTTP error as */\n  errorType: ErrorType;\n  \n  /** Severity level for logging and alerting */\n  severity: ErrorSeverity;\n  \n  /** Actions to execute on the frontend */\n  frontendActions: ErrorActionFrontend[];\n  \n  /** Redirect policy for navigation errors */\n  redirectPolicy?: Error_Frontend_RedirectPolicy;\n  \n  /** Whether to show the error to the user */\n  showToUser: boolean;\n  \n  /** Whether to automatically trigger logout for auth errors */\n  triggerLogout?: boolean;\n  \n  /** Whether to emit ERROR_OCCURED event (default: true) */\n  emitEvent?: boolean;\n  \n  /** Whether this error should be retried automatically */\n  shouldRetry?: boolean;\n  \n  /** Maximum retry attempts */\n  maxRetries?: number;\n  \n  /** Description for logging */\n  description: string;\n}\n\n/**\n * Risk-level specific overrides for an HTTP error behavior\n * Allows modifying specific properties based on operation risk\n */\nexport type HttpErrorBehaviorRiskOverride = Partial<Omit<HttpErrorBehavior, 'errorType' | 'description'>>;\n\n/**\n * Complete behavior definition with optional risk-level overrides\n */\nexport interface HttpErrorBehaviorWithRiskOverrides {\n  /** Base behavior (applies to all risk levels) */\n  base: HttpErrorBehavior;\n  \n  /** Risk-level specific overrides (merged with base) */\n  riskOverrides?: Partial<Record<ResourceOperationRiskLevel, HttpErrorBehaviorRiskOverride>>;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Error Context Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Base error context - common fields for all error handling contexts\n */\nexport interface BaseErrorContext {\n  /** Operation risk level - affects error behavior */\n  riskLevel?: ResourceOperationRiskLevel;\n  \n  /** Resource type if applicable */\n  resourceType?: string;\n  \n  /** Operation identifier if applicable (e.g., 'CREATE', 'READ') */\n  operationIdentifier?: string;\n  \n  /** Whether to skip global error handling (silent mode) */\n  silent?: boolean;\n  \n  /** Additional context data */\n  additionalContext?: Record<string, unknown>;\n}\n\n/**\n * HTTP Error Context\n * Context passed to HTTP error handler\n */\nexport interface HttpErrorContext extends BaseErrorContext {\n  /** The URL that was requested */\n  url?: string;\n  \n  /** The HTTP method used */\n  method?: string;\n  \n  /** Operation path key for resource operations */\n  operationPathKey?: string;\n  \n  /** Custom error message to show to user */\n  customMessage?: string;\n}\n\n/**\n * Error Manager Context\n * Context passed to unified error manager\n */\nexport interface ErrorManagerContext extends BaseErrorContext {\n  /** Error source for tracking and routing */\n  source?: ErrorSource;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Error Handler Result Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Result of HTTP error handling\n */\nexport interface HttpErrorResult {\n  /** The constructed WildoError_Frontend */\n  wildoError: WildoError_Frontend;\n  \n  /** The error behavior configuration applied */\n  behavior: HttpErrorBehavior;\n  \n  /** Whether an event was emitted */\n  eventEmitted: boolean;\n  \n  /** Whether logout should be triggered */\n  shouldLogout: boolean;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Error Deduplication Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Error fingerprint for deduplication\n * Used to identify duplicate errors within a time window\n */\nexport interface ErrorFingerprint {\n  type: ErrorType;\n  customMessageReference: string;\n  url?: string;\n  resourceType?: string;\n  operationIdentifier?: string;\n  retryAfterSeconds?: number | string;\n}\n\n/**\n * Tracked error for deduplication service\n */\nexport interface TrackedError {\n  fingerprint: ErrorFingerprint;\n  timestamp: number;\n  count: number;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// React Component Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Error Boundary State\n */\nexport interface ErrorBoundaryState {\n  hasError: boolean;\n  error: Error | null;\n  errorInfo: React.ErrorInfo | null;\n}\n\n/**\n * Error Boundary Props\n */\nexport interface ErrorBoundaryProps {\n  children: React.ReactNode;\n  fallback?: React.ComponentType<{ error: Error; errorInfo: React.ErrorInfo; resetError: () => void }>;\n  onError?: (error: Error, errorInfo: React.ErrorInfo) => void;\n}\n\n/**\n * Global Error Handler Props\n * \n * Props for the GlobalErrorHandler component which subscribes to ERROR_OCCURED events\n * and handles error processing including authentication error handling (logout).\n * \n * Note: Toast/notification display is now policy-driven via NotificationContext.\n * See notification-display-policy.frontend.schemas.ts for configuration.\n */\nexport interface GlobalErrorHandlerProps {\n  /** Optional custom error handler for additional processing */\n  onError?: (error: WildoError_Frontend) => void;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Error Context Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Error Context Type\n * Provides error handling functions to components\n */\nexport interface ErrorContextType {\n  /** Handle a generic error (Error object or any value) */\n  handleError: (error: Error | any, customMessage?: string, additionalContext?: Record<string, unknown>) => void;\n  \n  /** Handle a structured WildoError_Frontend */\n  handleWildoError: (wildoError: WildoError_Frontend) => void;\n  \n  /** Update user context for error tracking */\n  setUserContext: (userId?: string, organizationId?: string) => void;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Constants\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Default deduplication window (5 seconds)\n */\nexport const ERROR_DEDUPLICATION_WINDOW_MS = 5000;\n\n/**\n * Maximum duplicate errors before allowing through\n */\nexport const ERROR_MAX_DUPLICATES = 3;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Component-Specific Error Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Enhanced Error interface for extracting error information from HTTP client errors\n * Used by resource layout presets for displaying error information\n */\nexport interface EnhancedError {\n  message: string;\n  code?: string;\n  context?: Record<string, any>;\n}\n\n/**\n * Extract enhanced error information from HTTP client errors.\n * Shared utility used by resource layout presets (List, Search, etc.).\n *\n * E-1: Three-tier classification —\n *   1. Structured `WildoError_Backend` (preferred): use `customMessageReference`\n *      as `code` and propagate `context` from the structured payload so the\n *      UI can resolve a localized, branded message.\n *   2. Plain `Error` instances or `{ message, code, context }`-shaped objects.\n *   3. Anything else: stringify.\n */\nexport function extractErrorInfo(err: unknown): EnhancedError {\n  if (isWildoBackendError(err)) {\n    return {\n      message: err.customMessageReference,\n      code: err.customMessageReference,\n      context: err.context,\n    };\n  }\n\n  if (err && typeof err === 'object') {\n    const error = err as any;\n    return {\n      message: error.message || 'An unexpected error occurred',\n      code: error.code,\n      context: error.context,\n    };\n  }\n  return { message: String(err) };\n}\n"]}
+{"version":3,"file":"errors.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/errors/errors.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAQL,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AA6N/B,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AA+BtC;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,sBAAsB;YAChC,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,GAAU,CAAC;QACzB,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["/**\n * Frontend Error Management Schemas\n * \n * Centralized definitions for all frontend-specific error handling types, interfaces, and enums.\n * \n * Note: Core error types (ErrorType, ErrorSeverity, ErrorActionFrontend, WildoError_Frontend, etc.)\n * are defined in @wildo-ai/saas-models and should be imported from there.\n * \n * This file contains ONLY frontend-specific extensions and configurations.\n */\n\nimport {\n  ErrorType,\n  ErrorSeverity,\n  ErrorActionFrontend,\n  Error_Frontend_RedirectPolicy,\n  HttpStatusCode,\n  ResourceOperationRiskLevel,\n  WildoError_Frontend,\n  isWildoBackendError,\n} from '@wildo-ai/saas-models';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Error Source Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Error source identifier - tracks where the error originated\n */\nexport type ErrorSource = 'http' | 'react' | 'router' | 'websocket' | 'promise' | 'manual';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// HTTP Error Behavior Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * HTTP Error Behavior Configuration\n * Defines how a specific HTTP status code should be handled\n */\nexport interface HttpErrorBehavior {\n  /** The error type to classify this HTTP error as */\n  errorType: ErrorType;\n  \n  /** Severity level for logging and alerting */\n  severity: ErrorSeverity;\n  \n  /** Actions to execute on the frontend */\n  frontendActions: ErrorActionFrontend[];\n  \n  /** Redirect policy for navigation errors */\n  redirectPolicy?: Error_Frontend_RedirectPolicy;\n  \n  /** Whether to show the error to the user */\n  showToUser: boolean;\n  \n  /** Whether to automatically trigger logout for auth errors */\n  triggerLogout?: boolean;\n  \n  /** Whether to emit ERROR_OCCURED event (default: true) */\n  emitEvent?: boolean;\n  \n  /** Whether this error should be retried automatically */\n  shouldRetry?: boolean;\n  \n  /** Maximum retry attempts */\n  maxRetries?: number;\n  \n  /** Description for logging */\n  description: string;\n}\n\n/**\n * Risk-level specific overrides for an HTTP error behavior\n * Allows modifying specific properties based on operation risk\n */\nexport type HttpErrorBehaviorRiskOverride = Partial<Omit<HttpErrorBehavior, 'errorType' | 'description'>>;\n\n/**\n * Complete behavior definition with optional risk-level overrides\n */\nexport interface HttpErrorBehaviorWithRiskOverrides {\n  /** Base behavior (applies to all risk levels) */\n  base: HttpErrorBehavior;\n  \n  /** Risk-level specific overrides (merged with base) */\n  riskOverrides?: Partial<Record<ResourceOperationRiskLevel, HttpErrorBehaviorRiskOverride>>;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Error Context Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Base error context - common fields for all error handling contexts\n */\nexport interface BaseErrorContext {\n  /** Operation risk level - affects error behavior */\n  riskLevel?: ResourceOperationRiskLevel;\n  \n  /** Resource type if applicable */\n  resourceType?: string;\n  \n  /** Operation identifier if applicable (e.g., 'CREATE', 'READ') */\n  operationIdentifier?: string;\n  \n  /** Whether to skip global error handling (silent mode) */\n  silent?: boolean;\n  \n  /** Additional context data */\n  additionalContext?: Record<string, unknown>;\n}\n\n/**\n * HTTP Error Context\n * Context passed to HTTP error handler\n */\nexport interface HttpErrorContext extends BaseErrorContext {\n  /** The URL that was requested */\n  url?: string;\n  \n  /** The HTTP method used */\n  method?: string;\n  \n  /** Operation path key for resource operations */\n  operationPathKey?: string;\n  \n  /** Custom error message to show to user */\n  customMessage?: string;\n}\n\n/**\n * Error Manager Context\n * Context passed to unified error manager\n */\nexport interface ErrorManagerContext extends BaseErrorContext {\n  /** Error source for tracking and routing */\n  source?: ErrorSource;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Error Handler Result Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Result of HTTP error handling\n */\nexport interface HttpErrorResult {\n  /** The constructed WildoError_Frontend */\n  wildoError: WildoError_Frontend;\n  \n  /** The error behavior configuration applied */\n  behavior: HttpErrorBehavior;\n  \n  /** Whether an event was emitted */\n  eventEmitted: boolean;\n  \n  /** Whether logout should be triggered */\n  shouldLogout: boolean;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Error Deduplication Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Error fingerprint for deduplication\n * Used to identify duplicate errors within a time window\n */\nexport interface ErrorFingerprint {\n  type: ErrorType;\n  customMessageReference: string;\n  url?: string;\n  resourceType?: string;\n  operationIdentifier?: string;\n  retryAfterSeconds?: number | string;\n}\n\n/**\n * Tracked error for deduplication service\n */\nexport interface TrackedError {\n  fingerprint: ErrorFingerprint;\n  timestamp: number;\n  count: number;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// React Component Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Error Boundary State\n */\nexport interface ErrorBoundaryState {\n  hasError: boolean;\n  error: Error | null;\n  errorInfo: React.ErrorInfo | null;\n}\n\n/**\n * Error Boundary Props\n */\nexport interface ErrorBoundaryProps {\n  children: React.ReactNode;\n  fallback?: React.ComponentType<{ error: Error; errorInfo: React.ErrorInfo; resetError: () => void }>;\n  onError?: (error: Error, errorInfo: React.ErrorInfo) => void;\n}\n\n/**\n * Global Error Handler Props\n * \n * Props for the GlobalErrorHandler component which subscribes to ERROR_OCCURED events\n * and handles error processing including authentication error handling (logout).\n * \n * Note: Toast/notification display is now policy-driven via NotificationContext.\n * See notification-display-policy.frontend.schemas.ts for configuration.\n */\nexport interface GlobalErrorHandlerProps {\n  /** Optional custom error handler for additional processing */\n  onError?: (error: WildoError_Frontend) => void;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Error Context Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Error Context Type\n * Provides error handling functions to components\n */\nexport interface ErrorContextType {\n  /** Handle a generic error (Error object or any value) */\n  handleError: (error: Error | any, customMessage?: string, additionalContext?: Record<string, unknown>) => void;\n  \n  /** Handle a structured WildoError_Frontend */\n  handleWildoError: (wildoError: WildoError_Frontend) => void;\n  \n  /** Update user context for error tracking */\n  setUserContext: (userId?: string, organizationId?: string) => void;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Constants\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Default deduplication window (5 seconds)\n */\nexport const ERROR_DEDUPLICATION_WINDOW_MS = 5000;\n\n/**\n * Maximum duplicate errors before allowing through\n */\nexport const ERROR_MAX_DUPLICATES = 3;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Component-Specific Error Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * The TECHNICAL facts of a caught error: a code a person may quote to support, and the structured context.\n *\n * It deliberately carries NO `message` (#1160). It used to, and that field held text no person should read:\n * a backend error's `customMessageReference` (an i18n KEY such as `validation`), a plain `Error`'s developer\n * text, or `String(err)`. Every screen that rendered it showed a key or developer English in every locale.\n * Text for a person comes only from `resolveUserFacingErrorMessage` / `useUserFacingErrorMessage` — see\n * {@link DisplayableError}.\n */\nexport interface EnhancedError {\n  code?: string;\n  context?: Record<string, any>;\n}\n\n/**\n * A caught error prepared for DISPLAY: the technical facts plus `message`, the text a person reads.\n *\n * `message` must come from `resolveUserFacingErrorMessage` / `useUserFacingErrorMessage` (localized, never the\n * error's own text). Keeping it a separate type is what makes the contract checkable: a screen cannot render\n * an `EnhancedError`'s message because it has none.\n */\nexport interface DisplayableError extends EnhancedError {\n  message: string;\n}\n\n/**\n * Extract the technical facts of an error. Shared by resource layout presets (List, Search, Header, …).\n *\n * Three-tier classification —\n *   1. Structured `WildoError_Backend`: `customMessageReference` as `code`, plus its `context`.\n *   2. Any other object (a plain `Error`, the HTTP client's rejection): its own `code` and `context`.\n *   3. Anything else: no facts.\n *\n * Returns no display text by design; resolve that with `useUserFacingErrorMessage(err)`.\n */\nexport function extractErrorInfo(err: unknown): EnhancedError {\n  if (isWildoBackendError(err)) {\n    return {\n      code: err.customMessageReference,\n      context: err.context,\n    };\n  }\n\n  if (err && typeof err === 'object') {\n    const error = err as any;\n    return {\n      code: error.code,\n      context: error.context,\n    };\n  }\n  return {};\n}\n"]}

package/dist/esm/core/errors/http-error-behavior.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-error-behavior.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/errors/http-error-behavior.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,cAAc,EAKf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,kCAAkC,EACnC,MAAM,2BAA2B,CAAC;AAMnC;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,kCAAkC,CAAC,CAya1G,CAAC"}
+{"version":3,"file":"http-error-behavior.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/http-error-behavior.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,cAAc,EAKf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,kCAAkC,EACnC,MAAM,2BAA2B,CAAC;AAMnC;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,kCAAkC,CAAC,CAya1G,CAAC"}

package/dist/esm/core/errors/http-error-behavior.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-error-behavior.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/errors/http-error-behavior.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HTTP Error Behavior Matrix\n * \n * Defines how HTTP errors should be handled based on status code AND operation risk level.\n * This provides a centralized, configurable error behavior across the application.\n * \n * The matrix supports two dimensions:\n * 1. HTTP Status Code (400, 401, 403, 404, 500, etc.)\n * 2. Operation Risk Level (LOW, MEDIUM, HIGH, CRITICAL)\n * \n * Different risk levels can have different behaviors for the same HTTP error.\n * For example, a 401 on a LOW risk operation might just notify,\n * while a 401 on a CRITICAL operation triggers immediate logout.\n * \n * ## Override Capabilities\n * \n * 1. **Per-request override**: Pass `silent: true` to skip event emission\n * 2. **Risk level override**: Higher risk operations can have stricter behaviors\n * 3. **Matrix override**: Use `ErrorManagementService.setHttpErrorBehaviorOverride()` to customize behaviors\n */\n\nimport { \n  ErrorType, \n  HttpStatusCode,\n  ErrorActionFrontend,\n  Error_Frontend_RedirectPolicy,\n  ErrorSeverity,\n  ResourceOperationRiskLevel,\n} from '@wildo-ai/saas-models';\nimport {\n  HttpErrorBehavior,\n  HttpErrorBehaviorRiskOverride,\n  HttpErrorBehaviorWithRiskOverrides,\n} from './errors.frontend.schemas';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Base Matrix (HTTP Status → Behavior + Risk Overrides)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * HTTP Error Behavior Matrix with Risk Level Overrides\n * \n * Each HTTP status code has a base behavior, plus optional overrides per risk level.\n * The final behavior is computed by merging base with the applicable risk override.\n * \n * This matrix is used by ErrorManagementService.getHttpErrorBehavior().\n */\nexport const HTTP_ERROR_BEHAVIOR_MATRIX: Partial<Record<HttpStatusCode, HttpErrorBehaviorWithRiskOverrides>> = {\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 400 BAD_REQUEST - Validation Error\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.BAD_REQUEST]: {\n    base: {\n      errorType: ErrorType.VALIDATION,\n      severity: ErrorSeverity.LOW,\n      frontendActions: [], // Default: forms handle their own validation errors\n      showToUser: false,   // Default: component-level handling\n      emitEvent: true,     // Still emit for logging/analytics\n      shouldRetry: false,\n      description: 'Invalid request data - validation failed',\n    },\n    riskOverrides: {\n      // HIGH/CRITICAL: Show validation errors and notify user\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.MEDIUM,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 401 UNAUTHORIZED - Authentication Error\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.UNAUTHORIZED]: {\n    base: {\n      errorType: ErrorType.AUTHENTICATION,\n      severity: ErrorSeverity.MEDIUM,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      triggerLogout: true, // Default: logout for 401 (invalid session)\n      emitEvent: true,\n      shouldRetry: false,\n      description: 'Authentication required or token invalid',\n    },\n    riskOverrides: {\n      // LOW: Still logout, but silent (for background operations that shouldn't interrupt user)\n      // 401 means invalid session - we should logout regardless of risk level\n      [ResourceOperationRiskLevel.LOW]: {\n        triggerLogout: true, // Still logout even for LOW risk\n        frontendActions: [], // Silent - no notifications for background operations\n        showToUser: false, // Don't show to user for background polling\n      },\n      // MEDIUM: Logout with notification (default behavior - 401 usually means invalid session)\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        triggerLogout: true,\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      // HIGH/CRITICAL: Immediate logout with notification\n      [ResourceOperationRiskLevel.HIGH]: {\n        triggerLogout: true,\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        triggerLogout: true,\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 403 FORBIDDEN - Authorization Error\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.FORBIDDEN]: {\n    base: {\n      errorType: ErrorType.AUTHORIZATION,\n      severity: ErrorSeverity.MEDIUM,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: false,\n      description: 'Access forbidden - insufficient permissions',\n    },\n    riskOverrides: {\n      // LOW: Silent (background operations)\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM/HIGH: Notify user\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      // CRITICAL: Show modal and redirect\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n        redirectPolicy: Error_Frontend_RedirectPolicy.HOME,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 404 NOT_FOUND - Resource Not Found\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.NOT_FOUND]: {\n    base: {\n      errorType: ErrorType.NOT_FOUND,\n      severity: ErrorSeverity.LOW,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: false,\n      description: 'Resource not found',\n    },\n    riskOverrides: {\n      // LOW: Silent (background checks)\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM/HIGH: Notify user\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.MEDIUM,\n      },\n      // CRITICAL: Show modal and redirect\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n        redirectPolicy: Error_Frontend_RedirectPolicy.HOME,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 409 CONFLICT - Resource Conflict\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.CONFLICT]: {\n    base: {\n      errorType: ErrorType.CONFLICT,\n      severity: ErrorSeverity.MEDIUM,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: false,\n      description: 'Resource conflict - operation cannot be completed',\n    },\n    riskOverrides: {\n      // LOW: Silent\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM/HIGH: Notify user\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      // CRITICAL: Show modal\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 422 UNPROCESSABLE_ENTITY - Business Rule Violation\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.UNPROCESSABLE_ENTITY]: {\n    base: {\n      errorType: ErrorType.BUSINESS_RULE,\n      severity: ErrorSeverity.MEDIUM,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: false,\n      description: 'Business rule violation - operation cannot be completed',\n    },\n    riskOverrides: {\n      // LOW: Silent\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM/HIGH: Notify user\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      // CRITICAL: Show modal\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 429 TOO_MANY_REQUESTS - Rate Limit\n  // Transport retries are performed by WildoBackendHttpClient, which also caps\n  // long Retry-After waits before this behavior is consulted for user-facing\n  // error handling.\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.TOO_MANY_REQUESTS]: {\n    base: {\n      errorType: ErrorType.RATE_LIMIT,\n      severity: ErrorSeverity.MEDIUM,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: true,\n      maxRetries: 3,\n      description: 'Rate limit exceeded - too many requests',\n    },\n    riskOverrides: {\n      // LOW: Still notify after transport retries are exhausted. A final 429\n      // means the user's action/data load did not complete.\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      // MEDIUM/HIGH: Notify and retry\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      // CRITICAL: Show modal\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 500 INTERNAL_SERVER_ERROR - Server Error\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.INTERNAL_SERVER_ERROR]: {\n    base: {\n      errorType: ErrorType.INTERNAL,\n      severity: ErrorSeverity.HIGH,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: true,\n      maxRetries: 2,\n      description: 'Internal server error - unexpected server failure',\n    },\n    riskOverrides: {\n      // LOW: Silent retry\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM: Notify and retry\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      // HIGH/CRITICAL: Show modal and retry\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 502 BAD_GATEWAY - Gateway Error\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.BAD_GATEWAY]: {\n    base: {\n      errorType: ErrorType.NETWORK,\n      severity: ErrorSeverity.HIGH,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: true,\n      maxRetries: 2,\n      description: 'Bad gateway - upstream server error',\n    },\n    riskOverrides: {\n      // LOW: Silent retry\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM: Notify and retry\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      // HIGH/CRITICAL: Show modal and retry\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 503 SERVICE_UNAVAILABLE - Service Unavailable\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.SERVICE_UNAVAILABLE]: {\n    base: {\n      errorType: ErrorType.NETWORK,\n      severity: ErrorSeverity.HIGH,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: true,\n      maxRetries: 3,\n      description: 'Service unavailable - server temporarily unavailable',\n    },\n    riskOverrides: {\n      // LOW: Silent retry\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM: Notify and retry\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      // HIGH/CRITICAL: Show modal and retry\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 504 GATEWAY_TIMEOUT - Gateway Timeout\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.GATEWAY_TIMEOUT]: {\n    base: {\n      errorType: ErrorType.NETWORK,\n      severity: ErrorSeverity.HIGH,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: true,\n      maxRetries: 2,\n      description: 'Gateway timeout - upstream service not responding',\n    },\n    riskOverrides: {\n      // LOW: Silent retry\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM: Notify and retry\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      // HIGH/CRITICAL: Show modal and retry\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n};\n"]}
+{"version":3,"file":"http-error-behavior.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/errors/http-error-behavior.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HTTP Error Behavior Matrix\n * \n * Defines how HTTP errors should be handled based on status code AND operation risk level.\n * This provides a centralized, configurable error behavior across the application.\n * \n * The matrix supports two dimensions:\n * 1. HTTP Status Code (400, 401, 403, 404, 500, etc.)\n * 2. Operation Risk Level (LOW, MEDIUM, HIGH, CRITICAL)\n * \n * Different risk levels can have different behaviors for the same HTTP error.\n * For example, a 401 on a LOW risk operation might just notify,\n * while a 401 on a CRITICAL operation triggers immediate logout.\n * \n * ## Override Capabilities\n * \n * 1. **Per-request override**: Pass `silent: true` to skip event emission\n * 2. **Risk level override**: Higher risk operations can have stricter behaviors\n * 3. **Matrix override**: Use `ErrorManagementService.setHttpErrorBehaviorOverride()` to customize behaviors\n */\n\nimport { \n  ErrorType, \n  HttpStatusCode,\n  ErrorActionFrontend,\n  Error_Frontend_RedirectPolicy,\n  ErrorSeverity,\n  ResourceOperationRiskLevel,\n} from '@wildo-ai/saas-models';\nimport {\n  HttpErrorBehavior,\n  HttpErrorBehaviorRiskOverride,\n  HttpErrorBehaviorWithRiskOverrides,\n} from './errors.frontend.schemas';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Base Matrix (HTTP Status → Behavior + Risk Overrides)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * HTTP Error Behavior Matrix with Risk Level Overrides\n * \n * Each HTTP status code has a base behavior, plus optional overrides per risk level.\n * The final behavior is computed by merging base with the applicable risk override.\n * \n * This matrix is used by ErrorManagementService.getHttpErrorBehavior().\n */\nexport const HTTP_ERROR_BEHAVIOR_MATRIX: Partial<Record<HttpStatusCode, HttpErrorBehaviorWithRiskOverrides>> = {\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 400 BAD_REQUEST - Validation Error\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.BAD_REQUEST]: {\n    base: {\n      errorType: ErrorType.VALIDATION,\n      severity: ErrorSeverity.LOW,\n      frontendActions: [], // Default: forms handle their own validation errors\n      showToUser: false,   // Default: component-level handling\n      emitEvent: true,     // Still emit for logging/analytics\n      shouldRetry: false,\n      description: 'Invalid request data - validation failed',\n    },\n    riskOverrides: {\n      // HIGH/CRITICAL: Show validation errors and notify user\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.MEDIUM,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 401 UNAUTHORIZED - Authentication Error\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.UNAUTHORIZED]: {\n    base: {\n      errorType: ErrorType.AUTHENTICATION,\n      severity: ErrorSeverity.MEDIUM,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      triggerLogout: true, // Default: logout for 401 (invalid session)\n      emitEvent: true,\n      shouldRetry: false,\n      description: 'Authentication required or token invalid',\n    },\n    riskOverrides: {\n      // LOW: Still logout, but silent (for background operations that shouldn't interrupt user)\n      // 401 means invalid session - we should logout regardless of risk level\n      [ResourceOperationRiskLevel.LOW]: {\n        triggerLogout: true, // Still logout even for LOW risk\n        frontendActions: [], // Silent - no notifications for background operations\n        showToUser: false, // Don't show to user for background polling\n      },\n      // MEDIUM: Logout with notification (default behavior - 401 usually means invalid session)\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        triggerLogout: true,\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      // HIGH/CRITICAL: Immediate logout with notification\n      [ResourceOperationRiskLevel.HIGH]: {\n        triggerLogout: true,\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        triggerLogout: true,\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 403 FORBIDDEN - Authorization Error\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.FORBIDDEN]: {\n    base: {\n      errorType: ErrorType.AUTHORIZATION,\n      severity: ErrorSeverity.MEDIUM,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: false,\n      description: 'Access forbidden - insufficient permissions',\n    },\n    riskOverrides: {\n      // LOW: Silent (background operations)\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM/HIGH: Notify user\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      // CRITICAL: Show modal and redirect\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n        redirectPolicy: Error_Frontend_RedirectPolicy.HOME,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 404 NOT_FOUND - Resource Not Found\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.NOT_FOUND]: {\n    base: {\n      errorType: ErrorType.NOT_FOUND,\n      severity: ErrorSeverity.LOW,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: false,\n      description: 'Resource not found',\n    },\n    riskOverrides: {\n      // LOW: Silent (background checks)\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM/HIGH: Notify user\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.MEDIUM,\n      },\n      // CRITICAL: Show modal and redirect\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n        redirectPolicy: Error_Frontend_RedirectPolicy.HOME,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 409 CONFLICT - Resource Conflict\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.CONFLICT]: {\n    base: {\n      errorType: ErrorType.CONFLICT,\n      severity: ErrorSeverity.MEDIUM,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: false,\n      description: 'Resource conflict - operation cannot be completed',\n    },\n    riskOverrides: {\n      // LOW: Silent\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM/HIGH: Notify user\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      // CRITICAL: Show modal\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 422 UNPROCESSABLE_ENTITY - Business Rule Violation\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.UNPROCESSABLE_ENTITY]: {\n    base: {\n      errorType: ErrorType.BUSINESS_RULE,\n      severity: ErrorSeverity.MEDIUM,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: false,\n      description: 'Business rule violation - operation cannot be completed',\n    },\n    riskOverrides: {\n      // LOW: Silent\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM/HIGH: Notify user\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      // CRITICAL: Show modal\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 429 TOO_MANY_REQUESTS - Rate Limit\n  // Transport retries are performed by WildoBackendHttpClient, which also caps\n  // long Retry-After waits before this behavior is consulted for user-facing\n  // error handling.\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.TOO_MANY_REQUESTS]: {\n    base: {\n      errorType: ErrorType.RATE_LIMIT,\n      severity: ErrorSeverity.MEDIUM,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: true,\n      maxRetries: 3,\n      description: 'Rate limit exceeded - too many requests',\n    },\n    riskOverrides: {\n      // LOW: Still notify after transport retries are exhausted. A final 429\n      // means the user's action/data load did not complete.\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      // MEDIUM/HIGH: Notify and retry\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      // CRITICAL: Show modal\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 500 INTERNAL_SERVER_ERROR - Server Error\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.INTERNAL_SERVER_ERROR]: {\n    base: {\n      errorType: ErrorType.INTERNAL,\n      severity: ErrorSeverity.HIGH,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: true,\n      maxRetries: 2,\n      description: 'Internal server error - unexpected server failure',\n    },\n    riskOverrides: {\n      // LOW: Silent retry\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM: Notify and retry\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      // HIGH/CRITICAL: Show modal and retry\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 502 BAD_GATEWAY - Gateway Error\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.BAD_GATEWAY]: {\n    base: {\n      errorType: ErrorType.NETWORK,\n      severity: ErrorSeverity.HIGH,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: true,\n      maxRetries: 2,\n      description: 'Bad gateway - upstream server error',\n    },\n    riskOverrides: {\n      // LOW: Silent retry\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM: Notify and retry\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      // HIGH/CRITICAL: Show modal and retry\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 503 SERVICE_UNAVAILABLE - Service Unavailable\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.SERVICE_UNAVAILABLE]: {\n    base: {\n      errorType: ErrorType.NETWORK,\n      severity: ErrorSeverity.HIGH,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: true,\n      maxRetries: 3,\n      description: 'Service unavailable - server temporarily unavailable',\n    },\n    riskOverrides: {\n      // LOW: Silent retry\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM: Notify and retry\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      // HIGH/CRITICAL: Show modal and retry\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n  \n  // ─────────────────────────────────────────────────────────────────────────────\n  // 504 GATEWAY_TIMEOUT - Gateway Timeout\n  // ─────────────────────────────────────────────────────────────────────────────\n  [HttpStatusCode.GATEWAY_TIMEOUT]: {\n    base: {\n      errorType: ErrorType.NETWORK,\n      severity: ErrorSeverity.HIGH,\n      frontendActions: [ErrorActionFrontend.NOTIFY],\n      showToUser: true,\n      emitEvent: true,\n      shouldRetry: true,\n      maxRetries: 2,\n      description: 'Gateway timeout - upstream service not responding',\n    },\n    riskOverrides: {\n      // LOW: Silent retry\n      [ResourceOperationRiskLevel.LOW]: {\n        frontendActions: [],\n        showToUser: false,\n      },\n      // MEDIUM: Notify and retry\n      [ResourceOperationRiskLevel.MEDIUM]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY],\n        showToUser: true,\n      },\n      // HIGH/CRITICAL: Show modal and retry\n      [ResourceOperationRiskLevel.HIGH]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.HIGH,\n      },\n      [ResourceOperationRiskLevel.CRITICAL]: {\n        frontendActions: [ErrorActionFrontend.NOTIFY, ErrorActionFrontend.SHOW_MODAL],\n        showToUser: true,\n        severity: ErrorSeverity.CRITICAL,\n      },\n    },\n  },\n};\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useError.d.ts","sourceRoot":"","sources":["../../../../src/core/errors/useError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,QAAQ,QAAO,gBAM3B,CAAC"}
+{"version":3,"file":"useError.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/useError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,QAAQ,QAAO,gBAM3B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"useError.js","sourceRoot":"","sources":["../../../../src/core/errors/useError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAqB,EAAE;IAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/**\n * useError Hook\n * \n * Separated from ErrorContext.tsx for React Fast Refresh compatibility.\n */\n\nimport { useContext } from 'react';\nimport { ErrorContext } from './ErrorContext';\nimport { ErrorContextType } from './errors.frontend.schemas';\n\n/**\n * Hook to access the Error context\n * @returns ErrorContextType with error handling functions\n * @throws Error if used outside of ErrorProvider\n */\nexport const useError = (): ErrorContextType => {\n  const context = useContext(ErrorContext);\n  if (!context) {\n    throw new Error('useError must be used within an ErrorProvider');\n  }\n  return context;\n};\n\n\n\n"]}
+{"version":3,"file":"useError.js","sourceRoot":"","sources":["../../../../../src/core/errors/useError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAqB,EAAE;IAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/**\n * useError Hook\n * \n * Separated from ErrorContext.tsx for React Fast Refresh compatibility.\n */\n\nimport { useContext } from 'react';\nimport { ErrorContext } from './ErrorContext';\nimport { ErrorContextType } from './errors.frontend.schemas';\n\n/**\n * Hook to access the Error context\n * @returns ErrorContextType with error handling functions\n * @throws Error if used outside of ErrorProvider\n */\nexport const useError = (): ErrorContextType => {\n  const context = useContext(ErrorContext);\n  if (!context) {\n    throw new Error('useError must be used within an ErrorProvider');\n  }\n  return context;\n};\n\n\n\n"]}

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

@@ -0,0 +1,40 @@
+/**
+ * Hook form of {@link resolveUserFacingErrorMessage}, for components that display a caught error.
+ *
+ * Separated from the utils file for React Fast Refresh compatibility (a file exports either
+ * components/hooks or plain values, not both).
+ *
+ * The returned function has a STABLE identity and always reads the latest translators. The I18n
+ * context value is not memoized — `tErrorMessage` gets a new identity on every provider render — so
+ * returning a fresh closure would churn every `useCallback` that lists it as a dependency, and an
+ * effect that deliberately omits it would call a stale one. `GlobalErrorHandler` holds its resolver in
+ * a ref for the same reason.
+ */
+/** @wildo_source:part:start saas.frontend.errors.user-facing-error-message facet:layer:frontend facet:audience:app-developer */
+/**
+ * Turns a caught error into the words a person may read. Import it from `@wildo-ai/saas-frontend-lib`.
+ *
+ * Returns `(error, surfaceMessage?) => string`:
+ * - `error` — whatever was caught: a rejected request, a thrown `Error`, a failed action's `error`.
+ * - `surfaceMessage` — optional: your screen's own localized words for this failure, e.g.
+ *   `t(MyViewLabel.SAVE_FAILED)`. It replaces a generic category ("validation", "not found") that would
+ *   mislead on your screen, and is what shows when the error carries nothing displayable.
+ *
+ * The text comes from the application's error catalog, your surface words, or the backend's user
+ * guidance — never from the error's own `message`, which for a backend rejection is a reference key and
+ * for a thrown `Error` is developer text. Keep the error itself for logging; show only this.
+ *
+ * The returned function has a stable identity, so it is safe in `useCallback` / `useEffect` dependencies.
+ *
+ * @example
+ * const toUserFacingErrorMessage = useUserFacingErrorMessage();
+ * const [failure, setFailure] = useState<string | null>(null);
+ * try {
+ *   await saveNote();
+ * } catch (error) {
+ *   setFailure(toUserFacingErrorMessage(error, t(NoteViewLabel.SAVE_FAILED)));
+ * }
+ */
+export declare function useUserFacingErrorMessage(): (error: unknown, surfaceMessage?: string) => string;
+/** @wildo_source:part:end saas.frontend.errors.user-facing-error-message */
+//# sourceMappingURL=useUserFacingErrorMessage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUserFacingErrorMessage.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/useUserFacingErrorMessage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,gIAAgI;AAChI;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,yBAAyB,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,MAAM,CAU/F;AACD,4EAA4E"}

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

@@ -0,0 +1,48 @@
+/**
+ * Hook form of {@link resolveUserFacingErrorMessage}, for components that display a caught error.
+ *
+ * Separated from the utils file for React Fast Refresh compatibility (a file exports either
+ * components/hooks or plain values, not both).
+ *
+ * The returned function has a STABLE identity and always reads the latest translators. The I18n
+ * context value is not memoized — `tErrorMessage` gets a new identity on every provider render — so
+ * returning a fresh closure would churn every `useCallback` that lists it as a dependency, and an
+ * effect that deliberately omits it would call a stale one. `GlobalErrorHandler` holds its resolver in
+ * a ref for the same reason.
+ */
+import { useCallback, useRef } from 'react';
+import { useI18n } from '../../core/i18n/useI18n.js';
+import { resolveUserFacingErrorMessage, } from '../../core/errors/user-facing-error-message.frontend.utils.js';
+/** @wildo_source:part:start saas.frontend.errors.user-facing-error-message facet:layer:frontend facet:audience:app-developer */
+/**
+ * Turns a caught error into the words a person may read. Import it from `@wildo-ai/saas-frontend-lib`.
+ *
+ * Returns `(error, surfaceMessage?) => string`:
+ * - `error` — whatever was caught: a rejected request, a thrown `Error`, a failed action's `error`.
+ * - `surfaceMessage` — optional: your screen's own localized words for this failure, e.g.
+ *   `t(MyViewLabel.SAVE_FAILED)`. It replaces a generic category ("validation", "not found") that would
+ *   mislead on your screen, and is what shows when the error carries nothing displayable.
+ *
+ * The text comes from the application's error catalog, your surface words, or the backend's user
+ * guidance — never from the error's own `message`, which for a backend rejection is a reference key and
+ * for a thrown `Error` is developer text. Keep the error itself for logging; show only this.
+ *
+ * The returned function has a stable identity, so it is safe in `useCallback` / `useEffect` dependencies.
+ *
+ * @example
+ * const toUserFacingErrorMessage = useUserFacingErrorMessage();
+ * const [failure, setFailure] = useState<string | null>(null);
+ * try {
+ *   await saveNote();
+ * } catch (error) {
+ *   setFailure(toUserFacingErrorMessage(error, t(NoteViewLabel.SAVE_FAILED)));
+ * }
+ */
+export function useUserFacingErrorMessage() {
+    const { tErrorMessage, tErrorGuidance } = useI18n();
+    const translatorsRef = useRef({ tErrorMessage, tErrorGuidance });
+    translatorsRef.current = { tErrorMessage, tErrorGuidance };
+    return useCallback((error, surfaceMessage) => resolveUserFacingErrorMessage(error, { translators: translatorsRef.current, surfaceMessage }), []);
+}
+/** @wildo_source:part:end saas.frontend.errors.user-facing-error-message */
+//# sourceMappingURL=useUserFacingErrorMessage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUserFacingErrorMessage.js","sourceRoot":"","sources":["../../../../../src/core/errors/useUserFacingErrorMessage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAChE,OAAO,EACL,6BAA6B,GAE9B,MAAM,0EAA0E,CAAC;AAElF,gIAAgI;AAChI;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;IACpD,MAAM,cAAc,GAAG,MAAM,CAA0B,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC;IAC1F,cAAc,CAAC,OAAO,GAAG,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;IAE3D,OAAO,WAAW,CAChB,CAAC,KAAc,EAAE,cAAuB,EAAE,EAAE,CAC1C,6BAA6B,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,EAC/F,EAAE,CACH,CAAC;AACJ,CAAC;AACD,4EAA4E","sourcesContent":["/**\n * Hook form of {@link resolveUserFacingErrorMessage}, for components that display a caught error.\n *\n * Separated from the utils file for React Fast Refresh compatibility (a file exports either\n * components/hooks or plain values, not both).\n *\n * The returned function has a STABLE identity and always reads the latest translators. The I18n\n * context value is not memoized — `tErrorMessage` gets a new identity on every provider render — so\n * returning a fresh closure would churn every `useCallback` that lists it as a dependency, and an\n * effect that deliberately omits it would call a stale one. `GlobalErrorHandler` holds its resolver in\n * a ref for the same reason.\n */\n\nimport { useCallback, useRef } from 'react';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport {\n  resolveUserFacingErrorMessage,\n  type ErrorMessageTranslators,\n} from '~wildo-frontend-lib/core/errors/user-facing-error-message.frontend.utils';\n\n/** @wildo_source:part:start saas.frontend.errors.user-facing-error-message facet:layer:frontend facet:audience:app-developer */\n/**\n * Turns a caught error into the words a person may read. Import it from `@wildo-ai/saas-frontend-lib`.\n *\n * Returns `(error, surfaceMessage?) => string`:\n * - `error` — whatever was caught: a rejected request, a thrown `Error`, a failed action's `error`.\n * - `surfaceMessage` — optional: your screen's own localized words for this failure, e.g.\n *   `t(MyViewLabel.SAVE_FAILED)`. It replaces a generic category (\"validation\", \"not found\") that would\n *   mislead on your screen, and is what shows when the error carries nothing displayable.\n *\n * The text comes from the application's error catalog, your surface words, or the backend's user\n * guidance — never from the error's own `message`, which for a backend rejection is a reference key and\n * for a thrown `Error` is developer text. Keep the error itself for logging; show only this.\n *\n * The returned function has a stable identity, so it is safe in `useCallback` / `useEffect` dependencies.\n *\n * @example\n * const toUserFacingErrorMessage = useUserFacingErrorMessage();\n * const [failure, setFailure] = useState<string | null>(null);\n * try {\n *   await saveNote();\n * } catch (error) {\n *   setFailure(toUserFacingErrorMessage(error, t(NoteViewLabel.SAVE_FAILED)));\n * }\n */\nexport function useUserFacingErrorMessage(): (error: unknown, surfaceMessage?: string) => string {\n  const { tErrorMessage, tErrorGuidance } = useI18n();\n  const translatorsRef = useRef<ErrorMessageTranslators>({ tErrorMessage, tErrorGuidance });\n  translatorsRef.current = { tErrorMessage, tErrorGuidance };\n\n  return useCallback(\n    (error: unknown, surfaceMessage?: string) =>\n      resolveUserFacingErrorMessage(error, { translators: translatorsRef.current, surfaceMessage }),\n    [],\n  );\n}\n/** @wildo_source:part:end saas.frontend.errors.user-facing-error-message */\n"]}

package/dist/esm/core/errors/user-facing-error-message.frontend.utils.d.ts

@@ -0,0 +1,141 @@
+/**
+ * User-facing error message resolution — the ONE place a caught error becomes words a person reads.
+ *
+ * ## The policy this implements
+ *
+ * The text shown for an error comes from the i18n tree, never from the error object:
+ *
+ * - a backend error's `message` IS its `customMessageReference` (`"validation"`), which is an i18n
+ *   KEY, not a sentence — the HTTP client copies it onto the thrown error, so `e.message` renders a
+ *   key to the person;
+ * - `details.message` / `context.message` / `context.originalMessage` are server-authored English
+ *   meant for developers and logs — untranslatable, and frequently a Zod issue
+ *   (`Invalid option: expected one of …`);
+ * - a plain `Error` thrown in the browser (a WebAuthn `DOMException`, an invariant message) is
+ *   developer text as well.
+ *
+ * None of those may reach a person. What may is, in order:
+ *
+ * **Translated text always beats untranslated text** (decided 2026-09-15). In order:
+ *
+ * 1. **Localized user guidance** — `errors_guidance.{guidanceKey ?? ref}.explanation`, then `.resolution`.
+ * 2. **The reference label** — `errors_messages.{ref}.msg` — unless the reference is only the GENERIC
+ *   bucket of its error type AND that bucket's wording is {@link GenericErrorWording.SURFACE} AND the
+ *   surface supplied its own words. See {@link GENERIC_ERROR_WORDING_BY_ERROR_TYPE}.
+ * 3. **The surface's own words** — the label of the screen that failed ("Passkey sign-in failed. Try
+ *    again."), passed by the caller.
+ * 4. **The framework's default label** — `errors_messages.default.msg`.
+ * 5. **Raw user guidance** — the backend's `userGuidance.explanation` / `.resolution` string. It is the
+ *    field DESIGNED for display (see `buildErrorWithGuidance`), so it is kept, but it is untranslated:
+ *    it appears only when no authored label of any kind exists.
+ * 6. **The default label's KEY PATH.** A missing label must LOOK missing so somebody adds it
+ *    (`.claude/rules/display-text-comes-from-i18n.md`); an empty string would hide the failure entirely,
+ *    because every error surface renders only a truthy message.
+ *
+ * ## Why a generic reference can lose to the surface
+ *
+ * A generic bucket (`validation`, `internal`, `authentication`, …) is the reference an error carries
+ * when the server named NO specific reason. Its label was written without knowing where it would be
+ * shown, so for some buckets it misleads: a passkey button the person typed nothing into would read
+ * *"Some information is invalid. Please review it."* The surface knows what failed; the bucket does
+ * not. For other buckets the generic label tells the person something the surface cannot know and
+ * can act on — *"Check your connection"*, *"Please wait a moment"* — and it wins. That split is a
+ * property of the error-type vocabulary, so it lives in one total record over {@link ErrorType}.
+ *
+ * Measured 2026-09-15: a passkey sign-in answered `400 validation`, and the sign-in screen rendered
+ * the literal word `validation` in its alert, in every locale.
+ */
+import { ErrorType, type ErrorUserGuidance } from '@wildo-ai/saas-models';
+/**
+ * Whose words a person sees when an error carries only the GENERIC reference of its type.
+ *
+ * Only consulted when the caller supplied surface words; with none, the reference label is used
+ * whatever the classification, because there is nothing more precise to say.
+ */
+export declare enum GenericErrorWording {
+    /**
+     * The surface's own words win. For buckets whose generic label only says "it failed", or points the
+     * person at something the surface may not have asked them for (their input, signing in again, a
+     * missing item). The surface that failed says it more precisely.
+     */
+    SURFACE = "SURFACE",
+    /**
+     * The generic reference label wins. For buckets whose label carries a fact the surface cannot know
+     * and the person can act on: connectivity, permission, a state conflict, throttling, an unavailable
+     * dependency, a plan limit.
+     */
+    REFERENCE = "REFERENCE"
+}
+/**
+ * The wording decision for every {@link ErrorType}'s generic bucket.
+ *
+ * TOTAL over the enum on purpose: a new error type is a compile error here until someone decides what
+ * its generic bucket should say to a person, instead of silently inheriting a default.
+ */
+export declare const GENERIC_ERROR_WORDING_BY_ERROR_TYPE: Readonly<Record<ErrorType, GenericErrorWording>>;
+/** The two i18n resolvers error display needs — the matching members of `I18nContextType`. */
+export interface ErrorMessageTranslators {
+    /** Resolves `errors_messages.{ref}.{key}`; returns the key path when the label is missing. */
+    tErrorMessage: (errorRef: string, key?: string, params?: Record<string, string | number>) => string;
+    /** Resolves `errors_guidance.{guidanceKey}.{field}`; returns `''` when the label is missing. */
+    tErrorGuidance: (guidanceKey: string, field: string, params?: Record<string, string | number>) => string;
+}
+/**
+ * The localized `errors_messages.{ref}.msg` label, or `undefined` when none is authored.
+ *
+ * `tErrorMessage` fails OPEN — a missing label comes back as its own key path — so every caller that
+ * must not show a key needs this guard. It used to be hand-copied at each such caller.
+ */
+export declare function resolveErrorReferenceLabel(tErrorMessage: ErrorMessageTranslators['tErrorMessage'], errorRef: string | undefined): string | undefined;
+/**
+ * Words for a DECLARED REFUSAL CODE — the machine code a custom implementation returns in the error's
+ * `details.code` (#1048), e.g. `SECRET_SLUG_NOT_DECLARED`.
+ *
+ * Tried in order, first answer wins:
+ *  1. the code as an `ErrorCustomMessageReference` value — some declared codes ARE vocabulary members,
+ *     and their words live in `errors_messages`;
+ *  2. `errors_refusals.<code>.msg`, which the labelling planner derives from every
+ *     `errorScenarios[].errorCode` a resource specification declares, with its `when` text as context.
+ *
+ * `undefined` when neither is authored, so the caller falls through to the error's generic REFERENCE
+ * label. That fallback is itself authored, less specific text — never an invented sentence — and the
+ * server's own `details.message` is never shown: it is English prose (RFC 9457 §3.1.4 says consumers
+ * SHOULD NOT parse `detail`; the machine-readable member is what a client reads).
+ *
+ * spec-cite: RFC 9457 §3.1.4 — https://www.rfc-editor.org/rfc/rfc9457#section-3.1.4
+ */
+export declare function resolveRefusalCodeLabel(translators: {
+    tErrorMessage: ErrorMessageTranslators['tErrorMessage'];
+    t: (key: string) => string;
+}, code: string | undefined): string | undefined;
+/** The only facts about an error that display is allowed to read. Deliberately has no `message`. */
+export interface DisplayableErrorFacts {
+    errorType?: ErrorType;
+    customMessageReference?: string;
+    userGuidance?: ErrorUserGuidance;
+}
+/**
+ * Read the displayable facts from whatever a `catch` received.
+ *
+ * Three shapes reach a catch in this frontend, and the facts sit at different depths in each:
+ * - the HTTP client's rejected axios error, carrying the normalized `wildoError` it attached, plus
+ *   `customMessageReference` / `errorType` copied flat, plus the raw `response.data.error` envelope;
+ * - a `WildoError_Frontend` / `WildoError_Backend` itself (`type`, `customMessageReference`);
+ * - anything else — a plain `Error`, a `DOMException`, a string — which has no displayable facts.
+ */
+export declare function readDisplayableErrorFacts(error: unknown): DisplayableErrorFacts;
+export interface ResolveUserFacingErrorMessageOptions {
+    translators: ErrorMessageTranslators;
+    /**
+     * The failing surface's own words, already localized — e.g. `t(UserAuthLabel.PASSKEY_ERROR)`. Omit it
+     * when there is no surface to speak for (the global error toast): generic buckets then use their
+     * reference label.
+     */
+    surfaceMessage?: string;
+}
+/**
+ * Turn a caught error into the message a person reads. See the file header for the order and why.
+ * Never returns the error's `message`, its `details`/`context` text, or a raw reference.
+ */
+export declare function resolveUserFacingErrorMessage(error: unknown, options: ResolveUserFacingErrorMessageOptions): string;
+//# sourceMappingURL=user-facing-error-message.frontend.utils.d.ts.map

package/dist/esm/core/errors/user-facing-error-message.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-facing-error-message.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/errors/user-facing-error-message.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,EAGL,SAAS,EACT,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAO/B;;;;;GAKG;AACH,oBAAY,mBAAmB;IAC7B;;;;OAIG;IACH,OAAO,YAAY;IACnB;;;;OAIG;IACH,SAAS,cAAc;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mCAAmC,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAqBhG,CAAC;AAqBF,8FAA8F;AAC9F,MAAM,WAAW,uBAAuB;IACtC,8FAA8F;IAC9F,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;IACpG,gGAAgG;IAChG,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;CAC1G;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,uBAAuB,CAAC,eAAe,CAAC,EACvD,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE;IAAE,aAAa,EAAE,uBAAuB,CAAC,eAAe,CAAC,CAAC;IAAC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,EACpG,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,GAAG,SAAS,CAOpB;AAMD,oGAAoG;AACpG,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAUD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAwB/E;AAuCD,MAAM,WAAW,oCAAoC;IACnD,WAAW,EAAE,uBAAuB,CAAC;IACrC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,oCAAoC,GAAG,MAAM,CAyBnH"}